@shielded-x402/client 0.1.3 → 0.2.1

package/dist/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/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/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/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/client.d.ts

@@ -0,0 +1,26 @@
+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';
+export declare class ShieldedClientSDK {
+    private readonly config;
+    constructor(config: ShieldedClientConfig);
+    deposit(amount: bigint, ownerPkHash: Hex): Promise<{
+        note: ShieldedNote;
+        txHash?: Hex;
+        leafIndex: number;
+    }>;
+    buildSpendProof(params: SpendBuildParams): SpendProofBundle;
+    buildSpendProofWithProvider(params: SpendBuildParams): Promise<SpendProofBundle>;
+    private attachRealProof;
+    pay402(paymentResponse: ShieldedPaymentResponse, requirement: PaymentRequirement, challengeNonce: Hex): Promise<{
+        payload: string;
+        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>;
+}
+export declare function buildWitnessFromCommitments(commitments: Hex[], targetIndex: number): MerkleWitness;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +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;IAoCxB,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"}

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

@@ -0,0 +1,174 @@
+import { X402_HEADERS, buildPaymentSignatureHeader, normalizeRequirement, parsePaymentRequiredHeader } from '@shielded-x402/shared-types';
+import { randomBytes } from 'node:crypto';
+import { deriveChallengeHash, deriveCommitment, deriveNullifier } from './crypto.js';
+import { deriveWitness } from './merkle.js';
+const BN254_FIELD_MODULUS = 21888242871839275222246405745257275088548364400416034343698204186575808495617n;
+function randomFieldHex() {
+    while (true) {
+        const candidate = BigInt(`0x${randomBytes(32).toString('hex')}`);
+        if (candidate < BN254_FIELD_MODULUS) {
+            return (`0x${candidate.toString(16).padStart(64, '0')}`);
+        }
+    }
+}
+export class ShieldedClientSDK {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async deposit(amount, ownerPkHash) {
+        const rho = randomFieldHex();
+        const commitment = deriveCommitment(amount, rho, ownerPkHash);
+        const tx = this.config.depositFn ? await this.config.depositFn(amount, commitment) : undefined;
+        const result = {
+            note: {
+                amount,
+                rho,
+                pkHash: ownerPkHash,
+                commitment,
+                leafIndex: tx?.leafIndex ?? -1
+            },
+            leafIndex: tx?.leafIndex ?? -1
+        };
+        if (tx?.txHash) {
+            result.txHash = tx.txHash;
+        }
+        return result;
+    }
+    buildSpendProof(params) {
+        if (params.amount > params.note.amount) {
+            throw new Error('insufficient note amount');
+        }
+        const nullifier = deriveNullifier(params.nullifierSecret, params.note.commitment);
+        const merchantRho = params.merchantRho ?? randomFieldHex();
+        const merchantCommitment = deriveCommitment(params.amount, merchantRho, params.merchantPubKey);
+        const changeAmount = params.note.amount - params.amount;
+        const changeRho = params.changeRho ?? 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 response = {
+            proof: '0x00',
+            publicInputs: [
+                nullifier,
+                params.witness.root,
+                merchantCommitment,
+                changeCommitment,
+                challengeHash,
+                amountHex
+            ],
+            nullifier,
+            root: params.witness.root,
+            merchantCommitment,
+            changeCommitment,
+            challengeHash,
+            encryptedReceipt: params.encryptedReceipt,
+            txHint: `leaf:${params.note.leafIndex}`
+        };
+        return {
+            merchantRho,
+            response,
+            changeNote: {
+                amount: changeAmount,
+                rho: changeRho,
+                pkHash: params.note.pkHash,
+                commitment: changeCommitment,
+                leafIndex: -1
+            }
+        };
+    }
+    async buildSpendProofWithProvider(params) {
+        const bundle = this.buildSpendProof(params);
+        return this.attachRealProof(bundle, params);
+    }
+    async attachRealProof(bundle, params) {
+        if (!this.config.proofProvider) {
+            return bundle;
+        }
+        const proofResult = await this.config.proofProvider.generateProof({
+            note: params.note,
+            witness: params.witness,
+            nullifierSecret: params.nullifierSecret,
+            merchantPubKey: params.merchantPubKey,
+            merchantRho: bundle.merchantRho,
+            changePkHash: params.note.pkHash,
+            changeRho: bundle.changeNote.rho,
+            amount: params.amount,
+            challengeNonce: params.challengeNonce,
+            merchantAddress: params.merchantAddress,
+            expectedPublicInputs: bundle.response.publicInputs
+        });
+        const publicInputs = proofResult.publicInputs ?? bundle.response.publicInputs;
+        return {
+            ...bundle,
+            response: {
+                ...bundle.response,
+                proof: proofResult.proof,
+                publicInputs
+            }
+        };
+    }
+    async pay402(paymentResponse, requirement, challengeNonce) {
+        const payload = JSON.stringify(paymentResponse);
+        const signature = await this.config.signer(payload);
+        const paymentSignatureHeader = buildPaymentSignatureHeader({
+            x402Version: 2,
+            accepted: normalizeRequirement(requirement),
+            payload: paymentResponse,
+            challengeNonce,
+            signature: signature
+        });
+        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) {
+        if (requirement.rail !== 'shielded-usdc') {
+            throw new Error(`unsupported rail: ${requirement.rail}`);
+        }
+        const nonce = requirement.challengeNonce;
+        const merchant = requirement.verifyingContract;
+        const amount = BigInt(requirement.amount);
+        const spendParams = {
+            note,
+            witness,
+            nullifierSecret: payerPkHash,
+            merchantPubKey: requirement.merchantPubKey,
+            merchantAddress: merchant,
+            amount,
+            challengeNonce: nonce,
+            encryptedReceipt: '0x'
+        };
+        const bundleWithProof = await this.buildSpendProofWithProvider(spendParams);
+        const signed = await this.pay402(bundleWithProof.response, requirement, requirement.challengeNonce);
+        const headers = new Headers(baseHeaders);
+        headers.set(X402_HEADERS.paymentSignature, signed.paymentSignatureHeader);
+        return {
+            requirement,
+            headers,
+            response: bundleWithProof.response
+        };
+    }
+    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);
+}
+//# sourceMappingURL=client.js.map

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

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

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

@@ -0,0 +1,5 @@
+import { type Hex } from 'viem';
+export declare function deriveCommitment(amount: bigint, rho: Hex, pkHash: Hex): Hex;
+export declare function deriveNullifier(nullifierSecret: Hex, commitment: Hex): Hex;
+export declare function deriveChallengeHash(challengeNonce: Hex, amount: bigint, merchant: Hex): Hex;
+//# sourceMappingURL=crypto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../../../src/crypto.ts"],"names":[],"mappings":"AACA,OAAO,EAA6B,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAE3D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG,CAG3E;AAED,wBAAgB,eAAe,CAAC,eAAe,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,GAAG,GAAG,CAE1E;AAED,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,GAAG,CAM3F"}

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

@@ -0,0 +1,15 @@
+import { CRYPTO_SPEC } from '@shielded-x402/shared-types';
+import { concatHex, keccak256, pad } from 'viem';
+export function deriveCommitment(amount, rho, pkHash) {
+    const amountWord = `0x${amount.toString(16).padStart(64, '0')}`;
+    return keccak256(concatHex([amountWord, rho, pkHash]));
+}
+export function deriveNullifier(nullifierSecret, commitment) {
+    return keccak256(concatHex([nullifierSecret, commitment]));
+}
+export function deriveChallengeHash(challengeNonce, amount, merchant) {
+    const amountWord = `0x${amount.toString(16).padStart(64, '0')}`;
+    const merchantWord = pad(merchant, { size: 32 });
+    return keccak256(concatHex([CRYPTO_SPEC.challengeDomainHash, challengeNonce, amountWord, merchantWord]));
+}
+//# sourceMappingURL=crypto.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../../../../src/crypto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAY,MAAM,MAAM,CAAC;AAE3D,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,GAAQ,EAAE,MAAW;IACpE,MAAM,UAAU,GAAI,KAAK,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,EAAU,CAAC;IACzE,OAAO,SAAS,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,eAAoB,EAAE,UAAe;IACnE,OAAO,SAAS,CAAC,SAAS,CAAC,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,cAAmB,EAAE,MAAc,EAAE,QAAa;IACpF,MAAM,UAAU,GAAI,KAAK,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,EAAU,CAAC;IACzE,MAAM,YAAY,GAAG,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACjD,OAAO,SAAS,CACd,SAAS,CAAC,CAAC,WAAW,CAAC,mBAA0B,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAC9F,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,10 @@
+export * from './client.js';
+export * from './crypto.js';
+export * from './indexer.js';
+export * from './merkle.js';
+export * from './notes.js';
+export * from './proofProvider.js';
+export * from './relayerFetch.js';
+export * from './shieldedFetch.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1,10 @@
+export * from './client.js';
+export * from './crypto.js';
+export * from './indexer.js';
+export * from './merkle.js';
+export * from './notes.js';
+export * from './proofProvider.js';
+export * from './relayerFetch.js';
+export * from './shieldedFetch.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1,22 @@
+import type { Hex, ShieldedNote } from '@shielded-x402/shared-types';
+export interface DepositEvent {
+    commitment: Hex;
+    leafIndex: number;
+    amount: bigint;
+}
+export interface SpendEvent {
+    merchantCommitment: Hex;
+    changeCommitment: Hex;
+}
+export interface NoteState {
+    commitments: Hex[];
+    notes: ShieldedNote[];
+}
+export declare class LocalNoteIndexer {
+    private readonly state;
+    ingestDeposit(event: DepositEvent, note: ShieldedNote): void;
+    ingestSpend(event: SpendEvent): void;
+    getCommitments(): Hex[];
+    getNotes(): ShieldedNote[];
+}
+//# sourceMappingURL=indexer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../../../../src/indexer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAErE,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,GAAG,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,kBAAkB,EAAE,GAAG,CAAC;IACxB,gBAAgB,EAAE,GAAG,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,GAAG,EAAE,CAAC;IACnB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAGpB;IAEF,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI;IAK5D,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAIpC,cAAc,IAAI,GAAG,EAAE;IAIvB,QAAQ,IAAI,YAAY,EAAE;CAG3B"}

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

@@ -0,0 +1,20 @@
+export class LocalNoteIndexer {
+    state = {
+        commitments: [],
+        notes: []
+    };
+    ingestDeposit(event, note) {
+        this.state.commitments[event.leafIndex] = event.commitment;
+        this.state.notes.push(note);
+    }
+    ingestSpend(event) {
+        this.state.commitments.push(event.merchantCommitment, event.changeCommitment);
+    }
+    getCommitments() {
+        return [...this.state.commitments];
+    }
+    getNotes() {
+        return [...this.state.notes];
+    }
+}
+//# sourceMappingURL=indexer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.js","sourceRoot":"","sources":["../../../../src/indexer.ts"],"names":[],"mappings":"AAkBA,MAAM,OAAO,gBAAgB;IACV,KAAK,GAAc;QAClC,WAAW,EAAE,EAAE;QACf,KAAK,EAAE,EAAE;KACV,CAAC;IAEF,aAAa,CAAC,KAAmB,EAAE,IAAkB;QACnD,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC;QAC3D,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,WAAW,CAAC,KAAiB;QAC3B,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAChF,CAAC;IAED,cAAc;QACZ,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACrC,CAAC;IAED,QAAQ;QACN,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;CACF"}

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

@@ -0,0 +1,11 @@
+import { type Hex } from 'viem';
+export interface MerkleWitness {
+    root: Hex;
+    path: Hex[];
+    indexBits: number[];
+}
+export declare function buildZeroes(depth: number): Hex[];
+export declare function emptyRoot(depth?: number): Hex;
+export declare function deriveWitness(commitments: Hex[], targetIndex: number): MerkleWitness;
+export declare function deriveRootFromCommitments(commitments: Hex[]): Hex;
+//# sourceMappingURL=merkle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"merkle.d.ts","sourceRoot":"","sources":["../../../../src/merkle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAKtD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,GAAG,CAAC;IACV,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAMD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,CAOhD;AAED,wBAAgB,SAAS,CAAC,KAAK,GAAE,MAAoC,GAAG,GAAG,CAM1E;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,GAAG,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,CA2CpF;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,GAAG,EAAE,GAAG,GAAG,CAKjE"}