@asgcard/pay 0.1.1

package/dist/esm/adapters/evm.js

@@ -0,0 +1,258 @@
+import { createWalletClient, createPublicClient, http, formatEther, formatUnits, } from 'viem';
+import { privateKeyToAccount, generatePrivateKey } from 'viem/accounts';
+import { base, baseSepolia, arbitrum, arbitrumSepolia, optimism, optimismSepolia, mainnet as ethereum, sepolia as ethereumSepolia, polygon, polygonAmoy, } from 'viem/chains';
+import { noopLogger } from '../logger';
+/**
+ * Chain registry — maps chain names to viem chain objects + USDC contracts.
+ * All USDC addresses are Circle's official native USDC deployments.
+ */
+const CHAIN_REGISTRY = {
+    // ── Base (Coinbase L2) ──────────────────────────────────────────
+    'base': {
+        chain: base,
+        displayName: 'Base',
+        usdc: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+    },
+    'base-sepolia': {
+        chain: baseSepolia,
+        displayName: 'Base Sepolia',
+        usdc: '0x036CbD53842c5426634e7929541eC2318f3dCF7e',
+    },
+    // ── Arbitrum ────────────────────────────────────────────────────
+    'arbitrum': {
+        chain: arbitrum,
+        displayName: 'Arbitrum One',
+        usdc: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
+    },
+    'arbitrum-sepolia': {
+        chain: arbitrumSepolia,
+        displayName: 'Arbitrum Sepolia',
+        usdc: '0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d',
+    },
+    // ── Optimism ────────────────────────────────────────────────────
+    'optimism': {
+        chain: optimism,
+        displayName: 'Optimism',
+        usdc: '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85',
+    },
+    'optimism-sepolia': {
+        chain: optimismSepolia,
+        displayName: 'Optimism Sepolia',
+        usdc: '0x5fd84259d66Cd46123540766Be93DFE6D43130D7',
+    },
+    // ── Ethereum ────────────────────────────────────────────────────
+    'ethereum': {
+        chain: ethereum,
+        displayName: 'Ethereum',
+        usdc: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
+    },
+    'ethereum-sepolia': {
+        chain: ethereumSepolia,
+        displayName: 'Ethereum Sepolia',
+        usdc: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238',
+    },
+    // ── Polygon ─────────────────────────────────────────────────────
+    'polygon': {
+        chain: polygon,
+        displayName: 'Polygon',
+        usdc: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359',
+    },
+    'polygon-amoy': {
+        chain: polygonAmoy,
+        displayName: 'Polygon Amoy',
+        usdc: null, // No official Circle testnet USDC on Amoy yet
+    },
+};
+// ─── ERC-20 ABI (minimal) ───────────────────────────────────────────
+const ERC20_ABI = [
+    {
+        name: 'transfer',
+        type: 'function',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'to', type: 'address' },
+            { name: 'amount', type: 'uint256' },
+        ],
+        outputs: [{ name: '', type: 'bool' }],
+    },
+    {
+        name: 'balanceOf',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [{ name: 'account', type: 'address' }],
+        outputs: [{ name: '', type: 'uint256' }],
+    },
+];
+// ─── Universal EVM Adapter ──────────────────────────────────────────
+/**
+ * EvmPaymentAdapter — Universal EVM on-chain settlement.
+ *
+ * One adapter for ALL EVM chains supported by x402:
+ * Base, Arbitrum, Optimism, Ethereum, Polygon — mainnet & testnet.
+ *
+ * Supports native token (ETH/MATIC) and USDC (Circle ERC-20) transfers.
+ *
+ * @example
+ * ```ts
+ * // Arbitrum USDC settlement
+ * const adapter = new EvmPaymentAdapter({
+ *   chain: 'arbitrum',
+ *   asset: 'USDC',
+ *   privateKey: '0x...',
+ * });
+ *
+ * // Base ETH settlement (testnet)
+ * const adapter = new EvmPaymentAdapter({
+ *   chain: 'base-sepolia',
+ *   asset: 'native',
+ * });
+ * ```
+ *
+ * @see https://x402.org — x402 payment protocol
+ * @see https://pay.asgcard.dev — ASG Pay production infrastructure
+ */
+export class EvmPaymentAdapter {
+    chainName;
+    caip2Id;
+    wallet;
+    publicClient;
+    account;
+    chainConfig;
+    asset;
+    log;
+    constructor(options) {
+        const config = CHAIN_REGISTRY[options.chain];
+        if (!config) {
+            throw new Error(`Unsupported chain: "${options.chain}". ` +
+                `Supported: ${Object.keys(CHAIN_REGISTRY).join(', ')}`);
+        }
+        this.chainConfig = config;
+        this.chainName = config.displayName;
+        this.caip2Id = `eip155:${config.chain.id}`;
+        this.asset = options.asset ?? 'native';
+        this.log = options.logger ?? noopLogger;
+        if (this.asset === 'USDC' && !config.usdc) {
+            throw new Error(`No USDC contract available for ${config.displayName}. ` +
+                `Use asset: 'native' or choose a chain with USDC support.`);
+        }
+        const key = options.privateKey ?? generatePrivateKey();
+        this.account = privateKeyToAccount(key);
+        const transport = options.rpcUrl ? http(options.rpcUrl) : http();
+        this.wallet = createWalletClient({
+            account: this.account,
+            chain: config.chain,
+            transport,
+        });
+        this.publicClient = createPublicClient({
+            chain: config.chain,
+            transport,
+        });
+    }
+    getAddress() {
+        return this.account.address;
+    }
+    /** Get native token balance (ETH, MATIC, etc.). */
+    async getNativeBalance() {
+        const balance = await this.publicClient.getBalance({
+            address: this.account.address,
+        });
+        return formatEther(balance);
+    }
+    /** Get USDC balance (6 decimals). Returns '0.00' if USDC not supported. */
+    async getUsdcBalance() {
+        const usdcAddress = this.chainConfig.usdc;
+        if (!usdcAddress)
+            return '0.00';
+        const balance = await this.publicClient.readContract({
+            address: usdcAddress,
+            abi: ERC20_ABI,
+            functionName: 'balanceOf',
+            args: [this.account.address],
+        });
+        return formatUnits(balance, 6);
+    }
+    async pay(destination, amount, network) {
+        if (this.asset === 'USDC') {
+            return this.payUsdc(destination, amount);
+        }
+        return this.payNative(destination, amount);
+    }
+    // ── Native token transfer ───────────────────────────────────────
+    async payNative(destination, amount) {
+        const tag = `[${this.chainName}/native]`;
+        try {
+            const amountWei = BigInt(amount);
+            const formatted = formatEther(amountWei);
+            this.log(`${tag} 🚀 ${formatted} → ${this.shortAddr(destination)}`);
+            const balance = await this.publicClient.getBalance({
+                address: this.account.address,
+            });
+            if (balance < amountWei) {
+                this.log(`${tag} ❌ Insufficient: ${formatEther(balance)} < ${formatted}`);
+                return null;
+            }
+            const hash = await this.wallet.sendTransaction({
+                account: this.account,
+                to: destination,
+                value: amountWei,
+                chain: this.chainConfig.chain,
+            });
+            this.log(`${tag} ✅ ${hash}`);
+            return hash;
+        }
+        catch (error) {
+            this.log(`${tag} ❌ ${error.message}`);
+            return null;
+        }
+    }
+    // ── USDC ERC-20 transfer ────────────────────────────────────────
+    async payUsdc(destination, amount) {
+        const tag = `[${this.chainName}/USDC]`;
+        const usdcAddress = this.chainConfig.usdc;
+        try {
+            const amountAtomic = BigInt(amount);
+            const formatted = formatUnits(amountAtomic, 6);
+            this.log(`${tag} 🚀 ${formatted} USDC → ${this.shortAddr(destination)}`);
+            // Balance check
+            const balance = await this.publicClient.readContract({
+                address: usdcAddress,
+                abi: ERC20_ABI,
+                functionName: 'balanceOf',
+                args: [this.account.address],
+            });
+            if (balance < amountAtomic) {
+                this.log(`${tag} ❌ Insufficient: ${formatUnits(balance, 6)} < ${formatted} USDC`);
+                return null;
+            }
+            const hash = await this.wallet.writeContract({
+                address: usdcAddress,
+                abi: ERC20_ABI,
+                functionName: 'transfer',
+                args: [destination, amountAtomic],
+                chain: this.chainConfig.chain,
+                account: this.account,
+            });
+            this.log(`${tag} ✅ ${hash}`);
+            return hash;
+        }
+        catch (error) {
+            this.log(`${tag} ❌ ${error.message}`);
+            return null;
+        }
+    }
+    shortAddr(addr) {
+        return `${addr.slice(0, 8)}…${addr.slice(-6)}`;
+    }
+}
+// ─── Helper: list all supported chains ──────────────────────────────
+/** Returns metadata for all supported EVM chains. */
+export function listEvmChains() {
+    return Object.entries(CHAIN_REGISTRY).map(([name, config]) => ({
+        name: name,
+        displayName: config.displayName,
+        chainId: config.chain.id,
+        caip2Id: `eip155:${config.chain.id}`,
+        hasUsdc: config.usdc !== null,
+    }));
+}
+//# sourceMappingURL=evm.js.map

package/dist/esm/adapters/evm.js.map

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

package/dist/esm/adapters/index.js

@@ -0,0 +1,5 @@
+export { EvmPaymentAdapter, listEvmChains } from './evm';
+export { StripePaymentAdapter } from './stripe';
+export { BasePaymentAdapter } from './base';
+export { StellarPaymentAdapter } from './stellar';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAmC,aAAa,EAAE,MAAM,OAAO,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAwB,MAAM,UAAU,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAsB,MAAM,QAAQ,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAgC,MAAM,WAAW,CAAC"}

package/dist/esm/adapters/stellar.js

@@ -0,0 +1,136 @@
+import * as StellarSdk from '@stellar/stellar-sdk';
+import { noopLogger } from '../logger';
+/** Circle's official USDC issuer on Stellar mainnet. */
+const USDC_ISSUER = 'GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN';
+/**
+ * StellarPaymentAdapter — On-chain settlement on the Stellar network.
+ *
+ * Supports:
+ * - Native XLM payments (testnet default)
+ * - Circle USDC payments (production recommended)
+ *
+ * The production ASG Pay stack settles USDC on Stellar mainnet.
+ * @see https://pay.asgcard.dev
+ * @see https://stellar.org/usdc
+ */
+export class StellarPaymentAdapter {
+    chainName = 'Stellar';
+    caip2Id;
+    keypair;
+    server;
+    networkPassphrase;
+    assetType;
+    log;
+    constructor(options) {
+        this.keypair = StellarSdk.Keypair.fromSecret(options.secretKey);
+        this.log = options.logger ?? noopLogger;
+        this.assetType = options.asset ?? 'XLM';
+        const isMainnet = options.network === 'mainnet';
+        this.networkPassphrase = isMainnet
+            ? StellarSdk.Networks.PUBLIC
+            : StellarSdk.Networks.TESTNET;
+        this.caip2Id = isMainnet ? 'stellar:pubnet' : 'stellar:testnet';
+        this.server = new StellarSdk.Horizon.Server(options.horizonUrl ??
+            (isMainnet
+                ? 'https://horizon.stellar.org'
+                : 'https://horizon-testnet.stellar.org'));
+    }
+    getAddress() {
+        return this.keypair.publicKey();
+    }
+    /**
+     * Get the Stellar asset object based on configuration.
+     * - XLM: native asset (no trustline needed)
+     * - USDC: Circle's issued USDC (trustline required)
+     */
+    getAsset() {
+        if (this.assetType === 'USDC') {
+            return new StellarSdk.Asset('USDC', USDC_ISSUER);
+        }
+        return StellarSdk.Asset.native();
+    }
+    /**
+     * Convert atomic units to human-readable amount.
+     * Stellar uses 7 decimal places (stroops) for all assets.
+     */
+    formatAmount(stroops) {
+        return (parseInt(stroops, 10) / 1e7).toFixed(7);
+    }
+    async pay(destination, amount, network) {
+        try {
+            const asset = this.getAsset();
+            const humanAmount = this.formatAmount(amount);
+            const assetLabel = this.assetType === 'USDC' ? 'USDC' : 'XLM';
+            this.log(`[Stellar/${assetLabel}] 🚀 ${humanAmount} → ${destination.slice(0, 10)}…`);
+            const sourceAccount = await this.server.loadAccount(this.keypair.publicKey());
+            const tx = new StellarSdk.TransactionBuilder(sourceAccount, {
+                fee: StellarSdk.BASE_FEE,
+                networkPassphrase: this.networkPassphrase,
+            })
+                .addOperation(StellarSdk.Operation.payment({
+                destination,
+                asset,
+                amount: humanAmount,
+            }))
+                .setTimeout(30)
+                .build();
+            tx.sign(this.keypair);
+            this.log(`[Stellar/${assetLabel}] 📡 Submitting…`);
+            const response = await this.server.submitTransaction(tx);
+            this.log(`[Stellar/${assetLabel}] ✅ ${response.hash}`);
+            return response.hash;
+        }
+        catch (error) {
+            const detail = error?.response?.data?.extras?.result_codes || error.message;
+            this.log(`[Stellar] ❌ ${JSON.stringify(detail)}`);
+            return null;
+        }
+    }
+    /**
+     * Check if the account has a USDC trustline.
+     * Returns false if using XLM or if the trustline exists.
+     * Returns true if USDC is selected but trustline is missing.
+     */
+    async needsTrustline() {
+        if (this.assetType !== 'USDC')
+            return false;
+        try {
+            const account = await this.server.loadAccount(this.keypair.publicKey());
+            const hasTrustline = account.balances.some((b) => b.asset_type !== 'native' &&
+                b.asset_code === 'USDC' &&
+                b.asset_issuer === USDC_ISSUER);
+            return !hasTrustline;
+        }
+        catch {
+            return true;
+        }
+    }
+    /**
+     * Establish a USDC trustline (required before receiving USDC).
+     * Only needed once per account.
+     */
+    async createUsdcTrustline() {
+        try {
+            this.log('[Stellar/USDC] 🔗 Creating USDC trustline…');
+            const sourceAccount = await this.server.loadAccount(this.keypair.publicKey());
+            const tx = new StellarSdk.TransactionBuilder(sourceAccount, {
+                fee: StellarSdk.BASE_FEE,
+                networkPassphrase: this.networkPassphrase,
+            })
+                .addOperation(StellarSdk.Operation.changeTrust({
+                asset: new StellarSdk.Asset('USDC', USDC_ISSUER),
+            }))
+                .setTimeout(30)
+                .build();
+            tx.sign(this.keypair);
+            const response = await this.server.submitTransaction(tx);
+            this.log(`[Stellar/USDC] ✅ Trustline created: ${response.hash}`);
+            return response.hash;
+        }
+        catch (error) {
+            this.log(`[Stellar/USDC] ❌ Trustline failed: ${error.message}`);
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=stellar.js.map

package/dist/esm/adapters/stellar.js.map

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