envoy-pay 0.1.0

package/dist/types/requests/sep7.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sep7.d.ts","sourceRoot":"","sources":["../../../src/requests/sep7.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;IAClC,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CA0BzD"}

package/dist/types/requests/solana-pay.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Solana Pay — Payment URI builder.
+ *
+ * Generates `solana:` URIs per the Solana Pay specification
+ * for requesting SOL or SPL token payments.
+ *
+ * @see https://docs.solanapay.com/spec
+ *
+ * @example
+ * ```
+ * solana:7abc...?amount=1.5&spl-token=EPjFW...&reference=ref123&label=MyStore&message=Order42
+ * ```
+ */
+export interface SolanaPayOptions {
+    /** Recipient wallet address (base58). */
+    recipient: string;
+    /** Amount to request (human-readable). */
+    amount: string;
+    /** SPL token mint address. If omitted, requests native SOL. */
+    splToken?: string;
+    /** Unique reference for tracking the payment (base58 public key). */
+    reference?: string;
+    /** Label for the recipient. */
+    label?: string;
+    /** Message to display to the payer. */
+    message?: string;
+    /** Optional memo to include in the transaction. */
+    memo?: string;
+}
+/**
+ * Build a Solana Pay payment URI.
+ *
+ * @example
+ * ```ts
+ * // Native SOL
+ * buildSolanaPayUri({ recipient: '7abc...', amount: '1.5' });
+ * // => 'solana:7abc...?amount=1.5'
+ *
+ * // USDC SPL token
+ * buildSolanaPayUri({
+ *   recipient: '7abc...',
+ *   amount: '25.00',
+ *   splToken: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
+ *   label: 'envoy',
+ *   message: 'Agent service payment',
+ * });
+ * ```
+ */
+export declare function buildSolanaPayUri(options: SolanaPayOptions): string;
+//# sourceMappingURL=solana-pay.d.ts.map

package/dist/types/requests/solana-pay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solana-pay.d.ts","sourceRoot":"","sources":["../../../src/requests/solana-pay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAYnE"}

package/dist/types/requests/universal.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Universal Payment URI builder — auto-detects chain and generates
+ * the appropriate payment URI format.
+ */
+import { type Eip681Options } from './eip681';
+import { type Sep7Options } from './sep7';
+import { type SolanaPayOptions } from './solana-pay';
+export interface UniversalPaymentUriOptions {
+    /** Target chain. */
+    chain: 'evm' | 'stellar' | 'solana';
+    /** Chain-specific options. */
+    evm?: Eip681Options;
+    stellar?: Sep7Options;
+    solana?: SolanaPayOptions;
+}
+/**
+ * Build a payment URI for any supported chain.
+ *
+ * @example
+ * ```ts
+ * const uri = buildPaymentUri({
+ *   chain: 'evm',
+ *   evm: { to: '0x...', amount: '0.5', chainId: 8453 },
+ * });
+ * ```
+ */
+export declare function buildPaymentUri(options: UniversalPaymentUriOptions): string;
+//# sourceMappingURL=universal.d.ts.map

package/dist/types/requests/universal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"universal.d.ts","sourceRoot":"","sources":["../../../src/requests/universal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AACxD,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAExE,MAAM,WAAW,0BAA0B;IACzC,oBAAoB;IACpB,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,QAAQ,CAAC;IACpC,8BAA8B;IAC9B,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,CAc3E"}

package/dist/types/server/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * envoy — Server-Side Payment Gating
+ *
+ * Express/Connect-compatible middleware for monetizing API endpoints.
+ * Supports both x402 and MPP (Machine Payment Protocol) standards.
+ *
+ * @example
+ * ```ts
+ * import { createPaymentGate } from 'envoy-pay/server';
+ *
+ * app.post('/api/premium',
+ *   createPaymentGate({
+ *     payTo: '0xYOUR_WALLET',
+ *     amount: '500000',  // 0.50 USDC
+ *     asset: 'USDC',
+ *     network: 'eip155:8453',
+ *   }),
+ *   (req, res) => { res.json({ data: 'premium content' }); }
+ * );
+ * ```
+ */
+export { createX402Gate, type X402GateConfig, type X402Proof } from './x402-gate';
+export { createMppGate, type MppGateConfig } from './mpp-gate';
+export { createPaymentGate, type PaymentGateConfig } from './payment-gate';
+export { createWebhookHandler, type WebhookConfig } from './webhook';
+export { buildReceipt, type ReceiptOptions, type PaymentReceipt } from './receipt';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/types/server/mpp-gate.d.ts

@@ -0,0 +1,66 @@
+import type { IncomingMessage, ServerResponse } from 'http';
+import { Logger } from '../logger';
+/**
+ * Configuration for MPP payment gate middleware.
+ */
+export interface MppGateConfig {
+    /** Realm identifier for the challenge (usually the API domain). */
+    realm: string;
+    /** Payment method: 'stripe', 'onchain', etc. */
+    method: string;
+    /** Intent: 'payment', 'subscription', etc. Default: 'payment'. */
+    intent?: string;
+    /** Amount to charge (as string, in smallest units). */
+    amount: string;
+    /** Currency code. Default: 'usd'. */
+    currency?: string;
+    /** Number of decimal places. Default: 2. */
+    decimals?: number;
+    /** Recipient address / account. */
+    recipient: string;
+    /** Challenge TTL in milliseconds. Default: 300000 (5 min). */
+    ttlMs?: number;
+    /** Verification function for the payment credential. */
+    verifyCredential?: (credential: MppCredential, challengeId: string) => Promise<boolean> | boolean;
+    /** Logger function. */
+    logger?: Logger;
+}
+/** Decoded MPP credential from Authorization: Payment header. */
+export interface MppCredential {
+    challenge: {
+        id: string;
+        realm: string;
+        method: string;
+        intent: string;
+        request: string;
+        expires?: string;
+    };
+    source: string;
+    payload: {
+        transaction: string;
+    };
+}
+/** Express/Connect request with optional MPP payment metadata. */
+interface MppGatedRequest extends IncomingMessage {
+    mppPayment?: MppCredential;
+}
+/**
+ * Creates an Express/Connect middleware that gates access behind MPP payments.
+ *
+ * When a request lacks a valid `Authorization: Payment` header, the middleware
+ * responds with 402 and a `WWW-Authenticate: Payment` challenge header.
+ *
+ * @example
+ * ```ts
+ * app.post('/api/premium', createMppGate({
+ *   realm: 'api.example.com',
+ *   method: 'stripe',
+ *   amount: '50',
+ *   currency: 'usd',
+ *   recipient: 'acct_xxx',
+ * }), handler);
+ * ```
+ */
+export declare function createMppGate(config: MppGateConfig): (req: MppGatedRequest, res: ServerResponse, next: (err?: any) => void) => Promise<void>;
+export {};
+//# sourceMappingURL=mpp-gate.d.ts.map

package/dist/types/server/mpp-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mpp-gate.d.ts","sourceRoot":"","sources":["../../../src/server/mpp-gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAc,MAAM,WAAW,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAClG,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE;QACT,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,kEAAkE;AAClE,UAAU,eAAgB,SAAQ,eAAe;IAC/C,UAAU,CAAC,EAAE,aAAa,CAAC;CAC5B;AAYD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,IAQ/C,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,KAAK,IAAI,mBA6F5B"}

package/dist/types/server/payment-gate.d.ts

@@ -0,0 +1,33 @@
+import type { IncomingMessage, ServerResponse } from 'http';
+import { type X402GateConfig } from './x402-gate';
+import { type MppGateConfig } from './mpp-gate';
+import { Logger } from '../logger';
+/**
+ * Unified Payment Gate — supports both x402 and MPP simultaneously.
+ */
+export interface PaymentGateConfig {
+    /** x402 configuration. */
+    x402: Omit<X402GateConfig, 'logger'>;
+    /** MPP configuration. */
+    mpp: Omit<MppGateConfig, 'logger'>;
+    /** Shared logger. */
+    logger?: Logger;
+}
+/**
+ * Creates a dual-protocol payment gate that accepts both x402 and MPP.
+ *
+ * Detection logic:
+ * - `X-PAYMENT` header → x402 flow
+ * - `Authorization: Payment` header → MPP flow
+ * - Neither present → returns both challenge types simultaneously
+ *
+ * @example
+ * ```ts
+ * app.post('/api/premium', createPaymentGate({
+ *   x402: { payTo: '0x...', amount: '500000', asset: 'USDC', network: 'eip155:8453' },
+ *   mpp: { realm: 'api.example.com', method: 'stripe', amount: '50', recipient: 'acct_xxx' },
+ * }), handler);
+ * ```
+ */
+export declare function createPaymentGate(config: PaymentGateConfig): (req: IncomingMessage, res: ServerResponse, next: (err?: any) => void) => Promise<void>;
+//# sourceMappingURL=payment-gate.d.ts.map

package/dist/types/server/payment-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-gate.d.ts","sourceRoot":"","sources":["../../../src/server/payment-gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAC5D,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAc,MAAM,WAAW,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IACrC,yBAAyB;IACzB,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IACnC,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,IAcvD,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,KAAK,IAAI,mBAuE5B"}

package/dist/types/server/receipt.d.ts

@@ -0,0 +1,52 @@
+/**
+ * MPP Payment-Receipt builder.
+ *
+ * Generates base64url-encoded receipt JSON that can be attached
+ * as a `Payment-Receipt` response header after successful payment verification.
+ */
+export interface ReceiptOptions {
+    /** The challenge ID this receipt is for. */
+    challengeId: string;
+    /** Payment status. */
+    status: 'settled' | 'pending' | 'failed';
+    /** Amount paid (atomic units). */
+    amount: string;
+    /** Currency / asset. */
+    asset: string;
+    /** Transaction hash / proof. */
+    transactionHash?: string;
+    /** Timestamp of the receipt. */
+    timestamp?: Date;
+}
+export interface PaymentReceipt {
+    challengeId: string;
+    status: 'settled' | 'pending' | 'failed';
+    amount: string;
+    asset: string;
+    transactionHash?: string;
+    issuedAt: string;
+}
+/**
+ * Build a Payment-Receipt header value.
+ *
+ * @returns base64url-encoded JSON receipt.
+ *
+ * @example
+ * ```ts
+ * const receipt = buildReceipt({
+ *   challengeId: 'ch_123',
+ *   status: 'settled',
+ *   amount: '500000',
+ *   asset: 'USDC',
+ *   transactionHash: '0xabc...',
+ * });
+ *
+ * res.setHeader('Payment-Receipt', receipt);
+ * ```
+ */
+export declare function buildReceipt(options: ReceiptOptions): string;
+/**
+ * Parse a Payment-Receipt header value back into a receipt object.
+ */
+export declare function parseReceipt(encoded: string): PaymentReceipt;
+//# sourceMappingURL=receipt.d.ts.map

package/dist/types/server/receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt.d.ts","sourceRoot":"","sources":["../../../src/server/receipt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACzC,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gCAAgC;IAChC,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAe5D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAI5D"}

package/dist/types/server/webhook.d.ts

@@ -0,0 +1,46 @@
+import { Logger } from '../logger';
+/**
+ * Configuration for Stripe webhook handler.
+ */
+export interface WebhookConfig {
+    /** Stripe webhook signing secret (whsec_...). */
+    signingSecret: string;
+    /** Callback for successful payments. */
+    onPaymentSuccess?: (event: WebhookEvent) => void | Promise<void>;
+    /** Callback for failed payments. */
+    onPaymentFailure?: (event: WebhookEvent) => void | Promise<void>;
+    /** Idempotency: track processed event IDs to prevent replay. */
+    processedEventIds?: Set<string>;
+    /** Logger function. */
+    logger?: Logger;
+}
+/** Simplified webhook event representation. */
+export interface WebhookEvent {
+    id: string;
+    type: string;
+    amount?: number;
+    currency?: string;
+    paymentIntentId?: string;
+    metadata?: Record<string, string>;
+    timestamp: Date;
+}
+/**
+ * Creates a Connect/Express-compatible webhook handler for Stripe events.
+ *
+ * Uses HMAC signature verification via the raw request body.
+ * Supports idempotency guard to prevent duplicate processing.
+ *
+ * @example
+ * ```ts
+ * const handler = createWebhookHandler({
+ *   signingSecret: process.env.STRIPE_WEBHOOK_SECRET!,
+ *   onPaymentSuccess: (event) => {
+ *     console.log(`Payment received: ${event.amount} ${event.currency}`);
+ *   },
+ * });
+ *
+ * app.post('/webhook', express.raw({ type: 'application/json' }), handler);
+ * ```
+ */
+export declare function createWebhookHandler(config: WebhookConfig): (req: any, res: any, _next?: (err?: any) => void) => Promise<void>;
+//# sourceMappingURL=webhook.d.ts.map

package/dist/types/server/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../../src/server/webhook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAc,MAAM,WAAW,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,oCAAoC;IACpC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,IAKtD,KAAK,GAAG,EACR,KAAK,GAAG,EACR,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,KAAK,IAAI,mBA2E9B"}

package/dist/types/server/x402-gate.d.ts

@@ -0,0 +1,70 @@
+import type { IncomingMessage, ServerResponse } from 'http';
+import { Logger } from '../logger';
+/**
+ * Configuration for x402 payment gate middleware.
+ */
+export interface X402GateConfig {
+    /** Wallet address to receive payments. */
+    payTo: string;
+    /** Amount in atomic units (e.g., '500000' = 0.50 USDC). */
+    amount: string;
+    /** Asset identifier: 'USDC', 'ETH', etc. */
+    asset: string;
+    /** Network / CAIP-2 identifier. */
+    network: string;
+    /** Payment scheme. Default: 'exact'. */
+    scheme?: string;
+    /** x402 version. Default: 2. */
+    x402Version?: number;
+    /** Resource description for human-readable display. */
+    description?: string;
+    /** USD amount for policy engines (optional). */
+    usdAmount?: number;
+    /** Facilitator URL for verification (optional). */
+    facilitatorUrl?: string;
+    /** Verification function. If provided, called to verify X-PAYMENT proof. */
+    verifyPayment?: (proof: X402Proof) => Promise<boolean> | boolean;
+    /** Logger function. */
+    logger?: Logger;
+}
+/** Decoded X-PAYMENT proof from client. */
+export interface X402Proof {
+    x402Version: number;
+    accepted: {
+        scheme: string;
+        network: string;
+        amount: string;
+        payTo: string;
+        asset: string;
+    };
+    payload: {
+        transaction: string;
+        chain: string;
+    };
+}
+/** Express/Connect-style request with optional payment metadata. */
+interface GatedRequest extends IncomingMessage {
+    payment?: X402Proof;
+}
+/**
+ * Creates an Express/Connect middleware that gates access behind x402 payments.
+ *
+ * When a request lacks a valid `X-PAYMENT` header, the middleware responds with
+ * 402 Payment Required and an x402-compliant JSON challenge body.
+ *
+ * When a valid `X-PAYMENT` header is present, it's decoded and optionally
+ * verified before calling `next()`.
+ *
+ * @example
+ * ```ts
+ * app.post('/api/premium', createX402Gate({
+ *   payTo: '0xABC...',
+ *   amount: '500000',
+ *   asset: 'USDC',
+ *   network: 'eip155:8453',
+ * }), handler);
+ * ```
+ */
+export declare function createX402Gate(config: X402GateConfig): (req: GatedRequest, res: ServerResponse, next: (err?: any) => void) => Promise<void>;
+export {};
+//# sourceMappingURL=x402-gate.d.ts.map

package/dist/types/server/x402-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402-gate.d.ts","sourceRoot":"","sources":["../../../src/server/x402-gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAc,MAAM,WAAW,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACjE,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,2CAA2C;AAC3C,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,oEAAoE;AACpE,UAAU,YAAa,SAAQ,eAAe;IAC5C,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,IAMjD,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,KAAK,IAAI,mBAoF5B"}

package/dist/types/solana.d.ts

@@ -0,0 +1,7 @@
+export { SolanaPaymentAdapter } from './adapters/solana';
+export type { SolanaAdapterOptions } from './adapters/solana';
+export { createSolanaWatcher } from './monitor/solana-watcher';
+export type { SolanaWatcherConfig } from './monitor/solana-watcher';
+export { buildSolanaPayUri } from './requests/solana-pay';
+export type { SolanaPayOptions } from './requests/solana-pay';
+//# sourceMappingURL=solana.d.ts.map

package/dist/types/solana.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solana.d.ts","sourceRoot":"","sources":["../../src/solana.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/types/stellar.d.ts

@@ -0,0 +1,7 @@
+export { StellarPaymentAdapter } from './adapters/stellar';
+export type { StellarPaymentAdapterOptions } from './adapters/stellar';
+export { createStellarWatcher } from './monitor/stellar-watcher';
+export type { StellarWatcherConfig } from './monitor/stellar-watcher';
+export { buildSep7Uri } from './requests/sep7';
+export type { Sep7Options } from './requests/sep7';
+//# sourceMappingURL=stellar.d.ts.map

package/dist/types/stellar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stellar.d.ts","sourceRoot":"","sources":["../../src/stellar.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,YAAY,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types/wallet/balance-aggregator.d.ts

@@ -0,0 +1,51 @@
+/**
+ * BalanceAggregator — Multi-chain balance aggregation.
+ *
+ * Queries all registered adapters in parallel to produce a unified
+ * balance snapshot. Handles adapters that don't implement `getBalance()`
+ * gracefully (returns 0).
+ *
+ * @example
+ * ```ts
+ * const aggregator = new BalanceAggregator(adapters);
+ * const balance = await aggregator.getUnifiedBalance();
+ * console.log(balance.totalFormatted); // "$400.00"
+ * ```
+ */
+import { PaymentAdapter } from '../adapters/types';
+import { ChainBalance, UnifiedBalance } from './types';
+export declare class BalanceAggregator {
+    private adapters;
+    constructor(adapters: PaymentAdapter[]);
+    /**
+     * Query all adapters and return a unified balance snapshot.
+     * Adapters without `getBalance()` report $0.
+     */
+    getUnifiedBalance(): Promise<UnifiedBalance>;
+    /**
+     * Get the balance for a specific chain by CAIP-2 ID.
+     */
+    getChainBalance(caip2Id: string): Promise<ChainBalance | null>;
+    /**
+     * Find the adapter with the highest USD balance.
+     */
+    getRichestChain(): Promise<ChainBalance | null>;
+    /**
+     * Check if sufficient funds exist across all chains.
+     */
+    hasSufficientFunds(amountUsd: number): Promise<boolean>;
+    /**
+     * Find all chains that can cover a given USD amount.
+     */
+    getChainsWithSufficientFunds(amountUsd: number): Promise<ChainBalance[]>;
+    private queryAdapter;
+    /**
+     * Convert an asset amount to USD using stablecoin 1:1 or fallback rates.
+     */
+    private toUsd;
+    /**
+     * Best-effort detection of the primary asset for a chain.
+     */
+    private detectPrimaryAsset;
+}
+//# sourceMappingURL=balance-aggregator.d.ts.map

package/dist/types/wallet/balance-aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance-aggregator.d.ts","sourceRoot":"","sources":["../../../src/wallet/balance-aggregator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAyBvD,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,cAAc,EAAE;IAE9C;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC;IAwBlD;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAMpE;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAQrD;;OAEG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK7D;;OAEG;IACG,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;YAOhE,YAAY;IA4B1B;;OAEG;IACH,OAAO,CAAC,KAAK;IAQb;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAQ3B"}

package/dist/types/wallet/chain-router.d.ts

@@ -0,0 +1,44 @@
+/**
+ * ChainRouter — Optimal chain selection for payment execution.
+ *
+ * Given a payment intent ($5 USDC), the router scores all available
+ * adapters based on the configured strategy (cheapest, fastest,
+ * prefer-crypto, etc.) and returns a ranked list of PaymentPlans.
+ *
+ * Scoring is based on chain metadata (gas estimates, settlement times)
+ * and real-time balance availability.
+ *
+ * @see ERC-7521 — Intent-based execution patterns
+ */
+import { PaymentAdapter } from '../adapters/types';
+import { ChainMeta, PayIntent, PaymentPlan, RoutingStrategy } from './types';
+export declare class ChainRouter {
+    private adapters;
+    private chainMeta;
+    private roundRobinIndex;
+    constructor(adapters: PaymentAdapter[], customMeta?: Record<string, ChainMeta>);
+    /**
+     * Score and rank all adapters for a given payment intent.
+     * Returns plans sorted by score (lower = better).
+     */
+    route(intent: PayIntent, strategy: RoutingStrategy): PaymentPlan[];
+    /**
+     * Get the single best adapter for a payment intent.
+     */
+    getBestPlan(intent: PayIntent, strategy: RoutingStrategy): PaymentPlan | null;
+    /**
+     * Get chain metadata for a CAIP-2 ID.
+     * Falls back to sensible defaults for unknown chains.
+     */
+    getChainMeta(caip2Id: string): ChainMeta;
+    /**
+     * Calculate a composite score for an adapter/chain based on the strategy.
+     * Lower score = better.
+     */
+    private calculateScore;
+    /**
+     * Convert a USD amount to atomic units for a specific chain.
+     */
+    private toAtomicUnits;
+}
+//# sourceMappingURL=chain-router.d.ts.map

package/dist/types/wallet/chain-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-router.d.ts","sourceRoot":"","sources":["../../../src/wallet/chain-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,SAAS,EACT,SAAS,EACT,WAAW,EACX,eAAe,EAChB,MAAM,SAAS,CAAC;AAmIjB,qBAAa,WAAW;IAKpB,OAAO,CAAC,QAAQ;IAJlB,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,eAAe,CAAK;gBAGlB,QAAQ,EAAE,cAAc,EAAE,EAClC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;IAiBxC;;;OAGG;IACH,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,GAAG,WAAW,EAAE;IAiClE;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,GAAG,WAAW,GAAG,IAAI;IAK7E;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAaxC;;;OAGG;IACH,OAAO,CAAC,cAAc;IAwCtB;;OAEG;IACH,OAAO,CAAC,aAAa;CAKtB"}

package/dist/types/wallet/index.d.ts

@@ -0,0 +1,7 @@
+export { UnifiedWallet } from './unified-wallet';
+export { BalanceAggregator } from './balance-aggregator';
+export { ChainRouter } from './chain-router';
+export { IntentResolver } from './intent-resolver';
+export { SessionManager } from './session-manager';
+export type { UnifiedWalletOptions, UnifiedBalance, ChainBalance, PayIntent, PaymentPlan, PayResult, RoutingStrategy, Session, SessionPermissions, ChainMeta, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/wallet/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/wallet/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EACV,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,SAAS,EACT,WAAW,EACX,SAAS,EACT,eAAe,EACf,OAAO,EACP,kBAAkB,EAClB,SAAS,GACV,MAAM,SAAS,CAAC"}

package/dist/types/wallet/intent-resolver.d.ts

@@ -0,0 +1,39 @@
+/**
+ * IntentResolver — Parses natural-language payment intents into PaymentPlans.
+ *
+ * Agents express payment desires as simple strings ("pay $5", "send 10 USDC
+ * to 0x1234..."). The IntentResolver parses these into structured PayIntent
+ * objects, then delegates to ChainRouter for execution planning.
+ *
+ * Supports:
+ * - "$5" / "$5.00" — USD amounts
+ * - "5 USDC" / "10 XLM" — Asset-specific amounts
+ * - "to 0x..." / "to G..." / "to ..." — destination extraction
+ * - "memo: invoice-123" — memo extraction
+ *
+ * @see ERC-7521 — Intent-centric execution pattern
+ */
+import { PayIntent } from './types';
+export declare class IntentResolver {
+    /**
+     * Parse a natural-language payment intent string into a structured PayIntent.
+     *
+     * @example
+     * resolve('pay $5 to 0x1234...');           // { amount: '5.00', destination: '0x1234...' }
+     * resolve('send 100 USDC memo: inv-42');    // { amount: '100', asset: 'USDC', memo: 'inv-42' }
+     * resolve('$0.50');                          // { amount: '0.50' }
+     */
+    resolve(input: string): PayIntent;
+    /**
+     * Validate that a PayIntent has the minimum required fields.
+     */
+    validate(intent: PayIntent): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Convert a raw USD amount string to a specific asset amount.
+     */
+    usdToAsset(usdAmount: string, asset: string): string;
+}
+//# sourceMappingURL=intent-resolver.d.ts.map

package/dist/types/wallet/intent-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-resolver.d.ts","sourceRoot":"","sources":["../../../src/wallet/intent-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAqDpC,qBAAa,cAAc;IACzB;;;;;;;OAOG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS;IAiDjC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAkBjE;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;CAOrD"}