@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

As an Agent Skill

Install directly into your coding agent using the Vercel Skills CLI:

npx skills add arkade-os/skill

This discovers the arkade skill and installs it into supported agents (Claude Code, Cursor, etc.).

You can also target a specific agent or install globally:

# Install to a specific agent
npx skills add arkade-os/skill --agent claude-code

# Install globally (user-level)
npx skills add arkade-os/skill -g

As an npm Package

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

CLI Commands

Configuration

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

Documentation

See SKILL.md for detailed agent integration documentation.

License

MIT