@shielded-x402/client 0.2.0 → 0.2.1

package/dist/sdk/client/src/proofProvider.js

@@ -0,0 +1,207 @@
+import { CRYPTO_SPEC } from '@shielded-x402/shared-types';
+import { pad } from 'viem';
+const BN254_FIELD_MODULUS = 21888242871839275222246405745257275088548364400416034343698204186575808495617n;
+const MERKLE_DEPTH = CRYPTO_SPEC.merkleTreeDepth;
+const toHexWord = (value) => `0x${value.toString(16).padStart(64, '0')}`;
+const normalizeHex = (value) => {
+    const trimmed = value.trim().toLowerCase();
+    if (!trimmed.startsWith('0x')) {
+        return `0x${BigInt(trimmed).toString(16)}`;
+    }
+    return trimmed;
+};
+const hexToBytes32 = (value) => {
+    const hex = value.slice(2).padStart(64, '0');
+    const bytes = [];
+    for (let i = 0; i < 64; i += 2) {
+        bytes.push(Number.parseInt(hex.slice(i, i + 2), 16));
+    }
+    return bytes;
+};
+const fieldHexToDecimal = (value, label) => {
+    const scalar = BigInt(value);
+    if (scalar >= BN254_FIELD_MODULUS) {
+        throw new Error(`${label} exceeds BN254 field modulus; provide a field-safe value`);
+    }
+    return scalar.toString(10);
+};
+const normalizePublicInputWord = (value) => {
+    if (typeof value === 'string') {
+        return toHexWord(BigInt(normalizeHex(value)));
+    }
+    if (typeof value === 'bigint') {
+        return toHexWord(value);
+    }
+    if (typeof value === 'number') {
+        return toHexWord(BigInt(value));
+    }
+    throw new Error(`unsupported public input value type: ${typeof value}`);
+};
+const collapseExpandedPublicInputs = (publicInputs) => {
+    if (publicInputs.length < 161)
+        return null;
+    const readWord = (start) => {
+        const bytes = [];
+        for (let i = 0; i < 32; i += 1) {
+            const item = publicInputs[start + i];
+            if (!item)
+                throw new Error('invalid expanded public input');
+            const n = BigInt(item);
+            if (n < 0n || n > 255n)
+                throw new Error('expanded public input byte out of range');
+            bytes.push(Number(n));
+        }
+        return `0x${Buffer.from(bytes).toString('hex')}`;
+    };
+    return [
+        readWord(0),
+        readWord(32),
+        readWord(64),
+        readWord(96),
+        readWord(128),
+        toHexWord(BigInt(publicInputs[160] ?? '0x0'))
+    ];
+};
+const normalizePublicInputs = (values) => {
+    if (!Array.isArray(values))
+        return [];
+    const words = values.map((value) => normalizePublicInputWord(value));
+    if (words.length === 6)
+        return words;
+    const collapsed = collapseExpandedPublicInputs(words);
+    return collapsed ?? words;
+};
+const normalizeProofHex = (value) => {
+    if (typeof value === 'string') {
+        return normalizeHex(value);
+    }
+    if (value instanceof Uint8Array) {
+        return `0x${Buffer.from(value).toString('hex')}`;
+    }
+    if (value && typeof value === 'object' && 'proof' in value) {
+        return normalizeProofHex(value.proof);
+    }
+    throw new Error('unsupported proof value');
+};
+const toNoirInput = (request) => {
+    if (request.witness.path.length > MERKLE_DEPTH || request.witness.indexBits.length > MERKLE_DEPTH) {
+        throw new Error(`merkle witness exceeds configured depth ${MERKLE_DEPTH}`);
+    }
+    const pathBytes = request.witness.path.slice(0, MERKLE_DEPTH).map((value) => hexToBytes32(value));
+    const merklePath = [...pathBytes];
+    while (merklePath.length < MERKLE_DEPTH) {
+        merklePath.push(new Array(32).fill(0));
+    }
+    const indexBits = request.witness.indexBits.slice(0, MERKLE_DEPTH);
+    while (indexBits.length < MERKLE_DEPTH) {
+        indexBits.push(0);
+    }
+    const normalizedIndexBits = indexBits.map((bit) => {
+        if (bit !== 0 && bit !== 1) {
+            throw new Error('merkle witness indexBits must be 0/1');
+        }
+        return bit;
+    });
+    return {
+        note_amount: request.note.amount.toString(10),
+        note_rho: fieldHexToDecimal(request.note.rho, 'note.rho'),
+        note_pk_hash: fieldHexToDecimal(request.note.pkHash, 'note.pkHash'),
+        nullifier_secret: fieldHexToDecimal(request.nullifierSecret, 'nullifierSecret'),
+        merkle_path: merklePath,
+        index_bits: normalizedIndexBits,
+        merchant_pk_hash: fieldHexToDecimal(request.merchantPubKey, 'merchantPubKey'),
+        merchant_rho: fieldHexToDecimal(request.merchantRho, 'merchantRho'),
+        change_pk_hash: fieldHexToDecimal(request.changePkHash, 'changePkHash'),
+        change_rho: fieldHexToDecimal(request.changeRho, 'changeRho'),
+        pay_amount: request.amount.toString(10),
+        challenge_nonce: hexToBytes32(request.challengeNonce),
+        merchant_address_word: hexToBytes32(pad(request.merchantAddress, { size: 32 }))
+    };
+};
+const equalPublicInputs = (left, right) => {
+    if (left.length !== right.length)
+        return false;
+    for (let i = 0; i < left.length; i += 1) {
+        if ((left[i] ?? '').toLowerCase() !== (right[i] ?? '').toLowerCase()) {
+            return false;
+        }
+    }
+    return true;
+};
+const isNoirCircuitArtifact = (value) => {
+    return Boolean(value &&
+        typeof value === 'object' &&
+        typeof value.bytecode === 'string');
+};
+const loadBundledSpendChangeCircuit = async () => {
+    const dynamicImport = new Function('m', 'return import(m)');
+    // Node-safe path: avoid JSON module import-attribute issues by reading raw file.
+    try {
+        const fs = await dynamicImport('node:fs/promises');
+        const raw = await fs.readFile(new URL('./circuits/spend_change.json', import.meta.url), 'utf8');
+        const parsed = JSON.parse(raw);
+        if (isNoirCircuitArtifact(parsed))
+            return parsed;
+    }
+    catch {
+        // Fall through to runtime module import fallback.
+    }
+    const module = await dynamicImport('./circuits/spend_change.json');
+    const candidate = module.default ?? module;
+    if (!isNoirCircuitArtifact(candidate)) {
+        throw new Error('bundled spend_change circuit artifact is invalid');
+    }
+    return candidate;
+};
+export function createNoirJsProofProvider(config) {
+    return {
+        async generateProof(request) {
+            const noirInput = toNoirInput(request);
+            const { witness } = await config.noir.execute(noirInput);
+            const generated = await config.backend.generateProof(witness);
+            const proof = normalizeProofHex(generated.proof);
+            const normalized = normalizePublicInputs(generated.publicInputs);
+            const useNormalized = normalized.length > 0;
+            const finalPublicInputs = useNormalized ? normalized : request.expectedPublicInputs;
+            if ((config.enforcePublicInputsMatch ?? true) && !equalPublicInputs(finalPublicInputs, request.expectedPublicInputs)) {
+                throw new Error('proof provider public inputs mismatch with SDK-computed values');
+            }
+            return {
+                proof,
+                publicInputs: finalPublicInputs
+            };
+        }
+    };
+}
+/**
+ * Convenience factory for Node agent apps:
+ * instantiates Noir + UltraHonkBackend from a compiled Noir circuit artifact.
+ */
+export async function createNoirJsProofProviderFromCircuit(circuit, config) {
+    const dynamicImport = new Function('m', 'return import(m)');
+    const noirPkg = await dynamicImport('@noir-lang/noir_js');
+    const bbPkg = await dynamicImport('@aztec/bb.js');
+    const Noir = noirPkg.Noir;
+    const UltraHonkBackend = bbPkg.UltraHonkBackend;
+    const noir = new Noir(circuit);
+    const backend = new UltraHonkBackend(circuit.bytecode);
+    const providerConfig = {
+        noir,
+        backend
+    };
+    if (config?.enforcePublicInputsMatch !== undefined) {
+        providerConfig.enforcePublicInputsMatch = config.enforcePublicInputsMatch;
+    }
+    return createNoirJsProofProvider({
+        ...providerConfig
+    });
+}
+/**
+ * Highest-level convenience for agent apps:
+ * loads the bundled spend_change artifact from this package.
+ */
+export async function createNoirJsProofProviderFromDefaultCircuit(config) {
+    const circuit = await loadBundledSpendChangeCircuit();
+    return createNoirJsProofProviderFromCircuit(circuit, config);
+}
+//# sourceMappingURL=proofProvider.js.map

package/dist/sdk/client/src/proofProvider.js.map

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

package/dist/sdk/client/src/relayerFetch.d.ts

@@ -0,0 +1,36 @@
+import { type Hex, type PaymentRequirement, type ShieldedNote } from '@shielded-x402/shared-types';
+import { ShieldedClientSDK } from './client.js';
+import type { MerkleWitness } from './merkle.js';
+export interface RelayedShieldedFetchContext {
+    note: ShieldedNote;
+    witness: MerkleWitness;
+    payerPkHash: Hex;
+}
+export interface ResolveRelayedContextArgs {
+    input: string;
+    init: RequestInit;
+    requirement: PaymentRequirement;
+    challengeResponse: Response;
+}
+export interface UnsupportedRelayedRailArgs {
+    input: string;
+    init: RequestInit;
+    requirement: PaymentRequirement;
+    challengeResponse: Response;
+}
+export interface CreateRelayedShieldedFetchConfig {
+    sdk: ShieldedClientSDK;
+    relayerEndpoint: string;
+    relayerPath?: string;
+    relayerChallengePath?: string;
+    resolveContext: (args: ResolveRelayedContextArgs) => Promise<RelayedShieldedFetchContext>;
+    challengeUrlResolver?: (args: {
+        input: string;
+        requirement?: PaymentRequirement;
+    }) => string | undefined;
+    onUnsupportedRail?: (args: UnsupportedRelayedRailArgs) => Promise<Response>;
+    fetchImpl?: typeof fetch;
+}
+export type RelayedShieldedFetch = (input: string | URL, init?: RequestInit) => Promise<Response>;
+export declare function createRelayedShieldedFetch(config: CreateRelayedShieldedFetchConfig): RelayedShieldedFetch;
+//# sourceMappingURL=relayerFetch.d.ts.map

package/dist/sdk/client/src/relayerFetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relayerFetch.d.ts","sourceRoot":"","sources":["../../../../src/relayerFetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,GAAG,EACR,KAAK,kBAAkB,EAKvB,KAAK,YAAY,EAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,aAAa,CAAC;IACvB,WAAW,EAAE,GAAG,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,kBAAkB,CAAC;IAChC,iBAAiB,EAAE,QAAQ,CAAC;CAC7B;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,kBAAkB,CAAC;IAChC,iBAAiB,EAAE,QAAQ,CAAC;CAC7B;AAED,MAAM,WAAW,gCAAgC;IAC/C,GAAG,EAAE,iBAAiB,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,cAAc,EAAE,CAAC,IAAI,EAAE,yBAAyB,KAAK,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC1F,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,kBAAkB,CAAA;KAAE,KAAK,MAAM,GAAG,SAAS,CAAC;IACzG,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,0BAA0B,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5E,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAyHlG,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,gCAAgC,GAAG,oBAAoB,CAuHzG"}

package/dist/sdk/client/src/relayerFetch.js

@@ -0,0 +1,195 @@
+import { parsePaymentRequiredEnvelope, parsePaymentRequiredHeader, RELAYER_ROUTES, X402_HEADERS } from '@shielded-x402/shared-types';
+function normalizeInput(input) {
+    if (typeof input === 'string')
+        return input;
+    return input.toString();
+}
+function headersToRecord(headers) {
+    if (!headers)
+        return {};
+    const out = {};
+    const cast = new Headers(headers);
+    cast.forEach((value, key) => {
+        out[key] = value;
+    });
+    return out;
+}
+function bytesToBase64(bytes) {
+    return Buffer.from(bytes).toString('base64');
+}
+function serializedToFetchInit(method, serialized) {
+    const init = {
+        method,
+        headers: serialized.headers
+    };
+    if (method !== 'GET' && method !== 'HEAD' && serialized.bodyBase64 !== undefined) {
+        init.body = Buffer.from(serialized.bodyBase64, 'base64');
+    }
+    return init;
+}
+async function requestShieldedRequirementFromRelayer(baseFetch, relayerEndpoint, relayerChallengePath, merchantRequest, merchantPaymentRequiredHeader) {
+    const challengeRequest = {
+        merchantRequest,
+        merchantPaymentRequiredHeader
+    };
+    const response = await baseFetch(`${relayerEndpoint.replace(/\/$/, '')}${relayerChallengePath}`, {
+        method: 'POST',
+        headers: {
+            'content-type': 'application/json'
+        },
+        body: JSON.stringify(challengeRequest)
+    });
+    if (!response.ok) {
+        const body = await response.text();
+        throw new Error(`relayer challenge request failed: ${response.status} ${body}`);
+    }
+    const payload = (await response.json());
+    if (payload.requirement) {
+        return payload.requirement;
+    }
+    if (payload.paymentRequiredHeader) {
+        return parsePaymentRequiredHeader(payload.paymentRequiredHeader);
+    }
+    throw new Error('relayer challenge response missing requirement');
+}
+async function serializeMerchantRequestBody(method, headers, body) {
+    const normalizedMethod = method.toUpperCase();
+    const supportsBody = normalizedMethod !== 'GET' && normalizedMethod !== 'HEAD';
+    const requestInit = {
+        method: normalizedMethod
+    };
+    if (headers !== undefined) {
+        requestInit.headers = headers;
+    }
+    if (supportsBody && body !== undefined && body !== null) {
+        requestInit.body = body;
+    }
+    const request = new Request('http://relay.local', requestInit);
+    const serializedHeaders = headersToRecord(request.headers);
+    if (!supportsBody || body === undefined || body === null) {
+        return { headers: serializedHeaders };
+    }
+    const bytes = new Uint8Array(await request.arrayBuffer());
+    return {
+        headers: serializedHeaders,
+        bodyBase64: bytesToBase64(bytes)
+    };
+}
+function toRelayResultResponse(relayResponse) {
+    const settlementIdHeader = { 'x-relayer-settlement-id': relayResponse.settlementId };
+    if (!relayResponse.merchantResult) {
+        const status = relayResponse.status === 'DONE' ? 200 : 502;
+        return new Response(JSON.stringify(relayResponse), {
+            status,
+            headers: {
+                ...settlementIdHeader,
+                'content-type': 'application/json'
+            }
+        });
+    }
+    return new Response(Buffer.from(relayResponse.merchantResult.bodyBase64, 'base64'), {
+        status: relayResponse.merchantResult.status,
+        headers: {
+            ...relayResponse.merchantResult.headers,
+            ...settlementIdHeader
+        }
+    });
+}
+export function createRelayedShieldedFetch(config) {
+    const baseFetch = config.fetchImpl ?? fetch;
+    const relayerPath = config.relayerPath ?? RELAYER_ROUTES.pay;
+    const relayerChallengePath = config.relayerChallengePath ?? RELAYER_ROUTES.challenge;
+    return async (input, init) => {
+        const normalizedInput = normalizeInput(input);
+        const requestInit = init ?? {};
+        const method = (requestInit.method ?? 'GET').toUpperCase();
+        const serializedRequest = await serializeMerchantRequestBody(method, requestInit.headers, requestInit.body);
+        const baseMerchantRequest = {
+            url: normalizedInput,
+            method,
+            headers: serializedRequest.headers,
+            ...(serializedRequest.bodyBase64 !== undefined
+                ? { bodyBase64: serializedRequest.bodyBase64 }
+                : {})
+        };
+        const first = await baseFetch(normalizedInput, serializedToFetchInit(method, serializedRequest));
+        if (first.status !== 402)
+            return first;
+        const merchantRequiredHeader = first.headers.get(X402_HEADERS.paymentRequired);
+        if (!merchantRequiredHeader) {
+            throw new Error(`missing ${X402_HEADERS.paymentRequired} header`);
+        }
+        parsePaymentRequiredEnvelope(merchantRequiredHeader);
+        let requirement;
+        let parsedRequirement;
+        try {
+            parsedRequirement = config.sdk.parse402Response(first).requirement;
+        }
+        catch {
+            parsedRequirement = undefined;
+        }
+        if (parsedRequirement?.rail === 'shielded-usdc') {
+            requirement = parsedRequirement;
+        }
+        else {
+            const challengeUrl = config.challengeUrlResolver?.(parsedRequirement
+                ? {
+                    input: normalizedInput,
+                    requirement: parsedRequirement
+                }
+                : {
+                    input: normalizedInput
+                });
+            try {
+                requirement = await requestShieldedRequirementFromRelayer(baseFetch, config.relayerEndpoint, relayerChallengePath, {
+                    ...baseMerchantRequest,
+                    ...(challengeUrl ? { challengeUrl } : {})
+                }, merchantRequiredHeader);
+            }
+            catch (error) {
+                if (parsedRequirement && config.onUnsupportedRail) {
+                    return config.onUnsupportedRail({
+                        input: normalizedInput,
+                        init: requestInit,
+                        requirement: parsedRequirement,
+                        challengeResponse: first
+                    });
+                }
+                throw error;
+            }
+        }
+        const context = await config.resolveContext({
+            input: normalizedInput,
+            init: requestInit,
+            requirement,
+            challengeResponse: first
+        });
+        const prepared = await config.sdk.prepare402Payment(requirement, context.note, context.witness, context.payerPkHash, serializedRequest.headers);
+        const paymentSignatureHeader = prepared.headers.get(X402_HEADERS.paymentSignature);
+        if (!paymentSignatureHeader) {
+            throw new Error('failed to build relayer payment headers');
+        }
+        const challengeUrl = config.challengeUrlResolver?.({
+            input: normalizedInput,
+            requirement
+        });
+        const relayRequest = {
+            merchantRequest: {
+                ...baseMerchantRequest,
+                ...(challengeUrl ? { challengeUrl } : {})
+            },
+            requirement,
+            paymentSignatureHeader
+        };
+        const relayerResponse = await baseFetch(`${config.relayerEndpoint.replace(/\/$/, '')}${relayerPath}`, {
+            method: 'POST',
+            headers: {
+                'content-type': 'application/json'
+            },
+            body: JSON.stringify(relayRequest)
+        });
+        const relayPayload = (await relayerResponse.json());
+        return toRelayResultResponse(relayPayload);
+    };
+}
+//# sourceMappingURL=relayerFetch.js.map

package/dist/sdk/client/src/relayerFetch.js.map

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

package/dist/sdk/client/src/shieldedFetch.d.ts

@@ -0,0 +1,39 @@
+import { type Hex, type PaymentRequirement, type ShieldedNote } from '@shielded-x402/shared-types';
+import { ShieldedClientSDK } from './client.js';
+import type { MerkleWitness } from './merkle.js';
+export interface ShieldedFetchContext {
+    note: ShieldedNote;
+    witness: MerkleWitness;
+    payerPkHash: Hex;
+}
+export interface ResolveShieldedContextArgs {
+    input: string;
+    init: RequestInit;
+    requirement: PaymentRequirement;
+    challengeResponse: Response;
+}
+export interface UnsupportedRailArgs {
+    input: string;
+    init: RequestInit;
+    requirement: PaymentRequirement;
+    challengeResponse: Response;
+}
+export interface CreateShieldedFetchConfig {
+    sdk: ShieldedClientSDK;
+    resolveContext: (args: ResolveShieldedContextArgs) => Promise<ShieldedFetchContext>;
+    onUnsupportedRail?: (args: UnsupportedRailArgs) => Promise<Response>;
+    prefetchRequirement?: (args: {
+        input: string;
+        init: RequestInit;
+    }) => Promise<PaymentRequirement | null>;
+    fetchImpl?: typeof fetch;
+    relayerEndpoint?: string;
+    relayerPath?: string;
+    challengeUrlResolver?: (args: {
+        input: string;
+        requirement?: PaymentRequirement;
+    }) => string | undefined;
+}
+export type ShieldedFetch = (input: string | URL, init?: RequestInit) => Promise<Response>;
+export declare function createShieldedFetch(config: CreateShieldedFetchConfig): ShieldedFetch;
+//# sourceMappingURL=shieldedFetch.d.ts.map

package/dist/sdk/client/src/shieldedFetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shieldedFetch.d.ts","sourceRoot":"","sources":["../../../../src/shieldedFetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,GAAG,EACR,KAAK,kBAAkB,EACvB,KAAK,YAAY,EAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,aAAa,CAAC;IACvB,WAAW,EAAE,GAAG,CAAC;CAClB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,kBAAkB,CAAC;IAChC,iBAAiB,EAAE,QAAQ,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,kBAAkB,CAAC;IAChC,iBAAiB,EAAE,QAAQ,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,iBAAiB,CAAC;IACvB,cAAc,EAAE,CAAC,IAAI,EAAE,0BAA0B,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACpF,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrE,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,WAAW,CAAA;KAAE,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IACzG,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,kBAAkB,CAAA;KAAE,KAAK,MAAM,GAAG,SAAS,CAAC;CAC1G;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAO3F,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,yBAAyB,GAAG,aAAa,CAiGpF"}

package/dist/sdk/client/src/shieldedFetch.js

@@ -0,0 +1,88 @@
+import { X402_HEADERS, buildPaymentRequiredHeader } from '@shielded-x402/shared-types';
+import { createRelayedShieldedFetch } from './relayerFetch.js';
+const normalizeInput = (input) => {
+    if (typeof input === 'string')
+        return input;
+    return input.toString();
+};
+export function createShieldedFetch(config) {
+    if (config.relayerEndpoint) {
+        const relayedConfig = {
+            sdk: config.sdk,
+            relayerEndpoint: config.relayerEndpoint,
+            resolveContext: config.resolveContext
+        };
+        if (config.onUnsupportedRail) {
+            relayedConfig.onUnsupportedRail = config.onUnsupportedRail;
+        }
+        if (config.relayerPath) {
+            relayedConfig.relayerPath = config.relayerPath;
+        }
+        if (config.fetchImpl) {
+            relayedConfig.fetchImpl = config.fetchImpl;
+        }
+        if (config.challengeUrlResolver) {
+            relayedConfig.challengeUrlResolver = config.challengeUrlResolver;
+        }
+        return createRelayedShieldedFetch(relayedConfig);
+    }
+    const baseFetch = config.fetchImpl ?? fetch;
+    return async (input, init) => {
+        const normalizedInput = normalizeInput(input);
+        const requestInit = init ?? {};
+        let first = null;
+        if (config.prefetchRequirement) {
+            const prefetched = await config.prefetchRequirement({
+                input: normalizedInput,
+                init: requestInit
+            });
+            if (prefetched?.rail === 'shielded-usdc') {
+                const syntheticChallenge = new Response(null, {
+                    status: 402,
+                    headers: {
+                        [X402_HEADERS.paymentRequired]: buildPaymentRequiredHeader(prefetched)
+                    }
+                });
+                const context = await config.resolveContext({
+                    input: normalizedInput,
+                    init: requestInit,
+                    requirement: prefetched,
+                    challengeResponse: syntheticChallenge
+                });
+                const prepared = await config.sdk.prepare402Payment(prefetched, context.note, context.witness, context.payerPkHash, requestInit.headers);
+                first = await baseFetch(normalizedInput, {
+                    ...requestInit,
+                    headers: prepared.headers
+                });
+                if (first.status !== 402) {
+                    return first;
+                }
+            }
+        }
+        if (!first) {
+            first = await baseFetch(normalizedInput, requestInit);
+        }
+        if (first.status !== 402)
+            return first;
+        const parsed = config.sdk.parse402Response(first);
+        if (parsed.requirement.rail !== 'shielded-usdc') {
+            if (config.onUnsupportedRail) {
+                return config.onUnsupportedRail({
+                    input: normalizedInput,
+                    init: requestInit,
+                    requirement: parsed.requirement,
+                    challengeResponse: first
+                });
+            }
+            return first;
+        }
+        const context = await config.resolveContext({
+            input: normalizedInput,
+            init: requestInit,
+            requirement: parsed.requirement,
+            challengeResponse: first
+        });
+        return config.sdk.complete402Payment(normalizedInput, requestInit, parsed.requirement, context.note, context.witness, context.payerPkHash, baseFetch);
+    };
+}
+//# sourceMappingURL=shieldedFetch.js.map

package/dist/sdk/client/src/shieldedFetch.js.map

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