fth-xrpl CLI

The XRPL testnet utility. Every command that talks to a server first checks that the network id is 1.

Commands that exist

fth-xrpl wallet-new <file>          create a new Ed25519 wallet file; prints the address only
fth-xrpl wallet-address <file>      print the address of an existing wallet file
fth-xrpl fund <file>                ask the public testnet faucet to fund the wallet's address
fth-xrpl balances <file>            XRP balance, sequence and trust lines
fth-xrpl book <currency> <issuer>   top of book for XRP against an issued currency
fth-xrpl trust <file> currency=<c> issuer=<i> limit=<n> [--yes]
fth-xrpl order <file> <buy|sell> qty=<xrp> limit=<price> currency=<c> issuer=<i> [--yes]

Dry run first

trust and order sign and submit only with --yes. Without it they print the exact transaction and exit 2. Run them only with an explicit approval for that exact transaction.

Wallet files

• Keep wallet files outside any repository.
• A wallet file must be exactly 32 hexadecimal digits; it is never sliced or echoed, and the secret is never printed or sent. The faucet receives the address only.
• wallet-new creates a new file only and refuses to overwrite an existing one.
• On Windows, inherited permissions are removed and only the current user is granted access.
• A file is written to a temporary name, flushed, restricted, then renamed, so a failed write leaves no partial wallet.

Exit codes

0 on success, 1 on an error or bad usage, 2 when a dry run printed a transaction and sent nothing.

Token commands

Six commands for issuing and controlling tokens: built and reviewed, testnet only, not yet run. See Token tools on testnet.