SUBTC CLI V2 — Real Testnet Flow

2026-03-18 permalink SUBTC

This guide shows a complete payment flow using SUBTC CLI V2
with live testnet results.

# Step 1: Create Key

./subtc key create

Key Created
────────────────────────────────────────────
key:                 SUBTC-KEY-79821c194cd50ff0ce948920532fd8953a8c417de3d61c90
✓ Key saved → ~/.subtc.json

# Step 2: Check Key Status

./subtc key status

Key Status
────────────────────────────────────────────
{
  "ok": true,
  "request_id": "fcf859dae07b00d7",
  "result": {
    "key": "SUBTC-KEY-79821c194cd50ff0ce948920532fd8953a8c417de3d61c90",
    "wallet_count": 0
  }
}

# Step 3: Set Network to Testnet

./subtc config set-net test
✓ Default network → testnet

# Step 4: Create Wallet

./subtc wallet create

Wallet Created · testnet
────────────────────────────────────────────
wallet_id: w_acfd7aa7e54f31d533c4f6eed2cf18c9c192957c2f2e

# Step 5: Generate Receive Address

./subtc wallet receive w_acfd7aa7e54f31d533c4f6eed2cf18c9c192957c2f2e

Receive Address · testnet
────────────────────────────────────────────
address: tb1qhcy9w09yk22ppf3fdg6twnjh2zvgarf4zlsw4s

# Step 6: Check Wallet Balance

./subtc wallet balance w_acfd7aa7e54f31d533c4f6eed2cf18c9c192957c2f2e

Balance · w_acfd7aa7e5…  testnet
────────────────────────────────────────────
balance: 191849 sat  (0.00191849 BTC)
unconfirmed: 191849 sat  (0.00191849 BTC)

# Step 7: Wait for Funds (Blocking)

./subtc wait w_acfd7aa7e54f31d533c4f6eed2cf18c9c192957c2f2e tb1qhcy9w09yk22ppf3fdg6twnjh2zvgarf4zlsw4s 30000

Waiting for Funds · testnet
────────────────────────────────────────────
wallet_id: w_acfd7aa7e54f31d533c4f6eed2cf18c9c192957c2f2e
address: tb1qhcy9w09yk22ppf3fdg6twnjh2zvgarf4zlsw4s
expected_sat: 30000 sat
received: 191849 sat

# Step 8: Send BTC

./subtc send w_acfd7aa7e54f31d533c4f6eed2cf18c9c192957c2f2e tb1qjcr7lcucmwudwqscew4r078gxkw549ruq5r97w 50000

Send BTC · testnet
────────────────────────────────────────────
wallet_id: w_acfd7aa7e54f31d533c4f6eed2cf18c9c192957c2f2e
to: tb1qjcr7lcucmwudwqscew4r078gxkw549ruq5r97w
amount: 50000 sat  (0.00050000 BTC)
fee: 3% (service + network)
✓ Transaction broadcast
txid: 7360354a92094b97f20df66eab5c4da4bfa6e3ceba86ae4e6d5a077a06d7809f
sent_sat: 48500 sat
fee_sat: 1500 sat

# Step 9: Check Balance After Send

./subtc wallet balance w_acfd7aa7e54f31d533c4f6eed2cf18c9c192957c2f2e

Balance · w_acfd7aa7e5…  testnet
────────────────────────────────────────────
balance: 41849 sat  (0.00041849 BTC)
unconfirmed: 0 sat

# Step 10: Health Check

./subtc health

Health · testnet
────────────────────────────────────────────
{
  "ok": true,
  "request_id": "ee7d76f45093c3fe",
  "result": {
    "coin": "btc",
    "configured": true,
    "fee_bps": 300,
    "min_send_sat": 20000
  }
}

# Step 11: Show Config

./subtc config show

Config
────────────────────────────────────────────
key: SUBTC-KEY-79••••••••
network: test  testnet
file: ~/.subtc.json
env-override: SUBTC_KEY · SUBTC_NET

# ✅ Summary

- Created key & wallet
- Generated receive address
- Checked balance
- Waited for funds
- Sent BTC
- Verified final balance
- Health check & config review

All commands tested successfully on **V2**.
# tools subtc cli v2 : https://subtc.net/post/subtc-cli-v2-unified-bitcoin-cli

SUBTC CLI V2 — Real Testnet Flow

Related Articles