@sabaaa1/common 0.2.16

package/data-structures/tor/TorClient.mjs

@@ -0,0 +1,147 @@
+import { createSnowflakeStream as S, TorClientDuplex as E, Consensus as u } from "@hazae41/echalote";
+import { Ciphers as T, TlsClientDuplex as _ } from "@hazae41/cadenas";
+import { fetch as x } from "@hazae41/fleche";
+import { Ed25519 as C } from "@hazae41/ed25519";
+import { X25519 as b } from "@hazae41/x25519";
+import { ChaCha20Poly1305 as y } from "@hazae41/chacha20poly1305";
+import { Sha1 as O } from "@hazae41/sha1";
+import { WalletWasm as h } from "@brumewallet/wallet.wasm";
+import { WebSocketDuplex as k } from "./WebSocketDuplex.mjs";
+import { Logger as a } from "../../error-handling/logger.mjs";
+import "../../types/circom-data.types.mjs";
+import "../../types/transactions.types.mjs";
+import "../../types/activities.types.mjs";
+import { HttpMethod as P } from "../../types/routing.types.mjs";
+import { CustomJSONStringify as N } from "../../functions/utils/serialize.utils.mjs";
+import { Buffer as z } from "buffer";
+typeof globalThis.Buffer > "u" && (globalThis.Buffer = z);
+class m {
+  static initializationPromise;
+  cryptoInitialized = !1;
+  socket;
+  tor;
+  consensus;
+  abortController;
+  middles = [];
+  exits = [];
+  circuits = [];
+  circuitIndex = 0;
+  CIRCUIT_POOL_SIZE = 5;
+  TOP_RELAY_COUNT = 50;
+  static async create() {
+    return this.initializationPromise ? this.initializationPromise : (this.initializationPromise = (async () => {
+      try {
+        const i = new m();
+        return await i.initialize(), i;
+      } catch (i) {
+        throw this.initializationPromise = void 0, i;
+      }
+    })(), this.initializationPromise);
+  }
+  async initialize() {
+    await this.initializeCryptoOrThrow(), this.socket = await this.createSnowflakeSocketOrThrow(), this.tor = await this.createTorClientOrThrow(this.socket), await this.loadConsensus();
+    const i = Array(this.CIRCUIT_POOL_SIZE).fill(null).map(
+      (r, e) => this.createNewCircuit().catch((o) => (a.error(`Failed to build initial circuit ${e}`, o), null))
+    ), t = await Promise.all(i);
+    if (this.circuits = t.filter((r) => r !== null), this.circuits.length === 0)
+      throw new Error("Failed to build any circuits");
+  }
+  async initializeCryptoOrThrow() {
+    this.cryptoInitialized || (await h.initBundled(), O.set(O.fromWasm(h)), C.set(await C.fromNativeOrWasm(h)), b.set(b.fromWasm(h)), y.set(y.fromWasm(h)), this.cryptoInitialized = !0);
+  }
+  async createSnowflakeSocketOrThrow() {
+    const i = new WebSocket("wss://snowflake.torproject.net/");
+    return i.binaryType = "arraybuffer", await new Promise((t, r) => {
+      i.onopen = t, i.onerror = r;
+    }), i;
+  }
+  async createTorClientOrThrow(i) {
+    const t = new k(i), r = S(t), e = new E();
+    return this.abortController = new AbortController(), r.outer.readable.pipeTo(e.inner.writable, { signal: this.abortController.signal }).catch((o) => {
+      a.error("Pipe to Tor failed:", o);
+    }), e.inner.readable.pipeTo(r.outer.writable, { signal: this.abortController.signal }).catch((o) => {
+      a.error("Pipe to TCP failed:", o);
+    }), await e.waitOrThrow(), e;
+  }
+  async loadConsensus() {
+    if (!this.tor)
+      throw new Error("Tor client not initialized");
+    const i = await this.tor.createOrThrow();
+    if (this.consensus = await u.fetchOrThrow(i), this.middles = this.consensus.microdescs.filter(
+      (t) => t.flags.includes("Fast") && t.flags.includes("Stable") && t.flags.includes("V2Dir")
+    ), this.middles.sort((t, r) => {
+      const e = Number(t.bandwidth?.Bandwidth) || 0;
+      return (Number(r.bandwidth?.Bandwidth) || 0) - e;
+    }), this.middles = this.middles.slice(0, this.TOP_RELAY_COUNT), this.exits = this.consensus.microdescs.filter(
+      (t) => t.flags.includes("Fast") && t.flags.includes("Stable") && t.flags.includes("Exit") && !t.flags.includes("BadExit")
+    ), this.exits.sort((t, r) => {
+      const e = Number(t.bandwidth?.Bandwidth) || 0;
+      return (Number(r.bandwidth?.Bandwidth) || 0) - e;
+    }), this.exits = this.exits.slice(0, this.TOP_RELAY_COUNT), this.middles.length === 0 || this.exits.length === 0)
+      throw new Error("No suitable relays found");
+  }
+  async createNewCircuit() {
+    if (!this.tor)
+      throw new Error("Tor client not initialized");
+    const i = await this.tor.createOrThrow();
+    try {
+      const t = this.middles[Math.floor(Math.random() * this.middles.length)];
+      if (!t)
+        throw new Error("No middle relays available");
+      const r = await u.Microdesc.fetchOrThrow(i, t);
+      await i.extendOrThrow(r);
+      const e = this.exits[Math.floor(Math.random() * this.exits.length)];
+      if (!e)
+        throw new Error("No exit relays available");
+      const o = await u.Microdesc.fetchOrThrow(i, e);
+      return await i.extendOrThrow(o), i;
+    } catch (t) {
+      throw a.error("Failed to build circuit", t), t;
+    }
+  }
+  async openTlsConnectionOrThrow(i, t, r = 443) {
+    const e = await i.openOrThrow(t, r), o = [T.TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384, T.TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384], n = new _({ host_name: t, ciphers: o });
+    return e.outer.readable.pipeTo(n.inner.writable).catch(() => {
+    }), n.inner.readable.pipeTo(e.outer.writable).catch(() => {
+    }), n.outer;
+  }
+  async fetchViaTor(i, t, r, e) {
+    if (this.circuits.length === 0)
+      throw new Error("Circuit pool is empty, client may be closed or failed to init.");
+    const o = new URL(t), n = this.circuits.length;
+    let f;
+    for (let w = 0; w < n; w += 1) {
+      const c = (this.circuitIndex + w) % n, p = this.circuits[c];
+      if (p)
+        try {
+          const d = await this.openTlsConnectionOrThrow(p, o.hostname, 443), s = {
+            Host: o.hostname,
+            Connection: "keep-alive",
+            ...e
+          }, l = {
+            method: i,
+            stream: d,
+            headers: s
+          };
+          r && i !== P.GET && (l.body = typeof r == "string" ? r : N(r), !s["Content-Type"] && !s["content-type"] && (s["Content-Type"] = "application/json"));
+          const g = await x(t, l);
+          return this.circuitIndex = c, g;
+        } catch (d) {
+          f = d;
+          const s = d.message?.toLowerCase() || "";
+          a.error(`[TorClient] Circuit ${c} failed:`, s), (s.includes("circuit") || s.includes("destroyed") || s.includes("closed")) && this.createNewCircuit().then((l) => {
+            this.circuits[c] = l, a.log(`[TorClient] Replaced circuit ${c}`);
+          }).catch((l) => {
+            a.error(`[TorClient] Failed to replace circuit ${c}`, l);
+          });
+        }
+    }
+    throw new Error(`[TorClient] All ${n} circuits failed. Last error: ${f?.message || "unknown"}`);
+  }
+  async close() {
+    this.abortController && this.abortController.abort(), this.socket && (this.socket.readyState === WebSocket.OPEN || this.socket.readyState === WebSocket.CONNECTING) && this.socket.close(), this.circuits = [], this.socket = void 0, this.tor = void 0, this.consensus = void 0, this.abortController = void 0, m.initializationPromise = void 0;
+  }
+}
+export {
+  m as TorClient
+};

package/data-structures/tor/WebSocketDuplex.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("@hazae41/binary"),s=require("@hazae41/cascade");class i{duplex;constructor(t){this.duplex=new s.HalfDuplex({output:{write(e){t.send(r.Writable.writeToBytesOrThrow(e))}}}),t.addEventListener("close",()=>this.duplex.close()),t.addEventListener("error",e=>this.duplex.error(e)),t.addEventListener("message",async e=>{if(typeof e.data=="string")return;const u=new Uint8Array(e.data),n=new r.Opaque(u);this.duplex.input.enqueue(n)})}get outer(){return this.duplex.outer}}exports.WebSocketDuplex=i;

package/data-structures/tor/WebSocketDuplex.d.ts

@@ -0,0 +1,7 @@
+import { Opaque, Writable } from '@hazae41/binary';
+import { HalfDuplex } from '@hazae41/cascade';
+export declare class WebSocketDuplex {
+    readonly duplex: HalfDuplex<Opaque, Writable>;
+    constructor(socket: WebSocket);
+    get outer(): ReadableWritablePair<Opaque<Uint8Array>, Writable>;
+}

package/data-structures/tor/WebSocketDuplex.mjs

@@ -0,0 +1,25 @@
+import { Writable as u, Opaque as s } from "@hazae41/binary";
+import { HalfDuplex as o } from "@hazae41/cascade";
+class d {
+  duplex;
+  constructor(t) {
+    this.duplex = new o({
+      output: {
+        write(e) {
+          t.send(u.writeToBytesOrThrow(e));
+        }
+      }
+    }), t.addEventListener("close", () => this.duplex.close()), t.addEventListener("error", (e) => this.duplex.error(e)), t.addEventListener("message", async (e) => {
+      if (typeof e.data == "string")
+        return;
+      const r = new Uint8Array(e.data), n = new s(r);
+      this.duplex.input.enqueue(n);
+    });
+  }
+  get outer() {
+    return this.duplex.outer;
+  }
+}
+export {
+  d as WebSocketDuplex
+};

package/data-structures/tor/index.d.ts

@@ -0,0 +1,3 @@
+export * from './TorClient';
+export * from './WebSocketDuplex';
+export * from './HttpClient';

package/data-structures/transactions-manager/history/history.types.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var N=(W=>(W[W.DEPOSIT=0]="DEPOSIT",W[W.WITHDRAW=1]="WITHDRAW",W[W.SWAP=2]="SWAP",W[W.UNKNOWN=3]="UNKNOWN",W))(N||{});exports.TransactionType=N;

package/data-structures/transactions-manager/history/history.types.d.ts

@@ -0,0 +1,16 @@
+import { TokenBalance } from '../../../types';
+export declare enum TransactionType {
+    DEPOSIT = 0,
+    WITHDRAW = 1,
+    SWAP = 2,
+    UNKNOWN = 3
+}
+export interface TransactionDetails {
+    type: TransactionType;
+}
+export type HistoryTokenBalance = TokenBalance | {
+    token: {
+        erc20TokenAddress: string;
+    };
+    balance: bigint;
+};

package/data-structures/transactions-manager/history/history.types.mjs

@@ -0,0 +1,4 @@
+var N = /* @__PURE__ */ ((W) => (W[W.DEPOSIT = 0] = "DEPOSIT", W[W.WITHDRAW = 1] = "WITHDRAW", W[W.SWAP = 2] = "SWAP", W[W.UNKNOWN = 3] = "UNKNOWN", W))(N || {});
+export {
+  N as TransactionType
+};

package/data-structures/transactions-manager/index.d.ts

@@ -0,0 +1 @@
+export * from './history/history.types';

package/data-structures/utxo/Utxo.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=require("ethers"),a=require("../../constants/protocol.constants.cjs"),d=require("../../crypto/poseidon.cjs"),S=require("../../functions/web3/etherFunctions.cjs"),h=require("../crypto-keys/keys.cjs"),g=require("../../functions/utils/time.utils.cjs");class o{amount;erc20TokenAddress;timeStamp;tokenId;shieldedPrivateKey;randomization;stealthAddress;encryptionKey;commitment;nullifier;isStake;isStakeOrUnstakeInput;isUnstakeOutput;constructor({amount:t,erc20TokenAddress:e,timeStamp:s,tokenId:i,shieldedPrivateKey:n,randomization:r,stealthAddress:m,encryptionKey:u,commitment:l=void 0,nullifier:c=void 0,isStake:p=!1,isStakeOrUnstakeInput:k=!1,isUnstakeOutput:y=!1}){this.amount=t,this.erc20TokenAddress=e,this.timeStamp=s??g.getCurrentTimeInSeconds().toString(),this.tokenId=i??0,this.shieldedPrivateKey=n,this.randomization=r??o.findCorrectRandomization(S.randomBigInt(31),n),this.stealthAddress=m,this.encryptionKey=u,this.commitment=l,this.nullifier=c,this.isStake=p,this.isStakeOrUnstakeInput=k,this.isUnstakeOutput=y}static createFrom(t,e){return new o({...t.getConstructableParams(),nullifier:void 0,commitment:void 0,...e})}getConstructableParams(){return{amount:this.amount,erc20TokenAddress:this.erc20TokenAddress,timeStamp:this.timeStamp,shieldedPrivateKey:this.shieldedPrivateKey,randomization:this.randomization,stealthAddress:this.stealthAddress,encryptionKey:this.encryptionKey,tokenId:this.tokenId,commitment:this.commitment,nullifier:this.nullifier,isStake:this.isStake,isStakeOrUnstakeInput:this.isStakeOrUnstakeInput,isUnstakeOutput:this.isUnstakeOutput}}getCommitment(){if(!this.commitment){const t=[this.amount,this.erc20TokenAddress,BigInt(this.getStealthAddress()),this.timeStamp];this.tokenId>0&&t.push(this.tokenId.toString()),(this.isStake||this.isUnstakeOutput)&&t.push(0n,1n),this.commitment=d.poseidonHash(...t)}return this.commitment}getNullifier(){if(!this.nullifier){if(!this.shieldedPrivateKey)throw new Error("No Nullifiers if private key is not provided");const t=d.poseidonHash(this.shieldedPrivateKey,this.getCommitment()),e=BigInt(d.poseidonHash(this.commitment,t)),s=BigInt(this.isStakeOrUnstakeInput);this.nullifier=f.ethers.BigNumber.from(e+s).toHexString()}return this.nullifier}getStealthAddress(){if(!this.stealthAddress){if(!this.shieldedPrivateKey)throw Error("No stealth address in UTXO if private key is not provided");const t=h.UserKeys.getStealthAddress(this.randomization,this.shieldedPrivateKey);this.stealthAddress=t}return this.stealthAddress}getEncryptionKey(){if(!this.shieldedPrivateKey){if(!this.encryptionKey)throw Error("No encryption key provided in UTXO");return this.encryptionKey}return h.UserKeys.getEncryptionKeyPair(this.shieldedPrivateKey).publicKey}static findCorrectRandomization(t,e){if(!e)throw Error("No Private Shielded Key Provided");const s=BigInt(e)%a.CIRCOM_P;let i,n,r=0n;do i=t*10n**r%a.CIRCOM_P,n=i*s%a.CIRCOM_P,r+=1n;while(n>=2n**253n||i>=2n**253n);return i}}exports.Utxo=o;

package/data-structures/utxo/Utxo.d.ts

@@ -0,0 +1,63 @@
+export type IUtxoConstructor<T = bigint> = {
+    amount: T;
+    erc20TokenAddress: string;
+    timeStamp?: string;
+    shieldedPrivateKey?: string;
+    randomization?: T;
+    stealthAddress?: string;
+    encryptionKey?: string;
+    tokenId?: number;
+    isStake?: boolean;
+    isStakeOrUnstakeInput?: boolean;
+    isUnstakeOutput?: boolean;
+    commitment?: string;
+    nullifier?: string;
+};
+/**
+ * UTXO class for transactions
+ */
+export declare class Utxo {
+    amount: bigint;
+    erc20TokenAddress: string;
+    timeStamp: string;
+    tokenId: number;
+    shieldedPrivateKey?: string;
+    randomization: bigint;
+    stealthAddress?: string;
+    encryptionKey?: string;
+    commitment?: string;
+    nullifier?: string;
+    isStake: boolean;
+    isStakeOrUnstakeInput: boolean;
+    isUnstakeOutput: boolean;
+    /**
+     * creates new UTXO instance
+     * @param amount UTXO amount
+     * @param erc20TokenAddress contract address of ERC-20/ERC-721 token
+     * @param timeStamp timestamp
+     * @param tokenId tokenId
+     * @param randomization randomization parameter
+     * @param stealthAddress  stealth address as a parameter(e.g. in case of transfers we will not know private key and randomization of payee
+     * @param encryptionKey  encryption public key
+     * @param shieldedPrivateKey private key for nullification
+     * @param commitment [optional] commitment value if already computed
+     * @param nullifier [optional] nullifier value if already computed
+     */
+    constructor({ amount, erc20TokenAddress, timeStamp, tokenId, shieldedPrivateKey, randomization, stealthAddress, encryptionKey, commitment, nullifier, isStake, isStakeOrUnstakeInput, isUnstakeOutput, }: IUtxoConstructor);
+    static createFrom(utxoToCreateFrom: Utxo, patch: Partial<IUtxoConstructor>): Utxo;
+    getConstructableParams(): IUtxoConstructor;
+    /**
+     * @returns commitment hash of the UTXO instance
+     */
+    getCommitment(): string;
+    /**
+     * @returns nullifier hash of the UTXO instance
+     */
+    getNullifier(): string;
+    /**
+     * @returns stealth address from randomization and private shieldedPrivateKey
+     */
+    getStealthAddress(): string;
+    getEncryptionKey(): string;
+    static findCorrectRandomization(initialRandomization: bigint, privateKey?: string): bigint;
+}

package/data-structures/utxo/Utxo.mjs

@@ -0,0 +1,135 @@
+import { ethers as y } from "ethers";
+import { CIRCOM_P as o } from "../../constants/protocol.constants.mjs";
+import { poseidonHash as a } from "../../crypto/poseidon.mjs";
+import { randomBigInt as S } from "../../functions/web3/etherFunctions.mjs";
+import { UserKeys as h } from "../crypto-keys/keys.mjs";
+import { getCurrentTimeInSeconds as g } from "../../functions/utils/time.utils.mjs";
+class d {
+  amount;
+  erc20TokenAddress;
+  timeStamp;
+  tokenId;
+  shieldedPrivateKey;
+  // 1) if it's own UTXO one provides private key and  randomization -> computes stealth address and and eKey
+  randomization;
+  stealthAddress;
+  // 2) if it's other's utxo, stealth address and encryption key should be provided
+  encryptionKey;
+  commitment;
+  // computed
+  nullifier;
+  // computed
+  isStake;
+  isStakeOrUnstakeInput;
+  isUnstakeOutput;
+  /**
+   * creates new UTXO instance
+   * @param amount UTXO amount
+   * @param erc20TokenAddress contract address of ERC-20/ERC-721 token
+   * @param timeStamp timestamp
+   * @param tokenId tokenId
+   * @param randomization randomization parameter
+   * @param stealthAddress  stealth address as a parameter(e.g. in case of transfers we will not know private key and randomization of payee
+   * @param encryptionKey  encryption public key
+   * @param shieldedPrivateKey private key for nullification
+   * @param commitment [optional] commitment value if already computed
+   * @param nullifier [optional] nullifier value if already computed
+   */
+  constructor({
+    amount: t,
+    erc20TokenAddress: e,
+    timeStamp: s,
+    tokenId: i,
+    shieldedPrivateKey: r,
+    randomization: n,
+    stealthAddress: m,
+    encryptionKey: l,
+    commitment: u = void 0,
+    nullifier: c = void 0,
+    isStake: p = !1,
+    isStakeOrUnstakeInput: k = !1,
+    isUnstakeOutput: f = !1
+  }) {
+    this.amount = t, this.erc20TokenAddress = e, this.timeStamp = s ?? g().toString(), this.tokenId = i ?? 0, this.shieldedPrivateKey = r, this.randomization = n ?? d.findCorrectRandomization(S(31), r), this.stealthAddress = m, this.encryptionKey = l, this.commitment = u, this.nullifier = c, this.isStake = p, this.isStakeOrUnstakeInput = k, this.isUnstakeOutput = f;
+  }
+  static createFrom(t, e) {
+    return new d({
+      ...t.getConstructableParams(),
+      nullifier: void 0,
+      commitment: void 0,
+      ...e
+    });
+  }
+  getConstructableParams() {
+    return {
+      amount: this.amount,
+      erc20TokenAddress: this.erc20TokenAddress,
+      timeStamp: this.timeStamp,
+      shieldedPrivateKey: this.shieldedPrivateKey,
+      randomization: this.randomization,
+      stealthAddress: this.stealthAddress,
+      encryptionKey: this.encryptionKey,
+      tokenId: this.tokenId,
+      commitment: this.commitment,
+      nullifier: this.nullifier,
+      isStake: this.isStake,
+      isStakeOrUnstakeInput: this.isStakeOrUnstakeInput,
+      isUnstakeOutput: this.isUnstakeOutput
+    };
+  }
+  /**
+   * @returns commitment hash of the UTXO instance
+   */
+  getCommitment() {
+    if (!this.commitment) {
+      const t = [this.amount, this.erc20TokenAddress, BigInt(this.getStealthAddress()), this.timeStamp];
+      this.tokenId > 0 && t.push(this.tokenId.toString()), (this.isStake || this.isUnstakeOutput) && t.push(0n, 1n), this.commitment = a(...t);
+    }
+    return this.commitment;
+  }
+  /**
+   * @returns nullifier hash of the UTXO instance
+   */
+  getNullifier() {
+    if (!this.nullifier) {
+      if (!this.shieldedPrivateKey)
+        throw new Error("No Nullifiers if private key is not provided");
+      const t = a(this.shieldedPrivateKey, this.getCommitment()), e = BigInt(a(this.commitment, t)), s = BigInt(this.isStakeOrUnstakeInput);
+      this.nullifier = y.BigNumber.from(e + s).toHexString();
+    }
+    return this.nullifier;
+  }
+  /**
+   * @returns stealth address from randomization and private shieldedPrivateKey
+   */
+  getStealthAddress() {
+    if (!this.stealthAddress) {
+      if (!this.shieldedPrivateKey)
+        throw Error("No stealth address in UTXO if private key is not provided");
+      const t = h.getStealthAddress(this.randomization, this.shieldedPrivateKey);
+      this.stealthAddress = t;
+    }
+    return this.stealthAddress;
+  }
+  getEncryptionKey() {
+    if (!this.shieldedPrivateKey) {
+      if (!this.encryptionKey)
+        throw Error("No encryption key provided in UTXO");
+      return this.encryptionKey;
+    }
+    return h.getEncryptionKeyPair(this.shieldedPrivateKey).publicKey;
+  }
+  static findCorrectRandomization(t, e) {
+    if (!e)
+      throw Error("No Private Shielded Key Provided");
+    const s = BigInt(e) % o;
+    let i, r, n = 0n;
+    do
+      i = t * 10n ** n % o, r = i * s % o, n += 1n;
+    while (r >= 2n ** 253n || i >= 2n ** 253n);
+    return i;
+  }
+}
+export {
+  d as Utxo
+};

package/error-handling/customErrors/ErrorWithAmount.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class o extends Error{amount;constructor(r,t){super(t),this.amount=r}}exports.ErrorWithAmount=o;

package/error-handling/customErrors/ErrorWithAmount.d.ts

@@ -0,0 +1,4 @@
+export declare class ErrorWithAmount extends Error {
+    amount: number;
+    constructor(providedAmount: number, message: string);
+}

package/error-handling/customErrors/ErrorWithAmount.mjs

@@ -0,0 +1,9 @@
+class s extends Error {
+  amount;
+  constructor(r, t) {
+    super(t), this.amount = r;
+  }
+}
+export {
+  s as ErrorWithAmount
+};

package/error-handling/customErrors/ErrorWithTx.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class e extends Error{tx;constructor(r,t){super(r),this.tx=t}}exports.ErrorWithRelayerTransaction=e;

package/error-handling/customErrors/ErrorWithTx.d.ts

@@ -0,0 +1,5 @@
+import { RelayerTransaction } from '../../types/relayer.types';
+export declare class ErrorWithRelayerTransaction extends Error {
+    tx: RelayerTransaction | undefined;
+    constructor(message: string, tx: RelayerTransaction | undefined);
+}

package/error-handling/customErrors/ErrorWithTx.mjs

@@ -0,0 +1,9 @@
+class e extends Error {
+  tx;
+  constructor(r, t) {
+    super(r), this.tx = t;
+  }
+}
+export {
+  e as ErrorWithRelayerTransaction
+};

package/error-handling/customErrors/FeeOverTransactionValueError.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../error-codes.constants.cjs");class t extends Error{constructor(r){super(e.transactionErrorCodes.FEES_OVER_TRANSACTION_VALUE),this.data=r,this.name=this.constructor.name}}exports.FeeOverTransactionValueError=t;

package/error-handling/customErrors/FeeOverTransactionValueError.d.ts

@@ -0,0 +1,9 @@
+import { ERC20Token } from '../../types';
+export interface FeeOverTransactionValueErrorData {
+    totalFeeWEI: bigint;
+    feeUnit: ERC20Token | undefined;
+}
+export declare class FeeOverTransactionValueError extends Error {
+    data: FeeOverTransactionValueErrorData;
+    constructor(data: FeeOverTransactionValueErrorData);
+}

package/error-handling/customErrors/FeeOverTransactionValueError.mjs

@@ -0,0 +1,9 @@
+import { transactionErrorCodes as t } from "../error-codes.constants.mjs";
+class e extends Error {
+  constructor(r) {
+    super(t.FEES_OVER_TRANSACTION_VALUE), this.data = r, this.name = this.constructor.name;
+  }
+}
+export {
+  e as FeeOverTransactionValueError
+};

package/error-handling/customErrors/SimulationFailureError.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class e extends Error{errorStructure;constructor(r){super(r.error),this.errorStructure=r,this.name=this.constructor.name}}exports.SimulationFailureError=e;

package/error-handling/customErrors/SimulationFailureError.d.ts

@@ -0,0 +1,10 @@
+export declare class SimulationFailureError extends Error {
+    errorStructure: {
+        error: string;
+        errorReason: string;
+    };
+    constructor(data: {
+        error: string;
+        errorReason: string;
+    });
+}

package/error-handling/customErrors/SimulationFailureError.mjs

@@ -0,0 +1,9 @@
+class e extends Error {
+  errorStructure;
+  constructor(r) {
+    super(r.error), this.errorStructure = r, this.name = this.constructor.name;
+  }
+}
+export {
+  e as SimulationFailureError
+};

package/error-handling/customErrors/customErrors.helpers.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("../../functions/utils/amounts.utils.cjs"),c=require("../../functions/web3/etherFunctions.cjs"),u=require("../error-codes.constants.cjs"),l=require("../types.cjs"),T=require("./FeeOverTransactionValueError.cjs"),f=(e,r)=>{const{totalFeeWEI:s,feeUnit:t}=e.data;if(!t)return e.message;const a=c.getAmountInToken(t,s);let o="transact",n="an equivalent of ";return r===l.ErrorCategory.WITHDRAW&&(o="withdraw",n=""),`Fees are over transaction value. Please ${o} at least ${n} ${i.fixDecimalsAmount(Number(a))} of ${t?.symbol} (subject to real-time price)`},E=(e,r)=>{throw e instanceof T.FeeOverTransactionValueError||e?.message===u.transactionErrorCodes.INSUFFICIENT_FUNDS_TO_TRANSACT?e:Error(r)};exports.getGenericFeeOverTransactionValueErrorMessage=f;exports.rethrowKnownGasErrorIfPossible=E;

package/error-handling/customErrors/customErrors.helpers.d.ts

@@ -0,0 +1,5 @@
+import { ErrorCategory } from '../types';
+import { FeeOverTransactionValueError } from './FeeOverTransactionValueError';
+export declare const getGenericFeeOverTransactionValueErrorMessage: (error: FeeOverTransactionValueError, type?: ErrorCategory) => string;
+/** If the error is a known gas err type, rethrow it, otherwise throw a new Error */
+export declare const rethrowKnownGasErrorIfPossible: (err: unknown, fallbackErrorMsg: string) => never;

package/error-handling/customErrors/customErrors.helpers.mjs

@@ -0,0 +1,21 @@
+import { fixDecimalsAmount as i } from "../../functions/utils/amounts.utils.mjs";
+import { getAmountInToken as m } from "../../functions/web3/etherFunctions.mjs";
+import { transactionErrorCodes as f } from "../error-codes.constants.mjs";
+import { ErrorCategory as c } from "../types.mjs";
+import { FeeOverTransactionValueError as l } from "./FeeOverTransactionValueError.mjs";
+const v = (e, r) => {
+  const { totalFeeWEI: n, feeUnit: t } = e.data;
+  if (!t)
+    return e.message;
+  const s = m(t, n);
+  let o = "transact", a = "an equivalent of ";
+  return r === c.WITHDRAW && (o = "withdraw", a = ""), `Fees are over transaction value. Please ${o} at least ${a} ${i(
+    Number(s)
+  )} of ${t?.symbol} (subject to real-time price)`;
+}, F = (e, r) => {
+  throw e instanceof l || e?.message === f.INSUFFICIENT_FUNDS_TO_TRANSACT ? e : Error(r);
+};
+export {
+  v as getGenericFeeOverTransactionValueErrorMessage,
+  F as rethrowKnownGasErrorIfPossible
+};

package/error-handling/customErrors/index.d.ts

@@ -0,0 +1,5 @@
+export * from './ErrorWithAmount';
+export * from './FeeOverTransactionValueError';
+export * from './customErrors.helpers';
+export * from './SimulationFailureError';
+export * from './ErrorWithTx';

package/error-handling/error-codes.constants.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s={CANNOT_CERTIFY_FOR_PAST_WEEK:"Certification for the past week is not available",CYCLICAL_REFERRALS_FORBIDDEN:"Cyclical referrals are forbidden",USER_IS_UNRANKED:"Please certify transactions to see rank"},r={WC_NO_MATCHING_KEY:`creating the transaction failed
+version`},n={WC_INVALID_URI:"Invalid WalletConnect URI. Please, try again",WC_PAIRINNG_ERROR:"Pairing failed. Check your code and retry"},a={INSUFFICIENT_FUNDS:"Insufficient funds",INSUFFICIENT_FUNDS_WITHDRAW:"Not enough funds to withdraw",INSUFFICIENT_FUNDS_TRANSFER:"Not enough funds to transfer",INSUFFICIENT_FUNDS_TO_TRANSACT:"Not enough funds to transact",INSUFFICIENT_FUNDS_GAS:"Insufficient funds for gas * price"},t={GAS_PRICE_EXCEEDS_AUTOSHIELD_LIMIT:"Gas prices too high to autoshield"},o={...s,...r,...a,...t,SOME_ERROR:"Some error has occurred. Please try again in a few minutes. If the issue persists, please report it in Discord",TOO_HIGH_AMOUNT:"ApproxParamsInvalid",NOT_ENOUGH_TOKENS:"Transfer amount exceeds balance",TRANSACTION_NOT_CONFIRMED:"The transaction was not confirmed by the network. Please, try again",RPC_PROVIDER_LIMIT_ERROR:"Non-200 status code: '429'",RELAYER_NOT_AVAILABLE:"All relayers are busy, please try in a few seconds",TRANSACTION_TIMEOUT:"Your transaction got stale. Please, try in a few seconds",CONNECT_ERROR:"Connection error",CONNECT_ERROR2:"DOMException: Failed",USER_REJECTED_TX:"Transaction rejected",USER_REJECTED_SIGN:"User rejected signing",USER_REJECTED_TRANSACTION:"user rejected transaction",USER_REJECTED_SIGN2:"User rejected the request",SIGNING_FAILED:"The signing failed. Please, try again",SIGNATURE_UNSUPPORTED_CHAINS:"Details: Unsupported chains",SIGNATURE_UNSUPPORTED_CHAINS2:"User disapproved requested chains",SIGNATURE_REQUEST_EXPIRED:"Request expired. Please try again",SIGNATURE_UNSUPPORTED_PERSONAL_SIGN:"The method personal_sign does not exist",USER_DISAPPROVED_REQUESTED_METHODS:"User disapproved requested methods",INVALID_AUTHORIZATION:"The requested account and/or method has not been authorized by the user",INVALID_NULLIFIER:"Nullifier cannot be reused",SANCTIONED_ADDRESS:"Address is sanctioned",INVALID_AMOUNT:"Please, select correct amount",RECIPIENT_FORMAT_INCORRECT:"Recipient Information format is incorrect",INVALID_TOKEN:"Invalid token provided",STATE_TO_UPDATE:"Error in template Verifier_219 line: 121",HAS_TOKEN:"User already has an access token",INVALID_RECEIVER:"Receiver address doesn't match",INVALID_RELAYER:"Relayer address doesn't match",INVALID_RELAYER_FEE:"Relayer fee amount doesn't match",TIMESTAMP_STALE:"Timestamp provided does not align with current time",INVALID_ZKP:"Proof must be valid",NO_TRANSACTIONS_TO_CERTIFY:"This week, you do not have transactions to certify",RECIPIENT_AMOUNT_INVALID:"Recipient amount is invalid",UNSUPPORTED_NETWORK:"Unsupported network: please choose Polygon, BNB Chain",SIG_BY_OWNER:"Signature must be signed by the owner of the contract",AMOUNT_EMPTY:"Please, specify amount",UNVERIFIED_USER:"Please, pass KYC verification",RELAYER_ISSUE:"Relayer has some issues. Try again later",RELAYER_GAS_ESTIMATE:"Relayer was not able to estimate the gas costs of tx. Please, try later",RECEIVER_EMPTY:"Please, enter recipient address",VALID_ETHEREUM_ADDRESS:"Please, input valid ethereum address",METAMASK_NOT_INSTALLED:"Please, install Metamask Wallet",VIABLE_TX:"The transaction is not viable. Please increase the swap amount to swap with Relayer",TRANSACTION_REPLACED:"transaction was replaced",TRANSACTION_REPLACED2:"replacement fee too low",TRANSACTION_CANCELED:"Transaction was cancelled. Please try again",NONCE_HIGH:"Nonce too high",WALLET_CONNECT_MATCHING_KEYS:"No matching key. keychain",UNKNOWN_PROVIDER:"Unknown provider",SAFE_ERC:"SafeERC20: low-level call failed",SAFE_ERC_APPROVE:"SafeERC20: approve from non-zero to non-zero allowance",SWAP_RELAYER_MIN:"Relayer minimum fee is not satisfied",LOW_LEVEL_CALL:"low-level delegate call failed",INTEGRAL_CURVE_ZERO:"previous integral cannot be zero",ODOS_FETCH:"Odos API Fetch Error",YOU_CANCELED_REQUEST:"You canceled the request",SLIPPAGE_LIMIT:"Slippage Limit Exceeded",SLIPPAGE_LIMIT_1:"Slippage screwed you",QUOTE_EXPIRED:"Quote has expired",REVERT_NO_STRING:"Transaction reverted without a reason string",UNISWAP_NOT_ENOUGH_LIQUIDITY:"Not Enough Liquidity",CONNECTION_FAILED:"Failed to connect",FAILED_TO_SWITCH_NETWORKS:"Failed to switch network, Please switch networks using your wallet's settings",INVALID_FROM:"Invalid from token",INVALID_TO:"Invalid to token",Invalid_Password:"Invalid password",INTERNAL_ERROR:"Internal error: please, try again",INVALID_MERKLE_ROOT:"Invalid merkle tree root",ACCESS_TOKEN_INVALID_HASH:"Access Token not minted",MERLE_TREE_SNARK:"Error in template ForceEqualIfEnabled",ERROR_MESSAGE_CHAIN_ADDRESS_CHANGED:"Chain/address changed: balance updated canceled",DECIMALS_LIMIT:"Number of decimals exceed maximum",MERKLE_TREE_INCOMPLETE:"Merkle tree is incomplete",FAIL_ESTIMATE_GAS:"Failed to estimate gas: check the transaction parameters",ODOS_SWAP_FAILED:"Odos swap call failed",ONEINCH_SWAP_FAILED:"One inch swap failed",GAS_ESTIMATION_ERROR:"Failed Gas Estimates Response",GAS_ESTIMATE_INCORRECT_PARAMETERS:"Incorrect Parameters for Gas Estimate",CONNECTIVITY_ERROR:"Request failed with status code 500",TRANSACTION_FAILED:"Transaction Failed: Revert",NO_UNISWAP_PRICE:"Cannot get Uniswap Price",NO_ODOS_PRICE:"Cannot get Odos Price",NO_ONEINCH_PRICE:"Cannot get OneInch Price",NO_LIFI_PRICE:"Cannot get LiFi Price",FEES_OVER_TRANSACTION_VALUE:"Fees are over transaction value. Please, increase the amount",GAS_STATION_NOT_AVAILABLE:"Gas Station Not Available",INBALANCE_IN_TOKEN:"Inbalance in token detected",BALANCE_EQUATION_FAILED:"Balance Diff Should be equal to sum of onchain and offchain created commitments",TOKEN_ADD_ERROR:"Error occoured while adding token. Please make sure you are adding a valid ERC-20 token",CANNOT_ESTIMATE_GAS:"transaction may require manual gas limit",NETWORK_ERROR:"Network Error",MAX_FEE_GAS_ERROR:"max fee per gas less than block base fee",CORS_ERROR:"has been blocked by CORS policy",CANNOT_ESTIMATE_GAS2:"transaction may fail or may require manual gas limit",NO_RESPONSE_PRIVATE:"No resonse from private relay",TRY_AGAIN_AFTER_TRANSACTION:"Please, try again",ALREADY_SUBSCRIBED:"User Already Subscribed",PREFERRED_TOKEN_OR_ADDRESS_MISSING:"Please, specify both the preferred token and public wallet address",SNAPSHOT_FILE_NOT_FOUND:"We are updating our servers. Please try again in some time",SAME_ADDRESS_FORBIDDEN:"You cannot recieve staked tokens on the same ethereum address",NOT_VALID_ETHEREUM_ADDRESS:"Please enter a valid Ethereum address",MUST_STAKE_AT_LEAST_ONE_ETH:"Amount too low, Please stake at least 1 ETH",OUT_OF_MEMORY:"Out of memory: Cannot allocate Wasm memory",OUT_OF_MEMORY2:"could not allocate memory",OUT_OF_MEMORY3:"out of memory",UNKNOWN:"Unknown error",SANDBOX_WRONG_REQUEST:"The requested Transaction type is not supported"},e="Not enough memory. Please, close some tabs/applications to free up memory and try again",i={USER_REJECTED_TRANSACTION:"You cancelled the transaction",SOME_ERROR:"Some error has occurred. Please try again in a few minutes. If the issue persists, please report it in Discord",TOO_HIGH_AMOUNT:"The amount you provided is too high, please adjust the amount",WC_NO_MATCHING_KEY:"Wallet Connect error. Please, try again",RPC_PROVIDER_LIMIT_ERROR:"Rate Limit: please, use different rpc provider in your wallet",INSUFFICIENT_FUNDS_GAS:"Your balance is too low to cover the transaction fees. Please add funds to proceed",INVALID_NULLIFIER:"There seems to be an issue with syncing your balance. Please press the refresh icon next to your shielded balance",STATE_TO_UPDATE:"A technical issue has occurred. Please create a ticket on Hinkal discord server",INVALID_ZKP:"The Zero Knowledge Proof provided is invalid. Please check and try again",NONCE_HIGH:"To resolve this issue, please reset your wallet in the Settings",UNKNOWN_PROVIDER:"The provider is not recognized. Please check your settings",TRANSACTION_REPLACED:"Your transaction was replaced by another. Please submit your transaction again",TRANSACTION_REPLACED2:"This transaction was replaced. Please try submitting again",TRANSACTION_TIMEOUT:"Your transaction got stale. Please, try in a few seconds",SAFE_ERC:"The selected ERC20 Token could not be transferred. Please contact the Hinkal support team",SIMULATION_FAILED:"Transaction failed during simulation:",SAFE_ERC_APPROVE:"The selected ERC20 Token could not be approved. Please contact the Hinkal support team",INTEGRAL_CURVE_ZERO:"There's an issue with the pool's staking function. Please contact the Hinkal support team for assistance",LOW_LEVEL_CALL:"A technical issue occurred. Please contact the Hinkal team for assistance",YOU_CANCELED_REQUEST:"You canceled the request",USER_REJECTED_SIGN2:"You canceled the request",ODOS_FETCH:"Current Odos price is unavailable. Please try again",ODOS_SWAP_FAILED:"Your Odos Swap transaction didn’t go through. Please try again",ONEINCH_SWAP_FAILED:"Your 1inch Swap transaction didn’t go through. Please try again",CONNECT_ERROR2:"Oops, there are connectivity issues. Please check your internet connection and try again",WALLET_CONNECT_MATCHING_KEYS:"An internal WalletConnect error occurred. Please try reconnecting",SIGNATURE_UNSUPPORTED_CHAINS:"The transaction couldn’t be signed: this network is not supported",SIGNATURE_UNSUPPORTED_CHAINS2:"The transaction couldn’t be signed: this network is not supported",SIGNATURE_UNSUPPORTED_PERSONAL_SIGN:"Your active wallet doesn't support personal signatures. Please use a different wallet",REVERT_NO_STRING:"Your transaction didn’t go through due to technical issues. Please submit a ticket on Hinkal discord server",INVALID_MERKLE_ROOT:"There's an issue with the merkle tree root. Please submit a ticket on Hinkal discord server",MERLE_TREE_SNARK:"An error occurred in the circuit processing. Please submit a ticket on Hinkal discord server",MAX_FEE_GAS_ERROR:"Your transaction was rejected due to high network congestion",MERKLE_TREE_INCOMPLETE:"A technical issue has occurred. Please submit a ticket on Hinkal discord server",CORS_ERROR:"Unable to reach the remote client. Please submit a ticket on Hinkal discord server",NETWORK_ERROR:"Connection error. Please, check back later",CONNECTIVITY_ERROR:"A connectivity issue occurred. Please check your network connection",INBALANCE_IN_TOKEN:"Your transaction didn’t go through due to price slippage. Try increasing your slippage tolerance",BALANCE_EQUATION_FAILED:"There's an issue with the balance calculation. Please adjust your transaction parameters",SLIPPAGE_LIMIT_1:"Your transaction didn’t go through due to price slippage. Adjust slippage settings and retry",CANNOT_ESTIMATE_GAS:"Unable to estimate the gas required. Please set the gas limit manually",CANNOT_ESTIMATE_GAS2:"Your transaction didn’t go through. Please try setting gas limit manually",GAS_STATION_NOT_AVAILABLE:"The Gas Station service is currently unavailable. Please submit a ticket on Hinkal discord server",TIMESTAMP_STALE:"This transaction is outdated. Please initiate a new transaction",ALREADY_SUBSCRIBED:"This email is already subscribed to the Hinkal newsletter",OUT_OF_MEMORY:e,OUT_OF_MEMORY2:e,OUT_OF_MEMORY3:e,INVALID_RECOVERY_PHRASE:"Invalid recovery phrase",PHRASES_DONT_MATCH:"Phrases do not match. You can always go back and check!",PASSWORDS_DONT_MATCH:"Passwords do not match",PASSWORD_SAME_AS_OLD:"Password cannot be the same as the old one",PASSWORD_TOO_SMALL:"Password must be at least 8 characters",PASSWORD_NOT_CORRECT:"Incorrect current password",CODE_ALREADY_USED:"This code has already been used",ACCESS_CODE_REQUIRED:"Access code is required",ACCESS_CODE_IS_ALREADY_IN_USE:"Access code is already in use",ACCESS_CODE_IS_ALREADY_IN_USE1:"Access code already in use. Import or connect existing wallet",ERROR_DURING_PHRASE_CONFIRMATION:"Error during Phrase confirmation"};exports.UserFriendlyErrorCodes=i;exports.gasErrorCodes=t;exports.insufficientResourcesErrorCodes=a;exports.transactionErrorCodes=o;exports.walletConnectErrorCodes=n;