envoy-pay 0.1.0

package/dist/esm/adapters/solana.js

@@ -0,0 +1,206 @@
+import { Connection, Keypair, PublicKey, Transaction, SystemProgram, LAMPORTS_PER_SOL, clusterApiUrl, } from '@solana/web3.js';
+import { getOrCreateAssociatedTokenAccount, createTransferInstruction, getAccount, TOKEN_PROGRAM_ID, } from '@solana/spl-token';
+import { noopLogger } from '../logger.js';
+// ─── USDC Mint Addresses ────────────────────────────────────────────
+/** Circle's official USDC on Solana mainnet. */
+const USDC_MAINNET = new PublicKey('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v');
+/** Circle's USDC on Solana devnet (for testing). */
+const USDC_DEVNET = new PublicKey('4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU');
+// ─── Solana Payment Adapter ─────────────────────────────────────────
+/**
+ * SolanaPaymentAdapter — On-chain settlement on Solana.
+ *
+ * Supports:
+ * - Native SOL transfers (System Program)
+ * - USDC (SPL Token) transfers with automatic ATA creation
+ *
+ * @example
+ * ```ts
+ * // SOL on devnet
+ * const adapter = new SolanaPaymentAdapter({
+ *   secretKey: myKeypair.secretKey,
+ *   network: 'devnet',
+ *   asset: 'SOL',
+ *   logger: console.log,
+ * });
+ *
+ * // USDC on mainnet
+ * const adapter = new SolanaPaymentAdapter({
+ *   secretKey: myKeypair.secretKey,
+ *   network: 'mainnet-beta',
+ *   asset: 'USDC',
+ * });
+ * ```
+ *
+ * @see https://spl.solana.com/token — SPL Token program
+ * @see https://envoy.dev — envoy production infrastructure
+ */
+export class SolanaPaymentAdapter {
+    chainName;
+    caip2Id;
+    connection;
+    keypair;
+    asset;
+    usdcMint;
+    network;
+    log;
+    constructor(options) {
+        this.network = options.network ?? 'devnet';
+        this.asset = options.asset ?? 'SOL';
+        this.log = options.logger ?? noopLogger;
+        // Set CAIP-2 ID
+        const chainRef = this.network === 'mainnet-beta' ? '5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp' : '4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z';
+        this.caip2Id = `solana:${chainRef}`;
+        this.chainName = `Solana ${this.network === 'mainnet-beta' ? 'Mainnet' : this.network === 'devnet' ? 'Devnet' : 'Testnet'}`;
+        // USDC mint per network
+        this.usdcMint = this.network === 'mainnet-beta' ? USDC_MAINNET : USDC_DEVNET;
+        // Connection
+        const rpcUrl = options.rpcUrl ?? clusterApiUrl(this.network);
+        this.connection = new Connection(rpcUrl, 'confirmed');
+        // Keypair
+        if (options.secretKey) {
+            const keyArray = options.secretKey instanceof Uint8Array
+                ? options.secretKey
+                : Uint8Array.from(options.secretKey);
+            this.keypair = Keypair.fromSecretKey(keyArray);
+        }
+        else {
+            this.keypair = Keypair.generate();
+        }
+    }
+    getAddress() {
+        return this.keypair.publicKey.toBase58();
+    }
+    /** Get SOL balance in SOL (not lamports). */
+    async getSolBalance() {
+        const lamports = await this.connection.getBalance(this.keypair.publicKey);
+        return (lamports / LAMPORTS_PER_SOL).toFixed(9);
+    }
+    /** Get USDC balance (6 decimals). */
+    async getUsdcBalance() {
+        try {
+            const ata = await this.findAta(this.keypair.publicKey);
+            if (!ata)
+                return '0.000000';
+            const account = await getAccount(this.connection, ata);
+            return (Number(account.amount) / 1e6).toFixed(6);
+        }
+        catch {
+            return '0.000000';
+        }
+    }
+    async pay(destination, amount, network) {
+        if (this.asset === 'USDC') {
+            return this.payUsdc(destination, amount);
+        }
+        return this.paySol(destination, amount);
+    }
+    // ── Native SOL transfer ─────────────────────────────────────────
+    async paySol(destination, amount) {
+        const tag = `[Solana/SOL]`;
+        try {
+            const lamports = BigInt(amount);
+            const solAmount = (Number(lamports) / LAMPORTS_PER_SOL).toFixed(9);
+            const destPubkey = new PublicKey(destination);
+            this.log(`${tag} 🚀 ${solAmount} SOL → ${destination.slice(0, 8)}…`);
+            // Balance check
+            const balance = await this.connection.getBalance(this.keypair.publicKey);
+            if (BigInt(balance) < lamports) {
+                this.log(`${tag} ❌ Insufficient: ${(balance / LAMPORTS_PER_SOL).toFixed(9)} < ${solAmount} SOL`);
+                return null;
+            }
+            const tx = new Transaction().add(SystemProgram.transfer({
+                fromPubkey: this.keypair.publicKey,
+                toPubkey: destPubkey,
+                lamports: lamports,
+            }));
+            const signature = await this.connection.sendTransaction(tx, [this.keypair]);
+            await this.connection.confirmTransaction(signature, 'confirmed');
+            this.log(`${tag} ✅ ${signature}`);
+            return signature;
+        }
+        catch (error) {
+            this.log(`${tag} ❌ ${error.message}`);
+            return null;
+        }
+    }
+    // ── USDC SPL Token transfer ─────────────────────────────────────
+    async payUsdc(destination, amount) {
+        const tag = `[Solana/USDC]`;
+        try {
+            const atomicAmount = BigInt(amount);
+            const formatted = (Number(atomicAmount) / 1e6).toFixed(6);
+            const destPubkey = new PublicKey(destination);
+            this.log(`${tag} 🚀 ${formatted} USDC → ${destination.slice(0, 8)}…`);
+            // Get or create sender's ATA
+            const senderAta = await getOrCreateAssociatedTokenAccount(this.connection, this.keypair, // payer
+            this.usdcMint, // mint
+            this.keypair.publicKey // owner
+            );
+            // Balance check
+            if (senderAta.amount < atomicAmount) {
+                this.log(`${tag} ❌ Insufficient: ${(Number(senderAta.amount) / 1e6).toFixed(6)} < ${formatted} USDC`);
+                return null;
+            }
+            // Get or create destination ATA
+            const destAta = await getOrCreateAssociatedTokenAccount(this.connection, this.keypair, // payer (creates ATA if needed)
+            this.usdcMint, // mint
+            destPubkey // owner
+            );
+            // Build transfer instruction
+            const tx = new Transaction().add(createTransferInstruction(senderAta.address, // source
+            destAta.address, // destination
+            this.keypair.publicKey, // authority
+            atomicAmount, // amount
+            [], // multiSigners
+            TOKEN_PROGRAM_ID));
+            const signature = await this.connection.sendTransaction(tx, [this.keypair]);
+            await this.connection.confirmTransaction(signature, 'confirmed');
+            this.log(`${tag} ✅ ${signature}`);
+            return signature;
+        }
+        catch (error) {
+            this.log(`${tag} ❌ ${error.message}`);
+            return null;
+        }
+    }
+    // ── Helpers ─────────────────────────────────────────────────────
+    /** Find the Associated Token Account for USDC. Returns null if none. */
+    async findAta(owner) {
+        try {
+            const ASSOCIATED_TOKEN_PROGRAM_ID = new PublicKey('ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL');
+            // Compute the ATA deterministically
+            const [ata] = PublicKey.findProgramAddressSync([
+                owner.toBuffer(),
+                TOKEN_PROGRAM_ID.toBuffer(),
+                this.usdcMint.toBuffer(),
+            ], ASSOCIATED_TOKEN_PROGRAM_ID);
+            // Check if it exists
+            const info = await this.connection.getAccountInfo(ata);
+            return info ? ata : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Request SOL airdrop from devnet/testnet faucet (for testing). */
+    async requestAirdrop(amountSol = 1) {
+        if (this.network === 'mainnet-beta') {
+            this.log('[Solana] ❌ Cannot airdrop on mainnet');
+            return null;
+        }
+        try {
+            const lamports = amountSol * LAMPORTS_PER_SOL;
+            this.log(`[Solana] 💧 Requesting ${amountSol} SOL airdrop…`);
+            const sig = await this.connection.requestAirdrop(this.keypair.publicKey, lamports);
+            await this.connection.confirmTransaction(sig, 'confirmed');
+            this.log(`[Solana] ✅ Airdrop: ${sig}`);
+            return sig;
+        }
+        catch (error) {
+            this.log(`[Solana] ❌ Airdrop failed: ${error.message}`);
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=solana.js.map

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

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

package/dist/esm/adapters/stellar.js

@@ -0,0 +1,136 @@
+import * as StellarSdk from '@stellar/stellar-sdk';
+import { noopLogger } from '../logger.js';
+/** 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 envoy stack settles USDC on Stellar mainnet.
+ * @see https://envoy.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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"}