envoy-pay 0.1.0

package/dist/esm/providers/bridge.js

@@ -0,0 +1,319 @@
+/**
+ * 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 { noopLogger } from '../logger.js';
+// ─── Chain Constants ────────────────────────────────────────────────
+const CHAIN_INFO = {
+    '42220': { name: 'Celo', nativeSymbol: 'CELO', nativeAddress: '0x471EcE3750Da237f93B8E339c536989b8978a438' },
+    '1': { name: 'Ethereum', nativeSymbol: 'ETH', nativeAddress: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE' },
+    '137': { name: 'Polygon', nativeSymbol: 'MATIC', nativeAddress: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE' },
+    '42161': { name: 'Arbitrum', nativeSymbol: 'ETH', nativeAddress: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE' },
+    '10': { name: 'Optimism', nativeSymbol: 'ETH', nativeAddress: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE' },
+    '8453': { name: 'Base', nativeSymbol: 'ETH', nativeAddress: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE' },
+    '196': { name: 'X Layer', nativeSymbol: 'OKB', nativeAddress: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE' },
+    '56': { name: 'BNB Chain', nativeSymbol: 'BNB', nativeAddress: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE' },
+    '43114': { name: 'Avalanche', nativeSymbol: 'AVAX', nativeAddress: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE' },
+    '501': { name: 'Solana', nativeSymbol: 'SOL', nativeAddress: '11111111111111111111111111111111' },
+};
+/** USDC addresses on chains where we support bridging. */
+const USDC_ADDRESSES = {
+    '42220': '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',
+    '1': '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
+    '137': '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359',
+    '42161': '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
+    '10': '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85',
+    '8453': '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+    '196': '0x74b7f16337b8972027f6196a17a631ac6de26d22',
+};
+export class CrossChainBridge {
+    provider;
+    logger;
+    constructor(config) {
+        this.provider = config.provider;
+        this.logger = config.logger ?? noopLogger;
+    }
+    // ── Supported Routes ────────────────────────────────────────────
+    /** Get all chains supported for cross-chain bridging. */
+    getSupportedChains() {
+        return Object.entries(CHAIN_INFO).map(([chainIndex, info]) => ({
+            chainIndex,
+            name: info.name,
+            nativeSymbol: info.nativeSymbol,
+            hasUsdc: chainIndex in USDC_ADDRESSES,
+        }));
+    }
+    /** Get USDC address on a given chain, or null if not supported. */
+    getUsdcAddress(chainIndex) {
+        return USDC_ADDRESSES[chainIndex] ?? null;
+    }
+    /** Check if a route is supported (both chains must be in our registry). */
+    isRouteSupported(fromChainIndex, toChainIndex) {
+        return fromChainIndex in CHAIN_INFO && toChainIndex in CHAIN_INFO && fromChainIndex !== toChainIndex;
+    }
+    // ── Quote ──────────────────────────────────────────────────────
+    /**
+     * 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
+     */
+    async getQuote(params) {
+        if (!this.isRouteSupported(params.fromChainIndex, params.toChainIndex)) {
+            throw new Error(`Unsupported bridge route: ${params.fromChainIndex} → ${params.toChainIndex}`);
+        }
+        this.logger(`Bridge quote: ${CHAIN_INFO[params.fromChainIndex]?.name} → ${CHAIN_INFO[params.toChainIndex]?.name}`);
+        // Strategy 1: Try OnchainOS cross-chain API
+        try {
+            return await this.getCrossChainQuote(params);
+        }
+        catch (e) {
+            this.logger(`OnchainOS cross-chain unavailable, using two-step route`);
+        }
+        // Strategy 2: Two-step via USDC bridge
+        return this.getTwoStepQuote(params);
+    }
+    /**
+     * Get a bridge quote using OnchainOS cross-chain API.
+     * This aggregates multiple bridges (Stargate, Across, Celer, etc.)
+     */
+    async getCrossChainQuote(params) {
+        // Use the v5 cross-chain API (when available on upgraded plans)
+        const queryParams = {
+            fromChainId: params.fromChainIndex,
+            toChainId: params.toChainIndex,
+            fromTokenAddress: params.fromTokenAddress,
+            toTokenAddress: params.toTokenAddress,
+            amount: params.amount,
+            slippagePercent: params.slippagePercent ?? '1',
+        };
+        if (params.userWalletAddress) {
+            queryParams.userWalletAddress = params.userWalletAddress;
+        }
+        // This calls the OnchainOS cross-chain endpoint
+        // Currently requires upgraded API plan
+        const result = await this.provider.request('GET', '/api/v5/dex/cross-chain/quote', queryParams);
+        const data = Array.isArray(result) ? result[0] : result;
+        return {
+            route: {
+                bridgeName: data.bridgeName ?? 'OnchainOS Bridge',
+                steps: [
+                    {
+                        type: 'bridge',
+                        chainIndex: params.fromChainIndex,
+                        protocol: data.bridgeName ?? 'aggregated',
+                        fromToken: params.fromTokenAddress,
+                        toToken: params.toTokenAddress,
+                        amount: params.amount,
+                    },
+                ],
+                description: `${CHAIN_INFO[params.fromChainIndex]?.name} → ${CHAIN_INFO[params.toChainIndex]?.name} via ${data.bridgeName ?? 'OnchainOS'}`,
+            },
+            toTokenAmount: data.toTokenAmount ?? data.receiveAmount ?? '0',
+            fromToken: {
+                symbol: data.fromToken?.tokenSymbol ?? 'UNKNOWN',
+                decimals: parseInt(data.fromToken?.decimal ?? '18'),
+                address: params.fromTokenAddress,
+            },
+            toToken: {
+                symbol: data.toToken?.tokenSymbol ?? 'UNKNOWN',
+                decimals: parseInt(data.toToken?.decimal ?? '18'),
+                address: params.toTokenAddress,
+            },
+            estimatedFeeUsd: data.estimateFee ?? '0',
+            estimatedTimeSeconds: parseInt(data.estimateTime ?? '300'),
+            minReceiveAmount: data.minReceiveAmount ?? data.receiveAmount ?? '0',
+            tx: data.tx ? {
+                from: data.tx.from,
+                to: data.tx.to,
+                data: data.tx.data,
+                value: data.tx.value ?? '0',
+                gas: data.tx.gas ?? '300000',
+                gasPrice: data.tx.gasPrice ?? '0',
+                chainId: params.fromChainIndex,
+            } : undefined,
+        };
+    }
+    /**
+     * 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)
+     */
+    async getTwoStepQuote(params) {
+        const sourceUsdc = USDC_ADDRESSES[params.fromChainIndex];
+        const destUsdc = USDC_ADDRESSES[params.toChainIndex];
+        const steps = [];
+        let currentAmount = params.amount;
+        let usdcAmount = currentAmount;
+        // Step 1: If source token is NOT USDC, swap to USDC first
+        const isSourceUsdc = params.fromTokenAddress.toLowerCase() === sourceUsdc?.toLowerCase();
+        if (!isSourceUsdc && sourceUsdc) {
+            try {
+                const swapQuote = await this.provider.getQuote({
+                    chainIndex: params.fromChainIndex,
+                    fromTokenAddress: params.fromTokenAddress,
+                    toTokenAddress: sourceUsdc,
+                    amount: currentAmount,
+                });
+                usdcAmount = swapQuote.toTokenAmount;
+                steps.push({
+                    type: 'swap',
+                    chainIndex: params.fromChainIndex,
+                    protocol: swapQuote.dexRouterList?.[0]?.dexProtocol?.dexName ?? 'DEX',
+                    fromToken: params.fromTokenAddress,
+                    toToken: sourceUsdc,
+                    amount: currentAmount,
+                });
+                this.logger(`Step 1: Swap on ${CHAIN_INFO[params.fromChainIndex]?.name}: ${currentAmount} → ${usdcAmount} USDC`);
+            }
+            catch {
+                // If swap quote fails, pass through
+                usdcAmount = currentAmount;
+            }
+        }
+        // Step 2: Bridge USDC across chains
+        steps.push({
+            type: 'bridge',
+            chainIndex: params.fromChainIndex,
+            protocol: 'USDC Native Bridge',
+            fromToken: sourceUsdc ?? params.fromTokenAddress,
+            toToken: destUsdc ?? params.toTokenAddress,
+            amount: usdcAmount,
+        });
+        // Estimate bridge fee (~0.1% + gas)
+        const bridgeFeeRate = 0.001;
+        const afterBridge = Math.floor(Number(usdcAmount) * (1 - bridgeFeeRate)).toString();
+        this.logger(`Step 2: Bridge ${usdcAmount} USDC → ${CHAIN_INFO[params.toChainIndex]?.name}`);
+        // Step 3: If destination token is NOT USDC, swap on destination
+        let finalAmount = afterBridge;
+        const isDestUsdc = params.toTokenAddress.toLowerCase() === destUsdc?.toLowerCase();
+        if (!isDestUsdc && destUsdc) {
+            try {
+                const destSwapQuote = await this.provider.getQuote({
+                    chainIndex: params.toChainIndex,
+                    fromTokenAddress: destUsdc,
+                    toTokenAddress: params.toTokenAddress,
+                    amount: afterBridge,
+                });
+                finalAmount = destSwapQuote.toTokenAmount;
+                steps.push({
+                    type: 'swap',
+                    chainIndex: params.toChainIndex,
+                    protocol: destSwapQuote.dexRouterList?.[0]?.dexProtocol?.dexName ?? 'DEX',
+                    fromToken: destUsdc,
+                    toToken: params.toTokenAddress,
+                    amount: afterBridge,
+                });
+                this.logger(`Step 3: Swap on ${CHAIN_INFO[params.toChainIndex]?.name}: ${afterBridge} USDC → ${finalAmount}`);
+            }
+            catch {
+                finalAmount = afterBridge;
+            }
+        }
+        const fromInfo = CHAIN_INFO[params.fromChainIndex];
+        const toInfo = CHAIN_INFO[params.toChainIndex];
+        return {
+            route: {
+                bridgeName: 'Two-Step Bridge (Swap → Bridge → Swap)',
+                steps,
+                description: `${fromInfo?.name} → USDC Bridge → ${toInfo?.name}`,
+            },
+            toTokenAmount: finalAmount,
+            fromToken: {
+                symbol: isSourceUsdc ? 'USDC' : fromInfo?.nativeSymbol ?? 'UNKNOWN',
+                decimals: isSourceUsdc ? 6 : 18,
+                address: params.fromTokenAddress,
+            },
+            toToken: {
+                symbol: isDestUsdc ? 'USDC' : toInfo?.nativeSymbol ?? 'UNKNOWN',
+                decimals: isDestUsdc ? 6 : 18,
+                address: params.toTokenAddress,
+            },
+            estimatedFeeUsd: (Number(usdcAmount) * bridgeFeeRate / 1e6).toFixed(4),
+            estimatedTimeSeconds: 300, // ~5 minutes typical
+            minReceiveAmount: Math.floor(Number(finalAmount) * 0.99).toString(), // 1% slippage
+        };
+    }
+    // ── Convenience Methods ────────────────────────────────────────
+    /**
+     * Quick bridge: USDC between any two supported chains.
+     * Simplest cross-chain transfer — USDC in, USDC out.
+     */
+    async bridgeUsdc(fromChainIndex, toChainIndex, amount, userWalletAddress) {
+        const fromUsdc = USDC_ADDRESSES[fromChainIndex];
+        const toUsdc = USDC_ADDRESSES[toChainIndex];
+        if (!fromUsdc || !toUsdc) {
+            throw new Error(`USDC not supported on chain ${!fromUsdc ? fromChainIndex : toChainIndex}`);
+        }
+        return this.getQuote({
+            fromChainIndex,
+            toChainIndex,
+            fromTokenAddress: fromUsdc,
+            toTokenAddress: toUsdc,
+            amount,
+            userWalletAddress,
+        });
+    }
+    /**
+     * Bridge native token from one chain to another.
+     * e.g. ETH (Base) → OKB (X Layer)
+     */
+    async bridgeNative(fromChainIndex, toChainIndex, amount, userWalletAddress) {
+        const fromNative = CHAIN_INFO[fromChainIndex]?.nativeAddress;
+        const toNative = CHAIN_INFO[toChainIndex]?.nativeAddress;
+        if (!fromNative || !toNative) {
+            throw new Error(`Chain not supported: ${fromChainIndex} or ${toChainIndex}`);
+        }
+        return this.getQuote({
+            fromChainIndex,
+            toChainIndex,
+            fromTokenAddress: fromNative,
+            toTokenAddress: toNative,
+            amount,
+            userWalletAddress,
+        });
+    }
+    /**
+     * Get estimated bridge time between two chains (seconds).
+     */
+    getEstimatedTime(fromChainIndex, toChainIndex) {
+        // L2 → L2 (and Celo L1-with-fast-finality) is fastest (~2-5 min)
+        const l2s = ['42220', '8453', '42161', '10', '196'];
+        if (l2s.includes(fromChainIndex) && l2s.includes(toChainIndex)) {
+            return 180; // 3 minutes
+        }
+        // L1 → L2 or L2 → L1
+        if (fromChainIndex === '1' || toChainIndex === '1') {
+            return 600; // 10 minutes
+        }
+        return 300; // 5 minutes default
+    }
+}
+//# sourceMappingURL=bridge.js.map

package/dist/esm/providers/bridge.js.map

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

package/dist/esm/providers/onchainos.js

@@ -0,0 +1,172 @@
+/**
+ * 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 * as crypto from 'crypto';
+import * as https from 'https';
+import { noopLogger } from '../logger.js';
+// ─── OnchainOS Provider ────────────────────────────────────────────
+export class OnchainOSProvider {
+    apiKey;
+    secretKey;
+    passphrase;
+    logger;
+    baseUrl = 'https://web3.okx.com';
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.secretKey = config.secretKey;
+        this.passphrase = config.passphrase;
+        this.logger = config.logger ?? noopLogger;
+    }
+    // ── Auth ─────────────────────────────────────────────────────────
+    sign(method, requestPath, queryString = '', body = '') {
+        const timestamp = new Date().toISOString();
+        const preHash = timestamp + method + requestPath + (method === 'GET' ? queryString : body);
+        const signature = crypto
+            .createHmac('sha256', this.secretKey)
+            .update(preHash)
+            .digest('base64');
+        return {
+            'Content-Type': 'application/json',
+            'OK-ACCESS-KEY': this.apiKey,
+            'OK-ACCESS-SIGN': signature,
+            'OK-ACCESS-TIMESTAMP': timestamp,
+            'OK-ACCESS-PASSPHRASE': this.passphrase,
+        };
+    }
+    async request(method, path, params, body) {
+        return new Promise((resolve, reject) => {
+            const queryString = params
+                ? '?' + Object.entries(params).map(([k, v]) => `${k}=${encodeURIComponent(v)}`).join('&')
+                : '';
+            const bodyStr = body ? JSON.stringify(body) : '';
+            const headers = this.sign(method, path, queryString, bodyStr);
+            const options = {
+                hostname: 'web3.okx.com',
+                path: path + (method === 'GET' ? queryString : ''),
+                method,
+                headers,
+            };
+            this.logger(`OnchainOS ${method} ${path}${queryString}`);
+            const req = https.request(options, (res) => {
+                let data = '';
+                res.on('data', (chunk) => (data += chunk));
+                res.on('end', () => {
+                    try {
+                        const parsed = JSON.parse(data);
+                        if (parsed.code === '0') {
+                            resolve(parsed.data);
+                        }
+                        else {
+                            reject(new Error(`OnchainOS API error ${parsed.code}: ${parsed.msg}`));
+                        }
+                    }
+                    catch (e) {
+                        reject(new Error(`OnchainOS parse error: ${data.substring(0, 200)}`));
+                    }
+                });
+            });
+            req.on('error', reject);
+            if (method === 'POST' && bodyStr)
+                req.write(bodyStr);
+            req.end();
+        });
+    }
+    // ── DEX Aggregator ───────────────────────────────────────────────
+    /** Get all chains supported by the DEX aggregator. */
+    async getSupportedChains() {
+        return this.request('GET', '/api/v6/dex/aggregator/supported/chain');
+    }
+    /**
+     * Get a price quote for a token swap (no calldata — read-only).
+     * Routes through 400+ DEX sources for optimal pricing.
+     */
+    async getQuote(params) {
+        const result = await this.request('GET', '/api/v6/dex/aggregator/quote', {
+            chainIndex: params.chainIndex,
+            amount: params.amount,
+            fromTokenAddress: params.fromTokenAddress,
+            toTokenAddress: params.toTokenAddress,
+            ...(params.slippagePercent ? { slippagePercent: params.slippagePercent } : {}),
+        });
+        return result[0]?.routerResult ?? result[0];
+    }
+    /**
+     * Get swap transaction calldata for execution.
+     * Returns ready-to-sign transaction data.
+     */
+    async getSwapData(params) {
+        const result = await this.request('GET', '/api/v6/dex/aggregator/swap', {
+            chainIndex: params.chainIndex,
+            amount: params.amount,
+            fromTokenAddress: params.fromTokenAddress,
+            toTokenAddress: params.toTokenAddress,
+            userWalletAddress: params.userWalletAddress,
+            slippagePercent: params.slippagePercent ?? '0.5',
+        });
+        return result[0];
+    }
+    // ── Gas ──────────────────────────────────────────────────────────
+    /** Get current gas price for a chain. */
+    async getGasPrice(chainIndex) {
+        const result = await this.request('POST', '/api/v6/dex/pre-transaction/gas-price', undefined, { chainIndex });
+        return result[0];
+    }
+    // ── Wallet Balance ───────────────────────────────────────────────
+    /**
+     * Get total token balances for an address across a chain.
+     * Uses OnchainOS infrastructure — no direct RPC needed.
+     */
+    async getBalances(address, chainIndex) {
+        return this.request('GET', '/api/v6/wallet/asset/all-token-balances', {
+            address,
+            chainIndex,
+        });
+    }
+    // ── Tx History ───────────────────────────────────────────────────
+    /** Get transaction history for an address. */
+    async getTxHistory(address, chainIndex, limit = '20') {
+        return this.request('GET', '/api/v6/wallet/post-transaction/transactions-by-address', {
+            address,
+            chainIndex,
+            limit,
+        });
+    }
+    // ── Health Check ─────────────────────────────────────────────────
+    /**
+     * Test API connectivity — returns the number of supported DEX chains.
+     * Useful for verifying credentials at startup.
+     */
+    async healthCheck() {
+        try {
+            const chains = await this.getSupportedChains();
+            const xlayer = chains.some((c) => c.chainIndex === '196');
+            return { ok: true, chains: chains.length, xlayer };
+        }
+        catch {
+            return { ok: false, chains: 0, xlayer: false };
+        }
+    }
+}
+// ─── Factory ───────────────────────────────────────────────────────
+/**
+ * Create an OnchainOS provider from environment variables.
+ * Expects: OKX_API_KEY, OKX_SECRET_KEY, OKX_PASSPHRASE
+ */
+export function createOnchainOSFromEnv(logger) {
+    const apiKey = process.env.OKX_API_KEY;
+    const secretKey = process.env.OKX_SECRET_KEY;
+    const passphrase = process.env.OKX_PASSPHRASE;
+    if (!apiKey || !secretKey || !passphrase) {
+        return null;
+    }
+    return new OnchainOSProvider({ apiKey, secretKey, passphrase, logger });
+}
+//# sourceMappingURL=onchainos.js.map

package/dist/esm/providers/onchainos.js.map

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

package/dist/esm/requests/eip681.js

@@ -0,0 +1,74 @@
+/**
+ * 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
+ * ```
+ */
+/**
+ * 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 function buildEip681Uri(options) {
+    const { to, amount, asset, chainId, decimals } = options;
+    const isNative = !asset || asset === 'ETH' || asset === 'eth';
+    // EIP-681 carries the chain id in the PATH as `@<chainId>` (right after the
+    // target address) — NOT as a query param. A non-standard `?chainId=` is
+    // silently ignored by wallets, which then default to Ethereum mainnet and
+    // prompt to send on the WRONG chain. The `@<chainId>` form is what makes a
+    // Celo (42220) QR actually open as a Celo payment.
+    const chainSuffix = chainId && chainId !== 1 ? `@${chainId}` : '';
+    if (isNative) {
+        // Native: ethereum:<address>[@<chainId>]?value=<wei>
+        const d = decimals ?? 18;
+        const weiAmount = toAtomicUnits(amount, d);
+        const params = new URLSearchParams();
+        params.set('value', weiAmount);
+        return `ethereum:${to}${chainSuffix}?${params.toString()}`;
+    }
+    // ERC-20: ethereum:<token>[@<chainId>]/transfer?address=<recipient>&uint256=<amount>
+    const d = decimals ?? 6;
+    const atomicAmount = toAtomicUnits(amount, d);
+    const params = new URLSearchParams();
+    params.set('address', to);
+    params.set('uint256', atomicAmount);
+    return `ethereum:${asset}${chainSuffix}/transfer?${params.toString()}`;
+}
+/**
+ * Convert a human-readable amount to atomic units.
+ */
+function toAtomicUnits(amount, decimals) {
+    const parts = amount.split('.');
+    const whole = parts[0] || '0';
+    const frac = (parts[1] || '').padEnd(decimals, '0').slice(0, decimals);
+    const combined = whole + frac;
+    // Remove leading zeros
+    return combined.replace(/^0+/, '') || '0';
+}
+//# sourceMappingURL=eip681.js.map

package/dist/esm/requests/eip681.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eip681.js","sourceRoot":"","sources":["../../../src/requests/eip681.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAeH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,cAAc,CAAC,OAAsB;IACnD,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IACzD,MAAM,QAAQ,GAAG,CAAC,KAAK,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,KAAK,CAAC;IAE9D,4EAA4E;IAC5E,wEAAwE;IACxE,0EAA0E;IAC1E,2EAA2E;IAC3E,mDAAmD;IACnD,MAAM,WAAW,GAAG,OAAO,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAElE,IAAI,QAAQ,EAAE,CAAC;QACb,qDAAqD;QACrD,MAAM,CAAC,GAAG,QAAQ,IAAI,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC/B,OAAO,YAAY,EAAE,GAAG,WAAW,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC7D,CAAC;IAED,qFAAqF;IACrF,MAAM,CAAC,GAAG,QAAQ,IAAI,CAAC,CAAC;IACxB,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC1B,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACpC,OAAO,YAAY,KAAK,GAAG,WAAW,aAAa,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,MAAc,EAAE,QAAgB;IACrD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IAC9B,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,KAAK,GAAG,IAAI,CAAC;IAC9B,uBAAuB;IACvB,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;AAC5C,CAAC"}

package/dist/esm/requests/index.js

@@ -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 } from './eip681.js';
+export { buildSep7Uri } from './sep7.js';
+export { buildSolanaPayUri } from './solana-pay.js';
+export { buildPaymentUri } from './universal.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/requests/index.js.map

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