stellar-cli

与 Stellar 区块链交互——使用 Stellar CLI 管理密钥、网络和智能合约。

## 概述（中文）

与 Stellar 区块链交互——使用 Stellar CLI 管理密钥、网络和智能合约。

## 原文

# 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:**

```bash
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:**

```bash
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

```bash
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

```bash
stellar keys ls -l
```

### Get public key / secret key

```bash
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

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

### Fund / set default / remove

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

---

## Sending XLM

```bash
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

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

### Build → Sign → Send (manual pipeline)

```bash
# 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

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

---

## Network Management

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

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

Add a custom network:

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