@blockrun/franklin 3.26.1 → 3.27.1

package/dist/stats/swap-log.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Swap ledger — one line per executed on-chain swap, at ~/.blockrun/swaps.jsonl.
+ * The swap tools (0x on Base, Jupiter on Solana) append here on success so the
+ * desktop wallet view can show a "swaps" history with explorer links. Mirrors
+ * the JSONL pattern of cost-log / audit. All writes are best-effort.
+ */
+export interface SwapRow {
+    ts: number;
+    chain: 'base' | 'solana';
+    dex: string;
+    sellSym: string;
+    sellAmount: number;
+    buySym: string;
+    buyAmount: number;
+    txHash: string;
+    explorer?: string;
+}
+export declare function appendSwap(row: SwapRow): void;
+export declare function readSwaps(limit?: number): SwapRow[];

package/dist/stats/swap-log.js

@@ -0,0 +1,33 @@
+/**
+ * Swap ledger — one line per executed on-chain swap, at ~/.blockrun/swaps.jsonl.
+ * The swap tools (0x on Base, Jupiter on Solana) append here on success so the
+ * desktop wallet view can show a "swaps" history with explorer links. Mirrors
+ * the JSONL pattern of cost-log / audit. All writes are best-effort.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { BLOCKRUN_DIR } from '../config.js';
+const SWAP_FILE = path.join(BLOCKRUN_DIR, 'swaps.jsonl');
+export function appendSwap(row) {
+    try {
+        fs.mkdirSync(BLOCKRUN_DIR, { recursive: true });
+        fs.appendFileSync(SWAP_FILE, JSON.stringify(row) + '\n', { mode: 0o600 });
+    }
+    catch { /* best-effort */ }
+}
+export function readSwaps(limit = 100) {
+    try {
+        const lines = fs.readFileSync(SWAP_FILE, 'utf-8').trim().split('\n').filter(Boolean);
+        const rows = [];
+        for (const line of lines) {
+            try {
+                rows.push(JSON.parse(line));
+            }
+            catch { /* skip bad line */ }
+        }
+        return rows.sort((a, b) => b.ts - a.ts).slice(0, limit);
+    }
+    catch {
+        return [];
+    }
+}

package/dist/tools/zerox-base.js

@@ -27,6 +27,7 @@ import { base } from 'viem/chains';
 import { getOrCreateWallet } from '@blockrun/llm';
 import { loadConfig } from '../commands/config.js';
 import { loadChain, API_URLS, VERSION } from '../config.js';
+import { appendSwap } from '../stats/swap-log.js';
 // ─── BlockRun affiliate identity on Base ─────────────────────────────────
 // Reuses the existing BlockRun ops wallet that already receives x402
 // settlements on Base. Every swap routed through these tools deposits 20
@@ -407,9 +408,43 @@ async function executeBase0xSwap(input, ctx) {
     }
     liveSwapCount += 1;
     const explorer = `https://basescan.org/tx/${txHash}`;
+    // Confirm on-chain before recording: a submitted tx can still revert (e.g.
+    // slippage floor exceeded), and the swap log feeds the desktop wallet
+    // history — same confirmed-only gating as the gasless tool. Base blocks land
+    // in ~2s, so the wait is cheap.
+    let confirmed = false;
+    try {
+        const receipt = await client.waitForTransactionReceipt({ hash: txHash, timeout: 60_000 });
+        if (receipt.status !== 'success') {
+            return {
+                output: `Swap reverted on-chain (likely the slippage floor was exceeded — no tokens moved, only gas was spent).\n` +
+                    `Tx hash: ${txHash}\n${explorer}`,
+                isError: true,
+            };
+        }
+        confirmed = true;
+    }
+    catch { /* receipt wait timed out / RPC hiccup — report submitted, don't record */ }
+    if (confirmed) {
+        // Record the swap so the desktop wallet can show a history (best-effort).
+        try {
+            appendSwap({
+                ts: Date.now(),
+                chain: 'base',
+                dex: '0x',
+                sellSym: symbolFor(quote.sellToken),
+                sellAmount: Number(formatUnits(BigInt(quote.sellAmount), decimalsFor(quote.sellToken))),
+                buySym: symbolFor(quote.buyToken),
+                buyAmount: Number(formatUnits(BigInt(quote.buyAmount), decimalsFor(quote.buyToken))),
+                txHash,
+                explorer,
+            });
+        }
+        catch { /* best-effort */ }
+    }
     return {
         output: [
-            '✓ Swap executed on Base.',
+            confirmed ? '✓ Swap executed on Base.' : '✓ Swap submitted on Base (confirmation pending — check the explorer).',
             formatQuoteText(quote),
             `Tx hash: ${txHash}`,
             explorer,

package/dist/tools/zerox-gasless.js

@@ -24,6 +24,7 @@ import { createWalletClient, http, publicActions } from 'viem';
 import { getOrCreateWallet } from '@blockrun/llm';
 import { loadConfig } from '../commands/config.js';
 import { loadChain, API_URLS, VERSION } from '../config.js';
+import { appendSwap } from '../stats/swap-log.js';
 import { logger } from '../logger.js';
 // ─── Constants ────────────────────────────────────────────────────────────
 const ZEROX_GATEWAY_PATH = '/v1/zerox/gasless';
@@ -409,6 +410,22 @@ async function executeBase0xGaslessSwap(input, ctx) {
         : final.status === 'failed'
             ? `✗ Swap failed: ${final.reason ?? 'unknown reason'}`
             : `⏳ Still pending after ${MAX_STATUS_POLL_MS / 1000}s — relayer is backlogged. Check status later via /v1/zerox/gasless/status/${submitRes.tradeHash}.`;
+    if ((final.status === 'confirmed' || final.status === 'succeeded') && onChainHash) {
+        try {
+            appendSwap({
+                ts: Date.now(),
+                chain: 'base',
+                dex: '0x',
+                sellSym: symbolFor(quote.sellToken),
+                sellAmount: Number(formatUnits(BigInt(quote.sellAmount), decimalsFor(quote.sellToken))),
+                buySym: symbolFor(quote.buyToken),
+                buyAmount: Number(formatUnits(BigInt(quote.buyAmount), decimalsFor(quote.buyToken))),
+                txHash: onChainHash,
+                explorer: explorer ?? undefined,
+            });
+        }
+        catch { /* best-effort */ }
+    }
     const lines = [
         statusLine,
         formatGaslessQuoteText(quote),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/franklin",
-  "version": "3.26.1",
+  "version": "3.27.1",
   "description": "Franklin Agent — The AI agent with a wallet. Spends USDC autonomously to get real work done. Pay per action, no subscriptions.",
   "type": "module",
   "exports": {
@@ -69,6 +69,7 @@
     "@blockrun/llm": "^2.0.0",
     "@colbymchenry/codegraph": "^0.9.7",
     "@modelcontextprotocol/sdk": "^1.29.0",
+    "@slack/bolt": "^4.7.3",
     "@solana/spl-token": "^0.4.14",
     "@solana/web3.js": "^1.98.4",
     "@types/react": "^19.2.14",