@arkade-os/skill

Arkade SDK skills for agent integration - send and receive Bitcoin over Arkade, onchain via onboard/offboard, Lightning Network via Boltz, and swap USDC/USDT via LendaSwap.

Features

• Bitcoin on Arkade: Instant offchain Bitcoin transactions
• Onchain Payments: Get paid onchain (onboard) and pay onchain (offboard)
• Lightning Network: Pay and receive via Boltz submarine swaps
• Stablecoin Swaps: Trade BTC for USDC/USDT on Polygon, Ethereum, Arbitrum
• CLI for Agents: Command-line interface designed for MoltBot and other agents

Default Server: https://arkade.computer

Installation

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

Quick Start

CLI Usage

# Initialize wallet
arkade init <private-key-hex>

# Check balance
arkade balance

# Send Bitcoin
arkade send <ark-address> 50000

# Create Lightning invoice
arkade ln-invoice 25000 "Coffee payment"

# Pay Lightning invoice
arkade ln-pay lnbc...

SDK Usage

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

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

// Bitcoin operations
const bitcoin = new ArkadeBitcoinSkill(wallet);
const balance = await bitcoin.getBalance();
await bitcoin.send({ address: "ark1...", amount: 50000 });

// Lightning operations
const lightning = new ArkaLightningSkill({ wallet, network: "bitcoin" });
const invoice = await lightning.createInvoice({ amount: 25000 });

// Stablecoin swaps
const lendaswap = new LendaSwapSkill({ wallet, apiKey: "..." });
const quote = await lendaswap.getQuoteBtcToStablecoin(100000, "usdc_pol");

Available Skills

| Skill | Description | |-------|-------------| | ArkadeBitcoinSkill | Send/receive BTC via Arkade offchain, get paid onchain (onboard), pay onchain (offboard) | | ArkaLightningSkill | Lightning payments via Boltz swaps | | LendaSwapSkill | USDC/USDT swaps via LendaSwap |

CLI Commands

| Command | Description | |---------|-------------| | init <key> [url] | Initialize wallet | | address | Show Ark address | | boarding-address | Show boarding address | | balance | Show balance breakdown | | send <addr> <amt> | Send sats | | history | Transaction history | | onboard | Get paid onchain: convert received onchain BTC to offchain | | offboard <addr> | Pay onchain: send offchain BTC to an onchain address | | ln-invoice <amt> | Create Lightning invoice | | ln-pay <bolt11> | Pay Lightning invoice | | ln-fees | Show swap fees | | ln-limits | Show swap limits | | swap-quote <amt> <from> <to> | Get stablecoin quote | | swap-to-stable <amt> <token> <chain> <addr> | Swap BTC to stablecoin | | swap-to-btc <amt> <token> <chain> <addr> | Swap stablecoin to BTC | | swap-status <id> | Check swap status | | swap-pending | Show pending swaps | | swap-pairs | Show trading pairs |

Configuration

• Data: ~/.arkade-wallet/config.json
• Env: LENDASWAP_API_KEY for stablecoin swaps

Documentation

See SKILL.md for detailed agent integration documentation.

License

MIT