agentwallet-sdk 6.0.5 → 6.2.0

package/dist/x402/chains/stellar/index.js

@@ -1,199 +0,0 @@
-/**
- * Stellar x402 Payment Adapter
- *
- * Implements x402 payment protocol on Stellar network.
- * Stellar x402 support went live March 11, 2026.
- *
- * Chain identifiers:
- *   - Stellar Mainnet: "stellar:pubnet"
- *   - Stellar Testnet: "stellar:testnet"
- *
- * Key differences from EVM chains:
- * - Uses Ed25519 keypairs (not secp256k1)
- * - Transaction format: Stellar XDR (not EVM tx)
- * - Settlement: ~5 seconds (1 ledger close)
- * - Fees: ~0.00001 XLM per operation (effectively free at scale)
- * - USDC: Circle-issued USDC on Stellar
- */
-// ─── Stellar Chain Constants ─────────────────────────────────────────────────
-export const STELLAR_NETWORK = {
-    pubnet: {
-        horizonUrl: 'https://horizon.stellar.org',
-        networkPassphrase: 'Public Global Stellar Network ; September 2015',
-        chainId: 'stellar:pubnet',
-    },
-    testnet: {
-        horizonUrl: 'https://horizon-testnet.stellar.org',
-        networkPassphrase: 'Test SDF Network ; September 2015',
-        chainId: 'stellar:testnet',
-    },
-};
-/**
- * Circle USDC on Stellar (Mainnet)
- * Asset code: USDC
- * Issuer: GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN
- */
-export const STELLAR_USDC = {
-    pubnet: {
-        code: 'USDC',
-        issuer: 'GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN',
-    },
-    testnet: {
-        code: 'USDC',
-        issuer: 'GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5',
-    },
-};
-// ─── Stellar x402 Payment Adapter ────────────────────────────────────────────
-/**
- * StellarX402Adapter
- *
- * Handles x402 payment flow for Stellar network.
- *
- * Usage (with stellar-sdk):
- * ```typescript
- * import { StellarX402Adapter } from 'agentwallet-sdk/x402/stellar';
- * import { Keypair, Networks } from '@stellar/stellar-sdk';
- *
- * const adapter = new StellarX402Adapter({ network: 'pubnet' });
- * const result = await adapter.pay({
- *   destination: 'GDESTWVX3VMLQCXPHPVLS3FMNMG2X7L5IGGQT7BQMIZXZZ4V7KBQVS',
- *   amount: '0.50',
- *   sourcePublicKey: keypair.publicKey(),
- *   resource: '/api/data-endpoint',
- * }, keypair.secret());
- * ```
- *
- * Note: stellar-sdk must be installed separately:
- * npm install @stellar/stellar-sdk
- */
-export class StellarX402Adapter {
-    constructor(config = {}) {
-        this.network = config.network ?? 'pubnet';
-        this.horizonUrl = config.horizonUrl ?? STELLAR_NETWORK[this.network].horizonUrl;
-    }
-    /**
-     * Parse an x402 402 response and extract Stellar payment details.
-     * The 402 response should include X-Payment-Chains: stellar:pubnet
-     * and X-Payment-Amount, X-Payment-Destination headers.
-     */
-    parseX402Response(headers) {
-        const chains = headers['x-payment-chains'] ?? headers['X-Payment-Chains'] ?? '';
-        const chainId = STELLAR_NETWORK[this.network].chainId;
-        if (!chains.includes(chainId) && !chains.includes('stellar')) {
-            return { supported: false };
-        }
-        return {
-            supported: true,
-            destination: headers['x-payment-destination'] ?? headers['X-Payment-Destination'],
-            amount: headers['x-payment-amount'] ?? headers['X-Payment-Amount'],
-            resource: headers['x-payment-resource'] ?? headers['X-Payment-Resource'],
-        };
-    }
-    /**
-     * Build a Stellar USDC payment transaction.
-     *
-     * Requires @stellar/stellar-sdk to be installed:
-     * npm install @stellar/stellar-sdk
-     *
-     * Returns the XDR-encoded transaction envelope for signing and submission.
-     */
-    async buildPaymentTransaction(request) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        let StellarSdk;
-        try {
-            // @ts-expect-error — @stellar/stellar-sdk is an optional peer dependency
-            StellarSdk = await import('@stellar/stellar-sdk');
-        }
-        catch {
-            throw new Error('Stellar support requires @stellar/stellar-sdk: npm install @stellar/stellar-sdk');
-        }
-        const networkConfig = STELLAR_NETWORK[request.network ?? this.network];
-        const usdcAsset = STELLAR_USDC[request.network ?? this.network];
-        // Load source account sequence number from Horizon
-        const account = await this._loadAccount(request.sourcePublicKey, networkConfig.horizonUrl);
-        const stellarAccount = new StellarSdk.Account(request.sourcePublicKey, account.sequence);
-        const asset = new StellarSdk.Asset(usdcAsset.code, usdcAsset.issuer);
-        const memoText = request.resource
-            ? request.resource.slice(0, 28) // Stellar memo max 28 bytes
-            : 'x402-payment';
-        const transaction = new StellarSdk.TransactionBuilder(stellarAccount, {
-            fee: StellarSdk.BASE_FEE,
-            networkPassphrase: networkConfig.networkPassphrase,
-        })
-            .addOperation(StellarSdk.Operation.payment({
-            destination: request.destination,
-            asset,
-            amount: request.amount,
-        }))
-            .addMemo(StellarSdk.Memo.text(memoText))
-            .setTimeout(300) // 5 minute window
-            .build();
-        return transaction.toXDR();
-    }
-    /**
-     * Submit a signed Stellar transaction to Horizon.
-     */
-    async submitTransaction(signedXdr) {
-        const networkConfig = STELLAR_NETWORK[this.network];
-        const body = new URLSearchParams({ tx: signedXdr }).toString();
-        const resp = await fetch(`${networkConfig.horizonUrl}/transactions`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
-            body,
-        });
-        if (!resp.ok) {
-            const err = await resp.text();
-            throw new Error(`Stellar transaction failed: ${resp.status} ${err.slice(0, 200)}`);
-        }
-        const result = await resp.json();
-        return {
-            hash: result.hash,
-            ledger: result.ledger,
-            successful: result.successful ?? true,
-            network: this.network,
-        };
-    }
-    async _loadAccount(publicKey, horizonUrl) {
-        const resp = await fetch(`${horizonUrl}/accounts/${publicKey}`);
-        if (!resp.ok) {
-            throw new Error(`Cannot load Stellar account ${publicKey}: ${resp.status}. ` +
-                `Ensure the account exists and has a USDC trustline established.`);
-        }
-        const data = await resp.json();
-        return { sequence: data.sequence };
-    }
-    /** Chain ID for this adapter (e.g. "stellar:pubnet") */
-    get chainId() {
-        return STELLAR_NETWORK[this.network].chainId;
-    }
-}
-// ─── x402 Auto-Pay Helper ────────────────────────────────────────────────────
-/**
- * Full x402 payment flow for Stellar.
- * 1. Detects 402 response from API
- * 2. Parses Stellar payment details from headers
- * 3. Builds, signs, and submits Stellar USDC payment
- * 4. Retries the original request with payment proof
- *
- * Requires stellar-sdk: npm install @stellar/stellar-sdk
- */
-export async function stellarX402Pay(params) {
-    const adapter = new StellarX402Adapter({ network: params.network ?? 'pubnet' });
-    const details = adapter.parseX402Response(params.responseHeaders);
-    if (!details.supported) {
-        throw new Error('This endpoint does not support Stellar x402 payments');
-    }
-    if (!details.destination || !details.amount) {
-        throw new Error('x402 response missing destination or amount headers');
-    }
-    const xdr = await adapter.buildPaymentTransaction({
-        destination: details.destination,
-        amount: details.amount,
-        sourcePublicKey: params.sourcePublicKey,
-        resource: details.resource,
-        network: params.network ?? 'pubnet',
-    });
-    const signedXdr = await params.sign(xdr);
-    return adapter.submitTransaction(signedXdr);
-}
-//# sourceMappingURL=index.js.map

package/dist/x402/chains/stellar/index.js.map

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