@asgcard/sdk 1.0.0

package/README.md

@@ -0,0 +1,111 @@
+# @asgcard/sdk
+
+TypeScript SDK for [ASG Card](https://asgcard.dev) — instant virtual Visa cards for AI agents, paid via x402 on Stellar.
+
+## Install
+
+```bash
+npm install @asgcard/sdk
+```
+
+## Quick Start
+
+```typescript
+import { ASGCardClient } from '@asgcard/sdk';
+
+const client = new ASGCardClient({
+  privateKey: 'S...', // Stellar secret key
+});
+
+// Create a $10 virtual card
+const result = await client.createCard({
+  amount: 10,
+  nameOnCard: 'AI AGENT',
+  email: 'agent@example.com',
+});
+
+console.log(result.card.cardId);          // card_xxxx
+console.log(result.detailsEnvelope);      // { cardNumber, cvv, expiry, ... }
+console.log(result.payment.txHash);       // Stellar tx hash
+```
+
+## How It Works
+
+1. SDK calls `POST /cards/create/tier/10`
+2. API returns `402` with x402 payment challenge
+3. SDK builds a Soroban USDC transfer, signs it, and retries with `X-PAYMENT` header
+4. API verifies + settles on Stellar mainnet → returns `201` with card details
+
+## API
+
+### `new ASGCardClient(config)`
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `privateKey` | `string` | — | Stellar secret key (`S...`) |
+| `walletAdapter` | `WalletAdapter` | — | External wallet (browser extension) |
+| `baseUrl` | `string` | `https://api.asgcard.dev` | API URL |
+| `rpcUrl` | `string` | `https://mainnet.sorobanrpc.com` | Soroban RPC |
+| `timeout` | `number` | `60000` | Request timeout (ms) |
+
+### `client.createCard(params)`
+
+```typescript
+const card = await client.createCard({
+  amount: 10,            // 10, 25, 50, 100, 200, or 500 USD
+  nameOnCard: 'MY AGENT',
+  email: 'agent@example.com',
+});
+```
+
+### `client.fundCard(params)`
+
+```typescript
+const funded = await client.fundCard({
+  amount: 25,
+  cardId: 'card_xxxx',
+});
+```
+
+### `client.getTiers()`
+
+```typescript
+const tiers = await client.getTiers();
+// { creation: [...], funding: [...] }
+```
+
+### `client.health()`
+
+```typescript
+const health = await client.health();
+// { status: 'ok', version: '0.3.1' }
+```
+
+## Low-Level Utilities
+
+For custom integrations:
+
+```typescript
+import {
+  parseChallenge,
+  buildPaymentTransaction,
+  buildPaymentPayload,
+  handleX402Payment,
+} from '@asgcard/sdk';
+```
+
+## Requirements
+
+- Node.js 18+
+- Stellar account with USDC balance
+- USDC asset: `CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75` (Soroban SAC)
+
+## Links
+
+- [Documentation](https://asgcard.dev/docs)
+- [OpenAPI Spec](https://asgcard.dev/openapi.json)
+- [API Status](https://api.asgcard.dev/health)
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,29 @@
+import type { ASGCardClientConfig, CardResult, CreateCardParams, FundCardParams, FundResult, HealthResponse, TierResponse } from "./types";
+export declare class ASGCardClient {
+    private readonly baseUrl;
+    private readonly timeout;
+    private readonly rpcServer;
+    private readonly keypair?;
+    private readonly walletAdapter?;
+    constructor(config: ASGCardClientConfig);
+    /** Stellar public key (G...) */
+    get address(): string;
+    /**
+     * Create a virtual card for a supported tier amount.
+     * Handles 402 → x402 payment → 201 automatically.
+     */
+    createCard(params: CreateCardParams): Promise<CardResult>;
+    /**
+     * Fund an existing card by tier amount.
+     * Handles 402 → x402 payment → 200 automatically.
+     */
+    fundCard(params: FundCardParams): Promise<FundResult>;
+    /** Get available create/fund tier amounts and pricing */
+    getTiers(): Promise<TierResponse>;
+    /** Health check */
+    health(): Promise<HealthResponse>;
+    private requestWithX402;
+    private request;
+    private rawFetch;
+    private parseResponse;
+}

package/dist/client.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASGCardClient = void 0;
+/**
+ * @asgcard/sdk — ASGCardClient
+ *
+ * Main client for the ASG Card API.
+ * Handles x402 payment flow on Stellar automatically.
+ */
+const stellar_sdk_1 = require("@stellar/stellar-sdk");
+const errors_1 = require("./errors");
+const x402_1 = require("./utils/x402");
+const DEFAULT_BASE_URL = "https://api.asgcard.dev";
+const DEFAULT_RPC_URL = "https://mainnet.sorobanrpc.com";
+const DEFAULT_TIMEOUT = 60_000;
+class ASGCardClient {
+    baseUrl;
+    timeout;
+    rpcServer;
+    keypair;
+    walletAdapter;
+    constructor(config) {
+        if (!config.privateKey && !config.walletAdapter) {
+            throw new Error("Provide either privateKey or walletAdapter");
+        }
+        this.baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
+        this.timeout = config.timeout ?? DEFAULT_TIMEOUT;
+        this.rpcServer = new stellar_sdk_1.rpc.Server(config.rpcUrl ?? DEFAULT_RPC_URL);
+        if (config.privateKey) {
+            this.keypair = stellar_sdk_1.Keypair.fromSecret(config.privateKey);
+        }
+        this.walletAdapter = config.walletAdapter;
+    }
+    /** Stellar public key (G...) */
+    get address() {
+        if (this.keypair) {
+            return this.keypair.publicKey();
+        }
+        return this.walletAdapter.publicKey;
+    }
+    /**
+     * Create a virtual card for a supported tier amount.
+     * Handles 402 → x402 payment → 201 automatically.
+     */
+    async createCard(params) {
+        return this.requestWithX402(`/cards/create/tier/${params.amount}`, {
+            method: "POST",
+            body: JSON.stringify({
+                nameOnCard: params.nameOnCard,
+                email: params.email
+            })
+        });
+    }
+    /**
+     * Fund an existing card by tier amount.
+     * Handles 402 → x402 payment → 200 automatically.
+     */
+    async fundCard(params) {
+        return this.requestWithX402(`/cards/fund/tier/${params.amount}`, {
+            method: "POST",
+            body: JSON.stringify({ cardId: params.cardId })
+        });
+    }
+    /** Get available create/fund tier amounts and pricing */
+    async getTiers() {
+        return this.request("/cards/tiers", { method: "GET" });
+    }
+    /** Health check */
+    async health() {
+        return this.request("/health", { method: "GET" });
+    }
+    // ── x402 payment flow ────────────────────────────────
+    async requestWithX402(path, init) {
+        const first = await this.rawFetch(path, init);
+        if (first.status !== 402) {
+            return this.parseResponse(first);
+        }
+        const challengePayload = await first.json();
+        const paymentHeader = await (0, x402_1.handleX402Payment)({
+            rpcServer: this.rpcServer,
+            challengePayload,
+            keypair: this.keypair,
+            walletAdapter: this.walletAdapter
+        });
+        const retry = await this.rawFetch(path, {
+            ...init,
+            headers: {
+                "Content-Type": "application/json",
+                "X-PAYMENT": paymentHeader,
+                ...(init.headers ?? {})
+            }
+        });
+        return this.parseResponse(retry);
+    }
+    // ── HTTP primitives ──────────────────────────────────
+    async request(path, init) {
+        const response = await this.rawFetch(path, init);
+        return this.parseResponse(response);
+    }
+    async rawFetch(path, init) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            return await fetch(`${this.baseUrl}${path}`, {
+                ...init,
+                headers: {
+                    "Content-Type": "application/json",
+                    ...(init.headers ?? {})
+                },
+                signal: controller.signal
+            });
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === "AbortError") {
+                throw new errors_1.TimeoutError();
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    async parseResponse(response) {
+        const payload = await response.json().catch(() => ({}));
+        if (!response.ok) {
+            throw new errors_1.ApiError(response.status, payload);
+        }
+        return payload;
+    }
+}
+exports.ASGCardClient = ASGCardClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors/index.d.ts

@@ -0,0 +1,17 @@
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(status: number, body: unknown);
+}
+export declare class TimeoutError extends Error {
+    constructor(message?: string);
+}
+export declare class PaymentError extends Error {
+    readonly txHash?: string;
+    constructor(message: string, txHash?: string);
+}
+export declare class InsufficientBalanceError extends Error {
+    readonly required: string;
+    readonly available: string;
+    constructor(required: string, available: string);
+}

package/dist/errors/index.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InsufficientBalanceError = exports.PaymentError = exports.TimeoutError = exports.ApiError = void 0;
+class ApiError extends Error {
+    status;
+    body;
+    constructor(status, body) {
+        super(`API error ${status}`);
+        this.status = status;
+        this.body = body;
+    }
+}
+exports.ApiError = ApiError;
+class TimeoutError extends Error {
+    constructor(message = "Request timed out") {
+        super(message);
+    }
+}
+exports.TimeoutError = TimeoutError;
+class PaymentError extends Error {
+    txHash;
+    constructor(message, txHash) {
+        super(message);
+        this.txHash = txHash;
+    }
+}
+exports.PaymentError = PaymentError;
+class InsufficientBalanceError extends Error {
+    required;
+    available;
+    constructor(required, available) {
+        super(`Insufficient USDC balance. Required: ${required}, available: ${available}`);
+        this.required = required;
+        this.available = available;
+    }
+}
+exports.InsufficientBalanceError = InsufficientBalanceError;
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":";;;AAAA,MAAa,QAAS,SAAQ,KAAK;IACxB,MAAM,CAAS;IAEf,IAAI,CAAU;IAEvB,YAAY,MAAc,EAAE,IAAa;QACvC,KAAK,CAAC,aAAa,MAAM,EAAE,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAVD,4BAUC;AAED,MAAa,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAO,GAAG,mBAAmB;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;CACF;AAJD,oCAIC;AAED,MAAa,YAAa,SAAQ,KAAK;IAC5B,MAAM,CAAU;IAEzB,YAAY,OAAe,EAAE,MAAe;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAPD,oCAOC;AAED,MAAa,wBAAyB,SAAQ,KAAK;IACxC,QAAQ,CAAS;IAEjB,SAAS,CAAS;IAE3B,YAAY,QAAgB,EAAE,SAAiB;QAC7C,KAAK,CAAC,wCAAwC,QAAQ,gBAAgB,SAAS,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAVD,4DAUC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { ASGCardClient } from "./client";
+export { ApiError, TimeoutError, PaymentError, InsufficientBalanceError } from "./errors";
+export type { ASGCardClientConfig, WalletAdapter, CreateCardParams, FundCardParams, TierResponse, TierEntry, CardResult, FundResult, HealthResponse, BillingAddress, SensitiveCardDetails, X402Challenge, X402Accept, X402PaymentPayload } from "./types";
+export { parseChallenge, checkBalance, executePayment, buildPaymentPayload, buildPaymentTransaction, handleX402Payment } from "./utils/x402";

package/dist/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleX402Payment = exports.buildPaymentTransaction = exports.buildPaymentPayload = exports.executePayment = exports.checkBalance = exports.parseChallenge = exports.InsufficientBalanceError = exports.PaymentError = exports.TimeoutError = exports.ApiError = exports.ASGCardClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "ASGCardClient", { enumerable: true, get: function () { return client_1.ASGCardClient; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "ApiError", { enumerable: true, get: function () { return errors_1.ApiError; } });
+Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function () { return errors_1.TimeoutError; } });
+Object.defineProperty(exports, "PaymentError", { enumerable: true, get: function () { return errors_1.PaymentError; } });
+Object.defineProperty(exports, "InsufficientBalanceError", { enumerable: true, get: function () { return errors_1.InsufficientBalanceError; } });
+var x402_1 = require("./utils/x402");
+Object.defineProperty(exports, "parseChallenge", { enumerable: true, get: function () { return x402_1.parseChallenge; } });
+Object.defineProperty(exports, "checkBalance", { enumerable: true, get: function () { return x402_1.checkBalance; } });
+Object.defineProperty(exports, "executePayment", { enumerable: true, get: function () { return x402_1.executePayment; } });
+Object.defineProperty(exports, "buildPaymentPayload", { enumerable: true, get: function () { return x402_1.buildPaymentPayload; } });
+Object.defineProperty(exports, "buildPaymentTransaction", { enumerable: true, get: function () { return x402_1.buildPaymentTransaction; } });
+Object.defineProperty(exports, "handleX402Payment", { enumerable: true, get: function () { return x402_1.handleX402Payment; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAyC;AAAhC,uGAAA,aAAa,OAAA;AAEtB,mCAKkB;AAJhB,kGAAA,QAAQ,OAAA;AACR,sGAAA,YAAY,OAAA;AACZ,sGAAA,YAAY,OAAA;AACZ,kHAAA,wBAAwB,OAAA;AAoB1B,qCAOsB;AANpB,sGAAA,cAAc,OAAA;AACd,oGAAA,YAAY,OAAA;AACZ,sGAAA,cAAc,OAAA;AACd,2GAAA,mBAAmB,OAAA;AACnB,+GAAA,uBAAuB,OAAA;AACvB,yGAAA,iBAAiB,OAAA"}

package/dist/types/index.d.ts

@@ -0,0 +1,130 @@
+/**
+ * @asgcard/sdk — type definitions
+ * x402 payment protocol on Stellar (Soroban SAC USDC)
+ */
+/** Adapter for external wallet signing (e.g. browser extension) */
+export interface WalletAdapter {
+    /** Stellar public key (G...) */
+    publicKey: string;
+    /** Sign a Stellar XDR transaction envelope, return signed XDR */
+    signTransaction(transactionXDR: string, networkPassphrase: string): Promise<string>;
+}
+export interface ASGCardClientConfig {
+    /** Stellar secret key (S...) — provide either this or walletAdapter */
+    privateKey?: string;
+    /** External wallet adapter — provide either this or privateKey */
+    walletAdapter?: WalletAdapter;
+    /** API base URL (default: https://api.asgcard.dev) */
+    baseUrl?: string;
+    /** Soroban RPC URL (default: https://mainnet.sorobanrpc.com) */
+    rpcUrl?: string;
+    /** Horizon URL (default: https://horizon.stellar.org) */
+    horizonUrl?: string;
+    /** Request timeout in ms (default: 60000) */
+    timeout?: number;
+}
+export interface CreateCardParams {
+    amount: 10 | 25 | 50 | 100 | 200 | 500;
+    nameOnCard: string;
+    email: string;
+}
+export interface FundCardParams {
+    amount: 10 | 25 | 50 | 100 | 200 | 500;
+    cardId: string;
+}
+export interface TierEntry {
+    loadAmount?: number;
+    fundAmount?: number;
+    totalCost: number;
+    endpoint: string;
+    breakdown?: Record<string, number>;
+}
+export interface TierResponse {
+    creation: TierEntry[];
+    funding: TierEntry[];
+}
+export interface BillingAddress {
+    street: string;
+    city: string;
+    state: string;
+    zip: string;
+    country: string;
+}
+export interface SensitiveCardDetails {
+    cardNumber: string;
+    expiryMonth: number;
+    expiryYear: number;
+    cvv: string;
+    billingAddress: BillingAddress;
+}
+export interface CardResult {
+    success: boolean;
+    card: {
+        cardId: string;
+        nameOnCard: string;
+        balance: number;
+        status: string;
+        createdAt: string;
+    };
+    payment: {
+        amountCharged: number;
+        txHash: string;
+        network: string;
+    };
+    /** Sensitive card details (agent-first model, one-time access) */
+    detailsEnvelope?: {
+        cardNumber: string;
+        expiryMonth: number;
+        expiryYear: number;
+        cvv: string;
+        billingAddress: BillingAddress;
+        oneTimeAccess: boolean;
+        expiresInSeconds: number;
+    };
+    /** @deprecated use detailsEnvelope */
+    details?: SensitiveCardDetails;
+}
+export interface FundResult {
+    success: boolean;
+    cardId: string;
+    fundedAmount: number;
+    newBalance: number;
+    payment: {
+        amountCharged: number;
+        txHash: string;
+        network: string;
+    };
+}
+export interface HealthResponse {
+    status: string;
+    timestamp: string;
+    version: string;
+}
+export interface X402Accept {
+    scheme: "exact";
+    network: string;
+    asset: string;
+    amount: string;
+    payTo: string;
+    maxTimeoutSeconds: number;
+    extra?: {
+        areFeesSponsored?: boolean;
+        [key: string]: unknown;
+    };
+}
+export interface X402Challenge {
+    x402Version: 2;
+    accepts: X402Accept[];
+    resource?: {
+        url: string;
+        description: string;
+        mimeType: string;
+    };
+}
+export interface X402PaymentPayload {
+    x402Version: 2;
+    accepted: X402Accept;
+    payload: {
+        transaction: string;
+    };
+}

package/dist/types/index.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * @asgcard/sdk — type definitions
+ * x402 payment protocol on Stellar (Soroban SAC USDC)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/utils/x402.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @asgcard/sdk — x402 payment utilities for Stellar
+ *
+ * Builds and signs Soroban SAC USDC transfer transactions
+ * for the x402 payment protocol.
+ */
+import { Keypair, rpc as StellarRpc } from "@stellar/stellar-sdk";
+import type { WalletAdapter, X402Accept } from "../types";
+export declare const parseChallenge: (input: unknown) => X402Accept;
+export declare const checkBalance: (params: {
+    rpcServer: StellarRpc.Server;
+    publicKey: string;
+    asset: string;
+    requiredAtomic: bigint;
+}) => Promise<void>;
+/**
+ * Build a Soroban SAC USDC transfer transaction, simulate, assemble and sign.
+ * Returns the signed transaction XDR string ready for the facilitator.
+ */
+export declare const buildPaymentTransaction: (params: {
+    rpcServer: StellarRpc.Server;
+    publicKey: string;
+    accept: X402Accept;
+    signer: Keypair;
+}) => Promise<string>;
+export declare const executePayment: (params: {
+    rpcServer: StellarRpc.Server;
+    accept: X402Accept;
+    keypair?: Keypair;
+    walletAdapter?: WalletAdapter;
+}) => Promise<string>;
+export declare const buildPaymentPayload: (accepted: X402Accept, signedTransactionXDR: string) => string;
+export declare const handleX402Payment: (params: {
+    rpcServer: StellarRpc.Server;
+    challengePayload: unknown;
+    keypair?: Keypair;
+    walletAdapter?: WalletAdapter;
+}) => Promise<string>;

package/dist/utils/x402.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleX402Payment = exports.buildPaymentPayload = exports.executePayment = exports.buildPaymentTransaction = exports.checkBalance = exports.parseChallenge = void 0;
+/**
+ * @asgcard/sdk — x402 payment utilities for Stellar
+ *
+ * Builds and signs Soroban SAC USDC transfer transactions
+ * for the x402 payment protocol.
+ */
+const stellar_sdk_1 = require("@stellar/stellar-sdk");
+const errors_1 = require("../errors");
+const DEFAULT_FEE = "1000000";
+const SOROBAN_TIMEOUT = 300;
+// ── Challenge parsing ────────────────────────────────────
+const isChallenge = (input) => {
+    if (!input || typeof input !== "object")
+        return false;
+    const r = input;
+    return r.x402Version === 2 && Array.isArray(r.accepts);
+};
+const parseChallenge = (input) => {
+    if (!isChallenge(input) || input.accepts.length === 0) {
+        throw new errors_1.PaymentError("Invalid x402 challenge payload");
+    }
+    return input.accepts[0];
+};
+exports.parseChallenge = parseChallenge;
+// ── Balance check ────────────────────────────────────────
+const checkBalance = async (params) => {
+    const contract = new stellar_sdk_1.Contract(params.asset);
+    const account = await params.rpcServer.getAccount(params.publicKey);
+    const tx = new stellar_sdk_1.TransactionBuilder(account, {
+        fee: DEFAULT_FEE,
+        networkPassphrase: stellar_sdk_1.Networks.PUBLIC,
+    })
+        .addOperation(contract.call("balance", (0, stellar_sdk_1.nativeToScVal)(stellar_sdk_1.Address.fromString(params.publicKey).toScAddress(), { type: "address" })))
+        .setTimeout(30)
+        .build();
+    const sim = await params.rpcServer.simulateTransaction(tx);
+    if (!stellar_sdk_1.rpc.Api.isSimulationSuccess(sim)) {
+        throw new errors_1.InsufficientBalanceError(params.requiredAtomic.toString(), "0");
+    }
+    const successSim = sim;
+    const retVal = successSim.result?.retval;
+    let balance = 0n;
+    if (retVal) {
+        try {
+            balance = BigInt(retVal.value()?.toString() ?? "0");
+        }
+        catch {
+            balance = 0n;
+        }
+    }
+    if (balance < params.requiredAtomic) {
+        throw new errors_1.InsufficientBalanceError(params.requiredAtomic.toString(), balance.toString());
+    }
+};
+exports.checkBalance = checkBalance;
+// ── Build + sign payment transaction ─────────────────────
+/**
+ * Build a Soroban SAC USDC transfer transaction, simulate, assemble and sign.
+ * Returns the signed transaction XDR string ready for the facilitator.
+ */
+const buildPaymentTransaction = async (params) => {
+    const contract = new stellar_sdk_1.Contract(params.accept.asset);
+    const sourceAccount = await params.rpcServer.getAccount(params.publicKey);
+    const tx = new stellar_sdk_1.TransactionBuilder(sourceAccount, {
+        fee: DEFAULT_FEE,
+        networkPassphrase: stellar_sdk_1.Networks.PUBLIC,
+    })
+        .addOperation(contract.call("transfer", (0, stellar_sdk_1.nativeToScVal)(stellar_sdk_1.Address.fromString(params.publicKey).toScAddress(), { type: "address" }), (0, stellar_sdk_1.nativeToScVal)(stellar_sdk_1.Address.fromString(params.accept.payTo).toScAddress(), { type: "address" }), (0, stellar_sdk_1.nativeToScVal)(BigInt(params.accept.amount), { type: "i128" })))
+        .setTimeout(SOROBAN_TIMEOUT)
+        .build();
+    // Simulate to get the auth + resource footprint
+    const sim = await params.rpcServer.simulateTransaction(tx);
+    if (!stellar_sdk_1.rpc.Api.isSimulationSuccess(sim)) {
+        const errMsg = stellar_sdk_1.rpc.Api.isSimulationError(sim)
+            ? sim.error
+            : "Simulation failed";
+        throw new errors_1.PaymentError(`Transaction simulation failed: ${errMsg}`);
+    }
+    // Assemble the transaction with simulation results (auth entries + footprint)
+    const assembled = stellar_sdk_1.rpc.assembleTransaction(tx, sim).build();
+    // Sign
+    assembled.sign(params.signer);
+    return assembled.toXDR();
+};
+exports.buildPaymentTransaction = buildPaymentTransaction;
+// ── Execute payment ──────────────────────────────────────
+const executePayment = async (params) => {
+    if (!params.keypair && !params.walletAdapter) {
+        throw new errors_1.PaymentError("No signing wallet configured");
+    }
+    const publicKey = params.keypair
+        ? params.keypair.publicKey()
+        : params.walletAdapter.publicKey;
+    // Optional balance check — non-critical
+    try {
+        await (0, exports.checkBalance)({
+            rpcServer: params.rpcServer,
+            publicKey,
+            asset: params.accept.asset,
+            requiredAtomic: BigInt(params.accept.amount),
+        });
+    }
+    catch (error) {
+        if (error instanceof errors_1.InsufficientBalanceError)
+            throw error;
+        // Swallow non-balance errors — facilitator will verify
+    }
+    // Build, simulate, assemble, sign
+    if (params.keypair) {
+        return (0, exports.buildPaymentTransaction)({
+            rpcServer: params.rpcServer,
+            publicKey,
+            accept: params.accept,
+            signer: params.keypair,
+        });
+    }
+    // WalletAdapter path
+    const adapter = params.walletAdapter;
+    const contract = new stellar_sdk_1.Contract(params.accept.asset);
+    const sourceAccount = await params.rpcServer.getAccount(publicKey);
+    const tx = new stellar_sdk_1.TransactionBuilder(sourceAccount, {
+        fee: DEFAULT_FEE,
+        networkPassphrase: stellar_sdk_1.Networks.PUBLIC,
+    })
+        .addOperation(contract.call("transfer", (0, stellar_sdk_1.nativeToScVal)(stellar_sdk_1.Address.fromString(publicKey).toScAddress(), { type: "address" }), (0, stellar_sdk_1.nativeToScVal)(stellar_sdk_1.Address.fromString(params.accept.payTo).toScAddress(), { type: "address" }), (0, stellar_sdk_1.nativeToScVal)(BigInt(params.accept.amount), { type: "i128" })))
+        .setTimeout(SOROBAN_TIMEOUT)
+        .build();
+    const sim = await params.rpcServer.simulateTransaction(tx);
+    if (!stellar_sdk_1.rpc.Api.isSimulationSuccess(sim)) {
+        throw new errors_1.PaymentError("Transaction simulation failed");
+    }
+    const assembled = stellar_sdk_1.rpc.assembleTransaction(tx, sim).build();
+    return adapter.signTransaction(assembled.toXDR(), stellar_sdk_1.Networks.PUBLIC);
+};
+exports.executePayment = executePayment;
+// ── Build x402 PaymentPayload ────────────────────────────
+const buildPaymentPayload = (accepted, signedTransactionXDR) => {
+    const payload = {
+        x402Version: 2,
+        accepted,
+        payload: {
+            transaction: signedTransactionXDR,
+        },
+    };
+    return Buffer.from(JSON.stringify(payload), "utf8").toString("base64");
+};
+exports.buildPaymentPayload = buildPaymentPayload;
+// ── Full handleX402Payment ───────────────────────────────
+const handleX402Payment = async (params) => {
+    const accept = (0, exports.parseChallenge)(params.challengePayload);
+    const signedXDR = await (0, exports.executePayment)({
+        rpcServer: params.rpcServer,
+        accept,
+        keypair: params.keypair,
+        walletAdapter: params.walletAdapter,
+    });
+    return (0, exports.buildPaymentPayload)(accept, signedXDR);
+};
+exports.handleX402Payment = handleX402Payment;
+//# sourceMappingURL=x402.js.map

package/dist/utils/x402.js.map

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

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@asgcard/sdk",
+  "version": "1.0.0",
+  "description": "SDK for ASG Card — virtual Visa cards for AI agents, paid via x402 on Stellar",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "asgcard",
+    "virtual-card",
+    "ai-agent",
+    "x402",
+    "stellar",
+    "usdc",
+    "soroban"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/asgcard/sdk"
+  },
+  "homepage": "https://asgcard.dev",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@stellar/stellar-sdk": "^13.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.30",
+    "typescript": "^5.8.3"
+  }
+}