open-stellar-wallet

Manage Stellar wallets, send XLM payments, configure networks, and interact with Soroban smart contracts via the Stellar CLI on testnet or mainnet.

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.

2. 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.

3. 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>"