Codex Testnet

The Codex Testnet has been launched and is ready to be used for testing.

Your participation in the Codex Testnet is subject to the Codex Testnet Terms and Conditions and Codex Testnet Privacy Policy.

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.

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.

Guides are available either on Discord, as step-by-step, interactive guides, or here as simple instructions that you can follow:

• Basic: running a storage client. [Discord | web]
• Advanced: Running a storage provider. [web]

The guides were tested on the following operating systems:

• Linux: Ubuntu 24.04, Debian 12, Fedora 40
• macOS: 15
• Windows: 11, Server 2022

Running a Storage Client (Discord Version)

You can join Codex Discord server and jump into the #📺|join-testnet channel.

It is mostly the same as a Web guide, but uses Discord capabilities so you can have an interactive, step-by-step guide, and you also can get a support in the #🆘|node-help channel.

Running a Storage Client (Web Version)

Prerequisites

• Access to your Internet router so you can configure port forwarding

Steps for Linux/macOS and Windows are slightly different, so please use ones for your OS.

---

Linux/macOS

1. Download the master tarball from the Codex testnet starter repository, and untar its contents:

   curl -LO https://github.com/codex-storage/codex-testnet-starter/archive/master.tar.gz
   tar xzvf master.tar.gz
   rm master.tar.gz

2. Navigate to the scripts folder:

   cd codex-testnet-starter-master/scripts

3. Install dependencies when required:

   # Debian-based Linux
   sudo apt update && sudo apt install libgomp1

4. Download Codex binaries from GitHub releases:

   ./download_online.sh

5. Generate an ethereum keypair:

   ./generate.sh

   Your private key will be saved to eth.key and address to eth.address file.

6. Fill-up your address shown on the screen with the tokens:

   • Use the web faucets to mint some ETH and TST tokens.
   • We can also do this using Discord # bot channel
     • Use /set ethaddress command to enter your generated address
     • Use /mint command to receive ETH and TST tokens
     • Use /balance command to check if you have received test tokens successfully

7. Run Codex node:

   ./run_client.sh

8. Configure port forwarding and we are ready go to.

Windows

1. Download the master tarball from the Codex testnet starter repository, and untar its contents:

   WARNING

   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.

   curl -LO https://github.com/codex-storage/codex-testnet-starter/archive/master.tar.gz

   If you see an error like:

   curl: (35) schannel: next InitializeSecurityContext failed: CRYPT_E_NO_REVOCATION_CHECK (0x80092012) - The revocation function was unable to check revocation for the certificate.

   You may need to add the --ssl-no-revoke option to your curl call, e.g.:

   curl -LO --ssl-no-revoke https://github.com/codex-storage/codex-testnet-starter/archive/master.tar.gz

2. Extract the contents of the tar file, and then delete it:

   tar xzvf master.tar.gz
   del master.tar.gz

3. Navigate to the scripts folder:

   cd codex-testnet-starter-master\scripts\windows

4. Download Codex binaries from GitHub releases:

   download-online.bat

5. Generate an ethereum keypair:

   generate.bat

   Your private key will be saved to eth.key and address to eth.address file.

6. Fill-up your address shown on the screen with the tokens:

   • Use the web faucets to mint some ETH and TST tokens.
   • We can also do this using Discord # bot channel
     • Use /set ethaddress command to enter your generated address
     • Use /mint command to receive ETH and TST tokens
     • Use /balance command to check if you have received test tokens successfully

7. Run Codex node:

   run-client.bat

8. Configure port forwarding and we are ready go to.

All OS

Configure port forwarding on your Internet router

#	Protocol	Port	Description
1	UDP	8090	Codex Discovery
2	TCP	8070	Codex Transport

After your node is up and running, you can use the Codex API to be able to interact with your Codex node, please check our API walk-through for more details.

You also can use Codex App UI to interact with your local Codex node.

Need help? Reach out to us in #🆘|node-help channel or check troubleshooting guide.

Running a Storage Provider (Web Version)

Work in progress 🚧

Testnet Data

Bootstrap Nodes

Codex

spr:CiUIAhIhAiJvIcA_ZwPZ9ugVKDbmqwhJZaig5zKyLiuaicRcCGqLEgIDARo8CicAJQgCEiECIm8hwD9nA9n26BUoNuarCEllqKDnMrIuK5qJxFwIaosQ3d6esAYaCwoJBJ_f8zKRAnU6KkYwRAIgM0MvWNJL296kJ9gWvfatfmVvT-A7O2s8Mxp8l9c8EW0CIC-h-H-jBVSgFjg3Eny2u33qF7BDnWFzo7fGfZ7_qc9P
spr:CiUIAhIhAyUvcPkKoGE7-gh84RmKIPHJPdsX5Ugm_IHVJgF-Mmu_EgIDARo8CicAJQgCEiEDJS9w-QqgYTv6CHzhGYog8ck92xflSCb8gdUmAX4ya78QoemesAYaCwoJBES39Q2RAnVOKkYwRAIgLi3rouyaZFS_Uilx8k99ySdQCP1tsmLR21tDb9p8LcgCIG30o5YnEooQ1n6tgm9fCT7s53k6XlxyeSkD_uIO9mb3
spr:CiUIAhIhA6_j28xa--PvvOUxH10wKEm9feXEKJIK3Z9JQ5xXgSD9EgIDARo8CicAJQgCEiEDr-PbzFr74--85TEfXTAoSb195cQokgrdn0lDnFeBIP0QzOGesAYaCwoJBK6Kf1-RAnVEKkcwRQIhAPUH5nQrqG4OW86JQWphdSdnPA98ErQ0hL9OZH9a4e5kAiBBZmUl9KnhSOiDgU3_hvjXrXZXoMxhGuZ92_rk30sNDA
spr:CiUIAhIhA7E4DEMer8nUOIUSaNPA4z6x0n9Xaknd28Cfw9S2-cCeEgIDARo8CicAJQgCEiEDsTgMQx6vydQ4hRJo08DjPrHSf1dqSd3bwJ_D1Lb5wJ4Qt_CesAYaCwoJBEDhWZORAnVYKkYwRAIgFNzhnftocLlVHJl1onuhbSUM7MysXPV6dawHAA0DZNsCIDRVu9gnPTH5UkcRXLtt7MLHCo4-DL-RCMyTcMxYBXL0
spr:CiUIAhIhAzZn3JmJab46BNjadVnLNQKbhnN3eYxwqpteKYY32SbOEgIDARo8CicAJQgCEiEDNmfcmYlpvjoE2Np1Wcs1ApuGc3d5jHCqm14phjfZJs4QrvWesAYaCwoJBKpA-TaRAnViKkcwRQIhANuMmZDD2c25xzTbKSirEpkZYoxbq-FU_lpI0K0e4mIVAiBfQX4yR47h1LCnHznXgDs6xx5DLO5q3lUcicqUeaqGeg
spr:CiUIAhIhAgybmRwboqDdUJjeZrzh43sn5mp8jt6ENIb08tLn4x01EgIDARo8CicAJQgCEiECDJuZHBuioN1QmN5mvOHjeyfmanyO3oQ0hvTy0ufjHTUQh4ifsAYaCwoJBI_0zSiRAnVsKkcwRQIhAJCb_z0E3RsnQrEePdJzMSQrmn_ooHv6mbw1DOh5IbVNAiBbBJrWR8eBV6ftzMd6ofa5khNA2h88OBhMqHCIzSjCeA
spr:CiUIAhIhAntGLadpfuBCD9XXfiN_43-V3L5VWgFCXxg4a8uhDdnYEgIDARo8CicAJQgCEiECe0Ytp2l-4EIP1dd-I3_jf5XcvlVaAUJfGDhry6EN2dgQsIufsAYaCwoJBNEmoCiRAnV2KkYwRAIgXO3bzd5VF8jLZG8r7dcLJ_FnQBYp1BcxrOvovEa40acCIDhQ14eJRoPwJ6GKgqOkXdaFAsoszl-HIRzYcXKeb7D9

Geth

enode://cff0c44c62ecd6e00d72131f336bb4e4968f2c1c1abeca7d4be2d35f818608b6d8688b6b65a18f1d57796eaca32fd9d08f15908a88afe18c1748997235ea6fe7@159.223.243.50:40010
enode://ea331eaa8c5150a45b793b3d7c17db138b09f7c9dd7d881a1e2e17a053e0d2600e0a8419899188a87e6b91928d14267949a7e6ec18bfe972f3a14c5c2fe9aecb@68.183.245.13:40030
enode://4a7303b8a72db91c7c80c8fb69df0ffb06370d7f5fe951bcdc19107a686ba61432dc5397d073571433e8fc1f8295127cabbcbfd9d8464b242b7ad0dcd35e67fc@174.138.127.95:40020
enode://36f25e91385206300d04b95a2f8df7d7a792db0a76bd68f897ec7749241b5fdb549a4eecfab4a03c36955d1242b0316b47548b87ad8291794ab6d3fecda3e85b@64.225.89.147:40040
enode://2e14e4a8092b67db76c90b0a02d97d88fc2bb9df0e85df1e0a96472cdfa06b83d970ea503a9bc569c4112c4c447dbd1e1f03cf68471668ba31920ac1d05f85e3@170.64.249.54:40050
enode://6eeb3b3af8bef5634b47b573a17477ea2c4129ab3964210afe3b93774ce57da832eb110f90fbfcfa5f7adf18e55faaf2393d2e94710882d09d0204a9d7bc6dd2@143.244.205.40:40060
enode://6ba0e8b5d968ca8eb2650dd984cdcf50acc01e4ea182350e990191aadd79897801b79455a1186060aa3818a6bc4496af07f0912f7af53995a5ddb1e53d6f31b5@209.38.160.40:40070

Smart contracts

Contract	Address
Token	0x34a22f3911De437307c6f4485931779670f78764
Verifier	0x02dd582726F7507D7d0F8bD8bf8053d3006F9092
Marketplace	0x5Bd66fA15Eb0E546cd26808248867a572cFF5706

Endpoints

#	Service	URL
1	Geth Public RPC	rpc.testnet.codex.storage
2	Block explorer	explorer.testnet.codex.storage
3	Faucet ETH	faucet-eth.testnet.codex.storage
4	Faucet TST	faucet-tst.testnet.codex.storage
5	Status page	status.testnet.codex.storage