Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Create and Fund a Wallet

Go from zero to funded testnet wallet
View as Markdown

This guide gets you a funded Radius testnet wallet using only a terminal or agent workflow. It is designed for developers and autonomous agents that need programmatic onboarding.

What your agent will do

  1. Generate a new wallet securely
  2. Fund it via the Faucet API
  3. Verify its balance on-chain

Prerequisites

  • Node.js 20 or later
  • radius-cli
  • Claude Code, Codex, or equivalent agentic software tools when using the skill flow

Install or run radius-cli:

npx radius-cli --help

Or install globally:

npm install -g radius-cli
radius-cli --help

Create a project-scoped wallet

Use RADIUS_HOME to keep an agent wallet local to the current project:

export RADIUS_HOME=.radius
export RADIUS_NETWORK=testnet
export RADIUS_SBC_ADDRESS={FEE_CONTRACT}
 
radius-cli wallet address

The first account-needing command creates a local keystore if one does not exist. Log the wallet address only. Do not print or commit private keys.

Use the Dripping Faucet Skill

Use the dripping-faucet skill when an agent should complete the whole testnet funding flow, including challenge signing if required and balance verification.

claude "Read docs.radiustech.xyz/skills/dripping-faucet.md and fund a local testnet wallet. Use RADIUS_HOME=.radius, RADIUS_NETWORK=testnet, and radius-cli for wallet address, signing, and balance checks."

After funding, verify the balance:

RADIUS_HOME=.radius RADIUS_NETWORK=testnet RADIUS_SBC_ADDRESS={FEE_CONTRACT} \
  radius-cli wallet balance --json

:::note Testnet only The agentic faucet workflow targets Radius Testnet. For mainnet, use the Dashboard to claim SBC, or bridge stablecoins from Ethereum or Base. :::

What's next