@hpp-io/x402-mcp-bridge 0.0.1

package/dist/cli/safe.js

@@ -0,0 +1,299 @@
+/**
+ * Safe v1.4.1 helpers — minimal viem-based reimplementation of the bits
+ * of @safe-global/protocol-kit we use, to keep this CLI dependency-free
+ * beyond viem.
+ *
+ * What we need:
+ *   - deploySafe(owner, threshold)            via canonical ProxyFactory
+ *   - execSafeTx(to, data, ownerSigner)       1-of-1 path
+ *   - read helpers (nonce, isModuleEnabled)
+ *
+ * The canonical addresses are present on every chain that hosts Safe
+ * v1.4.1 (verified for HPP Sepolia + Mainnet on 2026-04-30).
+ */
+import { createPublicClient, createWalletClient, encodeFunctionData, http, defineChain, } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+export const SAFE_V141 = {
+    singleton: "0x41675C099F32341bf84BFc5382aF534df5C7461a",
+    proxyFactory: "0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67",
+    fallbackHandler: "0xfd0732Dc9E303f09fCEf3a7388Ad10A83459Ec99",
+};
+const SAFE_SETUP_ABI = [
+    {
+        type: "function",
+        name: "setup",
+        inputs: [
+            { name: "_owners", type: "address[]" },
+            { name: "_threshold", type: "uint256" },
+            { name: "to", type: "address" },
+            { name: "data", type: "bytes" },
+            { name: "fallbackHandler", type: "address" },
+            { name: "paymentToken", type: "address" },
+            { name: "payment", type: "uint256" },
+            { name: "paymentReceiver", type: "address" },
+        ],
+        outputs: [],
+        stateMutability: "nonpayable",
+    },
+];
+const PROXY_FACTORY_ABI = [
+    {
+        type: "function",
+        name: "createProxyWithNonce",
+        inputs: [
+            { name: "_singleton", type: "address" },
+            { name: "initializer", type: "bytes" },
+            { name: "saltNonce", type: "uint256" },
+        ],
+        outputs: [{ name: "proxy", type: "address" }],
+        stateMutability: "nonpayable",
+    },
+    {
+        type: "event",
+        name: "ProxyCreation",
+        inputs: [
+            { name: "proxy", type: "address", indexed: true },
+            { name: "singleton", type: "address", indexed: false },
+        ],
+        anonymous: false,
+    },
+];
+const SAFE_ABI = [
+    {
+        type: "function",
+        name: "execTransaction",
+        inputs: [
+            { name: "to", type: "address" },
+            { name: "value", type: "uint256" },
+            { name: "data", type: "bytes" },
+            { name: "operation", type: "uint8" },
+            { name: "safeTxGas", type: "uint256" },
+            { name: "baseGas", type: "uint256" },
+            { name: "gasPrice", type: "uint256" },
+            { name: "gasToken", type: "address" },
+            { name: "refundReceiver", type: "address" },
+            { name: "signatures", type: "bytes" },
+        ],
+        outputs: [{ name: "", type: "bool" }],
+        stateMutability: "payable",
+    },
+    {
+        type: "function",
+        name: "nonce",
+        inputs: [],
+        outputs: [{ name: "", type: "uint256" }],
+        stateMutability: "view",
+    },
+    {
+        type: "function",
+        name: "enableModule",
+        inputs: [{ name: "module", type: "address" }],
+        outputs: [],
+        stateMutability: "nonpayable",
+    },
+    {
+        type: "function",
+        name: "isModuleEnabled",
+        inputs: [{ name: "module", type: "address" }],
+        outputs: [{ name: "", type: "bool" }],
+        stateMutability: "view",
+    },
+];
+export function buildClients(cfg, ownerPk) {
+    const owner = privateKeyToAccount(ownerPk);
+    const chain = defineChain({
+        id: cfg.chainId,
+        name: `chain-${cfg.chainId}`,
+        nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+        rpcUrls: { default: { http: [cfg.rpcUrl] } },
+    });
+    const publicClient = createPublicClient({ chain, transport: http(cfg.rpcUrl) });
+    const walletClient = createWalletClient({
+        chain,
+        transport: http(cfg.rpcUrl),
+        account: owner,
+    });
+    return { owner, publicClient, walletClient };
+}
+/** Deploy a 1-of-1 Safe and return its address. */
+export async function deploySafe(cfg, ownerPk) {
+    const { owner, publicClient, walletClient } = buildClients(cfg, ownerPk);
+    const initializer = encodeFunctionData({
+        abi: SAFE_SETUP_ABI,
+        functionName: "setup",
+        args: [
+            [owner.address],
+            1n,
+            "0x0000000000000000000000000000000000000000",
+            "0x",
+            SAFE_V141.fallbackHandler,
+            "0x0000000000000000000000000000000000000000",
+            0n,
+            "0x0000000000000000000000000000000000000000",
+        ],
+    });
+    const saltNonce = BigInt(Date.now());
+    const txHash = await walletClient.writeContract({
+        address: SAFE_V141.proxyFactory,
+        abi: PROXY_FACTORY_ABI,
+        functionName: "createProxyWithNonce",
+        args: [SAFE_V141.singleton, initializer, saltNonce],
+    });
+    const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+    // Extract Safe address from ProxyCreation event topic[1] (indexed).
+    const log = receipt.logs.find((l) => l.address.toLowerCase() === SAFE_V141.proxyFactory.toLowerCase() &&
+        l.topics[0]?.toLowerCase() ===
+            "0x4f51faf6c4561ff95f067657e43439f0f856d97c04d9ec9070a6199ad418e235");
+    if (!log || !log.topics[1])
+        throw new Error("ProxyCreation event missing");
+    const safe = (`0x${log.topics[1].slice(26)}`);
+    return { safe, tx: txHash };
+}
+/** Execute a single Safe transaction (operation = CALL, nonce auto-fetched). */
+export async function execSafeTx(cfg, ownerPk, safe, to, data) {
+    const { owner, publicClient, walletClient } = buildClients(cfg, ownerPk);
+    const nonce = (await publicClient.readContract({
+        address: safe,
+        abi: SAFE_ABI,
+        functionName: "nonce",
+    }));
+    const params = {
+        to,
+        value: 0n,
+        data,
+        operation: 0,
+        safeTxGas: 0n,
+        baseGas: 0n,
+        gasPrice: 0n,
+        gasToken: "0x0000000000000000000000000000000000000000",
+        refundReceiver: "0x0000000000000000000000000000000000000000",
+        nonce,
+    };
+    const signature = await owner.signTypedData({
+        domain: { chainId: cfg.chainId, verifyingContract: safe },
+        types: {
+            SafeTx: [
+                { name: "to", type: "address" },
+                { name: "value", type: "uint256" },
+                { name: "data", type: "bytes" },
+                { name: "operation", type: "uint8" },
+                { name: "safeTxGas", type: "uint256" },
+                { name: "baseGas", type: "uint256" },
+                { name: "gasPrice", type: "uint256" },
+                { name: "gasToken", type: "address" },
+                { name: "refundReceiver", type: "address" },
+                { name: "nonce", type: "uint256" },
+            ],
+        },
+        primaryType: "SafeTx",
+        message: params,
+    });
+    const txHash = await walletClient.writeContract({
+        address: safe,
+        abi: SAFE_ABI,
+        functionName: "execTransaction",
+        args: [
+            params.to,
+            params.value,
+            params.data,
+            params.operation,
+            params.safeTxGas,
+            params.baseGas,
+            params.gasPrice,
+            params.gasToken,
+            params.refundReceiver,
+            signature,
+        ],
+    });
+    await publicClient.waitForTransactionReceipt({ hash: txHash });
+    return txHash;
+}
+export async function isModuleEnabled(cfg, safe, module) {
+    const publicClient = createPublicClient({
+        chain: defineChain({
+            id: cfg.chainId,
+            name: `chain-${cfg.chainId}`,
+            nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+            rpcUrls: { default: { http: [cfg.rpcUrl] } },
+        }),
+        transport: http(cfg.rpcUrl),
+    });
+    return (await publicClient.readContract({
+        address: safe,
+        abi: SAFE_ABI,
+        functionName: "isModuleEnabled",
+        args: [module],
+    }));
+}
+export const ALLOWANCE_MODULE_ABI = [
+    {
+        type: "function",
+        name: "addDelegate",
+        inputs: [{ name: "delegate", type: "address" }],
+        outputs: [],
+        stateMutability: "nonpayable",
+    },
+    {
+        type: "function",
+        name: "setAllowance",
+        inputs: [
+            { name: "delegate", type: "address" },
+            { name: "token", type: "address" },
+            { name: "allowanceAmount", type: "uint96" },
+            { name: "resetTimeMin", type: "uint16" },
+            { name: "resetBaseMin", type: "uint32" },
+        ],
+        outputs: [],
+        stateMutability: "nonpayable",
+    },
+    {
+        type: "function",
+        name: "deleteAllowance",
+        inputs: [
+            { name: "delegate", type: "address" },
+            { name: "token", type: "address" },
+        ],
+        outputs: [],
+        stateMutability: "nonpayable",
+    },
+    {
+        type: "function",
+        name: "getTokenAllowance",
+        inputs: [
+            { name: "safe", type: "address" },
+            { name: "delegate", type: "address" },
+            { name: "token", type: "address" },
+        ],
+        outputs: [{ name: "", type: "uint256[5]" }],
+        stateMutability: "view",
+    },
+];
+export function encodeEnableModule(module) {
+    return encodeFunctionData({
+        abi: SAFE_ABI,
+        functionName: "enableModule",
+        args: [module],
+    });
+}
+export function encodeAddDelegate(delegate) {
+    return encodeFunctionData({
+        abi: ALLOWANCE_MODULE_ABI,
+        functionName: "addDelegate",
+        args: [delegate],
+    });
+}
+export function encodeSetAllowance(delegate, token, amountAtomic, resetMinutes) {
+    return encodeFunctionData({
+        abi: ALLOWANCE_MODULE_ABI,
+        functionName: "setAllowance",
+        args: [delegate, token, amountAtomic, resetMinutes, 0],
+    });
+}
+export function encodeDeleteAllowance(delegate, token) {
+    return encodeFunctionData({
+        abi: ALLOWANCE_MODULE_ABI,
+        functionName: "deleteAllowance",
+        args: [delegate, token],
+    });
+}
+//# sourceMappingURL=safe.js.map

package/dist/cli/safe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe.js","sourceRoot":"","sources":["../../src/cli/safe.ts"],"names":[],"mappings":"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"}

package/dist/cli/setup.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/setup.js

@@ -0,0 +1,234 @@
+/**
+ * hpp-x402-safe-setup — one-shot bootstrap of the user's wallet config.
+ *
+ * Composes the four steps that used to live in /tmp/safe-deploy/* into
+ * a single command:
+ *
+ *   1. Deploy a 1-of-1 Safe (owner = --owner-pk's account)
+ *   2. Generate a fresh delegate EOA (or use --delegate-pk if provided)
+ *   3. Fund the Safe with USDC.e (--fund-usdc) + delegate with ETH (--fund-eth)
+ *      from the owner account
+ *   4. Send three Safe transactions:
+ *      - enableModule(allowanceModule)
+ *      - allowanceModule.addDelegate(delegate)
+ *      - allowanceModule.setAllowance(delegate, USDCe, allowance/day, 1440, 0)
+ *
+ * Outputs a copy-pasteable env block + (optional) merges into the host
+ * config (Claude Desktop) via the existing install-claude-desktop helper.
+ *
+ * Usage:
+ *   npx -y @hpp-io/x402-mcp-bridge setup \
+ *     --owner-pk 0x...                     (required — Safe owner key)
+ *     --network eip155:181228              (default: HPP Sepolia)
+ *     --rpc https://sepolia.hpp.io         (default by network)
+ *     --usdc 0x401eCb1D...                 (default by network)
+ *     --module 0x3CcE72...                 (default by network)
+ *     --allowance 1                        (USDC.e/day, default 1)
+ *     --fund-usdc 5                        (Safe USDC.e seed, default 5)
+ *     --fund-eth 0.001                     (delegate gas seed, default 0.001)
+ *     --delegate-pk 0x...                  (optional; auto-generates if omitted)
+ *     --resource-server-url https://...    (default localhost:4021/mcp/sse)
+ *     --install-claude                     (also write claude_desktop_config.json)
+ */
+import { parseUnits, parseEther, } from "viem";
+import { privateKeyToAccount, generatePrivateKey } from "viem/accounts";
+import { buildClients, deploySafe, execSafeTx, encodeEnableModule, encodeAddDelegate, encodeSetAllowance, isModuleEnabled, } from "./safe.js";
+// Built-in defaults per network; users can override with flags.
+const DEFAULTS = {
+    "eip155:181228": {
+        rpc: "https://sepolia.hpp.io",
+        usdc: "0x401eCb1D350407f13ba348573E5630B83638E30D",
+        module: "0x3CcE72483929e0517Dafc8fD192547B3B65f9b07",
+        chainId: 181228,
+        name: "HPP Sepolia",
+    },
+    // Mainnet entry pre-wired for when AllowanceModule is deployed there.
+    // "eip155:190415": { ..., module: "0x..." }
+};
+function parseArgs(argv) {
+    const out = {};
+    for (let i = 2; i < argv.length; i++) {
+        const a = argv[i];
+        if (!a.startsWith("--"))
+            continue;
+        const k = a.slice(2);
+        const next = argv[i + 1];
+        if (!next || next.startsWith("--")) {
+            out[k] = true;
+        }
+        else {
+            out[k] = next;
+            i++;
+        }
+    }
+    return out;
+}
+function requireStr(a, k) {
+    const v = a[k];
+    if (typeof v !== "string" || v.length === 0) {
+        console.error(`missing --${k}`);
+        process.exit(1);
+    }
+    return v;
+}
+const ERC20_TRANSFER_ABI = [
+    {
+        type: "function",
+        name: "transfer",
+        inputs: [
+            { name: "to", type: "address" },
+            { name: "amount", type: "uint256" },
+        ],
+        outputs: [{ name: "", type: "bool" }],
+        stateMutability: "nonpayable",
+    },
+];
+async function main() {
+    const args = parseArgs(process.argv);
+    const network = args.network || "eip155:181228";
+    const def = DEFAULTS[network];
+    if (!def) {
+        console.error(`unsupported network: ${network} (no default known)`);
+        process.exit(1);
+    }
+    const ownerPk = requireStr(args, "owner-pk");
+    const rpc = args.rpc || def.rpc;
+    const usdc = (args.usdc || def.usdc);
+    const module = (args.module || def.module);
+    const chainId = def.chainId;
+    const allowanceUSDC = args.allowance || "1";
+    const fundUSDC = args["fund-usdc"] || "5";
+    const fundETH = args["fund-eth"] || "0.001";
+    const resourceServerUrl = args["resource-server-url"] ||
+        "http://localhost:4021/mcp/sse";
+    const installClaude = args["install-claude"] === true;
+    let delegatePk = args["delegate-pk"];
+    let delegateGenerated = false;
+    if (!delegatePk) {
+        delegatePk = generatePrivateKey();
+        delegateGenerated = true;
+    }
+    const delegate = privateKeyToAccount(delegatePk).address;
+    const cfg = { rpcUrl: rpc, chainId };
+    console.log(`hpp-x402-safe-setup`);
+    console.log(`  network         : ${network} (${def.name})`);
+    console.log(`  rpc             : ${rpc}`);
+    console.log(`  USDC.e          : ${usdc}`);
+    console.log(`  AllowanceModule : ${module}`);
+    console.log(`  owner address   : ${privateKeyToAccount(ownerPk).address}`);
+    console.log(`  delegate address: ${delegate}${delegateGenerated ? " (auto-generated)" : ""}`);
+    console.log(`  allowance       : ${allowanceUSDC} USDC.e / 24h`);
+    console.log(`  fund-usdc       : ${fundUSDC} USDC.e`);
+    console.log(`  fund-eth        : ${fundETH} ETH`);
+    console.log("");
+    // ---- 1) Deploy Safe -------------------------------------------------
+    console.log("[1/5] Deploying Safe (1-of-1)…");
+    const { safe, tx: deployTx } = await deploySafe(cfg, ownerPk);
+    console.log(`      ✓ Safe: ${safe}  (tx ${deployTx})`);
+    // ---- 2) Fund Safe with USDC.e + delegate with ETH ------------------
+    const { walletClient, publicClient } = buildClients(cfg, ownerPk);
+    const usdcAtomic = parseUnits(fundUSDC, 6);
+    const ethWei = parseEther(fundETH);
+    console.log(`[2/5] Funding Safe with ${fundUSDC} USDC.e + delegate with ${fundETH} ETH…`);
+    const usdcTransferTx = await walletClient.writeContract({
+        address: usdc,
+        abi: ERC20_TRANSFER_ABI,
+        functionName: "transfer",
+        args: [safe, usdcAtomic],
+    });
+    await publicClient.waitForTransactionReceipt({ hash: usdcTransferTx });
+    const ethTx = await walletClient.sendTransaction({
+        to: delegate,
+        value: ethWei,
+    });
+    await publicClient.waitForTransactionReceipt({ hash: ethTx });
+    console.log(`      ✓ Safe ← ${fundUSDC} USDC.e (tx ${usdcTransferTx})`);
+    console.log(`      ✓ delegate ← ${fundETH} ETH (tx ${ethTx})`);
+    // ---- 3) enableModule(AllowanceModule) ------------------------------
+    if (await isModuleEnabled(cfg, safe, module)) {
+        console.log("[3/5] AllowanceModule already enabled — skip");
+    }
+    else {
+        console.log("[3/5] Enabling AllowanceModule…");
+        const enableTx = await execSafeTx(cfg, ownerPk, safe, safe, encodeEnableModule(module));
+        console.log(`      ✓ enabled (Safe tx ${enableTx})`);
+    }
+    // ---- 4) addDelegate ------------------------------------------------
+    console.log("[4/5] Authorising delegate…");
+    const addDelegateTx = await execSafeTx(cfg, ownerPk, safe, module, encodeAddDelegate(delegate));
+    console.log(`      ✓ addDelegate (Safe tx ${addDelegateTx})`);
+    // ---- 5) setAllowance -----------------------------------------------
+    const allowanceAtomic = parseUnits(allowanceUSDC, 6);
+    console.log(`[5/5] Setting allowance ${allowanceUSDC} USDC.e / 24h…`);
+    const setAllowanceTx = await execSafeTx(cfg, ownerPk, safe, module, encodeSetAllowance(delegate, usdc, allowanceAtomic, 1440));
+    console.log(`      ✓ setAllowance (Safe tx ${setAllowanceTx})`);
+    // ---- Output --------------------------------------------------------
+    console.log("\n🎉 setup complete.\n");
+    console.log("Addresses:");
+    console.log(`  Safe              : ${safe}`);
+    console.log(`  Delegate EOA      : ${delegate}`);
+    console.log(`  AllowanceModule   : ${module}`);
+    console.log(`  USDC.e            : ${usdc}`);
+    console.log("");
+    if (delegateGenerated) {
+        console.log("⚠ Delegate private key (save securely — *not* committed):");
+        console.log(`  ${delegatePk}`);
+        console.log("");
+    }
+    const envBlock = {
+        DELEGATE_PRIVATE_KEY: delegatePk,
+        SAFE_ADDRESS: safe,
+        ALLOWANCE_MODULE_ADDRESS: module,
+        USDCE_ADDRESS: usdc,
+        RESOURCE_SERVER_URL: resourceServerUrl,
+        HPP_RPC_URL: rpc,
+        HPP_NETWORK: network,
+        LOG_LEVEL: "info",
+    };
+    console.log("Paste into claude_desktop_config.json (or openclaw config.json):");
+    console.log(JSON.stringify({
+        mcpServers: {
+            "hpp-x402": {
+                command: "npx",
+                args: ["-y", "@hpp-io/x402-mcp-bridge"],
+                env: envBlock,
+            },
+        },
+    }, null, 2));
+    if (installClaude) {
+        console.log("\n[install-claude] Writing to Claude Desktop config…");
+        const { installClaudeDesktop } = await import("./install-claude.js");
+        try {
+            const r = installClaudeDesktop(envBlock, {
+                force: true,
+            });
+            console.log(`      config: ${r.configPath}`);
+            if (r.backupPath)
+                console.log(`      backup: ${r.backupPath}`);
+            console.log(`      preserved entries: ${r.preservedEntries.length}`);
+            console.log(`      changed: ${r.changed}`);
+            console.log("\n   ✓ Restart Claude Desktop (cmd+Q then reopen) to load.");
+        }
+        catch (err) {
+            console.error("   ✗ install-claude failed:", err.message);
+            console.error("     Use the env block above to merge manually.");
+        }
+    }
+    else {
+        console.log("\nTo merge into Claude Desktop automatically, re-run with --install-claude.");
+        console.log("To start the bridge manually:");
+        console.log(`  RESOURCE_SERVER_URL=${resourceServerUrl} \\`);
+        console.log(`  DELEGATE_PRIVATE_KEY=${delegatePk} \\`);
+        console.log(`  SAFE_ADDRESS=${safe} \\`);
+        console.log(`  ALLOWANCE_MODULE_ADDRESS=${module} \\`);
+        console.log(`  USDCE_ADDRESS=${usdc} \\`);
+        console.log(`  HPP_RPC_URL=${rpc} \\`);
+        console.log(`  HPP_NETWORK=${network} \\`);
+        console.log(`  npx @hpp-io/x402-mcp-bridge`);
+    }
+}
+main().catch((err) => {
+    console.error("\nERROR:", err?.message ?? err);
+    process.exit(1);
+});
+//# sourceMappingURL=setup.js.map

package/dist/cli/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,EACL,UAAU,EACV,UAAU,GAQX,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExE,OAAO,EAEL,YAAY,EACZ,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,GAEhB,MAAM,WAAW,CAAC;AAEnB,gEAAgE;AAChE,MAAM,QAAQ,GAGV;IACF,eAAe,EAAE;QACf,GAAG,EAAE,wBAAwB;QAC7B,IAAI,EAAE,4CAA4C;QAClD,MAAM,EAAE,4CAA4C;QACpD,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,aAAa;KACpB;IACD,sEAAsE;IACtE,4CAA4C;CAC7C,CAAC;AAKF,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,GAAG,GAAS,EAAE,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QAClC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;YACd,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,UAAU,CAAC,CAAO,EAAE,CAAS;IACpC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACf,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QAChC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,kBAAkB,GAAG;IACzB;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;YAC/B,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;SACpC;QACD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACrC,eAAe,EAAE,YAAY;KAC9B;CACO,CAAC;AAEX,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,OAAO,GAAI,IAAI,CAAC,OAAkB,IAAI,eAAe,CAAC;IAC5D,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,CAAC,KAAK,CAAC,wBAAwB,OAAO,qBAAqB,CAAC,CAAC;QACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,CAAQ,CAAC;IACpD,MAAM,GAAG,GAAI,IAAI,CAAC,GAAc,IAAI,GAAG,CAAC,GAAG,CAAC;IAC5C,MAAM,IAAI,GAAG,CAAE,IAAI,CAAC,IAAe,IAAI,GAAG,CAAC,IAAI,CAAY,CAAC;IAC5D,MAAM,MAAM,GAAG,CAAE,IAAI,CAAC,MAAiB,IAAI,GAAG,CAAC,MAAM,CAAY,CAAC;IAClE,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IAC5B,MAAM,aAAa,GAAI,IAAI,CAAC,SAAoB,IAAI,GAAG,CAAC;IACxD,MAAM,QAAQ,GAAI,IAAI,CAAC,WAAW,CAAY,IAAI,GAAG,CAAC;IACtD,MAAM,OAAO,GAAI,IAAI,CAAC,UAAU,CAAY,IAAI,OAAO,CAAC;IACxD,MAAM,iBAAiB,GACpB,IAAI,CAAC,qBAAqB,CAAY;QACvC,+BAA+B,CAAC;IAClC,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IAEtD,IAAI,UAAU,GAAI,IAAI,CAAC,aAAa,CAA+B,CAAC;IACpE,IAAI,iBAAiB,GAAG,KAAK,CAAC;IAC9B,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,UAAU,GAAG,kBAAkB,EAAE,CAAC;QAClC,iBAAiB,GAAG,IAAI,CAAC;IAC3B,CAAC;IACD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC;IAEzD,MAAM,GAAG,GAAgB,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;IAElD,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,uBAAuB,OAAO,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,uBAAuB,mBAAmB,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3E,OAAO,CAAC,GAAG,CAAC,uBAAuB,QAAQ,GAAG,iBAAiB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9F,OAAO,CAAC,GAAG,CAAC,uBAAuB,aAAa,eAAe,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,uBAAuB,QAAQ,SAAS,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,uBAAuB,OAAO,MAAM,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,wEAAwE;IACxE,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;IAC9C,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,SAAS,QAAQ,GAAG,CAAC,CAAC;IAEvD,uEAAuE;IACvE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAEnC,OAAO,CAAC,GAAG,CAAC,2BAA2B,QAAQ,2BAA2B,OAAO,OAAO,CAAC,CAAC;IAC1F,MAAM,cAAc,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC;QACtD,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,kBAAkB;QACvB,YAAY,EAAE,UAAU;QACxB,IAAI,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC;KACzB,CAAC,CAAC;IACH,MAAM,YAAY,CAAC,yBAAyB,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;IAEvE,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,eAAe,CAAC;QAC/C,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,MAAM;KACd,CAAC,CAAC;IACH,MAAM,YAAY,CAAC,yBAAyB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,kBAAkB,QAAQ,eAAe,cAAc,GAAG,CAAC,CAAC;IACxE,OAAO,CAAC,GAAG,CAAC,sBAAsB,OAAO,YAAY,KAAK,GAAG,CAAC,CAAC;IAE/D,uEAAuE;IACvE,IAAI,MAAM,eAAe,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAC9D,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;QACxF,OAAO,CAAC,GAAG,CAAC,4BAA4B,QAAQ,GAAG,CAAC,CAAC;IACvD,CAAC;IAED,uEAAuE;IACvE,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IAC3C,MAAM,aAAa,GAAG,MAAM,UAAU,CACpC,GAAG,EACH,OAAO,EACP,IAAI,EACJ,MAAM,EACN,iBAAiB,CAAC,QAAQ,CAAC,CAC5B,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,gCAAgC,aAAa,GAAG,CAAC,CAAC;IAE9D,uEAAuE;IACvE,MAAM,eAAe,GAAG,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,2BAA2B,aAAa,gBAAgB,CAAC,CAAC;IACtE,MAAM,cAAc,GAAG,MAAM,UAAU,CACrC,GAAG,EACH,OAAO,EACP,IAAI,EACJ,MAAM,EACN,kBAAkB,CAAC,QAAQ,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,CAAC,CAC1D,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,iCAAiC,cAAc,GAAG,CAAC,CAAC;IAEhE,uEAAuE;IACvE,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,CAAC,yBAAyB,MAAM,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;QACzE,OAAO,CAAC,GAAG,CAAC,KAAK,UAAU,EAAE,CAAC,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG;QACf,oBAAoB,EAAE,UAAU;QAChC,YAAY,EAAE,IAAI;QAClB,wBAAwB,EAAE,MAAM;QAChC,aAAa,EAAE,IAAI;QACnB,mBAAmB,EAAE,iBAAiB;QACtC,WAAW,EAAE,GAAG;QAChB,WAAW,EAAE,OAAO;QACpB,SAAS,EAAE,MAAM;KAClB,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,kEAAkE,CAAC,CAAC;IAChF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CACxB;QACE,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,CAAC,IAAI,EAAE,yBAAyB,CAAC;gBACvC,GAAG,EAAE,QAAQ;aACd;SACF;KACF,EACD,IAAI,EACJ,CAAC,CACF,CAAC,CAAC;IAEH,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;QACpE,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QACrE,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,oBAAoB,CAAC,QAAsD,EAAE;gBACrF,KAAK,EAAE,IAAI;aACZ,CAAC,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;YAC7C,IAAI,CAAC,CAAC,UAAU;gBAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;YAC/D,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC;YACrE,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;QAC5E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;YACrE,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;QAC3F,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,yBAAyB,iBAAiB,KAAK,CAAC,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,0BAA0B,UAAU,KAAK,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,KAAK,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,8BAA8B,MAAM,KAAK,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,KAAK,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,KAAK,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,iBAAiB,OAAO,KAAK,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,EAAE,OAAO,IAAI,GAAG,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Upstream MCP client. Connects to the remote x402 MCP server (the
+ * "seller") and wraps it with @x402/mcp's payment middleware.
+ *
+ * The middleware handles the 402 → sign → retry cycle. We hook into its
+ * `onPaymentRequested` callback to run autoTopup before each payment so
+ * the delegate EOA holds enough USDC.e to sign the EIP-3009 authorization.
+ */
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { wrapMCPClientWithPaymentFromConfig } from "@x402/mcp";
+import type { Network } from "@x402/core/types";
+import type { AutoTopup } from "./autoTopup.js";
+import { RawEoaSigner } from "./signers/raw-eoa.js";
+export interface UpstreamClient {
+    /** Standard MCP client — listTools/etc go here. */
+    base: Client;
+    /** Payment-aware wrapper — callTool goes here. */
+    x402: ReturnType<typeof wrapMCPClientWithPaymentFromConfig>;
+    /** Disconnect and free resources. */
+    close(): Promise<void>;
+}
+export interface UpstreamOptions {
+    url: string;
+    network: Network;
+    signer: RawEoaSigner;
+    autoTopup: AutoTopup;
+    bridgeName: string;
+    bridgeVersion: string;
+}
+export declare function connectUpstream(opts: UpstreamOptions): Promise<UpstreamClient>;

package/dist/client.js

@@ -0,0 +1,65 @@
+/**
+ * Upstream MCP client. Connects to the remote x402 MCP server (the
+ * "seller") and wraps it with @x402/mcp's payment middleware.
+ *
+ * The middleware handles the 402 → sign → retry cycle. We hook into its
+ * `onPaymentRequested` callback to run autoTopup before each payment so
+ * the delegate EOA holds enough USDC.e to sign the EIP-3009 authorization.
+ */
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
+import { wrapMCPClientWithPaymentFromConfig } from "@x402/mcp";
+import { ExactEvmScheme } from "@x402/evm/exact/client";
+import { log } from "./log.js";
+export async function connectUpstream(opts) {
+    const base = new Client({ name: opts.bridgeName, version: opts.bridgeVersion });
+    const x402 = wrapMCPClientWithPaymentFromConfig(base, {
+        schemes: [
+            {
+                network: opts.network,
+                client: new ExactEvmScheme(opts.signer.viemAccount),
+            },
+        ],
+    }, {
+        autoPayment: true,
+        onPaymentRequested: async ({ paymentRequired }) => {
+            const accept = paymentRequired.accepts?.[0];
+            if (!accept)
+                return false;
+            const requiredAtomic = BigInt(accept.amount ?? "0");
+            log.info("payment.requested", {
+                amount: requiredAtomic.toString(),
+                asset: accept.asset,
+                network: accept.network,
+            });
+            try {
+                const txHash = await opts.autoTopup.ensure(requiredAtomic);
+                if (txHash) {
+                    log.info("autoTopup.executed", { txHash, requiredAtomic: requiredAtomic.toString() });
+                }
+                else {
+                    log.debug("autoTopup.skipped — sufficient balance");
+                }
+                return true;
+            }
+            catch (err) {
+                log.error("autoTopup.failed", {
+                    err: err.message,
+                    requiredAtomic: requiredAtomic.toString(),
+                });
+                return false; // refuse payment — host will see the error
+            }
+        },
+    });
+    const transport = new SSEClientTransport(new URL(opts.url));
+    await base.connect(transport);
+    log.info("upstream.connected", { url: opts.url });
+    return {
+        base,
+        x402,
+        async close() {
+            await base.close().catch(() => { });
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,kCAAkC,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAKxD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAoB/B,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAqB;IACzD,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;IAEhF,MAAM,IAAI,GAAG,kCAAkC,CAC7C,IAAI,EACJ;QACE,OAAO,EAAE;YACP;gBACE,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,MAAM,EAAE,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;aACpD;SACF;KACF,EACD;QACE,WAAW,EAAE,IAAI;QACjB,kBAAkB,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE;YAChD,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YAC5C,IAAI,CAAC,MAAM;gBAAE,OAAO,KAAK,CAAC;YAE1B,MAAM,cAAc,GAAG,MAAM,CAAE,MAA8B,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC;YAC7E,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE;gBAC5B,MAAM,EAAE,cAAc,CAAC,QAAQ,EAAE;gBACjC,KAAK,EAAG,MAA6B,CAAC,KAAK;gBAC3C,OAAO,EAAG,MAA+B,CAAC,OAAO;aAClD,CAAC,CAAC;YAEH,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;gBAC3D,IAAI,MAAM,EAAE,CAAC;oBACX,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;gBACxF,CAAC;qBAAM,CAAC;oBACN,GAAG,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;gBACtD,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,GAAG,CAAC,KAAK,CAAC,kBAAkB,EAAE;oBAC5B,GAAG,EAAG,GAAa,CAAC,OAAO;oBAC3B,cAAc,EAAE,cAAc,CAAC,QAAQ,EAAE;iBAC1C,CAAC,CAAC;gBACH,OAAO,KAAK,CAAC,CAAC,2CAA2C;YAC3D,CAAC;QACH,CAAC;KACF,CACF,CAAC;IAEF,MAAM,SAAS,GAAG,IAAI,kBAAkB,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9B,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAElD,OAAO;QACL,IAAI;QACJ,IAAI;QACJ,KAAK,CAAC,KAAK;YACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrC,CAAC;KACF,CAAC;AACJ,CAAC"}