@sly_ai/sdk 0.1.0

package/dist/vercel.mjs

@@ -0,0 +1,138 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+
+// src/vercel/tools.ts
+function createSlyVercelTools(sly) {
+  return {
+    get_settlement_quote: tool({
+      description: "Get a settlement quote for cross-border payment with FX rates and fees. Use this when a user wants to know how much money will be received in another currency.",
+      parameters: z.object({
+        fromCurrency: z.enum(["USD", "BRL", "MXN", "USDC"]).describe("Source currency"),
+        toCurrency: z.enum(["USD", "BRL", "MXN", "USDC"]).describe("Destination currency"),
+        amount: z.string().describe("Amount to convert"),
+        rail: z.enum(["pix", "spei", "wire", "usdc"]).optional().describe("Settlement rail (optional)")
+      }),
+      execute: async ({ fromCurrency, toCurrency, amount, rail }) => {
+        try {
+          const quote = await sly.getSettlementQuote({
+            fromCurrency,
+            toCurrency,
+            amount,
+            rail
+          });
+          return {
+            success: true,
+            data: quote
+          };
+        } catch (error) {
+          return {
+            success: false,
+            error: error.message
+          };
+        }
+      }
+    }),
+    create_settlement: tool({
+      description: "Execute a settlement using a quote ID. Use this after getting a quote to actually send the money.",
+      parameters: z.object({
+        quoteId: z.string().describe("Quote ID from get_settlement_quote"),
+        destinationAccountId: z.string().describe("Destination account ID"),
+        metadata: z.record(z.any()).optional().describe("Optional metadata")
+      }),
+      execute: async ({ quoteId, destinationAccountId, metadata }) => {
+        try {
+          const settlement = await sly.createSettlement({
+            quoteId,
+            destinationAccountId,
+            metadata
+          });
+          return {
+            success: true,
+            data: settlement
+          };
+        } catch (error) {
+          return {
+            success: false,
+            error: error.message
+          };
+        }
+      }
+    }),
+    get_settlement_status: tool({
+      description: "Check the status of a settlement. Use this to track if a payment has completed.",
+      parameters: z.object({
+        settlementId: z.string().describe("Settlement ID")
+      }),
+      execute: async ({ settlementId }) => {
+        try {
+          const settlement = await sly.getSettlement(settlementId);
+          return {
+            success: true,
+            data: settlement
+          };
+        } catch (error) {
+          return {
+            success: false,
+            error: error.message
+          };
+        }
+      }
+    }),
+    check_compliance: tool({
+      description: "Check if a recipient passes compliance checks before sending payment. Use this to verify a recipient is valid.",
+      parameters: z.object({
+        recipientAccountId: z.string().describe("Recipient account ID"),
+        amount: z.string().describe("Payment amount"),
+        currency: z.enum(["USD", "BRL", "MXN"]).describe("Payment currency")
+      }),
+      execute: async ({ recipientAccountId, amount, currency }) => {
+        try {
+          const result = await sly.checkCompliance({
+            recipientAccountId,
+            amount,
+            currency
+          });
+          return {
+            success: true,
+            data: result
+          };
+        } catch (error) {
+          return {
+            success: false,
+            error: error.message
+          };
+        }
+      }
+    })
+  };
+}
+var SLY_VERCEL_SYSTEM_PROMPT = `You are a helpful AI assistant with access to Sly payment operations.
+
+You can help users with:
+- Getting settlement quotes for cross-border payments (USD, BRL, MXN, USDC)
+- Creating settlements and transfers
+- Checking settlement status
+- Verifying compliance for recipients
+
+Payment rails available:
+- Pix (Brazil): Instant settlement in ~10 seconds
+- SPEI (Mexico): Fast settlement in ~1 minute
+- Wire: Traditional bank transfer
+- USDC: Stablecoin settlement on blockchain
+
+Always:
+1. Get a quote before creating a settlement
+2. Check compliance for new recipients
+3. Confirm important actions with the user
+4. Provide clear information about exchange rates and fees
+5. Explain the estimated settlement time
+
+When presenting quotes:
+- Show the exchange rate clearly
+- Mention any fees
+- Explain the estimated settlement time
+- Ask for confirmation before executing`;
+
+export { SLY_VERCEL_SYSTEM_PROMPT as PAYOS_VERCEL_SYSTEM_PROMPT, SLY_VERCEL_SYSTEM_PROMPT, createSlyVercelTools as createPayOSVercelTools, createSlyVercelTools };
+//# sourceMappingURL=vercel.mjs.map
+//# sourceMappingURL=vercel.mjs.map

package/dist/vercel.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vercel/tools.ts"],"names":[],"mappings":";;;;AAiCO,SAAS,qBAAqB,GAAA,EAAU;AAC7C,EAAA,OAAO;AAAA,IACL,sBAAsB,IAAA,CAAK;AAAA,MACzB,WAAA,EAAa,iKAAA;AAAA,MACb,UAAA,EAAY,EAAE,MAAA,CAAO;AAAA,QACnB,YAAA,EAAc,CAAA,CAAE,IAAA,CAAK,CAAC,KAAA,EAAO,KAAA,EAAO,KAAA,EAAO,MAAM,CAAC,CAAA,CAAE,QAAA,CAAS,iBAAiB,CAAA;AAAA,QAC9E,UAAA,EAAY,CAAA,CAAE,IAAA,CAAK,CAAC,KAAA,EAAO,KAAA,EAAO,KAAA,EAAO,MAAM,CAAC,CAAA,CAAE,QAAA,CAAS,sBAAsB,CAAA;AAAA,QACjF,MAAA,EAAQ,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,mBAAmB,CAAA;AAAA,QAC/C,IAAA,EAAM,CAAA,CAAE,IAAA,CAAK,CAAC,KAAA,EAAO,MAAA,EAAQ,MAAA,EAAQ,MAAM,CAAC,CAAA,CAAE,QAAA,EAAS,CAAE,SAAS,4BAA4B;AAAA,OAC/F,CAAA;AAAA,MACD,SAAS,OAAO,EAAE,cAAc,UAAA,EAAY,MAAA,EAAQ,MAAK,KAAM;AAC7D,QAAA,IAAI;AACF,UAAA,MAAM,KAAA,GAAQ,MAAM,GAAA,CAAI,kBAAA,CAAmB;AAAA,YACzC,YAAA;AAAA,YACA,UAAA;AAAA,YACA,MAAA;AAAA,YACA;AAAA,WACD,CAAA;AACD,UAAA,OAAO;AAAA,YACL,OAAA,EAAS,IAAA;AAAA,YACT,IAAA,EAAM;AAAA,WACR;AAAA,QACF,SAAS,KAAA,EAAY;AACnB,UAAA,OAAO;AAAA,YACL,OAAA,EAAS,KAAA;AAAA,YACT,OAAO,KAAA,CAAM;AAAA,WACf;AAAA,QACF;AAAA,MACF;AAAA,KACD,CAAA;AAAA,IAED,mBAAmB,IAAA,CAAK;AAAA,MACtB,WAAA,EAAa,mGAAA;AAAA,MACb,UAAA,EAAY,EAAE,MAAA,CAAO;AAAA,QACnB,OAAA,EAAS,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,oCAAoC,CAAA;AAAA,QACjE,oBAAA,EAAsB,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,wBAAwB,CAAA;AAAA,QAClE,QAAA,EAAU,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,GAAA,EAAK,CAAA,CAAE,QAAA,EAAS,CAAE,QAAA,CAAS,mBAAmB;AAAA,OACpE,CAAA;AAAA,MACD,SAAS,OAAO,EAAE,OAAA,EAAS,oBAAA,EAAsB,UAAS,KAAM;AAC9D,QAAA,IAAI;AACF,UAAA,MAAM,UAAA,GAAa,MAAM,GAAA,CAAI,gBAAA,CAAiB;AAAA,YAC5C,OAAA;AAAA,YACA,oBAAA;AAAA,YACA;AAAA,WACD,CAAA;AACD,UAAA,OAAO;AAAA,YACL,OAAA,EAAS,IAAA;AAAA,YACT,IAAA,EAAM;AAAA,WACR;AAAA,QACF,SAAS,KAAA,EAAY;AACnB,UAAA,OAAO;AAAA,YACL,OAAA,EAAS,KAAA;AAAA,YACT,OAAO,KAAA,CAAM;AAAA,WACf;AAAA,QACF;AAAA,MACF;AAAA,KACD,CAAA;AAAA,IAED,uBAAuB,IAAA,CAAK;AAAA,MAC1B,WAAA,EAAa,iFAAA;AAAA,MACb,UAAA,EAAY,EAAE,MAAA,CAAO;AAAA,QACnB,YAAA,EAAc,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,eAAe;AAAA,OAClD,CAAA;AAAA,MACD,OAAA,EAAS,OAAO,EAAE,YAAA,EAAa,KAAM;AACnC,QAAA,IAAI;AACF,UAAA,MAAM,UAAA,GAAa,MAAM,GAAA,CAAI,aAAA,CAAc,YAAY,CAAA;AACvD,UAAA,OAAO;AAAA,YACL,OAAA,EAAS,IAAA;AAAA,YACT,IAAA,EAAM;AAAA,WACR;AAAA,QACF,SAAS,KAAA,EAAY;AACnB,UAAA,OAAO;AAAA,YACL,OAAA,EAAS,KAAA;AAAA,YACT,OAAO,KAAA,CAAM;AAAA,WACf;AAAA,QACF;AAAA,MACF;AAAA,KACD,CAAA;AAAA,IAED,kBAAkB,IAAA,CAAK;AAAA,MACrB,WAAA,EAAa,gHAAA;AAAA,MACb,UAAA,EAAY,EAAE,MAAA,CAAO;AAAA,QACnB,kBAAA,EAAoB,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,sBAAsB,CAAA;AAAA,QAC9D,MAAA,EAAQ,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,gBAAgB,CAAA;AAAA,QAC5C,QAAA,EAAU,CAAA,CAAE,IAAA,CAAK,CAAC,KAAA,EAAO,OAAO,KAAK,CAAC,CAAA,CAAE,QAAA,CAAS,kBAAkB;AAAA,OACpE,CAAA;AAAA,MACD,SAAS,OAAO,EAAE,kBAAA,EAAoB,MAAA,EAAQ,UAAS,KAAM;AAC3D,QAAA,IAAI;AACF,UAAA,MAAM,MAAA,GAAS,MAAM,GAAA,CAAI,eAAA,CAAgB;AAAA,YACvC,kBAAA;AAAA,YACA,MAAA;AAAA,YACA;AAAA,WACD,CAAA;AACD,UAAA,OAAO;AAAA,YACL,OAAA,EAAS,IAAA;AAAA,YACT,IAAA,EAAM;AAAA,WACR;AAAA,QACF,SAAS,KAAA,EAAY;AACnB,UAAA,OAAO;AAAA,YACL,OAAA,EAAS,KAAA;AAAA,YACT,OAAO,KAAA,CAAM;AAAA,WACf;AAAA,QACF;AAAA,MACF;AAAA,KACD;AAAA,GACH;AACF;AAKO,IAAM,wBAAA,GAA2B,CAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA,uCAAA","file":"vercel.mjs","sourcesContent":["/**\n * Vercel AI SDK Tools for Sly\n *\n * Provides Sly capabilities as Vercel AI SDK tools for use with\n * Next.js applications, streaming responses, and React hooks.\n *\n * @example\n * ```typescript\n * import { createSlyVercelTools } from '@sly/sdk/vercel';\n * import { openai } from '@ai-sdk/openai';\n * import { generateText } from 'ai';\n *\n * const sly = new Sly({ apiKey: '...', environment: 'sandbox' });\n * const tools = createSlyVercelTools(sly);\n *\n * const result = await generateText({\n *   model: openai('gpt-4'),\n *   prompt: 'Send $100 to Brazil via Pix',\n *   tools,\n * });\n * ```\n */\n\nimport { tool } from 'ai';\nimport { z } from 'zod';\nimport type { Sly } from '../index';\n\n/**\n * Create Vercel AI SDK tools from a Sly instance\n *\n * Returns an object with tools that can be passed directly to\n * `generateText`, `streamText`, or `generateObject` from the `ai` package.\n */\nexport function createSlyVercelTools(sly: Sly) {\n  return {\n    get_settlement_quote: tool({\n      description: 'Get a settlement quote for cross-border payment with FX rates and fees. Use this when a user wants to know how much money will be received in another currency.',\n      parameters: z.object({\n        fromCurrency: z.enum(['USD', 'BRL', 'MXN', 'USDC']).describe('Source currency'),\n        toCurrency: z.enum(['USD', 'BRL', 'MXN', 'USDC']).describe('Destination currency'),\n        amount: z.string().describe('Amount to convert'),\n        rail: z.enum(['pix', 'spei', 'wire', 'usdc']).optional().describe('Settlement rail (optional)'),\n      }),\n      execute: async ({ fromCurrency, toCurrency, amount, rail }) => {\n        try {\n          const quote = await sly.getSettlementQuote({\n            fromCurrency,\n            toCurrency,\n            amount,\n            rail,\n          });\n          return {\n            success: true,\n            data: quote,\n          };\n        } catch (error: any) {\n          return {\n            success: false,\n            error: error.message,\n          };\n        }\n      },\n    }),\n\n    create_settlement: tool({\n      description: 'Execute a settlement using a quote ID. Use this after getting a quote to actually send the money.',\n      parameters: z.object({\n        quoteId: z.string().describe('Quote ID from get_settlement_quote'),\n        destinationAccountId: z.string().describe('Destination account ID'),\n        metadata: z.record(z.any()).optional().describe('Optional metadata'),\n      }),\n      execute: async ({ quoteId, destinationAccountId, metadata }) => {\n        try {\n          const settlement = await sly.createSettlement({\n            quoteId,\n            destinationAccountId,\n            metadata,\n          });\n          return {\n            success: true,\n            data: settlement,\n          };\n        } catch (error: any) {\n          return {\n            success: false,\n            error: error.message,\n          };\n        }\n      },\n    }),\n\n    get_settlement_status: tool({\n      description: 'Check the status of a settlement. Use this to track if a payment has completed.',\n      parameters: z.object({\n        settlementId: z.string().describe('Settlement ID'),\n      }),\n      execute: async ({ settlementId }) => {\n        try {\n          const settlement = await sly.getSettlement(settlementId);\n          return {\n            success: true,\n            data: settlement,\n          };\n        } catch (error: any) {\n          return {\n            success: false,\n            error: error.message,\n          };\n        }\n      },\n    }),\n\n    check_compliance: tool({\n      description: 'Check if a recipient passes compliance checks before sending payment. Use this to verify a recipient is valid.',\n      parameters: z.object({\n        recipientAccountId: z.string().describe('Recipient account ID'),\n        amount: z.string().describe('Payment amount'),\n        currency: z.enum(['USD', 'BRL', 'MXN']).describe('Payment currency'),\n      }),\n      execute: async ({ recipientAccountId, amount, currency }) => {\n        try {\n          const result = await sly.checkCompliance({\n            recipientAccountId,\n            amount,\n            currency,\n          });\n          return {\n            success: true,\n            data: result,\n          };\n        } catch (error: any) {\n          return {\n            success: false,\n            error: error.message,\n          };\n        }\n      },\n    }),\n  };\n}\n\n/**\n * System prompt for Vercel AI SDK agents using Sly tools\n */\nexport const SLY_VERCEL_SYSTEM_PROMPT = `You are a helpful AI assistant with access to Sly payment operations.\n\nYou can help users with:\n- Getting settlement quotes for cross-border payments (USD, BRL, MXN, USDC)\n- Creating settlements and transfers\n- Checking settlement status\n- Verifying compliance for recipients\n\nPayment rails available:\n- Pix (Brazil): Instant settlement in ~10 seconds\n- SPEI (Mexico): Fast settlement in ~1 minute\n- Wire: Traditional bank transfer\n- USDC: Stablecoin settlement on blockchain\n\nAlways:\n1. Get a quote before creating a settlement\n2. Check compliance for new recipients\n3. Confirm important actions with the user\n4. Provide clear information about exchange rates and fees\n5. Explain the estimated settlement time\n\nWhen presenting quotes:\n- Show the exchange rate clearly\n- Mention any fees\n- Explain the estimated settlement time\n- Ask for confirmation before executing`;\n\n// Backward compatibility alias\nexport { SLY_VERCEL_SYSTEM_PROMPT as PAYOS_VERCEL_SYSTEM_PROMPT };\n\n/**\n * Type for Vercel AI SDK tools\n */\nexport type SlyVercelTools = ReturnType<typeof createSlyVercelTools>;\n\n// Backward compatibility alias\nexport type PayOSVercelTools = SlyVercelTools;\n\n// Backward compatibility alias for function\nexport { createSlyVercelTools as createPayOSVercelTools };\n\n"]}

package/dist/x402.d.mts

@@ -0,0 +1,209 @@
+import { P as PayOSEnvironment, g as SlyEnvironment } from './types-df1EICn_.mjs';
+import { RequestHandler } from 'express';
+
+/**
+ * Types for x402 protocol support
+ */
+
+/**
+ * x402 Client configuration
+ */
+interface X402ClientConfig {
+    /**
+     * PayOS API key
+     */
+    apiKey: string;
+    /**
+     * Environment (sandbox, testnet, production)
+     */
+    environment: PayOSEnvironment;
+    /**
+     * EVM private key (required for testnet/production)
+     */
+    evmPrivateKey?: string;
+    /**
+     * Custom facilitator URL (overrides environment default)
+     */
+    facilitatorUrl?: string;
+    /**
+     * Maximum auto-pay amount per request (default: $1)
+     */
+    maxAutoPayAmount?: string;
+    /**
+     * Maximum daily spend limit (default: $100)
+     */
+    maxDailySpend?: string;
+    /**
+     * Callback fired before payment is sent
+     */
+    onPayment?: (payment: X402PaymentInfo) => void | Promise<void>;
+    /**
+     * Callback fired after settlement is confirmed
+     */
+    onSettlement?: (settlement: X402SettlementInfo) => void | Promise<void>;
+    /**
+     * Trigger LATAM rail settlement after x402 payment
+     */
+    settleToRail?: 'pix' | 'spei' | 'none';
+}
+/**
+ * x402 payment information
+ */
+interface X402PaymentInfo {
+    amount: string;
+    currency: string;
+    from: string;
+    to: string;
+    scheme: string;
+    network: string;
+    timestamp: string;
+}
+/**
+ * x402 settlement information
+ */
+interface X402SettlementInfo {
+    transactionHash: string;
+    amount: string;
+    currency: string;
+    timestamp: string;
+    railSettlementId?: string;
+}
+/**
+ * Client status
+ */
+interface X402ClientStatus {
+    environment: PayOSEnvironment;
+    dailySpent: string;
+    dailyLimit: string;
+    walletAddress?: string;
+}
+/**
+ * 402 response from server
+ */
+interface X402Response {
+    statusCode: 402;
+    accepts: Array<{
+        scheme: string;
+        network: string;
+        token: string;
+        amount: string;
+        facilitator: string;
+        [key: string]: unknown;
+    }>;
+}
+
+/**
+ * x402 Client for making payments
+ *
+ * Automatically handles 402 responses by creating payments and retrying.
+ * Supports sandbox mode (no blockchain) and production mode (real EVM).
+ */
+declare class SlyX402Client {
+    private config;
+    private dailySpent;
+    private lastResetDate;
+    private sandboxFacilitator?;
+    constructor(config: X402ClientConfig);
+    /**
+     * Fetch a resource with automatic 402 payment handling
+     */
+    fetch(url: string, options?: RequestInit & {
+        maxPayment?: string;
+    }): Promise<Response>;
+    /**
+     * Get client status
+     */
+    getStatus(): X402ClientStatus;
+    /**
+     * Parse 402 response
+     */
+    private parse402Response;
+    /**
+     * Create payment based on environment
+     */
+    private createPayment;
+    /**
+     * Create sandbox payment (mock)
+     */
+    private createSandboxPayment;
+    /**
+     * Create blockchain payment (real EVM)
+     */
+    private createBlockchainPayment;
+    /**
+     * Get wallet address based on environment
+     */
+    private getWalletAddress;
+    /**
+     * Reset daily spend if date has changed
+     */
+    private resetDailySpendIfNeeded;
+}
+
+/**
+ * x402 Provider configuration
+ */
+interface X402ProviderConfig {
+    /**
+     * Sly API key
+     */
+    apiKey: string;
+    /**
+     * Environment (sandbox, testnet, production)
+     */
+    environment: SlyEnvironment;
+    /**
+     * Route configuration
+     * Maps route patterns to prices
+     */
+    routes: Record<string, {
+        price: string;
+        description?: string;
+        token?: string;
+    }>;
+    /**
+     * Custom facilitator URL (overrides environment default)
+     */
+    facilitatorUrl?: string;
+}
+/**
+ * x402 Provider for accepting payments
+ *
+ * Express middleware that returns 402 responses for protected routes
+ * and verifies payments before serving content.
+ */
+declare class SlyX402Provider {
+    private config;
+    private sandboxFacilitator?;
+    constructor(config: X402ProviderConfig);
+    /**
+     * Create Express middleware
+     */
+    middleware(): RequestHandler;
+    /**
+     * Get route configuration for request
+     */
+    private getRouteConfig;
+    /**
+     * Simple route pattern matching
+     */
+    private matchRoute;
+    /**
+     * Return 402 Payment Required response
+     */
+    private return402;
+    /**
+     * Verify payment
+     */
+    private verifyPayment;
+    /**
+     * Verify sandbox payment
+     */
+    private verifySandboxPayment;
+    /**
+     * Verify blockchain payment
+     */
+    private verifyBlockchainPayment;
+}
+
+export { SlyX402Client as PayOSX402Client, SlyX402Provider as PayOSX402Provider, SlyX402Client, SlyX402Provider, type X402ClientConfig, type X402ClientStatus, type X402PaymentInfo, type X402ProviderConfig, type X402Response, type X402SettlementInfo };

package/dist/x402.d.ts

@@ -0,0 +1,209 @@
+import { P as PayOSEnvironment, g as SlyEnvironment } from './types-df1EICn_.js';
+import { RequestHandler } from 'express';
+
+/**
+ * Types for x402 protocol support
+ */
+
+/**
+ * x402 Client configuration
+ */
+interface X402ClientConfig {
+    /**
+     * PayOS API key
+     */
+    apiKey: string;
+    /**
+     * Environment (sandbox, testnet, production)
+     */
+    environment: PayOSEnvironment;
+    /**
+     * EVM private key (required for testnet/production)
+     */
+    evmPrivateKey?: string;
+    /**
+     * Custom facilitator URL (overrides environment default)
+     */
+    facilitatorUrl?: string;
+    /**
+     * Maximum auto-pay amount per request (default: $1)
+     */
+    maxAutoPayAmount?: string;
+    /**
+     * Maximum daily spend limit (default: $100)
+     */
+    maxDailySpend?: string;
+    /**
+     * Callback fired before payment is sent
+     */
+    onPayment?: (payment: X402PaymentInfo) => void | Promise<void>;
+    /**
+     * Callback fired after settlement is confirmed
+     */
+    onSettlement?: (settlement: X402SettlementInfo) => void | Promise<void>;
+    /**
+     * Trigger LATAM rail settlement after x402 payment
+     */
+    settleToRail?: 'pix' | 'spei' | 'none';
+}
+/**
+ * x402 payment information
+ */
+interface X402PaymentInfo {
+    amount: string;
+    currency: string;
+    from: string;
+    to: string;
+    scheme: string;
+    network: string;
+    timestamp: string;
+}
+/**
+ * x402 settlement information
+ */
+interface X402SettlementInfo {
+    transactionHash: string;
+    amount: string;
+    currency: string;
+    timestamp: string;
+    railSettlementId?: string;
+}
+/**
+ * Client status
+ */
+interface X402ClientStatus {
+    environment: PayOSEnvironment;
+    dailySpent: string;
+    dailyLimit: string;
+    walletAddress?: string;
+}
+/**
+ * 402 response from server
+ */
+interface X402Response {
+    statusCode: 402;
+    accepts: Array<{
+        scheme: string;
+        network: string;
+        token: string;
+        amount: string;
+        facilitator: string;
+        [key: string]: unknown;
+    }>;
+}
+
+/**
+ * x402 Client for making payments
+ *
+ * Automatically handles 402 responses by creating payments and retrying.
+ * Supports sandbox mode (no blockchain) and production mode (real EVM).
+ */
+declare class SlyX402Client {
+    private config;
+    private dailySpent;
+    private lastResetDate;
+    private sandboxFacilitator?;
+    constructor(config: X402ClientConfig);
+    /**
+     * Fetch a resource with automatic 402 payment handling
+     */
+    fetch(url: string, options?: RequestInit & {
+        maxPayment?: string;
+    }): Promise<Response>;
+    /**
+     * Get client status
+     */
+    getStatus(): X402ClientStatus;
+    /**
+     * Parse 402 response
+     */
+    private parse402Response;
+    /**
+     * Create payment based on environment
+     */
+    private createPayment;
+    /**
+     * Create sandbox payment (mock)
+     */
+    private createSandboxPayment;
+    /**
+     * Create blockchain payment (real EVM)
+     */
+    private createBlockchainPayment;
+    /**
+     * Get wallet address based on environment
+     */
+    private getWalletAddress;
+    /**
+     * Reset daily spend if date has changed
+     */
+    private resetDailySpendIfNeeded;
+}
+
+/**
+ * x402 Provider configuration
+ */
+interface X402ProviderConfig {
+    /**
+     * Sly API key
+     */
+    apiKey: string;
+    /**
+     * Environment (sandbox, testnet, production)
+     */
+    environment: SlyEnvironment;
+    /**
+     * Route configuration
+     * Maps route patterns to prices
+     */
+    routes: Record<string, {
+        price: string;
+        description?: string;
+        token?: string;
+    }>;
+    /**
+     * Custom facilitator URL (overrides environment default)
+     */
+    facilitatorUrl?: string;
+}
+/**
+ * x402 Provider for accepting payments
+ *
+ * Express middleware that returns 402 responses for protected routes
+ * and verifies payments before serving content.
+ */
+declare class SlyX402Provider {
+    private config;
+    private sandboxFacilitator?;
+    constructor(config: X402ProviderConfig);
+    /**
+     * Create Express middleware
+     */
+    middleware(): RequestHandler;
+    /**
+     * Get route configuration for request
+     */
+    private getRouteConfig;
+    /**
+     * Simple route pattern matching
+     */
+    private matchRoute;
+    /**
+     * Return 402 Payment Required response
+     */
+    private return402;
+    /**
+     * Verify payment
+     */
+    private verifyPayment;
+    /**
+     * Verify sandbox payment
+     */
+    private verifySandboxPayment;
+    /**
+     * Verify blockchain payment
+     */
+    private verifyBlockchainPayment;
+}
+
+export { SlyX402Client as PayOSX402Client, SlyX402Provider as PayOSX402Provider, SlyX402Client, SlyX402Provider, type X402ClientConfig, type X402ClientStatus, type X402PaymentInfo, type X402ProviderConfig, type X402Response, type X402SettlementInfo };