Command Overview - terramike/xrpl-muse-skill GitHub Wiki

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/amendments network watches, stablecoin supply, oracle XLS-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.