@blockrun/franklin 3.14.0 → 3.15.0

package/dist/agent/context.js

@@ -213,11 +213,20 @@ You run on the BlockRun AI Gateway. When the user asks you to "test the BlockRun
 - Use the **\`JupiterQuote\` and \`JupiterSwap\` built-in tools** — they call Jupiter's Ultra API directly from this process. The user is the first-party caller of Jupiter; we are not a gateway proxy here. A 20 bps platform fee is collected on-chain as part of the swap (Jupiter Referral Program — official integrator mechanism, not a hidden cost).
 - Do NOT try to call \`/v1/jupiter/...\` on the BlockRun gateway — there is no such endpoint (Jupiter ToU forbids the gateway-proxy model).
 
-**Base DEX swap (0x V2 Permit2 via BlockRun gateway)**
-- Use the **\`Base0xQuote\` and \`Base0xSwap\` built-in tools** for swaps on Base (chain id 8453). Tools route through BlockRun gateway \`/v1/zerox/{price,quote}\` (server-side 0x key, x402-paid). User pays $0.001 USDC per quote/swap call to the gateway; on-chain affiliate (20 bps in the sell-token) flows automatically to BlockRun treasury at swap settlement. **No 0x signup needed** — BlockRun manages the upstream key.
-- Symbol shortcuts pre-mapped: ETH (native), WETH, USDC, USDT, CBBTC, CBETH, AERO, DAI. Raw \`0x...\` addresses pass through.
-- For native ETH → token: no Permit2 approval needed (native value path). For ERC-20 → token: first-time-per-token Permit2 approval auto-runs before the swap (one-time gas cost; future swaps of the same sell-token reuse it).
-- The user signs Permit2 typed data locally with their Base keypair; the signed transaction is submitted to a Base RPC (default public mainnet-beta) — BlockRun never custodies keys.
+**Base DEX swap (0x V2 via BlockRun gateway)** — three modes, pick by user's wallet state:
+
+- **\`Base0xQuote\`** (read-only): inspect price + impact + route. Free.
+- **\`Base0xSwap\`** (Permit2): user signs Permit2 typed-data + submits the tx themselves to Base RPC. **User needs ETH for gas.** Routes through BlockRun gateway \`/v1/zerox/{price,quote}\` — no 0x signup needed.
+- **\`Base0xGaslessSwap\`** (Gasless V2): user signs ONLY EIP-712 typed-data (offline, no on-chain action). 0x's relayer broadcasts the trade and pays gas. **User does NOT need any ETH.** Only works for Permit-supporting input tokens (USDC, DAI). USDT etc. do not support Permit on Base — the tool errors with that instruction. Routes through \`/v1/zerox/gasless/*\`.
+
+**Pick the right tool:**
+- User holds ETH on Base → use \`Base0xSwap\` (more flexibility, supports any input token).
+- User holds USDC/DAI but no ETH → use \`Base0xGaslessSwap\` (zero gas needed).
+- User asks for a quote without committing → use \`Base0xQuote\`.
+
+Symbol shortcuts pre-mapped on all three: ETH (native, Base0xSwap only), WETH, USDC, USDT, CBBTC, CBETH, AERO, DAI. Raw \`0x...\` addresses pass through.
+
+On-chain affiliate (20 bps in sell-token, force-set server-side) flows to BlockRun treasury at settlement on all three paths. BlockRun never custodies user keys; signing is always local.
 
 **Sandbox (POST, x402-paid)**
 - \`/v1/modal/{...path}\` — Modal GPU sandbox passthrough (create/exec/etc.).

package/dist/tools/index.js

@@ -27,6 +27,7 @@ import { webhookPostCapability } from './webhook.js';
 import { walletCapability } from './wallet.js';
 import { jupiterQuoteCapability, jupiterSwapCapability } from './jupiter.js';
 import { base0xQuoteCapability, base0xSwapCapability } from './zerox-base.js';
+import { base0xGaslessSwapCapability } from './zerox-gasless.js';
 import { defiLlamaProtocolsCapability, defiLlamaProtocolCapability, defiLlamaChainsCapability, defiLlamaYieldsCapability, defiLlamaPriceCapability, } from './defillama.js';
 import { createTradingCapabilities } from './trading-execute.js';
 import { Portfolio } from '../trading/portfolio.js';
@@ -151,6 +152,7 @@ export const allCapabilities = [
     jupiterSwapCapability,
     base0xQuoteCapability,
     base0xSwapCapability,
+    base0xGaslessSwapCapability,
     defiLlamaProtocolsCapability,
     defiLlamaProtocolCapability,
     defiLlamaChainsCapability,

package/dist/tools/zerox-base.js

@@ -24,7 +24,7 @@
 import { createWalletClient, http, publicActions, concat, numberToHex, size, parseUnits, formatUnits, maxUint256, erc20Abi, getContract, } from 'viem';
 import { privateKeyToAccount } from 'viem/accounts';
 import { base } from 'viem/chains';
-import { getOrCreateWallet, createPaymentPayload, createSolanaPaymentPayload, parsePaymentRequired, extractPaymentDetails, getOrCreateSolanaWallet, solanaKeyToBytes, SOLANA_NETWORK, } from '@blockrun/llm';
+import { getOrCreateWallet } from '@blockrun/llm';
 import { loadConfig } from '../commands/config.js';
 import { loadChain, API_URLS, VERSION } from '../config.js';
 // ─── BlockRun affiliate identity on Base ─────────────────────────────────
@@ -146,8 +146,8 @@ function makeClient(account) {
         transport: http(resolveBaseRpcUrl()),
     }).extend(publicActions);
 }
-// ─── 0x calls via BlockRun gateway (x402-paid) ───────────────────────────
-async function gatewayGetWithPayment(path, params, ctx) {
+// ─── 0x calls via BlockRun gateway (free public passthrough) ─────────────
+async function gatewayGet(path, params, ctx) {
     const chain = loadChain();
     const apiUrl = API_URLS[chain];
     const endpoint = `${apiUrl}${ZEROX_GATEWAY_PATH}/${path}?${params.toString()}`;
@@ -160,22 +160,11 @@ async function gatewayGetWithPayment(path, params, ctx) {
     const onAbort = () => controller.abort();
     ctx.abortSignal.addEventListener('abort', onAbort, { once: true });
     try {
-        let response = await fetch(endpoint, {
+        const response = await fetch(endpoint, {
             method: 'GET',
             headers,
             signal: controller.signal,
         });
-        if (response.status === 402) {
-            const paymentHeaders = await signGatewayPayment(response, chain, endpoint);
-            if (!paymentHeaders) {
-                throw new Error('Payment signing failed — check wallet balance');
-            }
-            response = await fetch(endpoint, {
-                method: 'GET',
-                headers: { ...headers, ...paymentHeaders },
-                signal: controller.signal,
-            });
-        }
         if (!response.ok) {
             const text = await response.text().catch(() => '');
             throw new Error(`BlockRun gateway /v1/zerox/${path} returned ${response.status}: ${text.slice(0, 300)}`);
@@ -187,51 +176,6 @@ async function gatewayGetWithPayment(path, params, ctx) {
         ctx.abortSignal.removeEventListener('abort', onAbort);
     }
 }
-async function signGatewayPayment(response, chain, endpoint) {
-    try {
-        let header = response.headers.get('payment-required');
-        if (!header) {
-            try {
-                const body = (await response.json());
-                if (body.x402 || body.accepts)
-                    header = btoa(JSON.stringify(body));
-            }
-            catch {
-                /* ignore */
-            }
-        }
-        if (!header)
-            return null;
-        if (chain === 'solana') {
-            const wallet = await getOrCreateSolanaWallet();
-            const paymentRequired = parsePaymentRequired(header);
-            const details = extractPaymentDetails(paymentRequired, SOLANA_NETWORK);
-            const secretBytes = await solanaKeyToBytes(wallet.privateKey);
-            const feePayer = details.extra?.feePayer || details.recipient;
-            const payload = await createSolanaPaymentPayload(secretBytes, wallet.address, details.recipient, details.amount, feePayer, {
-                resourceUrl: details.resource?.url || endpoint,
-                resourceDescription: details.resource?.description || 'Franklin 0x swap call',
-                maxTimeoutSeconds: details.maxTimeoutSeconds || 60,
-                extra: details.extra,
-            });
-            return { 'PAYMENT-SIGNATURE': payload };
-        }
-        const wallet = await getOrCreateWallet();
-        const paymentRequired = parsePaymentRequired(header);
-        const details = extractPaymentDetails(paymentRequired);
-        const payload = await createPaymentPayload(wallet.privateKey, wallet.address, details.recipient, details.amount, details.network || 'eip155:8453', {
-            resourceUrl: details.resource?.url || endpoint,
-            resourceDescription: details.resource?.description || 'Franklin 0x swap call',
-            maxTimeoutSeconds: details.maxTimeoutSeconds || 60,
-            extra: details.extra,
-        });
-        return { 'PAYMENT-SIGNATURE': payload };
-    }
-    catch (err) {
-        console.error(`[franklin] 0x gateway payment error: ${err.message}`);
-        return null;
-    }
-}
 function buildSwapParams(args) {
     // Affiliate params (swapFeeRecipient/Bps/Token) are NOT set here —
     // the BlockRun gateway forces them server-side, ensuring every
@@ -294,7 +238,7 @@ async function executeBase0xQuote(input, ctx) {
         taker: walletAddress,
     });
     try {
-        const price = await gatewayGetWithPayment('price', params, ctx);
+        const price = await gatewayGet('price', params, ctx);
         if (!price.liquidityAvailable && price.liquidityAvailable !== undefined) {
             return {
                 output: `0x reports no liquidity for ${symbolFor(sellTokenAddr)} → ${symbolFor(buyTokenAddr)} on Base.`,
@@ -342,7 +286,7 @@ async function executeBase0xSwap(input, ctx) {
     // Gateway forces affiliate params server-side; user pays $0.001 USDC.
     let quote;
     try {
-        quote = await gatewayGetWithPayment('quote', params, ctx);
+        quote = await gatewayGet('quote', params, ctx);
     }
     catch (err) {
         return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/franklin",
-  "version": "3.14.0",
+  "version": "3.15.0",
   "description": "Franklin — The AI agent with a wallet. Spends USDC autonomously to get real work done. Pay per action, no subscriptions.",
   "type": "module",
   "exports": {