veilix-sdk 0.0.9 → 0.2.0

package/dist/vite/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/circuits/constants.ts","../../src/vite/copyCircuitsPlugin.ts"],"names":["dirname","fileURLToPath","join","mkdirSync","existsSync","cpSync"],"mappings":";;;;;;;;AASO,IAAM,qBAAA,GAAwB,eAAA;AAC9B,IAAM,qBAAA,GAAwB,eAAA;;;ACDrC,IAAM,SAAA,GAAYA,YAAA,CAAQC,iBAAA,CAAc,2PAAe,CAAC,CAAA;AACxD,IAAM,WAAA,GAAcC,SAAA,CAAK,SAAA,EAAW,IAAA,EAAM,UAAU,CAAA;AA6B7C,SAAS,oBAAA,CACd,OAAA,GAAuC,EAAC,EAC5B;AACZ,EAAA,MAAM,OAAA,GAAU,QAAQ,IAAA,IAAQ,UAAA;AAEhC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,iBAAA;AAAA,IACN,KAAA,EAAO,OAAA;AAAA,IACP,UAAA,GAAa;AACX,MAAA,MAAM,SAASA,SAAA,CAAK,OAAA,CAAQ,GAAA,EAAI,EAAG,UAAU,OAAO,CAAA;AACpD,MAAAC,YAAA,CAAU,MAAA,EAAQ,EAAE,SAAA,EAAW,IAAA,EAAM,CAAA;AAErC,MAAA,KAAA,MAAW,IAAA,IAAQ,CAAC,qBAAA,EAAuB,qBAAqB,CAAA,EAAG;AACjE,QAAA,MAAM,IAAA,GAAOD,SAAA,CAAK,WAAA,EAAa,IAAI,CAAA;AACnC,QAAA,IAAI,CAACE,aAAA,CAAW,IAAI,CAAA,EAAG;AACrB,UAAA,IAAA,CAAK,KAAA,CAAM,CAAA,0BAAA,EAA6B,IAAI,CAAA,CAAE,CAAA;AAC9C,UAAA;AAAA,QACF;AACA,QAAAC,SAAA,CAAO,IAAA,EAAMH,SAAA,CAAK,MAAA,EAAQ,IAAI,CAAC,CAAA;AAAA,MACjC;AAEA,MAAA,IAAA,CAAK,IAAA,CAAK,CAAA,mCAAA,EAAsC,OAAO,CAAA,CAAA,CAAG,CAAA;AAAA,IAC5D;AAAA,GACF;AACF","file":"index.cjs","sourcesContent":["import packageJson from \"../../package.json\";\n\n/** npm package name (used to load the standalone circuits module). */\nexport const PACKAGE_NAME = packageJson.name;\n\n/** Published npm version (pins CDN circuit URLs in production). */\nexport const PACKAGE_VERSION = packageJson.version;\n\n/** Withdraw circuit artifact filenames (published under `veilix-sdk/circuits/`). */\nexport const WITHDRAW_CIRCUIT_WASM = \"withdraw.wasm\";\nexport const WITHDRAW_CIRCUIT_ZKEY = \"withdraw.zkey\";\n/**\n * Pinned SHA-256 hashes for the published withdraw circuit artifacts.\n * These are verified in-browser before passing artifacts to snarkjs.\n */\nexport const WITHDRAW_CIRCUIT_SHA256 = {\n  wasm: \"68b712068a25e5b027a755ec96c35f176dfdc988f437b98587d572d6f3a26c03\",\n  zkey: \"fd177812fb178896c08de7efd7bcc9e6b17d5ac1e5de512459ba0a9a92161a5e\",\n} as const;\n\n/** Optional self-hosted path convention (opt-in via `circuitPathsBase`). */\nexport const SELF_HOSTED_CIRCUIT_BASE = \"/circuits/\";\n\n/**\n * Stable published source for the pinned circuit artifacts.\n *\n * Decoupled from {@link PACKAGE_VERSION} on purpose: the withdraw circuit is a\n * fixed cryptographic artifact, so SDK code releases must not change where the\n * verified circuits are fetched from. Bump these together with\n * {@link WITHDRAW_CIRCUIT_SHA256} only when the circuit itself changes.\n */\nexport const CIRCUIT_CDN_PACKAGE = \"veilix-sdk\";\nexport const CIRCUIT_CDN_VERSION = \"0.0.4\";\n\nexport type CircuitPaths = {\n  wasm: string;\n  zkey: string;\n};\n\n/** Resolve circuit URLs when the caller knows the package `dist/` root. */\nexport function resolveCircuitPathsFromBase(base: string): CircuitPaths {\n  const root = base.endsWith(\"/\") ? base : `${base}/`;\n  return {\n    wasm: `${root}circuits/${WITHDRAW_CIRCUIT_WASM}`,\n    zkey: `${root}circuits/${WITHDRAW_CIRCUIT_ZKEY}`,\n  };\n}\n\n/**\n * Base URL for circuit files on jsDelivr.\n *\n * Pinned to {@link CIRCUIT_CDN_PACKAGE}@{@link CIRCUIT_CDN_VERSION} (not the\n * current SDK version) so the bytes always match {@link WITHDRAW_CIRCUIT_SHA256}.\n * This URL is independent of the consuming app's origin/domain.\n */\nexport function resolveNpmCdnCircuitBase(): string {\n  return `https://cdn.jsdelivr.net/npm/${CIRCUIT_CDN_PACKAGE}@${CIRCUIT_CDN_VERSION}/dist/circuits/`;\n}\n\n/** Trusted jsDelivr fallback paths for pinned withdraw circuit artifacts. */\nexport function resolveNpmCdnCircuitPaths(): CircuitPaths {\n  const base = resolveNpmCdnCircuitBase();\n  return {\n    wasm: `${base}${WITHDRAW_CIRCUIT_WASM}`,\n    zkey: `${base}${WITHDRAW_CIRCUIT_ZKEY}`,\n  };\n}\n\nfunction isLocalDevHost(hostname: string): boolean {\n  return (\n    hostname === \"localhost\" ||\n    hostname === \"127.0.0.1\" ||\n    hostname === \"[::1]\"\n  );\n}\n\n/**\n * Browser circuit URLs.\n *\n * - Local dev (Vite): `/node_modules/<pkg>/dist/circuits/` — Vite serves node_modules.\n * - Production: pinned, domain-independent jsDelivr CDN (verified by SHA-256 before use).\n *\n * The production default does not depend on the app's own origin/domain, so it\n * works on any deployed host with no copy step. Artifacts are always integrity\n * checked before proving (see {@link WITHDRAW_CIRCUIT_SHA256}). To self-host\n * instead, pass {@link VeilixSdkInitOptions.circuitPathsBase} (e.g. `\"/circuits/\"`);\n * it is verified too and falls back to the CDN if unavailable.\n */\nexport function resolveBrowserCircuitPaths(\n  baseOverride?: string\n): CircuitPaths | null {\n  if (typeof window === \"undefined\") {\n    return null;\n  }\n\n  if (baseOverride !== undefined) {\n    return resolveCircuitPathsFromBase(baseOverride);\n  }\n\n  if (isLocalDevHost(window.location.hostname)) {\n    const base = `/node_modules/${PACKAGE_NAME}/dist/circuits/`;\n    return {\n      wasm: `${base}${WITHDRAW_CIRCUIT_WASM}`,\n      zkey: `${base}${WITHDRAW_CIRCUIT_ZKEY}`,\n    };\n  }\n\n  return resolveNpmCdnCircuitPaths();\n}\n","import { cpSync, existsSync, mkdirSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport {\n  WITHDRAW_CIRCUIT_WASM,\n  WITHDRAW_CIRCUIT_ZKEY,\n} from \"../circuits/constants\";\n\nconst pluginDir = dirname(fileURLToPath(import.meta.url));\nconst circuitsSrc = join(pluginDir, \"..\", \"circuits\");\n\nexport type VeilixCircuitsPluginOptions = {\n  /** Directory under `public/` (default: `\"circuits\"`). */\n  dest?: string;\n};\n\ntype VitePlugin = {\n  name: string;\n  apply?: \"build\" | \"serve\";\n  buildStart?: (this: {\n    error: (msg: string) => void;\n    info: (msg: string) => void;\n  }) => void;\n};\n\n/**\n * Vite plugin: copies withdraw.wasm and withdraw.zkey into `public/circuits/`\n * before production build so browser proof generation works on static hosts (Vercel, etc.).\n *\n * @example\n * ```ts\n * import { veilixCircuitsPlugin } from \"veilix-sdk/vite\";\n *\n * export default defineConfig({\n *   plugins: [react(), veilixCircuitsPlugin()],\n * });\n * ```\n */\nexport function veilixCircuitsPlugin(\n  options: VeilixCircuitsPluginOptions = {}\n): VitePlugin {\n  const destDir = options.dest ?? \"circuits\";\n\n  return {\n    name: \"veilix-circuits\",\n    apply: \"build\",\n    buildStart() {\n      const target = join(process.cwd(), \"public\", destDir);\n      mkdirSync(target, { recursive: true });\n\n      for (const file of [WITHDRAW_CIRCUIT_WASM, WITHDRAW_CIRCUIT_ZKEY]) {\n        const from = join(circuitsSrc, file);\n        if (!existsSync(from)) {\n          this.error(`Missing circuit artifact: ${from}`);\n          return;\n        }\n        cpSync(from, join(target, file));\n      }\n\n      this.info(`Copied withdraw circuits to public/${destDir}/`);\n    },\n  };\n}\n"]}
+{"version":3,"sources":["../../src/circuits/constants.ts","../../src/vite/copyCircuitsPlugin.ts"],"names":["dirname","fileURLToPath","join","mkdirSync","existsSync","cpSync"],"mappings":";;;;;;;;AASO,IAAM,qBAAA,GAAwB,eAAA;AAC9B,IAAM,qBAAA,GAAwB,eAAA;;;ACDrC,IAAM,SAAA,GAAYA,YAAA,CAAQC,iBAAA,CAAc,2PAAe,CAAC,CAAA;AACxD,IAAM,WAAA,GAAcC,SAAA,CAAK,SAAA,EAAW,IAAA,EAAM,UAAU,CAAA;AA6B7C,SAAS,oBAAA,CACd,OAAA,GAAuC,EAAC,EAC5B;AACZ,EAAA,MAAM,OAAA,GAAU,QAAQ,IAAA,IAAQ,UAAA;AAEhC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,iBAAA;AAAA,IACN,KAAA,EAAO,OAAA;AAAA,IACP,UAAA,GAAa;AACX,MAAA,MAAM,SAASA,SAAA,CAAK,OAAA,CAAQ,GAAA,EAAI,EAAG,UAAU,OAAO,CAAA;AACpD,MAAAC,YAAA,CAAU,MAAA,EAAQ,EAAE,SAAA,EAAW,IAAA,EAAM,CAAA;AAErC,MAAA,KAAA,MAAW,IAAA,IAAQ,CAAC,qBAAA,EAAuB,qBAAqB,CAAA,EAAG;AACjE,QAAA,MAAM,IAAA,GAAOD,SAAA,CAAK,WAAA,EAAa,IAAI,CAAA;AACnC,QAAA,IAAI,CAACE,aAAA,CAAW,IAAI,CAAA,EAAG;AACrB,UAAA,IAAA,CAAK,KAAA,CAAM,CAAA,0BAAA,EAA6B,IAAI,CAAA,CAAE,CAAA;AAC9C,UAAA;AAAA,QACF;AACA,QAAAC,SAAA,CAAO,IAAA,EAAMH,SAAA,CAAK,MAAA,EAAQ,IAAI,CAAC,CAAA;AAAA,MACjC;AAEA,MAAA,IAAA,CAAK,IAAA,CAAK,CAAA,mCAAA,EAAsC,OAAO,CAAA,CAAA,CAAG,CAAA;AAAA,IAC5D;AAAA,GACF;AACF","file":"index.cjs","sourcesContent":["import packageJson from \"../../package.json\";\n\n/** npm package name (used to load the standalone circuits module). */\nexport const PACKAGE_NAME = packageJson.name;\n\n/** Published npm version (pins CDN circuit URLs in production). */\nexport const PACKAGE_VERSION = packageJson.version;\n\n/** Withdraw circuit artifact filenames (published under `veilix-sdk/circuits/`). */\nexport const WITHDRAW_CIRCUIT_WASM = \"withdraw.wasm\";\nexport const WITHDRAW_CIRCUIT_ZKEY = \"withdraw.zkey\";\n/**\n * Pinned SHA-256 hashes for the published withdraw circuit artifacts.\n * These are verified in-browser before passing artifacts to snarkjs.\n */\nexport const WITHDRAW_CIRCUIT_SHA256 = {\n  wasm: \"5f9eb88bcbc1b3dd5669dad6fdd3b91d59dd2d617ad0b34827af8a498d13fa60\",\n  zkey: \"73e0d2328eca8f48024b69b42d659b68d7dd2f067d762079e859ffff34360a1a\",\n} as const;\n\n/** Optional self-hosted path convention (opt-in via `circuitPathsBase`). */\nexport const SELF_HOSTED_CIRCUIT_BASE = \"/circuits/\";\n\n/**\n * Stable published source for the pinned circuit artifacts.\n *\n * Decoupled from {@link PACKAGE_VERSION} on purpose: the withdraw circuit is a\n * fixed cryptographic artifact, so SDK code releases must not change where the\n * verified circuits are fetched from. Bump these together with\n * {@link WITHDRAW_CIRCUIT_SHA256} only when the circuit itself changes.\n */\nexport const CIRCUIT_CDN_PACKAGE = \"veilix-sdk-test\";\nexport const CIRCUIT_CDN_VERSION = \"0.1.0\";\n\nexport type CircuitPaths = {\n  wasm: string;\n  zkey: string;\n};\n\n/** Resolve circuit URLs when the caller knows the package `dist/` root. */\nexport function resolveCircuitPathsFromBase(base: string): CircuitPaths {\n  const root = base.endsWith(\"/\") ? base : `${base}/`;\n  return {\n    wasm: `${root}circuits/${WITHDRAW_CIRCUIT_WASM}`,\n    zkey: `${root}circuits/${WITHDRAW_CIRCUIT_ZKEY}`,\n  };\n}\n\n/**\n * Base URL for circuit files on jsDelivr.\n *\n * Pinned to {@link CIRCUIT_CDN_PACKAGE}@{@link CIRCUIT_CDN_VERSION} (not the\n * current SDK version) so the bytes always match {@link WITHDRAW_CIRCUIT_SHA256}.\n * This URL is independent of the consuming app's origin/domain.\n */\nexport function resolveNpmCdnCircuitBase(): string {\n  return `https://cdn.jsdelivr.net/npm/${CIRCUIT_CDN_PACKAGE}@${CIRCUIT_CDN_VERSION}/dist/circuits/`;\n}\n\n/** Trusted jsDelivr fallback paths for pinned withdraw circuit artifacts. */\nexport function resolveNpmCdnCircuitPaths(): CircuitPaths {\n  const base = resolveNpmCdnCircuitBase();\n  return {\n    wasm: `${base}${WITHDRAW_CIRCUIT_WASM}`,\n    zkey: `${base}${WITHDRAW_CIRCUIT_ZKEY}`,\n  };\n}\n\nfunction isLocalDevHost(hostname: string): boolean {\n  return (\n    hostname === \"localhost\" ||\n    hostname === \"127.0.0.1\" ||\n    hostname === \"[::1]\"\n  );\n}\n\n/**\n * Browser circuit URLs.\n *\n * - Local dev (Vite): `/node_modules/<pkg>/dist/circuits/` — Vite serves node_modules.\n * - Production: pinned, domain-independent jsDelivr CDN (verified by SHA-256 before use).\n *\n * The production default does not depend on the app's own origin/domain, so it\n * works on any deployed host with no copy step. Artifacts are always integrity\n * checked before proving (see {@link WITHDRAW_CIRCUIT_SHA256}). To self-host\n * instead, pass {@link VeilixSdkInitOptions.circuitPathsBase} (e.g. `\"/circuits/\"`);\n * it is verified too and falls back to the CDN if unavailable.\n */\nexport function resolveBrowserCircuitPaths(\n  baseOverride?: string\n): CircuitPaths | null {\n  if (typeof window === \"undefined\") {\n    return null;\n  }\n\n  if (baseOverride !== undefined) {\n    return resolveCircuitPathsFromBase(baseOverride);\n  }\n\n  if (isLocalDevHost(window.location.hostname)) {\n    const base = `/node_modules/${PACKAGE_NAME}/dist/circuits/`;\n    return {\n      wasm: `${base}${WITHDRAW_CIRCUIT_WASM}`,\n      zkey: `${base}${WITHDRAW_CIRCUIT_ZKEY}`,\n    };\n  }\n\n  return resolveNpmCdnCircuitPaths();\n}\n","import { cpSync, existsSync, mkdirSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport {\n  WITHDRAW_CIRCUIT_WASM,\n  WITHDRAW_CIRCUIT_ZKEY,\n} from \"../circuits/constants\";\n\nconst pluginDir = dirname(fileURLToPath(import.meta.url));\nconst circuitsSrc = join(pluginDir, \"..\", \"circuits\");\n\nexport type VeilixCircuitsPluginOptions = {\n  /** Directory under `public/` (default: `\"circuits\"`). */\n  dest?: string;\n};\n\ntype VitePlugin = {\n  name: string;\n  apply?: \"build\" | \"serve\";\n  buildStart?: (this: {\n    error: (msg: string) => void;\n    info: (msg: string) => void;\n  }) => void;\n};\n\n/**\n * Vite plugin: copies withdraw.wasm and withdraw.zkey into `public/circuits/`\n * before production build so browser proof generation works on static hosts (Vercel, etc.).\n *\n * @example\n * ```ts\n * import { veilixCircuitsPlugin } from \"veilix-sdk/vite\";\n *\n * export default defineConfig({\n *   plugins: [react(), veilixCircuitsPlugin()],\n * });\n * ```\n */\nexport function veilixCircuitsPlugin(\n  options: VeilixCircuitsPluginOptions = {}\n): VitePlugin {\n  const destDir = options.dest ?? \"circuits\";\n\n  return {\n    name: \"veilix-circuits\",\n    apply: \"build\",\n    buildStart() {\n      const target = join(process.cwd(), \"public\", destDir);\n      mkdirSync(target, { recursive: true });\n\n      for (const file of [WITHDRAW_CIRCUIT_WASM, WITHDRAW_CIRCUIT_ZKEY]) {\n        const from = join(circuitsSrc, file);\n        if (!existsSync(from)) {\n          this.error(`Missing circuit artifact: ${from}`);\n          return;\n        }\n        cpSync(from, join(target, file));\n      }\n\n      this.info(`Copied withdraw circuits to public/${destDir}/`);\n    },\n  };\n}\n"]}

package/dist/vite/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/circuits/constants.ts","../../src/vite/copyCircuitsPlugin.ts"],"names":[],"mappings":";;;;;AASO,IAAM,qBAAA,GAAwB,eAAA;AAC9B,IAAM,qBAAA,GAAwB,eAAA;;;ACDrC,IAAM,SAAA,GAAY,OAAA,CAAQ,aAAA,CAAc,MAAA,CAAA,IAAA,CAAY,GAAG,CAAC,CAAA;AACxD,IAAM,WAAA,GAAc,IAAA,CAAK,SAAA,EAAW,IAAA,EAAM,UAAU,CAAA;AA6B7C,SAAS,oBAAA,CACd,OAAA,GAAuC,EAAC,EAC5B;AACZ,EAAA,MAAM,OAAA,GAAU,QAAQ,IAAA,IAAQ,UAAA;AAEhC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,iBAAA;AAAA,IACN,KAAA,EAAO,OAAA;AAAA,IACP,UAAA,GAAa;AACX,MAAA,MAAM,SAAS,IAAA,CAAK,OAAA,CAAQ,GAAA,EAAI,EAAG,UAAU,OAAO,CAAA;AACpD,MAAA,SAAA,CAAU,MAAA,EAAQ,EAAE,SAAA,EAAW,IAAA,EAAM,CAAA;AAErC,MAAA,KAAA,MAAW,IAAA,IAAQ,CAAC,qBAAA,EAAuB,qBAAqB,CAAA,EAAG;AACjE,QAAA,MAAM,IAAA,GAAO,IAAA,CAAK,WAAA,EAAa,IAAI,CAAA;AACnC,QAAA,IAAI,CAAC,UAAA,CAAW,IAAI,CAAA,EAAG;AACrB,UAAA,IAAA,CAAK,KAAA,CAAM,CAAA,0BAAA,EAA6B,IAAI,CAAA,CAAE,CAAA;AAC9C,UAAA;AAAA,QACF;AACA,QAAA,MAAA,CAAO,IAAA,EAAM,IAAA,CAAK,MAAA,EAAQ,IAAI,CAAC,CAAA;AAAA,MACjC;AAEA,MAAA,IAAA,CAAK,IAAA,CAAK,CAAA,mCAAA,EAAsC,OAAO,CAAA,CAAA,CAAG,CAAA;AAAA,IAC5D;AAAA,GACF;AACF","file":"index.js","sourcesContent":["import packageJson from \"../../package.json\";\n\n/** npm package name (used to load the standalone circuits module). */\nexport const PACKAGE_NAME = packageJson.name;\n\n/** Published npm version (pins CDN circuit URLs in production). */\nexport const PACKAGE_VERSION = packageJson.version;\n\n/** Withdraw circuit artifact filenames (published under `veilix-sdk/circuits/`). */\nexport const WITHDRAW_CIRCUIT_WASM = \"withdraw.wasm\";\nexport const WITHDRAW_CIRCUIT_ZKEY = \"withdraw.zkey\";\n/**\n * Pinned SHA-256 hashes for the published withdraw circuit artifacts.\n * These are verified in-browser before passing artifacts to snarkjs.\n */\nexport const WITHDRAW_CIRCUIT_SHA256 = {\n  wasm: \"68b712068a25e5b027a755ec96c35f176dfdc988f437b98587d572d6f3a26c03\",\n  zkey: \"fd177812fb178896c08de7efd7bcc9e6b17d5ac1e5de512459ba0a9a92161a5e\",\n} as const;\n\n/** Optional self-hosted path convention (opt-in via `circuitPathsBase`). */\nexport const SELF_HOSTED_CIRCUIT_BASE = \"/circuits/\";\n\n/**\n * Stable published source for the pinned circuit artifacts.\n *\n * Decoupled from {@link PACKAGE_VERSION} on purpose: the withdraw circuit is a\n * fixed cryptographic artifact, so SDK code releases must not change where the\n * verified circuits are fetched from. Bump these together with\n * {@link WITHDRAW_CIRCUIT_SHA256} only when the circuit itself changes.\n */\nexport const CIRCUIT_CDN_PACKAGE = \"veilix-sdk\";\nexport const CIRCUIT_CDN_VERSION = \"0.0.4\";\n\nexport type CircuitPaths = {\n  wasm: string;\n  zkey: string;\n};\n\n/** Resolve circuit URLs when the caller knows the package `dist/` root. */\nexport function resolveCircuitPathsFromBase(base: string): CircuitPaths {\n  const root = base.endsWith(\"/\") ? base : `${base}/`;\n  return {\n    wasm: `${root}circuits/${WITHDRAW_CIRCUIT_WASM}`,\n    zkey: `${root}circuits/${WITHDRAW_CIRCUIT_ZKEY}`,\n  };\n}\n\n/**\n * Base URL for circuit files on jsDelivr.\n *\n * Pinned to {@link CIRCUIT_CDN_PACKAGE}@{@link CIRCUIT_CDN_VERSION} (not the\n * current SDK version) so the bytes always match {@link WITHDRAW_CIRCUIT_SHA256}.\n * This URL is independent of the consuming app's origin/domain.\n */\nexport function resolveNpmCdnCircuitBase(): string {\n  return `https://cdn.jsdelivr.net/npm/${CIRCUIT_CDN_PACKAGE}@${CIRCUIT_CDN_VERSION}/dist/circuits/`;\n}\n\n/** Trusted jsDelivr fallback paths for pinned withdraw circuit artifacts. */\nexport function resolveNpmCdnCircuitPaths(): CircuitPaths {\n  const base = resolveNpmCdnCircuitBase();\n  return {\n    wasm: `${base}${WITHDRAW_CIRCUIT_WASM}`,\n    zkey: `${base}${WITHDRAW_CIRCUIT_ZKEY}`,\n  };\n}\n\nfunction isLocalDevHost(hostname: string): boolean {\n  return (\n    hostname === \"localhost\" ||\n    hostname === \"127.0.0.1\" ||\n    hostname === \"[::1]\"\n  );\n}\n\n/**\n * Browser circuit URLs.\n *\n * - Local dev (Vite): `/node_modules/<pkg>/dist/circuits/` — Vite serves node_modules.\n * - Production: pinned, domain-independent jsDelivr CDN (verified by SHA-256 before use).\n *\n * The production default does not depend on the app's own origin/domain, so it\n * works on any deployed host with no copy step. Artifacts are always integrity\n * checked before proving (see {@link WITHDRAW_CIRCUIT_SHA256}). To self-host\n * instead, pass {@link VeilixSdkInitOptions.circuitPathsBase} (e.g. `\"/circuits/\"`);\n * it is verified too and falls back to the CDN if unavailable.\n */\nexport function resolveBrowserCircuitPaths(\n  baseOverride?: string\n): CircuitPaths | null {\n  if (typeof window === \"undefined\") {\n    return null;\n  }\n\n  if (baseOverride !== undefined) {\n    return resolveCircuitPathsFromBase(baseOverride);\n  }\n\n  if (isLocalDevHost(window.location.hostname)) {\n    const base = `/node_modules/${PACKAGE_NAME}/dist/circuits/`;\n    return {\n      wasm: `${base}${WITHDRAW_CIRCUIT_WASM}`,\n      zkey: `${base}${WITHDRAW_CIRCUIT_ZKEY}`,\n    };\n  }\n\n  return resolveNpmCdnCircuitPaths();\n}\n","import { cpSync, existsSync, mkdirSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport {\n  WITHDRAW_CIRCUIT_WASM,\n  WITHDRAW_CIRCUIT_ZKEY,\n} from \"../circuits/constants\";\n\nconst pluginDir = dirname(fileURLToPath(import.meta.url));\nconst circuitsSrc = join(pluginDir, \"..\", \"circuits\");\n\nexport type VeilixCircuitsPluginOptions = {\n  /** Directory under `public/` (default: `\"circuits\"`). */\n  dest?: string;\n};\n\ntype VitePlugin = {\n  name: string;\n  apply?: \"build\" | \"serve\";\n  buildStart?: (this: {\n    error: (msg: string) => void;\n    info: (msg: string) => void;\n  }) => void;\n};\n\n/**\n * Vite plugin: copies withdraw.wasm and withdraw.zkey into `public/circuits/`\n * before production build so browser proof generation works on static hosts (Vercel, etc.).\n *\n * @example\n * ```ts\n * import { veilixCircuitsPlugin } from \"veilix-sdk/vite\";\n *\n * export default defineConfig({\n *   plugins: [react(), veilixCircuitsPlugin()],\n * });\n * ```\n */\nexport function veilixCircuitsPlugin(\n  options: VeilixCircuitsPluginOptions = {}\n): VitePlugin {\n  const destDir = options.dest ?? \"circuits\";\n\n  return {\n    name: \"veilix-circuits\",\n    apply: \"build\",\n    buildStart() {\n      const target = join(process.cwd(), \"public\", destDir);\n      mkdirSync(target, { recursive: true });\n\n      for (const file of [WITHDRAW_CIRCUIT_WASM, WITHDRAW_CIRCUIT_ZKEY]) {\n        const from = join(circuitsSrc, file);\n        if (!existsSync(from)) {\n          this.error(`Missing circuit artifact: ${from}`);\n          return;\n        }\n        cpSync(from, join(target, file));\n      }\n\n      this.info(`Copied withdraw circuits to public/${destDir}/`);\n    },\n  };\n}\n"]}
+{"version":3,"sources":["../../src/circuits/constants.ts","../../src/vite/copyCircuitsPlugin.ts"],"names":[],"mappings":";;;;;AASO,IAAM,qBAAA,GAAwB,eAAA;AAC9B,IAAM,qBAAA,GAAwB,eAAA;;;ACDrC,IAAM,SAAA,GAAY,OAAA,CAAQ,aAAA,CAAc,MAAA,CAAA,IAAA,CAAY,GAAG,CAAC,CAAA;AACxD,IAAM,WAAA,GAAc,IAAA,CAAK,SAAA,EAAW,IAAA,EAAM,UAAU,CAAA;AA6B7C,SAAS,oBAAA,CACd,OAAA,GAAuC,EAAC,EAC5B;AACZ,EAAA,MAAM,OAAA,GAAU,QAAQ,IAAA,IAAQ,UAAA;AAEhC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,iBAAA;AAAA,IACN,KAAA,EAAO,OAAA;AAAA,IACP,UAAA,GAAa;AACX,MAAA,MAAM,SAAS,IAAA,CAAK,OAAA,CAAQ,GAAA,EAAI,EAAG,UAAU,OAAO,CAAA;AACpD,MAAA,SAAA,CAAU,MAAA,EAAQ,EAAE,SAAA,EAAW,IAAA,EAAM,CAAA;AAErC,MAAA,KAAA,MAAW,IAAA,IAAQ,CAAC,qBAAA,EAAuB,qBAAqB,CAAA,EAAG;AACjE,QAAA,MAAM,IAAA,GAAO,IAAA,CAAK,WAAA,EAAa,IAAI,CAAA;AACnC,QAAA,IAAI,CAAC,UAAA,CAAW,IAAI,CAAA,EAAG;AACrB,UAAA,IAAA,CAAK,KAAA,CAAM,CAAA,0BAAA,EAA6B,IAAI,CAAA,CAAE,CAAA;AAC9C,UAAA;AAAA,QACF;AACA,QAAA,MAAA,CAAO,IAAA,EAAM,IAAA,CAAK,MAAA,EAAQ,IAAI,CAAC,CAAA;AAAA,MACjC;AAEA,MAAA,IAAA,CAAK,IAAA,CAAK,CAAA,mCAAA,EAAsC,OAAO,CAAA,CAAA,CAAG,CAAA;AAAA,IAC5D;AAAA,GACF;AACF","file":"index.js","sourcesContent":["import packageJson from \"../../package.json\";\n\n/** npm package name (used to load the standalone circuits module). */\nexport const PACKAGE_NAME = packageJson.name;\n\n/** Published npm version (pins CDN circuit URLs in production). */\nexport const PACKAGE_VERSION = packageJson.version;\n\n/** Withdraw circuit artifact filenames (published under `veilix-sdk/circuits/`). */\nexport const WITHDRAW_CIRCUIT_WASM = \"withdraw.wasm\";\nexport const WITHDRAW_CIRCUIT_ZKEY = \"withdraw.zkey\";\n/**\n * Pinned SHA-256 hashes for the published withdraw circuit artifacts.\n * These are verified in-browser before passing artifacts to snarkjs.\n */\nexport const WITHDRAW_CIRCUIT_SHA256 = {\n  wasm: \"5f9eb88bcbc1b3dd5669dad6fdd3b91d59dd2d617ad0b34827af8a498d13fa60\",\n  zkey: \"73e0d2328eca8f48024b69b42d659b68d7dd2f067d762079e859ffff34360a1a\",\n} as const;\n\n/** Optional self-hosted path convention (opt-in via `circuitPathsBase`). */\nexport const SELF_HOSTED_CIRCUIT_BASE = \"/circuits/\";\n\n/**\n * Stable published source for the pinned circuit artifacts.\n *\n * Decoupled from {@link PACKAGE_VERSION} on purpose: the withdraw circuit is a\n * fixed cryptographic artifact, so SDK code releases must not change where the\n * verified circuits are fetched from. Bump these together with\n * {@link WITHDRAW_CIRCUIT_SHA256} only when the circuit itself changes.\n */\nexport const CIRCUIT_CDN_PACKAGE = \"veilix-sdk-test\";\nexport const CIRCUIT_CDN_VERSION = \"0.1.0\";\n\nexport type CircuitPaths = {\n  wasm: string;\n  zkey: string;\n};\n\n/** Resolve circuit URLs when the caller knows the package `dist/` root. */\nexport function resolveCircuitPathsFromBase(base: string): CircuitPaths {\n  const root = base.endsWith(\"/\") ? base : `${base}/`;\n  return {\n    wasm: `${root}circuits/${WITHDRAW_CIRCUIT_WASM}`,\n    zkey: `${root}circuits/${WITHDRAW_CIRCUIT_ZKEY}`,\n  };\n}\n\n/**\n * Base URL for circuit files on jsDelivr.\n *\n * Pinned to {@link CIRCUIT_CDN_PACKAGE}@{@link CIRCUIT_CDN_VERSION} (not the\n * current SDK version) so the bytes always match {@link WITHDRAW_CIRCUIT_SHA256}.\n * This URL is independent of the consuming app's origin/domain.\n */\nexport function resolveNpmCdnCircuitBase(): string {\n  return `https://cdn.jsdelivr.net/npm/${CIRCUIT_CDN_PACKAGE}@${CIRCUIT_CDN_VERSION}/dist/circuits/`;\n}\n\n/** Trusted jsDelivr fallback paths for pinned withdraw circuit artifacts. */\nexport function resolveNpmCdnCircuitPaths(): CircuitPaths {\n  const base = resolveNpmCdnCircuitBase();\n  return {\n    wasm: `${base}${WITHDRAW_CIRCUIT_WASM}`,\n    zkey: `${base}${WITHDRAW_CIRCUIT_ZKEY}`,\n  };\n}\n\nfunction isLocalDevHost(hostname: string): boolean {\n  return (\n    hostname === \"localhost\" ||\n    hostname === \"127.0.0.1\" ||\n    hostname === \"[::1]\"\n  );\n}\n\n/**\n * Browser circuit URLs.\n *\n * - Local dev (Vite): `/node_modules/<pkg>/dist/circuits/` — Vite serves node_modules.\n * - Production: pinned, domain-independent jsDelivr CDN (verified by SHA-256 before use).\n *\n * The production default does not depend on the app's own origin/domain, so it\n * works on any deployed host with no copy step. Artifacts are always integrity\n * checked before proving (see {@link WITHDRAW_CIRCUIT_SHA256}). To self-host\n * instead, pass {@link VeilixSdkInitOptions.circuitPathsBase} (e.g. `\"/circuits/\"`);\n * it is verified too and falls back to the CDN if unavailable.\n */\nexport function resolveBrowserCircuitPaths(\n  baseOverride?: string\n): CircuitPaths | null {\n  if (typeof window === \"undefined\") {\n    return null;\n  }\n\n  if (baseOverride !== undefined) {\n    return resolveCircuitPathsFromBase(baseOverride);\n  }\n\n  if (isLocalDevHost(window.location.hostname)) {\n    const base = `/node_modules/${PACKAGE_NAME}/dist/circuits/`;\n    return {\n      wasm: `${base}${WITHDRAW_CIRCUIT_WASM}`,\n      zkey: `${base}${WITHDRAW_CIRCUIT_ZKEY}`,\n    };\n  }\n\n  return resolveNpmCdnCircuitPaths();\n}\n","import { cpSync, existsSync, mkdirSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport {\n  WITHDRAW_CIRCUIT_WASM,\n  WITHDRAW_CIRCUIT_ZKEY,\n} from \"../circuits/constants\";\n\nconst pluginDir = dirname(fileURLToPath(import.meta.url));\nconst circuitsSrc = join(pluginDir, \"..\", \"circuits\");\n\nexport type VeilixCircuitsPluginOptions = {\n  /** Directory under `public/` (default: `\"circuits\"`). */\n  dest?: string;\n};\n\ntype VitePlugin = {\n  name: string;\n  apply?: \"build\" | \"serve\";\n  buildStart?: (this: {\n    error: (msg: string) => void;\n    info: (msg: string) => void;\n  }) => void;\n};\n\n/**\n * Vite plugin: copies withdraw.wasm and withdraw.zkey into `public/circuits/`\n * before production build so browser proof generation works on static hosts (Vercel, etc.).\n *\n * @example\n * ```ts\n * import { veilixCircuitsPlugin } from \"veilix-sdk/vite\";\n *\n * export default defineConfig({\n *   plugins: [react(), veilixCircuitsPlugin()],\n * });\n * ```\n */\nexport function veilixCircuitsPlugin(\n  options: VeilixCircuitsPluginOptions = {}\n): VitePlugin {\n  const destDir = options.dest ?? \"circuits\";\n\n  return {\n    name: \"veilix-circuits\",\n    apply: \"build\",\n    buildStart() {\n      const target = join(process.cwd(), \"public\", destDir);\n      mkdirSync(target, { recursive: true });\n\n      for (const file of [WITHDRAW_CIRCUIT_WASM, WITHDRAW_CIRCUIT_ZKEY]) {\n        const from = join(circuitsSrc, file);\n        if (!existsSync(from)) {\n          this.error(`Missing circuit artifact: ${from}`);\n          return;\n        }\n        cpSync(from, join(target, file));\n      }\n\n      this.info(`Copied withdraw circuits to public/${destDir}/`);\n    },\n  };\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veilix-sdk",
-  "version": "0.0.9",
+  "version": "0.2.0",
   "description": "Veilix Privacy SDK",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -75,6 +75,7 @@
   "license": "MIT",
   "devDependencies": {
     "@solana/wallet-adapter-react": "^0.15.39",
+    "@types/bn.js": "^5.2.0",
     "@types/node": "^26.0.0",
     "@types/react": "^19.1.8",
     "react": "^19.1.0",
@@ -90,6 +91,7 @@
     "@solana/web3.js": "^1.98.4",
     "@switchboard-xyz/common": "^5.8.1",
     "@switchboard-xyz/on-demand": "^3.10.1",
+    "bn.js": "^5.2.5",
     "buffer": "^6.0.3",
     "ffjavascript": "^0.3.1",
     "fixed-merkle-tree": "^0.7.3",

package/dist/VeilixSDK-BmB790UK.d.ts

@@ -1,386 +0,0 @@
-import { PublicKey, Keypair, Connection, TransactionInstruction, Transaction } from '@solana/web3.js';
-import { OracleJob } from '@switchboard-xyz/common';
-import { Program } from '@coral-xyz/anchor';
-import { Wallet } from '@coral-xyz/anchor/dist/cjs/provider';
-import { C as CircuitPaths } from './constants-sO9UKB9l.js';
-
-type IndexerAsset = string | {
-    mint?: string;
-    asset?: string;
-} | null;
-
-/** Frontend wallet adapter or backend {@link Keypair}. */
-type EncryptKeyWallet = Keypair | {
-    signMessage: (message: Uint8Array) => Promise<Uint8Array> | Uint8Array;
-};
-type BuildDepositTxParams = {
-    senderPublicKey: PublicKey | string;
-    /** Pre-generated secret note from {@link generateDepositParams}. */
-    note: string;
-    onChainBackup?: boolean;
-    computeUnitPrice?: number;
-    tempSigner?: PublicKey | string;
-};
-type FetchWalletBalanceOptions = {
-    includeDeposits?: boolean;
-    indexerAsset?: IndexerAsset;
-};
-type BuildRelayPayloadParams = {
-    args: unknown[];
-    proofHex: string;
-    denomination: number | bigint | string;
-    withdrawAddress: unknown;
-    relayerPubkey: unknown;
-    mint?: unknown;
-};
-type RelayPayload = Record<string, unknown>;
-
-type DepositParams = {
-    nullifier: string;
-    secret: string;
-    amount: string;
-    commitment: string;
-    nullifierHash: string;
-    mint: string | null;
-};
-type GenerateDepositParamsResult = {
-    params: DepositParams;
-    note: string;
-};
-type PreparedCircuitArtifacts = {
-    wasmPath: string;
-    zkeyPath: string;
-    /** Revokes the browser object URLs. `null` outside the browser. */
-    cleanup: (() => void) | null;
-};
-type GenerateWithdrawProofOptions = {
-    /** Override WASM path/URL (for bundled frontends, use a Vite `?url` import). */
-    circuitWasmPath?: string;
-    /** Override zkey path/URL (for bundled frontends, use a Vite `?url` import). */
-    circuitZkeyPath?: string;
-    /**
-     * Artifacts already fetched and verified by {@link prepareCircuitArtifacts}.
-     * Skips the download and takes precedence over the path overrides; the caller
-     * stays responsible for calling `cleanup`.
-     */
-    circuitArtifacts?: PreparedCircuitArtifacts;
-};
-/**
- * Fetch and integrity-check the withdraw circuit artifacts once so that several
- * proofs can share them. Call `cleanup` after the last proof has settled.
- */
-declare const prepareCircuitArtifacts: (circuitWasmPath?: string, circuitZkeyPath?: string) => Promise<PreparedCircuitArtifacts>;
-
-type Network = "mainnet" | "devnet";
-declare const MAINNET_TOKEN_MINTS: {
-    readonly Veilix: "GAFN64LvtCBoc5BHncVn3JEJGpq42rUzQjPmvMK2UhZH";
-    readonly Bitcoin: "3NZ9JMVBmGAqocybic2c7LQCJScmgsAZ6vQqTDzcqmJh";
-    readonly Ethereum: "7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs";
-    readonly USDC: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
-};
-type TokenSymbol = keyof typeof MAINNET_TOKEN_MINTS;
-declare const TOKEN_DECIMALS: {
-    readonly Solana: 9;
-    readonly Veilix: 9;
-    readonly Ethereum: 8;
-    readonly Bitcoin: 8;
-    readonly USDC: 6;
-};
-type TokenDecimalsSymbol = keyof typeof TOKEN_DECIMALS;
-/** Supported deposit denominations per token (same on mainnet and devnet). */
-declare const DEPOSIT_AMOUNTS: {
-    readonly Solana: readonly [0.1, 1, 5, 10, 50, 100, 500];
-    readonly Veilix: readonly [10000, 50000, 100000, 500000, 1000000, 10000000];
-    readonly Bitcoin: readonly [0.01, 0.05, 0.1, 0.5, 1, 5];
-    readonly Ethereum: readonly [0.1, 1, 10, 50, 100, 500];
-    readonly USDC: readonly [1, 10, 50, 100, 1000, 10000, 100000, 1000000];
-};
-type DepositTokenSymbol = keyof typeof DEPOSIT_AMOUNTS;
-
-type Relayer = {
-    isValid: true;
-    label: string;
-    url: string;
-    key: number;
-    value: string;
-    fee: unknown;
-    recentActivities: unknown;
-    userPubkey: unknown;
-    workers: unknown;
-    totalFeeEarningsSol: unknown;
-    totalWithdrawCount: unknown;
-    stakedAmount: unknown;
-    volume24hSol: unknown;
-    volume7dSol: unknown;
-};
-
-interface VeilixSdkInitOptions {
-    /** Wallet for Anchor provider transactions. */
-    wallet: Wallet;
-    /**
-     * Solana JSON-RPC endpoint (Node/scripts). Omit when passing {@link connection}
-     * from `@solana/wallet-adapter-react` (`useConnection()`).
-     */
-    rpcEndpoint?: string;
-    /** Existing connection (e.g. `useConnection()` in React). */
-    connection?: Connection;
-    /**
-     * Cluster override when the RPC URL does not contain `devnet` / `mainnet` hints
-     * (common with private RPC providers).
-     */
-    network: Network;
-    /**
-     * Base URL/path for withdraw circuit artifacts in the browser.
-     * Defaults to `/node_modules/<pkg>/dist/circuits/` on localhost and the
-     * pinned, SHA-256-verified jsDelivr CDN in production (domain-independent).
-     * Set this to self-host instead, e.g. `"/circuits/"` (verified, with CDN fallback)
-     * or `"https://cdn.example.com/veilix/circuits/"`.
-     */
-    circuitPathsBase?: string;
-}
-interface VeilixSdkRuntimeConfig {
-    rpcEndpoint: string;
-    /** Cluster inferred from {@link rpcEndpoint}. */
-    network: Network;
-    programId: string;
-    /** Active relayers for {@link network}, loaded at SDK initialization. */
-    relayers: Relayer[];
-    connection: Connection;
-    wallet: Wallet;
-    program: Program;
-    /** Set by {@link VeilixSDK.getEncryptionKey}; required for on-chain note backup. */
-    encryptKey?: Uint8Array;
-    /** Resolved withdraw circuit wasm/zkey URLs for browser proof generation. */
-    circuitPaths?: CircuitPaths;
-}
-
-type WithdrawParams = {
-    /** Secret note from the original deposit. */
-    note: string;
-    /** Withdrawal recipient public key. */
-    recipient: PublicKey | string;
-    /** Mode for normal withdraw or veilix transfer. */
-    veilixTransferMode?: boolean;
-};
-type WithdrawStatus = "success" | "failed";
-type WithdrawResult = {
-    txHash: string;
-    status: WithdrawStatus;
-};
-
-type QuoteRelayer = {
-    url: string;
-    [key: string]: unknown;
-};
-type QuoteTransaction = Record<string, unknown>;
-type QuoteSplit = {
-    denomination: number;
-    totalRelayerFee: number;
-    relayer: QuoteRelayer;
-    transaction: QuoteTransaction;
-};
-type Quote = {
-    amount: number;
-    transactionCount: number;
-    recipientAmount: number;
-    totalRelayerFee: number;
-    etaSeconds: number;
-    splits: QuoteSplit[];
-    platformFee?: number;
-};
-type GetQuoteResponse = {
-    success: boolean;
-    quote: Quote;
-};
-type GetQuoteParams = {
-    amount: number | string;
-    amountLamports: number | string | bigint;
-    recipient: PublicKey | string;
-    /** Indexer asset label (default `SOL`). */
-    asset?: string;
-    /** Cluster for the quote (default active SDK network). */
-    network?: Network;
-};
-/** Fetch a withdraw quote from the indexer. Requires SDK init or an active instance context. */
-declare function getQuote(params: GetQuoteParams): Promise<GetQuoteResponse>;
-
-type ResolvedNoteAsset = {
-    key: string;
-    tokenName: TokenDecimalsSymbol;
-    unit: string;
-    multiplier: bigint;
-    mint: string | null;
-    poolAmounts: readonly number[];
-    decimals: number;
-};
-
-type VeilixTransferItem = {
-    mint: PublicKey;
-    /** Human-readable token amount (e.g. `"1.5"` SOL). */
-    amount: string;
-    recipient: PublicKey;
-};
-type VeilixTransferDepositFailure = {
-    amount: string;
-    mint: string;
-    recipient: string;
-};
-type VeilixTransferWithdrawFailure = {
-    note: string;
-    recipient: string;
-};
-type VeilixTransferResult = {
-    error: boolean;
-    depositFailed: VeilixTransferDepositFailure[];
-    withdrawFailed: VeilixTransferWithdrawFailure[];
-    depositSuccess: string[];
-};
-type VeilixTransferOptions = {
-    /** When true, all withdraws use the same randomly selected relayer. */
-    uniqueRelayer?: boolean;
-};
-
-/**
- * Veilix SDK client. Create one instance per configuration (network, RPC, wallet).
- *
- * @example
- * ```js
- * const { VeilixSDK } = require('veilix-sdk');
- * const sdk = await VeilixSDK.create({
- *   rpcEndpoint: 'https://api.devnet.solana.com',
- *   wallet,
- *   network: 'devnet',
- * });
- * console.log(sdk.config.relayers);
- * ```
- *
- * @example React (wallet-adapter)
- * ```tsx
- * import { useVeilixSdk } from 'veilix-sdk/react';
- *
- * function MyComponent() {
- *   const sdk = useVeilixSdk({ network: 'mainnet' });
- *   if (!sdk) return null;
- *   // ...
- * }
- * ```
- *
- * @example
- * ```ts
- * import { VeilixSDK } from 'veilix-sdk';
- * const sdk = await VeilixSDK.create({ rpcEndpoint, wallet, network: 'mainnet' });
- * await sdk.getEncryptionKey(wallet);
- * const { note } = sdk.generateDepositParams(1_000_000_000n, null);
- * await sdk.buildDepositTx({ senderPublicKey: wallet.publicKey, note, onChainBackup: true });
- * ```
- */
-declare class VeilixSDK {
-    static readonly VERSION = "0.0.1";
-    readonly config: VeilixSdkRuntimeConfig;
-    private constructor();
-    /** Create an SDK instance (loads relayers for the inferred network). */
-    static create(options: VeilixSdkInitOptions): Promise<VeilixSDK>;
-    private run;
-    private runAsync;
-    getConfig(): VeilixSdkRuntimeConfig;
-    getRpcEndpoint(): string;
-    getNetwork(): Network;
-    getProgramIdString(): string;
-    /** Encryption key derived by {@link getEncryptionKey}; undefined until set. */
-    get encryptKey(): Uint8Array | undefined;
-    /** Relayers loaded at initialization; use {@link fetchRelayers} to refresh. */
-    get relayers(): Relayer[];
-    getIndexerUrl(): string;
-    getRiskApiUrl(): string;
-    getTokenMints(): {
-        Solana: string;
-        Veilix: "GAFN64LvtCBoc5BHncVn3JEJGpq42rUzQjPmvMK2UhZH";
-        Bitcoin: "" | "3NZ9JMVBmGAqocybic2c7LQCJScmgsAZ6vQqTDzcqmJh";
-        Ethereum: "" | "7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs";
-        USDC: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" | "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU";
-    };
-    getVeilixTokenMint(): string;
-    getTokenMint(symbol: TokenSymbol): string;
-    getDepositAmounts(symbol: DepositTokenSymbol): readonly number[];
-    getTokenDecimals(symbol: TokenDecimalsSymbol): number;
-    resolveCircuitPaths(base?: string): Promise<CircuitPaths>;
-    getRangeRiskScoreJob(address: string): OracleJob;
-    getOracleQuote(payer: Keypair | PublicKey, addressToCheck: string): Promise<{
-        queueAccount: PublicKey;
-        sigVerifyIx: TransactionInstruction;
-    }>;
-    getProgramId(): PublicKey;
-    getPoolPDA(denominationLamports: number | bigint): [PublicKey, number];
-    getTokenPoolPDA(mint: PublicKey | string, denominationSmallestUnits: number | bigint): [PublicKey, number];
-    getTreasuryPDA(): [PublicKey, number];
-    getCommitmentPDA(commitmentBigInt: bigint | number | string): [PublicKey, number];
-    getNullifierPDA(nullifierHashBigInt: bigint | number | string): [PublicKey, number];
-    getNetworkStatePDA(): [PublicKey, number];
-    buildDepositTx(params: BuildDepositTxParams): Promise<{
-        tx: Transaction;
-        note: string;
-    }>;
-    /**
-     * Withdraw to `recipient` using a secret `note`.
-     * Relayer is chosen at random from {@link config.relayers}, or by {@link WithdrawParams.relayerIdx}.
-     */
-    withdraw(params: WithdrawParams, relayerIdx?: number): Promise<WithdrawResult>;
-    /**
-     * Private transfer: deposit into the pool (split by supported denominations),
-     * then withdraw each successful note to the recipient.
-     *
-     * Requires {@link getEncryptionKey} before calling (deposits use on-chain backup).
-     *
-     * @param tempKeypair Ephemeral keypair co-signed on deposit instructions.
-     */
-    veilixTransfer(items: VeilixTransferItem[], tempKeypair: Keypair): Promise<VeilixTransferResult>;
-    /** Validate a withdraw recipient against the risk API. */
-    assertWithdrawRecipientAllowed(address: string): Promise<void>;
-    /** Resolve the token asset encoded in a secret note. */
-    resolveNoteAsset(amount: string, mint?: string | null, tokenNameHint?: TokenDecimalsSymbol): ResolvedNoteAsset;
-    fetchPlatformFee(): Promise<string>;
-    /** Fetch a withdraw quote from the indexer. */
-    getQuote(params: GetQuoteParams): Promise<GetQuoteResponse>;
-    fetchCommitments(denomination: number | bigint | string, indexerAsset?: IndexerAsset): Promise<unknown>;
-    validateNullifier(nullifierHash: string, indexerAsset?: IndexerAsset): Promise<unknown>;
-    fetchTxStatus(commitmentHex: string, nullifierHashHex: string, indexerAsset?: IndexerAsset): Promise<unknown>;
-    fetchDepositCountByCommitment(commitment: string, denomination: number | bigint | string, indexerAsset?: IndexerAsset): Promise<unknown>;
-    fetchWalletBalance(wallet: string, options?: FetchWalletBalanceOptions): Promise<unknown>;
-    /** Re-fetch relayers from the indexer and update {@link config.relayers}. */
-    fetchRelayers(): Promise<Relayer[]>;
-    fetchLatestTransactions(type?: string, indexerAsset?: IndexerAsset): Promise<unknown>;
-    fetchTxCounts(type?: string, indexerAsset?: IndexerAsset): Promise<unknown>;
-    normalizePubkeyString(value: unknown): string;
-    buildRelayPayload(params: BuildRelayPayloadParams): RelayPayload;
-    submitToRelayer(relayerUrl: string, payload: RelayPayload): Promise<unknown>;
-    pollRelayerJob(relayerUrl: string, jobId: string, maxWaitMs?: number): Promise<unknown>;
-    /**
-     * Derives the note encryption key from a wallet signature and stores it on
-     * {@link config.encryptKey}. Required before {@link buildDepositTx} with
-     * `onChainBackup: true`.
-     *
-     * Accepts a frontend wallet adapter (`signMessage`) or a backend {@link Keypair}.
-     */
-    getEncryptionKey(wallet: EncryptKeyWallet): Promise<Uint8Array>;
-    encryptData(key: Uint8Array, plaintext: string): Uint8Array<ArrayBufferLike>;
-    decryptData(key: Uint8Array, combined: Uint8Array): string;
-    generateRandomFieldElement(): bigint;
-    createCommitment(nullifier: bigint | number | string, secret: bigint | number | string): bigint;
-    createNullifierHash(nullifier: bigint | number | string): bigint;
-    generateDepositParams(amountLamports: bigint | number | string, mint?: string | null): GenerateDepositParamsResult;
-    parseSecretNote(note: string): Record<string, string>;
-    publicKeyToFieldElement(publicKeyBytes: Uint8Array | number[]): bigint;
-    amountToFieldElement(amount: bigint | number | string): bigint;
-    generateMerkleProof(depositParams: Record<string, unknown>, leaves: unknown[]): unknown;
-    generateWithdrawProof(depositParams: Record<string, unknown>, leaves: unknown[], recipient: PublicKey | string, relayer: PublicKey | string, fee: bigint | number | string, refund: bigint | number | string, options?: GenerateWithdrawProofOptions): Promise<unknown>;
-    convertProofToBytes(proof: unknown): Promise<number[] | Uint8Array<ArrayBufferLike>>;
-    to32ByteBuffer(bigInt: bigint | number | string): Uint8Array<ArrayBufferLike>;
-    toFixedHex(value: bigint | number | string, length?: number): string;
-    toFieldElementHex(value: bigint | number | string): string;
-    formatNoteForDisplay(note: string, segmentLen?: number): string;
-    appendIndexerAsset(params: URLSearchParams, indexerAsset?: IndexerAsset): void;
-    /** Program ID for a cluster without an SDK instance. */
-    static getProgramIdForNetwork(network: Network): string;
-}
-
-export { type BuildDepositTxParams as B, type DepositTokenSymbol as D, type EncryptKeyWallet as E, type FetchWalletBalanceOptions as F, type GenerateDepositParamsResult as G, type IndexerAsset as I, type Network as N, type PreparedCircuitArtifacts as P, type Quote as Q, type RelayPayload as R, type TokenDecimalsSymbol as T, VeilixSDK as V, type WithdrawParams as W, type BuildRelayPayloadParams as a, type GenerateWithdrawProofOptions as b, type GetQuoteParams as c, type GetQuoteResponse as d, type QuoteRelayer as e, type QuoteSplit as f, type QuoteTransaction as g, type Relayer as h, type ResolvedNoteAsset as i, type TokenSymbol as j, type VeilixSdkInitOptions as k, type VeilixSdkRuntimeConfig as l, type VeilixTransferDepositFailure as m, type VeilixTransferItem as n, type VeilixTransferOptions as o, type VeilixTransferResult as p, type VeilixTransferWithdrawFailure as q, type WithdrawResult as r, type WithdrawStatus as s, getQuote as t, prepareCircuitArtifacts as u };