Guides

Network: testnet & mainnet

TuskPoint defaults to Walrus testnet, where writes are free and need no setup. Switch to mainnet for durable, paid storage whenever you are ready. Reads are public and free on either network.

The default — testnet, free writes

Out of the box TuskPoint points at the public Walrus testnet endpoints. Testnet has a public, unauthenticated publisher, so you can save, fork, roll back, and hand off checkpoints without any wallet or tokens. These are the built-in defaults — you do not need to set anything:

env (testnet — the default)

WALRUS_AGGREGATOR_URL=https://aggregator.walrus-testnet.walrus.space
WALRUS_PUBLISHER_URL=https://publisher.walrus-testnet.walrus.space

Switching to mainnet

When you want durable, paid storage, set both environment variables to the mainnet endpoints. They always take precedence over the testnet defaults:

env (mainnet)

WALRUS_AGGREGATOR_URL=https://aggregator.walrus-mainnet.walrus.space
WALRUS_PUBLISHER_URL=https://walrus-mainnet-publisher-1.staketab.org:443

Mainnet writes — need a publisher

Storing a blob on mainnet costs SUI (gas) plus WAL (storage), so there is no public, unauthenticated publisher. You have three options:

1. Community publisher — quickest to try; may rate-limit or require an allowlist. This is the default in .env.example:

env

WALRUS_PUBLISHER_URL=https://walrus-mainnet-publisher-1.staketab.org:443

2. Run your own publisher — recommended for production. Run the Walrus publisher with a funded Sui wallet and point WALRUS_PUBLISHER_URL at it.

terminal

walrus publisher --sui-wallet <path-to-wallet> ...

3. Use the upload relay — the mainnet relay at https://upload-relay.mainnet.walrus.space with a funded key.

Everything is env-overridable

WALRUS_PUBLISHER_URL and WALRUS_AGGREGATOR_URL always take precedence over the built-in testnet defaults. Reads work without any of the above — only writes (checkpoint_save, checkpoint_fork) need a publisher.