RLUSD CLI

RLUSD CLI is the deterministic runtime for multi-chain RLUSD operations.

RLUSD CLI is a developer-oriented command-line runtime for Ripple USD operations across XRPL, Ethereum, and supported DeFi workflows. It is designed for both human operators and agents that need structured JSON outputs, reviewable plans, and clear failure modes.

The CLI treats RLUSD as the primary object rather than treating any single chain as the center. This matters because RLUSD exists across multiple rails, and agents need a consistent way to resolve metadata, inspect balances, prepare transactions, and verify receipts. For institutional or developer teams, that consistency reduces the operational risk of asking agents to work across ledger environments.

Install

npm install -g @rlusd/cli

Or build from source.

git clone https://github.com/t54-labs/rlusd-cli.git
cd rlusd-cli
npm install
npm run build
npm link

Supported Operations

Area	Examples
Metadata	Resolve RLUSD asset metadata for a configured chain.
Wallets	Generate, list, and use encrypted local wallet aliases.
XRPL	Trust-line setup, account info, payment preparation, execution, wait, and receipt.
Ethereum	RLUSD transfers, approvals, transaction wait, and receipt.
DeFi	Venue discovery, live swap quotes, prepared swaps, Curve LP workflows, and Aave supply flows.
x402	Buyer-side x402 fetch with an XRPL wallet and spending cap.

Every command supports JSON output for automation. The stable response envelope includes fields such as ok, command, chain, timestamp, data, warnings, and next.

Rendering Mermaid graph...

Prepare, Review, Execute

Most write flows create deterministic plans before execution.

rlusd xrpl payment prepare \
  --chain xrpl-mainnet \
  --from-wallet treasury-xrpl \
  --to rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe \
  --amount 250 \
  --json

Execution then loads the stored plan and verifies its integrity.

rlusd xrpl payment execute \
  --plan ~/.config/rlusd-cli/plans/plan_x.json \
  --confirm-plan-id plan_x \
  --password "$RLUSD_WALLET_PASSWORD" \
  --json

After execution, agents confirm validation and read a receipt.

rlusd xrpl tx wait --chain xrpl-mainnet --hash ABC... --json
rlusd xrpl payment receipt --chain xrpl-mainnet --hash ABC... --json

Security Model

Prepared plans do not store signer material. Wallet files live under the local RLUSD CLI configuration directory and are encrypted. Execution requires the selected wallet and password or compatible local secret handling. If the plan has been modified, execution fails with a plan integrity error.

This model is important for agentic workflows. It gives agents a deterministic runtime while keeping side effects behind explicit commands, stored plans, and receipt verification. The same pattern supports later underwriting and audit needs because actions can be traced from request to plan to execution to receipt.

Relationship To RLUSD Skills

RLUSD Skills teach agents how to use the CLI correctly. RLUSD CLI performs the actual runtime work. The two repositories are separate so that skill prompts, routing rules, and docs can evolve while the CLI remains the authoritative runtime for ledger behavior.

PreviousRLUSD Skills NextXRPL x402 Facilitator