Skip to content

examples.md

Latest commit

 

History

History
107 lines (82 loc) · 2.78 KB

examples.md

File metadata and controls

107 lines (82 loc) · 2.78 KB

Examples

Real-world usage examples for common XRPL workflows.

Basic Workflow

# Full flow: generate wallet, fund it, send a payment
xrpl wallet generate
export XRPL_SEED=sEdV...
xrpl wallet fund --network testnet
xrpl send --to ra5nK24KXen9AHvsdFTKHSANinZseWnPcX --amount 25 --token XRP --network testnet

Multi-Signing

# Set up a multisig account
xrpl signer-list-set --quorum 3 \
  --signer rAddr1:1 --signer rAddr2:1 --signer rAddr3:1 --signer rAddr4:1
xrpl account-set --flag asfDisableMaster

# Multi-sign a payment from the multisig
xrpl send --to rSomeAddr --amount 10 --token XRP --prepare --signers 3 > unsigned.json
XRPL_SEED=sSigner1... xrpl multisign --file unsigned.json --multisig-account rMultisig > sig1.json
XRPL_SEED=sSigner2... xrpl multisign --file unsigned.json --multisig-account rMultisig > sig2.json
XRPL_SEED=sSigner3... xrpl multisign --file unsigned.json --multisig-account rMultisig > sig3.json
xrpl multisign-submit --files sig1.json sig2.json sig3.json

Trust Lines and IOUs

# Create a trust line, then send an IOU
xrpl trust-set USD rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B --limit 1000000
xrpl send --to rSomeAddr --amount 50 --token USD.rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B

Multi-Purpose Tokens

# Issue and send an MPT
xrpl mpt-create --asset-scale 2 --can-transfer --metadata 4D79546F6B656E
xrpl mpt-authorize 00064D1C63CEBEB49FC20032206CE0F203138BFC59F1AC578
xrpl send --to rHolder --amount 100 --token mpt:00064D1C63CEBEB49FC20032206CE0F203138BFC59F1AC578

NFTs

# Work with NFTs
xrpl nft-mint --taxon 0 --uri "ipfs://QmExample" --transfer-fee 5000
xrpl account-nfts rMyAccount
xrpl nft-offer-create 000800006... --amount 10 --token XRP --sell

AMM

# Create and use an AMM
xrpl amm-create --amount1 1000 --token1 XRP --amount2 1000 --token2 USD.rIssuer --trading-fee 500
xrpl amm-info --asset XRP --asset2 USD.rIssuer

DEX

# Query the order book
xrpl book-offers XRP USD.rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B --limit 5

Real-Time Events

# Watch ledger events in real time
xrpl subscribe --streams ledger transactions

Escape Hatches

# Use the escape hatches for anything not covered
xrpl build Batch --RawTransactions '[...]'
xrpl rpc vault_info '{"vault_id": "..."}'
xrpl rpc server_state

Cross-Chain Memos

# Send with memos
xrpl send --to ra5nK24KXen9AHvsdFTKHSANinZseWnPcX --amount 1 --token XRP \
  --memo "type:interchain_transfer" \
  --memo "destination_chain:ethereum" \
  --memo "destination_address:0x0A90c0Af1B07f6AC34f3520348Dbfae73BDa358E"

Keystore Workflow

# Import and use a keystore wallet
xrpl wallet import alice -i
xrpl wallet list
xrpl balance rMyAccount --from alice
xrpl send --to rDest --amount 10 --token XRP --from alice