@arkade-os/skill 0.1.1 → 0.1.3

package/README.md

@@ -1,6 +1,6 @@
 # @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.
+Arkade 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
 
@@ -89,7 +89,7 @@ const lightning = new ArkaLightningSkill({ wallet, network: "bitcoin" });
 const invoice = await lightning.createInvoice({ amount: 25000 });
 
 // Stablecoin swaps
-const lendaswap = new LendaSwapSkill({ wallet, apiKey: "..." });
+const lendaswap = new LendaSwapSkill({ wallet });
 const quote = await lendaswap.getQuoteBtcToStablecoin(100000, "usdc_pol");
 ```
 
@@ -127,7 +127,6 @@ const quote = await lendaswap.getQuoteBtcToStablecoin(100000, "usdc_pol");
 ## Configuration
 
 - **Data:** `~/.arkade-wallet/config.json`
-- **Env:** `LENDASWAP_API_KEY` for stablecoin swaps
 
 ## Documentation
 

package/SKILL.md

@@ -10,11 +10,9 @@ read_when:
   - user wants to get paid onchain or pay someone onchain
   - user mentions boarding address or VTXOs
   - user wants instant Bitcoin payments
+requires: []
 metadata:
   emoji: "₿"
-  requires:
-    - private key (64 hex characters)
-    - LENDASWAP_API_KEY (for stablecoin swaps)
 ---
 
 # Arkade Skill
@@ -35,13 +33,11 @@ Swap between BTC and stablecoins (USDC/USDT) via LendaSwap.
 
 ```bash
 # Using pnpm (recommended)
-pnpm dlx @arkade-os/skill generate
-pnpm dlx @arkade-os/skill init <private-key-hex>
+pnpm dlx @arkade-os/skill init
 pnpm dlx @arkade-os/skill address
 
 # Using npx
-npx -y -p @arkade-os/skill arkade generate
-npx -y -p @arkade-os/skill arkade init <private-key-hex>
+npx -y -p @arkade-os/skill arkade init
 npx -y -p @arkade-os/skill arkade address
 ```
 
@@ -54,8 +50,7 @@ npm install -g @arkade-os/skill
 pnpm add -g @arkade-os/skill
 
 # Then use directly
-arkade generate
-arkade init <private-key-hex>
+arkade init
 arkade address
 ```
 
@@ -76,14 +71,11 @@ pnpm add @arkade-os/skill
 ### Wallet Management
 
 ```bash
-# Generate a new random private key
-arkade generate
-
-# Initialize wallet with private key (default server: arkade.computer)
-arkade init <private-key-hex>
+# Initialize wallet (auto-generates private key, default server: arkade.computer)
+arkade init
 
 # Initialize with custom server
-arkade init <private-key-hex> https://custom-server.com
+arkade init https://custom-server.com
 
 # Show Ark address (for receiving offchain Bitcoin)
 arkade address
@@ -151,8 +143,6 @@ arkade ln-pending
 
 ### Stablecoin Swaps (LendaSwap)
 
-Requires `LENDASWAP_API_KEY` environment variable.
-
 ```bash
 # Get quote for BTC to stablecoin swap
 arkade swap-quote <amount-sats> <from> <to>
@@ -229,10 +219,7 @@ const payment = await lightning.payInvoice({
 console.log("Paid! Preimage:", payment.preimage);
 
 // === Stablecoin Swaps ===
-const lendaswap = new LendaSwapSkill({
-  wallet,
-  apiKey: process.env.LENDASWAP_API_KEY,
-});
+const lendaswap = new LendaSwapSkill({ wallet });
 
 // Get quote
 const quote = await lendaswap.getQuoteBtcToStablecoin(100000, "usdc_pol");
@@ -252,8 +239,7 @@ console.log("Swap ID:", swap.swapId);
 
 **Data Storage:** `~/.arkade-wallet/config.json`
 
-**Environment Variables:**
-- `LENDASWAP_API_KEY` - Required for stablecoin swaps
+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.
 
 ## Skill Interfaces
 

package/cli/arkade.mjs

@@ -5,12 +5,12 @@
  *
  * This CLI is designed for agent integration (CLI-friendly for agents like MoltBot).
  * Data is stored in ~/.arkade-wallet/config.json
+ * Private keys are auto-generated and stored locally — never exposed via CLI args.
  *
  * Default server: https://arkade.computer
  *
  * Usage:
- *   arkade generate                   # Generate random private key
- *   arkade init <key> [url]           # Initialize wallet
+ *   arkade init [url]                 # Initialize wallet (auto-generates key)
  *   arkade address                    # Show Ark address
  *   arkade boarding-address           # Show boarding address
  *   arkade balance                    # Show balance breakdown
@@ -28,7 +28,7 @@
  *   arkade help                       # Show help
  */
 
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 
@@ -55,9 +55,10 @@ function loadConfig() {
  */
 function saveConfig(config) {
   if (!existsSync(CONFIG_DIR)) {
-    mkdirSync(CONFIG_DIR, { recursive: true });
+    mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
   }
   writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+  chmodSync(CONFIG_FILE, 0o600);
 }
 
 /**
@@ -86,15 +87,35 @@ async function getSDK() {
 }
 
 /**
- * Create wallet from config.
+ * Auto-initialize wallet config by generating a new private key.
+ */
+async function autoInit(serverUrl) {
+  const { sdk } = await getSDK();
+  const { SingleKey } = sdk;
+
+  const identity = SingleKey.fromRandomBytes();
+  const privateKey = Buffer.from(identity.key).toString("hex");
+  const url = serverUrl || DEFAULT_SERVER;
+
+  const config = {
+    privateKey,
+    serverUrl: url,
+    createdAt: new Date().toISOString(),
+  };
+
+  saveConfig(config);
+  return config;
+}
+
+/**
+ * Create wallet from config, auto-initializing if needed.
  */
 async function createWallet() {
-  const config = loadConfig();
+  let config = loadConfig();
   if (!config) {
-    console.error(
-      "Error: Wallet not initialized. Run 'arkade init <key>' first.",
-    );
-    process.exit(1);
+    console.error("No wallet found. Auto-generating a new private key...");
+    config = await autoInit();
+    console.error("Wallet initialized. Config saved to ~/.arkade-wallet/config.json");
   }
 
   const { sdk } = await getSDK();
@@ -126,41 +147,41 @@ USAGE:
   arkade <command> [options]
 
 COMMANDS:
-  generate                   Generate a new random private key
-  init <key> [url]           Initialize wallet with private key (hex)
-                             Default server: arkade.computer
+  init [url]                   Initialize wallet (auto-generates key)
+                               Default server: arkade.computer
 
-  address                    Show Ark address (for receiving offchain)
-  boarding-address           Show boarding address (for onchain deposits)
-  balance                    Show balance breakdown
+  address                      Show Ark address (for receiving offchain)
+  boarding-address             Show boarding address (for onchain deposits)
+  balance                      Show balance breakdown
 
-  send <address> <amount>    Send satoshis to an Ark address
-  history                    Show transaction history
+  send <address> <amount>      Send satoshis to an Ark address
+  history                      Show transaction history
 
-  onboard                    Move funds from onchain to offchain (Arkade)
-  offboard <btc-address>     Move funds from offchain to onchain
+  onboard                      Move funds from onchain to offchain (Arkade)
+  offboard <btc-address>       Move funds from offchain to onchain
 
-  ln-invoice <amount> [desc] Create a Lightning invoice
-  ln-pay <bolt11>            Pay a Lightning invoice
-  ln-fees                    Show Lightning swap fees
-  ln-limits                  Show Lightning swap limits
-  ln-pending                 Show pending Lightning swaps
+  ln-invoice <amount> [desc]   Create a Lightning invoice
+  ln-pay <bolt11>              Pay a Lightning invoice
+  ln-fees                      Show Lightning swap fees
+  ln-limits                    Show Lightning swap limits
+  ln-pending                   Show pending Lightning swaps
 
   swap-quote <amt> <from> <to>  Get stablecoin swap quote
   swap-to-stable <amt> <token> <chain> <evm-addr>
-                               Swap BTC to stablecoin
+                                Swap BTC to stablecoin
   swap-to-btc <amt> <token> <chain> <evm-addr>
-                               Swap stablecoin to BTC
-  swap-status <swap-id>        Check swap status
-  swap-pending                 Show pending stablecoin swaps
-  swap-pairs                   Show available stablecoin pairs
+                                Swap stablecoin to BTC
+  swap-claim <swap-id>          Claim a completed swap
+  swap-refund <swap-id> [addr]  Refund an expired/failed swap
+  swap-status <swap-id>         Check swap status
+  swap-pending                  Show pending stablecoin swaps
+  swap-pairs                    Show available stablecoin pairs
 
-  help                         Show this help message
+  help                          Show this help message
 
 EXAMPLES:
-  arkade generate
-  arkade init abc123...
-  arkade init abc123... https://custom-server.com
+  arkade init
+  arkade init https://custom-server.com
   arkade balance
   arkade send ark1... 50000
   arkade ln-invoice 25000 "Coffee payment"
@@ -168,70 +189,49 @@ EXAMPLES:
   arkade swap-to-stable 100000 usdc_pol polygon 0x...
   arkade swap-to-btc 100 usdc_pol polygon 0x...
 
-ENVIRONMENT:
-  LENDASWAP_API_KEY          API key for LendaSwap stablecoin swaps
-
-CONFIG:
-  Data stored in: ~/.arkade-wallet/config.json
+NOTE:
+  Private keys are auto-generated and stored securely in ~/.arkade-wallet/config.json.
+  They are never exposed via CLI arguments or stdout.
 `);
 }
 
 /**
- * Generate a random private key.
+ * Initialize wallet command. Auto-generates a new private key.
+ * If a wallet already exists, shows its address without overwriting.
  */
-async function cmdGenerate() {
-  const { SingleKey } = await import("@arkade-os/sdk");
+async function cmdInit(serverUrl) {
+  const existing = loadConfig();
+  if (existing) {
+    const { sdk } = await getSDK();
+    const { Wallet, SingleKey } = sdk;
 
-  const identity = SingleKey.fromRandomBytes();
-  const privateKey = Buffer.from(identity.key).toString("hex");
-
-  console.log("Generated new private key:");
-  console.log(privateKey);
-  console.log("");
-  console.log("IMPORTANT: Save this key securely! It cannot be recovered.");
-  console.log("");
-  console.log("To initialize your wallet, run:");
-  console.log(`  arkade init ${privateKey}`);
-}
-
-/**
- * Initialize wallet command.
- */
-async function cmdInit(privateKey, serverUrl) {
-  if (!privateKey) {
-    console.error("Error: Private key required.");
-    console.error("Usage: arkade init <private-key-hex> [server-url]");
-    process.exit(1);
-  }
+    const wallet = await Wallet.create({
+      identity: SingleKey.fromHex(existing.privateKey),
+      arkServerUrl: existing.serverUrl || DEFAULT_SERVER,
+    });
 
-  // Validate private key format
-  if (!/^[0-9a-fA-F]{64}$/.test(privateKey)) {
-    console.error("Error: Invalid private key. Must be 64 hex characters.");
-    process.exit(1);
+    const address = await wallet.getAddress();
+    console.log("Wallet already initialized.");
+    console.log(`Server: ${existing.serverUrl || DEFAULT_SERVER}`);
+    console.log(`Address: ${address}`);
+    return;
   }
 
-  const url = serverUrl || DEFAULT_SERVER;
+  try {
+    const config = await autoInit(serverUrl);
 
-  // Test connection
-  const { sdk } = await getSDK();
-  const { Wallet, SingleKey } = sdk;
+    const { sdk } = await getSDK();
+    const { Wallet, SingleKey } = sdk;
 
-  try {
     const wallet = await Wallet.create({
-      identity: SingleKey.fromHex(privateKey),
-      arkServerUrl: url,
+      identity: SingleKey.fromHex(config.privateKey),
+      arkServerUrl: config.serverUrl,
     });
 
     const address = await wallet.getAddress();
 
-    saveConfig({
-      privateKey,
-      serverUrl: url,
-      createdAt: new Date().toISOString(),
-    });
-
     console.log("Wallet initialized successfully!");
-    console.log(`Server: ${url}`);
+    console.log(`Server: ${config.serverUrl}`);
     console.log(`Address: ${address}`);
   } catch (e) {
     console.error(`Error: Failed to initialize wallet: ${e.message}`);
@@ -615,6 +615,44 @@ async function cmdLnPending() {
   }
 }
 
+/**
+ * Create a LendaSwapSkill with mnemonic persistence.
+ * Loads mnemonic from config, and saves it back after first initialization.
+ */
+async function createLendaSwap() {
+  const wallet = await createWallet();
+  const { skill } = await getSDK();
+  const { LendaSwapSkill } = skill;
+
+  const config = loadConfig();
+  const options = {};
+
+  if (config.lendaswapMnemonic) {
+    options.mnemonic = config.lendaswapMnemonic;
+  }
+  if (process.env.LENDASWAP_API_KEY) {
+    options.apiKey = process.env.LENDASWAP_API_KEY;
+  }
+  if (process.env.LENDASWAP_API_URL) {
+    options.apiUrl = process.env.LENDASWAP_API_URL;
+  }
+
+  const lendaswap = new LendaSwapSkill({ wallet, ...options });
+
+  // Persist mnemonic after first SDK client initialization
+  if (!config.lendaswapMnemonic) {
+    try {
+      const mnemonic = await lendaswap.getMnemonic();
+      config.lendaswapMnemonic = mnemonic;
+      saveConfig(config);
+    } catch {
+      // Non-fatal: mnemonic save failed, will generate a new one next time
+    }
+  }
+
+  return lendaswap;
+}
+
 /**
  * Get stablecoin quote command.
  */
@@ -626,20 +664,7 @@ async function cmdSwapQuote(amount, from, to) {
     process.exit(1);
   }
 
-  const apiKey = process.env.LENDASWAP_API_KEY;
-  if (!apiKey) {
-    console.error("Error: LENDASWAP_API_KEY environment variable required.");
-    process.exit(1);
-  }
-
-  const wallet = await createWallet();
-  const { skill } = await getSDK();
-  const { LendaSwapSkill } = skill;
-
-  const lendaswap = new LendaSwapSkill({
-    wallet,
-    apiKey,
-  });
+  const lendaswap = await createLendaSwap();
 
   try {
     let quote;
@@ -691,26 +716,13 @@ async function cmdSwapToStable(
     process.exit(1);
   }
 
-  const apiKey = process.env.LENDASWAP_API_KEY;
-  if (!apiKey) {
-    console.error("Error: LENDASWAP_API_KEY environment variable required.");
-    process.exit(1);
-  }
-
   const sats = parseInt(amount, 10);
   if (isNaN(sats) || sats <= 0) {
     console.error("Error: Invalid amount.");
     process.exit(1);
   }
 
-  const wallet = await createWallet();
-  const { skill } = await getSDK();
-  const { LendaSwapSkill } = skill;
-
-  const lendaswap = new LendaSwapSkill({
-    wallet,
-    apiKey,
-  });
+  const lendaswap = await createLendaSwap();
 
   console.log(`Swapping ${formatSats(sats)} sats to ${targetToken}...`);
 
@@ -726,10 +738,10 @@ async function cmdSwapToStable(
     console.log(`Swap ID: ${result.swapId}`);
     console.log(`Status: ${result.status}`);
     console.log(`Expected: ${result.targetAmount} ${targetToken}`);
-    console.log(`Rate: ${result.exchangeRate}`);
     if (result.paymentDetails?.address) {
       console.log(`Payment Address: ${result.paymentDetails.address}`);
     }
+    console.log(`Fee: ${result.fee.amount} sats`);
     console.log(`Expires: ${result.expiresAt.toLocaleString()}`);
   } catch (e) {
     console.error(`Error: ${e.message}`);
@@ -750,27 +762,14 @@ async function cmdSwapToBtc(amount, sourceToken, sourceChain, evmAddress) {
     process.exit(1);
   }
 
-  const apiKey = process.env.LENDASWAP_API_KEY;
-  if (!apiKey) {
-    console.error("Error: LENDASWAP_API_KEY environment variable required.");
-    process.exit(1);
-  }
-
   const tokenAmount = parseFloat(amount);
   if (isNaN(tokenAmount) || tokenAmount <= 0) {
     console.error("Error: Invalid amount.");
     process.exit(1);
   }
 
-  const wallet = await createWallet();
-  const { skill } = await getSDK();
-  const { LendaSwapSkill } = skill;
-
-  const lendaswap = new LendaSwapSkill({
-    wallet,
-    apiKey,
-  });
-
+  const lendaswap = await createLendaSwap();
+  const wallet = lendaswap.getWallet();
   const arkAddress = await wallet.getAddress();
 
   console.log(`Swapping ${tokenAmount} ${sourceToken} to BTC...`);
@@ -788,13 +787,13 @@ async function cmdSwapToBtc(amount, sourceToken, sourceChain, evmAddress) {
     console.log(`Swap ID: ${result.swapId}`);
     console.log(`Status: ${result.status}`);
     console.log(`Expected: ${result.targetAmount} sats`);
-    console.log(`Rate: ${result.exchangeRate}`);
     if (result.paymentDetails?.address) {
       console.log(`HTLC Address: ${result.paymentDetails.address}`);
     }
     if (result.paymentDetails?.callData) {
-      console.log(`Call Data: ${result.paymentDetails.callData}`);
+      console.log(`Token Address: ${result.paymentDetails.callData}`);
     }
+    console.log(`Fee: ${result.fee.amount} sats`);
     console.log(`Expires: ${result.expiresAt.toLocaleString()}`);
   } catch (e) {
     console.error(`Error: ${e.message}`);
@@ -812,20 +811,7 @@ async function cmdSwapStatus(swapId) {
     process.exit(1);
   }
 
-  const apiKey = process.env.LENDASWAP_API_KEY;
-  if (!apiKey) {
-    console.error("Error: LENDASWAP_API_KEY environment variable required.");
-    process.exit(1);
-  }
-
-  const wallet = await createWallet();
-  const { skill } = await getSDK();
-  const { LendaSwapSkill } = skill;
-
-  const lendaswap = new LendaSwapSkill({
-    wallet,
-    apiKey,
-  });
+  const lendaswap = await createLendaSwap();
 
   try {
     const status = await lendaswap.getSwapStatus(swapId);
@@ -837,7 +823,6 @@ async function cmdSwapStatus(swapId) {
     console.log(`Status: ${status.status}`);
     console.log(`From: ${status.sourceAmount} ${status.sourceToken}`);
     console.log(`To: ${status.targetAmount} ${status.targetToken}`);
-    console.log(`Rate: ${status.exchangeRate}`);
     console.log(`Created: ${status.createdAt.toLocaleString()}`);
     if (status.completedAt) {
       console.log(`Completed: ${status.completedAt.toLocaleString()}`);
@@ -855,20 +840,7 @@ async function cmdSwapStatus(swapId) {
  * Show pending stablecoin swaps command.
  */
 async function cmdSwapPending() {
-  const apiKey = process.env.LENDASWAP_API_KEY;
-  if (!apiKey) {
-    console.error("Error: LENDASWAP_API_KEY environment variable required.");
-    process.exit(1);
-  }
-
-  const wallet = await createWallet();
-  const { skill } = await getSDK();
-  const { LendaSwapSkill } = skill;
-
-  const lendaswap = new LendaSwapSkill({
-    wallet,
-    apiKey,
-  });
+  const lendaswap = await createLendaSwap();
 
   try {
     const pending = await lendaswap.getPendingSwaps();
@@ -898,20 +870,7 @@ async function cmdSwapPending() {
  * Show available stablecoin pairs command.
  */
 async function cmdSwapPairs() {
-  const apiKey = process.env.LENDASWAP_API_KEY;
-  if (!apiKey) {
-    console.error("Error: LENDASWAP_API_KEY environment variable required.");
-    process.exit(1);
-  }
-
-  const wallet = await createWallet();
-  const { skill } = await getSDK();
-  const { LendaSwapSkill } = skill;
-
-  const lendaswap = new LendaSwapSkill({
-    wallet,
-    apiKey,
-  });
+  const lendaswap = await createLendaSwap();
 
   try {
     const pairs = await lendaswap.getAvailablePairs();
@@ -931,6 +890,71 @@ async function cmdSwapPairs() {
   }
 }
 
+/**
+ * Claim a swap command.
+ */
+async function cmdSwapClaim(swapId) {
+  if (!swapId) {
+    console.error("Error: Swap ID required.");
+    console.error("Usage: arkade swap-claim <swap-id>");
+    process.exit(1);
+  }
+
+  const lendaswap = await createLendaSwap();
+
+  try {
+    const result = await lendaswap.claimSwap(swapId);
+
+    if (result.success) {
+      console.log("Swap claimed successfully!");
+      if (result.chain) {
+        console.log(`Chain: ${result.chain}`);
+      }
+      if (result.txHash) {
+        console.log(`TX Hash: ${result.txHash}`);
+      }
+    } else {
+      console.log(`Claim status: ${result.message}`);
+    }
+  } catch (e) {
+    console.error(`Error: ${e.message}`);
+    process.exit(1);
+  }
+}
+
+/**
+ * Refund a swap command.
+ */
+async function cmdSwapRefund(swapId, destinationAddress) {
+  if (!swapId) {
+    console.error("Error: Swap ID required.");
+    console.error("Usage: arkade swap-refund <swap-id> [destination-address]");
+    process.exit(1);
+  }
+
+  const lendaswap = await createLendaSwap();
+
+  try {
+    const options = destinationAddress ? { destinationAddress } : undefined;
+    const result = await lendaswap.refundSwap(swapId, options);
+
+    if (result.success) {
+      console.log("Swap refunded successfully!");
+      if (result.txId) {
+        console.log(`TX ID: ${result.txId}`);
+      }
+      if (result.refundAmount != null) {
+        console.log(`Refund Amount: ${formatSats(result.refundAmount)} sats`);
+      }
+    } else {
+      console.log(`Refund status: ${result.message}`);
+    }
+  } catch (e) {
+    console.error(`Error: ${e.message}`);
+    process.exit(1);
+  }
+}
+
 /**
  * Main entry point.
  */
@@ -939,11 +963,8 @@ async function main() {
   const command = args[0];
 
   switch (command) {
-    case "generate":
-      await cmdGenerate();
-      break;
     case "init":
-      await cmdInit(args[1], args[2]);
+      await cmdInit(args[1]);
       break;
     case "address":
       await cmdAddress();
@@ -990,6 +1011,12 @@ async function main() {
     case "swap-to-btc":
       await cmdSwapToBtc(args[1], args[2], args[3], args[4]);
       break;
+    case "swap-claim":
+      await cmdSwapClaim(args[1]);
+      break;
+    case "swap-refund":
+      await cmdSwapRefund(args[1], args[2]);
+      break;
     case "swap-status":
       await cmdSwapStatus(args[1]);
       break;

package/dist/cjs/index.js

@@ -37,7 +37,7 @@
  * const invoice = await lightning.createInvoice({ amount: 50000 });
  *
  * // Stablecoin swaps
- * const lendaswap = new LendaSwapSkill({ wallet, apiKey: "..." });
+ * const lendaswap = new LendaSwapSkill({ wallet });
  * const quote = await lendaswap.getQuoteBtcToStablecoin(100000, "usdc_pol");
  * ```
  *

package/dist/cjs/skills/index.js

@@ -49,10 +49,7 @@
  * console.log("Invoice:", invoice.bolt11);
  *
  * // === LendaSwap Skill ===
- * const lendaswap = new LendaSwapSkill({
- *   wallet,
- *   apiKey: process.env.LENDASWAP_API_KEY,
- * });
+ * const lendaswap = new LendaSwapSkill({ wallet });
  *
  * // Get quote for BTC to USDC
  * const quote = await lendaswap.getQuoteBtcToStablecoin(100000, "usdc_pol");