@cloak.dev/sdk 0.1.8 → 0.2.1

package/dist/{utxo-LSTVI4HH.js → utxo-XPEGGWZ6.js}

@@ -1,6 +1,6 @@
 import {
   NATIVE_SOL_MINT,
-  bigintToBytes32,
+  bigintToBytes322 as bigintToBytes32,
   bigintToHex,
   computeCommitment,
   computeNullifier,
@@ -11,14 +11,15 @@ import {
   deriveUtxoKeypairFromSpendKey,
   deserializeUtxo,
   generateUtxoKeypair,
-  hexToBigint,
+  hexToBigint2 as hexToBigint,
   pubkeyToFieldElement,
+  pubkeyToFieldLimbs,
   randomFieldElement,
   selectUtxos,
   serializeUtxo,
   sumUtxoAmounts,
   utxoEquals
-} from "./chunk-2SOX3JNO.js";
+} from "./chunk-KNM6K5NG.js";
 export {
   NATIVE_SOL_MINT,
   bigintToBytes32,
@@ -34,6 +35,7 @@ export {
   generateUtxoKeypair,
   hexToBigint,
   pubkeyToFieldElement,
+  pubkeyToFieldLimbs,
   randomFieldElement,
   selectUtxos,
   serializeUtxo,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cloak.dev/sdk",
   "description": "Shield, send, and swap on Solana privately — TypeScript SDK with UTXO-based zero-knowledge transactions",
-  "version": "0.1.8",
+  "version": "0.2.1",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -17,25 +17,28 @@
     "build": "tsup src/index.ts --clean --format cjs,esm --dts --external fs --external path --external crypto",
     "lint": "tsc --noEmit",
     "test": "NODE_OPTIONS=--experimental-vm-modules jest",
-    "test:examples": "CLOAK_EXAMPLE_DRY_RUN=1 tsx examples/fast-send.ts && CLOAK_EXAMPLE_DRY_RUN=1 tsx examples/fast-usdc-send.ts && CLOAK_EXAMPLE_DRY_RUN=1 tsx examples/usdc-pool-transfer.ts && CLOAK_EXAMPLE_DRY_RUN=1 tsx examples/transfer.ts && CLOAK_EXAMPLE_DRY_RUN=1 tsx examples/swap.ts && CLOAK_EXAMPLE_DRY_RUN=1 tsx examples/swap-recovery.ts && CLOAK_EXAMPLE_DRY_RUN=1 tsx examples/history-scan.ts",
     "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch",
     "test:coverage": "NODE_OPTIONS=--experimental-vm-modules jest --coverage",
     "test:verbose": "NODE_OPTIONS=--experimental-vm-modules jest --verbose",
     "prepare": "npm run build",
-    "prepublishOnly": "npm run build",
-    "example:fast-send": "tsx examples/fast-send.ts",
-    "example:fast-usdc-send": "tsx examples/fast-usdc-send.ts",
-    "example:usdc-pool-transfer": "tsx examples/usdc-pool-transfer.ts",
-    "example:history-scan": "tsx examples/history-scan.ts",
-    "example:swap": "tsx examples/swap.ts",
-    "example:swap-recovery": "tsx examples/swap-recovery.ts",
-    "example:swap-usdc": "OUTPUT_TOKEN_MINT=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v SWAP_MARKER_TAG=swap-usdc tsx examples/swap.ts",
-    "example:swap-brz": "TRY_BRZ_FIRST=true OUTPUT_TOKEN_MINT=FtgGSFADXBtroxq8VCausXRr2of47QBf5AS1NtZCu4GD FALLBACK_OUTPUT_TOKEN_MINT=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v SWAP_MARKER_TAG=swap-brz tsx examples/swap.ts",
-    "soak:swap": "CLOAK_SOAK_NAME=swap CLOAK_SOAK_RUN_CMD='npx tsx examples/swap.ts' CLOAK_FORCE_RELAY_MERKLE_TREE=1 tsx scripts/soak-runner.ts",
-    "soak:fast-send": "CLOAK_SOAK_NAME=fast-send CLOAK_SOAK_RUN_CMD='npx tsx examples/fast-send.ts' CLOAK_FORCE_RELAY_MERKLE_TREE=1 tsx scripts/soak-runner.ts",
-    "example:transfer": "tsx examples/transfer.ts",
-    "script:admin-compliance": "tsx scripts/admin-compliance-report.ts",
-    "script:compliance-e2e-smoke": "tsx scripts/compliance-e2e-smoke.ts"
+    "prepublishOnly": "npm run build && node scripts/verify-dist-matches-src.mjs",
+    "verify:dist": "node scripts/verify-dist-matches-src.mjs",
+    "script:admin-compliance": "tsx scripts/admin-compliance.ts",
+    "script:compliance-smoke": "tsx scripts/compliance-smoke.ts",
+    "fixture:chain-note": "tsx scripts/gen-chain-note-v3-fixture.ts",
+    "test:examples": "CLOAK_EXAMPLE_DRY_RUN=1 tsx examples/sol/deposit.ts && CLOAK_EXAMPLE_DRY_RUN=1 tsx examples/sol/private-send.ts && CLOAK_EXAMPLE_DRY_RUN=1 tsx examples/sol/withdraw.ts && CLOAK_EXAMPLE_DRY_RUN=1 tsx examples/sol/swap.ts && CLOAK_EXAMPLE_DRY_RUN=1 tsx examples/spl/deposit.ts && CLOAK_EXAMPLE_DRY_RUN=1 tsx examples/spl/private-send.ts && CLOAK_EXAMPLE_DRY_RUN=1 tsx examples/spl/withdraw.ts && CLOAK_EXAMPLE_DRY_RUN=1 tsx examples/viewing-keys.ts",
+    "example:deposit": "tsx examples/sol/deposit.ts",
+    "example:private-send": "tsx examples/sol/private-send.ts",
+    "example:withdraw": "tsx examples/sol/withdraw.ts",
+    "example:swap": "tsx examples/sol/swap.ts",
+    "example:spl-deposit": "tsx examples/spl/deposit.ts",
+    "example:spl-private-send": "tsx examples/spl/private-send.ts",
+    "example:spl-withdraw": "tsx examples/spl/withdraw.ts",
+    "example:viewing-keys": "tsx examples/viewing-keys.ts",
+    "example:swap-usdc": "OUTPUT_TOKEN_MINT=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v SWAP_MARKER_TAG=swap-usdc tsx examples/sol/swap.ts",
+    "example:swap-brz": "TRY_BRZ_FIRST=true OUTPUT_TOKEN_MINT=FtgGSFADXBtroxq8VCausXRr2of47QBf5AS1NtZCu4GD FALLBACK_OUTPUT_TOKEN_MINT=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v SWAP_MARKER_TAG=swap-brz tsx examples/sol/swap.ts",
+    "soak:swap": "CLOAK_SOAK_NAME=swap CLOAK_SOAK_RUN_CMD='npx tsx examples/sol/swap.ts' CLOAK_FORCE_RELAY_MERKLE_TREE=1 tsx scripts/soak-runner.ts",
+    "soak:withdraw": "CLOAK_SOAK_NAME=withdraw CLOAK_SOAK_RUN_CMD='npx tsx examples/sol/withdraw.ts' CLOAK_FORCE_RELAY_MERKLE_TREE=1 tsx scripts/soak-runner.ts"
   },
   "keywords": [
     "solana",
@@ -68,8 +71,7 @@
     "ffjavascript": "^0.3.0",
     "snarkjs": "0.7.6",
     "tweetnacl": "^1.0.3",
-    "tweetnacl-util": "^0.15.1",
-    "yaml": "^2.8.3"
+    "tweetnacl-util": "^0.15.1"
   },
   "devDependencies": {
     "@coral-xyz/anchor": "^0.32.1",
@@ -113,9 +115,38 @@
   },
   "overrides": {
     "glob": "^10.5.0",
-    "js-yaml": "^3.14.2",
+    "js-yaml": "^3.15.1",
     "diff": "^4.0.4",
     "bigint-buffer": "npm:bigint-buffer-fixed@^1.1.6",
-    "tar": "^7.5.4"
+    "tar": "^7.5.21",
+    "handlebars": "^4.7.9",
+    "underscore": "^1.13.8",
+    "ip-address": "^10.4.0",
+    "@tootallnate/once": "^2.0.1",
+    "@babel/core": "^7.29.7",
+    "ws": "^8.21.0",
+    "picomatch@2": "^2.3.2",
+    "picomatch@4": "^4.0.7",
+    "brace-expansion@1": "^1.1.18",
+    "brace-expansion@2": "^2.1.4"
+  },
+  "resolutions": {
+    "glob": "^10.5.0",
+    "js-yaml": "^3.15.1",
+    "diff": "^4.0.4",
+    "bigint-buffer": "npm:bigint-buffer-fixed@^1.1.6",
+    "tar": "^7.5.21",
+    "handlebars": "^4.7.9",
+    "underscore": "^1.13.8",
+    "ip-address": "^10.4.0",
+    "@tootallnate/once": "^2.0.1",
+    "@babel/core": "^7.29.7",
+    "ws": "^8.21.0",
+    "jest-util/picomatch": "^2.3.2",
+    "anymatch/picomatch": "^2.3.2",
+    "micromatch/picomatch": "^2.3.2",
+    "picomatch": "^4.0.7",
+    "test-exclude/**/brace-expansion": "^1.1.18",
+    "brace-expansion": "^2.1.4"
   }
 }

package/dist/chunk-2SOX3JNO.js

@@ -1,255 +0,0 @@
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
-// src/core/utxo.ts
-import { PublicKey } from "@solana/web3.js";
-import { buildPoseidon } from "circomlibjs";
-import { blake3 } from "@noble/hashes/blake3";
-var FIELD_MODULUS = BigInt("21888242871839275222246405745257275088548364400416034343698204186575808495617");
-var UTXO_KEY_DOMAIN = new TextEncoder().encode("cloak_utxo_priv_v1");
-var NATIVE_SOL_MINT = new PublicKey("So11111111111111111111111111111111111111112");
-var poseidonInstance = null;
-async function getPoseidon() {
-  if (!poseidonInstance) {
-    poseidonInstance = await buildPoseidon();
-  }
-  return poseidonInstance;
-}
-function randomFieldElement() {
-  const bytes = new Uint8Array(32);
-  if (typeof crypto !== "undefined" && crypto.getRandomValues) {
-    crypto.getRandomValues(bytes);
-  } else {
-    const { randomBytes } = __require("crypto");
-    const nodeBytes = randomBytes(32);
-    for (let i = 0; i < 32; i++) {
-      bytes[i] = nodeBytes[i];
-    }
-  }
-  let value = BigInt(0);
-  for (let i = 0; i < 32; i++) {
-    value = value << BigInt(8) | BigInt(bytes[i]);
-  }
-  return value % (FIELD_MODULUS >> BigInt(4));
-}
-async function generateUtxoKeypair() {
-  const poseidon = await getPoseidon();
-  const privateKey = randomFieldElement();
-  const publicKeyHash = poseidon([privateKey, BigInt(0)]);
-  const publicKey = poseidon.F.toObject(publicKeyHash);
-  return { privateKey, publicKey };
-}
-async function deriveUtxoKeypairFromSpendKey(skSpend) {
-  if (!skSpend || !(skSpend instanceof Uint8Array) || skSpend.length !== 32) {
-    throw new Error("skSpend must be 32 bytes");
-  }
-  const preimage = new Uint8Array(UTXO_KEY_DOMAIN.length + skSpend.length);
-  preimage.set(UTXO_KEY_DOMAIN, 0);
-  preimage.set(skSpend, UTXO_KEY_DOMAIN.length);
-  const hash = blake3(preimage);
-  let value = BigInt(0);
-  for (let i = 0; i < 32; i++) {
-    value = value << BigInt(8) | BigInt(hash[i]);
-  }
-  const privateKey = value % (FIELD_MODULUS >> BigInt(4));
-  const publicKey = await derivePublicKey(privateKey);
-  return { privateKey, publicKey };
-}
-async function derivePublicKey(privateKey) {
-  const poseidon = await getPoseidon();
-  const hash = poseidon([privateKey, BigInt(0)]);
-  return poseidon.F.toObject(hash);
-}
-async function createUtxo(amount, keypair, mintAddress = NATIVE_SOL_MINT) {
-  const blinding = randomFieldElement();
-  const utxo = {
-    amount,
-    keypair,
-    blinding,
-    mintAddress
-  };
-  utxo.commitment = await computeCommitment(utxo);
-  return utxo;
-}
-async function createZeroUtxo(mintAddress = NATIVE_SOL_MINT, salt) {
-  const poseidon = await getPoseidon();
-  const effectiveSalt = salt ?? randomFieldElement();
-  const publicKeyHash = poseidon([effectiveSalt, BigInt(0)]);
-  const publicKey = poseidon.F.toObject(publicKeyHash);
-  const keypair = { privateKey: effectiveSalt, publicKey };
-  const utxo = {
-    amount: BigInt(0),
-    keypair,
-    blinding: BigInt(0),
-    mintAddress
-  };
-  utxo.commitment = await computeCommitment(utxo);
-  utxo.index = 0;
-  return utxo;
-}
-function pubkeyToFieldElement(pubkey) {
-  const bytes = pubkey.toBytes();
-  let value = BigInt(0);
-  for (let i = 0; i < 32; i++) {
-    value = value << BigInt(8) | BigInt(bytes[i]);
-  }
-  return value % FIELD_MODULUS;
-}
-async function computeCommitment(utxo) {
-  const poseidon = await getPoseidon();
-  const mintField = pubkeyToFieldElement(utxo.mintAddress);
-  const hash = poseidon([
-    utxo.amount,
-    utxo.keypair.publicKey,
-    utxo.blinding,
-    mintField
-  ]);
-  return poseidon.F.toObject(hash);
-}
-async function computeSignature(privateKey, commitment, pathIndex) {
-  const poseidon = await getPoseidon();
-  const hash = poseidon([privateKey, commitment, pathIndex]);
-  return poseidon.F.toObject(hash);
-}
-async function computeNullifier(utxo) {
-  if (utxo.index === void 0) {
-    throw new Error("UTXO must have an index to compute nullifier");
-  }
-  const poseidon = await getPoseidon();
-  const commitment = utxo.commitment ?? await computeCommitment(utxo);
-  const pathIndex = BigInt(utxo.index);
-  const signature = await computeSignature(
-    utxo.keypair.privateKey,
-    commitment,
-    pathIndex
-  );
-  const hash = poseidon([commitment, pathIndex, signature]);
-  return poseidon.F.toObject(hash);
-}
-function serializeUtxo(utxo) {
-  const buffer = new ArrayBuffer(128);
-  const view = new DataView(buffer);
-  const amountBytes = bigintToBytes(utxo.amount, 8);
-  for (let i = 0; i < 8; i++) {
-    view.setUint8(i, amountBytes[i]);
-  }
-  const privkeyBytes = bigintToBytes(utxo.keypair.privateKey, 32);
-  for (let i = 0; i < 32; i++) {
-    view.setUint8(8 + i, privkeyBytes[i]);
-  }
-  const blindingBytes = bigintToBytes(utxo.blinding, 32);
-  for (let i = 0; i < 32; i++) {
-    view.setUint8(40 + i, blindingBytes[i]);
-  }
-  const mintBytes = utxo.mintAddress.toBytes();
-  for (let i = 0; i < 32; i++) {
-    view.setUint8(72 + i, mintBytes[i]);
-  }
-  view.setUint32(104, utxo.index ?? 0, true);
-  return new Uint8Array(buffer);
-}
-async function deserializeUtxo(bytes) {
-  const view = new DataView(bytes.buffer, bytes.byteOffset);
-  const amountBytes = bytes.slice(0, 8);
-  const amount = bytesToBigint(amountBytes);
-  const privkeyBytes = bytes.slice(8, 40);
-  const privateKey = bytesToBigint(privkeyBytes);
-  const publicKey = await derivePublicKey(privateKey);
-  const blindingBytes = bytes.slice(40, 72);
-  const blinding = bytesToBigint(blindingBytes);
-  const mintBytes = bytes.slice(72, 104);
-  const mintAddress = new PublicKey(mintBytes);
-  const index = view.getUint32(104, true);
-  const utxo = {
-    amount,
-    keypair: { privateKey, publicKey },
-    blinding,
-    mintAddress,
-    index: index > 0 ? index : void 0
-  };
-  utxo.commitment = await computeCommitment(utxo);
-  return utxo;
-}
-function bigintToBytes(value, length) {
-  const result = new Uint8Array(length);
-  let remaining = value;
-  for (let i = 0; i < length; i++) {
-    result[i] = Number(remaining & BigInt(255));
-    remaining >>= BigInt(8);
-  }
-  return result;
-}
-function bytesToBigint(bytes) {
-  let result = BigInt(0);
-  for (let i = bytes.length - 1; i >= 0; i--) {
-    result = result << BigInt(8) | BigInt(bytes[i]);
-  }
-  return result;
-}
-function bigintToHex(value) {
-  return value.toString(16).padStart(64, "0");
-}
-function hexToBigint(hex) {
-  const cleanHex = hex.startsWith("0x") ? hex.slice(2) : hex;
-  return BigInt("0x" + cleanHex);
-}
-function bigintToBytes32(value) {
-  const result = new Uint8Array(32);
-  let remaining = value;
-  for (let i = 31; i >= 0; i--) {
-    result[i] = Number(remaining & BigInt(255));
-    remaining >>= BigInt(8);
-  }
-  return result;
-}
-async function utxoEquals(a, b) {
-  const commitmentA = a.commitment ?? await computeCommitment(a);
-  const commitmentB = b.commitment ?? await computeCommitment(b);
-  return commitmentA === commitmentB;
-}
-function sumUtxoAmounts(utxos) {
-  return utxos.reduce((sum, utxo) => sum + utxo.amount, BigInt(0));
-}
-function selectUtxos(available, targetAmount) {
-  const sorted = [...available].sort(
-    (a, b) => Number(b.amount - a.amount)
-  );
-  const selected = [];
-  let total = BigInt(0);
-  for (const utxo of sorted) {
-    if (total >= targetAmount) break;
-    selected.push(utxo);
-    total += utxo.amount;
-  }
-  if (total < targetAmount) {
-    return null;
-  }
-  return selected;
-}
-
-export {
-  __require,
-  NATIVE_SOL_MINT,
-  randomFieldElement,
-  generateUtxoKeypair,
-  deriveUtxoKeypairFromSpendKey,
-  derivePublicKey,
-  createUtxo,
-  createZeroUtxo,
-  pubkeyToFieldElement,
-  computeCommitment,
-  computeSignature,
-  computeNullifier,
-  serializeUtxo,
-  deserializeUtxo,
-  bigintToHex,
-  hexToBigint,
-  bigintToBytes32,
-  utxoEquals,
-  sumUtxoAmounts,
-  selectUtxos
-};