Skip to content

Archivist Testnet

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

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

Guides. We have basic guides covering how to set up a Storage Node which can be used to upload and persist files by buying storage in the Archivist 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 Archivist 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 node. [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: 26
  • Windows: 11, Server 2022

Running a Storage node (Discord Version)

You can join Archivist 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 Node (Web Version)

Prerequisites

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


Linux/macOS

  1. Install Archivist binaries from GitHub releases:

    shell
    mkdir archivist-testnet && cd archivist-testnet
    
    curl -s https://get.archivist.storage/testnet/install.sh | bash
  2. Install dependencies when required:

    shell
    # Debian-based Linux
    sudo apt update && sudo apt install libgomp1
  3. Generate an ethereum keypair:

    shell
    curl -s https://get.archivist.storage/testnet/generate.sh | bash

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

  4. 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
  5. Run Archivist node:

    shell
    curl -s https://get.archivist.storage/testnet/run.sh | bash
  6. Configure port forwarding and we are ready go to.

Windows

  1. Download the master tarball from the Archivist 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.

    batch
    curl -LO https://github.com/durability-labs/archivist-testnet-starter/archive/main.tar.gz

    If you see an error like:

    batch
    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.:

    batch
    curl -LO --ssl-no-revoke https://github.com/durability-labs/archivist-testnet-starter/archive/main.tar.gz
  2. Extract the contents of the tar file, and then delete it:

    batch
    tar xzvf master.tar.gz
    del master.tar.gz
  3. Navigate to the scripts folder:

    batch
    cd archivist-testnet-starter-master\scripts\windows
  4. Download Archivist binaries from GitHub releases:

    batch
    download-online.bat
  5. Generate an ethereum keypair:

    batch
    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 Archivist node:

    batch
    run-client.bat
  8. Configure port forwarding and we are ready go to.

All OS

Configure port forwarding on your Internet router

#ProtocolPortDescription
1UDP8090Archivist Discovery
2TCP8070Archivist Transport

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

You also can use Archivist App UI to interact with your local Archivist 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

Testnet bootstrap nodes records could be found in GitHub repository and accessed via endpoints

Smart contracts

ContractAddress
Token0x3b7412Ee1144b9801341A4F391490eB735DDc005
Verifier0xfF043672Ea1Da9Be566Ecf683Bfc055BaD2C1B7D
Marketplacemarketplace.archivist.storage/testnet/latest

Endpoints

#ServiceURL
1Arbitrum Public RPCrpc.testnet.archivist.storage
2Block explorersepolia.arbiscan.io
3Faucet ETHfaucet-arb.testnet.archivist.storage
4Faucet TSTfaucet-tst.testnet.archivist.storage
5Status pagestatus.testnet.archivist.storage