@sabaaa1/common 0.2.16

package/functions/snarkjs/constructGeneralZkProof.mjs

@@ -0,0 +1,160 @@
+import { chainIds as ie } from "../../constants/chains.constants.mjs";
+import { zeroAddress as c, defaultSignatureData as de } from "../../constants/protocol.constants.mjs";
+import { Utxo as re } from "../../data-structures/utxo/Utxo.mjs";
+import { HinkalStakeMode as k } from "../../types/hinkal.stake.types.mjs";
+import { performTaskWithWorker as h } from "../../webworker/performTaskWithWorker.mjs";
+import { WorkerVariant as g } from "../../webworker/worker.registry.mjs";
+import { ZKProofWorkerActionType as D } from "../../webworker/zkProofWorker/zkProofWorker.types.mjs";
+import { randomBigInt as ce } from "../web3/etherFunctions.mjs";
+import { calcAmountChanges as N, calcEncryptedOutputs as se, buildOutCommitments as le, calcPublicSignalCount as Se, getSlippageValues as pe, createCallDataHash as fe, calcStealthAddressStructure as ke } from "./common.snarkjs.mjs";
+import { generateCircomData as Te } from "./generateCircomData.mjs";
+import { generateZkProof as He } from "./generateZkProof.mjs";
+import { getPatchedAccessTokenMerkleTree as Ce } from "../../data-structures/merkle-tree/getPatchedAccessTokenMerkleTree.mjs";
+import { defaultHinkalLogicArgs as Ie } from "../../types/hinkal.types.mjs";
+import { generateFeeStructure as Ae } from "../utils/fees.utils.mjs";
+import { hinkalCheckTokenRegistry as he, createHinkalHelperFromData as ge } from "../../data-structures/Hinkal/hinkalCheckTokenRegistry.mjs";
+import { Logger as P } from "../../error-handling/logger.mjs";
+const We = async (d, y, Q, o, m, r, b, _, s, R, X, u = c, z = ie.localhost, l = o.map(() => !1), T = o.map(() => 0n), w = void 0, i, Y = !1, n = void 0, S, p = void 0, $, B = de) => {
+  const E = N(o, m), H = o.map((e) => e[0].erc20TokenAddress), C = se(
+    m,
+    (i && i.mode !== k.Deposit) ?? !1
+  ), I = r.getShieldedPrivateKey(), O = re.findCorrectRandomization(ce(31), I), L = await he(
+    $ ?? ge(z),
+    H,
+    N(o, m, !0)
+  ), Z = Ce(
+    Q,
+    r,
+    Y,
+    L
+  ), M = Z.getRootHash(), V = Z.toJSON(), v = y.getRootHash(), W = o.map((e) => e.map((a) => a.getConstructableParams())), J = r.getSignature(), { accessTokenSiblings: U, accessTokenSiblingSides: x } = await h({
+    type: g.ZKProof,
+    payload: {
+      type: D.CALC_ACCESS_TOKEN_SIBLING_AND_SIDES,
+      data: {
+        userSignature: J,
+        merkleTreeAccessTokenSerialized: V
+      }
+    }
+  }), { inCommitmentSiblings: ee, inCommitmentSiblingSides: te } = await h({
+    type: g.ZKProof,
+    payload: {
+      type: D.CALC_COMMITMENTS_SIBLING_AND_SIDES,
+      data: { inputUtxosSerialized: W, userSignature: J, merkleTreeSerialized: y.toJSON() }
+    }
+  }), K = await h({
+    type: g.ZKProof,
+    payload: {
+      type: D.BUILD_IN_NULLIFIERS,
+      data: { inputUtxosSerialized: W, onChainCreation: l, proverVersion: d }
+    }
+  }), G = le(d, m, l), t = {
+    rootHashHinkal: v,
+    shieldedPrivateKey: I,
+    erc20TokenAddresses: H,
+    inAmounts: o.map((e) => e.map((a) => a.amount.toString())),
+    inTimeStamps: o.map((e) => e.map((a) => a.timeStamp)),
+    inRandomizations: o.map((e) => e.map((a) => a.randomization)),
+    inNullifiers: K,
+    inCommitmentSiblings: ee,
+    inCommitmentSiblingSides: te,
+    outAmounts: m.map((e) => e.map((a) => a.amount.toString())),
+    outTimeStamp: BigInt(m[0][0].timeStamp),
+    outPublicKeys: m.map((e) => e.map((a) => a.getStealthAddress())),
+    extraRandomization: O,
+    amountChanges: E,
+    outCommitments: G,
+    rootHashAccessToken: M,
+    accessTokenSiblings: U,
+    accessTokenSiblingSides: x,
+    calldataHash: 0n
+  }, f = o.map((e) => e[0].tokenId ?? 0), q = f.reduce((e, a) => e + a, 0) > 0 ? f.length : 0;
+  q > 0 && (t.tokenIds = f);
+  const A = Se(
+    b,
+    t.erc20TokenAddresses,
+    t.amountChanges,
+    t.inNullifiers,
+    t.outCommitments,
+    q
+  );
+  if (!n) {
+    n = Ie(E.length, r), n.interactionAddress = s ?? c;
+    const e = r.getInHinkalAddress(n.interactionAddress);
+    n.inHinkalAddress = e;
+  }
+  if (d === "v1x1") {
+    if (t.interactionAddress = n?.interactionAddress ?? s ?? c, r.getInHinkalAddress(t.interactionAddress) !== n.inHinkalAddress)
+      throw new Error("inHinkalAddress mismatch");
+    t.externalApprovalAddresses = n.useApprovalUtxoData?.map(
+      ({ externalApprovalAddresses: e }) => e
+    ) ?? [c, c, c];
+  }
+  p || (p = Ae(
+    T,
+    o.map((e) => e[0].erc20TokenAddress)
+  ));
+  const F = N(o, m, !0);
+  S || (S = pe(F, n)), P.log({ publicSignalCount: A }), t.calldataHash = fe(
+    d,
+    A,
+    u,
+    s,
+    _,
+    R,
+    C,
+    T,
+    w,
+    S,
+    l,
+    n,
+    p,
+    B
+  ), i && (i.mode === k.Deposit && (t.mode = 0), i.mode === k.Stake && (t.mode = 1), i.mode === k.Unstake && (t.mode = 2), t.stakedTokenRecipient = i.stakedTokenRecipient, t.stakeBlinding = i.stakeBlinding, t.depositorAddress = i.depositorAddress);
+  const { zkCallData: oe, publicSignals: ae } = await He(
+    d,
+    z,
+    b,
+    t,
+    X
+  );
+  P.log({ publicSignals: ae });
+  const ne = ke(O, I), j = await Te(
+    d,
+    G,
+    K,
+    v,
+    M,
+    F,
+    H,
+    o,
+    m,
+    C,
+    T,
+    A,
+    _,
+    s,
+    R,
+    u,
+    t.calldataHash,
+    f,
+    ne,
+    l,
+    w,
+    void 0,
+    n,
+    S,
+    p,
+    B
+  );
+  P.log({ circomData: j });
+  const me = {
+    tokenNumber: o.length,
+    nullifierAmount: o[0].length,
+    outputAmount: m[0].length
+  };
+  return { zkCallData: oe, circomData: j, dimData: me, encryptedOutputs: C };
+};
+export {
+  We as constructZkProof
+};

package/functions/snarkjs/generateCircomData.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("../../constants/protocol.constants.cjs"),V=require("../../types/circom-data.types.cjs"),_=require("../utils/external-action.utils.cjs"),z=require("./getOriginalSender.cjs"),I=async(s,g,l,d,u,m,S,L,a,D,p,f,i,t,A,o,h,k,C,q,y,b,v,x,H,O=n.defaultSignatureData)=>{const c={rootHashHinkal:d,erc20TokenAddresses:S,tokenIds:k.map(e=>String(e)),amountChanges:m,inputNullifiers:l,outCommitments:g,encryptedOutputs:D,timeStamp:a.length>0?a[0][0].timeStamp:String(b??""),stealthAddressStructure:C,rootHashAccessToken:u,relay:o,externalAddress:t===void 0?n.zeroAddress:t,externalActionMetadata:A,externalActionId:typeof i=="bigint"?0n:_.getExternalActionIdHash(i),hookData:y||V.defaultHookData,publicSignalCount:f,calldataHash:h};if(s==="v1x0"){const e=c;return e.flatFees=p,e}else{const e=c;e.onChainCreation=q,e.slippageValues=x;const r=structuredClone(v);return"interactionAddress"in r&&delete r.interactionAddress,e.hinkalLogicArgs=r,e.feeStructure=H,e.signatureData=O,e.originalSender=z.getOriginalSender(t??n.zeroAddress,o),e}};exports.generateCircomData=I;

package/functions/snarkjs/generateCircomData.d.ts

@@ -0,0 +1,5 @@
+import { FeeStructure, HinkalLogicArgs, ProverVersion } from '../../types/hinkal.types';
+import { Utxo } from '../../data-structures/utxo/Utxo';
+import { CircomDataBaseType, HookDataType, StealthAddressStructure } from '../../types/circom-data.types';
+import { ExternalActionId } from '../../types/external-action.types';
+export declare const generateCircomData: (proverVersion: ProverVersion, outCommitments: string[][], inputNullifiers: string[][], rootHashHinkal: bigint | undefined, rootHashAccessToken: bigint | undefined, amountChanges: bigint[], erc20TokenAddresses: string[], inputUtxos: Utxo[][], outputUtxos: Utxo[][], encryptedOutputs: string[][], flatFees: bigint[], publicSignalCount: number, externalActionId: ExternalActionId | bigint, externalAddress: string | undefined, externalActionMetadata: string, relay: string, calldataHash: bigint, tokenIds: number[], stealthAddressStructure: StealthAddressStructure, onChainCreation: boolean[], hookData: HookDataType | undefined, timeStampFallback: number | undefined, hinkalLogicArgs: HinkalLogicArgs, slippageValues: bigint[], feeStructure: FeeStructure, signatureData?: import('../../index.ts').SignatureData) => Promise<CircomDataBaseType>;

package/functions/snarkjs/generateCircomData.mjs

@@ -0,0 +1,37 @@
+import { zeroAddress as c, defaultSignatureData as w } from "../../constants/protocol.constants.mjs";
+import { defaultHookData as y } from "../../types/circom-data.types.mjs";
+import { getExternalActionIdHash as z } from "../utils/external-action.utils.mjs";
+import { getOriginalSender as E } from "./getOriginalSender.mjs";
+const G = async (s, m, g, d, l, f, p, F, r, u, D, S, a, e, h, n, k, A, C, x, H, V, v, I, L, b = w) => {
+  const o = {
+    rootHashHinkal: d,
+    erc20TokenAddresses: p,
+    tokenIds: A.map((t) => String(t)),
+    amountChanges: f,
+    inputNullifiers: g,
+    outCommitments: m,
+    encryptedOutputs: u,
+    timeStamp: r.length > 0 ? r[0][0].timeStamp : String(V ?? ""),
+    stealthAddressStructure: C,
+    rootHashAccessToken: l,
+    relay: n,
+    externalAddress: e === void 0 ? c : e,
+    externalActionMetadata: h,
+    externalActionId: typeof a == "bigint" ? 0n : z(a),
+    hookData: H || y,
+    publicSignalCount: S,
+    calldataHash: k
+  };
+  if (s === "v1x0") {
+    const t = o;
+    return t.flatFees = D, t;
+  } else {
+    const t = o;
+    t.onChainCreation = x, t.slippageValues = I;
+    const i = structuredClone(v);
+    return "interactionAddress" in i && delete i.interactionAddress, t.hinkalLogicArgs = i, t.feeStructure = L, t.signatureData = b, t.originalSender = E(e ?? c, n), t;
+  }
+};
+export {
+  G as generateCircomData
+};

package/functions/snarkjs/generateZkProof.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const g=require("../../error-handling/logger.cjs"),c=require("./generateZkProofEnclave.cjs"),f=require("./generateZkProofSelf.cjs"),l=async(e,r,o,t,n)=>{if(n)try{return await c.generateZkProofEnclave(e,r,o,t)}catch(a){g.Logger.error("enclave proof error",a)}return f.generateZkProofSelf(e,r,o,t)};exports.generateZkProof=l;

package/functions/snarkjs/generateZkProof.d.ts

@@ -0,0 +1,5 @@
+import { NewZkCallDataType, ProverVersion } from '../../types';
+export declare const generateZkProof: (proverVersion: ProverVersion, chainId: number, verifierName: string, input: any, remotely?: boolean) => Promise<{
+    zkCallData: NewZkCallDataType;
+    publicSignals: string[];
+}>;

package/functions/snarkjs/generateZkProof.mjs

@@ -0,0 +1,15 @@
+import { Logger as n } from "../../error-handling/logger.mjs";
+import { generateZkProofEnclave as c } from "./generateZkProofEnclave.mjs";
+import { generateZkProofSelf as g } from "./generateZkProofSelf.mjs";
+const p = async (r, o, e, t, f) => {
+  if (f)
+    try {
+      return await c(r, o, e, t);
+    } catch (a) {
+      n.error("enclave proof error", a);
+    }
+  return g(r, o, e, t);
+};
+export {
+  p as generateZkProof
+};

package/functions/snarkjs/generateZkProofEnclave.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./getZKFiles.cjs"),k=require("./constant.cjs"),E=require("../utils/encryptInputForEnclave.cjs");require("../../data-structures/tor/TorClient.cjs");require("@hazae41/binary");require("@hazae41/cascade");const f=require("../../data-structures/tor/HttpClient.cjs"),i=e=>{if(e.startsWith("http")){const t=e.split("/").at(-1);if(!t)throw new Error("invalid verifierName");return t}return e},m=async(e,n,t,a)=>{const s=i(r.getWASMFile(e,t,n)),c=i(r.getZKeyFile(e,t,n)),{keyCiphertext:l,inputCiphertext:o}=await E.makeEnclaveHandshakeAndEncryptInput(a),u={chainId:n,circuit_wasm:s,circuit_zkey:c,input:o,key:l,version:e},p=await f.httpClient.post(`${k.ENCLAVE_EC2_URL}/generate`,u),{public_signals:g,zk_calldata:y}=p;return{zkCallData:y,publicSignals:g}};exports.generateZkProofEnclave=m;

package/functions/snarkjs/generateZkProofEnclave.d.ts

@@ -0,0 +1,6 @@
+import { NewZkCallDataType } from '../../types/snark.types';
+import { ProverVersion } from '../../types/hinkal.types';
+export declare const generateZkProofEnclave: (proverVersion: ProverVersion, chainId: number, verifierName: string, input: any) => Promise<{
+    zkCallData: NewZkCallDataType;
+    publicSignals: string[];
+}>;

package/functions/snarkjs/generateZkProofEnclave.mjs

@@ -0,0 +1,29 @@
+import { getWASMFile as f, getZKeyFile as k } from "./getZKFiles.mjs";
+import { ENCLAVE_EC2_URL as y } from "./constant.mjs";
+import { makeEnclaveHandshakeAndEncryptInput as E } from "../utils/encryptInputForEnclave.mjs";
+import "../../data-structures/tor/TorClient.mjs";
+import "@hazae41/binary";
+import "@hazae41/cascade";
+import { httpClient as g } from "../../data-structures/tor/HttpClient.mjs";
+const r = (t) => {
+  if (t.startsWith("http")) {
+    const e = t.split("/").at(-1);
+    if (!e)
+      throw new Error("invalid verifierName");
+    return e;
+  }
+  return t;
+}, x = async (t, i, e, n) => {
+  const a = r(f(t, e, i)), o = r(k(t, e, i)), { keyCiphertext: s, inputCiphertext: p } = await E(n), l = {
+    chainId: i,
+    circuit_wasm: a,
+    circuit_zkey: o,
+    input: p,
+    key: s,
+    version: t
+  }, c = await g.post(`${y}/generate`, l), { public_signals: m, zk_calldata: u } = c;
+  return { zkCallData: u, publicSignals: m };
+};
+export {
+  x as generateZkProofEnclave
+};

package/functions/snarkjs/generateZkProofSelf.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./getZKFiles.cjs"),k=require("../../webworker/performTaskWithWorker.cjs"),c=require("../../webworker/snarkjsWorker/snarkjsWorker.types.cjs"),y=require("../../webworker/worker.registry.cjs"),S=async(r,e,t,a)=>{const s=o.getWASMFile(r,t,e),n=o.getZKeyFile(r,t,e),{publicSignals:i,zkCallData:l}=await k.performTaskWithWorker({type:y.WorkerVariant.SnarkJS,payload:{type:c.SnarkJSWorkerActionType.FULL_PROVE,data:{input:a,chainId:e,wasmFilePath:s,zKeyFilePath:n}}});return{zkCallData:l,publicSignals:i}};exports.generateZkProofSelf=S;

package/functions/snarkjs/generateZkProofSelf.d.ts

@@ -0,0 +1,5 @@
+import { NewZkCallDataType, ProverVersion } from '../../types';
+export declare const generateZkProofSelf: (proverVersion: ProverVersion, chainId: number, verifierName: string, input: any) => Promise<{
+    zkCallData: NewZkCallDataType;
+    publicSignals: string[];
+}>;

package/functions/snarkjs/generateZkProofSelf.mjs

@@ -0,0 +1,17 @@
+import { getWASMFile as m, getZKeyFile as n } from "./getZKFiles.mjs";
+import { performTaskWithWorker as k } from "../../webworker/performTaskWithWorker.mjs";
+import { SnarkJSWorkerActionType as s } from "../../webworker/snarkjsWorker/snarkjsWorker.types.mjs";
+import { WorkerVariant as y } from "../../webworker/worker.registry.mjs";
+const W = async (o, t, r, a) => {
+  const e = m(o, r, t), l = n(o, r, t), { publicSignals: p, zkCallData: i } = await k({
+    type: y.SnarkJS,
+    payload: {
+      type: s.FULL_PROVE,
+      data: { input: a, chainId: t, wasmFilePath: e, zKeyFilePath: l }
+    }
+  });
+  return { zkCallData: i, publicSignals: p };
+};
+export {
+  W as generateZkProofSelf
+};

package/functions/snarkjs/getOriginalSender.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../../constants/protocol.constants.cjs"),t=(r,o)=>o===e.zeroAddress?r??e.zeroAddress:e.zeroAddress;exports.getOriginalSender=t;

package/functions/snarkjs/getOriginalSender.d.ts

@@ -0,0 +1 @@
+export declare const getOriginalSender: (externalAddress: string, relay: string) => string;

package/functions/snarkjs/getOriginalSender.mjs

@@ -0,0 +1,5 @@
+import { zeroAddress as r } from "../../constants/protocol.constants.mjs";
+const d = (e, o) => o === r ? e ?? r : r;
+export {
+  d as getOriginalSender
+};

package/functions/snarkjs/getZKFiles.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("../../constants/chains.constants.cjs"),s=require("./constant.cjs"),l=(e,t,i)=>{const r=e==="v1x0"?"":e;if(i===o.chainIds.localhost)return s.localVerifiers[`${t}${r}Wasm`];const c=s.prodVerifiers(i,e)[`${t}${r}Wasm`];return console.log({verifier:c}),c},f=(e,t,i)=>{const r=e==="v1x0"?"":e;return i===o.chainIds.localhost?s.localVerifiers[`${t}${r}Zkey`]:s.prodVerifiers(i,e)[`${t}${r}Zkey`]};exports.getWASMFile=l;exports.getZKeyFile=f;

package/functions/snarkjs/getZKFiles.d.ts

@@ -0,0 +1,3 @@
+import { ProverVersion } from '../../types/hinkal.types';
+export declare const getWASMFile: (proverVersion: ProverVersion, filename: string, chainId: number) => string;
+export declare const getZKeyFile: (proverVersion: ProverVersion, filename: string, chainId: number) => string;

package/functions/snarkjs/getZKFiles.mjs

@@ -0,0 +1,16 @@
+import { chainIds as s } from "../../constants/chains.constants.mjs";
+import { prodVerifiers as c, localVerifiers as f } from "./constant.mjs";
+const v = (e, r, t) => {
+  const i = e === "v1x0" ? "" : e;
+  if (t === s.localhost)
+    return f[`${r}${i}Wasm`];
+  const o = c(t, e)[`${r}${i}Wasm`];
+  return console.log({ verifier: o }), o;
+}, x = (e, r, t) => {
+  const i = e === "v1x0" ? "" : e;
+  return t === s.localhost ? f[`${r}${i}Zkey`] : c(t, e)[`${r}${i}Zkey`];
+};
+export {
+  v as getWASMFile,
+  x as getZKeyFile
+};

package/functions/snarkjs/index.d.ts

@@ -0,0 +1,4 @@
+export * from './constructGeneralZkProof';
+export * from './constructEmporiumProof';
+export * from './common.snarkjs';
+export * from './generateZkProof';

package/functions/staking/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("ethers"),y=require("../../data-structures/crypto-keys/keys.cjs"),s=require("libsodium-wrappers"),c=require("../../crypto/poseidon.cjs");require("circomlibjs-hinkal-fork");require("process");require("buffer");const f=(e,t,r)=>{const n=i.ethers.utils.defaultAbiCoder.encode(["uint256","address"],[e,t]),a=s.crypto_box_seal(n,i.ethers.utils.arrayify(r));return`0x${Buffer.from(a).toString("hex")}`},p=(e,t)=>{const r=Buffer.from(e.slice(2),"hex"),{publicKey:n,privateKey:a}=y.UserKeys.getEncryptionKeyPair(t.getShieldedPrivateKey());try{const o=s.crypto_box_seal_open(r,i.ethers.utils.arrayify(n),i.ethers.utils.arrayify(a)),d=Buffer.from(o).toString("utf-8"),[u,l]=i.ethers.utils.defaultAbiCoder.decode(["uint256","address"],d);return{stakeBlinding:u.toBigInt(),stakedTokenRecipient:l}}catch{console.log("failed to decrypt");return}},S=(e,t,r,n,a,o)=>BigInt(c.poseidonHash(...[e,t,r,n,a,o].map(BigInt))),k=(e,t)=>c.poseidonHash(e,t),g=(e,t,r,n,a)=>i.ethers.utils.defaultAbiCoder.encode(["uint8","uint256","address","bytes","bytes"],[e,t,r,n,a]);exports.calculateStakeNullifier=k;exports.createStakeCommitment=S;exports.decryptStake=p;exports.encodeHStakeMetadata=g;exports.encryptStake=f;

package/functions/staking/index.d.ts

@@ -0,0 +1,11 @@
+import { UserKeys } from '../../data-structures/crypto-keys/keys';
+interface StakeDecryptOutput {
+    stakeBlinding: bigint;
+    stakedTokenRecipient: string;
+}
+export declare const encryptStake: (stakeBlinding: bigint, stakedTokenRecipient: string, encryptionKey: string) => string;
+export declare const decryptStake: (encryptedStakeCommitmentContent: string, minterKeys: UserKeys) => StakeDecryptOutput | undefined;
+export declare const createStakeCommitment: (isStake: boolean, stakedTokenRecipient: string, stakeBlinding: bigint, tokenAddress: string, amountChange: bigint, timeStamp: bigint) => bigint;
+export declare const calculateStakeNullifier: (stakeCommitment: bigint, blinding: bigint) => string;
+export declare const encodeHStakeMetadata: (action: 1 | 0, stakeCommitment: bigint, depositorAddress: string, encryptedContent: string, encryptedContentAlt: string) => string;
+export {};

package/functions/staking/index.mjs

@@ -0,0 +1,42 @@
+import { ethers as n } from "ethers";
+import { UserKeys as y } from "../../data-structures/crypto-keys/keys.mjs";
+import s from "libsodium-wrappers";
+import { poseidonHash as c } from "../../crypto/poseidon.mjs";
+import "circomlibjs-hinkal-fork";
+import "process";
+import "buffer";
+const B = (t, e, r) => {
+  const o = n.utils.defaultAbiCoder.encode(
+    ["uint256", "address"],
+    [t, e]
+  ), i = s.crypto_box_seal(o, n.utils.arrayify(r));
+  return `0x${Buffer.from(i).toString("hex")}`;
+}, h = (t, e) => {
+  const r = Buffer.from(t.slice(2), "hex"), { publicKey: o, privateKey: i } = y.getEncryptionKeyPair(e.getShieldedPrivateKey());
+  try {
+    const a = s.crypto_box_seal_open(
+      r,
+      n.utils.arrayify(o),
+      n.utils.arrayify(i)
+    ), d = Buffer.from(a).toString("utf-8"), [u, p] = n.utils.defaultAbiCoder.decode(
+      ["uint256", "address"],
+      d
+    );
+    return { stakeBlinding: u.toBigInt(), stakedTokenRecipient: p };
+  } catch {
+    console.log("failed to decrypt");
+    return;
+  }
+}, x = (t, e, r, o, i, a) => BigInt(
+  c(...[t, e, r, o, i, a].map(BigInt))
+), K = (t, e) => c(t, e), _ = (t, e, r, o, i) => n.utils.defaultAbiCoder.encode(
+  ["uint8", "uint256", "address", "bytes", "bytes"],
+  [t, e, r, o, i]
+);
+export {
+  K as calculateStakeNullifier,
+  x as createStakeCommitment,
+  h as decryptStake,
+  _ as encodeHStakeMetadata,
+  B as encryptStake
+};

package/functions/utils/addresses.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("ethers"),l=s=>{const[r,t,e]=s.split(","),n=!r||!t||!e,i=t?.substring(0,2)!=="0x"||e?.substring(0,2)!=="0x",o=e?.length!==66||t?.length>66||t?.length<64,c=s?.includes('"');return!(n||i||o||c)},u=s=>{const[r,t,e,n]=s.split(","),i=!t||!r||!e||!n,o=t?.substring(0,2)!=="0x",c=t?.length>66||t?.length<64,a=s?.includes('"');return!(i||o||c||a)},h=s=>{const[r,t,e,n]=s.split(",");return{extraRandomization:BigInt(r),stealthAddress:BigInt(t),H0:BigInt(e),H1:BigInt(n)}},g=s=>d.ethers.utils.keccak256(d.ethers.utils.toUtf8Bytes(s.toLowerCase()));exports.constructStealthAddressStructure=h;exports.hashEthereumAddress=g;exports.isValidExtendedPrivateAddress=u;exports.isValidPrivateAddress=l;

package/functions/utils/addresses.d.ts

@@ -0,0 +1,5 @@
+import { StealthAddressStructure } from '../../types/circom-data.types';
+export declare const isValidPrivateAddress: (address: string) => boolean;
+export declare const isValidExtendedPrivateAddress: (address: string) => boolean;
+export declare const constructStealthAddressStructure: (recipientInfo: string) => StealthAddressStructure;
+export declare const hashEthereumAddress: (ethereumAddress: string) => string;

package/functions/utils/addresses.mjs

@@ -0,0 +1,22 @@
+import { ethers as d } from "ethers";
+const g = (s) => {
+  const [e, t, n] = s.split(","), r = !e || !t || !n, i = t?.substring(0, 2) !== "0x" || n?.substring(0, 2) !== "0x", o = n?.length !== 66 || t?.length > 66 || t?.length < 64, c = s?.includes('"');
+  return !(r || i || o || c);
+}, h = (s) => {
+  const [e, t, n, r] = s.split(","), i = !t || !e || !n || !r, o = t?.substring(0, 2) !== "0x", c = t?.length > 66 || t?.length < 64, a = s?.includes('"');
+  return !(i || o || c || a);
+}, u = (s) => {
+  const [e, t, n, r] = s.split(",");
+  return {
+    extraRandomization: BigInt(e),
+    stealthAddress: BigInt(t),
+    H0: BigInt(n),
+    H1: BigInt(r)
+  };
+}, m = (s) => d.utils.keccak256(d.utils.toUtf8Bytes(s.toLowerCase()));
+export {
+  u as constructStealthAddressStructure,
+  m as hashEthereumAddress,
+  h as isValidExtendedPrivateAddress,
+  g as isValidPrivateAddress
+};

package/functions/utils/amounts.utils.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=t=>t.reduce((n,e)=>n+e,0),s=t=>t.reduce((n,e)=>n+e,0n),u=t=>t/100,a=(t,n)=>n*t/10000n;function g(t){return typeof t=="object"&&"toBigInt"in t?t.toBigInt():BigInt(t)}const m=t=>{try{return BigInt(t)}catch{return}},d=t=>{const n=Number(t);return Number.isNaN(n)?void 0:n},l=(t,n)=>t?parseInt(t,10):n;function f(){BigInt.prototype.toJSON=function(){return this.toString()}}function I(...t){return t.reduce((n,e)=>e>n?e:n)}function B(t){return t===0?0:t<99999e-11?"< 0.000001":+Number(t).toFixed(6)}const p=(t,n)=>{const e=t.toFixed(20),r=e.indexOf(".");if(r===-1)return e;const i=r+n+1;return e.substring(0,i)},o=t=>{if(/^0+$/.test(t))return"0";if(/^0\.\d+$/.test(t))return t;const n=t.replace(/^0+/,"");return n.startsWith(".")?`0${n}`:n},b=t=>{const n=t.split("."),e=n[0],r=n.length>1?`.${n[1]}`:"";return`${o(e).replace(/\B(?=(\d{3})+(?!\d))/g,",")}${r}`},S=(t,n=18)=>{const e=t.match(/^(\d+)(\.(\d+))?$/);if(e){const r=e[1],i=e[3]?.slice(0,n)||"";return i?`${r}.${i}`:r}return t},N=t=>t<0n?-t:t,P=(t,n,e)=>{const r=t<n?t:n;return e?r<e?r:e:r},x=(t,n)=>t>n?t:n,O=t=>t.reduce((n,{amount:e})=>n+e,0n);exports.absBigInt=N;exports.beepsToPercentage=u;exports.bigintApplySugar=f;exports.bigintMax=I;exports.calculateAmountUsingBeeps=a;exports.calculateBigIntSum=s;exports.calculateSum=c;exports.countTotalAmountInUtxos=O;exports.fixDecimalsAmount=B;exports.getValueFirstNDigit=p;exports.maxBigInt=x;exports.minBigInt=P;exports.toBigInt=g;exports.toBigIntOrUndefined=m;exports.toCommaSeparatedNumberString=b;exports.toInt=l;exports.toNumberOrUndefined=d;exports.trimLeadingZeros=o;exports.truncateToDecimalPlaces=S;

package/functions/utils/amounts.utils.d.ts

@@ -0,0 +1,25 @@
+import { type Utxo } from '../../data-structures/utxo/Utxo';
+import { BigIntable } from '../../types/big-intable.types';
+export declare const calculateSum: (arr: number[]) => number;
+export declare const calculateBigIntSum: (arr: bigint[]) => bigint;
+export declare const beepsToPercentage: (beeps: number) => number;
+export declare const calculateAmountUsingBeeps: (beep: bigint, amount: bigint) => bigint;
+export declare function toBigInt(value: BigIntable): bigint;
+/** Converts the value to a BigInt or returns undefined if can't */
+export declare const toBigIntOrUndefined: (value: any) => bigint | undefined;
+/** Converts the value to a number or returns undefined if can't */
+export declare const toNumberOrUndefined: (value: any) => number | undefined;
+export declare const toInt: (param: string | undefined, defaultValue: number) => number;
+export declare function bigintApplySugar(): void;
+export declare function bigintMax(...values: bigint[]): bigint;
+export declare function fixDecimalsAmount(n: number): number | "< 0.000001";
+export declare const getValueFirstNDigit: (num: number, numberOfDigits: number) => string;
+export declare const trimLeadingZeros: (numberString: string) => string;
+export declare const toCommaSeparatedNumberString: (numberString: string) => string;
+export declare const truncateToDecimalPlaces: (numStr: string, decimalPlaces?: number) => string;
+/** Return absolute value of BigInt */
+export declare const absBigInt: (n: bigint) => bigint;
+/** Return the smallest values of the 2 or 3 values provided */
+export declare const minBigInt: (a: bigint, b: bigint, c?: bigint) => bigint;
+export declare const maxBigInt: (a: bigint, b: bigint) => bigint;
+export declare const countTotalAmountInUtxos: (utxos: Utxo[]) => bigint;

package/functions/utils/amounts.utils.mjs

@@ -0,0 +1,73 @@
+const s = (t) => t.reduce((n, e) => n + e, 0), u = (t) => t.reduce((n, e) => n + e, 0n), a = (t) => t / 100, d = (t, n) => n * t / 10000n;
+function g(t) {
+  return typeof t == "object" && "toBigInt" in t ? t.toBigInt() : BigInt(t);
+}
+const m = (t) => {
+  try {
+    return BigInt(t);
+  } catch {
+    return;
+  }
+}, f = (t) => {
+  const n = Number(t);
+  return Number.isNaN(n) ? void 0 : n;
+}, l = (t, n) => t ? parseInt(t, 10) : n;
+function I() {
+  BigInt.prototype.toJSON = function() {
+    return this.toString();
+  };
+}
+function p(...t) {
+  return t.reduce((n, e) => e > n ? e : n);
+}
+function B(t) {
+  return t === 0 ? 0 : t < 99999e-11 ? "< 0.000001" : +Number(t).toFixed(6);
+}
+const N = (t, n) => {
+  const e = t.toFixed(20), r = e.indexOf(".");
+  if (r === -1)
+    return e;
+  const o = r + n + 1;
+  return e.substring(0, o);
+}, i = (t) => {
+  if (/^0+$/.test(t))
+    return "0";
+  if (/^0\.\d+$/.test(t))
+    return t;
+  const n = t.replace(/^0+/, "");
+  return n.startsWith(".") ? `0${n}` : n;
+}, P = (t) => {
+  const n = t.split("."), e = n[0], r = n.length > 1 ? `.${n[1]}` : "";
+  return `${i(e).replace(/\B(?=(\d{3})+(?!\d))/g, ",")}${r}`;
+}, $ = (t, n = 18) => {
+  const e = t.match(/^(\d+)(\.(\d+))?$/);
+  if (e) {
+    const r = e[1], o = e[3]?.slice(0, n) || "";
+    return o ? `${r}.${o}` : r;
+  }
+  return t;
+}, x = (t) => t < 0n ? -t : t, O = (t, n, e) => {
+  const r = t < n ? t : n;
+  return e ? r < e ? r : e : r;
+}, S = (t, n) => t > n ? t : n, b = (t) => t.reduce((n, { amount: e }) => n + e, 0n);
+export {
+  x as absBigInt,
+  a as beepsToPercentage,
+  I as bigintApplySugar,
+  p as bigintMax,
+  d as calculateAmountUsingBeeps,
+  u as calculateBigIntSum,
+  s as calculateSum,
+  b as countTotalAmountInUtxos,
+  B as fixDecimalsAmount,
+  N as getValueFirstNDigit,
+  S as maxBigInt,
+  O as minBigInt,
+  g as toBigInt,
+  m as toBigIntOrUndefined,
+  P as toCommaSeparatedNumberString,
+  l as toInt,
+  f as toNumberOrUndefined,
+  i as trimLeadingZeros,
+  $ as truncateToDecimalPlaces
+};

package/functions/utils/arraysMatch.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=(e,t)=>e.length!==t.length?!1:e.every((r,n)=>r===t[n]);exports.arraysMatch=l;

package/functions/utils/arraysMatch.d.ts

@@ -0,0 +1 @@
+export declare const arraysMatch: (array1: unknown[], array2: unknown[]) => boolean;

package/functions/utils/arraysMatch.mjs

@@ -0,0 +1,4 @@
+const h = (e, t) => e.length !== t.length ? !1 : e.every((n, r) => n === t[r]);
+export {
+  h as arraysMatch
+};

package/functions/utils/cacheDevice.utils.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("../../constants/token-data/index.cjs");require("../../constants/chains.constants.cjs");require("../../constants/contracts.constants.cjs");require("../../constants/kyc.constants.cjs");require("../../constants/server.constants.cjs");const t=require("../../constants/vite.constants.cjs");require("../../constants/coingecko.constants.cjs");require("../../constants/reorg-depths.constants.cjs");require("../../constants/addresses.constants.cjs");require("../../constants/token.limits.constants.cjs");require("../../constants/presale.constants.cjs");require("../../constants/mystery-boxes.constants.cjs");require("../../constants/activity.constants.cjs");require("../../constants/tasks.constants.cjs");require("../../constants/events.constants.cjs");const a=require("../../data-structures/cacheDevices/FileCacheDevice.cjs"),u=require("../../data-structures/cacheDevices/LocalStorageCacheDevice.cjs"),s=e=>{if(t.isNode){let r,c;e&&({useFileCache:r,cacheFilePath:c}=e);const i=require("path").resolve(process.cwd(),"hinkalCache.json");return new a.FileCacheDevice(r,c??i)}else return new u.LocalStorageCacheDevice(e?.disableCaching,e?.serializedCache)};exports.createCacheDevice=s;

package/functions/utils/cacheDevice.utils.d.ts

@@ -0,0 +1,3 @@
+import { type HinkalConfig } from '../../types/hinkal.types';
+import { FileCacheDevice, LocalStorageCacheDevice } from '../../data-structures/cacheDevices';
+export declare const createCacheDevice: (hinkalConfig?: HinkalConfig) => FileCacheDevice | LocalStorageCacheDevice;

package/functions/utils/cacheDevice.utils.mjs

@@ -0,0 +1,29 @@
+import "../../constants/token-data/index.mjs";
+import "../../constants/chains.constants.mjs";
+import "../../constants/contracts.constants.mjs";
+import "../../constants/kyc.constants.mjs";
+import "../../constants/server.constants.mjs";
+import { isNode as i } from "../../constants/vite.constants.mjs";
+import "../../constants/coingecko.constants.mjs";
+import "../../constants/reorg-depths.constants.mjs";
+import "../../constants/addresses.constants.mjs";
+import "../../constants/token.limits.constants.mjs";
+import "../../constants/presale.constants.mjs";
+import "../../constants/mystery-boxes.constants.mjs";
+import "../../constants/activity.constants.mjs";
+import "../../constants/tasks.constants.mjs";
+import "../../constants/events.constants.mjs";
+import { FileCacheDevice as c } from "../../data-structures/cacheDevices/FileCacheDevice.mjs";
+import { LocalStorageCacheDevice as p } from "../../data-structures/cacheDevices/LocalStorageCacheDevice.mjs";
+const x = (e) => {
+  if (i) {
+    let r, t;
+    e && ({ useFileCache: r, cacheFilePath: t } = e);
+    const o = require("path").resolve(process.cwd(), "hinkalCache.json");
+    return new c(r, t ?? o);
+  } else
+    return new p(e?.disableCaching, e?.serializedCache);
+};
+export {
+  x as createCacheDevice
+};

package/functions/utils/cacheFunctions.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("../../types/ethereum-network.types.cjs"),y=require("./getDataFromTransaction.cjs"),A=require("idb-keyval"),k={encryptedOutputs:[],lastOutput:""},o=(s,e)=>{const t=s.substring(0,25),r=e.substring(0,25);return{shortPublicKey:t,shortHinkalAddress:r}},H=(s,e,t)=>`hinkalCache-${s}-${e}-${t}`,v=(s,e,t)=>{const r=s.getContract(l.ContractType.HinkalContract).address;if(!e||!t||!r)throw Error("GetHinkalCache: incorrect arguments");const{shortPublicKey:a,shortHinkalAddress:n}=o(t,r);return JSON.parse(s.cacheDevice.get(H(e,a,n))??JSON.stringify(k))},T=(s,e,t,r)=>{const a=e.getContract(l.ContractType.HinkalContract).address;if(!t||!r||!a)throw Error("SetHinkalCache: incorrect arguments");const{shortPublicKey:n,shortHinkalAddress:c}=o(r,a);e.cacheDevice.set(H(t,n,c),JSON.stringify(s))},S=(s,e,t)=>{T(k,s,e,t)},p=(s,e,t)=>`txsCache-${s}-${e}-${t}`,f=async(s,e,t,r,a,n)=>{if(!e||!t||!r)throw Error("saveTxsCache: incorrect arguments");const{shortPublicKey:c,shortHinkalAddress:i}=o(t,r),C=y.serializeDecodedTxs(s),d=p(e,c,i),g=JSON.stringify({serializedTxs:C,lastHash:a});try{await A.set(d,g)}catch{n.cacheDevice.set(d,g)}},m={serializedTxs:[],lastHash:""},D=async(s,e,t,r)=>{if(!s||!e||!t)throw Error("loadTxsCache: incorrect arguments");const{shortPublicKey:a,shortHinkalAddress:n}=o(e,t),c=p(s,a,n);let i;try{const h=await A.get(c);if(!h)throw new Error("Empty indexedDB cache");i=h}catch{i=r.cacheDevice.get(c)}const{serializedTxs:C,lastHash:d}=JSON.parse(i??JSON.stringify(m));return{decodedTxs:C.map(h=>y.deserializeDecodedTxs(h)),lastHash:d===""?void 0:d}},u=(s,e,t)=>`hinkalApprovalsCache-${s}-${e}-${t}`,x=(s,e,t,r)=>{const a=e.getContract(l.ContractType.HinkalContract,void 0,t).address;if(!t||!r||!a)throw Error("SetHinkalCache: incorrect arguments");const{shortPublicKey:n,shortHinkalAddress:c}=o(r,a);e.cacheDevice.set(u(t,n,c),JSON.stringify(s))},O=(s,e,t)=>{const r=s.getContract(l.ContractType.HinkalContract,void 0,e).address;if(!e||!t||!r)throw Error("GetHinkalCache: incorrect arguments");const{shortPublicKey:a,shortHinkalAddress:n}=o(t,r);return JSON.parse(s.cacheDevice.get(u(e,a,n))??JSON.stringify(k))},w=(s,e,t)=>{x({},s,e,t)};exports.getFilePath=H;exports.getHinkalCache=v;exports.getInHinkalAddressesCache=O;exports.getInHinkalAddressesFilePath=u;exports.loadTxsCache=D;exports.resetCache=S;exports.resetInHinkalAddressesCache=w;exports.saveTxsCache=f;exports.setHinkalCache=T;exports.setInHinkalAddressesCache=x;