@agenticocean/x402-stellar 1.0.0

package/README.md

@@ -0,0 +1,148 @@
+# @agentsea/x402-stellar
+
+x402 payment protocol for Stellar — header builder, facilitator, and Express middleware for AI agent micropayments.
+
+## Installation
+
+```bash
+npm install @agentsea/x402-stellar
+# or
+pnpm add @agentsea/x402-stellar
+```
+
+## Quick Start
+
+### 1. Build an x402 Payment Header (Agent side)
+
+```typescript
+import { buildX402Header } from "@agentsea/x402-stellar";
+
+const header = await buildX402Header({
+  rpcUrl: "https://soroban-testnet.stellar.org",
+  networkPassphrase: "Test SDF Network ; September 2015",
+  vaultContract: "CVAULT...",
+  agentSigner: "GAGENT...",
+  agentSecret: "SAGENT_SECRET...",
+  payTo: "GFACILITATOR...",
+  amount: "100000",        // 0.01 USDC in stroops
+  memo: "yield_query_v1",
+  agentId: 1,
+  usdcAddress: "CUSDC...",
+});
+
+// Use in API request
+const response = await fetch("https://api.example.com/yield/query", {
+  headers: { "X-PAYMENT": header },
+});
+```
+
+### 2. Gate your API with x402 Middleware (Vendor side)
+
+```typescript
+import express from "express";
+import { createX402Middleware } from "@agentsea/x402-stellar";
+
+const app = express();
+
+const x402 = createX402Middleware({
+  rpcUrl: "https://soroban-testnet.stellar.org",
+  horizonUrl: "https://horizon-testnet.stellar.org",
+  networkPassphrase: "Test SDF Network ; September 2015",
+  facilitatorSecret: process.env.FACILITATOR_SECRET!,
+  usdcAddress: "CUSDC...",
+});
+
+// Gate a route — returns 402 if unpaid, 200 if paid
+app.get("/premium-data", x402({ price: "100000", description: "Premium AI data" }), (req, res) => {
+  res.json({ data: "...", payment: req.x402 });
+});
+
+app.listen(3001);
+```
+
+### 3. Settle a Payment (Facilitator side)
+
+```typescript
+import { settlePayment } from "@agentsea/x402-stellar";
+
+const result = await settlePayment(paymentPayload, {
+  rpcUrl: "https://soroban-testnet.stellar.org",
+  horizonUrl: "https://horizon-testnet.stellar.org",
+  networkPassphrase: "Test SDF Network ; September 2015",
+  facilitatorSecret: process.env.FACILITATOR_SECRET!,
+});
+
+console.log(result.success, result.txHash);
+```
+
+## API Reference
+
+### `buildX402Header(params)`
+
+Builds a base64-encoded x402 payment header. Signs a `vault.agent_pay()` invocation with the agent's key.
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `rpcUrl` | `string` | Soroban RPC endpoint |
+| `networkPassphrase` | `string` | Network passphrase |
+| `vaultContract` | `string` | User vault contract address |
+| `agentSigner` | `string` | Agent's public key |
+| `agentSecret` | `string` | Agent's secret key (for signing auth entry) |
+| `payTo` | `string` | Facilitator's public key (payment destination) |
+| `amount` | `string` | Amount in stroops (7 decimals) |
+| `memo` | `string` | Audit memo |
+| `agentId` | `number` | Agent's registry ID |
+| `usdcAddress` | `string` | USDC SAC contract address |
+
+### `createX402Middleware(options)`
+
+Returns an Express middleware factory. Call with route config to create per-route middleware.
+
+```typescript
+const x402 = createX402Middleware({ ...options });
+
+// returns middleware:
+x402({ price: "100000", description: "..." })
+```
+
+### `settlePayment(payload, options)`
+
+Verifies and executes payment on-chain. Returns `{ success, txHash?, error? }`.
+
+### `formatUsdc(stroops)`
+
+Convert stroops to human-readable USDC string.
+
+```typescript
+formatUsdc("100000") // → "0.01"
+formatUsdc(10_000_000n) // → "1.00"
+```
+
+### `toStroops(usdc)`
+
+Convert USDC amount to stroops (bigint).
+
+```typescript
+toStroops(0.01) // → 100000n
+toStroops(5) // → 50000000n
+```
+
+### Network Config
+
+```typescript
+import { TESTNET, MAINNET } from "@agentsea/x402-stellar";
+
+// TESTNET: soroban-testnet.stellar.org
+// MAINNET: soroban.stellar.org
+```
+
+## Stellar USDC Decimals
+
+**Important**: Stellar USDC uses 7 decimal places (not 6 like EVM).
+
+- `1 USDC = 10,000,000 stroops`
+- `0.01 USDC = 100,000 stroops`
+
+## License
+
+MIT — StellarAgent402

package/dist/config.d.ts

@@ -0,0 +1,31 @@
+export interface StellarNetworkConfig {
+    rpcUrl: string;
+    horizonUrl: string;
+    networkPassphrase: string;
+    friendbotUrl?: string;
+    explorerUrl?: string;
+}
+export declare const TESTNET: StellarNetworkConfig;
+export declare const MAINNET: StellarNetworkConfig;
+export declare const STELLAR_CONFIG: {
+    readonly testnet: {
+        readonly rpcUrl: string;
+        readonly horizonUrl: string;
+        readonly networkPassphrase: string;
+        readonly friendbotUrl: string;
+        readonly explorerUrl: string;
+    };
+    readonly mainnet: {
+        readonly rpcUrl: string;
+        readonly horizonUrl: string;
+        readonly networkPassphrase: string;
+        readonly friendbotUrl: "";
+        readonly explorerUrl: string;
+    };
+};
+export type StellarNetwork = keyof typeof STELLAR_CONFIG;
+export declare const USDC_DECIMALS = 7;
+export declare const STROOPS_PER_USDC = 10000000;
+export declare function formatUsdc(stroops: string | number | bigint): string;
+export declare function toStroops(usdc: number): bigint;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,OAAO,EAAE,oBAMrB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,oBAKrB,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;CAejB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,cAAc,CAAC;AAIzD,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,gBAAgB,WAAa,CAAC;AAI3C,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAOpE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/config.js

@@ -0,0 +1,46 @@
+// ── Stellar Network Configuration ──
+export const TESTNET = {
+    rpcUrl: "https://soroban-testnet.stellar.org",
+    horizonUrl: "https://horizon-testnet.stellar.org",
+    networkPassphrase: "Test SDF Network ; September 2015",
+    friendbotUrl: "https://friendbot.stellar.org",
+    explorerUrl: "https://stellar.expert/explorer/testnet",
+};
+export const MAINNET = {
+    rpcUrl: "https://soroban.stellar.org",
+    horizonUrl: "https://horizon.stellar.org",
+    networkPassphrase: "Public Global Stellar Network ; September 2015",
+    explorerUrl: "https://stellar.expert/explorer/public",
+};
+export const STELLAR_CONFIG = {
+    testnet: {
+        rpcUrl: TESTNET.rpcUrl,
+        horizonUrl: TESTNET.horizonUrl,
+        networkPassphrase: TESTNET.networkPassphrase,
+        friendbotUrl: TESTNET.friendbotUrl,
+        explorerUrl: TESTNET.explorerUrl,
+    },
+    mainnet: {
+        rpcUrl: MAINNET.rpcUrl,
+        horizonUrl: MAINNET.horizonUrl,
+        networkPassphrase: MAINNET.networkPassphrase,
+        friendbotUrl: "",
+        explorerUrl: MAINNET.explorerUrl,
+    },
+};
+// ── USDC Constants ──
+export const USDC_DECIMALS = 7;
+export const STROOPS_PER_USDC = 10_000_000;
+// ── Utility Functions ──
+export function formatUsdc(stroops) {
+    const amount = typeof stroops === "bigint"
+        ? Number(stroops)
+        : typeof stroops === "string"
+            ? parseInt(stroops)
+            : stroops;
+    return (amount / STROOPS_PER_USDC).toFixed(2);
+}
+export function toStroops(usdc) {
+    return BigInt(Math.round(usdc * STROOPS_PER_USDC));
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAUtC,MAAM,CAAC,MAAM,OAAO,GAAyB;IAC3C,MAAM,EAAE,qCAAqC;IAC7C,UAAU,EAAE,qCAAqC;IACjD,iBAAiB,EAAE,mCAAmC;IACtD,YAAY,EAAE,+BAA+B;IAC7C,WAAW,EAAE,yCAAyC;CACvD,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAyB;IAC3C,MAAM,EAAE,6BAA6B;IACrC,UAAU,EAAE,6BAA6B;IACzC,iBAAiB,EAAE,gDAAgD;IACnE,WAAW,EAAE,wCAAwC;CACtD,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE;QACP,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;QAC5C,YAAY,EAAE,OAAO,CAAC,YAAa;QACnC,WAAW,EAAE,OAAO,CAAC,WAAY;KAClC;IACD,OAAO,EAAE;QACP,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;QAC5C,YAAY,EAAE,EAAE;QAChB,WAAW,EAAE,OAAO,CAAC,WAAY;KAClC;CACO,CAAC;AAIX,uBAAuB;AAEvB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAC/B,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAE3C,0BAA0B;AAE1B,MAAM,UAAU,UAAU,CAAC,OAAiC;IAC1D,MAAM,MAAM,GAAG,OAAO,OAAO,KAAK,QAAQ;QACxC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QACjB,CAAC,CAAC,OAAO,OAAO,KAAK,QAAQ;YAC3B,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YACnB,CAAC,CAAC,OAAO,CAAC;IACd,OAAO,CAAC,MAAM,GAAG,gBAAgB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,gBAAgB,CAAC,CAAC,CAAC;AACrD,CAAC"}

package/dist/facilitator.d.ts

@@ -0,0 +1,25 @@
+import type { PaymentPayload, SettlementResult, LoggerLike } from "./types.js";
+export interface SettlementOptions {
+    rpcUrl: string;
+    horizonUrl: string;
+    networkPassphrase: string;
+    facilitatorSecret: string;
+    logger?: LoggerLike;
+}
+/**
+ * Settle an x402 payment by submitting the agent's pre-assembled transaction.
+ *
+ * Flow:
+ * 1. If the header includes assembledTxXdr (recommended):
+ *    - Deserialize the pre-assembled transaction
+ *    - Sign as facilitator (pays XLM fees)
+ *    - Submit directly
+ *
+ * 2. Fallback (legacy, no assembledTxXdr):
+ *    - Build and simulate our own transaction
+ *    - Inject the agent's signed auth entry
+ *    - Assemble, sign, submit
+ *    (May fail due to auth nonce/footprint mismatch)
+ */
+export declare function settlePayment(payload: PaymentPayload, options: SettlementOptions): Promise<SettlementResult>;
+//# sourceMappingURL=facilitator.d.ts.map

package/dist/facilitator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facilitator.d.ts","sourceRoot":"","sources":["../src/facilitator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE/E,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAoG3B"}

package/dist/facilitator.js

@@ -0,0 +1,102 @@
+import { Keypair, TransactionBuilder, Contract, nativeToScVal, xdr, } from "@stellar/stellar-sdk";
+import { Server, assembleTransaction } from "@stellar/stellar-sdk/rpc";
+/**
+ * Settle an x402 payment by submitting the agent's pre-assembled transaction.
+ *
+ * Flow:
+ * 1. If the header includes assembledTxXdr (recommended):
+ *    - Deserialize the pre-assembled transaction
+ *    - Sign as facilitator (pays XLM fees)
+ *    - Submit directly
+ *
+ * 2. Fallback (legacy, no assembledTxXdr):
+ *    - Build and simulate our own transaction
+ *    - Inject the agent's signed auth entry
+ *    - Assemble, sign, submit
+ *    (May fail due to auth nonce/footprint mismatch)
+ */
+export async function settlePayment(payload, options) {
+    const { payload: p } = payload;
+    const log = options.logger ?? console;
+    const rpc = new Server(options.rpcUrl);
+    if (!options.facilitatorSecret) {
+        return { success: false, error: "Facilitator key not configured" };
+    }
+    try {
+        const facilitator = Keypair.fromSecret(options.facilitatorSecret);
+        let assembled;
+        if (p.assembledTxXdr) {
+            assembled = TransactionBuilder.fromXDR(p.assembledTxXdr, options.networkPassphrase);
+        }
+        else {
+            const vault = new Contract(p.vaultContract);
+            const account = await rpc.getAccount(facilitator.publicKey());
+            const tx = new TransactionBuilder(account, {
+                fee: "1000000",
+                networkPassphrase: options.networkPassphrase,
+            })
+                .addOperation(vault.call("agent_pay", nativeToScVal(p.agentSigner, { type: "address" }), nativeToScVal(p.payTo, { type: "address" }), nativeToScVal(BigInt(p.amount), { type: "i128" }), nativeToScVal(p.memo, { type: "symbol" })))
+                .setTimeout(60)
+                .build();
+            const sim = await rpc.simulateTransaction(tx);
+            if (!("result" in sim)) {
+                return { success: false, error: "simulation failed" };
+            }
+            const signedAuth = xdr.SorobanAuthorizationEntry.fromXDR(p.signedAuthEntry, "base64");
+            if (sim.result?.auth) {
+                sim.result.auth = [signedAuth];
+            }
+            assembled = assembleTransaction(tx, sim).build();
+        }
+        assembled.sign(facilitator);
+        const result = await rpc.sendTransaction(assembled);
+        if (result.status !== "PENDING") {
+            return { success: false, error: `send: ${result.status}` };
+        }
+        try {
+            let txResult = await rpc.getTransaction(result.hash);
+            let waited = 0;
+            while (txResult.status === "NOT_FOUND" && waited < 30) {
+                await new Promise(r => setTimeout(r, 1000));
+                txResult = await rpc.getTransaction(result.hash);
+                waited++;
+            }
+            if (txResult.status === "SUCCESS") {
+                log.info("x402 settled", { txHash: result.hash, amount: p.amount });
+                return { success: true, txHash: result.hash };
+            }
+            if (txResult.status === "NOT_FOUND") {
+                log.warn("x402 tx still pending after 30s", { txHash: result.hash });
+                return { success: true, txHash: result.hash };
+            }
+            return { success: false, error: `tx: ${txResult.status}` };
+        }
+        catch (pollErr) {
+            log.warn("getTransaction parse error, checking Horizon", {
+                txHash: result.hash,
+                error: pollErr.message,
+            });
+            try {
+                await new Promise(r => setTimeout(r, 5000));
+                const horizonResp = await fetch(`${options.horizonUrl}/transactions/${result.hash}`);
+                if (horizonResp.ok) {
+                    const horizonTx = await horizonResp.json();
+                    if (horizonTx.successful) {
+                        log.info("x402 settled (Horizon)", { txHash: result.hash, amount: p.amount });
+                        return { success: true, txHash: result.hash };
+                    }
+                    return { success: false, error: `tx failed: ${horizonTx.result_xdr}` };
+                }
+                log.info("x402 tx submitted", { txHash: result.hash });
+                return { success: true, txHash: result.hash };
+            }
+            catch {
+                return { success: true, txHash: result.hash };
+            }
+        }
+    }
+    catch (err) {
+        return { success: false, error: err.message };
+    }
+}
+//# sourceMappingURL=facilitator.js.map

package/dist/facilitator.js.map

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

package/dist/header-builder.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Build an X-PAYMENT header for x402 protocol.
+ *
+ * This is the agent-side function. It:
+ * 1. Simulates vault.agent_pay() to get the required SorobanAuthorizationEntry
+ * 2. Signs the auth entry with the agent's private key (authorizeEntry)
+ * 3. Assembles the full transaction (to capture the correct footprint + resources)
+ * 4. Packages the signed auth entry AND assembled transaction XDR
+ *
+ * CRITICAL: The assembled transaction XDR is included because it contains the
+ * footprint with the correct auth nonce. If the facilitator re-simulates, it
+ * gets a DIFFERENT nonce, causing an INVOKE_HOST_FUNCTION_TRAPPED error.
+ */
+export declare function buildX402Header(params: {
+    rpcUrl: string;
+    networkPassphrase: string;
+    vaultContract: string;
+    agentSigner: string;
+    agentSecret: string;
+    payTo: string;
+    amount: string;
+    memo: string;
+    agentId: number;
+    usdcAddress: string;
+    facilitatorPublicKey?: string;
+}): Promise<string>;
+//# sourceMappingURL=header-builder.d.ts.map

package/dist/header-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-builder.d.ts","sourceRoot":"","sources":["../src/header-builder.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,GAAG,OAAO,CAAC,MAAM,CAAC,CAkElB"}

package/dist/header-builder.js

@@ -0,0 +1,62 @@
+import { Keypair, TransactionBuilder, Contract, nativeToScVal, authorizeEntry, } from "@stellar/stellar-sdk";
+import { Server, assembleTransaction } from "@stellar/stellar-sdk/rpc";
+/**
+ * Build an X-PAYMENT header for x402 protocol.
+ *
+ * This is the agent-side function. It:
+ * 1. Simulates vault.agent_pay() to get the required SorobanAuthorizationEntry
+ * 2. Signs the auth entry with the agent's private key (authorizeEntry)
+ * 3. Assembles the full transaction (to capture the correct footprint + resources)
+ * 4. Packages the signed auth entry AND assembled transaction XDR
+ *
+ * CRITICAL: The assembled transaction XDR is included because it contains the
+ * footprint with the correct auth nonce. If the facilitator re-simulates, it
+ * gets a DIFFERENT nonce, causing an INVOKE_HOST_FUNCTION_TRAPPED error.
+ */
+export async function buildX402Header(params) {
+    const rpc = new Server(params.rpcUrl);
+    const agentKp = Keypair.fromSecret(params.agentSecret);
+    const vault = new Contract(params.vaultContract);
+    const sourcePub = params.facilitatorPublicKey || agentKp.publicKey();
+    const account = await rpc.getAccount(sourcePub);
+    const tx = new TransactionBuilder(account, {
+        fee: "1000000",
+        networkPassphrase: params.networkPassphrase,
+    })
+        .addOperation(vault.call("agent_pay", nativeToScVal(params.agentSigner, { type: "address" }), nativeToScVal(params.payTo, { type: "address" }), nativeToScVal(BigInt(params.amount), { type: "i128" }), nativeToScVal(params.memo, { type: "symbol" })))
+        .setTimeout(60)
+        .build();
+    const sim = await rpc.simulateTransaction(tx);
+    if (!("result" in sim)) {
+        const errorMsg = "error" in sim ? `${sim.error}` : "Unknown simulation error";
+        console.error("x402 simulation failed:", JSON.stringify(sim, null, 2));
+        throw new Error(`Simulation failed: ${errorMsg}`);
+    }
+    const authEntries = sim.result?.auth || [];
+    if (authEntries.length === 0)
+        throw new Error("No auth entries from simulation");
+    const latestLedger = sim.latestLedger;
+    const validUntilLedger = latestLedger + 1000;
+    const signedAuth = await authorizeEntry(authEntries[0], agentKp, validUntilLedger, params.networkPassphrase);
+    sim.result.auth = [signedAuth];
+    const assembled = assembleTransaction(tx, sim).build();
+    const payload = {
+        x402Version: 1,
+        scheme: "stellar-vault",
+        network: "stellar:testnet",
+        payload: {
+            vaultContract: params.vaultContract,
+            agentId: params.agentId,
+            agentSigner: params.agentSigner,
+            payTo: params.payTo,
+            amount: params.amount,
+            asset: params.usdcAddress,
+            memo: params.memo,
+            signedAuthEntry: signedAuth.toXDR("base64"),
+            assembledTxXdr: assembled.toXDR(),
+            expirationLedger: validUntilLedger,
+        },
+    };
+    return Buffer.from(JSON.stringify(payload)).toString("base64");
+}
+//# sourceMappingURL=header-builder.js.map

package/dist/header-builder.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export type { PaymentRequirements, PaymentAccept, PaymentPayload, PaymentResponse, SettlementResult, X402RouteConfig, LoggerLike, } from "./types.js";
+export { ErrorCode, AgentNetError } from "./types.js";
+export { STELLAR_CONFIG, TESTNET, MAINNET, USDC_DECIMALS, STROOPS_PER_USDC, formatUsdc, toStroops, } from "./config.js";
+export type { StellarNetworkConfig, StellarNetwork } from "./config.js";
+export { buildX402Header } from "./header-builder.js";
+export { settlePayment } from "./facilitator.js";
+export type { SettlementOptions } from "./facilitator.js";
+export { createX402Middleware } from "./middleware.js";
+export type { X402MiddlewareOptions } from "./middleware.js";
+export { buildAndSubmitTx, fundAccount } from "./stellar-tx.js";
+export { createRpcClient, getAccount, getLatestLedger, generateKeypair } from "./stellar-client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGtD,OAAO,EACL,cAAc,EACd,OAAO,EACP,OAAO,EACP,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGxE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAG7D,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGhE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export { ErrorCode, AgentNetError } from "./types.js";
+// ── Config ──
+export { STELLAR_CONFIG, TESTNET, MAINNET, USDC_DECIMALS, STROOPS_PER_USDC, formatUsdc, toStroops, } from "./config.js";
+// ── Header Builder ──
+export { buildX402Header } from "./header-builder.js";
+// ── Facilitator ──
+export { settlePayment } from "./facilitator.js";
+// ── Middleware ──
+export { createX402Middleware } from "./middleware.js";
+// ── Stellar Transaction Helpers ──
+export { buildAndSubmitTx, fundAccount } from "./stellar-tx.js";
+// ── Stellar Client ──
+export { createRpcClient, getAccount, getLatestLedger, generateKeypair } from "./stellar-client.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEtD,eAAe;AACf,OAAO,EACL,cAAc,EACd,OAAO,EACP,OAAO,EACP,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,SAAS,GACV,MAAM,aAAa,CAAC;AAGrB,uBAAuB;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,oBAAoB;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,mBAAmB;AACnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAGvD,oCAAoC;AACpC,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEhE,uBAAuB;AACvB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/middleware.d.ts

@@ -0,0 +1,27 @@
+import type { X402RouteConfig, LoggerLike } from "./types.js";
+export interface X402MiddlewareOptions {
+    rpcUrl: string;
+    horizonUrl: string;
+    networkPassphrase: string;
+    facilitatorSecret: string;
+    usdcAddress: string;
+    logger?: LoggerLike;
+}
+/**
+ * Factory that creates an x402 middleware function for Express.
+ *
+ * Usage:
+ * ```ts
+ * const x402 = createX402Middleware({
+ *   rpcUrl: "https://soroban-testnet.stellar.org",
+ *   horizonUrl: "https://horizon-testnet.stellar.org",
+ *   networkPassphrase: "Test SDF Network ; September 2015",
+ *   facilitatorSecret: "S...",
+ *   usdcAddress: "C...",
+ * });
+ *
+ * app.use("/api/paid", x402({ price: "100000", description: "Query" }));
+ * ```
+ */
+export declare function createX402Middleware(options: X402MiddlewareOptions): (routeConfig: X402RouteConfig) => (req: any, res: any, next: any) => Promise<any>;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE9D,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,IAM5C,aAAa,eAAe,MACjC,KAAK,GAAG,EAAE,KAAK,GAAG,EAAE,MAAM,GAAG,kBA0D9C"}

package/dist/middleware.js

@@ -0,0 +1,77 @@
+import { Keypair } from "@stellar/stellar-sdk";
+import { settlePayment } from "./facilitator.js";
+/**
+ * Factory that creates an x402 middleware function for Express.
+ *
+ * Usage:
+ * ```ts
+ * const x402 = createX402Middleware({
+ *   rpcUrl: "https://soroban-testnet.stellar.org",
+ *   horizonUrl: "https://horizon-testnet.stellar.org",
+ *   networkPassphrase: "Test SDF Network ; September 2015",
+ *   facilitatorSecret: "S...",
+ *   usdcAddress: "C...",
+ * });
+ *
+ * app.use("/api/paid", x402({ price: "100000", description: "Query" }));
+ * ```
+ */
+export function createX402Middleware(options) {
+    const log = options.logger ?? console;
+    const facilitatorPubkey = options.facilitatorSecret
+        ? Keypair.fromSecret(options.facilitatorSecret).publicKey()
+        : "GFACILITATOR_PLACEHOLDER";
+    return function x402(routeConfig) {
+        return async (req, res, next) => {
+            const paymentHeader = req.headers["x-payment"];
+            if (!paymentHeader) {
+                return res.status(402).json({
+                    x402Version: 1,
+                    accepts: [{
+                            scheme: "stellar-vault",
+                            network: "stellar:testnet",
+                            asset: options.usdcAddress,
+                            amount: routeConfig.price,
+                            payTo: facilitatorPubkey,
+                            maxTimeoutSeconds: 60,
+                            description: routeConfig.description,
+                        }],
+                });
+            }
+            try {
+                const payload = JSON.parse(Buffer.from(paymentHeader, "base64").toString("utf-8"));
+                if (payload.scheme !== "stellar-vault") {
+                    return res.status(402).json({ error: "unsupported scheme" });
+                }
+                if (BigInt(payload.payload.amount) < BigInt(routeConfig.price)) {
+                    return res.status(402).json({ error: "insufficient amount" });
+                }
+                const result = await settlePayment(payload, {
+                    rpcUrl: options.rpcUrl,
+                    horizonUrl: options.horizonUrl,
+                    networkPassphrase: options.networkPassphrase,
+                    facilitatorSecret: options.facilitatorSecret,
+                    logger: log,
+                });
+                if (result.success) {
+                    req.x402 = {
+                        txHash: result.txHash,
+                        payer: payload.payload.vaultContract,
+                        agentId: payload.payload.agentId,
+                    };
+                    res.setHeader("X-PAYMENT-RESPONSE", JSON.stringify({
+                        txHash: result.txHash,
+                        network: "stellar:testnet",
+                    }));
+                    return next();
+                }
+                return res.status(402).json({ error: result.error });
+            }
+            catch (err) {
+                log.error("x402 payment failed", { error: err.message });
+                return res.status(402).json({ error: err.message });
+            }
+        };
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

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

package/dist/stellar-client.d.ts

@@ -0,0 +1,19 @@
+import { Keypair } from "@stellar/stellar-sdk";
+import { Server } from "@stellar/stellar-sdk/rpc";
+/**
+ * Create a Soroban RPC client.
+ */
+export declare function createRpcClient(rpcUrl: string): Server;
+/**
+ * Get account details from the RPC.
+ */
+export declare function getAccount(rpc: Server, publicKey: string): Promise<import("@stellar/stellar-sdk").Account>;
+/**
+ * Get the latest ledger sequence from the RPC.
+ */
+export declare function getLatestLedger(rpc: Server): Promise<import("@stellar/stellar-sdk/rpc").Api.GetLatestLedgerResponse>;
+/**
+ * Generate a random Stellar keypair.
+ */
+export declare function generateKeypair(): Keypair;
+//# sourceMappingURL=stellar-client.d.ts.map

package/dist/stellar-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stellar-client.d.ts","sourceRoot":"","sources":["../src/stellar-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAElD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,mDAE9D;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,2EAEhD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC"}

package/dist/stellar-client.js

@@ -0,0 +1,27 @@
+import { Keypair } from "@stellar/stellar-sdk";
+import { Server } from "@stellar/stellar-sdk/rpc";
+/**
+ * Create a Soroban RPC client.
+ */
+export function createRpcClient(rpcUrl) {
+    return new Server(rpcUrl);
+}
+/**
+ * Get account details from the RPC.
+ */
+export async function getAccount(rpc, publicKey) {
+    return rpc.getAccount(publicKey);
+}
+/**
+ * Get the latest ledger sequence from the RPC.
+ */
+export async function getLatestLedger(rpc) {
+    return rpc.getLatestLedger();
+}
+/**
+ * Generate a random Stellar keypair.
+ */
+export function generateKeypair() {
+    return Keypair.random();
+}
+//# sourceMappingURL=stellar-client.js.map

package/dist/stellar-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stellar-client.js","sourceRoot":"","sources":["../src/stellar-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAElD;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW,EAAE,SAAiB;IAC7D,OAAO,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW;IAC/C,OAAO,GAAG,CAAC,eAAe,EAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;AAC1B,CAAC"}

package/dist/stellar-tx.d.ts

@@ -0,0 +1,18 @@
+import type { LoggerLike } from "./types.js";
+/**
+ * Build, simulate, sign, and submit a Soroban transaction.
+ */
+export declare function buildAndSubmitTx(params: {
+    rpcUrl: string;
+    networkPassphrase: string;
+    signerSecret: string;
+    operations: any[];
+    logger?: LoggerLike;
+}): Promise<{
+    txHash: string;
+}>;
+/**
+ * Fund an account on Stellar testnet via friendbot.
+ */
+export declare function fundAccount(publicKey: string, logger?: LoggerLike): Promise<void>;
+//# sourceMappingURL=stellar-tx.d.ts.map

package/dist/stellar-tx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stellar-tx.d.ts","sourceRoot":"","sources":["../src/stellar-tx.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,GAAG,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA8B9B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/stellar-tx.js

@@ -0,0 +1,45 @@
+import { Keypair, TransactionBuilder } from "@stellar/stellar-sdk";
+import { Server, assembleTransaction } from "@stellar/stellar-sdk/rpc";
+/**
+ * Build, simulate, sign, and submit a Soroban transaction.
+ */
+export async function buildAndSubmitTx(params) {
+    const rpc = new Server(params.rpcUrl);
+    const keypair = Keypair.fromSecret(params.signerSecret);
+    const account = await rpc.getAccount(keypair.publicKey());
+    const builder = new TransactionBuilder(account, {
+        fee: "1000000",
+        networkPassphrase: params.networkPassphrase,
+    });
+    for (const op of params.operations)
+        builder.addOperation(op);
+    const tx = builder.setTimeout(60).build();
+    const sim = await rpc.simulateTransaction(tx);
+    if (!("result" in sim))
+        throw new Error("Simulation failed");
+    const assembled = assembleTransaction(tx, sim).build();
+    assembled.sign(keypair);
+    const result = await rpc.sendTransaction(assembled);
+    if (result.status !== "PENDING")
+        throw new Error(`Send: ${result.status}`);
+    let txResult = await rpc.getTransaction(result.hash);
+    let waited = 0;
+    while (txResult.status === "NOT_FOUND" && waited < 30) {
+        await new Promise(r => setTimeout(r, 1000));
+        txResult = await rpc.getTransaction(result.hash);
+        waited++;
+    }
+    if (txResult.status !== "SUCCESS")
+        throw new Error(`Tx: ${txResult.status}`);
+    return { txHash: result.hash };
+}
+/**
+ * Fund an account on Stellar testnet via friendbot.
+ */
+export async function fundAccount(publicKey, logger) {
+    const response = await fetch(`https://friendbot.stellar.org/?addr=${publicKey}`);
+    if (!response.ok)
+        throw new Error(`Friendbot failed: ${response.statusText}`);
+    (logger ?? console).info("Account funded via friendbot", { publicKey });
+}
+//# sourceMappingURL=stellar-tx.js.map

package/dist/stellar-tx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stellar-tx.js","sourceRoot":"","sources":["../src/stellar-tx.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGvE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAMtC;IACC,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAE1D,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,OAAO,EAAE;QAC9C,GAAG,EAAE,SAAS;QACd,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;KAC5C,CAAC,CAAC;IACH,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,UAAU;QAAE,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAC7D,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;IAE1C,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;IAC9C,IAAI,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAE7D,MAAM,SAAS,GAAG,mBAAmB,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;IACvD,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAExB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IACpD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAE3E,IAAI,QAAQ,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,QAAQ,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,GAAG,EAAE,EAAE,CAAC;QACtD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QAC5C,QAAQ,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,EAAE,CAAC;IACX,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7E,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,SAAiB,EACjB,MAAmB;IAEnB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,uCAAuC,SAAS,EAAE,CAAC,CAAC;IACjF,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IAC9E,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;AAC1E,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,69 @@
+export interface PaymentRequirements {
+    x402Version: number;
+    accepts: PaymentAccept[];
+}
+export interface PaymentAccept {
+    scheme: string;
+    network: string;
+    asset: string;
+    amount: string;
+    payTo: string;
+    maxTimeoutSeconds: number;
+    description: string;
+}
+export interface PaymentPayload {
+    x402Version: number;
+    scheme: string;
+    network: string;
+    payload: {
+        vaultContract: string;
+        agentId: number;
+        agentSigner: string;
+        payTo: string;
+        amount: string;
+        asset: string;
+        memo: string;
+        signedAuthEntry: string;
+        assembledTxXdr?: string;
+        expirationLedger: number;
+    };
+}
+export interface PaymentResponse {
+    txHash: string;
+    network: string;
+}
+export interface SettlementResult {
+    success: boolean;
+    txHash?: string;
+    error?: string;
+}
+export interface X402RouteConfig {
+    price: string;
+    description: string;
+}
+export declare enum ErrorCode {
+    WALLET_NOT_CONNECTED = "WALLET_NOT_CONNECTED",
+    VAULT_NOT_FOUND = "VAULT_NOT_FOUND",
+    AGENT_NOT_FOUND = "AGENT_NOT_FOUND",
+    INSUFFICIENT_BALANCE = "INSUFFICIENT_BALANCE",
+    TX_FAILED = "TX_FAILED",
+    X402_PAYMENT_REQUIRED = "X402_PAYMENT_REQUIRED",
+    X402_SETTLEMENT_FAILED = "X402_SETTLEMENT_FAILED",
+    SIMULATION_FAILED = "SIMULATION_FAILED",
+    REPUTATION_NOT_FOUND = "REPUTATION_NOT_FOUND",
+    INVALID_SCORE = "INVALID_SCORE",
+    VALIDATION_NOT_FOUND = "VALIDATION_NOT_FOUND",
+    VALIDATION_ALREADY_COMPLETED = "VALIDATION_ALREADY_COMPLETED",
+    NOT_VALIDATOR = "NOT_VALIDATOR"
+}
+export declare class AgentNetError extends Error {
+    code: ErrorCode;
+    constructor(code: ErrorCode, message: string);
+}
+export interface LoggerLike {
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+    debug(message: string, ...args: any[]): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,oBAAY,SAAS;IACnB,oBAAoB,yBAAyB;IAC7C,eAAe,oBAAoB;IACnC,eAAe,oBAAoB;IACnC,oBAAoB,yBAAyB;IAC7C,SAAS,cAAc;IACvB,qBAAqB,0BAA0B;IAC/C,sBAAsB,2BAA2B;IACjD,iBAAiB,sBAAsB;IACvC,oBAAoB,yBAAyB;IAC7C,aAAa,kBAAkB;IAC/B,oBAAoB,yBAAyB;IAC7C,4BAA4B,iCAAiC;IAC7D,aAAa,kBAAkB;CAChC;AAED,qBAAa,aAAc,SAAQ,KAAK;IAE7B,IAAI,EAAE,SAAS;gBAAf,IAAI,EAAE,SAAS,EACtB,OAAO,EAAE,MAAM;CAKlB;AAID,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC7C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;CAC9C"}

package/dist/types.js

@@ -0,0 +1,27 @@
+// ── x402 Protocol Types ──
+// ── Error Types ──
+export var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode["WALLET_NOT_CONNECTED"] = "WALLET_NOT_CONNECTED";
+    ErrorCode["VAULT_NOT_FOUND"] = "VAULT_NOT_FOUND";
+    ErrorCode["AGENT_NOT_FOUND"] = "AGENT_NOT_FOUND";
+    ErrorCode["INSUFFICIENT_BALANCE"] = "INSUFFICIENT_BALANCE";
+    ErrorCode["TX_FAILED"] = "TX_FAILED";
+    ErrorCode["X402_PAYMENT_REQUIRED"] = "X402_PAYMENT_REQUIRED";
+    ErrorCode["X402_SETTLEMENT_FAILED"] = "X402_SETTLEMENT_FAILED";
+    ErrorCode["SIMULATION_FAILED"] = "SIMULATION_FAILED";
+    ErrorCode["REPUTATION_NOT_FOUND"] = "REPUTATION_NOT_FOUND";
+    ErrorCode["INVALID_SCORE"] = "INVALID_SCORE";
+    ErrorCode["VALIDATION_NOT_FOUND"] = "VALIDATION_NOT_FOUND";
+    ErrorCode["VALIDATION_ALREADY_COMPLETED"] = "VALIDATION_ALREADY_COMPLETED";
+    ErrorCode["NOT_VALIDATOR"] = "NOT_VALIDATOR";
+})(ErrorCode || (ErrorCode = {}));
+export class AgentNetError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "AgentNetError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAqD5B,oBAAoB;AAEpB,MAAM,CAAN,IAAY,SAcX;AAdD,WAAY,SAAS;IACnB,0DAA6C,CAAA;IAC7C,gDAAmC,CAAA;IACnC,gDAAmC,CAAA;IACnC,0DAA6C,CAAA;IAC7C,oCAAuB,CAAA;IACvB,4DAA+C,CAAA;IAC/C,8DAAiD,CAAA;IACjD,oDAAuC,CAAA;IACvC,0DAA6C,CAAA;IAC7C,4CAA+B,CAAA;IAC/B,0DAA6C,CAAA;IAC7C,0EAA6D,CAAA;IAC7D,4CAA+B,CAAA;AACjC,CAAC,EAdW,SAAS,KAAT,SAAS,QAcpB;AAED,MAAM,OAAO,aAAc,SAAQ,KAAK;IAE7B;IADT,YACS,IAAe,EACtB,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAAW;QAItB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@agenticocean/x402-stellar",
+  "version": "1.0.0",
+  "description": "x402 payment protocol for Stellar — header builder, facilitator, Express middleware",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/stellaragent402/stellaragent402"
+  },
+  "homepage": "https://stellaragent402.io",
+  "bugs": {
+    "url": "https://github.com/stellaragent402/stellaragent402/issues"
+  },
+  "keywords": [
+    "stellar",
+    "soroban",
+    "x402",
+    "payment",
+    "ai-agents",
+    "defi",
+    "blockchain"
+  ],
+  "dependencies": {
+    "@stellar/stellar-sdk": "^13.1.0"
+  },
+  "peerDependencies": {
+    "express": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "typescript": "^5.7.0"
+  },
+  "license": "MIT"
+}