zerc20-client-sdk 0.1.0

package/dist/wasm/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/wasm/artifacts.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,UAAU,CAAC;IACpB,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE,UAAU,CAAC;IACrB,QAAQ,EAAE,UAAU,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,UAAU,CAAC;IACpB,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE,UAAU,CAAC;IACrB,QAAQ,EAAE,UAAU,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,2BAA2B,CAAC;IACpC,KAAK,EAAE,0BAA0B,CAAC;CACnC;AAED,MAAM,WAAW,4BAA4B;IAC3C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,KAAK,uBAAuB,GACxB,CAAC,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAC,GACtC,CAAC,MAAM,qBAAqB,CAAC,CAAC;AAalC,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAGtF;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAED,wBAAgB,0BAA0B,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAE9D;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,qBAAqB,GAAG,IAAI,CAI7E;AAED,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,2BAA2B,GAAG,IAAI,CAEzF;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,0BAA0B,GAAG,IAAI,CAEvF;AAmBD,wBAAsB,qBAAqB,CACzC,QAAQ,GAAE,4BAAiC,GAC1C,OAAO,CAAC,qBAAqB,CAAC,CAShC;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,2BAA2B,CAAC,CAOtC;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,0BAA0B,CAAC,CAOrC"}

package/dist/wasm/artifacts.js

@@ -0,0 +1,70 @@
+let artifactLoader;
+let teleportArtifactsPromise;
+let singleArtifactsPromise;
+let batchArtifactsPromise;
+function resetCaches() {
+    teleportArtifactsPromise = undefined;
+    singleArtifactsPromise = undefined;
+    batchArtifactsPromise = undefined;
+}
+export function configureTeleportArtifactsLoader(loader) {
+    artifactLoader = loader;
+    resetCaches();
+}
+export function clearTeleportArtifactsCache() {
+    resetCaches();
+}
+export function clearTeleportArtifactCache(_url) {
+    clearTeleportArtifactsCache();
+}
+export function primeTeleportArtifacts(artifacts) {
+    teleportArtifactsPromise = Promise.resolve(artifacts);
+    singleArtifactsPromise = Promise.resolve(artifacts.single);
+    batchArtifactsPromise = Promise.resolve(artifacts.batch);
+}
+export function primeSingleTeleportArtifacts(artifacts) {
+    singleArtifactsPromise = Promise.resolve(artifacts);
+}
+export function primeBatchTeleportArtifacts(artifacts) {
+    batchArtifactsPromise = Promise.resolve(artifacts);
+}
+function requireLoader() {
+    if (!artifactLoader) {
+        throw new Error("Teleport artifact loader is not configured. Call configureTeleportArtifactsLoader() first.");
+    }
+    return artifactLoader;
+}
+async function resolveTeleportArtifacts() {
+    if (!teleportArtifactsPromise) {
+        const loader = requireLoader();
+        teleportArtifactsPromise = Promise.resolve().then(() => loader());
+    }
+    return teleportArtifactsPromise;
+}
+export async function loadTeleportArtifacts(_options = {}) {
+    const artifacts = await resolveTeleportArtifacts();
+    if (!singleArtifactsPromise) {
+        singleArtifactsPromise = Promise.resolve(artifacts.single);
+    }
+    if (!batchArtifactsPromise) {
+        batchArtifactsPromise = Promise.resolve(artifacts.batch);
+    }
+    return artifacts;
+}
+export async function loadSingleTeleportArtifacts(options = {}) {
+    if (singleArtifactsPromise) {
+        return singleArtifactsPromise;
+    }
+    const promise = loadTeleportArtifacts(options).then((artifacts) => artifacts.single);
+    singleArtifactsPromise = promise;
+    return promise;
+}
+export async function loadBatchTeleportArtifacts(options = {}) {
+    if (batchArtifactsPromise) {
+        return batchArtifactsPromise;
+    }
+    const promise = loadTeleportArtifacts(options).then((artifacts) => artifacts.batch);
+    batchArtifactsPromise = promise;
+    return promise;
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/wasm/artifacts.js.map

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

package/dist/wasm/index.d.ts

@@ -0,0 +1,69 @@
+import type { SingleWithdrawWasm, WithdrawNovaWasm } from '../assets/wasm/web/zkerc20_wasm.js';
+import { AggregationTreeState, BurnArtifacts, ChainEvents, FetchAggregationTreeStateParams, FetchLocalTeleportProofsParams, FetchTransferEventsParams, GenerateGlobalTeleportProofsParams, GlobalTeleportProofWithEvent, LocalTeleportProof, SecretAndTweak, SeparateEventsByEligibilityParams, SeparatedChainEvents } from '../types.js';
+export interface WasmLocatorGlobal {
+    location?: {
+        origin?: string;
+    };
+}
+export interface WasmRuntimeOptions {
+    /** Direct URL to the wasm bundle. */
+    url?: string;
+    /** Base URL used to resolve the wasm file; relative paths rely on window.location.origin. */
+    baseUrl?: string;
+    /** Override filename when using a custom base. */
+    wasmFilename?: string;
+    /** Custom global object used when resolving relative base URLs (defaults to globalThis). */
+    globalObject?: WasmLocatorGlobal;
+}
+export declare class WasmRuntime {
+    private locator;
+    private overrideUrl?;
+    private initPromise?;
+    private wasmBindings?;
+    constructor(options?: WasmRuntimeOptions);
+    configure(options: WasmRuntimeOptions): void;
+    setOverrideUrl(url?: string): void;
+    ready(): Promise<void>;
+    getSeedMessage(): Promise<string>;
+    derivePaymentAdvice(seedHex: string, paymentAdviceIdHex: string, recipientChainId: bigint | number, recipientAddress: string): Promise<SecretAndTweak>;
+    deriveInvoiceSingle(seedHex: string, invoiceIdHex: string, recipientChainId: bigint | number, recipientAddress: string): Promise<SecretAndTweak>;
+    deriveInvoiceBatch(seedHex: string, invoiceIdHex: string, subId: number, recipientChainId: bigint | number, recipientAddress: string): Promise<SecretAndTweak>;
+    buildFullBurnAddress(recipientChainId: bigint | number, recipientAddress: string, secretHex: string, tweakHex: string): Promise<BurnArtifacts>;
+    decodeFullBurnAddress(payloadHex: string): Promise<BurnArtifacts>;
+    generalRecipientFr(chainId: bigint | number, recipientAddress: string, tweakHex: string): Promise<string>;
+    aggregationRoot(snapshot: readonly string[]): Promise<string>;
+    aggregationMerkleProof(snapshot: readonly string[], index: number): Promise<string[]>;
+    fetchAggregationTreeState(params: FetchAggregationTreeStateParams): Promise<AggregationTreeState>;
+    fetchTransferEvents(params: FetchTransferEventsParams): Promise<ChainEvents[]>;
+    separateEventsByEligibility(params: SeparateEventsByEligibilityParams): Promise<SeparatedChainEvents[]>;
+    fetchLocalTeleportMerkleProofs(params: FetchLocalTeleportProofsParams): Promise<LocalTeleportProof[]>;
+    generateGlobalTeleportMerkleProofs(params: GenerateGlobalTeleportProofsParams): Promise<GlobalTeleportProofWithEvent[]>;
+    createSingleWithdrawProgram(localPk: Uint8Array, localVk: Uint8Array, globalPk: Uint8Array, globalVk: Uint8Array): Promise<SingleWithdrawWasm>;
+    createWithdrawNovaProgram(localPp: Uint8Array, localVp: Uint8Array, globalPp: Uint8Array, globalVp: Uint8Array): Promise<WithdrawNovaWasm>;
+    private ensureReady;
+    private readyBindings;
+    private getBindings;
+    private initialize;
+    private resolveCandidateUrls;
+    private resolveConfiguredUrl;
+}
+export declare function getDefaultWasmRuntime(): WasmRuntime;
+export declare function configureWasmLocator(options?: WasmRuntimeOptions): void;
+export declare function getSeedMessage(): Promise<string>;
+export declare function derivePaymentAdvice(seedHex: string, paymentAdviceIdHex: string, recipientChainId: bigint | number, recipientAddress: string): Promise<SecretAndTweak>;
+export declare function deriveInvoiceSingle(seedHex: string, invoiceIdHex: string, recipientChainId: bigint | number, recipientAddress: string): Promise<SecretAndTweak>;
+export declare function deriveInvoiceBatch(seedHex: string, invoiceIdHex: string, subId: number, recipientChainId: bigint | number, recipientAddress: string): Promise<SecretAndTweak>;
+export declare function buildFullBurnAddress(recipientChainId: bigint | number, recipientAddress: string, secretHex: string, tweakHex: string): Promise<BurnArtifacts>;
+export declare function decodeFullBurnAddress(payloadHex: string): Promise<BurnArtifacts>;
+export declare function generalRecipientFr(chainId: bigint | number, recipientAddress: string, tweakHex: string): Promise<string>;
+export declare function aggregationRoot(snapshot: readonly string[]): Promise<string>;
+export declare function aggregationMerkleProof(snapshot: readonly string[], index: number): Promise<string[]>;
+export declare function fetchAggregationTreeState(params: FetchAggregationTreeStateParams): Promise<AggregationTreeState>;
+export declare function fetchTransferEvents(params: FetchTransferEventsParams): Promise<ChainEvents[]>;
+export declare function separateEventsByEligibility(params: SeparateEventsByEligibilityParams): Promise<SeparatedChainEvents[]>;
+export declare function fetchLocalTeleportMerkleProofs(params: FetchLocalTeleportProofsParams): Promise<LocalTeleportProof[]>;
+export declare function generateGlobalTeleportMerkleProofs(params: GenerateGlobalTeleportProofsParams): Promise<GlobalTeleportProofWithEvent[]>;
+export declare function createSingleWithdrawWasm(localPk: Uint8Array, localVk: Uint8Array, globalPk: Uint8Array, globalVk: Uint8Array): Promise<SingleWithdrawWasm>;
+export declare function createWithdrawNovaWasm(localPp: Uint8Array, localVp: Uint8Array, globalPp: Uint8Array, globalVp: Uint8Array): Promise<WithdrawNovaWasm>;
+export type { SingleWithdrawWasm, WithdrawNovaWasm };
+//# sourceMappingURL=index.d.ts.map

package/dist/wasm/index.d.ts.map

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

package/dist/wasm/index.js

@@ -0,0 +1,504 @@
+import { normalizeHex, toBigInt } from '../utils/hex.js';
+import { NUM_BATCH_INVOICES } from '../constants.js';
+const DEFAULT_WASM_FILENAME = 'assets/wasm/web/zkerc20_wasm_bg.wasm';
+const BUNDLED_WASM_URL = new URL('../assets/wasm/web/zkerc20_wasm_bg.wasm', import.meta.url).toString();
+let bindingsCache;
+let bindingsPromise;
+function isNodeRuntime() {
+    return typeof process !== 'undefined' && typeof process.versions?.node === 'string';
+}
+async function getOrLoadBindings() {
+    if (bindingsCache) {
+        return bindingsCache;
+    }
+    if (!bindingsPromise) {
+        bindingsPromise = resolveBindings();
+    }
+    bindingsCache = await bindingsPromise;
+    return bindingsCache;
+}
+async function resolveBindings() {
+    if (isNodeRuntime()) {
+        return loadNodeBindings();
+    }
+    return import('../assets/wasm/web/zkerc20_wasm.js');
+}
+async function loadNodeBindings() {
+    const { createRequire } = await loadNodeModule();
+    const require = createRequire(import.meta.url);
+    return require('../assets/wasm/node/zkerc20_wasm.js');
+}
+async function loadNodeModule() {
+    const specifiers = ['node:module', 'module'];
+    let lastError;
+    for (const specifier of specifiers) {
+        try {
+            const mod = (await import(specifier));
+            return mod;
+        }
+        catch (error) {
+            lastError = error;
+        }
+    }
+    throw lastError ?? new Error('failed to load node:module for wasm bindings');
+}
+function requiresExplicitInit(bindings) {
+    return typeof bindings.default === 'function';
+}
+export class WasmRuntime {
+    locator;
+    overrideUrl;
+    initPromise;
+    wasmBindings;
+    constructor(options = {}) {
+        this.locator = { ...options };
+        this.overrideUrl = normalizeOverride(options.url);
+    }
+    configure(options) {
+        this.locator = { ...options };
+        this.overrideUrl = normalizeOverride(options.url);
+        this.initPromise = undefined;
+    }
+    setOverrideUrl(url) {
+        this.overrideUrl = normalizeOverride(url);
+        this.initPromise = undefined;
+    }
+    async ready() {
+        await this.ensureReady();
+    }
+    async getSeedMessage() {
+        const wasm = await this.readyBindings();
+        return wasm.seed_message();
+    }
+    async derivePaymentAdvice(seedHex, paymentAdviceIdHex, recipientChainId, recipientAddress) {
+        const wasm = await this.readyBindings();
+        return asSecretAndTweak(wasm.derive_payment_advice(normalizeHex(seedHex), normalizeHex(paymentAdviceIdHex), toBigInt(recipientChainId), normalizeHex(recipientAddress)));
+    }
+    async deriveInvoiceSingle(seedHex, invoiceIdHex, recipientChainId, recipientAddress) {
+        const wasm = await this.readyBindings();
+        return asSecretAndTweak(wasm.derive_invoice_single(normalizeHex(seedHex), normalizeHex(invoiceIdHex), toBigInt(recipientChainId), normalizeHex(recipientAddress)));
+    }
+    async deriveInvoiceBatch(seedHex, invoiceIdHex, subId, recipientChainId, recipientAddress) {
+        assertValidInvoiceSubId(subId);
+        const wasm = await this.readyBindings();
+        return asSecretAndTweak(wasm.derive_invoice_batch(normalizeHex(seedHex), normalizeHex(invoiceIdHex), subId, toBigInt(recipientChainId), normalizeHex(recipientAddress)));
+    }
+    async buildFullBurnAddress(recipientChainId, recipientAddress, secretHex, tweakHex) {
+        const wasm = await this.readyBindings();
+        const result = wasm.build_full_burn_address(toBigInt(recipientChainId), normalizeHex(recipientAddress), normalizeHex(secretHex), normalizeHex(tweakHex));
+        return asBurnArtifacts(result);
+    }
+    async decodeFullBurnAddress(payloadHex) {
+        const wasm = await this.readyBindings();
+        return asBurnArtifacts(wasm.decode_full_burn_address(normalizeHex(payloadHex)));
+    }
+    async generalRecipientFr(chainId, recipientAddress, tweakHex) {
+        const wasm = await this.readyBindings();
+        return normalizeHex(wasm.general_recipient_fr(toBigInt(chainId), normalizeHex(recipientAddress), normalizeHex(tweakHex)));
+    }
+    async aggregationRoot(snapshot) {
+        const wasm = await this.readyBindings();
+        return normalizeHex(wasm.aggregation_root(snapshot.slice()));
+    }
+    async aggregationMerkleProof(snapshot, index) {
+        const wasm = await this.readyBindings();
+        const siblings = wasm.aggregation_merkle_proof(snapshot.slice(), index);
+        return siblings.map((value) => normalizeHex(value));
+    }
+    async fetchAggregationTreeState(params) {
+        const payload = {
+            hub: serializeHubEntry(params.hub),
+            token: serializeTokenEntry(params.token),
+        };
+        if (params.eventBlockSpan !== undefined) {
+            payload.eventBlockSpan = toSafeNumber(params.eventBlockSpan, 'eventBlockSpan');
+        }
+        const wasm = await this.readyBindings();
+        const rawState = await wasm.fetch_aggregation_tree_state(payload);
+        return deserializeAggregationTreeState(rawState);
+    }
+    async fetchTransferEvents(params) {
+        const payload = {
+            indexerUrl: params.indexerUrl,
+            indexerFetchLimit: params.indexerFetchLimit,
+            tokens: params.tokens.map(serializeTokenEntry),
+            burnAddresses: params.burnAddresses.map((address) => normalizeHex(address)),
+        };
+        const wasm = await this.readyBindings();
+        const rawEvents = await wasm.fetch_transfer_events(payload);
+        return rawEvents.map((entry) => deserializeChainEvents(entry));
+    }
+    async separateEventsByEligibility(params) {
+        const payload = {
+            aggregationState: serializeAggregationTreeState(params.aggregationState),
+            events: params.events.map(serializeChainEvents),
+        };
+        const wasm = await this.readyBindings();
+        const rawSeparated = wasm.separate_events_by_eligibility(payload);
+        return rawSeparated.map((entry) => deserializeSeparatedChainEvents(entry));
+    }
+    async fetchLocalTeleportMerkleProofs(params) {
+        const payload = {
+            indexerUrl: params.indexerUrl,
+            token: serializeTokenEntry(params.token),
+            treeIndex: toBigInt(params.treeIndex),
+            events: params.events.map(serializeIndexedEvent),
+        };
+        const wasm = await this.readyBindings();
+        const rawProofs = await wasm.fetch_local_teleport_merkle_proofs(payload);
+        return rawProofs.map((proof) => deserializeLocalTeleportProof(proof));
+    }
+    async generateGlobalTeleportMerkleProofs(params) {
+        const payload = {
+            aggregationState: serializeAggregationTreeState(params.aggregationState),
+            proofs: params.chains.map(serializeChainLocalTeleportProofs),
+        };
+        const wasm = await this.readyBindings();
+        const rawProofs = wasm.generate_global_teleport_merkle_proofs(payload);
+        return rawProofs.map((proof) => deserializeGlobalTeleportProof(proof));
+    }
+    async createSingleWithdrawProgram(localPk, localVk, globalPk, globalVk) {
+        const wasm = await this.readyBindings();
+        return new wasm.SingleWithdrawWasm(localPk, localVk, globalPk, globalVk);
+    }
+    async createWithdrawNovaProgram(localPp, localVp, globalPp, globalVp) {
+        const wasm = await this.readyBindings();
+        return new wasm.WithdrawNovaWasm(localPp, localVp, globalPp, globalVp);
+    }
+    async ensureReady() {
+        if (!this.initPromise) {
+            this.initPromise = this.initialize();
+        }
+        await this.initPromise;
+    }
+    async readyBindings() {
+        await this.ensureReady();
+        return this.getBindings();
+    }
+    getBindings() {
+        if (!this.wasmBindings) {
+            throw new Error('zkERC20 wasm bindings are not initialized');
+        }
+        return this.wasmBindings;
+    }
+    async initialize() {
+        const bindings = await getOrLoadBindings();
+        if (!requiresExplicitInit(bindings)) {
+            this.wasmBindings = bindings;
+            return;
+        }
+        const candidates = this.resolveCandidateUrls();
+        let lastError;
+        for (let idx = 0; idx < candidates.length; idx++) {
+            const candidate = candidates[idx];
+            try {
+                await bindings.default({ module_or_path: candidate });
+                this.wasmBindings = bindings;
+                return;
+            }
+            catch (error) {
+                lastError = error;
+                if (idx < candidates.length - 1) {
+                    logWasmFallbackWarning(candidate, error);
+                }
+            }
+        }
+        throw new Error(`failed to initialize zkERC20 wasm: ${formatError(lastError)}`);
+    }
+    resolveCandidateUrls() {
+        const urls = [];
+        if (this.overrideUrl) {
+            urls.push(this.overrideUrl);
+        }
+        const configured = this.resolveConfiguredUrl();
+        if (configured && configured !== this.overrideUrl) {
+            urls.push(configured);
+        }
+        if (!urls.includes(BUNDLED_WASM_URL)) {
+            urls.push(BUNDLED_WASM_URL);
+        }
+        return urls;
+    }
+    resolveConfiguredUrl() {
+        const baseUrl = this.locator.baseUrl;
+        if (!baseUrl) {
+            return undefined;
+        }
+        const wasmFilename = this.locator.wasmFilename ?? DEFAULT_WASM_FILENAME;
+        if (/^https?:\/\//i.test(baseUrl)) {
+            return new URL(wasmFilename, ensureTrailingSlash(baseUrl)).toString();
+        }
+        const globalRef = this.locator.globalObject ?? (typeof globalThis !== 'undefined' ? globalThis : undefined);
+        const origin = globalRef?.location?.origin;
+        if (!origin) {
+            throw new Error('WasmRuntime requires a global location.origin when baseUrl is relative');
+        }
+        const prefix = baseUrl.startsWith('/') ? `${origin}${baseUrl}` : `${origin}/${baseUrl}`;
+        return new URL(wasmFilename, ensureTrailingSlash(prefix)).toString();
+    }
+}
+const defaultRuntime = new WasmRuntime();
+function runtime() {
+    return defaultRuntime;
+}
+export function getDefaultWasmRuntime() {
+    return runtime();
+}
+export function configureWasmLocator(options = {}) {
+    runtime().configure(options);
+}
+export async function getSeedMessage() {
+    return runtime().getSeedMessage();
+}
+export async function derivePaymentAdvice(seedHex, paymentAdviceIdHex, recipientChainId, recipientAddress) {
+    return runtime().derivePaymentAdvice(seedHex, paymentAdviceIdHex, recipientChainId, recipientAddress);
+}
+export async function deriveInvoiceSingle(seedHex, invoiceIdHex, recipientChainId, recipientAddress) {
+    return runtime().deriveInvoiceSingle(seedHex, invoiceIdHex, recipientChainId, recipientAddress);
+}
+export async function deriveInvoiceBatch(seedHex, invoiceIdHex, subId, recipientChainId, recipientAddress) {
+    return runtime().deriveInvoiceBatch(seedHex, invoiceIdHex, subId, recipientChainId, recipientAddress);
+}
+export async function buildFullBurnAddress(recipientChainId, recipientAddress, secretHex, tweakHex) {
+    return runtime().buildFullBurnAddress(recipientChainId, recipientAddress, secretHex, tweakHex);
+}
+export async function decodeFullBurnAddress(payloadHex) {
+    return runtime().decodeFullBurnAddress(payloadHex);
+}
+export async function generalRecipientFr(chainId, recipientAddress, tweakHex) {
+    return runtime().generalRecipientFr(chainId, recipientAddress, tweakHex);
+}
+export async function aggregationRoot(snapshot) {
+    return runtime().aggregationRoot(snapshot);
+}
+export async function aggregationMerkleProof(snapshot, index) {
+    return runtime().aggregationMerkleProof(snapshot, index);
+}
+export async function fetchAggregationTreeState(params) {
+    return runtime().fetchAggregationTreeState(params);
+}
+export async function fetchTransferEvents(params) {
+    return runtime().fetchTransferEvents(params);
+}
+export async function separateEventsByEligibility(params) {
+    return runtime().separateEventsByEligibility(params);
+}
+export async function fetchLocalTeleportMerkleProofs(params) {
+    return runtime().fetchLocalTeleportMerkleProofs(params);
+}
+export async function generateGlobalTeleportMerkleProofs(params) {
+    return runtime().generateGlobalTeleportMerkleProofs(params);
+}
+export async function createSingleWithdrawWasm(localPk, localVk, globalPk, globalVk) {
+    return runtime().createSingleWithdrawProgram(localPk, localVk, globalPk, globalVk);
+}
+export async function createWithdrawNovaWasm(localPp, localVp, globalPp, globalVp) {
+    return runtime().createWithdrawNovaProgram(localPp, localVp, globalPp, globalVp);
+}
+function normalizeOverride(url) {
+    if (!url) {
+        return undefined;
+    }
+    const trimmed = url.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function ensureTrailingSlash(value) {
+    return value.endsWith('/') ? value : `${value}/`;
+}
+function logWasmFallbackWarning(url, error) {
+    if (typeof console === 'undefined' || typeof console.warn !== 'function') {
+        return;
+    }
+    console.warn(`zkERC20 wasm failed to load from '${url}'. Falling back to the next candidate.`, error);
+}
+function formatError(error) {
+    if (!error) {
+        return 'unknown error';
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+function asSecretAndTweak(value) {
+    const candidate = value;
+    if (!candidate || typeof candidate.secret !== 'string' || typeof candidate.tweak !== 'string') {
+        throw new Error('unexpected secret/tweak payload from wasm');
+    }
+    return {
+        secret: normalizeHex(candidate.secret),
+        tweak: normalizeHex(candidate.tweak),
+    };
+}
+function asBurnArtifacts(value) {
+    const raw = value;
+    if (!raw || typeof raw.burnAddress !== 'string' || typeof raw.secret !== 'string') {
+        throw new Error('unexpected burn artifacts payload from wasm');
+    }
+    const recipient = raw.generalRecipient;
+    if (!recipient || typeof recipient.address !== 'string') {
+        throw new Error('missing general recipient payload from wasm');
+    }
+    const tweakSource = raw.tweak ?? recipient.tweak;
+    if (typeof tweakSource !== 'string') {
+        throw new Error('missing burn tweak payload from wasm');
+    }
+    return {
+        burnAddress: normalizeHex(raw.burnAddress),
+        fullBurnAddress: normalizeHex(raw.fullBurnAddress),
+        secret: normalizeHex(raw.secret),
+        tweak: normalizeHex(tweakSource),
+        generalRecipient: {
+            chainId: toBigInt(recipient.chainId ?? 0),
+            address: normalizeHex(recipient.address),
+            tweak: normalizeHex(recipient.tweak),
+            fr: normalizeHex(recipient.fr),
+            u256: normalizeHex(recipient.u256),
+        },
+    };
+}
+function copyRpcUrls(urls, label) {
+    if (!Array.isArray(urls) || urls.length === 0) {
+        throw new Error(`${label} must provide at least one RPC URL`);
+    }
+    return urls.map((url, idx) => {
+        if (typeof url !== 'string' || url.trim().length === 0) {
+            throw new Error(`${label} RPC URL at index ${idx} must be a non-empty string`);
+        }
+        return url.trim();
+    });
+}
+function serializeHubEntry(entry) {
+    return {
+        hub_address: normalizeHex(entry.hubAddress),
+        chain_id: entry.chainId,
+        rpc_urls: copyRpcUrls(entry.rpcUrls, 'hub.rpcUrls'),
+    };
+}
+function serializeTokenEntry(entry) {
+    return {
+        label: entry.label,
+        token_address: normalizeHex(entry.tokenAddress),
+        verifier_address: normalizeHex(entry.verifierAddress),
+        minter_address: entry.minterAddress ? normalizeHex(entry.minterAddress) : undefined,
+        chain_id: entry.chainId,
+        deployed_block_number: entry.deployedBlockNumber,
+        rpc_urls: copyRpcUrls(entry.rpcUrls, `${entry.label}.rpcUrls`),
+        legacy_tx: entry.legacyTx ?? false,
+    };
+}
+function serializeAggregationTreeState(state) {
+    return {
+        latestAggSeq: state.latestAggSeq,
+        aggregationRoot: normalizeHex(state.aggregationRoot),
+        snapshot: state.snapshot.map((value) => normalizeHex(value)),
+        transferTreeIndices: state.transferTreeIndices.map((value) => value),
+        chainIds: state.chainIds.map((value) => value),
+    };
+}
+function deserializeAggregationTreeState(raw) {
+    return {
+        latestAggSeq: toBigInt(raw.latestAggSeq),
+        aggregationRoot: normalizeHex(raw.aggregationRoot),
+        snapshot: raw.snapshot.map((value) => normalizeHex(value)),
+        transferTreeIndices: raw.transferTreeIndices.map((value) => toBigInt(value)),
+        chainIds: raw.chainIds.map((value) => toBigInt(value)),
+    };
+}
+function serializeIndexedEvent(event) {
+    return {
+        event_index: event.eventIndex,
+        from: normalizeHex(event.from),
+        to: normalizeHex(event.to),
+        value: normalizeHex(event.value),
+        eth_block_number: event.ethBlockNumber,
+    };
+}
+function deserializeIndexedEvent(raw) {
+    return {
+        eventIndex: toBigInt(raw.event_index),
+        from: normalizeHex(raw.from),
+        to: normalizeHex(raw.to),
+        value: toBigInt(raw.value),
+        ethBlockNumber: toBigInt(raw.eth_block_number),
+    };
+}
+function serializeChainEvents(entry) {
+    return {
+        chainId: entry.chainId,
+        events: entry.events.map(serializeIndexedEvent),
+    };
+}
+function deserializeChainEvents(raw) {
+    return {
+        chainId: toBigInt(raw.chainId),
+        events: raw.events.map(deserializeIndexedEvent),
+    };
+}
+function deserializeEventsWithEligibility(raw) {
+    return {
+        eligible: raw.eligible.map(deserializeIndexedEvent),
+        ineligible: raw.ineligible.map(deserializeIndexedEvent),
+    };
+}
+function deserializeSeparatedChainEvents(raw) {
+    return {
+        chainId: toBigInt(raw.chainId),
+        events: deserializeEventsWithEligibility(raw.events),
+    };
+}
+function serializeLocalTeleportProof(proof) {
+    return {
+        treeIndex: proof.treeIndex,
+        event: serializeIndexedEvent(proof.event),
+        siblings: proof.siblings.map((value) => normalizeHex(value)),
+    };
+}
+function deserializeLocalTeleportProof(raw) {
+    return {
+        treeIndex: toBigInt(raw.treeIndex),
+        event: deserializeIndexedEvent(raw.event),
+        siblings: raw.siblings.map((value) => normalizeHex(value)),
+    };
+}
+function serializeChainLocalTeleportProofs(entry) {
+    return {
+        chainId: entry.chainId,
+        proofs: entry.proofs.map(serializeLocalTeleportProof),
+    };
+}
+function deserializeGlobalTeleportProof(raw) {
+    return {
+        event: deserializeIndexedEvent(raw.event),
+        siblings: raw.siblings.map((value) => normalizeHex(value)),
+        leafIndex: toBigInt(raw.leafIndex),
+    };
+}
+function assertValidInvoiceSubId(subId) {
+    if (!Number.isFinite(subId) || !Number.isInteger(subId)) {
+        throw new Error('subId must be a finite integer');
+    }
+    if (subId < 0 || subId >= NUM_BATCH_INVOICES) {
+        throw new Error(`subId must be between 0 and ${NUM_BATCH_INVOICES - 1}`);
+    }
+}
+function toSafeNumber(value, label) {
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value) || !Number.isInteger(value)) {
+            throw new Error(`${label} must be a finite integer`);
+        }
+        if (value < 0) {
+            throw new Error(`${label} must be non-negative`);
+        }
+        return value;
+    }
+    if (value < 0n) {
+        throw new Error(`${label} must be non-negative`);
+    }
+    const asNumber = Number(value);
+    if (!Number.isFinite(asNumber) || BigInt(asNumber) !== value) {
+        throw new Error(`${label} exceeds JavaScript safe integer range`);
+    }
+    return asNumber;
+}
+//# sourceMappingURL=index.js.map