@morebetterclaw/forge-swap 0.1.1

package/src/test.js

@@ -0,0 +1,109 @@
+/**
+ * Smoke test — Crypto Swap Agent HTTP server
+ * Run: node src/test.js
+ * Exit 0 = all pass, Exit 1 = one or more failures
+ *
+ * Starts the server on port 3001, runs checks, stops it.
+ * No external test framework — plain Node with assert.
+ */
+
+import 'dotenv/config';
+import assert from 'assert';
+import { startServer } from './server.js';
+
+const PORT = 3001;
+const BASE = `http://localhost:${PORT}`;
+
+let passed = 0;
+let failed = 0;
+
+async function check(name, fn) {
+  try {
+    await fn();
+    console.log(`  PASS  ${name}`);
+    passed++;
+  } catch (err) {
+    console.log(`  FAIL  ${name}`);
+    console.log(`       -> ${err.message}`);
+    failed++;
+  }
+}
+
+console.log('\nCrypto Swap Agent — Smoke Tests');
+console.log('='.repeat(50));
+
+// Start server
+const server = startServer(PORT);
+
+// Wait for server to be ready
+await new Promise(resolve => setTimeout(resolve, 300));
+
+// ── Test 1: GET /health ───────────────────────────────────────────────────────
+await check('GET /health returns 200 + { status: "ok" }', async () => {
+  const res = await fetch(`${BASE}/health`);
+  assert.strictEqual(res.status, 200, `Expected 200, got ${res.status}`);
+  const data = await res.json();
+  assert.strictEqual(data.status, 'ok', `Expected status "ok", got "${data.status}"`);
+  assert.ok(data.version, 'Missing version field');
+  assert.ok(data.timestamp, 'Missing timestamp field');
+});
+
+// ── Test 2: GET /swap/assets ──────────────────────────────────────────────────
+await check('GET /swap/assets returns array', async () => {
+  const res = await fetch(`${BASE}/swap/assets`);
+  assert.strictEqual(res.status, 200, `Expected 200, got ${res.status}`);
+  const data = await res.json();
+  assert.ok(Array.isArray(data), `Expected array, got ${typeof data}`);
+  assert.ok(data.length > 0, 'Asset list is empty');
+  console.log(`         -> ${data.length} assets returned`);
+});
+
+// ── Test 3: POST /swap/quote ──────────────────────────────────────────────────
+await check('POST /swap/quote returns expectedOutput', async () => {
+  const res = await fetch(`${BASE}/swap/quote`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ fromAsset: 'ETH.ETH', toAsset: 'BTC.BTC', amount: '0.1' }),
+  });
+
+  // 422 means no route found (pair temporarily unavailable) — acceptable
+  assert.ok(
+    [200, 422].includes(res.status),
+    `Unexpected status ${res.status}`
+  );
+
+  const data = await res.json();
+  if (res.status === 200) {
+    assert.ok('expectedOutput' in data, 'Missing expectedOutput field');
+    assert.ok('affiliateFee' in data, 'Missing affiliateFee field');
+    console.log(`         -> expectedOutput: ${data.expectedOutput}`);
+  } else {
+    console.log(`         -> No route available (pair temporarily unavailable — OK)`);
+  }
+});
+
+// ── Test 4: POST /swap/quote validation ──────────────────────────────────────
+await check('POST /swap/quote returns 400 on missing fields', async () => {
+  const res = await fetch(`${BASE}/swap/quote`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ fromAsset: 'ETH.ETH' }),
+  });
+  assert.strictEqual(res.status, 400, `Expected 400, got ${res.status}`);
+  const data = await res.json();
+  assert.ok(data.error, 'Missing error field in 400 response');
+});
+
+// ── Stop server ───────────────────────────────────────────────────────────────
+server.close();
+
+console.log('\n' + '='.repeat(50));
+console.log(`  Results: ${passed} passed, ${failed} failed`);
+
+if (failed > 0) {
+  console.log(`\n  FAIL — Fix issues before deploying.\n`);
+  process.exit(1);
+} else {
+  console.log(`\n  PASS — All smoke tests passed.\n`);
+  process.exit(0);
+}

package/src/wallet.js

@@ -0,0 +1,157 @@
+/**
+ * wallet.js — Wallet Signing Layer for Crypto Swap Agent
+ * Week 3: Connects SwapKit executeSwap with user wallet signing.
+ *
+ * Supports two modes:
+ *   1. Agent wallet (env: WALLET_PRIVATE_KEY) — fully autonomous
+ *   2. External wallet (MetaMask/WalletConnect) — returns unsigned tx for user to sign
+ *
+ * For THORChain swaps: builds the inbound deposit transaction (sends asset
+ * to THORChain vault address with memo in OP_RETURN / tx.memo).
+ */
+
+import { ethers } from 'ethers';
+
+const EVM_RPC = process.env.EVM_RPC_URL || 'https://mainnet.infura.io/v3/YOUR_INFURA_KEY';
+const AGENT_PRIVATE_KEY = process.env.WALLET_PRIVATE_KEY || null;
+
+// ─── Wallet Factory ──────────────────────────────────────────────────────────
+
+/**
+ * Create an agent wallet from private key in env.
+ * For production: load key from a secrets manager, not .env.
+ *
+ * @returns {ethers.Wallet|null} funded wallet instance, or null if not configured
+ */
+export function getAgentWallet() {
+  if (!AGENT_PRIVATE_KEY) return null;
+  const provider = new ethers.JsonRpcProvider(EVM_RPC);
+  return new ethers.Wallet(AGENT_PRIVATE_KEY, provider);
+}
+
+// ─── ETH/EVM Signing ─────────────────────────────────────────────────────────
+
+/**
+ * Sign and broadcast an EVM-based THORChain inbound deposit.
+ * For ETH → anything swaps via THORChain.
+ *
+ * @param {object} swapData  output from SwapKitApi.executeSwap()
+ * @param {string} [privateKey]  optional key override (for testing)
+ * @returns {Promise<{txHash: string, explorerUrl: string}>}
+ */
+export async function signAndSendEVM(swapData, privateKey = AGENT_PRIVATE_KEY) {
+  if (!privateKey) {
+    throw new Error('No wallet configured. Set WALLET_PRIVATE_KEY in env or pass a key.');
+  }
+
+  const provider = new ethers.JsonRpcProvider(EVM_RPC);
+  const wallet = new ethers.Wallet(privateKey, provider);
+
+  // THORChain deposits: send ETH to inbound vault with memo as tx data
+  const memoHex = ethers.hexlify(ethers.toUtf8Bytes(swapData.memo));
+
+  // Parse deposit amount (SwapKit returns amount as string like "1.5")
+  const amountWei = ethers.parseEther(String(swapData.depositAmount));
+
+  const tx = {
+    to: swapData.depositAddress,
+    value: amountWei,
+    data: memoHex,
+    gasLimit: 80_000n, // THORChain deposits are simple ETH sends
+  };
+
+  console.log(`[wallet] Broadcasting EVM swap tx — vault: ${swapData.depositAddress}, memo: ${swapData.memo}`);
+  const sent = await wallet.sendTransaction(tx);
+  const receipt = await sent.wait(1);
+
+  return {
+    txHash: receipt.hash,
+    explorerUrl: `https://etherscan.io/tx/${receipt.hash}`,
+    status: 'broadcast',
+    memo: swapData.memo,
+    depositAmount: swapData.depositAmount,
+    expectedOutput: swapData.expectedOutput,
+  };
+}
+
+/**
+ * Build an unsigned EVM transaction for external wallet signing (MetaMask etc.)
+ * Returns a JSON object the frontend passes to wallet_sendTransaction.
+ *
+ * @param {object} swapData  output from SwapKitApi.executeSwap()
+ * @returns {object} unsigned tx payload
+ */
+export function buildUnsignedEVMTx(swapData) {
+  const memoHex = ethers.hexlify(ethers.toUtf8Bytes(swapData.memo));
+  const amountHex = ethers.toBeHex(ethers.parseEther(String(swapData.depositAmount)));
+
+  return {
+    method: 'eth_sendTransaction',
+    params: [{
+      to: swapData.depositAddress,
+      value: amountHex,
+      data: memoHex,
+      gas: '0x13880', // 80000 gas
+    }],
+    // For wagmi/viem integration:
+    request: {
+      address: swapData.depositAddress,
+      value: amountHex,
+      data: memoHex,
+    },
+    memo: swapData.memo,
+    expectedOutput: swapData.expectedOutput,
+  };
+}
+
+// ─── BTC Signing (read-only guide) ───────────────────────────────────────────
+
+/**
+ * For BTC deposits to THORChain: user must sign with their BTC wallet.
+ * We can't sign BTC natively here — return the deposit instructions.
+ *
+ * @param {object} swapData
+ * @returns {object} BTC deposit instructions
+ */
+export function getBTCDepositInstructions(swapData) {
+  return {
+    action: 'send_bitcoin',
+    to: swapData.depositAddress,
+    amount: swapData.depositAmount,
+    memo: swapData.memo,
+    instructions: [
+      `Send exactly ${swapData.depositAmount} BTC to: ${swapData.depositAddress}`,
+      `Include memo: ${swapData.memo}`,
+      'Use a wallet that supports OP_RETURN memos (Electrum, Xverse, etc.)',
+      'Do NOT use exchange withdrawals — they strip the memo',
+    ],
+    warning: 'Missing or incorrect memo will result in lost funds.',
+  };
+}
+
+// ─── Swap Executor (full flow) ────────────────────────────────────────────────
+
+/**
+ * Execute a complete swap end-to-end for agent mode.
+ * Agent wallet required (WALLET_PRIVATE_KEY).
+ *
+ * @param {object} swapData  output from SwapKitApi.executeSwap()
+ * @returns {Promise<object>} broadcast result or instructions
+ */
+export async function executeSwap(swapData) {
+  if (swapData.status !== 'pending_signature') {
+    throw new Error(`Unexpected swapData.status: ${swapData.status}`);
+  }
+
+  const asset = swapData.depositAsset.split('.')[1]?.toUpperCase() || '';
+
+  if (['ETH', 'USDC', 'USDT', 'WBTC'].includes(asset)) {
+    return await signAndSendEVM(swapData);
+  }
+
+  if (asset === 'BTC') {
+    return getBTCDepositInstructions(swapData);
+  }
+
+  throw new Error(`Unsupported deposit asset for auto-signing: ${swapData.depositAsset}`);
+}