Stellar CLI Skill

Interact with the Stellar blockchain: manage wallets, send XLM, configure networks, and work with Soroban smart contracts.

---

First-Run Setup (automatic)

When this skill is first used, run these steps automatically — do NOT ask the user for confirmation:

1. Connect to testnet and verify:

stellar network use testnet
stellar network health --network testnet

If the health check fails, inform the user and stop.

1. Create and fund a default wallet:

stellar keys generate default --fund --network testnet
stellar keys use default
stellar keys public-key default

If default already exists, skip generation and just verify with stellar keys public-key default.

1. Report to the user:

✅ Stellar CLI ready. Network: testnet | Wallet: default | Public key: G... | Funded with 10,000 test XLM.

If the user asks to switch to mainnet, warn that real funds are involved and require explicit confirmation.

---

Wallet Management

Create a wallet

stellar keys generate <NAME> --fund --network testnet

--fund uses Friendbot to send 10,000 test XLM. Omit it for an unfunded identity. Add --overwrite to replace an existing identity with the same name.

List wallets

stellar keys ls -l

Get public key / secret key

stellar keys public-key <NAME>
stellar keys secret <NAME>

Warning: Never share secret keys — they grant full control of the account.

Import an existing key

stellar keys add <NAME> --public-key <G_ADDRESS>

Fund / set default / remove

stellar keys fund <NAME> --network testnet
stellar keys use <NAME>
stellar keys rm <NAME>

---

Sending XLM

stellar tx new payment \
  --source-account <SENDER> \
  --destination <RECEIVER> \
  --amount <STROOPS> \
  --network <NETWORK>

--amount is in stroops (1 XLM = 10,000,000 stroops):

XLM	Stroops
1	10000000
10	100000000
100	1000000000

--source-account and --destination accept identity names (e.g. alice) or public keys (G...). --asset defaults to native (XLM). For other assets: --asset CODE:ISSUER. --inclusion-fee <STROOPS> overrides the default 100 stroop fee.

Example: send 10 XLM

stellar tx new payment \
  --source-account default \
  --destination <RECEIVER> \
  --amount 100000000 \
  --network testnet

Build → Sign → Send (manual pipeline)

# 1. Build
stellar tx new payment \
  --source-account default \
  --destination <RECEIVER> \
  --amount 100000000 \
  --network testnet \
  --build-only > tx.xdr

# 2. Sign
stellar tx sign --sign-with-key default --network testnet < tx.xdr > signed_tx.xdr

# 3. Send
stellar tx send --network testnet < signed_tx.xdr

Create a new on-chain account

stellar tx new create-account \
  --source-account default \
  --destination <NEW_PUBLIC_KEY> \
  --network testnet

---

Network Management

Built-in networks: testnet, futurenet, mainnet, local.

stellar network use <NAME>
stellar network health --network <NAME>
stellar network ls

Add a custom network:

stellar network add <NAME> \
  --rpc-url <RPC_URL> \
  --network-passphrase "<PASSPHRASE>"