@shielded-x402/client 0.1.1

package/dist/proofProvider.js

@@ -0,0 +1,177 @@
+import { pad } from 'viem';
+import bundledSpendChangeCircuit from './circuits/spend_change.json';
+const BN254_FIELD_MODULUS = 21888242871839275222246405745257275088548364400416034343698204186575808495617n;
+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) => {
+    const pathBytes = request.witness.path.map((value) => hexToBytes32(value));
+    const merklePath = [...pathBytes];
+    while (merklePath.length < 32) {
+        merklePath.push(new Array(32).fill(0));
+    }
+    const indexBits = request.witness.indexBits.slice(0, 32);
+    while (indexBits.length < 32) {
+        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;
+};
+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) {
+    return createNoirJsProofProviderFromCircuit(bundledSpendChangeCircuit, config);
+}
+//# sourceMappingURL=proofProvider.js.map

package/dist/proofProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proofProvider.js","sourceRoot":"","sources":["../src/proofProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAY,MAAM,MAAM,CAAC;AAErC,OAAO,yBAAyB,MAAM,8BAA8B,CAAC;AAErE,MAAM,mBAAmB,GACvB,8EAA8E,CAAC;AAEjF,MAAM,SAAS,GAAG,CAAC,KAAa,EAAO,EAAE,CAAE,KAAK,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,EAAU,CAAC;AAE/F,MAAM,YAAY,GAAG,CAAC,KAAa,EAAO,EAAE;IAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAQ,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAU,CAAC;IACtD,CAAC;IACD,OAAQ,OAAe,CAAC;AAC1B,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,KAAU,EAAY,EAAE;IAC5C,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,KAAU,EAAE,KAAa,EAAU,EAAE;IAC9D,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,MAAM,IAAI,mBAAmB,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,0DAA0D,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC7B,CAAC,CAAC;AAEF,MAAM,wBAAwB,GAAG,CAAC,KAAc,EAAO,EAAE;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,wCAAwC,OAAO,KAAK,EAAE,CAAC,CAAC;AAC1E,CAAC,CAAC;AAEF,MAAM,4BAA4B,GAAG,CAAC,YAAmB,EAAgB,EAAE;IACzE,IAAI,YAAY,CAAC,MAAM,GAAG,GAAG;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAO,EAAE;QACtC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YACrC,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YAC5D,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YACvB,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;YACnF,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC;QACD,OAAQ,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAU,CAAC;IAC5D,CAAC,CAAC;IACF,OAAO;QACL,QAAQ,CAAC,CAAC,CAAC;QACX,QAAQ,CAAC,EAAE,CAAC;QACZ,QAAQ,CAAC,EAAE,CAAC;QACZ,QAAQ,CAAC,EAAE,CAAC;QACZ,QAAQ,CAAC,GAAG,CAAC;QACb,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC;KAC9C,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAAC,MAAe,EAAS,EAAE;IACvD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;IACrE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,MAAM,SAAS,GAAG,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACtD,OAAO,SAAS,IAAI,KAAK,CAAC;AAC5B,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAAO,EAAE;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,OAAQ,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAU,CAAC;IAC5D,CAAC;IACD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;QAC3D,OAAO,iBAAiB,CAAE,KAA4B,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;AAC7C,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,OAA6B,EAA2B,EAAE;IAC7E,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;IAClC,OAAO,UAAU,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QAC9B,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,CAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzD,OAAO,SAAS,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QAC7B,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IACD,MAAM,mBAAmB,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAChD,IAAI,GAAG,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7C,QAAQ,EAAE,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC;QACzD,YAAY,EAAE,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC;QACnE,gBAAgB,EAAE,iBAAiB,CAAC,OAAO,CAAC,eAAe,EAAE,iBAAiB,CAAC;QAC/E,WAAW,EAAE,UAAU;QACvB,UAAU,EAAE,mBAAmB;QAC/B,gBAAgB,EAAE,iBAAiB,CAAC,OAAO,CAAC,cAAc,EAAE,gBAAgB,CAAC;QAC7E,YAAY,EAAE,iBAAiB,CAAC,OAAO,CAAC,WAAW,EAAE,aAAa,CAAC;QACnE,cAAc,EAAE,iBAAiB,CAAC,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC;QACvE,UAAU,EAAE,iBAAiB,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC;QAC7D,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvC,eAAe,EAAE,YAAY,CAAC,OAAO,CAAC,cAAc,CAAC;QACrD,qBAAqB,EAAE,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;KAChF,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,IAAoB,EAAE,KAAqB,EAAW,EAAE;IACjF,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YACrE,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAqBF,MAAM,UAAU,yBAAyB,CAAC,MAAiC;IACzE,OAAO;QACL,KAAK,CAAC,aAAa,CAAC,OAA6B;YAC/C,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;YACvC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACzD,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAC9D,MAAM,KAAK,GAAG,iBAAiB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAEjD,MAAM,UAAU,GAAG,qBAAqB,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;YACjE,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;YAC5C,MAAM,iBAAiB,GAAG,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC;YAEpF,IAAI,CAAC,MAAM,CAAC,wBAAwB,IAAI,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,iBAAiB,EAAE,OAAO,CAAC,oBAAoB,CAAC,EAAE,CAAC;gBACrH,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;YACpF,CAAC;YAED,OAAO;gBACL,KAAK;gBACL,YAAY,EAAE,iBAAiB;aAChC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oCAAoC,CACxD,OAA4B,EAC5B,MAA4D;IAE5D,MAAM,aAAa,GAAG,IAAI,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAyC,CAAC;IACpG,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,oBAAoB,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,cAAc,CAAC,CAAC;IAElD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAoE,CAAC;IAC1F,MAAM,gBAAgB,GAAG,KAAK,CAAC,gBAA2D,CAAC;IAE3F,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvD,MAAM,cAAc,GAA8B;QAChD,IAAI;QACJ,OAAO;KACR,CAAC;IACF,IAAI,MAAM,EAAE,wBAAwB,KAAK,SAAS,EAAE,CAAC;QACnD,cAAc,CAAC,wBAAwB,GAAG,MAAM,CAAC,wBAAwB,CAAC;IAC5E,CAAC;IACD,OAAO,yBAAyB,CAAC;QAC/B,GAAG,cAAc;KAClB,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,2CAA2C,CAC/D,MAA4D;IAE5D,OAAO,oCAAoC,CACzC,yBAA2D,EAC3D,MAAM,CACP,CAAC;AACJ,CAAC"}

package/dist/shieldedFetch.d.ts

@@ -0,0 +1,29 @@
+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>;
+    fetchImpl?: typeof fetch;
+}
+export type ShieldedFetch = (input: string | URL, init?: RequestInit) => Promise<Response>;
+export declare function createShieldedFetch(config: CreateShieldedFetchConfig): ShieldedFetch;
+//# sourceMappingURL=shieldedFetch.d.ts.map

package/dist/shieldedFetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shieldedFetch.d.ts","sourceRoot":"","sources":["../src/shieldedFetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AACnG,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,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,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;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,CAuCpF"}

package/dist/shieldedFetch.js

@@ -0,0 +1,35 @@
+const normalizeInput = (input) => {
+    if (typeof input === 'string')
+        return input;
+    return input.toString();
+};
+export function createShieldedFetch(config) {
+    const baseFetch = config.fetchImpl ?? fetch;
+    return async (input, init) => {
+        const normalizedInput = normalizeInput(input);
+        const requestInit = init ?? {};
+        const 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/shieldedFetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shieldedFetch.js","sourceRoot":"","sources":["../src/shieldedFetch.ts"],"names":[],"mappings":"AAiCA,MAAM,cAAc,GAAG,CAAC,KAAmB,EAAU,EAAE;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;AAC1B,CAAC,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,MAAiC;IACnE,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,KAAK,CAAC;IAC5C,OAAO,KAAK,EAAE,KAAmB,EAAE,IAAkB,EAAqB,EAAE;QAC1E,MAAM,eAAe,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,WAAW,GAAgB,IAAI,IAAI,EAAE,CAAC;QAE5C,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;QAC5D,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,KAAK,CAAC;QAEvC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,MAAM,CAAC,WAAW,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YAChD,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;gBAC7B,OAAO,MAAM,CAAC,iBAAiB,CAAC;oBAC9B,KAAK,EAAE,eAAe;oBACtB,IAAI,EAAE,WAAW;oBACjB,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,iBAAiB,EAAE,KAAK;iBACzB,CAAC,CAAC;YACL,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC;YAC1C,KAAK,EAAE,eAAe;YACtB,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,iBAAiB,EAAE,KAAK;SACzB,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAClC,eAAe,EACf,WAAW,EACX,MAAM,CAAC,WAAW,EAClB,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,WAAW,EACnB,SAAS,CACV,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,52 @@
+import type { Hex, PaymentRequirement, ShieldedNote, ShieldedPaymentResponse } from '@shielded-x402/shared-types';
+import type { MerkleWitness } from './merkle.js';
+export interface ProofProviderRequest {
+    note: ShieldedNote;
+    witness: MerkleWitness;
+    nullifierSecret: Hex;
+    merchantPubKey: Hex;
+    merchantRho: Hex;
+    changePkHash: Hex;
+    changeRho: Hex;
+    amount: bigint;
+    challengeNonce: Hex;
+    merchantAddress: Hex;
+    expectedPublicInputs: Hex[];
+}
+export interface ProofProviderResult {
+    proof: Hex;
+    publicInputs?: Hex[];
+}
+export interface ProofProvider {
+    generateProof: (request: ProofProviderRequest) => Promise<ProofProviderResult>;
+}
+export interface SpendBuildParams {
+    note: ShieldedNote;
+    witness: MerkleWitness;
+    nullifierSecret: Hex;
+    merchantPubKey: Hex;
+    merchantRho?: Hex;
+    merchantAddress: Hex;
+    changeRho?: Hex;
+    amount: bigint;
+    challengeNonce: Hex;
+    encryptedReceipt: Hex;
+}
+export interface SpendProofBundle {
+    response: ShieldedPaymentResponse;
+    changeNote: ShieldedNote;
+    merchantRho: Hex;
+}
+export interface ShieldedClientConfig {
+    endpoint: string;
+    signer: (message: string) => Promise<string>;
+    depositFn?: (amount: bigint, commitment: Hex) => Promise<{
+        txHash: Hex;
+        leafIndex: number;
+    }>;
+    proofProvider?: ProofProvider;
+}
+export interface Parsed402 {
+    requirement: PaymentRequirement;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,kBAAkB,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAClH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,aAAa,CAAC;IACvB,eAAe,EAAE,GAAG,CAAC;IACrB,cAAc,EAAE,GAAG,CAAC;IACpB,WAAW,EAAE,GAAG,CAAC;IACjB,YAAY,EAAE,GAAG,CAAC;IAClB,SAAS,EAAE,GAAG,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,GAAG,CAAC;IACpB,eAAe,EAAE,GAAG,CAAC;IACrB,oBAAoB,EAAE,GAAG,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,GAAG,CAAC;IACX,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAChF;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,aAAa,CAAC;IACvB,eAAe,EAAE,GAAG,CAAC;IACrB,cAAc,EAAE,GAAG,CAAC;IACpB,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,eAAe,EAAE,GAAG,CAAC;IACrB,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,GAAG,CAAC;IACpB,gBAAgB,EAAE,GAAG,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,uBAAuB,CAAC;IAClC,UAAU,EAAE,YAAY,CAAC;IACzB,WAAW,EAAE,GAAG,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,GAAG,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7F,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,kBAAkB,CAAC;CACjC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@shielded-x402/client",
+  "version": "0.1.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "viem": "^2.39.3",
+    "@shielded-x402/shared-types": "0.1.1"
+  },
+  "peerDependencies": {
+    "@aztec/bb.js": "^2.1.11",
+    "@noir-lang/noir_js": ">=1.0.0-beta.18 <2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@aztec/bb.js": {
+      "optional": true
+    },
+    "@noir-lang/noir_js": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "pretest": "pnpm --filter @shielded-x402/shared-types build && pnpm run build",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "lint": "tsc -p tsconfig.json --noEmit"
+  }
+}