@3rd-eye-labs/openmm 0.1.0 → 0.1.3

package/dist/x402/crypto.js

@@ -0,0 +1,300 @@
+"use strict";
+/**
+ * OpenMM x402 Cryptographic Utilities
+ * Pure Node.js crypto implementations for EVM signing.
+ * No external dependencies required.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.keccak256 = keccak256;
+exports.signSecp256k1 = signSecp256k1;
+exports.encryptKey = encryptKey;
+exports.decryptKey = decryptKey;
+exports.hashPassword = hashPassword;
+exports.verifyPassword = verifyPassword;
+exports.generatePrivateKey = generatePrivateKey;
+exports.privateKeyToEvmAddress = privateKeyToEvmAddress;
+exports.generateSolanaKeypair = generateSolanaKeypair;
+exports.base58Encode = base58Encode;
+const crypto_1 = __importDefault(require("crypto"));
+/**
+ * Compute keccak256 hash (Ethereum's version of SHA3-256).
+ * Uses Node.js crypto which supports keccak256 natively.
+ */
+function keccak256(data) {
+    return crypto_1.default.createHash('sha3-256').update(data).digest();
+}
+/**
+ * Sign a message hash with secp256k1 private key.
+ * Returns { r, s, v } where v is recovery id (0 or 1).
+ */
+function signSecp256k1(msgHash, privateKey) {
+    // Use Node.js ECDH to get the public key for recovery
+    const ecdh = crypto_1.default.createECDH('secp256k1');
+    ecdh.setPrivateKey(privateKey);
+    const publicKey = ecdh.getPublicKey(null, 'uncompressed');
+    // Sign the message
+    const sign = crypto_1.default.createSign('sha256');
+    sign.update(msgHash);
+    sign.end();
+    // Node.js sign() with ECDSA returns DER-encoded signature
+    // We need to extract r and s from it
+    const derSig = sign.sign({ key: privateKeyToPem(privateKey), dsaEncoding: 'der' });
+    // Parse DER signature to get r and s
+    const { r, s } = parseDerSignature(derSig);
+    // Normalize s to low-S form (required by Ethereum)
+    const secp256k1N = BigInt('0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141');
+    const halfN = secp256k1N / 2n;
+    let sBigInt = BigInt('0x' + s.toString('hex'));
+    let sNormalized = s;
+    if (sBigInt > halfN) {
+        sBigInt = secp256k1N - sBigInt;
+        sNormalized = Buffer.from(sBigInt.toString(16).padStart(64, '0'), 'hex');
+    }
+    // Determine recovery id by trying both values
+    const v = recoverV(msgHash, r, sNormalized, publicKey);
+    return { r, s: sNormalized, v };
+}
+/**
+ * Convert raw private key to PEM format for Node.js crypto.
+ */
+function privateKeyToPem(privateKey) {
+    // Create SEC1 EC private key DER structure
+    const ecdh = crypto_1.default.createECDH('secp256k1');
+    ecdh.setPrivateKey(privateKey);
+    // Use Node.js KeyObject API
+    const keyObject = crypto_1.default.createPrivateKey({
+        key: {
+            kty: 'EC',
+            crv: 'secp256k1',
+            d: privateKey.toString('base64url'),
+            x: ecdh.getPublicKey().subarray(1, 33).toString('base64url'),
+            y: ecdh.getPublicKey().subarray(33, 65).toString('base64url'),
+        },
+        format: 'jwk',
+    });
+    return keyObject.export({ type: 'pkcs8', format: 'pem' });
+}
+/**
+ * Parse DER-encoded ECDSA signature to extract r and s values.
+ */
+function parseDerSignature(der) {
+    // DER: 30 <len> 02 <r-len> <r> 02 <s-len> <s>
+    let offset = 2; // Skip SEQUENCE header
+    // Read r
+    if (der[offset] !== 0x02)
+        throw new Error('Invalid DER signature');
+    offset++;
+    const rLen = der[offset];
+    offset++;
+    let r = der.subarray(offset, offset + rLen);
+    offset += rLen;
+    // Read s
+    if (der[offset] !== 0x02)
+        throw new Error('Invalid DER signature');
+    offset++;
+    const sLen = der[offset];
+    offset++;
+    let s = der.subarray(offset, offset + sLen);
+    // Remove leading zeros if present (DER may add 0x00 prefix for positive numbers)
+    if (r.length === 33 && r[0] === 0x00)
+        r = r.subarray(1);
+    if (s.length === 33 && s[0] === 0x00)
+        s = s.subarray(1);
+    // Pad to 32 bytes if needed
+    if (r.length < 32)
+        r = Buffer.concat([Buffer.alloc(32 - r.length), r]);
+    if (s.length < 32)
+        s = Buffer.concat([Buffer.alloc(32 - s.length), s]);
+    return { r, s };
+}
+/**
+ * Determine the recovery id (v) by verifying which value recovers the correct public key.
+ */
+function recoverV(msgHash, r, s, expectedPubKey) {
+    // Try v=0 and v=1, see which recovers the correct public key
+    // For simplicity, we'll use a mathematical approach based on Y parity
+    // The recovery id is based on the Y coordinate of the signature point
+    // For Ethereum, v is typically 0 or 1 (added to 27 for legacy reasons)
+    // Extract Y coordinate from the expected public key
+    const yCoord = expectedPubKey.subarray(33, 65);
+    const yBigInt = BigInt('0x' + yCoord.toString('hex'));
+    // If Y is even, v = 0; if odd, v = 1
+    return yBigInt % 2n === 0n ? 0 : 1;
+}
+// ============= Encryption for Wallet Storage =============
+const SCRYPT_N = 131072;
+const SCRYPT_R = 8;
+const SCRYPT_P = 1;
+const SCRYPT_KEYLEN = 32;
+const SALT_LEN = 16;
+const IV_LEN = 12;
+/**
+ * Derive encryption key from password using scrypt.
+ */
+function deriveKey(password, salt) {
+    return crypto_1.default.scryptSync(password, salt, SCRYPT_KEYLEN, {
+        N: SCRYPT_N,
+        r: SCRYPT_R,
+        p: SCRYPT_P,
+        maxmem: 256 * 1024 * 1024,
+    });
+}
+/**
+ * Encrypt a private key with a password.
+ */
+function encryptKey(privateKeyHex, password) {
+    if (password === null) {
+        return { data: privateKeyHex, encrypted: false };
+    }
+    const salt = crypto_1.default.randomBytes(SALT_LEN);
+    const iv = crypto_1.default.randomBytes(IV_LEN);
+    const key = deriveKey(password, salt);
+    const cipher = crypto_1.default.createCipheriv('aes-256-gcm', key, iv);
+    const encrypted = Buffer.concat([cipher.update(privateKeyHex, 'utf8'), cipher.final()]);
+    const authTag = cipher.getAuthTag();
+    return {
+        cipher: 'aes-256-gcm',
+        kdf: 'scrypt',
+        kdfParams: { N: SCRYPT_N, r: SCRYPT_R, p: SCRYPT_P },
+        salt: salt.toString('hex'),
+        iv: iv.toString('hex'),
+        authTag: authTag.toString('hex'),
+        ciphertext: encrypted.toString('hex'),
+    };
+}
+/**
+ * Decrypt a private key with a password.
+ */
+function decryptKey(encryptedData, password) {
+    const ENCRYPTED_FIELDS = ['salt', 'iv', 'authTag', 'ciphertext'];
+    const hasEncryptionFields = ENCRYPTED_FIELDS.some(f => f in encryptedData);
+    // Unencrypted blob
+    if (encryptedData.encrypted === false) {
+        if (hasEncryptionFields) {
+            throw new Error('Wallet data corrupted or tampered');
+        }
+        return encryptedData.data;
+    }
+    // Encrypted blob with missing fields
+    if (!ENCRYPTED_FIELDS.every(f => f in encryptedData)) {
+        throw new Error('Wallet data corrupted or tampered');
+    }
+    // Encrypted blob but no password provided
+    if (password === null || password === undefined) {
+        throw new Error('Wallet is encrypted. Set OPENMM_WALLET_PASSWORD.');
+    }
+    const salt = Buffer.from(encryptedData.salt, 'hex');
+    const iv = Buffer.from(encryptedData.iv, 'hex');
+    const authTag = Buffer.from(encryptedData.authTag, 'hex');
+    const ciphertext = Buffer.from(encryptedData.ciphertext, 'hex');
+    const key = deriveKey(password, salt);
+    const decipher = crypto_1.default.createDecipheriv('aes-256-gcm', key, iv);
+    decipher.setAuthTag(authTag);
+    try {
+        const decrypted = Buffer.concat([decipher.update(ciphertext), decipher.final()]);
+        return decrypted.toString('utf8');
+    }
+    catch {
+        throw new Error('Incorrect password');
+    }
+}
+/**
+ * Hash a password for verification (not encryption).
+ */
+function hashPassword(password) {
+    const salt = crypto_1.default.randomBytes(16);
+    const hash = crypto_1.default.scryptSync(password, salt, 32, {
+        N: SCRYPT_N,
+        r: SCRYPT_R,
+        p: SCRYPT_P,
+        maxmem: 256 * 1024 * 1024,
+    });
+    return { salt: salt.toString('hex'), hash: hash.toString('hex') };
+}
+/**
+ * Verify a password against stored hash.
+ */
+function verifyPassword(password, storedHash) {
+    const derived = crypto_1.default.scryptSync(password, Buffer.from(storedHash.salt, 'hex'), 32, {
+        N: SCRYPT_N,
+        r: SCRYPT_R,
+        p: SCRYPT_P,
+        maxmem: 256 * 1024 * 1024,
+    });
+    return crypto_1.default.timingSafeEqual(derived, Buffer.from(storedHash.hash, 'hex'));
+}
+/**
+ * Generate a random 32-byte private key.
+ */
+function generatePrivateKey() {
+    return crypto_1.default.randomBytes(32);
+}
+/**
+ * Derive EVM address from private key.
+ */
+function privateKeyToEvmAddress(privateKey) {
+    // Derive public key (uncompressed, 65 bytes: 0x04 + x + y)
+    const ecdh = crypto_1.default.createECDH('secp256k1');
+    ecdh.setPrivateKey(privateKey);
+    const publicKey = ecdh.getPublicKey(null, 'uncompressed');
+    // Address = last 20 bytes of keccak256(publicKey without 0x04 prefix)
+    const hash = keccak256(publicKey.subarray(1));
+    const addressBytes = hash.subarray(12);
+    const addressHex = addressBytes.toString('hex');
+    // EIP-55 checksum
+    const addressHash = keccak256(Buffer.from(addressHex, 'utf8')).toString('hex');
+    let checksummed = '0x';
+    for (let i = 0; i < 40; i++) {
+        checksummed += parseInt(addressHash[i], 16) >= 8 ? addressHex[i].toUpperCase() : addressHex[i];
+    }
+    return checksummed;
+}
+/**
+ * Generate Ed25519 keypair for Solana.
+ */
+function generateSolanaKeypair() {
+    const { publicKey, privateKey } = crypto_1.default.generateKeyPairSync('ed25519', {
+        publicKeyEncoding: { type: 'spki', format: 'der' },
+        privateKeyEncoding: { type: 'pkcs8', format: 'der' },
+    });
+    // Extract raw 32-byte keys from DER encoding
+    const rawPrivate = privateKey.subarray(privateKey.length - 32);
+    const rawPublic = publicKey.subarray(publicKey.length - 32);
+    // Solana keypair format: 64 bytes = private seed (32) + public key (32)
+    const keypair = Buffer.concat([rawPrivate, rawPublic]);
+    return { privateKey: keypair, publicKey: rawPublic };
+}
+// ============= Base58 for Solana addresses =============
+const BASE58_ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+/**
+ * Encode buffer to Base58 string (for Solana addresses).
+ */
+function base58Encode(buffer) {
+    const bytes = [...buffer];
+    const digits = [0];
+    for (const byte of bytes) {
+        let carry = byte;
+        for (let j = 0; j < digits.length; j++) {
+            carry += digits[j] << 8;
+            digits[j] = carry % 58;
+            carry = Math.floor(carry / 58);
+        }
+        while (carry > 0) {
+            digits.push(carry % 58);
+            carry = Math.floor(carry / 58);
+        }
+    }
+    // Handle leading zeros
+    let leadingZeros = '';
+    for (const byte of bytes) {
+        if (byte === 0)
+            leadingZeros += '1';
+        else
+            break;
+    }
+    return leadingZeros + digits.reverse().map(d => BASE58_ALPHABET[d]).join('');
+}
+//# sourceMappingURL=crypto.js.map

package/dist/x402/crypto.js.map

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

package/dist/x402/evm.d.ts

@@ -0,0 +1,41 @@
+/**
+ * OpenMM x402 EVM Auto-Payment
+ * Implements EIP-3009 TransferWithAuthorization via EIP-712 typed data signing.
+ * Pure Node.js implementation — no external dependencies.
+ */
+import type { PaymentRequirement, EIP712Domain } from './types';
+interface TypeField {
+    name: string;
+    type: string;
+}
+/**
+ * Compute EIP-712 final hash: keccak256("\x19\x01" || domainSeparator || structHash)
+ */
+export declare function hashTypedData(domain: EIP712Domain, primaryType: string, fields: TypeField[], message: Record<string, unknown>): Buffer;
+/**
+ * Check if a network string is an EVM network.
+ */
+export declare function isEvmNetwork(network: string): boolean;
+/**
+ * Create an x402 payment payload for EVM (EIP-3009 TransferWithAuthorization).
+ *
+ * @param requirements - Parsed PaymentRequirements from 402 response
+ * @param privateKeyHex - 32-byte EVM private key as hex
+ * @param walletAddress - Signer's EVM address
+ * @param resource - Original request URL
+ * @returns Base64-encoded PaymentPayload for Payment-Signature header
+ */
+export declare function createEvmPaymentPayload(requirements: PaymentRequirement, privateKeyHex: string, walletAddress: string, resource: string): string;
+/**
+ * Check USDC balance on Base network.
+ *
+ * @param address - EVM address to check
+ * @returns Balance in USD (number) or null if check fails
+ */
+export declare function checkEvmBalance(address: string): Promise<number | null>;
+/**
+ * Get Base network RPC URL.
+ */
+export declare function getBaseRpcUrl(): string;
+export {};
+//# sourceMappingURL=evm.d.ts.map

package/dist/x402/evm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evm.d.ts","sourceRoot":"","sources":["../../src/x402/evm.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EAGb,MAAM,SAAS,CAAC;AAIjB,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AA0GD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,EAAE,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAKR;AAcD;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,kBAAkB,EAChC,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,MAAM,CAwER;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwB7E;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/x402/evm.js

@@ -0,0 +1,229 @@
+"use strict";
+/**
+ * OpenMM x402 EVM Auto-Payment
+ * Implements EIP-3009 TransferWithAuthorization via EIP-712 typed data signing.
+ * Pure Node.js implementation — no external dependencies.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hashTypedData = hashTypedData;
+exports.isEvmNetwork = isEvmNetwork;
+exports.createEvmPaymentPayload = createEvmPaymentPayload;
+exports.checkEvmBalance = checkEvmBalance;
+exports.getBaseRpcUrl = getBaseRpcUrl;
+const crypto_1 = __importDefault(require("crypto"));
+const crypto_2 = require("./crypto");
+const DOMAIN_TYPES = [
+    { name: 'name', type: 'string' },
+    { name: 'version', type: 'string' },
+    { name: 'chainId', type: 'uint256' },
+    { name: 'verifyingContract', type: 'address' },
+];
+const AUTHORIZATION_TYPES = [
+    { name: 'from', type: 'address' },
+    { name: 'to', type: 'address' },
+    { name: 'value', type: 'uint256' },
+    { name: 'validAfter', type: 'uint256' },
+    { name: 'validBefore', type: 'uint256' },
+    { name: 'nonce', type: 'bytes32' },
+];
+/**
+ * Encode a type string for EIP-712 typeHash.
+ */
+function encodeType(typeName, fields) {
+    const fieldStrs = fields.map(f => `${f.type} ${f.name}`);
+    return `${typeName}(${fieldStrs.join(',')})`;
+}
+/**
+ * Compute typeHash = keccak256(encodeType(...))
+ */
+function typeHash(typeName, fields) {
+    return (0, crypto_2.keccak256)(Buffer.from(encodeType(typeName, fields), 'utf8'));
+}
+/**
+ * ABI-encode a single value to 32 bytes based on its EIP-712 type.
+ */
+function encodeValue(fieldType, value) {
+    if (fieldType === 'string') {
+        // Strings are hashed
+        return (0, crypto_2.keccak256)(Buffer.from(value, 'utf8'));
+    }
+    if (fieldType === 'bytes') {
+        const buf = typeof value === 'string'
+            ? Buffer.from(value.replace(/^0x/, ''), 'hex')
+            : value;
+        return (0, crypto_2.keccak256)(buf);
+    }
+    if (fieldType === 'bytes32') {
+        if (typeof value === 'string') {
+            return Buffer.from(value.replace(/^0x/, ''), 'hex');
+        }
+        return value;
+    }
+    if (fieldType === 'address') {
+        // Left-pad address to 32 bytes
+        const addr = value.replace(/^0x/, '').toLowerCase();
+        return Buffer.from(addr.padStart(64, '0'), 'hex');
+    }
+    if (fieldType.startsWith('uint') || fieldType.startsWith('int')) {
+        // Encode as 32-byte big-endian
+        const hex = BigInt(value)
+            .toString(16)
+            .padStart(64, '0');
+        return Buffer.from(hex, 'hex');
+    }
+    if (fieldType === 'bool') {
+        return Buffer.from((value ? '1' : '0').padStart(64, '0'), 'hex');
+    }
+    throw new Error(`Unsupported EIP-712 field type: ${fieldType}`);
+}
+/**
+ * Compute struct hash = keccak256(typeHash || encodeValue(field1) || ...)
+ */
+function hashStruct(typeName, fields, data) {
+    const parts = [typeHash(typeName, fields)];
+    for (const field of fields) {
+        const value = data[field.name];
+        if (value === undefined || value === null) {
+            throw new Error(`Missing EIP-712 field: ${field.name}`);
+        }
+        parts.push(encodeValue(field.type, value));
+    }
+    return (0, crypto_2.keccak256)(Buffer.concat(parts));
+}
+/**
+ * Compute EIP-712 domain separator hash.
+ */
+function hashDomain(domain) {
+    return hashStruct('EIP712Domain', DOMAIN_TYPES, domain);
+}
+/**
+ * Compute EIP-712 final hash: keccak256("\x19\x01" || domainSeparator || structHash)
+ */
+function hashTypedData(domain, primaryType, fields, message) {
+    const domainSeparator = hashDomain(domain);
+    const structHash = hashStruct(primaryType, fields, message);
+    return (0, crypto_2.keccak256)(Buffer.concat([Buffer.from([0x19, 0x01]), domainSeparator, structHash]));
+}
+// ============= x402 EVM Payment =============
+/**
+ * Extract chain ID from CAIP-2 network identifier.
+ * e.g., "eip155:8453" → 8453
+ */
+function getChainId(network) {
+    const match = network.match(/^eip155:(\d+)$/);
+    if (!match)
+        throw new Error(`Invalid EVM network: ${network}`);
+    return parseInt(match[1], 10);
+}
+/**
+ * Check if a network string is an EVM network.
+ */
+function isEvmNetwork(network) {
+    return typeof network === 'string' && network.startsWith('eip155:');
+}
+/**
+ * Create an x402 payment payload for EVM (EIP-3009 TransferWithAuthorization).
+ *
+ * @param requirements - Parsed PaymentRequirements from 402 response
+ * @param privateKeyHex - 32-byte EVM private key as hex
+ * @param walletAddress - Signer's EVM address
+ * @param resource - Original request URL
+ * @returns Base64-encoded PaymentPayload for Payment-Signature header
+ */
+function createEvmPaymentPayload(requirements, privateKeyHex, walletAddress, resource) {
+    const chainId = getChainId(requirements.network);
+    const extra = requirements.extra || {};
+    // Token name and version from requirements.extra (set by server/facilitator)
+    const tokenName = extra.name;
+    const tokenVersion = extra.version || '1';
+    if (!tokenName) {
+        throw new Error('EIP-712 domain name missing from requirements.extra');
+    }
+    // Generate random nonce (32 bytes)
+    const nonce = '0x' + crypto_1.default.randomBytes(32).toString('hex');
+    // Validity window: valid now, expires in 1 hour
+    const now = Math.floor(Date.now() / 1000);
+    const validAfter = '0';
+    const validBefore = String(now + 3600);
+    // EIP-712 domain
+    const domain = {
+        name: tokenName,
+        version: tokenVersion,
+        chainId,
+        verifyingContract: requirements.asset,
+    };
+    // EIP-3009 message
+    const message = {
+        from: walletAddress,
+        to: requirements.payTo || requirements.pay_to || '',
+        value: BigInt(requirements.amount),
+        validAfter: BigInt(validAfter),
+        validBefore: BigInt(validBefore),
+        nonce,
+    };
+    // Hash and sign
+    const msgHash = hashTypedData(domain, 'TransferWithAuthorization', AUTHORIZATION_TYPES, message);
+    const { r, s, v } = (0, crypto_2.signSecp256k1)(msgHash, Buffer.from(privateKeyHex, 'hex'));
+    const signature = '0x' + r.toString('hex') + s.toString('hex') + (27 + v).toString(16);
+    // Build payload (camelCase keys per x402 spec)
+    const payload = {
+        x402Version: 2,
+        payload: {
+            authorization: {
+                from: walletAddress,
+                to: message.to,
+                value: String(requirements.amount),
+                validAfter: validAfter,
+                validBefore: validBefore,
+                nonce: nonce,
+            },
+            signature: signature,
+        },
+        accepted: requirements,
+    };
+    // Add resource if provided
+    if (resource) {
+        payload.resource = { url: resource };
+    }
+    return Buffer.from(JSON.stringify(payload)).toString('base64');
+}
+/**
+ * Check USDC balance on Base network.
+ *
+ * @param address - EVM address to check
+ * @returns Balance in USD (number) or null if check fails
+ */
+async function checkEvmBalance(address) {
+    try {
+        // Base USDC contract address
+        const USDC_BASE = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913';
+        const addr = address.replace('0x', '').toLowerCase().padStart(64, '0');
+        const response = await fetch('https://mainnet.base.org', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                jsonrpc: '2.0',
+                id: 1,
+                method: 'eth_call',
+                params: [{ to: USDC_BASE, data: `0x70a08231${addr}` }, 'latest'],
+            }),
+        });
+        const data = (await response.json());
+        if (!data.result)
+            return null;
+        return parseInt(data.result, 16) / 1e6;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get Base network RPC URL.
+ */
+function getBaseRpcUrl() {
+    return process.env.OPENMM_BASE_RPC || 'https://mainnet.base.org';
+}
+//# sourceMappingURL=evm.js.map

package/dist/x402/evm.js.map

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

package/dist/x402/handler.d.ts

@@ -0,0 +1,53 @@
+/**
+ * OpenMM x402 Auto-Payment Handler
+ * Detects 402 responses and auto-signs payment using local wallet.
+ */
+import type { PaymentRequirement, X402FetchOptions, X402BalanceResult } from './types';
+/**
+ * Parse PaymentRequirements from a 402 response.
+ */
+export declare function parsePaymentRequirements(response: Response): PaymentRequirement[] | null;
+/**
+ * Generate payment signatures for all viable payment options, in priority order.
+ * Yields { signature, network } objects. Caller should try each until one succeeds.
+ */
+export declare function createPaymentSignatures(response: Response, url: string, options?: {
+    password?: string;
+    walletName?: string;
+}): AsyncGenerator<{
+    signature: string;
+    network: string;
+}>;
+/**
+ * Attempt to auto-pay a 402 response (single-shot, returns first viable signature).
+ */
+export declare function createPaymentSignature(response: Response, url: string, options?: {
+    password?: string;
+    walletName?: string;
+}): Promise<string | null>;
+/**
+ * Check x402 payment wallet balance.
+ */
+export declare function checkX402Balance(network: string): Promise<X402BalanceResult | null>;
+/**
+ * Wrapper for fetch that handles x402 auto-payment.
+ *
+ * When a request returns HTTP 402:
+ * 1. Parses payment requirements from Payment-Required header
+ * 2. Signs payment using local wallet
+ * 3. Retries request with Payment-Signature header
+ */
+export declare function x402Fetch(url: string, options?: X402FetchOptions): Promise<Response>;
+/**
+ * Format payment requirements for display.
+ */
+export declare function formatPaymentRequirements(requirements: PaymentRequirement[]): string;
+/**
+ * Check if a response is a 402 payment required.
+ */
+export declare function isPaymentRequired(response: Response): boolean;
+/**
+ * Get supported payment networks from requirements.
+ */
+export declare function getSupportedNetworks(requirements: PaymentRequirement[]): string[];
+//# sourceMappingURL=handler.d.ts.map

package/dist/x402/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/x402/handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAEhB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,GAAG,kBAAkB,EAAE,GAAG,IAAI,CAiBxF;AA2CD;;;GAGG;AACH,wBAAuB,uBAAuB,CAC5C,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACvD,cAAc,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA8CxD;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACvD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAKxB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAkBzF;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,QAAQ,CAAC,CAoEnB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAepF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,kBAAkB,EAAE,GAAG,MAAM,EAAE,CAEjF"}