testnet.md
1 --- 2 outline: [2, 4] 3 --- 4 # Codex 테스트넷 5 6 Codex 테스트넷이 출시되어 테스트에 사용할 준비가 되었습니다. 7 8 Your participation in the Codex Testnet is subject to the [Codex Testnet Terms and Conditions](https://github.com/codex-storage/codex-testnet-starter/blob/master/Codex%20Testnet%20Terms%20and%20Conditions.pdf) and [Codex Testnet Privacy Policy](https://github.com/codex-storage/codex-testnet-starter/blob/master/Codex%20Testnet%20Privacy%20Policy.pdf). 9 10 **Guides.** We have basic guides covering how to set up a Storage Client which can be used to upload and persist files by buying storage in the Codex network. We recommend that you start with those. 11 12 Running a Storage Provider is more involved and is covered as a separate guide which demonstrates the storage sales side, as well as how to run Codex with its own local Ethereum execution client. 13 14 Guides are available either on Discord, as step-by-step, interactive guides, or here as simple instructions that you can follow: 15 16 - **Basic: running a storage client.** [[Discord](#sc-guide-discord) | [web](#sc-guide-web)] 17 - **Advanced: Running a storage provider.** [[web](#sp-guide-web)] 18 19 The guides were tested on the following operating systems: 20 21 - Linux: Ubuntu 24.04, Debian 12, Fedora 40 22 - macOS: 15 23 - Windows: 11, Server 2022 24 25 ## 테스트넷 정보 26 27 | 항목 | 값 | 28 | --- | --- | 29 | 체인 ID | 2430 | 30 | 통화 기호 | ETH | 31 | 블록 시간 | 5초 | 32 | 합의 | Clique PoA | 33 | 네트워크 ID | 2430 | 34 | 네트워크 이름 | Codex Testnet | 35 | RPC URL | https://rpc.testnet.codex.storage | 36 37 ## Running a Storage Client (Discord Version) {#sc-guide-discord} 38 39 You can join [Codex Discord server](https://discord.gg/codex-storage) and jump into the [#:tv:|join-testnet](https://discord.com/channels/895609329053474826/1289923125928001702) channel. 40 41 It is mostly the same as a [Web guide](#sc-guide-web), but uses Discord capabilities so you can have an interactive, step-by-step guide, and you also can get a support in the [#:sos:|node-help](https://discord.com/channels/895609329053474826/1286205545837105224) channel. 42 43 ## Running a Storage Client (Web Version) {#sc-guide-web} 44 45 **Prerequisites** 46 47 - Access to your Internet router so you can [configure port forwarding](#basic-common) 48 49 Steps for [Linux/macOS](#basic-linux-macos) and [Windows](#basic-windows) are slightly different, so please use ones for your OS. 50 51 <hr> 52 53 ### Linux/macOS {#basic-linux-macos} 54 55 1. Download the master tarball from the Codex testnet starter repository, and untar its contents: 56 ```shell 57 curl -LO https://github.com/codex-storage/codex-testnet-starter/archive/master.tar.gz 58 tar xzvf master.tar.gz 59 rm master.tar.gz 60 ``` 61 62 2. Navigate to the scripts folder: 63 ```shell 64 cd codex-testnet-starter-master/scripts 65 ``` 66 67 3. Install dependencies when required: 68 ```shell 69 # Debian-based Linux 70 sudo apt update && sudo apt install libgomp1 71 ``` 72 73 4. Download Codex binaries from GitHub releases: 74 ```shell 75 ./download_online.sh 76 ``` 77 78 5. Generate an ethereum keypair: 79 ```shell 80 ./generate.sh 81 ``` 82 Your private key will be saved to `eth.key` and address to `eth.address` file. 83 84 6. Fill-up your address shown on the screen with the tokens: 85 - Use the web faucets to mint some [ETH](https://faucet-eth.testnet.codex.storage) and [TST](https://faucet-tst.testnet.codex.storage) tokens. 86 - We can also do this using Discord [# bot](https://discord.com/channels/895609329053474826/1230785221553819669) channel 87 - Use `/set ethaddress` command to enter your generated address 88 - Use `/mint` command to receive ETH and TST tokens 89 - Use `/balance` command to check if you have received test tokens successfully 90 91 7. Run Codex node: 92 ```shell 93 ./run_client.sh 94 ``` 95 96 8. Configure [port forwarding](#basic-common) and we are ready go to. 97 98 ### Windows {#basic-windows} 99 100 1. Download the master tarball from the Codex testnet starter repository, and untar its contents: 101 > [!WARNING] 102 > Windows antivirus software and built-in firewalls may cause steps to fail. We will cover some possible errors here, but always consider checking your setup if requests fail - in particular, if temporarily disabling your antivirus fixes it, then it is likely to be the culprit. 103 104 ```batch 105 curl -LO https://github.com/codex-storage/codex-testnet-starter/archive/master.tar.gz 106 ``` 107 108 If you see an error like: 109 110 ```batch 111 curl: (35) schannel: next InitializeSecurityContext failed: CRYPT_E_NO_REVOCATION_CHECK (0x80092012) - The revocation function was unable to check revocation for the certificate. 112 ``` 113 114 You may need to add the `--ssl-no-revoke` option to your curl call, e.g.: 115 116 ```batch 117 curl -LO --ssl-no-revoke https://github.com/codex-storage/codex-testnet-starter/archive/master.tar.gz 118 ``` 119 120 1. Extract the contents of the tar file, and then delete it: 121 ```batch 122 tar xzvf master.tar.gz 123 del master.tar.gz 124 ``` 125 126 2. Navigate to the scripts folder: 127 ```batch 128 cd codex-testnet-starter-master\scripts\windows 129 ``` 130 131 3. Download Codex binaries from GitHub releases: 132 ```batch 133 download-online.bat 134 ``` 135 136 4. Generate an ethereum keypair: 137 ```batch 138 generate.bat 139 ``` 140 Your private key will be saved to `eth.key` and address to `eth.address` file. 141 142 5. Fill-up your address shown on the screen with the tokens: 143 - Use the web faucets to mint some [ETH](https://faucet-eth.testnet.codex.storage) and [TST](https://faucet-tst.testnet.codex.storage) tokens. 144 - We can also do this using Discord [# bot](https://discord.com/channels/895609329053474826/1230785221553819669) channel 145 - Use `/set ethaddress` command to enter your generated address 146 - Use `/mint` command to receive ETH and TST tokens 147 - Use `/balance` command to check if you have received test tokens successfully 148 149 6. Run Codex node: 150 ```batch 151 run-client.bat 152 ``` 153 154 7. Configure [port forwarding](#basic-common) and we are ready go to. 155 156 ### All OS {#basic-common} 157 158 Configure [port forwarding](https://en.wikipedia.org/wiki/Port_forwarding) on your Internet router 159 | # | Protocol | Port | Description | 160 | - | -------- | ------ | ----------------- | 161 | 1 | `UDP` | `8090` | `Codex Discovery` | 162 | 2 | `TCP` | `8070` | `Codex Transport` | 163 164 After your node is up and running, you can use the [Codex API](/developers/api) to be able to interact with your Codex node, please check our [API walk-through](/learn/using) for more details. 165 166 You also can use [Codex App UI](https://app.codex.storage) to interact with your local Codex node. 167 168 Need help? Reach out to us in [#:sos:|node-help](https://discord.com/channels/895609329053474826/1286205545837105224) channel or check [troubleshooting guide](/learn/troubleshoot.md). 169 170 ## Running a Storage Provider (Web Version) {#sp-guide-web} 171 172 Work in progress :construction: 173 174 ## Testnet Data 175 176 ### Bootstrap Nodes 177 **Codex** 178 ```shell 179 spr:CiUIAhIhAiJvIcA_ZwPZ9ugVKDbmqwhJZaig5zKyLiuaicRcCGqLEgIDARo8CicAJQgCEiECIm8hwD9nA9n26BUoNuarCEllqKDnMrIuK5qJxFwIaosQ3d6esAYaCwoJBJ_f8zKRAnU6KkYwRAIgM0MvWNJL296kJ9gWvfatfmVvT-A7O2s8Mxp8l9c8EW0CIC-h-H-jBVSgFjg3Eny2u33qF7BDnWFzo7fGfZ7_qc9P 180 spr:CiUIAhIhAyUvcPkKoGE7-gh84RmKIPHJPdsX5Ugm_IHVJgF-Mmu_EgIDARo8CicAJQgCEiEDJS9w-QqgYTv6CHzhGYog8ck92xflSCb8gdUmAX4ya78QoemesAYaCwoJBES39Q2RAnVOKkYwRAIgLi3rouyaZFS_Uilx8k99ySdQCP1tsmLR21tDb9p8LcgCIG30o5YnEooQ1n6tgm9fCT7s53k6XlxyeSkD_uIO9mb3 181 spr:CiUIAhIhA6_j28xa--PvvOUxH10wKEm9feXEKJIK3Z9JQ5xXgSD9EgIDARo8CicAJQgCEiEDr-PbzFr74--85TEfXTAoSb195cQokgrdn0lDnFeBIP0QzOGesAYaCwoJBK6Kf1-RAnVEKkcwRQIhAPUH5nQrqG4OW86JQWphdSdnPA98ErQ0hL9OZH9a4e5kAiBBZmUl9KnhSOiDgU3_hvjXrXZXoMxhGuZ92_rk30sNDA 182 spr:CiUIAhIhA7E4DEMer8nUOIUSaNPA4z6x0n9Xaknd28Cfw9S2-cCeEgIDARo8CicAJQgCEiEDsTgMQx6vydQ4hRJo08DjPrHSf1dqSd3bwJ_D1Lb5wJ4Qt_CesAYaCwoJBEDhWZORAnVYKkYwRAIgFNzhnftocLlVHJl1onuhbSUM7MysXPV6dawHAA0DZNsCIDRVu9gnPTH5UkcRXLtt7MLHCo4-DL-RCMyTcMxYBXL0 183 spr:CiUIAhIhAzZn3JmJab46BNjadVnLNQKbhnN3eYxwqpteKYY32SbOEgIDARo8CicAJQgCEiEDNmfcmYlpvjoE2Np1Wcs1ApuGc3d5jHCqm14phjfZJs4QrvWesAYaCwoJBKpA-TaRAnViKkcwRQIhANuMmZDD2c25xzTbKSirEpkZYoxbq-FU_lpI0K0e4mIVAiBfQX4yR47h1LCnHznXgDs6xx5DLO5q3lUcicqUeaqGeg 184 spr:CiUIAhIhAgybmRwboqDdUJjeZrzh43sn5mp8jt6ENIb08tLn4x01EgIDARo8CicAJQgCEiECDJuZHBuioN1QmN5mvOHjeyfmanyO3oQ0hvTy0ufjHTUQh4ifsAYaCwoJBI_0zSiRAnVsKkcwRQIhAJCb_z0E3RsnQrEePdJzMSQrmn_ooHv6mbw1DOh5IbVNAiBbBJrWR8eBV6ftzMd6ofa5khNA2h88OBhMqHCIzSjCeA 185 spr:CiUIAhIhAntGLadpfuBCD9XXfiN_43-V3L5VWgFCXxg4a8uhDdnYEgIDARo8CicAJQgCEiECe0Ytp2l-4EIP1dd-I3_jf5XcvlVaAUJfGDhry6EN2dgQsIufsAYaCwoJBNEmoCiRAnV2KkYwRAIgXO3bzd5VF8jLZG8r7dcLJ_FnQBYp1BcxrOvovEa40acCIDhQ14eJRoPwJ6GKgqOkXdaFAsoszl-HIRzYcXKeb7D9 186 ``` 187 188 **Geth** 189 ```shell 190 enode://cff0c44c62ecd6e00d72131f336bb4e4968f2c1c1abeca7d4be2d35f818608b6d8688b6b65a18f1d57796eaca32fd9d08f15908a88afe18c1748997235ea6fe7@159.223.243.50:40010 191 enode://ea331eaa8c5150a45b793b3d7c17db138b09f7c9dd7d881a1e2e17a053e0d2600e0a8419899188a87e6b91928d14267949a7e6ec18bfe972f3a14c5c2fe9aecb@68.183.245.13:40030 192 enode://4a7303b8a72db91c7c80c8fb69df0ffb06370d7f5fe951bcdc19107a686ba61432dc5397d073571433e8fc1f8295127cabbcbfd9d8464b242b7ad0dcd35e67fc@174.138.127.95:40020 193 enode://36f25e91385206300d04b95a2f8df7d7a792db0a76bd68f897ec7749241b5fdb549a4eecfab4a03c36955d1242b0316b47548b87ad8291794ab6d3fecda3e85b@64.225.89.147:40040 194 enode://2e14e4a8092b67db76c90b0a02d97d88fc2bb9df0e85df1e0a96472cdfa06b83d970ea503a9bc569c4112c4c447dbd1e1f03cf68471668ba31920ac1d05f85e3@170.64.249.54:40050 195 enode://6eeb3b3af8bef5634b47b573a17477ea2c4129ab3964210afe3b93774ce57da832eb110f90fbfcfa5f7adf18e55faaf2393d2e94710882d09d0204a9d7bc6dd2@143.244.205.40:40060 196 enode://6ba0e8b5d968ca8eb2650dd984cdcf50acc01e4ea182350e990191aadd79897801b79455a1186060aa3818a6bc4496af07f0912f7af53995a5ddb1e53d6f31b5@209.38.160.40:40070 197 ``` 198 199 ### Smart contracts 200 201 | Contract | Address | 202 | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------- | 203 | Token | [`0x34a22f3911De437307c6f4485931779670f78764`](https://explorer.testnet.codex.storage/address/0x34a22f3911De437307c6f4485931779670f78764) | 204 | Verifier | [`0x1f60B2329775545AaeF743dbC3571e699405263e`](https://explorer.testnet.codex.storage/address/0x1f60B2329775545AaeF743dbC3571e699405263e) | 205 | Marketplace | [`0xd53a4181862f42641ccA02Fb4CED7D7f19C6920B`](https://explorer.testnet.codex.storage/address/0xd53a4181862f42641ccA02Fb4CED7D7f19C6920B) | 206 207 ### Endpoints 208 209 | # | Service | URL | 210 | - | --------------- | ---------------------------------------------------------------------------- | 211 | 1 | Geth Public RPC | [rpc.testnet.codex.storage](https://rpc.testnet.codex.storage) | 212 | 2 | Block explorer | [explorer.testnet.codex.storage](https://explorer.testnet.codex.storage) | 213 | 3 | Faucet ETH | [faucet-eth.testnet.codex.storage](https://faucet-eth.testnet.codex.storage) | 214 | 4 | Faucet TST | [faucet-tst.testnet.codex.storage](https://faucet-tst.testnet.codex.storage) | 215 | 5 | Status page | [status.testnet.codex.storage](https://status.testnet.codex.storage) | 216 217 ## 유용한 링크 218 219 | # | 서비스 | URL | 220 | - | --------------- | ---------------------------------------------------------------------------- | 221 | 1 | Geth 공개 RPC | [rpc.testnet.codex.storage](https://rpc.testnet.codex.storage) | 222 | 2 | 블록 탐색기 | [explorer.testnet.codex.storage](https://explorer.testnet.codex.storage) | 223 | 3 | ETH 수도꼭지 | [faucet-eth.testnet.codex.storage](https://faucet-eth.testnet.codex.storage) | 224 | 4 | TST 수도꼭지 | [faucet-tst.testnet.codex.storage](https://faucet-tst.testnet.codex.storage) | 225 | 5 | 상태 페이지 | [status.testnet.codex.storage](https://status.testnet.codex.storage) |