envoy-pay 0.1.0

package/dist/cjs/adapters/ows.js

@@ -0,0 +1,204 @@
+"use strict";
+/**
+ * OWS Adapter — Bridge between Open Wallet Standard and envoy.
+ *
+ * Uses `@open-wallet-standard/core` for local key management,
+ * policy-gated signing, and multi-chain address derivation.
+ * envoy handles the payment protocol layer (x402, MPP).
+ *
+ * Architecture:
+ * ```
+ * Agent → EnvoyClient → OWSAdapter → @open-wallet-standard/core
+ *                                     ├── createWallet()
+ *                                     ├── signTransaction()
+ *                                     ├── signMessage()
+ *                                     └── Policy Engine (spending limits)
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { createOwsAdapter } from 'envoy-pay';
+ *
+ * // Create adapter backed by OWS local wallet
+ * const adapter = createOwsAdapter({
+ *   walletName: 'agent-treasury',
+ *   chain: 'evm',
+ *   chainId: 'eip155:8453',
+ *   rpcUrl: 'https://mainnet.base.org',
+ * });
+ *
+ * // Use with envoy client
+ * const client = new EnvoyClient({ adapter });
+ * await client.handle402(response);
+ * ```
+ *
+ * @see https://github.com/open-wallet-standard/core
+ * @see OWS Specification: docs/00-specification.md
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOwsAdapter = createOwsAdapter;
+exports.createOwsPolicy = createOwsPolicy;
+exports.createOwsAgentKey = createOwsAgentKey;
+exports.importOwsWallet = importOwsWallet;
+exports.importOwsWalletFromKey = importOwsWalletFromKey;
+exports.exportOwsWallet = exportOwsWallet;
+exports.listOwsWallets = listOwsWallets;
+exports.deleteOwsWallet = deleteOwsWallet;
+const core_1 = require("@open-wallet-standard/core");
+// ═══ Adapter Factory ════════════════════════════════════════════════════
+/**
+ * Create a PaymentAdapter backed by an OWS local wallet.
+ *
+ * The adapter automatically creates the wallet if it doesn't exist,
+ * and derives the address for the specified chain.
+ */
+function createOwsAdapter(options) {
+    const { walletName, chain, chainId, rpcUrl, vaultPath, passphrase, accountIndex = 0, logger = () => { }, } = options;
+    // Ensure wallet exists
+    let walletInfo;
+    try {
+        walletInfo = (0, core_1.getWallet)(walletName, vaultPath);
+        logger(`[envoy] 📂 Loaded wallet: ${walletName} (${walletInfo.id})`);
+    }
+    catch {
+        // Wallet doesn't exist — create it
+        walletInfo = (0, core_1.createWallet)(walletName, passphrase, 12, vaultPath);
+        logger(`[envoy] 🆕 Created wallet: ${walletName} (${walletInfo.id})`);
+    }
+    // Find the address for our chain
+    const account = walletInfo.accounts.find((a) => a.chainId.startsWith(chainId.split(':')[0])) ?? walletInfo.accounts[0];
+    const address = account?.address ?? '0x0000000000000000000000000000000000000000';
+    const derivedChainName = options.chainName ?? mapChainName(chainId);
+    logger(`[envoy] 🔗 Chain: ${derivedChainName} (${chainId})`);
+    logger(`[envoy] 📍 Address: ${address}`);
+    // Build the PaymentAdapter interface
+    const adapter = {
+        chainName: derivedChainName,
+        caip2Id: chainId,
+        getAddress() {
+            return address;
+        },
+        async pay(destination, amount, _chainId) {
+            logger(`[envoy] 💳 Paying ${amount} to ${destination} on ${chainId}`);
+            try {
+                // For EVM chains, construct and sign+send a transaction
+                if (chain === 'evm') {
+                    // Use signAndSend for on-chain settlement
+                    const result = (0, core_1.signAndSend)(walletName, chain, amount, // tx hex — in production this would be a properly encoded tx
+                    passphrase, accountIndex, rpcUrl, vaultPath);
+                    logger(`[envoy] ✅ Transaction sent: ${result.txHash}`);
+                    return result.txHash;
+                }
+                // For other chains, sign the transaction
+                const sig = (0, core_1.signTransaction)(walletName, chain, amount, passphrase, accountIndex, vaultPath);
+                logger(`[envoy] ✅ Signed: ${sig.signature.substring(0, 20)}...`);
+                return sig.signature;
+            }
+            catch (error) {
+                logger(`[envoy] ❌ Payment failed: ${error.message}`);
+                return null;
+            }
+        },
+        async getBalance() {
+            // OWS doesn't provide balance queries — return '0' and let
+            // the agent fund the wallet via `ows fund deposit`
+            return '0';
+        },
+    };
+    return adapter;
+}
+// ═══ OWS Wallet Management Helpers ═════════════════════════════════════
+/**
+ * Create an OWS policy for agent spending limits.
+ *
+ * @example
+ * ```ts
+ * createOwsPolicy({
+ *   id: 'agent-budget',
+ *   name: 'Agent daily budget',
+ *   allowedChains: ['eip155:8453'],
+ *   expiresAt: '2026-12-31T23:59:59Z',
+ * });
+ * ```
+ */
+function createOwsPolicy(options) {
+    const rules = [];
+    if (options.allowedChains) {
+        rules.push({
+            type: 'allowed_chains',
+            chain_ids: options.allowedChains,
+        });
+    }
+    if (options.expiresAt) {
+        rules.push({
+            type: 'expires_at',
+            timestamp: options.expiresAt,
+        });
+    }
+    const policy = JSON.stringify({
+        id: options.id,
+        name: options.name,
+        version: 1,
+        created_at: new Date().toISOString(),
+        rules,
+        action: 'deny',
+    });
+    (0, core_1.createPolicy)(policy, options.vaultPath);
+}
+/**
+ * Create a scoped OWS API key for agent access.
+ * The agent uses this token as the passphrase — it NEVER sees the private key.
+ *
+ * @returns The API key token (shown once — caller must save it)
+ */
+function createOwsAgentKey(options) {
+    return (0, core_1.createApiKey)(options.name, [options.walletName], options.policyIds, options.passphrase, options.expiresAt, options.vaultPath);
+}
+/**
+ * Import an existing wallet into OWS from a mnemonic.
+ */
+function importOwsWallet(name, mnemonic, passphrase, vaultPath) {
+    return (0, core_1.importWalletMnemonic)(name, mnemonic, passphrase, undefined, vaultPath);
+}
+/**
+ * Import an existing wallet from a private key.
+ */
+function importOwsWalletFromKey(name, privateKeyHex, chain = 'evm', passphrase, vaultPath) {
+    return (0, core_1.importWalletPrivateKey)(name, privateKeyHex, passphrase, vaultPath, chain);
+}
+/**
+ * Export the mnemonic from an OWS wallet.
+ */
+function exportOwsWallet(nameOrId, passphrase, vaultPath) {
+    return (0, core_1.exportWallet)(nameOrId, passphrase, vaultPath);
+}
+/**
+ * List all OWS wallets.
+ */
+function listOwsWallets(vaultPath) {
+    return (0, core_1.listWallets)(vaultPath);
+}
+/**
+ * Delete an OWS wallet.
+ */
+function deleteOwsWallet(nameOrId, vaultPath) {
+    return (0, core_1.deleteWallet)(nameOrId, vaultPath);
+}
+// ═══ Internal ═══════════════════════════════════════════════════════════
+function mapChainName(caip2Id) {
+    const names = {
+        'eip155:1': 'Ethereum',
+        'eip155:8453': 'Base',
+        'eip155:84532': 'Base Sepolia',
+        'eip155:42161': 'Arbitrum',
+        'eip155:10': 'Optimism',
+        'eip155:137': 'Polygon',
+        'solana:mainnet': 'Solana',
+        'solana:devnet': 'Solana Devnet',
+        'stellar:pubnet': 'Stellar',
+        'xrpl:mainnet': 'XRPL',
+        'bip122:000000000019d6689c085ae165831e93': 'Bitcoin',
+    };
+    return names[caip2Id] ?? caip2Id;
+}
+//# sourceMappingURL=ows.js.map

package/dist/cjs/adapters/ows.js.map

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

package/dist/cjs/adapters/solana.js

@@ -0,0 +1,210 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SolanaPaymentAdapter = void 0;
+const web3_js_1 = require("@solana/web3.js");
+const spl_token_1 = require("@solana/spl-token");
+const logger_1 = require("../logger");
+// ─── USDC Mint Addresses ────────────────────────────────────────────
+/** Circle's official USDC on Solana mainnet. */
+const USDC_MAINNET = new web3_js_1.PublicKey('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v');
+/** Circle's USDC on Solana devnet (for testing). */
+const USDC_DEVNET = new web3_js_1.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
+ */
+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 ?? logger_1.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 ?? (0, web3_js_1.clusterApiUrl)(this.network);
+        this.connection = new web3_js_1.Connection(rpcUrl, 'confirmed');
+        // Keypair
+        if (options.secretKey) {
+            const keyArray = options.secretKey instanceof Uint8Array
+                ? options.secretKey
+                : Uint8Array.from(options.secretKey);
+            this.keypair = web3_js_1.Keypair.fromSecretKey(keyArray);
+        }
+        else {
+            this.keypair = web3_js_1.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 / web3_js_1.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 (0, spl_token_1.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) / web3_js_1.LAMPORTS_PER_SOL).toFixed(9);
+            const destPubkey = new web3_js_1.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 / web3_js_1.LAMPORTS_PER_SOL).toFixed(9)} < ${solAmount} SOL`);
+                return null;
+            }
+            const tx = new web3_js_1.Transaction().add(web3_js_1.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 web3_js_1.PublicKey(destination);
+            this.log(`${tag} 🚀 ${formatted} USDC → ${destination.slice(0, 8)}…`);
+            // Get or create sender's ATA
+            const senderAta = await (0, spl_token_1.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 (0, spl_token_1.getOrCreateAssociatedTokenAccount)(this.connection, this.keypair, // payer (creates ATA if needed)
+            this.usdcMint, // mint
+            destPubkey // owner
+            );
+            // Build transfer instruction
+            const tx = new web3_js_1.Transaction().add((0, spl_token_1.createTransferInstruction)(senderAta.address, // source
+            destAta.address, // destination
+            this.keypair.publicKey, // authority
+            atomicAmount, // amount
+            [], // multiSigners
+            spl_token_1.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 web3_js_1.PublicKey('ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL');
+            // Compute the ATA deterministically
+            const [ata] = web3_js_1.PublicKey.findProgramAddressSync([
+                owner.toBuffer(),
+                spl_token_1.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 * web3_js_1.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;
+        }
+    }
+}
+exports.SolanaPaymentAdapter = SolanaPaymentAdapter;
+//# sourceMappingURL=solana.js.map

package/dist/cjs/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/cjs/adapters/stellar.js

@@ -0,0 +1,173 @@
+"use strict";
+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.StellarPaymentAdapter = void 0;
+const StellarSdk = __importStar(require("@stellar/stellar-sdk"));
+const logger_1 = require("../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 envoy stack settles USDC on Stellar mainnet.
+ * @see https://envoy.dev
+ * @see https://stellar.org/usdc
+ */
+class StellarPaymentAdapter {
+    chainName = 'Stellar';
+    caip2Id;
+    keypair;
+    server;
+    networkPassphrase;
+    assetType;
+    log;
+    constructor(options) {
+        this.keypair = StellarSdk.Keypair.fromSecret(options.secretKey);
+        this.log = options.logger ?? logger_1.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;
+        }
+    }
+}
+exports.StellarPaymentAdapter = StellarPaymentAdapter;
+//# sourceMappingURL=stellar.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stellar.js","sourceRoot":"","sources":["../../../src/adapters/stellar.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,iEAAmD;AAEnD,sCAA+C;AAE/C,wDAAwD;AACxD,MAAM,WAAW,GAAG,0DAA0D,CAAC;AAsB/E;;;;;;;;;;GAUG;AACH,MAAa,qBAAqB;IAChB,SAAS,GAAG,SAAS,CAAC;IACtB,OAAO,CAAS;IAExB,OAAO,CAAqB;IAC5B,MAAM,CAA4B;IAClC,iBAAiB,CAAS;IAC1B,SAAS,CAAiB;IAC1B,GAAG,CAAS;IAEpB,YAAY,OAAqC;QAC/C,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChE,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,mBAAU,CAAC;QACxC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;QAExC,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC;QAEhD,IAAI,CAAC,iBAAiB,GAAG,SAAS;YAChC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM;YAC5B,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;QAEhC,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,iBAAiB,CAAC;QAEhE,IAAI,CAAC,MAAM,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,CACzC,OAAO,CAAC,UAAU;YAChB,CAAC,SAAS;gBACR,CAAC,CAAC,6BAA6B;gBAC/B,CAAC,CAAC,qCAAqC,CAAC,CAC7C,CAAC;IACJ,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACK,QAAQ;QACd,IAAI,IAAI,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;YAC9B,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IACnC,CAAC;IAED;;;OAGG;IACK,YAAY,CAAC,OAAe;QAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC;IAEM,KAAK,CAAC,GAAG,CACd,WAAmB,EACnB,MAAc,EACd,OAAe;QAEf,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;YAE9D,IAAI,CAAC,GAAG,CACN,YAAY,UAAU,QAAQ,WAAW,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAC3E,CAAC;YAEF,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CACjD,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CACzB,CAAC;YAEF,MAAM,EAAE,GAAG,IAAI,UAAU,CAAC,kBAAkB,CAAC,aAAa,EAAE;gBAC1D,GAAG,EAAE,UAAU,CAAC,QAAQ;gBACxB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;aAC1C,CAAC;iBACC,YAAY,CACX,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC;gBAC3B,WAAW;gBACX,KAAK;gBACL,MAAM,EAAE,WAAW;aACpB,CAAC,CACH;iBACA,UAAU,CAAC,EAAE,CAAC;iBACd,KAAK,EAAE,CAAC;YAEX,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAEtB,IAAI,CAAC,GAAG,CAAC,YAAY,UAAU,kBAAkB,CAAC,CAAC;YACnD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;YACzD,IAAI,CAAC,GAAG,CAAC,YAAY,UAAU,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;YAEvD,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,IAAI,KAAK,CAAC,OAAO,CAAC;YAC5E,IAAI,CAAC,GAAG,CAAC,eAAe,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAClD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,cAAc;QACzB,IAAI,IAAI,CAAC,SAAS,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC;QAE5C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;YACxE,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CACxC,CAAC,CAAM,EAAE,EAAE,CACT,CAAC,CAAC,UAAU,KAAK,QAAQ;gBACzB,CAAC,CAAC,UAAU,KAAK,MAAM;gBACvB,CAAC,CAAC,YAAY,KAAK,WAAW,CACjC,CAAC;YACF,OAAO,CAAC,YAAY,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,mBAAmB;QAC9B,IAAI,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;YAEvD,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CACjD,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CACzB,CAAC;YAEF,MAAM,EAAE,GAAG,IAAI,UAAU,CAAC,kBAAkB,CAAC,aAAa,EAAE;gBAC1D,GAAG,EAAE,UAAU,CAAC,QAAQ;gBACxB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;aAC1C,CAAC;iBACC,YAAY,CACX,UAAU,CAAC,SAAS,CAAC,WAAW,CAAC;gBAC/B,KAAK,EAAE,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC;aACjD,CAAC,CACH;iBACA,UAAU,CAAC,EAAE,CAAC;iBACd,KAAK,EAAE,CAAC;YAEX,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;YACzD,IAAI,CAAC,GAAG,CAAC,uCAAuC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;YACjE,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,CAAC,GAAG,CAAC,sCAAsC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAChE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF;AA5JD,sDA4JC"}