@sardis/sdk 0.2.0

package/dist/integrations/vercel-ai.d.ts

@@ -0,0 +1,180 @@
+import { z } from 'zod';
+import { SardisClient } from '../client.js';
+export interface SardisToolsOptions {
+    /** 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';
+}
+/**
+ * Create Sardis tools for Vercel AI SDK integration.
+ *
+ * @example
+ * ```typescript
+ * import { generateText } from 'ai';
+ * import { SardisClient } from '@sardis/sdk';
+ * import { createSardisTools } from '@sardis/sdk/integrations/vercel-ai';
+ *
+ * const client = new SardisClient({ apiKey: 'your-api-key' });
+ * const tools = createSardisTools(client, {
+ *   walletId: 'wallet_123',
+ *   agentId: 'agent_456'
+ * });
+ *
+ * const result = await generateText({
+ *   model: yourModel,
+ *   tools,
+ *   prompt: 'Pay $50 to OpenAI for API credits'
+ * });
+ * ```
+ */
+export declare const createSardisTools: (client?: SardisClient, options?: SardisToolsOptions) => {
+    /**
+     * Execute a secure payment using Sardis MPC wallet.
+     */
+    payVendor: {
+        description: string;
+        parameters: z.ZodObject<{
+            amount: z.ZodNumber;
+            vendor: z.ZodString;
+            vendorAddress: z.ZodOptional<z.ZodString>;
+            purpose: z.ZodOptional<z.ZodString>;
+            walletId: z.ZodOptional<z.ZodString>;
+            token: z.ZodOptional<z.ZodEnum<["USDC", "USDT", "PYUSD", "EURC"]>>;
+            chain: z.ZodOptional<z.ZodString>;
+            domain: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            amount: number;
+            vendor: string;
+            chain?: string | undefined;
+            token?: "USDC" | "USDT" | "PYUSD" | "EURC" | undefined;
+            vendorAddress?: string | undefined;
+            purpose?: string | undefined;
+            walletId?: string | undefined;
+            domain?: string | undefined;
+        }, {
+            amount: number;
+            vendor: string;
+            chain?: string | undefined;
+            token?: "USDC" | "USDT" | "PYUSD" | "EURC" | undefined;
+            vendorAddress?: string | undefined;
+            purpose?: string | undefined;
+            walletId?: string | undefined;
+            domain?: string | undefined;
+        }>;
+        execute: ({ amount, vendor, vendorAddress, purpose, walletId, token, chain, domain, }: {
+            amount: number;
+            vendor: string;
+            vendorAddress?: string;
+            purpose?: string;
+            walletId?: string;
+            token?: "USDC" | "USDT" | "PYUSD" | "EURC";
+            chain?: string;
+            domain?: string;
+        }) => Promise<{
+            success: boolean;
+            error: string;
+            status?: undefined;
+            transactionHash?: undefined;
+            chain?: undefined;
+            auditAnchor?: undefined;
+            message?: undefined;
+            blocked?: undefined;
+        } | {
+            success: boolean;
+            status: string;
+            transactionHash: string;
+            chain: import("../types.js").Chain;
+            auditAnchor: string | null | undefined;
+            message: string;
+            error?: undefined;
+            blocked?: undefined;
+        } | {
+            success: boolean;
+            blocked: boolean;
+            error: string;
+            message: string;
+            status?: undefined;
+            transactionHash?: undefined;
+            chain?: undefined;
+            auditAnchor?: undefined;
+        }>;
+    };
+    /**
+     * Check wallet balance before making a payment.
+     */
+    checkBalance: {
+        description: string;
+        parameters: z.ZodObject<{
+            walletId: z.ZodOptional<z.ZodString>;
+            token: z.ZodOptional<z.ZodEnum<["USDC", "USDT", "PYUSD", "EURC"]>>;
+            chain: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            chain?: string | undefined;
+            token?: "USDC" | "USDT" | "PYUSD" | "EURC" | undefined;
+            walletId?: string | undefined;
+        }, {
+            chain?: string | undefined;
+            token?: "USDC" | "USDT" | "PYUSD" | "EURC" | undefined;
+            walletId?: string | undefined;
+        }>;
+        execute: ({ walletId, token, chain }: {
+            walletId?: string;
+            token?: "USDC" | "USDT" | "PYUSD" | "EURC";
+            chain?: string;
+        }) => Promise<{
+            success: boolean;
+            error: string;
+            walletId?: undefined;
+            balance?: undefined;
+            token?: undefined;
+            chain?: undefined;
+            address?: undefined;
+        } | {
+            success: boolean;
+            walletId: string;
+            balance: string;
+            token: import("../types.js").Token;
+            chain: string;
+            address: string;
+            error?: undefined;
+        }>;
+    };
+    /**
+     * Get wallet information.
+     */
+    getWallet: {
+        description: string;
+        parameters: z.ZodObject<{
+            walletId: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            walletId?: string | undefined;
+        }, {
+            walletId?: string | undefined;
+        }>;
+        execute: ({ walletId }: {
+            walletId?: string;
+        }) => Promise<{
+            success: boolean;
+            error: string;
+            wallet?: undefined;
+        } | {
+            success: boolean;
+            wallet: {
+                id: string;
+                agentId: string;
+                currency: import("../types.js").Token;
+                limitPerTx: string;
+                limitTotal: string;
+                isActive: boolean;
+                addresses: Record<string, string>;
+            };
+            error?: undefined;
+        }>;
+    };
+};
+//# sourceMappingURL=vercel-ai.d.ts.map

package/dist/integrations/vercel-ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-ai.d.ts","sourceRoot":"","sources":["../../src/integrations/vercel-ai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,kBAAkB;IAC/B,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;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,YAAY,EAAE,UAAS,kBAAuB;IAOjF;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+FAsBI;YACC,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,MAAM,CAAC;YACf,aAAa,CAAC,EAAE,MAAM,CAAC;YACvB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;YAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,MAAM,CAAC,EAAE,MAAM,CAAC;SACnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkEL;;OAEG;;;;;;;;;;;;;;;;8CAYI;YACC,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;YAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;SAClB;;;;;;;;;;;;;;;;;;IAwCL;;OAEG;;;;;;;;;;gCAM+B;YAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;CAwC9D,CAAC"}

package/dist/integrations/vercel-ai.js

@@ -0,0 +1,194 @@
+import { z } from 'zod';
+/**
+ * Create Sardis tools for Vercel AI SDK integration.
+ *
+ * @example
+ * ```typescript
+ * import { generateText } from 'ai';
+ * import { SardisClient } from '@sardis/sdk';
+ * import { createSardisTools } from '@sardis/sdk/integrations/vercel-ai';
+ *
+ * const client = new SardisClient({ apiKey: 'your-api-key' });
+ * const tools = createSardisTools(client, {
+ *   walletId: 'wallet_123',
+ *   agentId: 'agent_456'
+ * });
+ *
+ * const result = await generateText({
+ *   model: yourModel,
+ *   tools,
+ *   prompt: 'Pay $50 to OpenAI for API credits'
+ * });
+ * ```
+ */
+export const createSardisTools = (client, options = {}) => {
+    const sardis = client;
+    const defaultWalletId = options.walletId || process.env.SARDIS_WALLET_ID || '';
+    const defaultChain = options.chain || 'base_sepolia';
+    const defaultToken = options.token || 'USDC';
+    return {
+        /**
+         * Execute a secure payment using Sardis MPC wallet.
+         */
+        payVendor: {
+            description: 'Execute a secure payment using Sardis MPC wallet. Validates against spending policies before execution.',
+            parameters: z.object({
+                amount: z.number().describe('The amount to pay in USD (or token units).'),
+                vendor: z.string().describe('The name of the merchant or service provider.'),
+                vendorAddress: z.string().optional().describe('The wallet address of the vendor (0x...).'),
+                purpose: z.string().optional().describe('The reason for the payment, used for policy validation.'),
+                walletId: z.string().optional().describe('The wallet ID to pay from. Defaults to configured wallet.'),
+                token: z.enum(['USDC', 'USDT', 'PYUSD', 'EURC']).optional().describe('The stablecoin to use. Defaults to USDC.'),
+                chain: z.string().optional().describe('The chain to use (e.g. base_sepolia). Defaults to configured chain.'),
+                domain: z.string().optional().describe('Policy context label (e.g. aws.amazon.com). Defaults to vendor.'),
+            }),
+            execute: async ({ amount, vendor, vendorAddress, purpose, walletId, token, chain, domain, }) => {
+                if (!sardis) {
+                    return {
+                        success: false,
+                        error: "SardisClient not initialized. Please provide a client instance."
+                    };
+                }
+                const effectiveWalletId = walletId || defaultWalletId;
+                if (!effectiveWalletId) {
+                    return {
+                        success: false,
+                        error: "No wallet ID provided. Set walletId in options or SARDIS_WALLET_ID env var."
+                    };
+                }
+                try {
+                    const effectiveToken = token || defaultToken;
+                    const effectiveChain = chain || defaultChain;
+                    const effectiveDomain = domain || vendor;
+                    if (!vendorAddress) {
+                        return {
+                            success: false,
+                            error: "Missing vendorAddress (destination). Provide a wallet address (0x...) for the vendor."
+                        };
+                    }
+                    const result = await sardis.wallets.transfer(effectiveWalletId, {
+                        destination: vendorAddress,
+                        amount: amount.toString(),
+                        token: effectiveToken,
+                        chain: effectiveChain,
+                        domain: effectiveDomain,
+                        memo: purpose,
+                    });
+                    return {
+                        success: true,
+                        status: result.status,
+                        transactionHash: result.tx_hash,
+                        chain: result.chain,
+                        auditAnchor: result.audit_anchor,
+                        message: `Payment of $${amount} ${effectiveToken} to ${vendor} ${result.status === 'completed' ? 'completed' : 'initiated'} successfully.`
+                    };
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : 'Payment failed';
+                    // Check if this is a policy violation
+                    if (errorMessage.includes('policy') || errorMessage.includes('blocked') || errorMessage.includes('limit')) {
+                        return {
+                            success: false,
+                            blocked: true,
+                            error: errorMessage,
+                            message: `Payment to ${vendor} was blocked by spending policy: ${errorMessage}`
+                        };
+                    }
+                    return {
+                        success: false,
+                        error: errorMessage
+                    };
+                }
+            },
+        },
+        /**
+         * Check wallet balance before making a payment.
+         */
+        checkBalance: {
+            description: 'Check the current balance of a Sardis wallet.',
+            parameters: z.object({
+                walletId: z.string().optional().describe('The wallet ID to check. Defaults to configured wallet.'),
+                token: z.enum(['USDC', 'USDT', 'PYUSD', 'EURC']).optional().describe('The token to check balance for.'),
+                chain: z.string().optional().describe('The chain to check balance on.'),
+            }),
+            execute: async ({ walletId, token, chain }) => {
+                if (!sardis) {
+                    return {
+                        success: false,
+                        error: "SardisClient not initialized"
+                    };
+                }
+                const effectiveWalletId = walletId || defaultWalletId;
+                if (!effectiveWalletId) {
+                    return {
+                        success: false,
+                        error: "No wallet ID provided"
+                    };
+                }
+                try {
+                    const balance = await sardis.wallets.getBalance(effectiveWalletId, chain || defaultChain, token || defaultToken);
+                    return {
+                        success: true,
+                        walletId: balance.wallet_id,
+                        balance: balance.balance,
+                        token: balance.token,
+                        chain: balance.chain,
+                        address: balance.address
+                    };
+                }
+                catch (error) {
+                    return {
+                        success: false,
+                        error: error instanceof Error ? error.message : 'Failed to get balance'
+                    };
+                }
+            },
+        },
+        /**
+         * Get wallet information.
+         */
+        getWallet: {
+            description: 'Get information about a Sardis wallet including spending limits.',
+            parameters: z.object({
+                walletId: z.string().optional().describe('The wallet ID to get info for. Defaults to configured wallet.'),
+            }),
+            execute: async ({ walletId }) => {
+                if (!sardis) {
+                    return {
+                        success: false,
+                        error: "SardisClient not initialized"
+                    };
+                }
+                const effectiveWalletId = walletId || defaultWalletId;
+                if (!effectiveWalletId) {
+                    return {
+                        success: false,
+                        error: "No wallet ID provided"
+                    };
+                }
+                try {
+                    const wallet = await sardis.wallets.get(effectiveWalletId);
+                    return {
+                        success: true,
+                        wallet: {
+                            id: wallet.id,
+                            agentId: wallet.agent_id,
+                            currency: wallet.currency,
+                            limitPerTx: wallet.limit_per_tx,
+                            limitTotal: wallet.limit_total,
+                            isActive: wallet.is_active,
+                            addresses: wallet.addresses
+                        }
+                    };
+                }
+                catch (error) {
+                    return {
+                        success: false,
+                        error: error instanceof Error ? error.message : 'Failed to get wallet'
+                    };
+                }
+            },
+        },
+    };
+};
+//# sourceMappingURL=vercel-ai.js.map

package/dist/integrations/vercel-ai.js.map

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

package/dist/resources/a2a.d.ts

@@ -0,0 +1,254 @@
+/**
+ * A2A (Agent-to-Agent) resource
+ *
+ * Provides inter-agent communication capabilities:
+ * - Discover other agents via agent cards
+ * - Send payment requests
+ * - Verify credentials
+ */
+import { BaseResource } from './base.js';
+export interface AgentCapability {
+    capability_type: string;
+    version?: string;
+    enabled?: boolean;
+    endpoint?: string;
+}
+export interface PaymentCapability {
+    supported_tokens: string[];
+    supported_chains: string[];
+    min_amount_minor?: number;
+    max_amount_minor?: number;
+    ap2_compliant?: boolean;
+    x402_compliant?: boolean;
+    ucp_compliant?: boolean;
+}
+export interface ServiceEndpoint {
+    url: string;
+    protocol?: string;
+    auth_required?: boolean;
+    auth_type?: string;
+}
+export interface AgentCard {
+    agent_id: string;
+    name: string;
+    version?: string;
+    description?: string;
+    operator?: {
+        name?: string;
+        url?: string;
+        contact?: string;
+    };
+    capabilities: string[];
+    payment?: PaymentCapability;
+    endpoints?: {
+        api?: ServiceEndpoint;
+        mcp?: string;
+        webhook?: ServiceEndpoint;
+        a2a?: ServiceEndpoint;
+    };
+    signing?: {
+        key_id?: string;
+        public_key?: string;
+        algorithm?: string;
+    };
+    created_at?: string;
+    updated_at?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface DiscoveredAgent {
+    agent_id: string;
+    agent_name: string;
+    agent_url: string;
+    card?: AgentCard;
+    available: boolean;
+    last_error?: string;
+    discovered_at: string;
+    last_verified_at: string;
+}
+export interface PaymentRequestInput {
+    recipient_agent_url: string;
+    amount_minor: number;
+    token: string;
+    chain: string;
+    destination: string;
+    purpose?: string;
+    reference?: string;
+    callback_url?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface PaymentResponse {
+    response_id: string;
+    request_id: string;
+    success: boolean;
+    status: string;
+    tx_hash?: string;
+    chain?: string;
+    block_number?: number;
+    error?: string;
+    error_code?: string;
+}
+export interface CredentialVerifyInput {
+    recipient_agent_url: string;
+    credential_type: string;
+    credential_data: Record<string, unknown>;
+    verify_signature?: boolean;
+    verify_expiration?: boolean;
+    verify_chain?: boolean;
+}
+export interface CredentialResponse {
+    response_id: string;
+    request_id: string;
+    valid: boolean;
+    verified_at: string;
+    signature_valid?: boolean;
+    not_expired?: boolean;
+    chain_valid?: boolean;
+    error?: string;
+    error_code?: string;
+    verification_details?: Record<string, unknown>;
+}
+export interface A2AMessage {
+    message_id: string;
+    message_type: string;
+    sender_id: string;
+    recipient_id: string;
+    timestamp: string;
+    expires_at?: string;
+    correlation_id?: string;
+    in_reply_to?: string;
+    payload: Record<string, unknown>;
+    signature?: string;
+    status: string;
+    error?: string;
+    error_code?: string;
+}
+export declare class A2AResource extends BaseResource {
+    /**
+     * Discover an agent by URL
+     *
+     * Fetches the agent card from /.well-known/agent-card.json
+     *
+     * @example
+     * ```typescript
+     * const agent = await client.a2a.discoverAgent('https://agent.example.com');
+     * console.log(agent.card?.capabilities);
+     * ```
+     */
+    discoverAgent(agentUrl: string, forceRefresh?: boolean): Promise<DiscoveredAgent>;
+    /**
+     * Get our own agent card
+     *
+     * @example
+     * ```typescript
+     * const myCard = await client.a2a.getAgentCard();
+     * console.log(myCard.capabilities);
+     * ```
+     */
+    getAgentCard(): Promise<AgentCard>;
+    /**
+     * List all discovered agents
+     *
+     * @example
+     * ```typescript
+     * const agents = await client.a2a.listAgents({
+     *   capability: 'payment.execute',
+     *   available_only: true,
+     * });
+     * ```
+     */
+    listAgents(options?: {
+        capability?: string;
+        token?: string;
+        chain?: string;
+        available_only?: boolean;
+    }): Promise<DiscoveredAgent[]>;
+    /**
+     * Send a payment request to another agent
+     *
+     * @example
+     * ```typescript
+     * const response = await client.a2a.sendPaymentRequest({
+     *   recipient_agent_url: 'https://merchant.example.com',
+     *   amount_minor: 5000,
+     *   token: 'USDC',
+     *   chain: 'base',
+     *   destination: '0x...',
+     *   purpose: 'Order #12345',
+     * });
+     *
+     * if (response.success) {
+     *   console.log('Payment tx:', response.tx_hash);
+     * }
+     * ```
+     */
+    sendPaymentRequest(input: PaymentRequestInput): Promise<PaymentResponse>;
+    /**
+     * Request credential verification from another agent
+     *
+     * @example
+     * ```typescript
+     * const response = await client.a2a.verifyCredential({
+     *   recipient_agent_url: 'https://verifier.example.com',
+     *   credential_type: 'mandate',
+     *   credential_data: mandate,
+     * });
+     *
+     * if (response.valid) {
+     *   console.log('Credential verified!');
+     * }
+     * ```
+     */
+    verifyCredential(input: CredentialVerifyInput): Promise<CredentialResponse>;
+    /**
+     * Send a raw A2A message to another agent
+     *
+     * @example
+     * ```typescript
+     * const response = await client.a2a.sendMessage(
+     *   'https://agent.example.com',
+     *   {
+     *     message_type: 'custom',
+     *     payload: { action: 'notify', data: {...} },
+     *   }
+     * );
+     * ```
+     */
+    sendMessage(recipientUrl: string, message: Partial<A2AMessage>): Promise<A2AMessage>;
+    /**
+     * List recent A2A messages
+     *
+     * @example
+     * ```typescript
+     * const messages = await client.a2a.listMessages({
+     *   direction: 'inbound',
+     *   message_type: 'payment_request',
+     * });
+     * ```
+     */
+    listMessages(options?: {
+        direction?: 'inbound' | 'outbound' | 'all';
+        message_type?: string;
+        status?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<A2AMessage[]>;
+    /**
+     * Register an agent for discovery
+     *
+     * @example
+     * ```typescript
+     * await client.a2a.registerAgent({
+     *   agent_id: 'my_agent',
+     *   agent_name: 'My Agent',
+     *   agent_url: 'https://my-agent.example.com',
+     * });
+     * ```
+     */
+    registerAgent(input: {
+        agent_id: string;
+        agent_name: string;
+        agent_url: string;
+        card?: AgentCard;
+    }): Promise<DiscoveredAgent>;
+}
+//# sourceMappingURL=a2a.d.ts.map

package/dist/resources/a2a.d.ts.map

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