Repository navigation
Command Overview
Terramike edited this page Oct 1, 2026
·
8 revisions
Every command in the skill, grouped by what it does. Commands marked PROPOSE build a transaction and stop — a human must approve the exact proposal hash before xrpl-sign will sign and submit it. Everything else is read-only and free to run.
| Command | What it does | Needs approval |
|---|---|---|
xrpl-trade buy --pair P --amount A --price P |
PROPOSE buying BASE with QUOTE at a limit price | Yes |
xrpl-trade sell --pair P --amount A --price P |
PROPOSE selling BASE for QUOTE at a limit price | Yes |
xrpl-trade cancel --seq N |
PROPOSE cancelling an open offer | Yes |
xrpl-trade send --to <addr> --amount A [--ccy C] |
PROPOSE sending XRP or an IOU | Yes |
xrpl-trade trustline --currency USD --issuer r… --limit 1000 |
PROPOSE opening a trustline | Yes |
xrpl-trade quote --pair XRP/RLUSD |
Live order book: bid/ask/mid/spread | No |
xrpl-trade plan-trade --pair P --side {buy,sell} --amount A --price P |
Estimate fill, price impact, max spend | No |
xrpl-trade inspect-token --currency FUZZY --issuer r… |
Issuer risk: domain, transfer fee, freeze flags | No |
xrpl-trade pairs |
List your approved trading pairs | No |
xrpl-trade balance [address] |
XRP + trustline balances | No |
xrpl-trade reconcile --hash H |
Validated on-ledger outcome of a submitted tx | No |
Amounts are in BASE units; price is QUOTE per BASE. --pair resolves from your approved-pairs file, or pass explicit issuers.
| Command | What it does | Needs approval |
|---|---|---|
xrpl-trade flow --address r… |
Value-flow graph from an address's history (delivered value only, tesSUCCESS) |
No |
xrpl-trade trace --hash H |
Follow a transaction's on-ledger trail | No |
xrpl-trade token-trail <token> |
Movement history of an issued token | No |
xrpl-trade nft-trail <NFTokenID> |
Ownership trail of an NFT, holder verified at a pinned validated ledger | No |
xrpl-trade kyc-report --address r… |
Account summary with risk flags | No |
xrpl-trade cluster --address r… |
Counterparty clusters from history | No |
Forensic commands report on-ledger facts with LINK:/NOTE: discipline — they never claim common ownership without control overlap. UNVERIFIED is shown when a holder can't be pinned to the validated ledger.
| Command | What it does | Needs approval |
|---|---|---|
xrpl-trade farm |
Farmers Union overview (read-only) | No |
xrpl-trade farm status |
Program status and current dusting info | No |
xrpl-trade farm qualify --address r… |
Check an address's qualification | No |
xrpl-trade farm treasury |
Treasury holdings | No |
Farm P1+P2 is read-only. Never recommend a trustline without screening the exact issuer; every trustline uses propose → approve → sign.
| Command | What it does | Needs approval |
|---|---|---|
xrpl-trade luck |
LuckyHash lottery info | No |
xrpl-trade koi |
Koi NFT info | No |
xrpl-trade xrplf |
XRPL Foundation resources | No |
xrpl-trade coffee |
Coffee & Crypto giveaway info | No |
xrpl-trade xboost |
xBoost X-Spaces engagement info | No |
xrpl-trade validators |
Signed validator-list health | No |
xrpl-trade amendments |
Live amendment vote counts | No |
xrpl-trade stablecoin <SYM> |
Stablecoin supply by chain + price (DefiLlama, aggregator-not-authority) | No |
xrpl-trade oracle <BASE> <QUOTE> |
XLS-47 oracle prices (Band Protocol + DIA, publisher-attested) | No |
| Command | What it does | Needs approval |
|---|---|---|
xrpl-trade nft-stage --file <path> --name <name> |
Validate + hash artwork LOCALLY — zero network calls — prints a stage id | No |
xrpl-trade nft-pin-and-propose --stage <id> --approve-stage <full-sha256> |
Check independent stage approval before vault credential access/upload; pin staged art and PROPOSE the mint | Yes |
xrpl-trade nft-list --token-id <id> --price-xrp 25 |
PROPOSE listing an owned NFT for sale (XRP, sell offer, expiry required) | Yes |
xrpl-trade nft-buy --offer-index <idx> |
Verify the sell offer from the ledger, then PROPOSE accepting it | Yes |
xrpl-trade nft-bid --token-id <id> --seller r… --price-xrp 5 |
PROPOSE a buy offer (bid) — disabled by default, must be opted into | Yes |
xrpl-trade nft-inventory [address] |
List NFTs owned by an account | No |
xrpl-trade nft-send --token-id <id> --to <name-or-address> |
Gift/transfer an NFT via 0-XRP transfer offer (recipient accepts to claim) | Yes |
xrpl-trade nft-new |
New mints from your favorite artists, with prices and xrp.cafe links | No |
Royalty is 0–5000 bps (default 1000 = 10%) and immutable after mint.
| Command | What it does | Needs approval |
|---|---|---|
xrpl-trade favorites add <name> <address> |
Watch an artist wallet (local file, no ledger) | No |
xrpl-trade favorites list / rename / remove
|
Manage the watchlist | No |
Anonymous, read-only, no API key. Results carry deep links — you buy in XRPresso's UI.
| Command | What it does | Needs approval |
|---|---|---|
xrpl-trade xrpresso listings [--q …] |
Search marketplace listings | No |
xrpl-trade xrpresso nfts [--q …] [--sort price_asc] |
XRPresso-native NFT listings | No |
xrpl-trade xrpresso listing <id> |
Full detail for one listing | No |
xrpl-trade xrpresso auctions |
Live NFT auctions | No |
xrpl-trade xrpresso stats |
Marketplace aggregates | No |
xrpl-trade xrpresso categories |
Listing category keys | No |
Local onboarding — your display name, watch-only addresses, memberships, interests, and alert preferences. Stored in ~/.xrpl/profile.json (owner-only 0600) and never leaves your machine: no network, no proposals, no signing. Memberships drive reminders, alert settings drive price-move alerts, interests personalize menus. It never asks for a seed — seed-like input is refused with a warning and never stored.
| Command | What it does | Needs approval |
|---|---|---|
xrpl-trade profile init |
Interactive questionnaire to build your profile | No |
xrpl-trade profile show |
Print the current profile | No |
xrpl-trade profile set <key> <value> |
display_name, alerts.price_moves, alerts.threshold_pct
|
No |
xrpl-trade profile add-address r… / remove-address
|
Watch-only addresses (checksummed; seed-like strings refused) | No |
xrpl-trade profile add-membership <tag> / remove-membership
|
Open membership tags (e.g. xaodao) |
No |
xrpl-trade profile add-interest <tag> / remove-interest
|
Open interest tags (e.g. trading) |
No |
xrpl-trade profile clear |
Delete the profile | No |
Newly public in v0.6.0 — a Friday community giveaway paid from the donation wallet.
| Command | What it does | Needs approval |
|---|---|---|
xrpl-trade giveaway opt-in |
PROPOSE an opt-in 1-drop payment (destination tag 777); normal exact-hash approval required | Yes |
xrpl-trade giveaway entrants |
List eligible entrants | No |
xrpl-trade giveaway draw |
Verifiable Friday draw from a future ledger hash | No |
xrpl-trade giveaway status |
Entrants, config, donation-wallet inventory | No |
xrpl-trade giveaway gift --to <winner> --amount <n> --ccy XRP |
PROPOSE a gift from the donation wallet — a human approves each gift; never auto-sends | Yes |
xrpl-trade giveaway setup |
Narrow giveaway signing policy | No |
xrpl-trade giveaway announce |
Draft winner announcement | No |
| Command | What it does | Needs approval |
|---|---|---|
xrpl-trade setup |
Register a public address, or optionally generate a local testnet/devnet wallet; mainnet provisioning is vault-only | No |
xrpl-trade faucet |
Fund a fresh testnet/devnet wallet | No |
xrpl-trade wallet create --network testnet |
Create local test wallet with typed, network/account-bound credential storage | No |
xrpl-trade wallet create --network mainnet |
Refused; provision mainnet credentials in the secure vault | No |
xrpl-trade wallet backup --network testnet |
Display a local testnet seed once for offline backup; run outside chat to avoid transcript exposure | No |
xrpl-trade wallet backup --network mainnet |
Refused; mainnet backup remains in the secure vault | No |
xrpl-trade wallet forget-seed |
Remove legacy disk seed after address confirmation | No |
xrpl-sign --profile <name> --hash <full-64-char-hash> --approve |
Verify profile/envelope/policy, sign, submit, and wait for a validated result. Muse must gate this on genuine approval; the CLI flag alone is not approval | Human approval of the exact operation |
xrpl-sign init-policy / migrate-policy
|
Write / upgrade the policy file | No |
xrpl-sign init-profiles |
Create named account/network/credential/policy/state bindings from configured public settings | No |
xrpl-sign sync-profile --profile <name> |
Record the reviewed policy digest after a deliberate policy edit | No |
xrpl-sign recover-state |
Fail-closed validation or explicitly reviewed state reconstruction; preserves damaged source | No |
xrpl-sign migrate-state --profile <name> --legacy-state {default,giveaway} |
Copy validated old liabilities into stable account/network accounting namespace | No |
xrpl-trade doctor |
Read-only local diagnostics; cannot attest Muse's deployed vault/runtime boundary | No |
- v0.14.1 — third-party audit of v0.14.0: seven findings fixed, Farm Helper (read-only), nft-new crash fix + scan trim, nft-trail holder verification.
-
v0.12 —
validators/amendmentsnetwork watches,stablecoinsupply,oracleXLS-47 prices. - v0.9–v0.13 — ecosystem add-ins: LuckyHash, Koi, XRPLF, Coffee & Crypto, xBoost; forensics v2.
- v0.8 — remediation: named profiles, proposal/5 binding, strict validation, full-hash approval.
See Home for the current release and the release notes on GitHub for full detail.
Propose → approve → sign. Nothing moves without your hash.