@stellar-agent/x402-client 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 stellar-agent-bridge contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @stellar-agent/x402-client
+
+Local x402-style client support for the Testnet demo.
+
+This package implements a concrete local `402 -> policy -> Testnet payment -> retry with proof` flow. It is not a full facilitator-backed Soroban auth-entry x402 implementation yet.

package/dist/index.d.ts

@@ -0,0 +1,68 @@
+import { NetworkProfile, PaymentRequest, TestnetWallet } from "@stellar-agent/core";
+import { Policy, SpendHistory, evaluatePaymentRequest } from "@stellar-agent/policy";
+import { sendPayment } from "@stellar-agent/stellar";
+export interface X402PaymentRequirement {
+    protocol: "stellar-agent-local-x402";
+    version: 1;
+    network: "testnet";
+    asset: string;
+    amount: string;
+    recipient: string;
+    resource: string;
+    nonce: string;
+    memo?: string;
+}
+export interface X402PaymentProof {
+    protocol: "stellar-agent-local-x402";
+    version: 1;
+    transactionHash: string;
+    ledger?: number;
+    payer: string;
+    recipient: string;
+    asset: string;
+    amount: string;
+    resource: string;
+    nonce: string;
+}
+export interface X402PaymentResult {
+    firstStatus: number;
+    finalStatus: number;
+    requirement: X402PaymentRequirement;
+    policyDecision: ReturnType<typeof evaluatePaymentRequest>;
+    transaction?: {
+        hash: string;
+        ledger?: number;
+        successful: boolean;
+        feeCharged?: string;
+    };
+    receiptPath?: string;
+    responseBody?: string;
+    paidResourceDelivered?: boolean;
+}
+export declare function runX402Payment(args: {
+    url: string;
+    source: TestnetWallet;
+    policy: Policy;
+    profile: NetworkProfile;
+    receiptsDir: string;
+    eventLog: string;
+    command: string;
+    dryRun?: boolean;
+    spendHistory?: SpendHistory;
+    loadSpendHistory?: (request: PaymentRequest) => Promise<SpendHistory>;
+    fetchImpl?: typeof fetch;
+    sendPaymentImpl?: typeof sendPayment;
+}): Promise<X402PaymentResult>;
+export declare function parseX402Requirement(response: Response): Promise<X402PaymentRequirement>;
+export declare function validateRequirement(value: unknown): X402PaymentRequirement;
+export declare function startPaidApiDemo(args: {
+    recipient: string;
+    amount?: string;
+    asset?: string;
+    port?: number;
+    host?: string;
+}): Promise<{
+    url: string;
+    close(): Promise<void>;
+}>;
+//# 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":"AAAA,OAAO,EACL,cAAc,EACd,cAAc,EAEd,aAAa,EAGd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,SAAS,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,0BAA0B,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,sBAAsB,CAAC;IACpC,cAAc,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;IAC1D,WAAW,CAAC,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,OAAO,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,cAAc,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACtE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,WAAW,CAAC;CACtC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA2H7B;AAgBD,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAQ9F;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CA8B1E;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC;IACV,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC,CAiFD"}

package/dist/index.js

@@ -0,0 +1,302 @@
+import { StellarAgentError, makeId, parseAmount } from "@stellar-agent/core";
+import { appendEvent, writeReceipt } from "@stellar-agent/ledger-logger";
+import { evaluatePaymentRequest } from "@stellar-agent/policy";
+import { sendPayment } from "@stellar-agent/stellar";
+import { createServer } from "node:http";
+export async function runX402Payment(args) {
+    const fetchImpl = args.fetchImpl ?? fetch;
+    const sendPaymentImpl = args.sendPaymentImpl ?? sendPayment;
+    const first = await fetchResource(fetchImpl, args.url);
+    if (first.status !== 402) {
+        return {
+            firstStatus: first.status,
+            finalStatus: first.status,
+            requirement: syntheticRequirement(args.url),
+            policyDecision: evaluatePaymentRequest(args.policy, {
+                destination: args.source.publicKey,
+                amount: "0.0000001",
+                asset: "XLM",
+                network: "testnet"
+            }),
+            responseBody: await first.text()
+        };
+    }
+    const requirement = await parseX402Requirement(first);
+    assertSameResource(requirement.resource, args.url);
+    const request = {
+        source: args.source.publicKey,
+        destination: requirement.recipient,
+        amount: requirement.amount,
+        asset: requirement.asset,
+        memo: requirement.memo,
+        network: "testnet",
+        domain: new URL(args.url).host,
+        url: args.url
+    };
+    const history = args.loadSpendHistory ? await args.loadSpendHistory(request) : args.spendHistory;
+    const policyDecision = evaluatePaymentRequest(args.policy, request, history);
+    await appendEvent(args.eventLog, {
+        event: "policy_decision",
+        status: policyDecision.status,
+        command: args.command,
+        profile: "testnet",
+        data: { request, requirement, policyDecision }
+    });
+    if (policyDecision.status === "denied") {
+        throw new StellarAgentError({
+            code: "POLICY_DENIED",
+            message: "x402 payment request was denied by policy.",
+            hint: "Enable x402 and allow the target domain in policy when appropriate.",
+            docs: "docs/x402-and-mpp.md#local-x402-demo"
+        });
+    }
+    if (policyDecision.status === "requires_approval") {
+        throw new StellarAgentError({
+            code: "APPROVAL_REQUIRED",
+            message: "x402 payment requires approval.",
+            docs: "docs/x402-and-mpp.md#local-x402-demo"
+        });
+    }
+    if (args.dryRun) {
+        return { firstStatus: 402, finalStatus: 402, requirement, policyDecision };
+    }
+    const transaction = await sendPaymentImpl({
+        source: args.source,
+        destination: requirement.recipient,
+        amount: requirement.amount,
+        asset: requirement.asset,
+        ...(requirement.memo === undefined ? {} : { memo: requirement.memo }),
+        profile: args.profile
+    });
+    const proof = {
+        protocol: "stellar-agent-local-x402",
+        version: 1,
+        transactionHash: transaction.hash,
+        payer: args.source.publicKey,
+        recipient: requirement.recipient,
+        asset: requirement.asset,
+        amount: parseAmount(requirement.amount).value,
+        resource: requirement.resource,
+        nonce: requirement.nonce,
+        ...(transaction.ledger === undefined ? {} : { ledger: transaction.ledger })
+    };
+    const paid = await fetchResource(fetchImpl, args.url, {
+        headers: {
+            "X-Payment": JSON.stringify(proof),
+            "X-Payment-Transaction": transaction.hash
+        }
+    });
+    const responseBody = await paid.text();
+    const paidResourceDelivered = paid.status >= 200 && paid.status < 300;
+    const { path: receiptPath } = await writeReceipt(args.receiptsDir, {
+        command: args.command,
+        profile: "testnet",
+        networkPassphrase: args.profile.networkPassphrase,
+        realFunds: false,
+        payment: {
+            source: args.source.publicKey,
+            destination: requirement.recipient,
+            asset: requirement.asset,
+            amount: requirement.amount,
+            domain: new URL(args.url).host,
+            url: args.url,
+            ...(requirement.memo === undefined ? {} : { memo: requirement.memo })
+        },
+        policyDecision,
+        transaction,
+        ...(transaction.ledger === undefined ? {} : { ledger: { confirmedLedger: transaction.ledger } }),
+        eventLog: args.eventLog
+    });
+    await appendEvent(args.eventLog, {
+        event: "receipt_written",
+        status: paidResourceDelivered ? "success" : "paid_resource_failed",
+        command: args.command,
+        profile: "testnet",
+        data: { receiptPath, transactionHash: transaction.hash, finalStatus: paid.status, paidResourceDelivered }
+    });
+    return {
+        firstStatus: 402,
+        finalStatus: paid.status,
+        requirement,
+        policyDecision,
+        transaction,
+        receiptPath,
+        responseBody,
+        paidResourceDelivered
+    };
+}
+async function fetchResource(fetchImpl, url, init) {
+    try {
+        return await fetchImpl(url, init);
+    }
+    catch (error) {
+        throw new StellarAgentError({
+            code: "X402_RESOURCE_UNAVAILABLE",
+            message: "Could not fetch the x402 resource.",
+            hint: "Check the URL and make sure the paid API is running.",
+            docs: "docs/x402-and-mpp.md#local-x402-demo",
+            details: String(error)
+        });
+    }
+}
+export async function parseX402Requirement(response) {
+    const header = response.headers.get("Payment-Required") ??
+        response.headers.get("PAYMENT-REQUIRED") ??
+        response.headers.get("X-Payment-Required") ??
+        response.headers.get("X-Payment");
+    const parsed = header ? JSON.parse(header) : await response.json();
+    return validateRequirement(parsed);
+}
+export function validateRequirement(value) {
+    const candidate = value;
+    if (candidate.protocol !== "stellar-agent-local-x402" ||
+        candidate.version !== 1 ||
+        candidate.network !== "testnet" ||
+        !candidate.recipient ||
+        !candidate.amount ||
+        !candidate.asset ||
+        !candidate.resource ||
+        !candidate.nonce) {
+        throw new StellarAgentError({
+            code: "INVALID_INPUT",
+            message: "HTTP 402 response did not include a supported x402 payment requirement.",
+            docs: "docs/x402-and-mpp.md#local-x402-demo"
+        });
+    }
+    parseAmount(candidate.amount, candidate.asset);
+    return {
+        protocol: "stellar-agent-local-x402",
+        version: 1,
+        network: "testnet",
+        recipient: candidate.recipient,
+        amount: candidate.amount,
+        asset: candidate.asset,
+        resource: candidate.resource,
+        nonce: candidate.nonce,
+        ...(candidate.memo === undefined ? {} : { memo: candidate.memo })
+    };
+}
+export async function startPaidApiDemo(args) {
+    const host = args.host ?? "127.0.0.1";
+    const amount = args.amount ?? "0.0000001";
+    const asset = args.asset ?? "XLM";
+    parseAmount(amount, asset);
+    const nonce = makeId("x402_req");
+    const acceptedTransactions = new Set();
+    const server = createServer((request, response) => {
+        if (request.url?.startsWith("/health")) {
+            writeJson(response, 200, { ok: true });
+            return;
+        }
+        if (!request.url?.startsWith("/paid-report")) {
+            writeJson(response, 404, { ok: false, error: "not_found" });
+            return;
+        }
+        const proofHeader = request.headers["x-payment"];
+        if (!proofHeader) {
+            const resource = paidResource(host, server);
+            const requirement = {
+                protocol: "stellar-agent-local-x402",
+                version: 1,
+                network: "testnet",
+                asset,
+                amount,
+                recipient: args.recipient,
+                resource,
+                nonce,
+                memo: "x402-demo"
+            };
+            const encoded = JSON.stringify(requirement);
+            response.setHeader("Payment-Required", encoded);
+            response.setHeader("X-Payment-Required", encoded);
+            writeJson(response, 402, requirement);
+            return;
+        }
+        const proof = parseProofHeader(proofHeader);
+        const resource = paidResource(host, server);
+        if (!proof ||
+            proof.protocol !== "stellar-agent-local-x402" ||
+            proof.version !== 1 ||
+            !proof.transactionHash ||
+            !proof.payer ||
+            proof.recipient !== args.recipient ||
+            proof.asset !== asset ||
+            proof.amount !== parseAmount(amount, asset).value ||
+            proof.resource !== resource ||
+            proof.nonce !== nonce) {
+            writeJson(response, 402, { ok: false, error: "invalid_payment_proof" });
+            return;
+        }
+        if (acceptedTransactions.has(proof.transactionHash)) {
+            writeJson(response, 402, { ok: false, error: "payment_proof_replayed" });
+            return;
+        }
+        acceptedTransactions.add(proof.transactionHash);
+        writeJson(response, 200, {
+            ok: true,
+            id: makeId("paid_report"),
+            message: "Local x402 demo content unlocked.",
+            paid: {
+                transactionHash: proof.transactionHash,
+                amount: proof.amount,
+                asset: proof.asset
+            }
+        });
+    });
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(args.port ?? 0, host, () => resolve());
+    });
+    return {
+        url: `http://${host}:${addressPort(server)}/paid-report`,
+        close: () => new Promise((resolve, reject) => {
+            server.close((error) => (error ? reject(error) : resolve()));
+        })
+    };
+}
+function syntheticRequirement(url) {
+    return {
+        protocol: "stellar-agent-local-x402",
+        version: 1,
+        network: "testnet",
+        asset: "XLM",
+        amount: "0.0000001",
+        recipient: "GAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAWHF",
+        resource: url,
+        nonce: makeId("x402_req")
+    };
+}
+function paidResource(host, server) {
+    return `http://${host}:${addressPort(server)}/paid-report`;
+}
+function assertSameResource(advertisedResource, requestedUrl) {
+    const advertised = new URL(advertisedResource);
+    const requested = new URL(requestedUrl);
+    if (advertised.origin !== requested.origin || advertised.pathname !== requested.pathname) {
+        throw new StellarAgentError({
+            code: "INVALID_INPUT",
+            message: "HTTP 402 payment requirement resource does not match the requested URL.",
+            docs: "docs/x402-and-mpp.md#local-x402-demo"
+        });
+    }
+}
+function addressPort(server) {
+    const address = server.address();
+    if (!address || typeof address === "string")
+        return 0;
+    return address.port;
+}
+function writeJson(response, status, body) {
+    response.statusCode = status;
+    response.setHeader("content-type", "application/json");
+    response.end(JSON.stringify(body));
+}
+function parseProofHeader(header) {
+    try {
+        return JSON.parse(Array.isArray(header) ? header[0] ?? "{}" : header ?? "{}");
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@stellar-agent/x402-client",
+  "version": "0.4.0",
+  "description": "Local Testnet x402-style payment demo client and server helpers for Stellar Agent Bridge.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/someone-in-texas/Stellar-Agent.git",
+    "directory": "packages/x402-client"
+  },
+  "bugs": {
+    "url": "https://github.com/someone-in-texas/Stellar-Agent/issues"
+  },
+  "homepage": "https://github.com/someone-in-texas/Stellar-Agent#readme",
+  "engines": {
+    "node": ">=22"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@stellar-agent/core": "0.4.0",
+    "@stellar-agent/ledger-logger": "0.4.0",
+    "@stellar-agent/policy": "0.4.0",
+    "@stellar-agent/stellar": "0.4.0"
+  }
+}