envoy-pay 0.1.0

package/dist/types/monitor/stellar-watcher.d.ts

@@ -0,0 +1,34 @@
+import type { IncomingPayment, Unsubscribe } from '../adapters/types';
+import { Logger } from '../logger';
+/**
+ * Stellar Watcher — monitors incoming payments via Horizon SSE.
+ *
+ * Uses the Horizon `/payments` endpoint with Server-Sent Events (SSE)
+ * to receive real-time notifications of incoming payments.
+ */
+export interface StellarWatcherConfig {
+    /** Stellar account to monitor. */
+    accountId: string;
+    /** Horizon server URL. Default: 'https://horizon.stellar.org'. */
+    horizonUrl?: string;
+    /** Asset filter: 'USDC', 'XLM', or 'all'. Default: 'all'. */
+    asset?: string;
+    /** Cursor to resume from (paging_token). If omitted, starts from 'now'. */
+    cursor?: string;
+    /** Callback for detected incoming payments. */
+    onPayment: (event: IncomingPayment) => void;
+    /** Callback for errors. */
+    onError?: (error: Error) => void;
+    /** Logger function. */
+    logger?: Logger;
+}
+/**
+ * Creates a Stellar payment watcher using Horizon SSE streaming.
+ *
+ * Listens for `payment` and `create_account` operations directed
+ * to the target account. Supports asset-based filtering.
+ *
+ * @returns Unsubscribe function to stop watching.
+ */
+export declare function createStellarWatcher(config: StellarWatcherConfig): Unsubscribe;
+//# sourceMappingURL=stellar-watcher.d.ts.map

package/dist/types/monitor/stellar-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stellar-watcher.d.ts","sourceRoot":"","sources":["../../../src/monitor/stellar-watcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,MAAM,EAAc,MAAM,WAAW,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,SAAS,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAC5C,2BAA2B;IAC3B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAgBD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,WAAW,CAgI9E"}

package/dist/types/mpp.d.ts

@@ -0,0 +1,153 @@
+/**
+ * MPP — Machine Payments Protocol utilities.
+ *
+ * Handles parsing/building of MPP-standard headers:
+ *   - WWW-Authenticate: Payment (Challenge)
+ *   - Authorization: Payment (Credential)
+ *   - Payment-Receipt (Receipt)
+ *
+ * @see https://mpp.dev/protocol/challenges
+ * @see https://mpp.dev/protocol/credentials
+ * @see https://mpp.dev/protocol/receipts
+ * @see https://paymentauth.org — IETF specification
+ */
+/** Supported MPP payment methods */
+export type MppMethod = 'stripe' | 'tempo' | 'card' | 'lightning' | 'solana' | 'stellar' | string;
+/** Payment intent types */
+export type MppIntent = 'charge' | 'session';
+/**
+ * Parsed MPP Challenge from `WWW-Authenticate: Payment` header.
+ */
+export interface MppChallenge {
+    /** Unique challenge ID (cryptographically bound to parameters) */
+    id: string;
+    /** Server realm (e.g. "mpp.dev", "envoy.dev") */
+    realm: string;
+    /** Payment method identifier */
+    method: MppMethod;
+    /** Payment intent type */
+    intent: MppIntent;
+    /** Base64url-encoded JSON with method-specific payment details */
+    request: string;
+    /** ISO 8601 expiration timestamp (optional) */
+    expires?: string;
+    /** Human-readable description (optional) */
+    description?: string;
+}
+/**
+ * Decoded request object from Challenge.
+ */
+export interface MppRequestObject {
+    /** Amount in smallest currency unit (string for precision) */
+    amount: string;
+    /** Currency code (e.g. "usd") or token address */
+    currency: string;
+    /** Recipient address or Stripe account */
+    recipient?: string;
+    /** Decimal places for the currency */
+    decimals?: number;
+    /** Human-readable description */
+    description?: string;
+    /** External reference ID */
+    externalId?: string;
+    /** Method-specific details */
+    methodDetails?: {
+        networkId?: string;
+        paymentMethodTypes?: string[];
+        metadata?: Record<string, string>;
+        [key: string]: unknown;
+    };
+}
+/**
+ * MPP Credential — sent in `Authorization: Payment` header.
+ */
+export interface MppCredential {
+    /** Echo of the original challenge */
+    challenge: MppChallenge;
+    /** DID or identifier of the paying entity */
+    source: string;
+    /** Method-specific payload */
+    payload: MppStripePayload | MppTempoPayload | Record<string, unknown>;
+}
+/** Stripe-specific credential payload */
+export interface MppStripePayload {
+    /** Shared Payment Token ID */
+    spt: string;
+    /** Optional external reference ID */
+    externalId?: string;
+}
+/** Tempo-specific credential payload */
+export interface MppTempoPayload {
+    type: 'transaction' | 'hash' | 'proof';
+    signature?: string;
+    hash?: string;
+}
+/**
+ * MPP Receipt — returned in `Payment-Receipt` header.
+ */
+export interface MppReceipt {
+    /** Receipt data (base64url-decoded JSON) */
+    [key: string]: unknown;
+}
+/**
+ * Encode string to base64url (RFC 4648 §5).
+ * No padding, URL-safe alphabet.
+ */
+export declare function base64urlEncode(str: string): string;
+/**
+ * Decode base64url string.
+ */
+export declare function base64urlDecode(str: string): string;
+/**
+ * Parse a `WWW-Authenticate: Payment` header value into an MppChallenge.
+ *
+ * Format:
+ * ```
+ * Payment id="abc", realm="mpp.dev", method="stripe", intent="charge",
+ *   expires="2025-01-15T12:05:00Z", request="eyJhbW91bnQ..."
+ * ```
+ *
+ * @param header — Raw header value (with or without "Payment " prefix)
+ * @returns Parsed challenge object
+ * @throws Error if required fields are missing
+ */
+export declare function parseMppChallenge(header: string): MppChallenge;
+/**
+ * Parse multiple `WWW-Authenticate: Payment` headers.
+ * Servers can offer multiple payment options.
+ */
+export declare function parseMppChallenges(headers: string[]): MppChallenge[];
+/**
+ * Decode the `request` field of a Challenge into a structured object.
+ */
+export declare function decodeChallengeRequest(challenge: MppChallenge): MppRequestObject;
+/**
+ * Build an MPP Credential for the `Authorization: Payment` header.
+ *
+ * @param challenge — The challenge being responded to
+ * @param source — DID or identifier of the payer
+ * @param payload — Method-specific proof (SPT for Stripe, tx for Tempo)
+ * @returns Base64url-encoded credential string
+ */
+export declare function buildMppCredential(challenge: MppChallenge, source: string, payload: MppCredential['payload']): string;
+/**
+ * Build the full `Authorization` header value.
+ */
+export declare function buildAuthorizationHeader(challenge: MppChallenge, source: string, payload: MppCredential['payload']): string;
+/**
+ * Parse a `Payment-Receipt` header.
+ */
+export declare function parseMppReceipt(header: string): MppReceipt;
+/**
+ * Detect whether a 402 response uses MPP or x402 protocol.
+ *
+ * MPP: has `WWW-Authenticate: Payment` header
+ * x402: has JSON body with `x402Version` and `accepts[]`
+ */
+export declare function detectProtocol(headers: Record<string, string | string[] | undefined>, body?: unknown): 'mpp' | 'x402' | 'unknown';
+/**
+ * Extract all MPP challenges from response headers.
+ * Handles both single and multiple WWW-Authenticate headers.
+ */
+export declare function extractMppChallenges(headers: Record<string, string | string[] | undefined>): MppChallenge[];
+//# sourceMappingURL=mpp.d.ts.map

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

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

package/dist/types/policy.d.ts

@@ -0,0 +1,40 @@
+/**
+ * PolicyEngine — On-device budget controller for autonomous AI agents.
+ *
+ * Enforces per-transaction caps, monthly rolling budgets, and optional
+ * destination whitelists so that an agent can never overspend without
+ * explicit human approval.
+ *
+ * Fail-closed: if any check fails, the payment is rejected.
+ */
+import { Logger } from './logger';
+export interface BudgetPolicy {
+    /** Maximum USD amount the agent may spend in a single transaction. */
+    maxAmountPerTransaction: number;
+    /** Maximum USD the agent may spend within a calendar month. */
+    monthlyBudget: number;
+    /** Optional whitelist of addresses the agent is allowed to pay. */
+    allowedDestinations?: string[];
+}
+export declare class PolicyEngine {
+    private policy;
+    private currentMonthSpent;
+    private log;
+    constructor(policy: BudgetPolicy, logger?: Logger);
+    /**
+     * Returns `true` if the proposed spend passes every policy gate.
+     * Fail-closed: any unrecognised state returns `false`.
+     */
+    checkPolicy(amountUsd: number, destination?: string): boolean;
+    /** Record a successful spend against the rolling budget. */
+    recordSpend(amountUsd: number): void;
+    /** Get total USD spent in the current period. */
+    getSpent(): number;
+    /** Get remaining USD budget. */
+    getRemainingBudget(): number;
+    /** Reset the spend counter (e.g. on month rollover or for testing). */
+    resetBudget(): void;
+    /** Get a snapshot of the current policy configuration. */
+    getPolicy(): Readonly<BudgetPolicy>;
+}
+//# sourceMappingURL=policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAc,MAAM,UAAU,CAAC;AAE9C,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,uBAAuB,EAAE,MAAM,CAAC;IAChC,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,qBAAa,YAAY;IAKrB,OAAO,CAAC,MAAM;IAJhB,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,GAAG,CAAS;gBAGV,MAAM,EAAE,YAAY,EAC5B,MAAM,CAAC,EAAE,MAAM;IAKjB;;;OAGG;IACI,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO;IAiCpE,4DAA4D;IACrD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAO3C,iDAAiD;IAC1C,QAAQ,IAAI,MAAM;IAIzB,gCAAgC;IACzB,kBAAkB,IAAI,MAAM;IAInC,uEAAuE;IAChE,WAAW,IAAI,IAAI;IAI1B,0DAA0D;IACnD,SAAS,IAAI,QAAQ,CAAC,YAAY,CAAC;CAG3C"}

package/dist/types/providers/bridge.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Cross-Chain Bridge Module for envoy
+ *
+ * Provides cross-chain token transfers between any supported EVM chain
+ * using the OnchainOS DEX cross-chain API.
+ *
+ * Strategies:
+ * 1. OnchainOS Cross-Chain — single-tx bridge via OKX aggregated bridges
+ *    (Stargate, Across, Celer, etc.)
+ * 2. Two-Step — swap to bridgeable token on source → bridge → swap on dest
+ *
+ * @example
+ * ```ts
+ * const bridge = new CrossChainBridge({ provider: okxProvider });
+ *
+ * // Get quote: Base USDC → X Layer USDC
+ * const quote = await bridge.getQuote({
+ *   fromChainIndex: '8453',
+ *   toChainIndex: '196',
+ *   fromTokenAddress: USDC_BASE,
+ *   toTokenAddress: USDC_XLAYER,
+ *   amount: '1000000', // 1 USDC
+ * });
+ *
+ * // Execute bridge (requires signer)
+ * const result = await bridge.execute(quote, walletClient);
+ * ```
+ */
+import { type OnchainOSProvider } from './onchainos';
+import { Logger } from '../logger';
+export interface BridgeQuoteParams {
+    /** Source chain index (e.g. '8453' for Base). */
+    fromChainIndex: string;
+    /** Destination chain index (e.g. '196' for X Layer). */
+    toChainIndex: string;
+    /** Source token contract address. Use 0xEeEe...EEeE for native. */
+    fromTokenAddress: string;
+    /** Destination token contract address. Use 0xEeEe...EEeE for native. */
+    toTokenAddress: string;
+    /** Amount in smallest unit (e.g. '1000000' for 1 USDC). */
+    amount: string;
+    /** Slippage tolerance percentage (default: '1'). */
+    slippagePercent?: string;
+    /** User wallet address (required for buildTx). */
+    userWalletAddress?: string;
+}
+export interface BridgeQuoteResult {
+    /** Bridge route information. */
+    route: BridgeRoute;
+    /** Estimated output amount in smallest unit. */
+    toTokenAmount: string;
+    /** Source token info. */
+    fromToken: {
+        symbol: string;
+        decimals: number;
+        address: string;
+    };
+    /** Destination token info. */
+    toToken: {
+        symbol: string;
+        decimals: number;
+        address: string;
+    };
+    /** Estimated bridge fee in USD. */
+    estimatedFeeUsd: string;
+    /** Estimated time in seconds. */
+    estimatedTimeSeconds: number;
+    /** Minimum received after slippage. */
+    minReceiveAmount: string;
+    /** Ready-to-sign transaction data (if userWalletAddress provided). */
+    tx?: BridgeTxData;
+}
+export interface BridgeRoute {
+    /** Bridge/DEX protocol used. */
+    bridgeName: string;
+    /** Steps in the route. */
+    steps: BridgeStep[];
+    /** Total route: source → dest description. */
+    description: string;
+}
+export interface BridgeStep {
+    type: 'swap' | 'bridge' | 'approve';
+    chainIndex: string;
+    protocol: string;
+    fromToken: string;
+    toToken: string;
+    amount: string;
+}
+export interface BridgeTxData {
+    from: string;
+    to: string;
+    data: string;
+    value: string;
+    gas: string;
+    gasPrice: string;
+    chainId: string;
+}
+export interface BridgeStatus {
+    status: 'pending' | 'source_confirmed' | 'bridging' | 'completed' | 'failed';
+    sourceTxHash?: string;
+    destTxHash?: string;
+    bridgeName?: string;
+    estimatedRemainingSeconds?: number;
+}
+export interface CrossChainBridgeConfig {
+    /** OnchainOS provider for DEX quotes and cross-chain API. */
+    provider: OnchainOSProvider;
+    /** Logger function. */
+    logger?: Logger;
+}
+export declare class CrossChainBridge {
+    private readonly provider;
+    private readonly logger;
+    constructor(config: CrossChainBridgeConfig);
+    /** Get all chains supported for cross-chain bridging. */
+    getSupportedChains(): Array<{
+        chainIndex: string;
+        name: string;
+        nativeSymbol: string;
+        hasUsdc: boolean;
+    }>;
+    /** Get USDC address on a given chain, or null if not supported. */
+    getUsdcAddress(chainIndex: string): string | null;
+    /** Check if a route is supported (both chains must be in our registry). */
+    isRouteSupported(fromChainIndex: string, toChainIndex: string): boolean;
+    /**
+     * Get a bridge quote for cross-chain transfer.
+     *
+     * Strategy:
+     * 1. Try OnchainOS cross-chain API (aggregated bridges)
+     * 2. If unavailable, compute a two-step route:
+     *    Source chain DEX swap → Bridge via USDC → Dest chain DEX swap
+     */
+    getQuote(params: BridgeQuoteParams): Promise<BridgeQuoteResult>;
+    /**
+     * Get a bridge quote using OnchainOS cross-chain API.
+     * This aggregates multiple bridges (Stargate, Across, Celer, etc.)
+     */
+    private getCrossChainQuote;
+    /**
+     * Get a two-step bridge quote:
+     * 1. Swap source token → USDC on source chain (if needed)
+     * 2. Bridge USDC across chains (estimated)
+     * 3. Swap USDC → target token on dest chain (if needed)
+     */
+    private getTwoStepQuote;
+    /**
+     * Quick bridge: USDC between any two supported chains.
+     * Simplest cross-chain transfer — USDC in, USDC out.
+     */
+    bridgeUsdc(fromChainIndex: string, toChainIndex: string, amount: string, userWalletAddress?: string): Promise<BridgeQuoteResult>;
+    /**
+     * Bridge native token from one chain to another.
+     * e.g. ETH (Base) → OKB (X Layer)
+     */
+    bridgeNative(fromChainIndex: string, toChainIndex: string, amount: string, userWalletAddress?: string): Promise<BridgeQuoteResult>;
+    /**
+     * Get estimated bridge time between two chains (seconds).
+     */
+    getEstimatedTime(fromChainIndex: string, toChainIndex: string): number;
+}
+//# sourceMappingURL=bridge.d.ts.map

package/dist/types/providers/bridge.d.ts.map

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

package/dist/types/providers/onchainos.d.ts

@@ -0,0 +1,128 @@
+/**
+ * OnchainOS API Provider for envoy
+ *
+ * Provides DEX aggregation (400+ DEX sources), gas estimation,
+ * and transaction broadcast via OKX OnchainOS infrastructure.
+ *
+ * This is an OPTIONAL provider — all existing direct viem/Uniswap
+ * flows continue to work unchanged.
+ *
+ * @see https://web3.okx.com/onchainos/dev-docs/trade/dex-api-introduction
+ */
+import { Logger } from '../logger';
+export interface OnchainOSConfig {
+    apiKey: string;
+    secretKey: string;
+    passphrase: string;
+    logger?: Logger;
+}
+export interface DexQuoteParams {
+    chainIndex: string;
+    fromTokenAddress: string;
+    toTokenAddress: string;
+    amount: string;
+    slippagePercent?: string;
+}
+export interface DexSwapParams extends DexQuoteParams {
+    userWalletAddress: string;
+}
+export interface DexQuoteResult {
+    chainIndex: string;
+    fromToken: TokenInfo;
+    toToken: TokenInfo;
+    fromTokenAmount: string;
+    toTokenAmount: string;
+    tradeFee: string;
+    estimateGasFee: string;
+    dexRouterList: DexRoute[];
+    priceImpactPercent: string;
+}
+export interface DexSwapResult {
+    routerResult: DexQuoteResult;
+    tx: {
+        from: string;
+        to: string;
+        data: string;
+        value: string;
+        gas: string;
+        gasPrice: string;
+        minReceiveAmount: string;
+    };
+}
+export interface TokenInfo {
+    tokenContractAddress: string;
+    tokenSymbol: string;
+    tokenUnitPrice: string;
+    decimal: string;
+    isHoneyPot: boolean;
+    taxRate: string;
+}
+export interface DexRoute {
+    dexProtocol: {
+        dexName: string;
+        percent: string;
+    };
+    fromToken: TokenInfo;
+    toToken: TokenInfo;
+}
+export interface SupportedChain {
+    chainIndex: string;
+    chainName: string;
+}
+export interface GasPrice {
+    normal: string;
+    min: string;
+    max: string;
+    suggestGasPrice: string;
+}
+export declare class OnchainOSProvider {
+    private readonly apiKey;
+    private readonly secretKey;
+    private readonly passphrase;
+    private readonly logger;
+    private readonly baseUrl;
+    constructor(config: OnchainOSConfig);
+    private sign;
+    private request;
+    /** Get all chains supported by the DEX aggregator. */
+    getSupportedChains(): Promise<SupportedChain[]>;
+    /**
+     * Get a price quote for a token swap (no calldata — read-only).
+     * Routes through 400+ DEX sources for optimal pricing.
+     */
+    getQuote(params: DexQuoteParams): Promise<DexQuoteResult>;
+    /**
+     * Get swap transaction calldata for execution.
+     * Returns ready-to-sign transaction data.
+     */
+    getSwapData(params: DexSwapParams): Promise<DexSwapResult>;
+    /** Get current gas price for a chain. */
+    getGasPrice(chainIndex: string): Promise<GasPrice>;
+    /**
+     * Get total token balances for an address across a chain.
+     * Uses OnchainOS infrastructure — no direct RPC needed.
+     */
+    getBalances(address: string, chainIndex: string): Promise<Array<{
+        tokenContractAddress: string;
+        symbol: string;
+        balance: string;
+        tokenPrice: string;
+    }>>;
+    /** Get transaction history for an address. */
+    getTxHistory(address: string, chainIndex: string, limit?: string): Promise<unknown[]>;
+    /**
+     * Test API connectivity — returns the number of supported DEX chains.
+     * Useful for verifying credentials at startup.
+     */
+    healthCheck(): Promise<{
+        ok: boolean;
+        chains: number;
+        xlayer: boolean;
+    }>;
+}
+/**
+ * Create an OnchainOS provider from environment variables.
+ * Expects: OKX_API_KEY, OKX_SECRET_KEY, OKX_PASSPHRASE
+ */
+export declare function createOnchainOSFromEnv(logger?: Logger): OnchainOSProvider | null;
+//# sourceMappingURL=onchainos.d.ts.map

package/dist/types/providers/onchainos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onchainos.d.ts","sourceRoot":"","sources":["../../../src/providers/onchainos.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,MAAM,EAAc,MAAM,WAAW,CAAC;AAI/C,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,SAAS,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,QAAQ,EAAE,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,cAAc,CAAC;IAC7B,EAAE,EAAE;QACF,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,SAAS;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;CACzB;AAID,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;gBAEtC,MAAM,EAAE,eAAe;IASnC,OAAO,CAAC,IAAI;YAsBE,OAAO;IA+CrB,sDAAsD;IAChD,kBAAkB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIrD;;;OAGG;IACG,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAW/D;;;OAGG;IACG,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAchE,yCAAyC;IACnC,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAYxD;;;OAGG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,KAAK,CAAC;QAAE,oBAAoB,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IASxG,8CAA8C;IACxC,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,MAAa,GACnB,OAAO,CAAC,OAAO,EAAE,CAAC;IAUrB;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;CAS/E;AAID;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAUhF"}

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

@@ -0,0 +1,51 @@
+/**
+ * EIP-681 — Ethereum Payment URI builder.
+ *
+ * Generates URIs per EIP-681 standard for requesting ETH or ERC-20 payments.
+ * These URIs can be embedded in QR codes or shared as links.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-681
+ *
+ * @example
+ * ```
+ * // Native ETH payment
+ * ethereum:0xABC...?value=1e18
+ *
+ * // ERC-20 USDC transfer
+ * ethereum:0xUSDC_CONTRACT/transfer?address=0xABC...&uint256=500000
+ * ```
+ */
+export interface Eip681Options {
+    /** Recipient address. */
+    to: string;
+    /** Amount in human-readable format (e.g., '0.5'). */
+    amount: string;
+    /** Asset: 'ETH' for native, or ERC-20 contract address. Default: 'ETH'. */
+    asset?: string;
+    /** Chain ID (decimal). Default: 1 (Ethereum mainnet). */
+    chainId?: number;
+    /** Number of decimals for the token. Default: 18 for ETH, 6 for USDC. */
+    decimals?: number;
+}
+/**
+ * Build an EIP-681 payment URI.
+ *
+ * @example
+ * ```ts
+ * // Native ETH
+ * buildEip681Uri({ to: '0xABC...', amount: '1.5' });
+ * // => 'ethereum:0xABC...?value=1500000000000000000'
+ *
+ * // USDC on Base
+ * buildEip681Uri({
+ *   to: '0xABC...',
+ *   amount: '10',
+ *   asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+ *   chainId: 8453,
+ *   decimals: 6,
+ * });
+ * // => 'ethereum:0x833589.../transfer?address=0xABC...&uint256=10000000&chainId=8453'
+ * ```
+ */
+export declare function buildEip681Uri(options: Eip681Options): string;
+//# sourceMappingURL=eip681.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"eip681.d.ts","sourceRoot":"","sources":["../../../src/requests/eip681.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CA2B7D"}

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

@@ -0,0 +1,11 @@
+/**
+ * envoy — Payment Request URIs
+ *
+ * Generate chain-specific payment request URIs for receiving payments.
+ * Supports EIP-681 (EVM), SEP-7 (Stellar), and Solana Pay.
+ */
+export { buildEip681Uri, type Eip681Options } from './eip681';
+export { buildSep7Uri, type Sep7Options } from './sep7';
+export { buildSolanaPayUri, type SolanaPayOptions } from './solana-pay';
+export { buildPaymentUri, type UniversalPaymentUriOptions } from './universal';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/requests/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,KAAK,0BAA0B,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,56 @@
+/**
+ * SEP-7 — Stellar Payment URI builder.
+ *
+ * Generates `web+stellar:` URIs per SEP-0007 for requesting
+ * XLM or custom asset payments on Stellar.
+ *
+ * @see https://github.com/nicohman/sep-0007
+ *
+ * @example
+ * ```
+ * web+stellar:pay?destination=GABCD...&amount=100&asset_code=USDC&asset_issuer=GA5Z...&memo=invoice123
+ * ```
+ */
+export interface Sep7Options {
+    /** Destination Stellar account ID. */
+    destination: string;
+    /** Amount to request (human-readable). */
+    amount: string;
+    /** Asset code: 'XLM' for native, or asset code like 'USDC'. Default: 'XLM'. */
+    assetCode?: string;
+    /** Asset issuer (required for non-native assets). */
+    assetIssuer?: string;
+    /** Optional memo to include. */
+    memo?: string;
+    /** Memo type: 'text', 'id', 'hash'. Default: 'text'. */
+    memoType?: 'text' | 'id' | 'hash';
+    /** Optional callback URL. */
+    callback?: string;
+    /** Optional message to display. */
+    msg?: string;
+    /** Network passphrase. Default: public network. */
+    networkPassphrase?: string;
+    /** Origin domain for signing requests. */
+    originDomain?: string;
+}
+/**
+ * Build a SEP-7 Stellar payment URI.
+ *
+ * @example
+ * ```ts
+ * // Native XLM
+ * buildSep7Uri({ destination: 'GABCD...', amount: '100' });
+ * // => 'web+stellar:pay?destination=GABCD...&amount=100'
+ *
+ * // USDC on Stellar
+ * buildSep7Uri({
+ *   destination: 'GABCD...',
+ *   amount: '50',
+ *   assetCode: 'USDC',
+ *   assetIssuer: 'GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN',
+ *   memo: 'invoice-42',
+ * });
+ * ```
+ */
+export declare function buildSep7Uri(options: Sep7Options): string;
+//# sourceMappingURL=sep7.d.ts.map