Devnet Docs
Internal reference for engineers working with the Sietch devnet stack.
Architecture
Sietch devnet runs a validator set producing blocks via BFT consensus, ZK proof generation for every mint/transfer/burn, and on-chain SHPLONK/BN254 verification on the Ethereum bridge. The Ethereum L1 layer runs on Reth in dev mode with disk-backed MDBX storage, preserving block history from genesis. The watcher process monitors L1 deposit events and submits mint proofs to validators.
This explorer indexes Sietch chain state and bridge contract events into Postgres, then serves it. It does not replace sietch-cli or node RPC -- it reads what they expose.
Devnet vs production
Devnet runs the same consensus, circuit constraints, and EVM verification contracts targeted for mainnet. Proofs are generated and verified end-to-end. Block finality, state roots relayed to L1, and bridge deposit/withdrawal flows match production semantics.
Both the Sietch chain and the Reth-backed L1 persist state from block 0 across restarts. Devnet differs from production in three ways: genesis pre-funded accounts, a small validator set, and no economic stake. Treat it as a test environment; nothing here is audited or financially guaranteed.
Performance profile
Each Sietch RPC node in the current devnet runs on 1 GB RAM and 1 CPU, with finality landing around ~120 ms per block in internal runs across validator sets.
Benchmarks (throughput, proof latency, memory profiles) will land with the public codebase release. Numbers above are measurements, not estimates.
Testnet targets 50–90 ms finality.
Services
This UI. Indexed devnet state: blocks, mempool, pool, bridge, watcher health.
Ethereum L1 block explorer using Reth's ots_* APIs; covers blocks, transactions, logs, and decoded calldata from genesis.
Contract verification; verified sources let Otterscan decode function calls and events.
CLI quick reference
Use sietch-cli to interact with devnet wallets and the chain:
| Command | Purpose |
|---|---|
| wallet create --name alice | Create a new wallet with a random seed |
| wallet list | List wallets, balances, and note counts |
| deposit-eth --name alice --amount 1 | Deposit ETH into the shielded pool via L1 bridge |
| transfer --from alice --to bob --amount 0.5 | Private transfer inside the pool |
| withdraw-eth --name bob --amount 0.5 | Withdraw ETH back to L1 |
| status | Node connection, block height, state root |
Default RPC is http://127.0.0.1:11000 (validator-0). Pass --rpc-url to target a different validator.
Full CLI reference and deployment config live in the sietch-core/deploy/README.md and docs/rnd/TOOLING.md files inside the repository.