@lucid-fdn/pay 0.3.0

package/README.md

@@ -0,0 +1,181 @@
+# @lucid-fdn/pay
+
+Drop-in `fetch()` replacement with automatic x402 payments for AI agents. Multi-chain: Base, Ethereum, Arbitrum, Optimism, Polygon, ApeChain, Monad, Solana, Sui.
+
+## Install
+
+```bash
+npm install @lucid-fdn/pay
+```
+
+## Quick Start
+
+```ts
+import { createWalletClient, http } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { base } from "viem/chains";
+import { createLucidFetch, ViemWallet } from "@lucid-fdn/pay";
+
+const client = createWalletClient({
+  account: privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`),
+  chain: base,
+  transport: http(),
+});
+
+const lucidFetch = createLucidFetch({
+  wallet: new ViemWallet(client),
+  maxAmountPerRequest: "100000", // 0.10 USDC (6 decimals)
+});
+
+// Use exactly like fetch() -- payments are handled automatically
+const response = await lucidFetch(
+  "https://api.lucid.foundation/v1/chat/completions",
+  {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      model: "gpt-4o",
+      messages: [{ role: "user", content: "Hello" }],
+    }),
+  },
+);
+```
+
+## How It Works
+
+1. Your request is sent to the API as a normal `fetch()` call.
+2. If the server returns HTTP 402, the response body contains an x402 v2 `options[]` array — one entry per supported chain and facilitator, each with the recipient address, token, amount, and chain.
+3. `@lucid-fdn/pay` selects the option matching your wallet's chain (or falls back to the first option), checks the amount against your budget, sends an on-chain USDC transfer, and retries with `X-Payment-Proof` (tx hash) and `X-Payment-Chain` headers.
+4. The server delegates verification to the appropriate facilitator and returns the response.
+
+Works with any x402-enabled API, including Lucid TrustGate and MCPGate endpoints.
+
+### Supported Chains
+
+| Chain | Token | Facilitators |
+|-------|-------|-------------|
+| Base | USDC | Direct, Coinbase, PayAI, Thirdweb |
+| Ethereum | USDC | PayAI, Thirdweb |
+| Arbitrum | USDC | PayAI, Thirdweb |
+| Optimism | USDC | PayAI, Thirdweb |
+| Polygon | USDC | Thirdweb |
+| ApeChain | USDC | Thirdweb |
+| Monad | USDC | Direct, PayAI, Thirdweb |
+| Solana | USDC | PayAI |
+| Sui | USDC | Sui (native) |
+
+## API Reference
+
+### `createLucidFetch(config): lucidFetch`
+
+Returns a configured fetch function that handles x402 payments automatically.
+
+```ts
+const lucidFetch = createLucidFetch(config);
+const response = await lucidFetch(url, init);
+```
+
+### `lucidFetch(url, init?, config?)`
+
+One-shot convenience function. Accepts an inline config as the third argument. If no config is provided, behaves as a standard `fetch()`.
+
+```ts
+import { lucidFetch } from "@lucid-fdn/pay";
+
+const response = await lucidFetch(
+  "https://api.lucid.foundation/v1/chat/completions",
+  { method: "POST", body: "..." },
+  { wallet: myWallet },
+);
+```
+
+### Configuration (`LucidPayConfig`)
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `wallet` | `PaymentWallet` | required | Wallet adapter used for payments |
+| `maxAmountPerRequest` | `string` | no limit | Maximum amount per request in micro-units (USDC has 6 decimals, so `"1000000"` = 1 USDC) |
+| `maxRetries` | `number` | `1` | Number of retries after payment |
+| `onPayment` | `(info: PaymentInfo) => void` | -- | Called after a successful payment |
+| `onPaymentSkipped` | `(info) => void` | -- | Called when a payment exceeds the budget |
+
+### Per-Request Overrides (`LucidFetchOptions`)
+
+Extends standard `RequestInit`. You can override the wallet or budget on individual requests:
+
+```ts
+const response = await lucidFetch(url, {
+  method: "POST",
+  body: "...",
+  wallet: alternateWallet, // override wallet for this call
+  maxAmount: "50000",      // override budget for this call
+});
+```
+
+### `PaymentInfo`
+
+Object passed to the `onPayment` callback:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `txHash` | `string` | On-chain transaction hash |
+| `amount` | `string` | Amount paid (micro-units) |
+| `recipient` | `string` | Payment recipient address |
+| `chain` | `string` | Chain identifier (e.g. `"base-sepolia"`) |
+| `token` | `string` | Token symbol (e.g. `"USDC"`) |
+| `url` | `string` | The URL that required payment |
+
+## Wallets
+
+### `ViemWallet` (production)
+
+Wraps a [viem](https://viem.sh) `WalletClient` to sign and send real ERC-20 transfers on-chain. Consumers bring their own `viem` dependency.
+
+```ts
+import { createWalletClient, http } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { base } from "viem/chains";
+import { ViemWallet } from "@lucid-fdn/pay";
+
+const wallet = new ViemWallet(
+  createWalletClient({
+    account: privateKeyToAccount("0x..."),
+    chain: base,
+    transport: http(),
+  }),
+);
+```
+
+### `MemoryWallet` (testing)
+
+In-memory wallet that records payments without sending real transactions. Useful for tests and local development.
+
+```ts
+import { MemoryWallet } from "@lucid-fdn/pay";
+
+const wallet = new MemoryWallet("0xYourAddress", "base-sepolia");
+
+// After running requests:
+console.log(wallet.payments); // array of recorded payments
+```
+
+### Custom Wallets
+
+Implement the `PaymentWallet` interface to use any signing backend:
+
+```ts
+import type { PaymentWallet } from "@lucid-fdn/pay";
+
+const myWallet: PaymentWallet = {
+  address: "0x...",
+  chain: "base",
+  async sendPayment({ to, amount, tokenAddress, chain }) {
+    // Sign and broadcast an ERC-20 transfer
+    return txHash;
+  },
+};
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { createLucidFetch, lucidFetch } from './lucid-fetch.js';
+export type { LucidPayConfig, LucidFetchOptions, PaymentWallet, PaymentInfo, X402PaymentOption, X402PaymentBlock, X402Response, } from './types.js';
+export { MemoryWallet } from './wallets/memory-wallet.js';
+export { ViemWallet } from './wallets/viem-wallet.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAG/D,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,GACb,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/index.js

@@ -0,0 +1,6 @@
+// Core
+export { createLucidFetch, lucidFetch } from './lucid-fetch.js';
+// Wallets
+export { MemoryWallet } from './wallets/memory-wallet.js';
+export { ViemWallet } from './wallets/viem-wallet.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO;AACP,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAa/D,UAAU;AACV,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/lucid-fetch.d.ts

@@ -0,0 +1,22 @@
+import type { LucidPayConfig, LucidFetchOptions } from './types.js';
+/**
+ * Create a configured lucidFetch function.
+ *
+ * Usage:
+ *   const lucidFetch = createLucidFetch({ wallet: myWallet })
+ *   const response = await lucidFetch('https://api.example.com/v1/chat', { method: 'POST', body: '...' })
+ *   // If 402 returned, payment is handled automatically
+ */
+export declare function createLucidFetch(config: LucidPayConfig): (url: string | URL | Request, init?: LucidFetchOptions) => Promise<Response>;
+/**
+ * Convenience: create a one-shot lucidFetch with inline config.
+ *
+ * Usage:
+ *   import { lucidFetch } from '@lucid/pay'
+ *   const response = await lucidFetch('https://api.example.com/chat', {
+ *     method: 'POST',
+ *     body: JSON.stringify({ model: 'gpt-4o', messages: [...] }),
+ *   }, { wallet: myWallet })
+ */
+export declare function lucidFetch(url: string | URL | Request, init?: LucidFetchOptions, config?: LucidPayConfig): Promise<Response>;
+//# sourceMappingURL=lucid-fetch.d.ts.map

package/dist/lucid-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lucid-fetch.d.ts","sourceRoot":"","sources":["../src/lucid-fetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAIlB,MAAM,YAAY,CAAA;AAEnB;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,IAEnD,KAAK,MAAM,GAAG,GAAG,GAAG,OAAO,EAC3B,OAAO,iBAAiB,KACvB,OAAO,CAAC,QAAQ,CAAC,CA6FrB;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC3B,IAAI,CAAC,EAAE,iBAAiB,EACxB,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,QAAQ,CAAC,CAOnB"}

package/dist/lucid-fetch.js

@@ -0,0 +1,111 @@
+/**
+ * Create a configured lucidFetch function.
+ *
+ * Usage:
+ *   const lucidFetch = createLucidFetch({ wallet: myWallet })
+ *   const response = await lucidFetch('https://api.example.com/v1/chat', { method: 'POST', body: '...' })
+ *   // If 402 returned, payment is handled automatically
+ */
+export function createLucidFetch(config) {
+    return async function lucidFetch(url, init) {
+        const urlStr = url instanceof Request ? url.url : url.toString();
+        const wallet = init?.wallet ?? config.wallet;
+        const maxAmount = init?.maxAmount ?? config.maxAmountPerRequest;
+        const maxRetries = config.maxRetries ?? 1;
+        // First attempt — normal fetch
+        let response = await fetch(url, init);
+        // Not 402 — return as-is
+        if (response.status !== 402)
+            return response;
+        // Parse x402 payment block
+        let x402Body;
+        try {
+            x402Body = await response.json();
+        }
+        catch {
+            // Not a valid x402 response — return original 402
+            return response;
+        }
+        if (!x402Body?.x402?.options || x402Body.x402.options.length === 0) {
+            return response;
+        }
+        // Select a compatible payment option — prefer wallet's chain, fall back to first option
+        const options = x402Body.x402.options;
+        const payment = options.find(o => o.chain === wallet.chain) ?? options[0];
+        // Budget check
+        if (maxAmount) {
+            const requested = BigInt(payment.amount);
+            const max = BigInt(maxAmount);
+            if (requested > max) {
+                config.onPaymentSkipped?.({ amount: payment.amount, max: maxAmount });
+                return response; // Return original 402
+            }
+        }
+        // Check expiry
+        const now = Math.floor(Date.now() / 1000);
+        if (x402Body.x402.expires && now > x402Body.x402.expires) {
+            return response; // Expired — return 402
+        }
+        // Execute payment
+        let txHash;
+        try {
+            txHash = await wallet.sendPayment({
+                to: payment.recipient,
+                amount: payment.amount,
+                tokenAddress: payment.tokenAddress,
+                chain: payment.chain,
+            });
+        }
+        catch {
+            // Payment failed — return original 402
+            return response;
+        }
+        // Notify caller
+        const paymentInfo = {
+            txHash,
+            amount: payment.amount,
+            recipient: payment.recipient,
+            chain: payment.chain,
+            token: payment.token,
+            url: urlStr,
+        };
+        config.onPayment?.(paymentInfo);
+        // Retry with payment proof + chain hint
+        for (let attempt = 0; attempt < maxRetries; attempt++) {
+            const retryHeaders = new Headers(init?.headers);
+            retryHeaders.set('X-Payment-Proof', txHash);
+            retryHeaders.set('X-Payment-Chain', payment.chain);
+            // If server returned a session ID, include it
+            const sessionId = response.headers.get('X-Payment-Session');
+            if (sessionId) {
+                retryHeaders.set('X-Payment-Session', sessionId);
+            }
+            response = await fetch(url, {
+                ...init,
+                headers: retryHeaders,
+            });
+            if (response.status !== 402)
+                return response;
+        }
+        return response;
+    };
+}
+/**
+ * Convenience: create a one-shot lucidFetch with inline config.
+ *
+ * Usage:
+ *   import { lucidFetch } from '@lucid/pay'
+ *   const response = await lucidFetch('https://api.example.com/chat', {
+ *     method: 'POST',
+ *     body: JSON.stringify({ model: 'gpt-4o', messages: [...] }),
+ *   }, { wallet: myWallet })
+ */
+export async function lucidFetch(url, init, config) {
+    if (!config) {
+        // No config — just regular fetch
+        return fetch(url, init);
+    }
+    const fn = createLucidFetch(config);
+    return fn(url, init);
+}
+//# sourceMappingURL=lucid-fetch.js.map

package/dist/lucid-fetch.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,69 @@
+/** Single payment option within an x402 block */
+export type X402PaymentOption = {
+    chain: string;
+    token: string;
+    tokenAddress: string;
+    amount: string;
+    recipient: string;
+    facilitator: string;
+    scheme: string;
+};
+/** x402 payment block from 402 response */
+export type X402PaymentBlock = {
+    version: string;
+    description: string;
+    options: X402PaymentOption[];
+    expires: number;
+};
+/** 402 response body */
+export type X402Response = {
+    error: string;
+    x402: X402PaymentBlock;
+};
+/** Wallet adapter interface — abstract over different wallet types */
+export type PaymentWallet = {
+    /** The wallet address */
+    address: string;
+    /** Chain the wallet operates on */
+    chain: string;
+    /** Sign and send a USDC transfer, return the tx hash */
+    sendPayment(params: {
+        to: string;
+        amount: string;
+        tokenAddress: string;
+        chain: string;
+    }): Promise<string>;
+};
+/** Configuration for lucidFetch */
+export type LucidPayConfig = {
+    /** Wallet to use for payments */
+    wallet: PaymentWallet;
+    /** Maximum amount willing to pay per request (micro-units). Default: no limit */
+    maxAmountPerRequest?: string;
+    /** Maximum retries after payment. Default: 1 */
+    maxRetries?: number;
+    /** Callback when a payment is made */
+    onPayment?: (info: PaymentInfo) => void;
+    /** Callback when payment is skipped (over budget) */
+    onPaymentSkipped?: (info: {
+        amount: string;
+        max: string;
+    }) => void;
+};
+/** Information about a payment that was made */
+export type PaymentInfo = {
+    txHash: string;
+    amount: string;
+    recipient: string;
+    chain: string;
+    token: string;
+    url: string;
+};
+/** Options for lucidFetch — extends standard RequestInit */
+export type LucidFetchOptions = RequestInit & {
+    /** Override wallet for this request */
+    wallet?: PaymentWallet;
+    /** Override max amount for this request */
+    maxAmount?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,2CAA2C;AAC3C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,iBAAiB,EAAE,CAAA;IAC5B,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,wBAAwB;AACxB,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,gBAAgB,CAAA;CACvB,CAAA;AAED,sEAAsE;AACtE,MAAM,MAAM,aAAa,GAAG;IAC1B,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,wDAAwD;IACxD,WAAW,CAAC,MAAM,EAAE;QAClB,EAAE,EAAE,MAAM,CAAA;QACV,MAAM,EAAE,MAAM,CAAA;QACd,YAAY,EAAE,MAAM,CAAA;QACpB,KAAK,EAAE,MAAM,CAAA;KACd,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACpB,CAAA;AAED,mCAAmC;AACnC,MAAM,MAAM,cAAc,GAAG;IAC3B,iCAAiC;IACjC,MAAM,EAAE,aAAa,CAAA;IACrB,iFAAiF;IACjF,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sCAAsC;IACtC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAA;IACvC,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;CACnE,CAAA;AAED,gDAAgD;AAChD,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,4DAA4D;AAC5D,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG;IAC5C,uCAAuC;IACvC,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/wallets/memory-wallet.d.ts

@@ -0,0 +1,24 @@
+import type { PaymentWallet } from '../types.js';
+/**
+ * In-memory test wallet that tracks payments without real signing.
+ * Use for testing or as a reference implementation.
+ */
+export declare class MemoryWallet implements PaymentWallet {
+    address: string;
+    chain: string;
+    payments: Array<{
+        to: string;
+        amount: string;
+        tokenAddress: string;
+        chain: string;
+        txHash: string;
+    }>;
+    constructor(address: string, chain?: string);
+    sendPayment(params: {
+        to: string;
+        amount: string;
+        tokenAddress: string;
+        chain: string;
+    }): Promise<string>;
+}
+//# sourceMappingURL=memory-wallet.d.ts.map

package/dist/wallets/memory-wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-wallet.d.ts","sourceRoot":"","sources":["../../src/wallets/memory-wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD;;;GAGG;AACH,qBAAa,YAAa,YAAW,aAAa;IAChD,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAK;gBAE7F,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAuB;IAKrD,WAAW,CAAC,MAAM,EAAE;QACxB,EAAE,EAAE,MAAM,CAAA;QACV,MAAM,EAAE,MAAM,CAAA;QACd,YAAY,EAAE,MAAM,CAAA;QACpB,KAAK,EAAE,MAAM,CAAA;KACd,GAAG,OAAO,CAAC,MAAM,CAAC;CAKpB"}

package/dist/wallets/memory-wallet.js

@@ -0,0 +1,19 @@
+/**
+ * In-memory test wallet that tracks payments without real signing.
+ * Use for testing or as a reference implementation.
+ */
+export class MemoryWallet {
+    address;
+    chain;
+    payments = [];
+    constructor(address, chain = 'base-sepolia') {
+        this.address = address;
+        this.chain = chain;
+    }
+    async sendPayment(params) {
+        const txHash = `0x${Date.now().toString(16)}${Math.random().toString(16).slice(2, 10)}`;
+        this.payments.push({ ...params, txHash });
+        return txHash;
+    }
+}
+//# sourceMappingURL=memory-wallet.js.map

package/dist/wallets/memory-wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-wallet.js","sourceRoot":"","sources":["../../src/wallets/memory-wallet.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,YAAY;IACvB,OAAO,CAAQ;IACf,KAAK,CAAQ;IACb,QAAQ,GAA+F,EAAE,CAAA;IAEzG,YAAY,OAAe,EAAE,QAAgB,cAAc;QACzD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAKjB;QACC,MAAM,MAAM,GAAG,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAA;QACvF,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QACzC,OAAO,MAAM,CAAA;IACf,CAAC;CACF"}

package/dist/wallets/viem-wallet.d.ts

@@ -0,0 +1,53 @@
+import type { PaymentWallet } from '../types.js';
+/**
+ * Viem-based wallet adapter for real on-chain USDC payments.
+ *
+ * Usage:
+ * ```ts
+ * import { createWalletClient, http } from 'viem'
+ * import { privateKeyToAccount } from 'viem/accounts'
+ * import { baseSepolia } from 'viem/chains'
+ * import { ViemWallet } from '@lucid/pay'
+ *
+ * const client = createWalletClient({
+ *   account: privateKeyToAccount('0x...'),
+ *   chain: baseSepolia,
+ *   transport: http(),
+ * })
+ * const wallet = new ViemWallet(client)
+ * ```
+ */
+export declare class ViemWallet implements PaymentWallet {
+    address: string;
+    chain: string;
+    private client;
+    constructor(client: WalletClientLike, chain?: string);
+    sendPayment(params: {
+        to: string;
+        amount: string;
+        tokenAddress: string;
+        chain: string;
+    }): Promise<string>;
+}
+/**
+ * Minimal interface matching viem's WalletClient.
+ * Avoids requiring viem as a direct dependency — consumers bring their own.
+ */
+type WalletClientLike = {
+    account?: {
+        address: string;
+    } | null;
+    chain?: {
+        name?: string;
+    } | null;
+    sendTransaction(args: {
+        to: `0x${string}`;
+        data: `0x${string}`;
+        account: {
+            address: string;
+        };
+        chain: unknown;
+    }): Promise<string>;
+};
+export {};
+//# sourceMappingURL=viem-wallet.d.ts.map

package/dist/wallets/viem-wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viem-wallet.d.ts","sourceRoot":"","sources":["../../src/wallets/viem-wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,UAAW,YAAW,aAAa;IAC9C,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE,MAAM;IAS9C,WAAW,CAAC,MAAM,EAAE;QACxB,EAAE,EAAE,MAAM,CAAA;QACV,MAAM,EAAE,MAAM,CAAA;QACd,YAAY,EAAE,MAAM,CAAA;QACpB,KAAK,EAAE,MAAM,CAAA;KACd,GAAG,OAAO,CAAC,MAAM,CAAC;CAepB;AAED;;;GAGG;AACH,KAAK,gBAAgB,GAAG;IACtB,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IACpC,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IAChC,eAAe,CAAC,IAAI,EAAE;QACpB,EAAE,EAAE,KAAK,MAAM,EAAE,CAAA;QACjB,IAAI,EAAE,KAAK,MAAM,EAAE,CAAA;QACnB,OAAO,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;QAC5B,KAAK,EAAE,OAAO,CAAA;KACf,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACpB,CAAA"}

package/dist/wallets/viem-wallet.js

@@ -0,0 +1,45 @@
+/**
+ * Viem-based wallet adapter for real on-chain USDC payments.
+ *
+ * Usage:
+ * ```ts
+ * import { createWalletClient, http } from 'viem'
+ * import { privateKeyToAccount } from 'viem/accounts'
+ * import { baseSepolia } from 'viem/chains'
+ * import { ViemWallet } from '@lucid/pay'
+ *
+ * const client = createWalletClient({
+ *   account: privateKeyToAccount('0x...'),
+ *   chain: baseSepolia,
+ *   transport: http(),
+ * })
+ * const wallet = new ViemWallet(client)
+ * ```
+ */
+export class ViemWallet {
+    address;
+    chain;
+    client;
+    constructor(client, chain) {
+        if (!client.account?.address) {
+            throw new Error('WalletClient must have an account attached');
+        }
+        this.client = client;
+        this.address = client.account.address;
+        this.chain = chain ?? client.chain?.name?.toLowerCase().replace(/\s+/g, '-') ?? 'base';
+    }
+    async sendPayment(params) {
+        // ERC-20 transfer(address,uint256) selector: 0xa9059cbb
+        const amountHex = BigInt(params.amount).toString(16).padStart(64, '0');
+        const toAddress = params.to.slice(2).padStart(64, '0');
+        const data = `0xa9059cbb${toAddress}${amountHex}`;
+        const hash = await this.client.sendTransaction({
+            to: params.tokenAddress,
+            data,
+            account: this.client.account,
+            chain: this.client.chain,
+        });
+        return hash;
+    }
+}
+//# sourceMappingURL=viem-wallet.js.map

package/dist/wallets/viem-wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viem-wallet.js","sourceRoot":"","sources":["../../src/wallets/viem-wallet.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,UAAU;IACrB,OAAO,CAAQ;IACf,KAAK,CAAQ;IACL,MAAM,CAAkB;IAEhC,YAAY,MAAwB,EAAE,KAAc;QAClD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;QAC/D,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAA;QACrC,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,MAAM,CAAA;IACxF,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAKjB;QACC,wDAAwD;QACxD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;QACtE,MAAM,SAAS,GAAG,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;QACtD,MAAM,IAAI,GAAG,aAAa,SAAS,GAAG,SAAS,EAAmB,CAAA;QAElE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;YAC7C,EAAE,EAAE,MAAM,CAAC,YAA6B;YACxC,IAAI;YACJ,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAQ;YAC7B,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;SACzB,CAAC,CAAA;QAEF,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@lucid-fdn/pay",
+  "version": "0.3.0",
+  "description": "Drop-in fetch() replacement that handles x402 payments automatically",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["x402", "payment", "ai", "agent", "fetch", "usdc", "web3"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/raijinlabs/lucid-plateform-core",
+    "directory": "packages/pay"
+  },
+  "homepage": "https://lucid.foundation",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "vitest": "^1.0.0",
+    "typescript": "^5.0.0"
+  }
+}