Network and RPC

Use this page to configure wallets and apps for Radius. It includes network values, RPC behavior, rate limits, and fee configuration patterns.

Network configuration

Radius Network

Radius Testnet

Add Radius to a wallet

MetaMask

1. Open MetaMask and select Add network.
2. Enter the values from the table above.
3. Save and switch to the Radius network you configured.

Programmatic setup (viem)

Use the Radius chain definition from Tooling configuration — chain definition. No fee overrides are needed — viem's built-in estimation works with Radius.

Terminal and agent setup (radius-cli)

Use radius-cli for local wallet and agent execution. Set the network explicitly because the CLI defaults to mainnet:

RADIUS_HOME=.radius RADIUS_NETWORK=testnet RADIUS_RPC_URL={TESTNET_RPC_URL} \
  radius-cli wallet balance --json

For command examples, see radius-cli.

RPC endpoints and transport

• HTTP RPC: Use the endpoint values in the network tables.
• WebSocket RPC: Requires an RPC key with elevated privileges.

For WebSocket access requests, use the Radius contact form.

API keys and rate limiting

Radius tracks request volume per API key.

• Requests without an API key have lower limits.
• Default API key limit is 10 MGas/s.
• For higher limits, use the Radius contact form.

In this context, “MGas” includes both RPC calls and gas consumed by submitted transactions.

Avoid throttling

1. Reuse API keys consistently per environment.
2. Add client-side retry with exponential backoff for 429-style responses.
3. Cache frequent read requests where possible.
4. Batch reads with Multicall3 when practical.
5. Queue and smooth bursty traffic instead of sending spikes.

RPC key URL format

Append your API key to the RPC URL path:

JSON-RPC behavior to account for

Radius is EVM compatible, but some methods differ from Ethereum behavior:

• eth_blockNumber returns the current timestamp in milliseconds
• eth_getBalance returns native balance plus convertible SBC balance
• eth_gasPrice returns the fixed network gas price
• eth_feeHistory returns a pseudo-supported response

See JSON-RPC API for method details and Ethereum compatibility for rationale.

Get testnet funds

Use the Radius testnet faucet (Dashboard) to claim SBC tokens with a point-and-click interface.

For programmatic and agent access, use Create and Fund a Wallet. The agentic faucet flow is available on testnet only — use the Dashboard or bridge stablecoins for mainnet.

x402 facilitator endpoints

Use the Radius facilitator for x402 payment settlement. Each network has a dedicated facilitator URL.

For integration patterns, see x402 payments. For the facilitator API reference, see x402 facilitator API.

Related pages

• JSON-RPC API
• Fees
• Contract addresses
• Ethereum compatibility