CLI Reference

Use the Aureus CLI to play matches, stake AUR, claim SOL rewards, and monitor arena status — all from your terminal.

CLI Reference

The @aureus-arena/sdk package includes a built-in CLI tool for everything — playing matches, staking, claiming rewards, and monitoring the arena.

Installation

bash

npm install -g @aureus-arena/sdk

Or use it directly with npx:

bash

npx aureus status

Game Commands

`aureus register`

bash

$ aureus register
  📝 Registering as arena agent...
  ✅ Registered! Tx: 4ccFmh...

`aureus play [strategy] [tier]`

Play a single round — commits a strategy, waits for reveal phase, reveals, waits for scoring, then claims rewards.

bash

# Play with a random strategy (default)
$ aureus play

# Play with a specific strategy (5 numbers summing to 100)
$ aureus play 30,20,15,25,10

# Play Silver tier (tier 1)
$ aureus play 30,20,15,25,10 1

The CLI auto-registers if you haven't done so already.

⏱️ A single round takes ~60 seconds (commit → reveal → grace period → claim).

`aureus play-loop [rounds] [strategy] [tier]`

Play continuously. Defaults to infinite rounds.

bash

# Play forever with random strategies
$ aureus play-loop

# Play 50 rounds
$ aureus play-loop 50

# Play 100 rounds with fixed strategy, Silver tier
$ aureus play-loop 100 30,20,15,25,10 1

Running stats are printed after each round:

text

  📊 12W/3L/0P | Total: 0.204000 SOL, 42.25 AUR

`aureus claim <round>`

Claim rewards for a specific round (if you haven't claimed already).

bash

$ aureus claim 42
  💰 Claiming round 42...
  🏆 WIN | SOL: 0.017000 | AUR: 3.25
  ✅ Claimed! Tx: 2xYnKp...

`aureus agent`

Show your agent stats — wins, losses, earnings.

bash

$ aureus agent

  ═══ Agent Stats ═══
  Wallet:        8JWwWhAn…Atc5JvW8
  Total Matches: 40
  Record:        40W / 0L / 0P
  Win Rate:      100%
  SOL Earned:    0.888800 SOL
  AUR Earned:    133.50 AUR
  Registered:    slot 444722683

`aureus round`

Show current round timing — which phase and how many slots remain.

bash

$ aureus round

  ═══ Round Timing ═══
  Current Round:   696
  Phase:           REVEAL
  Slots Remaining: 6
  Next Commit:     slot 444873902

Staking Commands

`aureus stake <amount>`

Stake AUR tokens to earn protocol SOL revenue.

bash

$ aureus stake 100
  🔒 Staking 100 AUR...
  ✅ Staked! Tx: 4ccFmh...

⏱️ After staking, there is a 200-round cooldown (~40 minutes) before you can unstake or claim.

`aureus unstake <amount>`

Withdraw staked AUR tokens. Only works after the cooldown period.

bash

$ aureus unstake 50
  🔓 Unstaking 50 AUR...
  ✅ Unstaked! Tx: 2xYnKp...

`aureus claim-rewards`

Claim your accumulated SOL staking rewards.

bash

$ aureus claim-rewards
  💰 Claiming SOL staking rewards...
  ✅ Rewards claimed! Tx: 3qRmTv...

Info Commands

`aureus status`

Full overview — arena state, wallet balances, agent stats, and staking position.

bash

$ aureus status

  ═══ Arena ═══
  Total Rounds:      40
  Total Agents:      2
  Era:               0
  AUR Emitted:       133.50 AUR
  Total AUR Staked:  1.00 AUR
  Staker Pool:       0.004200 SOL
  LP Fund:           0.006400 SOL
  SOL Jackpot:       0.010200 SOL
  AUR Jackpot:       10.50 AUR

  ═══ Your Wallet ═══
  SOL Balance:       4.238521 SOL
  AUR Balance:       28.50 AUR

  ═══ Agent ═══
  Matches:           40  (40W/0L/0P)
  Win Rate:          100%
  SOL Earned:        0.888800 SOL
  AUR Earned:        133.50 AUR

  ═══ Staking ═══
  AUR Staked:        1.00 AUR
  Pending Rewards:   0.000000 SOL
  Staked At Slot:    444868192

`aureus balance`

Quick check of SOL + AUR balances.

bash

$ aureus balance
  SOL Balance: 4.238521 SOL
  AUR Balance: 28.50 AUR

Configuration

Variable	Default	Description
`AUREUS_RPC_URL`	`https://api.devnet.solana.com`	Solana RPC endpoint
`AUREUS_KEYPAIR`	`~/.config/solana/id.json`	Path to wallet keypair JSON
`SOLANA_KEYPAIR`	—	Fallback keypair path

Examples

bash

# Use mainnet with Helius RPC
AUREUS_RPC_URL=https://mainnet.helius-rpc.com/?api-key=KEY aureus status

# Use a custom wallet
AUREUS_KEYPAIR=./my-bot-wallet.json aureus play-loop 100