envoy-pay 0.1.0

package/dist/cjs/providers/onchainos.js

@@ -0,0 +1,210 @@
+"use strict";
+/**
+ * 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
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OnchainOSProvider = void 0;
+exports.createOnchainOSFromEnv = createOnchainOSFromEnv;
+const crypto = __importStar(require("crypto"));
+const https = __importStar(require("https"));
+const logger_1 = require("../logger");
+// ─── OnchainOS Provider ────────────────────────────────────────────
+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 ?? logger_1.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 };
+        }
+    }
+}
+exports.OnchainOSProvider = OnchainOSProvider;
+// ─── Factory ───────────────────────────────────────────────────────
+/**
+ * Create an OnchainOS provider from environment variables.
+ * Expects: OKX_API_KEY, OKX_SECRET_KEY, OKX_PASSPHRASE
+ */
+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/cjs/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/cjs/requests/eip681.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * 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
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildEip681Uri = buildEip681Uri;
+/**
+ * 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'
+ * ```
+ */
+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/cjs/requests/eip681.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eip681.js","sourceRoot":"","sources":["../../../src/requests/eip681.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;AAmCH,wCA2BC;AA/CD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,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/cjs/requests/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPaymentUri = exports.buildSolanaPayUri = exports.buildSep7Uri = exports.buildEip681Uri = void 0;
+/**
+ * envoy — Payment Request URIs
+ *
+ * Generate chain-specific payment request URIs for receiving payments.
+ * Supports EIP-681 (EVM), SEP-7 (Stellar), and Solana Pay.
+ */
+var eip681_1 = require("./eip681");
+Object.defineProperty(exports, "buildEip681Uri", { enumerable: true, get: function () { return eip681_1.buildEip681Uri; } });
+var sep7_1 = require("./sep7");
+Object.defineProperty(exports, "buildSep7Uri", { enumerable: true, get: function () { return sep7_1.buildSep7Uri; } });
+var solana_pay_1 = require("./solana-pay");
+Object.defineProperty(exports, "buildSolanaPayUri", { enumerable: true, get: function () { return solana_pay_1.buildSolanaPayUri; } });
+var universal_1 = require("./universal");
+Object.defineProperty(exports, "buildPaymentUri", { enumerable: true, get: function () { return universal_1.buildPaymentUri; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/requests/index.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,mCAA8D;AAArD,wGAAA,cAAc,OAAA;AACvB,+BAAwD;AAA/C,oGAAA,YAAY,OAAA;AACrB,2CAAwE;AAA/D,+GAAA,iBAAiB,OAAA;AAC1B,yCAA+E;AAAtE,4GAAA,eAAe,OAAA"}

package/dist/cjs/requests/sep7.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * 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
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSep7Uri = buildSep7Uri;
+/**
+ * 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',
+ * });
+ * ```
+ */
+function buildSep7Uri(options) {
+    const params = new URLSearchParams();
+    params.set('destination', options.destination);
+    params.set('amount', options.amount);
+    const isNative = !options.assetCode || options.assetCode === 'XLM';
+    if (!isNative) {
+        params.set('asset_code', options.assetCode);
+        if (options.assetIssuer) {
+            params.set('asset_issuer', options.assetIssuer);
+        }
+    }
+    if (options.memo) {
+        params.set('memo', options.memo);
+        params.set('memo_type', options.memoType ?? 'MEMO_TEXT');
+    }
+    if (options.callback)
+        params.set('callback', options.callback);
+    if (options.msg)
+        params.set('msg', options.msg);
+    if (options.networkPassphrase)
+        params.set('network_passphrase', options.networkPassphrase);
+    if (options.originDomain)
+        params.set('origin_domain', options.originDomain);
+    return `web+stellar:pay?${params.toString()}`;
+}
+//# sourceMappingURL=sep7.js.map

package/dist/cjs/requests/sep7.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sep7.js","sourceRoot":"","sources":["../../../src/requests/sep7.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;AA4CH,oCA0BC;AA7CD;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,YAAY,CAAC,OAAoB;IAC/C,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IAErC,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAErC,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,KAAK,KAAK,CAAC;IAEnE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,SAAU,CAAC,CAAC;QAC7C,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,IAAI,WAAW,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ;QAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/D,IAAI,OAAO,CAAC,GAAG;QAAE,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,OAAO,CAAC,iBAAiB;QAAE,MAAM,CAAC,GAAG,CAAC,oBAAoB,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC3F,IAAI,OAAO,CAAC,YAAY;QAAE,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAE5E,OAAO,mBAAmB,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;AAChD,CAAC"}

package/dist/cjs/requests/solana-pay.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * 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
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSolanaPayUri = buildSolanaPayUri;
+/**
+ * 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',
+ * });
+ * ```
+ */
+function buildSolanaPayUri(options) {
+    const params = new URLSearchParams();
+    params.set('amount', options.amount);
+    if (options.splToken)
+        params.set('spl-token', options.splToken);
+    if (options.reference)
+        params.set('reference', options.reference);
+    if (options.label)
+        params.set('label', options.label);
+    if (options.message)
+        params.set('message', options.message);
+    if (options.memo)
+        params.set('memo', options.memo);
+    return `solana:${options.recipient}?${params.toString()}`;
+}
+//# sourceMappingURL=solana-pay.js.map

package/dist/cjs/requests/solana-pay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solana-pay.js","sourceRoot":"","sources":["../../../src/requests/solana-pay.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;AAsCH,8CAYC;AA/BD;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,iBAAiB,CAAC,OAAyB;IACzD,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IAErC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAErC,IAAI,OAAO,CAAC,QAAQ;QAAE,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChE,IAAI,OAAO,CAAC,SAAS;QAAE,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAClE,IAAI,OAAO,CAAC,KAAK;QAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACtD,IAAI,OAAO,CAAC,OAAO;QAAE,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,IAAI,OAAO,CAAC,IAAI;QAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD,OAAO,UAAU,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;AAC5D,CAAC"}

package/dist/cjs/requests/universal.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPaymentUri = buildPaymentUri;
+/**
+ * Universal Payment URI builder — auto-detects chain and generates
+ * the appropriate payment URI format.
+ */
+const eip681_1 = require("./eip681");
+const sep7_1 = require("./sep7");
+const solana_pay_1 = require("./solana-pay");
+/**
+ * Build a payment URI for any supported chain.
+ *
+ * @example
+ * ```ts
+ * const uri = buildPaymentUri({
+ *   chain: 'evm',
+ *   evm: { to: '0x...', amount: '0.5', chainId: 8453 },
+ * });
+ * ```
+ */
+function buildPaymentUri(options) {
+    switch (options.chain) {
+        case 'evm':
+            if (!options.evm)
+                throw new Error('EVM options required for chain=evm');
+            return (0, eip681_1.buildEip681Uri)(options.evm);
+        case 'stellar':
+            if (!options.stellar)
+                throw new Error('Stellar options required for chain=stellar');
+            return (0, sep7_1.buildSep7Uri)(options.stellar);
+        case 'solana':
+            if (!options.solana)
+                throw new Error('Solana options required for chain=solana');
+            return (0, solana_pay_1.buildSolanaPayUri)(options.solana);
+        default:
+            throw new Error(`Unsupported chain: ${options.chain}`);
+    }
+}
+//# sourceMappingURL=universal.js.map

package/dist/cjs/requests/universal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"universal.js","sourceRoot":"","sources":["../../../src/requests/universal.ts"],"names":[],"mappings":";;AA4BA,0CAcC;AA1CD;;;GAGG;AACH,qCAA8D;AAC9D,iCAAwD;AACxD,6CAAwE;AAWxE;;;;;;;;;;GAUG;AACH,SAAgB,eAAe,CAAC,OAAmC;IACjE,QAAQ,OAAO,CAAC,KAAK,EAAE,CAAC;QACtB,KAAK,KAAK;YACR,IAAI,CAAC,OAAO,CAAC,GAAG;gBAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;YACxE,OAAO,IAAA,uBAAc,EAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,KAAK,SAAS;YACZ,IAAI,CAAC,OAAO,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;YACpF,OAAO,IAAA,mBAAY,EAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvC,KAAK,QAAQ;YACX,IAAI,CAAC,OAAO,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;YACjF,OAAO,IAAA,8BAAiB,EAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC3C;YACE,MAAM,IAAI,KAAK,CAAC,sBAAsB,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC"}

package/dist/cjs/server/index.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildReceipt = exports.createWebhookHandler = exports.createPaymentGate = exports.createMppGate = exports.createX402Gate = void 0;
+/**
+ * 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' }); }
+ * );
+ * ```
+ */
+var x402_gate_1 = require("./x402-gate");
+Object.defineProperty(exports, "createX402Gate", { enumerable: true, get: function () { return x402_gate_1.createX402Gate; } });
+var mpp_gate_1 = require("./mpp-gate");
+Object.defineProperty(exports, "createMppGate", { enumerable: true, get: function () { return mpp_gate_1.createMppGate; } });
+var payment_gate_1 = require("./payment-gate");
+Object.defineProperty(exports, "createPaymentGate", { enumerable: true, get: function () { return payment_gate_1.createPaymentGate; } });
+var webhook_1 = require("./webhook");
+Object.defineProperty(exports, "createWebhookHandler", { enumerable: true, get: function () { return webhook_1.createWebhookHandler; } });
+var receipt_1 = require("./receipt");
+Object.defineProperty(exports, "buildReceipt", { enumerable: true, get: function () { return receipt_1.buildReceipt; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,yCAAkF;AAAzE,2GAAA,cAAc,OAAA;AACvB,uCAA+D;AAAtD,yGAAA,aAAa,OAAA;AACtB,+CAA2E;AAAlE,iHAAA,iBAAiB,OAAA;AAC1B,qCAAqE;AAA5D,+GAAA,oBAAoB,OAAA;AAC7B,qCAAmF;AAA1E,uGAAA,YAAY,OAAA"}

package/dist/cjs/server/mpp-gate.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMppGate = createMppGate;
+const logger_1 = require("../logger");
+let challengeCounter = 0;
+/**
+ * Generate a unique challenge ID.
+ */
+function generateChallengeId() {
+    challengeCounter++;
+    return `ch_${Date.now()}_${challengeCounter}`;
+}
+/**
+ * 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);
+ * ```
+ */
+function createMppGate(config) {
+    const log = config.logger ?? logger_1.noopLogger;
+    const intent = config.intent ?? 'payment';
+    const currency = config.currency ?? 'usd';
+    const decimals = config.decimals ?? 2;
+    const ttlMs = config.ttlMs ?? 300000;
+    return async (req, res, next) => {
+        // Check for Authorization: Payment header
+        const authHeader = req.headers['authorization'];
+        if (!authHeader || !authHeader.startsWith('Payment ')) {
+            // No credential — return 402 with WWW-Authenticate challenge
+            log('[mpp-gate] 💰 No Authorization: Payment — returning 402 challenge');
+            const challengeId = generateChallengeId();
+            const expires = new Date(Date.now() + ttlMs).toISOString();
+            const requestObj = {
+                amount: config.amount,
+                currency,
+                decimals,
+                recipient: config.recipient,
+            };
+            const requestEncoded = Buffer.from(JSON.stringify(requestObj))
+                .toString('base64')
+                .replace(/\+/g, '-')
+                .replace(/\//g, '_')
+                .replace(/=+$/, '');
+            const challengeStr = `Payment id="${challengeId}",realm="${config.realm}",method="${config.method}",intent="${intent}",request="${requestEncoded}",expires="${expires}"`;
+            res.writeHead(402, {
+                'WWW-Authenticate': challengeStr,
+                'Content-Type': 'text/plain',
+            });
+            res.end('Payment Required');
+            return;
+        }
+        // Decode Payment credential
+        try {
+            const credentialBase64 = authHeader.slice('Payment '.length);
+            // Re-add base64 padding
+            const padded = credentialBase64
+                .replace(/-/g, '+')
+                .replace(/_/g, '/');
+            const decoded = Buffer.from(padded, 'base64').toString('utf-8');
+            const credential = JSON.parse(decoded);
+            // Validate credential structure
+            if (!credential.challenge?.id || !credential.payload?.transaction) {
+                log('[mpp-gate] ❌ Malformed credential');
+                res.writeHead(400, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: 'Malformed payment credential' }));
+                return;
+            }
+            // Check realm matches
+            if (credential.challenge.realm !== config.realm) {
+                log('[mpp-gate] ❌ Realm mismatch');
+                res.writeHead(403, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: 'Challenge realm mismatch' }));
+                return;
+            }
+            // Check expiration
+            if (credential.challenge.expires) {
+                const expiresAt = new Date(credential.challenge.expires).getTime();
+                if (Date.now() > expiresAt) {
+                    log('[mpp-gate] ❌ Challenge expired');
+                    res.writeHead(402, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: 'Challenge expired' }));
+                    return;
+                }
+            }
+            // Custom verification
+            if (config.verifyCredential) {
+                const isValid = await config.verifyCredential(credential, credential.challenge.id);
+                if (!isValid) {
+                    log('[mpp-gate] ❌ Credential verification failed');
+                    res.writeHead(402, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: 'Payment verification failed' }));
+                    return;
+                }
+            }
+            // Attach credential to request
+            req.mppPayment = credential;
+            log(`[mpp-gate] ✅ Payment verified: tx=${credential.payload.transaction.slice(0, 16)}…`);
+            next();
+        }
+        catch (err) {
+            log(`[mpp-gate] ❌ Failed to decode credential: ${err.message}`);
+            res.writeHead(400, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'Invalid Authorization: Payment header' }));
+        }
+    };
+}
+//# sourceMappingURL=mpp-gate.js.map