@sardis/sdk 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Sardis TypeScript SDK
+ *
+ * Official SDK for the Sardis stablecoin execution layer.
+ * Enables AI agents to execute programmable payments using stablecoins.
+ *
+ * @packageDocumentation
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { SardisClient } from '@sardis/sdk';
+ *
+ * const client = new SardisClient({
+ *   apiKey: 'your-api-key',
+ * });
+ *
+ * // Execute a payment
+ * const result = await client.payments.executeMandate(mandate);
+ *
+ * // Create a hold
+ * const hold = await client.holds.create({
+ *   wallet_id: 'wallet_123',
+ *   amount: '100.00',
+ * });
+ * ```
+ *
+ * @example With request cancellation
+ * ```typescript
+ * const controller = new AbortController();
+ *
+ * // Cancel after 5 seconds
+ * setTimeout(() => controller.abort(), 5000);
+ *
+ * try {
+ *   const result = await client.payments.executeMandate(mandate, {
+ *     signal: controller.signal,
+ *   });
+ * } catch (error) {
+ *   if (error instanceof AbortError) {
+ *     console.log('Request was cancelled');
+ *   }
+ * }
+ * ```
+ *
+ * @example With interceptors
+ * ```typescript
+ * client.addRequestInterceptor({
+ *   onRequest: (config) => {
+ *     console.log(`Requesting ${config.method} ${config.url}`);
+ *     return config;
+ *   },
+ * });
+ * ```
+ *
+ * @example With pagination
+ * ```typescript
+ * for await (const agent of client.paginate(
+ *   (params) => client.agents.list(params),
+ *   { limit: 100 }
+ * )) {
+ *   console.log(agent.name);
+ * }
+ * ```
+ */
+export { SardisClient } from './client.js';
+export { SardisError, APIError, AuthenticationError, RateLimitError, TimeoutError, AbortError, NetworkError, ValidationError, InsufficientBalanceError, NotFoundError, PolicyViolationError, SpendingLimitError, BlockchainError, SardisErrorCode, isSardisError, isRetryableError, } from './errors.js';
+export type { SardisClientOptions, RequestOptions, RequestInterceptor, ResponseInterceptor, RetryConfig, TokenRefreshConfig, PaginationParams, PaginatedResponse, } from './types.js';
+export type { Chain, Token, MPCProvider, } from './types.js';
+export type { Wallet, WalletBalance, TokenLimit, CreateWalletInput, SetAddressInput, WalletTransferInput, WalletTransferResponse, } from './types.js';
+export type { ParsedPolicy, PolicyPreviewResponse, ApplyPolicyFromNLResponse, PolicyCheckResponse, } from './types.js';
+export type { Card, CardStatus, IssueCardInput, UpdateCardLimitsInput, SimulateCardPurchaseInput, SimulateCardPurchaseResponse, CardTransaction, } from './types.js';
+export type { Payment, PaymentStatus, ExecutePaymentInput, ExecuteAP2Input, ExecutePaymentResponse, ExecuteAP2Response, } from './types.js';
+export type { Hold, HoldStatus, CreateHoldInput, CaptureHoldInput, CreateHoldResponse, } from './types.js';
+export type { Webhook, WebhookDelivery, WebhookEventType, CreateWebhookInput, UpdateWebhookInput, } from './types.js';
+export type { Service, ServiceOffer, ServiceReview, ServiceCategory, ServiceStatus, OfferStatus, CreateServiceInput, CreateOfferInput, SearchServicesInput, } from './types.js';
+export type { GasEstimate, TransactionStatus, ChainInfo, } from './types.js';
+export type { LedgerEntry, } from './types.js';
+export type { Agent, CreateAgentInput, UpdateAgentInput, ListAgentsOptions, SpendingLimits, AgentPolicy, KeyAlgorithm, } from './types.js';
+export type { BulkOperation, BulkOperationResult, BulkOptions, } from './types.js';
+export type { ErrorDetails, } from './errors.js';
+export type { SardisErrorDetails, } from './types.js';
+export * as integrations from './integrations/index.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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAEL,WAAW,EAEX,QAAQ,EACR,mBAAmB,EACnB,cAAc,EAEd,YAAY,EACZ,UAAU,EACV,YAAY,EAEZ,eAAe,EAEf,wBAAwB,EACxB,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EAEf,eAAe,EAEf,aAAa,EACb,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,KAAK,EACL,KAAK,EACL,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,MAAM,EACN,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,YAAY,EACZ,qBAAqB,EACrB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,IAAI,EACJ,UAAU,EACV,cAAc,EACd,qBAAqB,EACrB,yBAAyB,EACzB,4BAA4B,EAC5B,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,OAAO,EACP,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,IAAI,EACJ,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,OAAO,EACP,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,OAAO,EACP,YAAY,EACZ,aAAa,EACb,eAAe,EACf,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,SAAS,GACV,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,KAAK,EACL,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,KAAK,YAAY,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,85 @@
+/**
+ * Sardis TypeScript SDK
+ *
+ * Official SDK for the Sardis stablecoin execution layer.
+ * Enables AI agents to execute programmable payments using stablecoins.
+ *
+ * @packageDocumentation
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { SardisClient } from '@sardis/sdk';
+ *
+ * const client = new SardisClient({
+ *   apiKey: 'your-api-key',
+ * });
+ *
+ * // Execute a payment
+ * const result = await client.payments.executeMandate(mandate);
+ *
+ * // Create a hold
+ * const hold = await client.holds.create({
+ *   wallet_id: 'wallet_123',
+ *   amount: '100.00',
+ * });
+ * ```
+ *
+ * @example With request cancellation
+ * ```typescript
+ * const controller = new AbortController();
+ *
+ * // Cancel after 5 seconds
+ * setTimeout(() => controller.abort(), 5000);
+ *
+ * try {
+ *   const result = await client.payments.executeMandate(mandate, {
+ *     signal: controller.signal,
+ *   });
+ * } catch (error) {
+ *   if (error instanceof AbortError) {
+ *     console.log('Request was cancelled');
+ *   }
+ * }
+ * ```
+ *
+ * @example With interceptors
+ * ```typescript
+ * client.addRequestInterceptor({
+ *   onRequest: (config) => {
+ *     console.log(`Requesting ${config.method} ${config.url}`);
+ *     return config;
+ *   },
+ * });
+ * ```
+ *
+ * @example With pagination
+ * ```typescript
+ * for await (const agent of client.paginate(
+ *   (params) => client.agents.list(params),
+ *   { limit: 100 }
+ * )) {
+ *   console.log(agent.name);
+ * }
+ * ```
+ */
+// Main client
+export { SardisClient } from './client.js';
+// Errors
+export { 
+// Error base class
+SardisError, 
+// API errors
+APIError, AuthenticationError, RateLimitError, 
+// Network errors
+TimeoutError, AbortError, NetworkError, 
+// Validation errors
+ValidationError, 
+// Business logic errors
+InsufficientBalanceError, NotFoundError, PolicyViolationError, SpendingLimitError, BlockchainError, 
+// Error codes
+SardisErrorCode, 
+// Type guards
+isSardisError, isRetryableError, } from './errors.js';
+// Integrations
+export * as integrations from './integrations/index.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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AAEH,cAAc;AACd,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,SAAS;AACT,OAAO;AACL,mBAAmB;AACnB,WAAW;AACX,aAAa;AACb,QAAQ,EACR,mBAAmB,EACnB,cAAc;AACd,iBAAiB;AACjB,YAAY,EACZ,UAAU,EACV,YAAY;AACZ,oBAAoB;AACpB,eAAe;AACf,wBAAwB;AACxB,wBAAwB,EACxB,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,eAAe;AACf,cAAc;AACd,eAAe;AACf,cAAc;AACd,aAAa,EACb,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAmIrB,eAAe;AACf,OAAO,KAAK,YAAY,MAAM,yBAAyB,CAAC"}

package/dist/integrations/index.d.ts

@@ -0,0 +1,4 @@
+export * from './vercel-ai.js';
+export * from './langchain.js';
+export * from './openai.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/integrations/index.js

@@ -0,0 +1,5 @@
+// AI Framework Integrations for Sardis SDK
+export * from './vercel-ai.js';
+export * from './langchain.js';
+export * from './openai.js';
+//# sourceMappingURL=index.js.map

package/dist/integrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/integrations/langchain.d.ts

@@ -0,0 +1,68 @@
+/**
+ * LangChain.js Integration for Sardis SDK
+ *
+ * Provides LangChain-compatible tools for AI agents to execute payments
+ * through Sardis MPC wallets with policy enforcement.
+ *
+ * @example
+ * ```typescript
+ * import { ChatOpenAI } from '@langchain/openai';
+ * import { AgentExecutor, createOpenAIFunctionsAgent } from 'langchain/agents';
+ * import { SardisClient } from '@sardis/sdk';
+ * import { createSardisLangChainTools } from '@sardis/sdk/integrations/langchain';
+ *
+ * const client = new SardisClient({ apiKey: 'your-api-key' });
+ * const tools = createSardisLangChainTools(client, { walletId: 'wallet_123' });
+ *
+ * const agent = await createOpenAIFunctionsAgent({
+ *   llm: new ChatOpenAI(),
+ *   tools,
+ *   prompt: yourPrompt
+ * });
+ *
+ * const executor = new AgentExecutor({ agent, tools });
+ * const result = await executor.invoke({ input: 'Pay $50 to OpenAI' });
+ * ```
+ */
+import { SardisClient } from '../client.js';
+/**
+ * Options for creating Sardis LangChain tools
+ */
+export interface SardisLangChainOptions {
+    /** Default wallet ID to use for payments */
+    walletId?: string;
+    /** Default agent ID */
+    agentId?: string;
+    /** Default chain for transactions */
+    chain?: 'base' | 'base_sepolia' | 'polygon' | 'polygon_amoy' | 'ethereum' | 'ethereum_sepolia';
+    /** Default token */
+    token?: 'USDC' | 'USDT' | 'PYUSD' | 'EURC';
+}
+/**
+ * LangChain tool interface
+ */
+interface LangChainTool {
+    name: string;
+    description: string;
+    schema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+    func: (input: Record<string, unknown>) => Promise<string>;
+}
+/**
+ * Create LangChain-compatible tools for Sardis payments.
+ *
+ * @param client - Initialized SardisClient instance
+ * @param options - Configuration options
+ * @returns Array of LangChain-compatible tools
+ */
+export declare function createSardisLangChainTools(client: SardisClient, options?: SardisLangChainOptions): LangChainTool[];
+/**
+ * Create a single LangChain tool for payments only.
+ * Use this if you only need the payment functionality.
+ */
+export declare function createSardisPaymentTool(client: SardisClient, options?: SardisLangChainOptions): LangChainTool;
+export type { LangChainTool };
+//# sourceMappingURL=langchain.d.ts.map

package/dist/integrations/langchain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.d.ts","sourceRoot":"","sources":["../../src/integrations/langchain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,GAAG,cAAc,GAAG,UAAU,GAAG,kBAAkB,CAAC;IAC/F,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;CAC9C;AAED;;GAEG;AACH,UAAU,aAAa;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QACJ,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;IACF,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7D;AAyBD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACtC,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,sBAA2B,GACrC,aAAa,EAAE,CAsSjB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACnC,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,sBAA2B,GACrC,aAAa,CAGf;AAED,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/dist/integrations/langchain.js

@@ -0,0 +1,335 @@
+/**
+ * LangChain.js Integration for Sardis SDK
+ *
+ * Provides LangChain-compatible tools for AI agents to execute payments
+ * through Sardis MPC wallets with policy enforcement.
+ *
+ * @example
+ * ```typescript
+ * import { ChatOpenAI } from '@langchain/openai';
+ * import { AgentExecutor, createOpenAIFunctionsAgent } from 'langchain/agents';
+ * import { SardisClient } from '@sardis/sdk';
+ * import { createSardisLangChainTools } from '@sardis/sdk/integrations/langchain';
+ *
+ * const client = new SardisClient({ apiKey: 'your-api-key' });
+ * const tools = createSardisLangChainTools(client, { walletId: 'wallet_123' });
+ *
+ * const agent = await createOpenAIFunctionsAgent({
+ *   llm: new ChatOpenAI(),
+ *   tools,
+ *   prompt: yourPrompt
+ * });
+ *
+ * const executor = new AgentExecutor({ agent, tools });
+ * const result = await executor.invoke({ input: 'Pay $50 to OpenAI' });
+ * ```
+ */
+/**
+ * Generate a unique mandate ID
+ */
+function generateMandateId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 10);
+    return `mnd_${timestamp}${random}`;
+}
+/**
+ * Create a SHA-256 hash for audit purposes
+ */
+async function createAuditHash(data) {
+    if (typeof crypto !== 'undefined' && crypto.subtle) {
+        const encoder = new TextEncoder();
+        const dataBuffer = encoder.encode(data);
+        const hashBuffer = await crypto.subtle.digest('SHA-256', dataBuffer);
+        const hashArray = Array.from(new Uint8Array(hashBuffer));
+        return hashArray.map(b => b.toString(16).padStart(2, '0')).join('');
+    }
+    return `hash_${Date.now().toString(16)}`;
+}
+/**
+ * Create LangChain-compatible tools for Sardis payments.
+ *
+ * @param client - Initialized SardisClient instance
+ * @param options - Configuration options
+ * @returns Array of LangChain-compatible tools
+ */
+export function createSardisLangChainTools(client, options = {}) {
+    const defaultWalletId = options.walletId || process.env.SARDIS_WALLET_ID || '';
+    const defaultAgentId = options.agentId || process.env.SARDIS_AGENT_ID || '';
+    const defaultChain = options.chain || 'base_sepolia';
+    const defaultToken = options.token || 'USDC';
+    const tools = [
+        {
+            name: 'sardis_pay',
+            description: 'Execute a secure payment using Sardis MPC wallet. Validates against spending policies. Use this when the user wants to pay a vendor or service.',
+            schema: {
+                type: 'object',
+                properties: {
+                    amount: {
+                        type: 'number',
+                        description: 'The amount to pay in USD (or token units)'
+                    },
+                    vendor: {
+                        type: 'string',
+                        description: 'The name of the merchant or service provider'
+                    },
+                    vendor_address: {
+                        type: 'string',
+                        description: 'The wallet address of the vendor (0x...). Optional - will resolve if not provided.'
+                    },
+                    purpose: {
+                        type: 'string',
+                        description: 'The reason for the payment, used for policy validation'
+                    },
+                    token: {
+                        type: 'string',
+                        enum: ['USDC', 'USDT', 'PYUSD', 'EURC'],
+                        description: 'The stablecoin to use. Defaults to USDC.'
+                    }
+                },
+                required: ['amount', 'vendor']
+            },
+            func: async (input) => {
+                const amount = input.amount;
+                const vendor = input.vendor;
+                const vendorAddress = input.vendor_address;
+                const purpose = input.purpose;
+                const token = input.token || defaultToken;
+                if (!defaultWalletId) {
+                    return JSON.stringify({
+                        success: false,
+                        error: 'No wallet ID configured. Set walletId in options or SARDIS_WALLET_ID env var.'
+                    });
+                }
+                try {
+                    const mandateId = generateMandateId();
+                    const timestamp = new Date().toISOString();
+                    const amountMinor = Math.round(amount * 1_000_000).toString();
+                    const auditData = JSON.stringify({
+                        mandate_id: mandateId,
+                        subject: defaultWalletId,
+                        destination: vendorAddress || `pending:${vendor}`,
+                        amount_minor: amountMinor,
+                        token,
+                        purpose: purpose || `Payment to ${vendor}`,
+                        timestamp
+                    });
+                    const auditHash = await createAuditHash(auditData);
+                    const mandate = {
+                        mandate_id: mandateId,
+                        subject: defaultWalletId,
+                        destination: vendorAddress || `pending:${vendor}`,
+                        amount_minor: amountMinor,
+                        token,
+                        chain: defaultChain,
+                        purpose: purpose || `Payment to ${vendor}`,
+                        vendor_name: vendor,
+                        agent_id: defaultAgentId,
+                        timestamp,
+                        audit_hash: auditHash,
+                        metadata: {
+                            vendor,
+                            category: 'saas',
+                            initiated_by: 'ai_agent',
+                            tool: 'langchain_js'
+                        }
+                    };
+                    const result = await client.payments.executeMandate(mandate);
+                    return JSON.stringify({
+                        success: true,
+                        status: result.status,
+                        payment_id: result.payment_id,
+                        transaction_hash: result.tx_hash,
+                        chain: result.chain,
+                        ledger_tx_id: result.ledger_tx_id,
+                        message: `Payment of $${amount} ${token} to ${vendor} ${result.status === 'completed' ? 'completed' : 'initiated'}.`
+                    });
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : 'Payment failed';
+                    if (errorMessage.includes('policy') || errorMessage.includes('blocked') || errorMessage.includes('limit')) {
+                        return JSON.stringify({
+                            success: false,
+                            blocked: true,
+                            error: errorMessage,
+                            message: `Payment to ${vendor} blocked by policy: ${errorMessage}`
+                        });
+                    }
+                    return JSON.stringify({
+                        success: false,
+                        error: errorMessage
+                    });
+                }
+            }
+        },
+        {
+            name: 'sardis_check_balance',
+            description: 'Check the current balance of a Sardis wallet. Use this before making payments to ensure sufficient funds.',
+            schema: {
+                type: 'object',
+                properties: {
+                    token: {
+                        type: 'string',
+                        enum: ['USDC', 'USDT', 'PYUSD', 'EURC'],
+                        description: 'The token to check balance for. Defaults to USDC.'
+                    },
+                    chain: {
+                        type: 'string',
+                        description: 'The blockchain to check balance on. Defaults to base_sepolia.'
+                    }
+                }
+            },
+            func: async (input) => {
+                const token = input.token || defaultToken;
+                const chain = input.chain || defaultChain;
+                if (!defaultWalletId) {
+                    return JSON.stringify({
+                        success: false,
+                        error: 'No wallet ID configured'
+                    });
+                }
+                try {
+                    const balance = await client.wallets.getBalance(defaultWalletId, chain, token);
+                    return JSON.stringify({
+                        success: true,
+                        wallet_id: balance.wallet_id,
+                        balance: balance.balance,
+                        token: balance.token,
+                        chain: balance.chain,
+                        address: balance.address
+                    });
+                }
+                catch (error) {
+                    return JSON.stringify({
+                        success: false,
+                        error: error instanceof Error ? error.message : 'Failed to get balance'
+                    });
+                }
+            }
+        },
+        {
+            name: 'sardis_get_wallet',
+            description: 'Get information about the Sardis wallet including spending limits and policy settings.',
+            schema: {
+                type: 'object',
+                properties: {}
+            },
+            func: async () => {
+                if (!defaultWalletId) {
+                    return JSON.stringify({
+                        success: false,
+                        error: 'No wallet ID configured'
+                    });
+                }
+                try {
+                    const wallet = await client.wallets.get(defaultWalletId);
+                    return JSON.stringify({
+                        success: true,
+                        wallet: {
+                            id: wallet.id,
+                            agent_id: wallet.agent_id,
+                            currency: wallet.currency,
+                            limit_per_tx: wallet.limit_per_tx,
+                            limit_total: wallet.limit_total,
+                            is_active: wallet.is_active,
+                            addresses: wallet.addresses
+                        }
+                    });
+                }
+                catch (error) {
+                    return JSON.stringify({
+                        success: false,
+                        error: error instanceof Error ? error.message : 'Failed to get wallet'
+                    });
+                }
+            }
+        },
+        {
+            name: 'sardis_check_policy',
+            description: 'Check if a payment would be allowed by the spending policy without executing it. Use this to validate payments before execution.',
+            schema: {
+                type: 'object',
+                properties: {
+                    amount: {
+                        type: 'number',
+                        description: 'The amount to pay in USD'
+                    },
+                    vendor: {
+                        type: 'string',
+                        description: 'The name of the merchant or service provider'
+                    },
+                    purpose: {
+                        type: 'string',
+                        description: 'The reason for the payment'
+                    }
+                },
+                required: ['amount', 'vendor']
+            },
+            func: async (input) => {
+                const amount = input.amount;
+                const vendor = input.vendor;
+                const purpose = input.purpose;
+                if (!defaultWalletId) {
+                    return JSON.stringify({
+                        success: false,
+                        error: 'No wallet ID configured'
+                    });
+                }
+                try {
+                    // Get wallet to check limits
+                    const wallet = await client.wallets.get(defaultWalletId);
+                    const limitPerTx = parseFloat(wallet.limit_per_tx);
+                    const limitTotal = parseFloat(wallet.limit_total);
+                    // Basic policy checks
+                    const checks = [];
+                    // Per-transaction limit check
+                    if (amount <= limitPerTx) {
+                        checks.push({ name: 'per_transaction_limit', passed: true });
+                    }
+                    else {
+                        checks.push({
+                            name: 'per_transaction_limit',
+                            passed: false,
+                            reason: `Amount $${amount} exceeds per-transaction limit of $${limitPerTx}`
+                        });
+                    }
+                    // Wallet active check
+                    if (wallet.is_active) {
+                        checks.push({ name: 'wallet_active', passed: true });
+                    }
+                    else {
+                        checks.push({
+                            name: 'wallet_active',
+                            passed: false,
+                            reason: 'Wallet is not active'
+                        });
+                    }
+                    const allPassed = checks.every(c => c.passed);
+                    return JSON.stringify({
+                        success: true,
+                        allowed: allPassed,
+                        checks,
+                        summary: allPassed
+                            ? `Payment of $${amount} to ${vendor} would be allowed`
+                            : `Payment of $${amount} to ${vendor} would be blocked: ${checks.filter(c => !c.passed).map(c => c.reason).join('; ')}`
+                    });
+                }
+                catch (error) {
+                    return JSON.stringify({
+                        success: false,
+                        error: error instanceof Error ? error.message : 'Failed to check policy'
+                    });
+                }
+            }
+        }
+    ];
+    return tools;
+}
+/**
+ * Create a single LangChain tool for payments only.
+ * Use this if you only need the payment functionality.
+ */
+export function createSardisPaymentTool(client, options = {}) {
+    const tools = createSardisLangChainTools(client, options);
+    return tools.find(t => t.name === 'sardis_pay');
+}
+//# sourceMappingURL=langchain.js.map

package/dist/integrations/langchain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.js","sourceRoot":"","sources":["../../src/integrations/langchain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAiCH;;GAEG;AACH,SAAS,iBAAiB;IACtB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3D,OAAO,OAAO,SAAS,GAAG,MAAM,EAAE,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,eAAe,CAAC,IAAY;IACvC,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QACjD,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACrE,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;QACzD,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CACtC,MAAoB,EACpB,UAAkC,EAAE;IAEpC,MAAM,eAAe,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC;IAC/E,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC;IAC5E,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,IAAI,cAAc,CAAC;IACrD,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC;IAE7C,MAAM,KAAK,GAAoB;QAC3B;YACI,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,iJAAiJ;YAC9J,MAAM,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,MAAM,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,2CAA2C;qBAC3D;oBACD,MAAM,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,8CAA8C;qBAC9D;oBACD,cAAc,EAAE;wBACZ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,oFAAoF;qBACpG;oBACD,OAAO,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,wDAAwD;qBACxE;oBACD,KAAK,EAAE;wBACH,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;wBACvC,WAAW,EAAE,0CAA0C;qBAC1D;iBACJ;gBACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;aACjC;YACD,IAAI,EAAE,KAAK,EAAE,KAA8B,EAAmB,EAAE;gBAC5D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAgB,CAAC;gBACtC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAgB,CAAC;gBACtC,MAAM,aAAa,GAAG,KAAK,CAAC,cAAoC,CAAC;gBACjE,MAAM,OAAO,GAAG,KAAK,CAAC,OAA6B,CAAC;gBACpD,MAAM,KAAK,GAAI,KAAK,CAAC,KAA4C,IAAI,YAAY,CAAC;gBAElF,IAAI,CAAC,eAAe,EAAE,CAAC;oBACnB,OAAO,IAAI,CAAC,SAAS,CAAC;wBAClB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,+EAA+E;qBACzF,CAAC,CAAC;gBACP,CAAC;gBAED,IAAI,CAAC;oBACD,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;oBACtC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;oBAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAC;oBAE9D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;wBAC7B,UAAU,EAAE,SAAS;wBACrB,OAAO,EAAE,eAAe;wBACxB,WAAW,EAAE,aAAa,IAAI,WAAW,MAAM,EAAE;wBACjD,YAAY,EAAE,WAAW;wBACzB,KAAK;wBACL,OAAO,EAAE,OAAO,IAAI,cAAc,MAAM,EAAE;wBAC1C,SAAS;qBACZ,CAAC,CAAC;oBACH,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;oBAEnD,MAAM,OAAO,GAAG;wBACZ,UAAU,EAAE,SAAS;wBACrB,OAAO,EAAE,eAAe;wBACxB,WAAW,EAAE,aAAa,IAAI,WAAW,MAAM,EAAE;wBACjD,YAAY,EAAE,WAAW;wBACzB,KAAK;wBACL,KAAK,EAAE,YAAY;wBACnB,OAAO,EAAE,OAAO,IAAI,cAAc,MAAM,EAAE;wBAC1C,WAAW,EAAE,MAAM;wBACnB,QAAQ,EAAE,cAAc;wBACxB,SAAS;wBACT,UAAU,EAAE,SAAS;wBACrB,QAAQ,EAAE;4BACN,MAAM;4BACN,QAAQ,EAAE,MAAM;4BAChB,YAAY,EAAE,UAAU;4BACxB,IAAI,EAAE,cAAc;yBACvB;qBACJ,CAAC;oBAEF,MAAM,MAAM,GAA2B,MAAM,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;oBAErF,OAAO,IAAI,CAAC,SAAS,CAAC;wBAClB,OAAO,EAAE,IAAI;wBACb,MAAM,EAAE,MAAM,CAAC,MAAM;wBACrB,UAAU,EAAE,MAAM,CAAC,UAAU;wBAC7B,gBAAgB,EAAE,MAAM,CAAC,OAAO;wBAChC,KAAK,EAAE,MAAM,CAAC,KAAK;wBACnB,YAAY,EAAE,MAAM,CAAC,YAAY;wBACjC,OAAO,EAAE,eAAe,MAAM,IAAI,KAAK,OAAO,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,GAAG;qBACvH,CAAC,CAAC;gBACP,CAAC;gBAAC,OAAO,KAAc,EAAE,CAAC;oBACtB,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC;oBAE/E,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;wBACxG,OAAO,IAAI,CAAC,SAAS,CAAC;4BAClB,OAAO,EAAE,KAAK;4BACd,OAAO,EAAE,IAAI;4BACb,KAAK,EAAE,YAAY;4BACnB,OAAO,EAAE,cAAc,MAAM,uBAAuB,YAAY,EAAE;yBACrE,CAAC,CAAC;oBACP,CAAC;oBAED,OAAO,IAAI,CAAC,SAAS,CAAC;wBAClB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,YAAY;qBACtB,CAAC,CAAC;gBACP,CAAC;YACL,CAAC;SACJ;QAED;YACI,IAAI,EAAE,sBAAsB;YAC5B,WAAW,EAAE,2GAA2G;YACxH,MAAM,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,KAAK,EAAE;wBACH,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;wBACvC,WAAW,EAAE,mDAAmD;qBACnE;oBACD,KAAK,EAAE;wBACH,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,+DAA+D;qBAC/E;iBACJ;aACJ;YACD,IAAI,EAAE,KAAK,EAAE,KAA8B,EAAmB,EAAE;gBAC5D,MAAM,KAAK,GAAI,KAAK,CAAC,KAA4C,IAAI,YAAY,CAAC;gBAClF,MAAM,KAAK,GAAI,KAAK,CAAC,KAAgB,IAAI,YAAY,CAAC;gBAEtD,IAAI,CAAC,eAAe,EAAE,CAAC;oBACnB,OAAO,IAAI,CAAC,SAAS,CAAC;wBAClB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,yBAAyB;qBACnC,CAAC,CAAC;gBACP,CAAC;gBAED,IAAI,CAAC;oBACD,MAAM,OAAO,GAAkB,MAAM,MAAM,CAAC,OAAO,CAAC,UAAU,CAC1D,eAAe,EACf,KAAK,EACL,KAAK,CACR,CAAC;oBAEF,OAAO,IAAI,CAAC,SAAS,CAAC;wBAClB,OAAO,EAAE,IAAI;wBACb,SAAS,EAAE,OAAO,CAAC,SAAS;wBAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;wBACxB,KAAK,EAAE,OAAO,CAAC,KAAK;wBACpB,KAAK,EAAE,OAAO,CAAC,KAAK;wBACpB,OAAO,EAAE,OAAO,CAAC,OAAO;qBAC3B,CAAC,CAAC;gBACP,CAAC;gBAAC,OAAO,KAAc,EAAE,CAAC;oBACtB,OAAO,IAAI,CAAC,SAAS,CAAC;wBAClB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB;qBAC1E,CAAC,CAAC;gBACP,CAAC;YACL,CAAC;SACJ;QAED;YACI,IAAI,EAAE,mBAAmB;YACzB,WAAW,EAAE,wFAAwF;YACrG,MAAM,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,EAAE;aACjB;YACD,IAAI,EAAE,KAAK,IAAqB,EAAE;gBAC9B,IAAI,CAAC,eAAe,EAAE,CAAC;oBACnB,OAAO,IAAI,CAAC,SAAS,CAAC;wBAClB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,yBAAyB;qBACnC,CAAC,CAAC;gBACP,CAAC;gBAED,IAAI,CAAC;oBACD,MAAM,MAAM,GAAW,MAAM,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;oBAEjE,OAAO,IAAI,CAAC,SAAS,CAAC;wBAClB,OAAO,EAAE,IAAI;wBACb,MAAM,EAAE;4BACJ,EAAE,EAAE,MAAM,CAAC,EAAE;4BACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;4BACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;4BACzB,YAAY,EAAE,MAAM,CAAC,YAAY;4BACjC,WAAW,EAAE,MAAM,CAAC,WAAW;4BAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;4BAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;yBAC9B;qBACJ,CAAC,CAAC;gBACP,CAAC;gBAAC,OAAO,KAAc,EAAE,CAAC;oBACtB,OAAO,IAAI,CAAC,SAAS,CAAC;wBAClB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB;qBACzE,CAAC,CAAC;gBACP,CAAC;YACL,CAAC;SACJ;QAED;YACI,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EAAE,kIAAkI;YAC/I,MAAM,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,MAAM,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,0BAA0B;qBAC1C;oBACD,MAAM,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,8CAA8C;qBAC9D;oBACD,OAAO,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,4BAA4B;qBAC5C;iBACJ;gBACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;aACjC;YACD,IAAI,EAAE,KAAK,EAAE,KAA8B,EAAmB,EAAE;gBAC5D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAgB,CAAC;gBACtC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAgB,CAAC;gBACtC,MAAM,OAAO,GAAG,KAAK,CAAC,OAA6B,CAAC;gBAEpD,IAAI,CAAC,eAAe,EAAE,CAAC;oBACnB,OAAO,IAAI,CAAC,SAAS,CAAC;wBAClB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,yBAAyB;qBACnC,CAAC,CAAC;gBACP,CAAC;gBAED,IAAI,CAAC;oBACD,6BAA6B;oBAC7B,MAAM,MAAM,GAAW,MAAM,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;oBACjE,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;oBACnD,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;oBAElD,sBAAsB;oBACtB,MAAM,MAAM,GAAyD,EAAE,CAAC;oBAExE,8BAA8B;oBAC9B,IAAI,MAAM,IAAI,UAAU,EAAE,CAAC;wBACvB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;oBACjE,CAAC;yBAAM,CAAC;wBACJ,MAAM,CAAC,IAAI,CAAC;4BACR,IAAI,EAAE,uBAAuB;4BAC7B,MAAM,EAAE,KAAK;4BACb,MAAM,EAAE,WAAW,MAAM,sCAAsC,UAAU,EAAE;yBAC9E,CAAC,CAAC;oBACP,CAAC;oBAED,sBAAsB;oBACtB,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;wBACnB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;oBACzD,CAAC;yBAAM,CAAC;wBACJ,MAAM,CAAC,IAAI,CAAC;4BACR,IAAI,EAAE,eAAe;4BACrB,MAAM,EAAE,KAAK;4BACb,MAAM,EAAE,sBAAsB;yBACjC,CAAC,CAAC;oBACP,CAAC;oBAED,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;oBAE9C,OAAO,IAAI,CAAC,SAAS,CAAC;wBAClB,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE,SAAS;wBAClB,MAAM;wBACN,OAAO,EAAE,SAAS;4BACd,CAAC,CAAC,eAAe,MAAM,OAAO,MAAM,mBAAmB;4BACvD,CAAC,CAAC,eAAe,MAAM,OAAO,MAAM,sBAAsB,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;qBAC9H,CAAC,CAAC;gBACP,CAAC;gBAAC,OAAO,KAAc,EAAE,CAAC;oBACtB,OAAO,IAAI,CAAC,SAAS,CAAC;wBAClB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB;qBAC3E,CAAC,CAAC;gBACP,CAAC;YACL,CAAC;SACJ;KACJ,CAAC;IAEF,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACnC,MAAoB,EACpB,UAAkC,EAAE;IAEpC,MAAM,KAAK,GAAG,0BAA0B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1D,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAE,CAAC;AACrD,CAAC"}