Skip to content
Zroarus
TestnetBuilder Hub

Build on Zroarus

Zroarus is EVM-compatible. If you have built on Ethereum, you already know the tools. Start on Testnet, where test tokens are free and fees are effectively zero.

Read the docs First contractNetwork config Grants Coming Soon

Quick start

  1. Step 1

    Add the network

    Chain ID 305583, RPC https://rpc.testnet.zroarus.com. Wallet setup

  2. Step 2

    Fund a test wallet

    Claim tZROAR for gas from the faucet(opens in a new tab). Use a wallet you only use for testing.

  3. Step 3

    Compile for Cancun

    Set evmVersion: "cancun". Solidity 0.8.30+ defaults to Prague, which Testnet does not run.

  4. Step 4

    Deploy and inspect

    Deploy with your usual tools, then look up the transaction on the explorer(opens in a new tab).

Your first contract with Foundry

Standard Foundry commands with the verified Testnet settings.

  1. Install Foundry from its official guide(opens in a new tab), then run forge init my-first-zroarus-app. It creates a sample Counter contract.
  2. Replace foundry.toml with the configuration shown here. evm_version = "cancun" is required.
  3. Create a new wallet account used only for testing, and claim tZROAR from the faucet.
  4. Deploy. The key is read into your shell session only, never written to a file.
  5. Copy the transaction hash into the explorer search. Blocks are final after one block (about 2 seconds).

Keep keys out of your code

Never commit a private key, even a Testnet one, and never reuse a Testnet key on any other network. Nobody from Zroarus will ask for it.
foundry.toml
[profile.default]
src = "src"
out = "out"
libs = ["lib"]
solc_version = "0.8.28"
evm_version = "cancun"

[rpc_endpoints]
zroarus_testnet = "https://rpc.testnet.zroarus.com"
Deploy
# Use a test-only wallet. Load its key into this shell session only.
read -rs ZROARUS_TESTNET_KEY && export ZROARUS_TESTNET_KEY

forge create src/Counter.sol:Counter \
  --rpc-url zroarus_testnet \
  --private-key "$ZROARUS_TESTNET_KEY" \
  --broadcast

unset ZROARUS_TESTNET_KEY
Check the connection
cast chain-id --rpc-url https://rpc.testnet.zroarus.com   # 305583
cast block-number --rpc-url https://rpc.testnet.zroarus.com

Network configuration

Generated from the site's verified network configuration. Tool versions shown are examples; any EVM tooling that accepts a custom chain works.

viem
import { defineChain, createPublicClient, http } from "viem";

export const zroarusTestnet = defineChain({
  id: 305583,
  name: "Zroarus Testnet",
  nativeCurrency: { name: "Zroarus Testnet Token", symbol: "tZROAR", decimals: 18 },
  rpcUrls: {
    default: { http: ["https://rpc.testnet.zroarus.com"], webSocket: ["wss://rpc.testnet.zroarus.com/ws"] },
  },
  blockExplorers: { default: { name: "Zroarus Testnet Explorer", url: "https://explorer-testnet.zroarus.com" } },
  testnet: true,
});

export const client = createPublicClient({ chain: zroarusTestnet, transport: http() });
ethers v6
import { JsonRpcProvider, Network } from "ethers";

const network = Network.from({ chainId: 305583, name: "zroarus-testnet" });
export const provider = new JsonRpcProvider("https://rpc.testnet.zroarus.com", network, { staticNetwork: network });
Hardhat
// hardhat.config.ts
import type { HardhatUserConfig } from "hardhat/config";
import "@nomicfoundation/hardhat-toolbox";

const key = process.env.ZROARUS_TESTNET_KEY; // from your environment, never committed

const config: HardhatUserConfig = {
  solidity: { version: "0.8.28", settings: { evmVersion: "cancun", optimizer: { enabled: true, runs: 200 } } },
  networks: {
    zroarusTestnet: { url: "https://rpc.testnet.zroarus.com", chainId: 305583, accounts: key ? [key] : [] },
  },
};
export default config;

Resources

Each resource is labelled with its current state.

Supported languages and tools

Confirmed on Testnet

  • Solidity contracts compiled for the Cancun EVM
  • Standard Ethereum JSON-RPC (ETH, NET, WEB3, TXPOOL) over HTTPS and WebSocket
  • EIP-1559 (type 2) and legacy EIP-155 transactions
  • Multicall3, Permit2 and the CREATE2 deployer at their canonical addresses

Documented configuration

Configuration for viem, ethers v6, Hardhat and Foundry is published above. These are standard EVM tools with no Zroarus-specific plugins.

Not available on Testnet

  • EIP-7702 (type 4) transactions and other Prague features
  • debug_* and trace_* RPC methods
  • Price oracles and bridges

Get help, share work, get funded