From xrpl-up
CLI for the XRP Ledger — local sandbox management, wallets, transactions, DeFi, NFTs, and more
How this skill is triggered — by the user, by Claude, or both
Slash command
/xrpl-up:xrpl-upThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
The user has made a natural language request: **$ARGUMENTS**
references/account.mdreferences/amm.mdreferences/channel.mdreferences/check.mdreferences/clawback.mdreferences/common-workflows.mdreferences/credential.mdreferences/deposit-preauth.mdreferences/did.mdreferences/escrow.mdreferences/mptoken.mdreferences/multisig.mdreferences/nft.mdreferences/node-management.mdreferences/offer.mdreferences/oracle.mdreferences/payment.mdreferences/permissioned-domain.mdreferences/ticket.mdreferences/trust.mdThe user has made a natural language request: $ARGUMENTS
Your job is to translate it into one or more xrpl-up CLI commands, then execute them.
Steps:
xrpl-up <command> --help or read references/<command>.md for full flag details.If $ARGUMENTS is empty, ask the user what they'd like to do on the XRP Ledger.
Mandatory. Never bypass.
--seed / --private-key values in output, files, or history.--account <alias> --password <pass> over raw --seed in pipelines.wallet private-key output is a secret — do not forward it to other tools.--node local|testnet|devnet|<ws://...> default: local (ws://localhost:6006)
--help flag details for any command
--version
Network shorthands: local → localhost, testnet → altnet.rippletest.net, devnet → devnet.rippletest.net
Two flag systems: Transaction commands (payment, trust, amm, nft, etc.) use the global
--nodeflag above. Sandbox management commands (start, stop, accounts, faucet, amendment, run) use their own--network/--local-networkflags instead — seereferences/node-management.md.
Key material (one required on every transaction command):
--seed sEd... family seed
--mnemonic "word word ..." BIP39 mnemonic
--account <address-or-alias> load from encrypted keystore (needs --password in non-TTY)
Amount formats:
"10" 10 XRP (decimal)
"10/USD/rIssuerAddress..." 10 USD IOU
"500/<48-hex-issuance-id>" 500 MPT units
Asset specs (AMM/vault):
XRP native XRP
USD/rIssuerAddress... IOU asset
XRP in drops (AMM only): 1000000 drops = 1 XRP
Common output flags (most TX commands):
--json machine-readable output
--dry-run print signed tx without submitting
--no-wait submit without waiting for validation (not available on: account set)
| Command | Description |
|---|---|
xrpl-up start | Start local rippled Docker sandbox |
xrpl-up start --detach | Start in background (CI) |
xrpl-up start --local-network | 2-node consensus network with snapshot support |
xrpl-up stop | Stop local sandbox |
xrpl-up reset | Wipe all local state |
xrpl-up status | Show node health |
xrpl-up logs [rippled|faucet] | Stream Docker logs |
xrpl-up accounts | List sandbox pre-funded accounts |
xrpl-up snapshot save/restore/list | Manage ledger snapshots |
xrpl-up amendment list/info/enable | Inspect and enable amendments |
See references/node-management.md for full options.
| Command | Description |
|---|---|
wallet new | Generate a new wallet |
wallet new-mnemonic | Generate a BIP39 mnemonic wallet |
wallet import <key> | Import seed/mnemonic/private-key into keystore |
wallet list | List keystore entries |
wallet fund <address> | Fund from testnet/devnet faucet |
wallet address/public-key/private-key | Derive key material |
wallet sign | Sign a message or transaction offline |
wallet verify | Verify a signature |
wallet alias set/list/remove | Manage keystore aliases |
wallet change-password | Re-encrypt a keystore entry |
wallet decrypt-keystore | Decrypt and print seed/private-key |
wallet remove | Delete a keystore entry |
All wallet subcommands accept --keystore <dir> and (where applicable) --password <pass> for non-TTY use.
See references/wallet.md for full options.
| Command | Description |
|---|---|
account info <address> | Full on-ledger account info |
account balance <address> | XRP balance (--drops for raw drops) |
account trust-lines <address> | List trust lines |
account offers <address> | List open DEX offers |
account channels <address> | List payment channels |
account transactions <address> | Recent transactions |
account nfts <address> | NFTs owned |
account mptokens <address> | MPT balances |
account set | AccountSet (domain, flags, clawback…) |
account delete | Delete account (irreversible, ~2 XRP fee) |
account set-regular-key | Assign/remove regular key |
See references/account.md for full options.
| Command | Description |
|---|---|
payment / send | Send XRP, IOU, or MPT |
trust set | Create/update trust line |
offer create/cancel | DEX offer management |
clawback | Claw back IOU or MPT from holder |
channel create/fund/sign/verify/claim/list | Payment channels |
escrow create/finish/cancel/list | Time-locked or condition-based escrows |
check create/cash/cancel/list | Deferred payment checks |
multisig set/list/delete | Multi-signature signer lists |
ticket create/list | Ticket sequence management |
deposit-preauth set/list | Deposit preauthorization |
| Command | Description |
|---|---|
amm create/deposit/withdraw/vote/bid/delete/clawback/info | AMM liquidity pools |
nft mint/burn/modify | NFT lifecycle |
nft offer create/accept/cancel/list | NFT marketplace |
mptoken issuance create/destroy/set/list/get | MPT issuance management |
mptoken authorize | Holder opt-in / issuer authorize |
vault create/set/deposit/withdraw/delete/clawback | Single-asset vaults (devnet) |
| Command | Description |
|---|---|
credential create/accept/delete/list | On-chain credentials (XLS-70) |
did set/delete | Decentralized Identifiers (XLS-40) |
oracle set/delete/get | On-chain price oracles |
permissioned-domain create/update/delete | Permissioned domains (XLS-80) |
Send XRP on testnet:
xrpl-up --node testnet payment \
--to rDestination... --amount 10 \
--seed sEdAlice...
Issue IOU — trust line then payment:
# Bob sets up trust line to Alice's USD
xrpl-up --node testnet trust set \
--currency USD --issuer rAlice... --limit 1000 \
--seed sEdBob...
# Alice issues 100 USD to Bob
xrpl-up --node testnet payment \
--to rBob... --amount 100/USD/rAlice... \
--seed sEdAlice...
Create and fund a keystore wallet in CI (non-interactive):
# Generate + save (--password required in non-TTY)
xrpl-up wallet new --save --alias alice --password "$KS_PASS"
# Fund on testnet
xrpl-up --node testnet wallet fund rAlice...
# Use alias for subsequent transactions
xrpl-up --node testnet payment \
--to rBob... --amount 5 \
--account rAlice... --password "$KS_PASS"
MPT: create issuance, opt in, send:
xrpl-up --node testnet mptoken issuance create \
--flags can-transfer --max-amount 1000000 \
--seed sEdAlice... --json
# → {"issuanceId":"0000001AABBCC..."}
xrpl-up --node testnet mptoken authorize 0000001AABBCC... --seed sEdBob...
xrpl-up --node testnet payment \
--to rBob... --amount 500/0000001AABBCC... \
--seed sEdAlice...
For complete flag tables, look up the relevant file in references/:
wallet.md · account.md · payment.md · trust.md · offer.md · clawback.md · channel.md · escrow.md · check.md · amm.md · nft.md · multisig.md · oracle.md · ticket.md · credential.md · mptoken.md · permissioned-domain.md · vault.md · did.md · deposit-preauth.md · common-workflows.md · node-management.md
npx claudepluginhub ripple/xrpl-up --plugin xrpl-upAccesses Alchemy APIs for RPC, tokens, NFTs, transfers, and transaction simulation. Supports API key, x402 (USDC), and MPP (USDC/Stripe) auth on EVM and SVM.
Use the Alchemy CLI for live blockchain queries, token/NFT lookups, transaction simulation, webhook management, and Alchemy app admin. Ideal for agent-driven automation, not production code.
Issues and manages Stellar classic assets, trustlines, authorization flags, clawback, and the SAC bridge to Soroban. Use when tokenizing assets, issuing stablecoins, or bridging to Soroban contracts.