Quickstart

You need Node 20 or later. The arx CLI comes with the TypeScript SDK, which has no runtime dependencies and also runs in browsers and Workers.

1. Install and connect

npm install -g @arxium-protocol/sdk
arx --version

export ARX_RPC=https://retracer-api.arxium.network/rpc/corechain-devnet
export ARX_TOKEN=rk_...            # your API key
arx query status

status prints the chain name, tip height and genesis_hash. Keep the genesis hash: it identifies this chain, and you'll compare against it in Verify without a node.

2. Get a key and test ARX

Sign in at console.arxium.network. Generate a signing key under Settings. It's created and encrypted in your browser, and the passphrase never leaves it. Then open Faucet and claim 10 ARX. You can claim again every 100 blocks, and the faucet only pays the Console key. Back in Settings, click Export encrypted key and bring the file into the CLI:

arx keys import --file arxium-devnet-key-xxxxxxxx.json
export ARX_KEY=arxium-devnet-key-xxxxxxxx.json
arx keys show                       # address, no passphrase needed
arx query account arx1...           # balance 10000000000 = 10 ARX

Amounts are integers in base units: 1 ARX = 1,000,000,000 IUM. arx asks for the passphrase when it signs, or reads it from ARX_PASSPHRASE in scripts. arx keys new makes a key entirely offline, but it starts at zero balance.

3. Send your first transfer

Make a second key and send it 1 ARX.

arx keys new holder.json            # prints the holder's address
arx send transfer arx1holder... 1000000000

send fetches your nonce, signs locally, submits, and waits for the block. The output has the signed action, including its signature, and "status": "confirmed" with the height. A rejected action prints the node's reason and exits 1. Each action costs a flat fee of 0.001 ARX.

4. See it in the Explorer

Open explorer.arxium.network/address/arx1… with either address, or paste the signature into the Explorer's search. The transfer is listed with its block and finality.

5. Verify it yourself

arx verify <signature>
{
  "signature": "2523…b904",
  "finalized": true,
  "signatureValid": true,
  "height": 22
}

arx verify doesn't take the node's word for anything except where the action landed. It fetches that block and checks that it's finalized and contains your action. Then it verifies the Ed25519 signature against the sender's address on your own machine.