Devnet

Try out the developer testnet

Welcome! This walkthrough is quick. It only requires a minute of actual attention, while the rest is waiting. If you run into any issues, please check if it's one of the 10 common errors resolved in the FAQ section. You can also hop in our discord and ask questions in the #devnet channel.

If you end up deploying your own custom contract, please send the github link to @lyronc on TG! Also note, this is not an incentivized testnet.

Works on Mac, Linux, and Windows via WSL (see FAQ).

Deploy an encrypted contract

1. Install Rust

curl https://sh.rustup.rs -sSf | sh  # choose default, just press enter
. "$HOME/.cargo/env"

2. Install jq

For Mac. See instructions for your machine here. Only step that isn't OS agnostic.

brew install jq

3. Install sfoundryup

curl -L \
     -H "Accept: application/vnd.github.v3.raw" \
     "https://api.github.com/repos/SeismicSystems/seismic-foundry/contents/sfoundryup/install?ref=seismic" | bash
source ~/.bashrc

4. Run sfoundryup

sfoundryup  # takes between 5m to 60m, and stalling for a while at 98% normal

5. Clone repository

git clone --recurse-submodules https://github.com/SeismicSystems/try-devnet.git
cd try-devnet/packages/contract/

6. Deploy contract

bash script/deploy.sh

Interact with an encrypted contract

1. Install Bun

curl -fsSL https://bun.sh/install | bash

2. Install node dependencies

cd try-devnet/packages/cli/
bun install

3. Send transactions

bash script/transact.sh

FAQ

What if I'm on Windows?

We recommend using WSL to run commands as if you were on a Linux machine. Run

wsl --install

Now restart your computer. After booting back up, you should be able to run the below command and follow the rest of the steps like normal

wsl
I'm stuck at 1108/1112 when running sfoundryup .

Some machines take up to an hour to do this step. If it takes longer, ask a question in our discord's #devnet channel.

I'm getting Command failed: cargo build --bins --release.

Means your machine doesn't have cargo. If you're on Linux, run

sudo apt update && sudo apt install -y build-essential
sudo apt install cargo -y
I'm getting jq (command not found).

Means step #2 didn't work. If you're on Linux, run

sudo apt-get install jq
I'm getting Address not funded. Please check if your faucet transaction went...

Means your wallet has no testnet ETH. Please go to the faucet, enter the address the script gave you, and wait for the green confirmation.

I'm getting Command 'brew' not found.

Means your machine doesn't have the Homebrew package manager. Run

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
I'm getting linker 'cc' not found.

You can resolve by running

sudo apt update && sudo apt install -y build-essential
sudo apt install cargo -y
I'm getting command not found: sfoundryup .

If this comes up even after you complete step #3 successfully, restart your terminal. Should be able to run it after.

I'm getting info: aborting installation .

Means you aren't selecting an option for your Rust installation. Run the curl command again, and press Enter.

I'm getting Command: 'bun' not found.

You need to add bun to your PATH. You can either do this temporarily in your current terminal via the below command (you'll have to do it for every new window):

export PATH="/home/$(whoami)/.bun/bin:$PATH"

Or set it properly, by opening up your ~/.bashrc and adding

PATH="/home/$(whoami)/.bun/bin:$PATH"

NOTE: This is a testnet with known decryption keys. Please don't put real information on it!

Last updated