rwa-wallet（RWA 钱包）

Hard rules

• Prefer encrypted wallets for new setups
• Use rwa --json for agent-driven send/reclaim flows
• send transfers assets; it does not sell them
• After liquidation, run reclaim before final send SOL all
• For post-sell withdrawals, prefer exact values from CLI output when available

JSON / dry-run defaults

• Default to rwa --json for send and reclaim flows
• Use --dry-run for gm send when previewing a transfer for the user
• There is no --dry-run for keys commands; use keys show for low-risk inspection
• Do not use -y with --dry-run

Intent -> command

Do

• Use keys show before asking the user to fund the wallet
• Default to encrypted wallet creation/import
• Use --dry-run when previewing transfers for the user
• Use send USDC all and send SOL all for “withdraw everything”

Don't

• Do not tell the agent to “sell” when the real intent is “send”
• Do not use manual arithmetic for final withdrawal amounts if CLI already returned them
• Do not skip reclaim after close-all when the goal is full withdrawal

Install

curl -fsSL https://raw.githubusercontent.com/outputlayer/rwa_cli/main/install.sh | sh

Wallet commands

rwa keys generate
rwa keys generate --encrypt
rwa keys import --seed-phrase "word1 ... word12"
rwa keys import --seed-phrase "word1 ... word12" --encrypt
rwa keys import --private-key <BASE58>
rwa keys import --file <PATH>
rwa keys show
rwa keys encrypt
rwa keys decrypt

Passphrase

If ~/.config/rwa/key.age exists, commands prompt for the passphrase.

export RWA_PASSPHRASE="my passphrase"
rwa --json gm portfolio

Send / withdraw

rwa --json gm send SOL 1.5 <ADDR> --dry-run
rwa --json gm send SOL all <ADDR> -y
rwa --json gm send USDC 100 <ADDR> --dry-run
rwa --json gm send USDC all <ADDR> -y
rwa --json gm send TSLA 0.5 <ADDR> -y

Canonical examples

Create an encrypted wallet, then show the address:

rwa keys generate --encrypt
rwa keys show

Preview then send USDC:

rwa --json gm send USDC 100 <ADDR> --dry-run
rwa --json gm send USDC 100 <ADDR> -y

Withdraw everything after liquidation:

rwa --json gm reclaim
rwa --json gm send USDC all <ADDR> -y
rwa --json gm send SOL all <ADDR> -y

Shortest path

• Need wallet address -> rwa keys show
• New wallet -> rwa keys generate --encrypt
• Import wallet -> rwa keys import... --encrypt
• Withdraw everything after liquidation -> send USDC all, then send SOL all
• Recover locked SOL -> reclaim
• Pure transfer flow -> go straight to gm send; do not call portfolio unless the user asked about holdings

Reclaim rent

rwa --json gm reclaim
rwa --json gm reclaim --token TSLA

Run this after selling or transferring out tokens to recover locked SOL from empty accounts.

Cheapest useful call

Canonical withdrawal flow

rwa --json gm close-all -y
rwa --json gm reclaim
rwa --json gm send USDC all <ADDR> -y
rwa --json gm send SOL all <ADDR> -y

Notes

• send USDC all uses full on-chain precision
• send SOL all auto-reserves tx fees and now uses exact lamport arithmetic
• The install script prefers a release binary and falls back to source install
• For faster/private RPC, set RWA_RPC_URL

export RWA_RPC_URL=https://your-rpc-endpoint.com