@shielded-x402/client 0.2.4 → 0.4.0

package/dist/agentPaymentFetch.d.ts

@@ -0,0 +1,56 @@
+import type { Erc8004DirectoryClient } from "@shielded-x402/erc8004-adapter";
+import type { AgentPaymentErrorCode, CanonicalAgentProfile, CanonicalServiceEndpoint } from "@shielded-x402/shared-types";
+import { type CounterpartyPolicyConfig } from "./counterpartyPolicy.js";
+import { type CreateCreditFetchConfig } from "./creditFetch.js";
+export type AgentTarget = {
+    type: "url";
+    url: string;
+} | {
+    type: "erc8004";
+    chainId: number;
+    tokenId: string;
+    isTestnet?: boolean;
+};
+export interface A2AX402PaymentProfile {
+    method: string;
+    payee?: string;
+    network?: string;
+    endpoint?: string;
+    facilitatorUrl?: string;
+    raw: Record<string, unknown>;
+}
+export interface A2AResolvedCard {
+    url: string;
+    name?: string;
+    description?: string;
+    x402Payments: A2AX402PaymentProfile[];
+    raw: Record<string, unknown>;
+}
+export declare class AgentPaymentError extends Error {
+    readonly code: AgentPaymentErrorCode;
+    readonly context: Record<string, unknown>;
+    constructor(code: AgentPaymentErrorCode, message: string, context?: Record<string, unknown>);
+}
+export interface AgentPaymentFetchConfig extends CreateCreditFetchConfig {
+    directoryClient?: Erc8004DirectoryClient;
+    targetPolicy?: CounterpartyPolicyConfig;
+    onA2ACardResolved?: (args: {
+        target: Extract<AgentTarget, {
+            type: "erc8004";
+        }>;
+        profile: CanonicalAgentProfile;
+        selectedEndpoint: CanonicalServiceEndpoint;
+        card: A2AResolvedCard;
+    }) => Promise<void> | void;
+    resolveA2AInvokeTarget?: (args: {
+        target: Extract<AgentTarget, {
+            type: "erc8004";
+        }>;
+        profile: CanonicalAgentProfile;
+        selectedEndpoint: CanonicalServiceEndpoint;
+        card: A2AResolvedCard;
+    }) => Promise<string | undefined> | string | undefined;
+}
+export type AgentPaymentFetch = (target: AgentTarget, init?: RequestInit) => Promise<Response>;
+export declare function createAgentPaymentFetch(config: AgentPaymentFetchConfig): AgentPaymentFetch;
+//# sourceMappingURL=agentPaymentFetch.d.ts.map

package/dist/agentPaymentFetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentPaymentFetch.d.ts","sourceRoot":"","sources":["../src/agentPaymentFetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,EAEzB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,kBAAkB,CAAC;AAE1B,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE/E,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,qBAAqB,EAAE,CAAC;IACtC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAED,qBAAa,iBAAkB,SAAQ,KAAK;aAExB,IAAI,EAAE,qBAAqB;aAE3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFhC,IAAI,EAAE,qBAAqB,EAC3C,OAAO,EAAE,MAAM,EACC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAIxD;AAED,MAAM,WAAW,uBAAwB,SAAQ,uBAAuB;IACtE,eAAe,CAAC,EAAE,sBAAsB,CAAC;IACzC,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE;QACzB,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE;YAAE,IAAI,EAAE,SAAS,CAAA;SAAE,CAAC,CAAC;QAClD,OAAO,EAAE,qBAAqB,CAAC;QAC/B,gBAAgB,EAAE,wBAAwB,CAAC;QAC3C,IAAI,EAAE,eAAe,CAAC;KACvB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3B,sBAAsB,CAAC,EAAE,CAAC,IAAI,EAAE;QAC9B,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE;YAAE,IAAI,EAAE,SAAS,CAAA;SAAE,CAAC,CAAC;QAClD,OAAO,EAAE,qBAAqB,CAAC;QAC/B,gBAAgB,EAAE,wBAAwB,CAAC;QAC3C,IAAI,EAAE,eAAe,CAAC;KACvB,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC;CACxD;AAED,MAAM,MAAM,iBAAiB,GAAG,CAC9B,MAAM,EAAE,WAAW,EACnB,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC;AA+MvB,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,uBAAuB,GAC9B,iBAAiB,CAmCnB"}

package/dist/agentPaymentFetch.js

@@ -0,0 +1,208 @@
+import { getRecord, toStringOrUndefined } from "@shielded-x402/shared-types";
+import { selectCounterpartyEndpoint, } from "./counterpartyPolicy.js";
+import { createCreditShieldedFetch, } from "./creditFetch.js";
+export class AgentPaymentError extends Error {
+    code;
+    context;
+    constructor(code, message, context = {}) {
+        super(message);
+        this.code = code;
+        this.context = context;
+    }
+}
+function endpointFromSelection(selection) {
+    return selection.selected?.endpoint.url;
+}
+function extractX402Payments(card) {
+    const paymentsRaw = card.payments;
+    if (!Array.isArray(paymentsRaw))
+        return [];
+    const out = [];
+    for (const paymentEntry of paymentsRaw) {
+        const payment = getRecord(paymentEntry);
+        if (!payment)
+            continue;
+        const method = toStringOrUndefined(payment.method);
+        if (!method || method.toLowerCase() !== "x402")
+            continue;
+        const extensions = getRecord(payment.extensions);
+        const x402Extension = extensions ? getRecord(extensions.x402) : undefined;
+        const payee = toStringOrUndefined(payment.payee);
+        const network = toStringOrUndefined(payment.network);
+        const endpoint = toStringOrUndefined(payment.endpoint);
+        const facilitatorUrl = toStringOrUndefined(x402Extension?.facilitatorUrl);
+        out.push({
+            method,
+            ...(payee ? { payee } : {}),
+            ...(network ? { network } : {}),
+            ...(endpoint ? { endpoint } : {}),
+            ...(facilitatorUrl ? { facilitatorUrl } : {}),
+            raw: payment,
+        });
+    }
+    return out;
+}
+async function resolveA2ACard(target, profile, selectedEndpoint, selectedUrl, config) {
+    if (selectedEndpoint.protocol !== "a2a") {
+        return { finalUrl: selectedUrl };
+    }
+    const baseFetch = config.fetchImpl ?? fetch;
+    let payload;
+    try {
+        const response = await baseFetch(selectedUrl, {
+            method: "GET",
+            headers: { accept: "application/json" },
+        });
+        if (!response.ok) {
+            return {
+                finalUrl: selectedUrl,
+                diagnostics: `a2a-card-fetch-status=${response.status}`,
+            };
+        }
+        payload = await response.json().catch(() => undefined);
+    }
+    catch (error) {
+        return {
+            finalUrl: selectedUrl,
+            diagnostics: `a2a-card-fetch-error=${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+    const cardRecord = getRecord(payload);
+    if (!cardRecord) {
+        return {
+            finalUrl: selectedUrl,
+            diagnostics: "a2a-card-parse=invalid-json-shape",
+        };
+    }
+    const card = {
+        url: selectedUrl,
+        x402Payments: extractX402Payments(cardRecord),
+        raw: cardRecord,
+    };
+    const name = toStringOrUndefined(cardRecord.name);
+    const description = toStringOrUndefined(cardRecord.description);
+    if (name) {
+        card.name = name;
+    }
+    if (description) {
+        card.description = description;
+    }
+    if (config.onA2ACardResolved) {
+        await config.onA2ACardResolved({
+            target,
+            profile,
+            selectedEndpoint,
+            card,
+        });
+    }
+    const overriddenUrl = config.resolveA2AInvokeTarget
+        ? await config.resolveA2AInvokeTarget({
+            target,
+            profile,
+            selectedEndpoint,
+            card,
+        })
+        : undefined;
+    return {
+        finalUrl: overriddenUrl ?? selectedUrl,
+        card,
+    };
+}
+async function resolveTargetUrl(target, config) {
+    if (target.type === "url") {
+        return { url: target.url, context: { targetType: "url" } };
+    }
+    if (!config.directoryClient) {
+        throw new AgentPaymentError("E_DIRECTORY_UNAVAILABLE", "directoryClient is required for erc8004 targets", {
+            target,
+        });
+    }
+    let profile;
+    try {
+        profile = await config.directoryClient.resolveAgent({
+            chainId: target.chainId,
+            tokenId: target.tokenId,
+            ...(target.isTestnet !== undefined
+                ? { isTestnet: target.isTestnet }
+                : {}),
+        });
+    }
+    catch (error) {
+        throw new AgentPaymentError("E_DIRECTORY_UNAVAILABLE", error instanceof Error ? error.message : String(error), { target });
+    }
+    if (!profile) {
+        throw new AgentPaymentError("E_AGENT_NOT_FOUND", "agent not found in directory", { target });
+    }
+    const selection = selectCounterpartyEndpoint(profile, config.targetPolicy);
+    const selectedUrl = endpointFromSelection(selection);
+    if (!selectedUrl) {
+        throw new AgentPaymentError("E_NO_COMPATIBLE_ENDPOINT", "no compatible endpoint found for target agent", {
+            target,
+            selection,
+        });
+    }
+    const selectedEndpoint = selection.selected?.endpoint;
+    const a2aResolution = selectedEndpoint && target.type === "erc8004"
+        ? await resolveA2ACard(target, profile, selectedEndpoint, selectedUrl, config)
+        : { finalUrl: selectedUrl };
+    return {
+        url: a2aResolution.finalUrl,
+        context: {
+            targetType: "erc8004",
+            selection,
+            profile,
+            ...(a2aResolution.card
+                ? {
+                    a2aCard: {
+                        url: a2aResolution.card.url,
+                        name: a2aResolution.card.name,
+                        x402Payments: a2aResolution.card.x402Payments,
+                    },
+                }
+                : {}),
+            ...(a2aResolution.diagnostics
+                ? { a2aDiagnostics: a2aResolution.diagnostics }
+                : {}),
+        },
+    };
+}
+export function createAgentPaymentFetch(config) {
+    const creditFetch = createCreditShieldedFetch({
+        creditClient: config.creditClient,
+        ...(config.fetchImpl ? { fetchImpl: config.fetchImpl } : {}),
+    });
+    return async (target, init) => {
+        let resolved;
+        try {
+            resolved = await resolveTargetUrl(target, config);
+        }
+        catch (error) {
+            if (error instanceof AgentPaymentError)
+                throw error;
+            const message = error instanceof Error ? error.message : String(error);
+            throw new AgentPaymentError("E_PAYMENT_EXECUTION_FAILED", message, {
+                target,
+                targetType: target.type,
+            });
+        }
+        try {
+            return await creditFetch(resolved.url, init);
+        }
+        catch (error) {
+            if (error instanceof AgentPaymentError)
+                throw error;
+            const message = error instanceof Error ? error.message : String(error);
+            if (message.includes("requirement adapter")) {
+                throw new AgentPaymentError("E_402_NORMALIZATION_FAILED", message, {
+                    target,
+                    ...resolved.context,
+                });
+            }
+            throw new AgentPaymentError("E_PAYMENT_EXECUTION_FAILED", message, {
+                target,
+                ...resolved.context,
+            });
+        }
+    };
+}
+//# sourceMappingURL=agentPaymentFetch.js.map

package/dist/agentPaymentFetch.js.map

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

package/dist/client.d.ts

@@ -1,6 +1,6 @@
 import { type Hex, type PaymentRequirement, type ShieldedNote, type ShieldedPaymentResponse } from '@shielded-x402/shared-types';
 import { type MerkleWitness } from './merkle.js';
-import type { Parsed402, Prepared402Payment, ShieldedClientConfig, SpendBuildParams, SpendProofBundle } from './types.js';
+import type { Prepared402Payment, ShieldedClientConfig, SpendBuildParams, SpendProofBundle } from './types.js';
 export declare class ShieldedClientSDK {
     private readonly config;
     constructor(config: ShieldedClientConfig);
@@ -17,10 +17,7 @@ export declare class ShieldedClientSDK {
         signature: string;
         paymentSignatureHeader: string;
     }>;
-    parse402Response(response: Response): Parsed402;
-    prepare402Payment(requirement: PaymentRequirement, note: ShieldedNote, witness: MerkleWitness, payerPkHash: Hex, baseHeaders?: HeadersInit): Promise<Prepared402Payment>;
-    complete402Payment(input: string, init: RequestInit, requirement: PaymentRequirement, note: ShieldedNote, witness: MerkleWitness, payerPkHash: Hex, fetchFn?: typeof fetch): Promise<Response>;
-    fetchWithShieldedPayment(input: string, init: RequestInit, note: ShieldedNote, witness: MerkleWitness, payerPkHash: Hex): Promise<Response>;
+    prepare402Payment(requirement: PaymentRequirement, note: ShieldedNote, witness: MerkleWitness, nullifierSecret: Hex, baseHeaders?: HeadersInit): Promise<Prepared402Payment>;
 }
 export declare function buildWitnessFromCommitments(commitments: Hex[], targetIndex: number): MerkleWitness;
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,GAAG,EACR,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC7B,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EACV,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAcpB,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,oBAAoB;IAEnD,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,MAAM,CAAC,EAAE,GAAG,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAqBjH,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB;IA8CrD,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;YAKxE,eAAe;IA8BvB,MAAM,CACV,eAAe,EAAE,uBAAuB,EACxC,WAAW,EAAE,kBAAkB,EAC/B,cAAc,EAAE,GAAG,GAClB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,sBAAsB,EAAE,MAAM,CAAA;KAAE,CAAC;IAalF,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS;IAMzC,iBAAiB,CACrB,WAAW,EAAE,kBAAkB,EAC/B,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,GAAG,EAChB,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,kBAAkB,CAAC;IAqCxB,kBAAkB,CACtB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,kBAAkB,EAC/B,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,GAAG,EAChB,OAAO,GAAE,OAAO,KAAa,GAC5B,OAAO,CAAC,QAAQ,CAAC;IAed,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC;CAOlJ;AAED,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,GAAG,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,CAElG"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,GAAG,EACR,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC7B,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAcpB,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,oBAAoB;IAEnD,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,MAAM,CAAC,EAAE,GAAG,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAqBjH,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB;IAgDrD,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;YAKxE,eAAe;IA8BvB,MAAM,CACV,eAAe,EAAE,uBAAuB,EACxC,WAAW,EAAE,kBAAkB,EAC/B,cAAc,EAAE,GAAG,GAClB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,sBAAsB,EAAE,MAAM,CAAA;KAAE,CAAC;IAa5E,iBAAiB,CACrB,WAAW,EAAE,kBAAkB,EAC/B,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,aAAa,EACtB,eAAe,EAAE,GAAG,EACpB,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,kBAAkB,CAAC;CAqC/B;AAED,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,GAAG,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,CAElG"}

package/dist/client.js

@@ -1,4 +1,4 @@
-import { X402_HEADERS, buildPaymentSignatureHeader, normalizeRequirement, parsePaymentRequiredHeader } from '@shielded-x402/shared-types';
+import { X402_HEADERS, buildPaymentSignatureHeader, normalizeRequirement, toHexWord } from '@shielded-x402/shared-types';
 import { randomBytes } from 'node:crypto';
 import { deriveChallengeHash, deriveCommitment, deriveNullifier } from './crypto.js';
 import { deriveWitness } from './merkle.js';
@@ -44,9 +44,10 @@ export class ShieldedClientSDK {
         const merchantCommitment = deriveCommitment(params.amount, merchantRho, params.merchantPubKey);
         const changeAmount = params.note.amount - params.amount;
         const changeRho = params.changeRho ?? randomFieldHex();
+        const changeNullifierSecret = params.changeNullifierSecret ?? randomFieldHex();
         const changeCommitment = deriveCommitment(changeAmount, changeRho, params.note.pkHash);
         const challengeHash = deriveChallengeHash(params.challengeNonce, params.amount, params.merchantAddress);
-        const amountHex = `0x${params.amount.toString(16).padStart(64, '0')}`;
+        const amountHex = toHexWord(params.amount);
         const response = {
             proof: '0x00',
             publicInputs: [
@@ -67,6 +68,7 @@ export class ShieldedClientSDK {
         };
         return {
             merchantRho,
+            changeNullifierSecret,
             response,
             changeNote: {
                 amount: changeAmount,
@@ -120,13 +122,7 @@ export class ShieldedClientSDK {
         });
         return { payload, signature, paymentSignatureHeader };
     }
-    parse402Response(response) {
-        const header = response.headers.get(X402_HEADERS.paymentRequired);
-        if (!header)
-            throw new Error(`missing ${X402_HEADERS.paymentRequired} header`);
-        return { requirement: parsePaymentRequiredHeader(header) };
-    }
-    async prepare402Payment(requirement, note, witness, payerPkHash, baseHeaders) {
+    async prepare402Payment(requirement, note, witness, nullifierSecret, baseHeaders) {
         if (requirement.rail !== 'shielded-usdc') {
             throw new Error(`unsupported rail: ${requirement.rail}`);
         }
@@ -136,7 +132,7 @@ export class ShieldedClientSDK {
         const spendParams = {
             note,
             witness,
-            nullifierSecret: payerPkHash,
+            nullifierSecret,
             merchantPubKey: requirement.merchantPubKey,
             merchantAddress: merchant,
             amount,
@@ -151,23 +147,10 @@ export class ShieldedClientSDK {
             requirement,
             headers,
             response: bundleWithProof.response,
-            changeNote: bundleWithProof.changeNote
+            changeNote: bundleWithProof.changeNote,
+            changeNullifierSecret: bundleWithProof.changeNullifierSecret
         };
     }
-    async complete402Payment(input, init, requirement, note, witness, payerPkHash, fetchFn = fetch) {
-        const prepared = await this.prepare402Payment(requirement, note, witness, payerPkHash, init.headers);
-        return fetchFn(input, {
-            ...init,
-            headers: prepared.headers
-        });
-    }
-    async fetchWithShieldedPayment(input, init, note, witness, payerPkHash) {
-        const first = await fetch(input, init);
-        if (first.status !== 402)
-            return first;
-        const parsed = this.parse402Response(first);
-        return this.complete402Payment(input, init, parsed.requirement, note, witness, payerPkHash);
-    }
 }
 export function buildWitnessFromCommitments(commitments, targetIndex) {
     return deriveWitness(commitments, targetIndex);

package/dist/client.js.map

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

package/dist/counterpartyPolicy.d.ts

@@ -0,0 +1,9 @@
+import type { CanonicalAgentProfile, CounterpartySelectionResult } from '@shielded-x402/shared-types';
+export interface CounterpartyPolicyConfig {
+    preferredProtocols?: Array<'a2a' | 'web' | 'mcp' | 'oasf'>;
+    minTrustScore?: number;
+    requireX402Support?: boolean;
+    requireHttps?: boolean;
+}
+export declare function selectCounterpartyEndpoint(profile: CanonicalAgentProfile, policy?: CounterpartyPolicyConfig): CounterpartySelectionResult;
+//# sourceMappingURL=counterpartyPolicy.d.ts.map

package/dist/counterpartyPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counterpartyPolicy.d.ts","sourceRoot":"","sources":["../src/counterpartyPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EAGrB,2BAA2B,EAE5B,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,wBAAwB;IACvC,kBAAkB,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC,CAAC;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AA0ED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,qBAAqB,EAC9B,MAAM,GAAE,wBAA6B,GACpC,2BAA2B,CAwB7B"}

package/dist/counterpartyPolicy.js

@@ -0,0 +1,87 @@
+const DEFAULT_PROTOCOLS = ['a2a', 'web', 'mcp', 'oasf'];
+function protocolPriority(protocol, preferred) {
+    const index = preferred.indexOf(protocol);
+    return index >= 0 ? preferred.length - index : 0;
+}
+function normalizeHealthScore(health) {
+    if (!health)
+        return 0;
+    if (health === 'healthy')
+        return 10;
+    if (health === 'degraded')
+        return 5;
+    return 0;
+}
+function normalizeTimestampScore(value) {
+    if (!value)
+        return 0;
+    const time = Date.parse(value);
+    if (!Number.isFinite(time))
+        return 0;
+    return Math.floor(time / 1000);
+}
+function toEndpointLabel(endpoint) {
+    return endpoint.url ?? endpoint.identifier ?? `${endpoint.protocol}:unknown`;
+}
+function buildCandidate(endpoint, profile, config) {
+    const rejectionReasons = [];
+    if (!endpoint.url) {
+        rejectionReasons.push('endpoint url missing');
+    }
+    if (config.requireHttps && endpoint.url && !endpoint.url.startsWith('https://')) {
+        rejectionReasons.push('https required');
+    }
+    if (config.requireX402Support && profile.x402Supported === false) {
+        rejectionReasons.push('counterparty does not advertise x402 support');
+    }
+    const trustScore = profile.trust?.score;
+    if (config.minTrustScore !== undefined && trustScore !== undefined && trustScore < config.minTrustScore) {
+        rejectionReasons.push(`trust score ${trustScore} below minimum ${config.minTrustScore}`);
+    }
+    const preferredProtocols = (config.preferredProtocols ?? DEFAULT_PROTOCOLS);
+    const protocolScore = protocolPriority(endpoint.protocol, preferredProtocols);
+    const healthScore = normalizeHealthScore(profile.trust?.healthStatus);
+    const trustScoreNormalized = trustScore ?? 0;
+    const activityScore = normalizeTimestampScore(profile.trust?.lastActiveAt);
+    const rankScoreBreakdown = {
+        protocol: protocolScore,
+        health: healthScore,
+        trust: trustScoreNormalized,
+        activity: activityScore
+    };
+    const rankScore = protocolScore * 1_000_000_000_000 +
+        healthScore * 1_000_000_000 +
+        trustScoreNormalized * 1_000_000 +
+        activityScore;
+    return {
+        endpoint,
+        rankScore,
+        rejectionReasons,
+        rankScoreBreakdown
+    };
+}
+export function selectCounterpartyEndpoint(profile, policy = {}) {
+    const options = {
+        requireHttps: policy.requireHttps ?? true,
+        requireX402Support: policy.requireX402Support ?? false,
+        ...policy
+    };
+    const candidates = profile.services
+        .map((endpoint) => buildCandidate(endpoint, profile, options))
+        .sort((a, b) => {
+        if (a.rankScore !== b.rankScore)
+            return b.rankScore - a.rankScore;
+        const aLabel = toEndpointLabel(a.endpoint);
+        const bLabel = toEndpointLabel(b.endpoint);
+        return aLabel.localeCompare(bLabel);
+    });
+    const selected = candidates.find((candidate) => candidate.rejectionReasons.length === 0);
+    if (selected) {
+        return {
+            selected,
+            candidates
+        };
+    }
+    return { candidates };
+}
+//# sourceMappingURL=counterpartyPolicy.js.map

package/dist/counterpartyPolicy.js.map

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

package/dist/creditChannel.d.ts

@@ -0,0 +1,28 @@
+import { type CreditDomainResponse, type CreditChannelId, type Hex, type RelayerCreditPayRequest, type RelayerCreditPayResponse, type RelayerCreditTopupRequest, type RelayerCreditTopupResponse, type SignedCreditState } from '@shielded-x402/shared-types';
+import { type CreditTypedDataSigner } from './creditSignatures.js';
+export interface CreditStateStore {
+    getCreditState: (channelId: Hex) => SignedCreditState | undefined;
+    setCreditState: (state: SignedCreditState) => Promise<void> | void;
+}
+export interface CreditChannelClientConfig {
+    relayerEndpoint: string;
+    channelId?: Hex;
+    agentAddress: Hex;
+    signer: CreditTypedDataSigner;
+    stateStore?: CreditStateStore;
+    fetchImpl?: typeof fetch;
+}
+export interface CreditPayArgs {
+    requestId: string;
+    merchantRequest: RelayerCreditPayRequest['merchantRequest'];
+    requirement: RelayerCreditPayRequest['requirement'];
+    deadlineSeconds?: number;
+}
+export declare function createCreditChannelClient(config: CreditChannelClientConfig): {
+    getDomain: () => Promise<CreditDomainResponse>;
+    getChannelId: () => Promise<CreditChannelId>;
+    getLatestState: () => SignedCreditState | undefined;
+    topup: (request: Omit<RelayerCreditTopupRequest, "channelId" | "latestState">) => Promise<RelayerCreditTopupResponse>;
+    pay: (args: CreditPayArgs) => Promise<RelayerCreditPayResponse>;
+};
+//# sourceMappingURL=creditChannel.d.ts.map

package/dist/creditChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creditChannel.d.ts","sourceRoot":"","sources":["../src/creditChannel.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,oBAAoB,EACzB,KAAK,eAAe,EAEpB,KAAK,GAAG,EACR,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,EACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAG/B,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,CAAC,SAAS,EAAE,GAAG,KAAK,iBAAiB,GAAG,SAAS,CAAC;IAClE,cAAc,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACpE;AAED,MAAM,WAAW,yBAAyB;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,YAAY,EAAE,GAAG,CAAC;IAClB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;IAC5D,WAAW,EAAE,uBAAuB,CAAC,aAAa,CAAC,CAAC;IACpD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAoBD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB;qBAU7C,OAAO,CAAC,oBAAoB,CAAC;wBAYtB,OAAO,CAAC,eAAe,CAAC;0BAUhC,iBAAiB,GAAG,SAAS;qBAqB7C,IAAI,CAAC,yBAAyB,EAAE,WAAW,GAAG,aAAa,CAAC,KACpE,OAAO,CAAC,0BAA0B,CAAC;gBA0Bb,aAAa,KAAG,OAAO,CAAC,wBAAwB,CAAC;EAuE3E"}