# Send Bitcoin Wallet for Agents using Arkade to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "bitcoin-arkade-wallet",
    "name": "Bitcoin Wallet for Agents using Arkade",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/tiero/bitcoin-arkade-wallet",
    "canonicalUrl": "https://clawhub.ai/tiero/bitcoin-arkade-wallet",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/bitcoin-arkade-wallet",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bitcoin-arkade-wallet",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "cli/arkade.mjs",
      "package.json",
      "pnpm-lock.yaml",
      "pnpm-workspace.yaml"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/bitcoin-arkade-wallet"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/bitcoin-arkade-wallet",
    "downloadUrl": "https://openagent3.xyz/downloads/bitcoin-arkade-wallet",
    "agentUrl": "https://openagent3.xyz/skills/bitcoin-arkade-wallet/agent",
    "manifestUrl": "https://openagent3.xyz/skills/bitcoin-arkade-wallet/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/bitcoin-arkade-wallet/agent.md"
  }
}
```
## Documentation

### Arkade Skill

Send and receive Bitcoin over Arkade (offchain), onchain (via onboard/offboard), and Lightning Network.
Swap between BTC and stablecoins (USDC/USDT) via LendaSwap.

Payment methods:

Offchain (Arkade): Instant transactions between Arkade wallets
Onchain: Get paid onchain via boarding address (onboard), pay onchain via offboard
Lightning: Pay and receive via Boltz submarine swaps

Default Server: https://arkade.computer

### Agent Safety Rules

IMPORTANT: The following commands move real funds. The agent MUST always ask the user for explicit confirmation before executing them, displaying the amount and destination:

send — sends sats to an Ark address
offboard — moves offchain BTC to an onchain Bitcoin address
onboard — moves onchain BTC into Arkade
ln-pay — pays a Lightning invoice
swap-to-stable / swap-to-btc — executes a stablecoin swap
swap-claim / swap-refund — claims or refunds a swap

Read-only commands (address, balance, history, ln-invoice, ln-fees, ln-limits, ln-pending, swap-quote, swap-pairs, swap-status, swap-pending, boarding-address) are safe to run without confirmation.

Wallet initialization: init creates a new private key stored at ~/.arkade-wallet/config.json (permissions 0600). All other commands require init to have been run first. The agent MUST inform the user and get confirmation before running init for the first time.

### Quick Start (no install required)

# Using pnpm (recommended)
pnpm dlx @arkade-os/skill init
pnpm dlx @arkade-os/skill address

# Using npx
npx -y -p @arkade-os/skill arkade init
npx -y -p @arkade-os/skill arkade address

### Global Install

# Install globally
npm install -g @arkade-os/skill
# or
pnpm add -g @arkade-os/skill

# Then use directly
arkade init
arkade address

### As a dependency

npm install @arkade-os/skill
# or
pnpm add @arkade-os/skill

### CLI Commands

Note: Examples below use arkade directly (assumes global install).
For pnpm: pnpm dlx @arkade-os/skill <command>
For npx: npx -y -p @arkade-os/skill arkade <command>

### Wallet Management

# Initialize wallet (auto-generates private key, default server: arkade.computer)
arkade init

# Initialize with custom server
arkade init https://custom-server.com

# Show Ark address (for receiving offchain Bitcoin)
arkade address

# Show boarding address (for onchain deposits)
arkade boarding-address

# Show balance breakdown
arkade balance

### Bitcoin Transactions

# Send sats to an Ark address
arkade send <ark-address> <amount-sats>

# Example: Send 50,000 sats
arkade send ark1qxyz... 50000

# View transaction history
arkade history

### Onchain Payments (Onboard/Offboard)

# Get paid onchain: Receive BTC to your boarding address, then onboard to Arkade
# Step 1: Get your boarding address
arkade boarding-address

# Step 2: Have someone send BTC to your boarding address

# Step 3: Onboard the received BTC to make it available offchain
arkade onboard

# Pay onchain: Send offchain BTC to any onchain Bitcoin address
arkade offboard <btc-address>

# Example: Pay someone at bc1 address
arkade offboard bc1qxyz...

### Lightning Network

# Create a Lightning invoice to receive payment
arkade ln-invoice <amount-sats> [description]

# Example: Create invoice for 25,000 sats
arkade ln-invoice 25000 "Coffee payment"

# Pay a Lightning invoice
arkade ln-pay <bolt11-invoice>

# Show swap fees
arkade ln-fees

# Show swap limits
arkade ln-limits

# Show pending swaps
arkade ln-pending

### Stablecoin Swaps (LendaSwap)

# Get quote for BTC to stablecoin swap
arkade swap-quote <amount-sats> <from> <to>

# Example: Quote 100,000 sats to USDC on Polygon
arkade swap-quote 100000 btc_arkade usdc_pol

# Show available trading pairs
arkade swap-pairs

Supported Tokens:

btc_arkade - Bitcoin on Arkade
usdc_pol - USDC on Polygon
usdc_eth - USDC on Ethereum
usdc_arb - USDC on Arbitrum
usdt_pol - USDT on Polygon
usdt_eth - USDT on Ethereum
usdt_arb - USDT on Arbitrum

### SDK Usage

import { Wallet, SingleKey } from "@arkade-os/sdk";
import {
  ArkadeBitcoinSkill,
  ArkaLightningSkill,
  LendaSwapSkill,
} from "@arkade-os/skill";

// Create wallet (default server: arkade.computer)
const wallet = await Wallet.create({
  identity: SingleKey.fromHex(privateKeyHex),
  arkServerUrl: "https://arkade.computer",
});

// === Bitcoin Operations ===
const bitcoin = new ArkadeBitcoinSkill(wallet);

// Get addresses
const arkAddress = await bitcoin.getArkAddress();
const boardingAddress = await bitcoin.getBoardingAddress();

// Check balance
const balance = await bitcoin.getBalance();
console.log("Total:", balance.total, "sats");
console.log("Offchain available:", balance.offchain.available, "sats");
console.log("Onchain pending:", balance.onchain.total, "sats");

// Send Bitcoin
const result = await bitcoin.send({
  address: recipientArkAddress,
  amount: 50000,
});
console.log("Sent! TX:", result.txid);

// === Lightning Operations ===
const lightning = new ArkaLightningSkill({
  wallet,
  network: "bitcoin",
});

// Create invoice
const invoice = await lightning.createInvoice({
  amount: 25000,
  description: "Coffee payment",
});
console.log("Invoice:", invoice.bolt11);

// Pay invoice
const payment = await lightning.payInvoice({
  bolt11: "lnbc...",
});
console.log("Paid! Preimage:", payment.preimage);

// === Stablecoin Swaps ===
const lendaswap = new LendaSwapSkill({ wallet });

// Get quote
const quote = await lendaswap.getQuoteBtcToStablecoin(100000, "usdc_pol");
console.log("You'll receive:", quote.targetAmount, "USDC");

// Execute swap
const swap = await lendaswap.swapBtcToStablecoin({
  targetAddress: "0x...", // EVM address
  targetToken: "usdc_pol",
  targetChain: "polygon",
  sourceAmount: 100000,
});
console.log("Swap ID:", swap.swapId);

### Configuration

Data Storage: ~/.arkade-wallet/config.json

Private keys are auto-generated on first use and stored locally. They are never exposed via CLI arguments or stdout. No environment variables required. The LendaSwap API is publicly accessible.

### ArkadeBitcoinSkill

getArkAddress() - Get Ark address for receiving offchain payments
getBoardingAddress() - Get boarding address for receiving onchain payments
getBalance() - Get balance breakdown
send(params) - Send Bitcoin to Ark address (offchain)
getTransactionHistory() - Get transaction history
onboard(params) - Get paid onchain: convert onchain BTC to offchain
offboard(params) - Pay onchain: send offchain BTC to any onchain address
waitForIncomingFunds(timeout?) - Wait for incoming funds

### ArkaLightningSkill

createInvoice(params) - Create Lightning invoice
payInvoice(params) - Pay Lightning invoice
getFees() - Get swap fees
getLimits() - Get swap limits
getPendingSwaps() - Get pending swaps
getSwapHistory() - Get swap history
isAvailable() - Check if Lightning is available

### LendaSwapSkill

getQuoteBtcToStablecoin(amount, token) - Quote BTC to stablecoin
getQuoteStablecoinToBtc(amount, token) - Quote stablecoin to BTC
swapBtcToStablecoin(params) - Swap BTC to stablecoin
swapStablecoinToBtc(params) - Swap stablecoin to BTC
getSwapStatus(swapId) - Get swap status
getPendingSwaps() - Get pending swaps
getSwapHistory() - Get swap history
getAvailablePairs() - Get available trading pairs
claimSwap(swapId) - Claim completed swap
refundSwap(swapId) - Refund expired swap

### Networks

Arkade supports multiple networks:

bitcoin - Bitcoin mainnet
testnet - Bitcoin testnet
signet - Bitcoin signet
regtest - Local regtest
mutinynet - Mutiny signet

### Support

GitHub: https://github.com/arkade-os/skill
Documentation: https://docs.arkadeos.com
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: tiero
- Version: 1.0.5
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/bitcoin-arkade-wallet)
- [Send to Agent page](https://openagent3.xyz/skills/bitcoin-arkade-wallet/agent)
- [JSON manifest](https://openagent3.xyz/skills/bitcoin-arkade-wallet/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/bitcoin-arkade-wallet/agent.md)
- [Download page](https://openagent3.xyz/downloads/bitcoin-arkade-wallet)