├── deployment_steps.md ├── specs.md ├── README.md └── LICENSE /deployment_steps.md: -------------------------------------------------------------------------------- 1 | # Deployment steps: 2 | 3 | 1. Confirm that all the work in the built-in actors `integration/builtin-api` branch is also in the `next` branch before we cut the actors release bundle for the deployment. (ask @aayush to check) 4 | 2. Use a branch @jennijuju will prepare based on M2 branch at https://github.com/filecoin-project/lotus/tree/experimental/fvm-m2 5 | 3. Add `build/params_wallaby.go` 6 | 4. Create PR to Lotus 7 | 5. Wait 24 hours for any community requests for changes 8 | 6. Deploy the testnet 9 | 7. Ask the Lotus team to create a tag 10 | 8. Update this `filecoin-project/testnet-wallaby` repo's [README](README.md) with exact commit/tag used 11 | 9. Notify testnet RPC endpoint providers and Filscan 12 | 10. Update FVM early builders 13 | -------------------------------------------------------------------------------- /specs.md: -------------------------------------------------------------------------------- 1 | ### Wallaby Testnet for FVM Developers 2 | 3 | A shared FVM developer-focused testnet to support deployment and testing of longer-running smart contracts and storage deals with closer-to-mainnet-like conditions and enable more interactive use cases to be tried out between projects. 4 | 5 | **Components:** 6 | - Shared public testnet based on FVM experimental branch that will likely be reset every few weeks[?] 7 | - Public faucet webpage 8 | - Dedicated storage miners auto-accepting deals for 512 MiB, 32 GiB sectors with faster sealing 9 | - Simulate an environment similar to Filecoin mainnet, such as Fil+ registry settings, etc. 10 | - Downloadable snapshots for fast bootstrap (regenerated once a week) 11 | - Block explorer [will ask Filscan.io] 12 | - Hosted RPC endpoints [will ask Glif Nodes] 13 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | :warning: The Hyperspace Testnet has been **discontinued** as of May 31, 2023. :warning: 2 | 3 | Please use the [Calibration testnet](https://github.com/filecoin-project/testnet-calibration/blob/main/README.md). 4 | 5 | Wallaby has been shut down until further notice and Hyperspace is the main testnet for Filecoin developers and testing FEVM releases. 6 | 7 | In the future, Wallaby will be used for testing bleeding-edge Wasm FVM releases (see the FVM Roadmap at https://fvm.filecoin.io). 8 | 9 | # Wallaby Testnet 10 | 11 | Meta info about Wallaby Weekly, a *bleeding edge* testnet for FVM development 12 | 13 | - Not sure which testnet to use? Start with **[Hyperspace](https://github.com/filecoin-project/testnet-hyperspace)** - a stable testnet for Filecoin developers. **Wallaby is only for future experimental releases.** 14 | 15 | - [Info about all testnets](https://github.com/filecoin-project/FIPs/discussions/544) 16 | 17 | ![david-clode-ko-v55B2xOw-unsplash](https://user-images.githubusercontent.com/1017762/189190624-cb1179cd-4b1e-437c-947b-493ebd2568f0.png) 18 |
photo by [David Clode on Unsplash](https://unsplash.com/@davidclode) 19 | 20 |   21 | 22 | ## Quickstart 23 | 24 | 1. Add the Wallaby testnet to your wallet (e.g. MetaMask). 25 | - Go to https://chainlist.org/chain/31415 26 | - Click on "Connect wallet" 27 | 2. Create a new account in MetaMask to use with Filecoin. 28 | 3. Use the [faucet](https://wallaby.network/#faucet) to draw funds to your Ethereum address (it will be converted behind the scenes to a Filecoin f4 address) 29 | 4. Follow the transaction in one of the recommended Wallaby testnet explorers: 30 | - https://wallaby.filfox.info/en 31 | - https://explorer.glif.io/ (select Wallaby from the networks dropdown) 32 | 5. Your account is now funded and can be used in Ethereum tools such as Hardhat, Foundry, Remix, etc. 33 | 34 | ## Technical details 35 | 36 | **Maintainer:** offline, unmaintained 37 | 38 | **Genesis**: 39 | 40 | - CAR File: `QmavrNRhTMbUNFtSJA6VVMMcSyCwQzUpJbSPRjZzKjy3Jg` 41 | - Reset Timestamp: `2023-01-09T14:54:09Z` 42 | - Genesis Block CID: `bafy2bzaceaq7a2nole6qaje33tydbvumeykjs4vjh2sh7hunsxwdsblpibxf2` 43 | - sha1 Digest: `104a283cf7f3e805790c1e4fc02e50ed0f673981` 44 | 45 | **Network parameters**: 46 | 47 | - Supported Sector Sizes: `512 MiB` and `32 GiB` and `64 GiB` 48 | - Consensus Miner Min Power: `16 GiB` 49 | - Epoch Duration Seconds: `30` 50 | - Expected Leaders per Epoch: `5` 51 | - WindowPoSt Proving Period: `2880` 52 | - WindowPoSt Challenge Window: `60` 53 | - WindowPoSt Period Deadlines: `48` 54 | - Pre-Commit Challenge Delay: `10` 55 | 56 | **Bootstrap peers**: 57 | 58 | ``` 59 | 60 | ``` 61 | 62 | **FVM release**: 63 | 64 | - [FVM M2.1 Carbonado (r10)](https://github.com/filecoin-project/ref-fvm/issues/1052) 65 | - Lotus commit: [f2d5afc09431daea43291c52e38945b3147a7079](https://github.com/filecoin-project/lotus/commit/f2d5afc09431daea43291c52e38945b3147a7079) 66 | - [List of FVM releases](https://github.com/filecoin-project/ref-fvm/issues/692) 67 | 68 | **Resources**: 69 | 70 | - Slack Channel for Updates: [#fil-net-wallaby-discuss](https://filecoinproject.slack.com/archives/C03KGBTJ0BY) 71 | 72 | - **Wallaby Docs**: 73 | - **Faucet**: 74 | - **Block Explorers**: 75 | - [https://wallaby.filscan.io](https://wallaby.filscan.io) 76 | - [https://explorer.glif.io/actor/?network=wallaby](https://explorer.glif.io/actor/?network=wallaby) 77 | - **Filecoin CID Checker**: [https://wallaby.filecoin.tools](https://wallaby.filecoin.tools/) - check your deal CID’s storage status. This is **not a real-time** application and refreshes every 5 minutes. 78 | - If you want to play with marketdeals on your own you can access them directly [here](https://marketdeals-wallaby.s3.ap-northeast-1.amazonaws.com/StateMarketDeals.json) 79 | 80 | - **JSON RPC API - Public Endpoints**: 81 | - Limited to all read API calls + `MPoolPush` (for sending already signed messages) 82 | - https://wallaby.node.glif.io/rpc/v0 (for stable API v0) 83 | - https://wallaby.node.glif.io/rpc/v1 (for new API v1 - see [API README](https://github.com/filecoin-project/lotus/blob/422f66776fa07827f2cfa9d2f8142ef29dcd2a95/api/README.md)) 84 | - web socket endpoint: wss://wss.wallaby.node.glif.io/apigw/lotus/rpc/v0 85 | - **JSON RPC API - Private Endpoints**: 86 | - Protected by JWT authorization. Ping @glif-nodes-team in wallaby slack channels to obtain the token. 87 | - https://wallaby.dev.node.glif.io/archive/lotus/rpc/v0 88 | - https://wallaby.dev.node.glif.io/archive/lotus/rpc/v1 89 | - **Wallaby SPs auto-accepting storage deals:** 90 | - 91 | - **Schedule**: 92 | - Normally reset every Tuesday with [bleeding edge FEVM releases](https://github.com/filecoin-project/ref-fvm/issues/692) 93 | - Follow [#fil-net-wallaby-discuss](https://filecoinproject.slack.com/archives/C03KGBTJ0BY) for updates 94 | - **MetaMask** (HowTo): 95 | - Open MetaMask and add a new network: 96 | - Name: Filecoin Wallaby 97 | - RPC URL: https://wallaby.node.glif.io/rpc/v0 (once the public RPC has been updated, otherwise use appropriate private URL - **please see the note below**) 98 | - ChainID: [**31415**](https://github.com/ethereum-lists/chains/blob/master/_data/chains/eip155-31415.json) (Wallaby's ) 99 | - Currency symbol: tFIL (Test FIL). 100 | - Create a new account in MetaMask to use with Filecoin. 101 | - (OPTIONAL - the faucet accepts 0x style addresses now) Go to https://explorer.glif.io/ethereum/, and select the account to see its f4 address. 102 | - Use the [faucet](https://wallaby.filtest.network/#faucet) to draw funds to your f4 (0x style addresses are translated automatically to f4's in the backend) or alternatively use `lotus send` to transfer funds to the f4 address. 103 | - Wait until the transaction process, and verify that the funds appear in MetaMask. 104 | - Create another new account in MetaMask, (optional) obtain its f4 address again. 105 | - Use MetaMask to send funds from your first account to your second account. 106 | - **Notes on MM** 107 | - Note that you may need to increase the gas limit manually because there's something strange going on with gas estimation at the moment. 108 | - **Note on GLIF**: 109 | - The GLIF explorer seems to have some problems with f4 addresses right now, please refer to the #fil-net-wallaby-discuss for questions/solutions 110 | 111 | 112 |
113 | 114 | :warning: [TODO - SAMPLE INFO BELOW] :warning: 115 | 116 | - [Latest chain snapshot (pruned)](https://fil-chain-snapshots-fallback.s3.amazonaws.com/mainnet/minimal_finality_stateroots_latest.car) 117 | - [Latest chain snapshot (full)](https://fil-chain-snapshots-fallback.s3.amazonaws.com/mainnet/complete_chain_with_finality_stateroots_latest.car) 118 | - [Status page and incidents](https://filecoin.statuspage.io/) 119 | - [Stats dashboard](https://stats.filecoin.io/) 120 | - [Block explorer: Filscan](https://filscan.io/) 121 | 122 | :warning: [TODO - SAMPLE INFO ABOVE] :warning: 123 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Apache License 2 | Version 2.0, January 2004 3 | http://www.apache.org/licenses/ 4 | 5 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 6 | 7 | 1. Definitions. 8 | 9 | "License" shall mean the terms and conditions for use, reproduction, 10 | and distribution as defined by Sections 1 through 9 of this document. 11 | 12 | "Licensor" shall mean the copyright owner or entity authorized by 13 | the copyright owner that is granting the License. 14 | 15 | "Legal Entity" shall mean the union of the acting entity and all 16 | other entities that control, are controlled by, or are under common 17 | control with that entity. For the purposes of this definition, 18 | "control" means (i) the power, direct or indirect, to cause the 19 | direction or management of such entity, whether by contract or 20 | otherwise, or (ii) ownership of fifty percent (50%) or more of the 21 | outstanding shares, or (iii) beneficial ownership of such entity. 22 | 23 | "You" (or "Your") shall mean an individual or Legal Entity 24 | exercising permissions granted by this License. 25 | 26 | "Source" form shall mean the preferred form for making modifications, 27 | including but not limited to software source code, documentation 28 | source, and configuration files. 29 | 30 | "Object" form shall mean any form resulting from mechanical 31 | transformation or translation of a Source form, including but 32 | not limited to compiled object code, generated documentation, 33 | and conversions to other media types. 34 | 35 | "Work" shall mean the work of authorship, whether in Source or 36 | Object form, made available under the License, as indicated by a 37 | copyright notice that is included in or attached to the work 38 | (an example is provided in the Appendix below). 39 | 40 | "Derivative Works" shall mean any work, whether in Source or Object 41 | form, that is based on (or derived from) the Work and for which the 42 | editorial revisions, annotations, elaborations, or other modifications 43 | represent, as a whole, an original work of authorship. For the purposes 44 | of this License, Derivative Works shall not include works that remain 45 | separable from, or merely link (or bind by name) to the interfaces of, 46 | the Work and Derivative Works thereof. 47 | 48 | "Contribution" shall mean any work of authorship, including 49 | the original version of the Work and any modifications or additions 50 | to that Work or Derivative Works thereof, that is intentionally 51 | submitted to Licensor for inclusion in the Work by the copyright owner 52 | or by an individual or Legal Entity authorized to submit on behalf of 53 | the copyright owner. For the purposes of this definition, "submitted" 54 | means any form of electronic, verbal, or written communication sent 55 | to the Licensor or its representatives, including but not limited to 56 | communication on electronic mailing lists, source code control systems, 57 | and issue tracking systems that are managed by, or on behalf of, the 58 | Licensor for the purpose of discussing and improving the Work, but 59 | excluding communication that is conspicuously marked or otherwise 60 | designated in writing by the copyright owner as "Not a Contribution." 61 | 62 | "Contributor" shall mean Licensor and any individual or Legal Entity 63 | on behalf of whom a Contribution has been received by Licensor and 64 | subsequently incorporated within the Work. 65 | 66 | 2. Grant of Copyright License. Subject to the terms and conditions of 67 | this License, each Contributor hereby grants to You a perpetual, 68 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 69 | copyright license to reproduce, prepare Derivative Works of, 70 | publicly display, publicly perform, sublicense, and distribute the 71 | Work and such Derivative Works in Source or Object form. 72 | 73 | 3. Grant of Patent License. Subject to the terms and conditions of 74 | this License, each Contributor hereby grants to You a perpetual, 75 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 76 | (except as stated in this section) patent license to make, have made, 77 | use, offer to sell, sell, import, and otherwise transfer the Work, 78 | where such license applies only to those patent claims licensable 79 | by such Contributor that are necessarily infringed by their 80 | Contribution(s) alone or by combination of their Contribution(s) 81 | with the Work to which such Contribution(s) was submitted. If You 82 | institute patent litigation against any entity (including a 83 | cross-claim or counterclaim in a lawsuit) alleging that the Work 84 | or a Contribution incorporated within the Work constitutes direct 85 | or contributory patent infringement, then any patent licenses 86 | granted to You under this License for that Work shall terminate 87 | as of the date such litigation is filed. 88 | 89 | 4. Redistribution. You may reproduce and distribute copies of the 90 | Work or Derivative Works thereof in any medium, with or without 91 | modifications, and in Source or Object form, provided that You 92 | meet the following conditions: 93 | 94 | (a) You must give any other recipients of the Work or 95 | Derivative Works a copy of this License; and 96 | 97 | (b) You must cause any modified files to carry prominent notices 98 | stating that You changed the files; and 99 | 100 | (c) You must retain, in the Source form of any Derivative Works 101 | that You distribute, all copyright, patent, trademark, and 102 | attribution notices from the Source form of the Work, 103 | excluding those notices that do not pertain to any part of 104 | the Derivative Works; and 105 | 106 | (d) If the Work includes a "NOTICE" text file as part of its 107 | distribution, then any Derivative Works that You distribute must 108 | include a readable copy of the attribution notices contained 109 | within such NOTICE file, excluding those notices that do not 110 | pertain to any part of the Derivative Works, in at least one 111 | of the following places: within a NOTICE text file distributed 112 | as part of the Derivative Works; within the Source form or 113 | documentation, if provided along with the Derivative Works; or, 114 | within a display generated by the Derivative Works, if and 115 | wherever such third-party notices normally appear. The contents 116 | of the NOTICE file are for informational purposes only and 117 | do not modify the License. You may add Your own attribution 118 | notices within Derivative Works that You distribute, alongside 119 | or as an addendum to the NOTICE text from the Work, provided 120 | that such additional attribution notices cannot be construed 121 | as modifying the License. 122 | 123 | You may add Your own copyright statement to Your modifications and 124 | may provide additional or different license terms and conditions 125 | for use, reproduction, or distribution of Your modifications, or 126 | for any such Derivative Works as a whole, provided Your use, 127 | reproduction, and distribution of the Work otherwise complies with 128 | the conditions stated in this License. 129 | 130 | 5. Submission of Contributions. Unless You explicitly state otherwise, 131 | any Contribution intentionally submitted for inclusion in the Work 132 | by You to the Licensor shall be under the terms and conditions of 133 | this License, without any additional terms or conditions. 134 | Notwithstanding the above, nothing herein shall supersede or modify 135 | the terms of any separate license agreement you may have executed 136 | with Licensor regarding such Contributions. 137 | 138 | 6. Trademarks. This License does not grant permission to use the trade 139 | names, trademarks, service marks, or product names of the Licensor, 140 | except as required for reasonable and customary use in describing the 141 | origin of the Work and reproducing the content of the NOTICE file. 142 | 143 | 7. Disclaimer of Warranty. Unless required by applicable law or 144 | agreed to in writing, Licensor provides the Work (and each 145 | Contributor provides its Contributions) on an "AS IS" BASIS, 146 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 147 | implied, including, without limitation, any warranties or conditions 148 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A 149 | PARTICULAR PURPOSE. You are solely responsible for determining the 150 | appropriateness of using or redistributing the Work and assume any 151 | risks associated with Your exercise of permissions under this License. 152 | 153 | 8. Limitation of Liability. In no event and under no legal theory, 154 | whether in tort (including negligence), contract, or otherwise, 155 | unless required by applicable law (such as deliberate and grossly 156 | negligent acts) or agreed to in writing, shall any Contributor be 157 | liable to You for damages, including any direct, indirect, special, 158 | incidental, or consequential damages of any character arising as a 159 | result of this License or out of the use or inability to use the 160 | Work (including but not limited to damages for loss of goodwill, 161 | work stoppage, computer failure or malfunction, or any and all 162 | other commercial damages or losses), even if such Contributor 163 | has been advised of the possibility of such damages. 164 | 165 | 9. Accepting Warranty or Additional Liability. While redistributing 166 | the Work or Derivative Works thereof, You may choose to offer, 167 | and charge a fee for, acceptance of support, warranty, indemnity, 168 | or other liability obligations and/or rights consistent with this 169 | License. However, in accepting such obligations, You may act only 170 | on Your own behalf and on Your sole responsibility, not on behalf 171 | of any other Contributor, and only if You agree to indemnify, 172 | defend, and hold each Contributor harmless for any liability 173 | incurred by, or claims asserted against, such Contributor by reason 174 | of your accepting any such warranty or additional liability. 175 | 176 | END OF TERMS AND CONDITIONS 177 | 178 | APPENDIX: How to apply the Apache License to your work. 179 | 180 | To apply the Apache License to your work, attach the following 181 | boilerplate notice, with the fields enclosed by brackets "[]" 182 | replaced with your own identifying information. (Don't include 183 | the brackets!) The text should be enclosed in the appropriate 184 | comment syntax for the file format. We also recommend that a 185 | file or class name and description of purpose be included on the 186 | same "printed page" as the copyright notice for easier 187 | identification within third-party archives. 188 | 189 | Copyright [yyyy] [name of copyright owner] 190 | 191 | Licensed under the Apache License, Version 2.0 (the "License"); 192 | you may not use this file except in compliance with the License. 193 | You may obtain a copy of the License at 194 | 195 | http://www.apache.org/licenses/LICENSE-2.0 196 | 197 | Unless required by applicable law or agreed to in writing, software 198 | distributed under the License is distributed on an "AS IS" BASIS, 199 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 200 | See the License for the specific language governing permissions and 201 | limitations under the License. 202 | --------------------------------------------------------------------------------