@gurge/sdk 0.2.32

package/data-structures/WalletManager/WalletManager.mjs

@@ -0,0 +1,99 @@
+import { evmHexToTronBase58Address as e } from "../../functions/utils/tron.utils.mjs";
+import { hmacSha512 as t } from "../../functions/web3/crypto.mjs";
+import { HDNodeWallet as n, Mnemonic as r, Wallet as i, ethers as a } from "ethers";
+import { Keypair as o } from "@solana/web3.js";
+import s from "bs58";
+import { mnemonicToSeedSync as c } from "bip39";
+//#region libs/shared/common/src/data-structures/WalletManager/WalletManager.ts
+var l = class {
+	mainWallet = null;
+	tronMainWallet = null;
+	mnemonicPhrase = null;
+	ethDerivationBasePath = "m/44'/60'/0'";
+	tronDerivationBasePath = "m/44'/195'/0'";
+	generateMnemonic(e = 12) {
+		let t = e === 24 ? 32 : 16;
+		return r.fromEntropy(a.randomBytes(t)).phrase.split(" ");
+	}
+	isValidMnemonic(e) {
+		return r.isValidMnemonic(e);
+	}
+	isValidWord(e) {
+		return a.wordlists.en.getWordIndex(e.toLowerCase()) !== -1;
+	}
+	createEvmWallet(e) {
+		if (!this.mainWallet) throw Error("Main wallet not initialized. Call createMainWallet first.");
+		let t = new i(this.mainWallet.derivePath(`0/${e}`).privateKey);
+		return {
+			address: t.address,
+			privateKey: t.privateKey
+		};
+	}
+	createTronWallet(t) {
+		if (!this.tronMainWallet) throw Error("Main wallet not initialized. Call createMainWallet first.");
+		let n = new i(this.tronMainWallet.derivePath(`0/${t}`).privateKey);
+		return {
+			address: e(n.address),
+			privateKey: n.privateKey
+		};
+	}
+	async createSolanaAccount(e = 0) {
+		if (!this.mnemonicPhrase) throw Error("Main wallet not initialized. Call createMainWallet first.");
+		let t = c(this.mnemonicPhrase, ""), n = `m/44'/501'/${e}'/0'`, r = await this.deriveEd25519Path(n, new Uint8Array(t)), i = o.fromSeed(r);
+		return {
+			publicKey: i.publicKey.toBase58(),
+			secretKey: s.encode(i.secretKey)
+		};
+	}
+	async createChildWallet(e) {
+		let t = this.createEvmWallet(e), n = this.createTronWallet(e), r = await this.createSolanaAccount(e);
+		return {
+			ethereum: {
+				address: t.address,
+				privateKey: t.privateKey
+			},
+			tron: {
+				address: n.address,
+				privateKey: n.privateKey
+			},
+			solana: {
+				publicKey: r.publicKey,
+				secretKey: r.secretKey
+			}
+		};
+	}
+	async deriveEd25519Path(e, n) {
+		let r = e.split("/").slice(1).map((e) => {
+			let t = e.endsWith("'"), n = parseInt(e.replace("'", ""), 10);
+			return t ? n + 2147483648 : n;
+		}), i = await t("ed25519 seed", n), a = i.slice(0, 32), o = i.slice(32);
+		for (let e of r) {
+			let n = new Uint8Array(37);
+			n[0] = 0, n.set(a, 1), new DataView(n.buffer).setUint32(33, e, !1);
+			let r = await t(o, n);
+			a = r.slice(0, 32), o = r.slice(32);
+		}
+		return a;
+	}
+	async createMainWallet(e) {
+		if (!this.isValidMnemonic(e)) throw Error("Invalid mnemonic phrase");
+		this.mnemonicPhrase = e, this.mainWallet = n.fromPhrase(e, "", this.ethDerivationBasePath), this.tronMainWallet = n.fromPhrase(e, "", this.tronDerivationBasePath);
+		let { ethereum: t, tron: r, solana: i } = await this.createChildWallet(0);
+		return {
+			ethereum: {
+				address: t.address,
+				privateKey: t.privateKey
+			},
+			tron: {
+				address: r.address,
+				privateKey: r.privateKey
+			},
+			solana: {
+				publicKey: i.publicKey,
+				secretKey: i.secretKey
+			}
+		};
+	}
+};
+//#endregion
+export { l as WalletManager };

package/data-structures/WalletManager/index.cjs

@@ -0,0 +1 @@
+require(`./WalletManager.cjs`);

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

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

package/data-structures/WalletManager/index.mjs

@@ -0,0 +1 @@
+import "./WalletManager.mjs";

package/data-structures/cacheDevices/AttachableMemoryCacheDevice.cjs

@@ -0,0 +1 @@
+const e=require(`../../functions/utils/serialize.utils.cjs`),t=require(`./BaseCacheDevice.cjs`);var n=class extends t.BaseCacheDevice{isAttached=!1;get(e){return this.getInMemory(e)}set(e,t){this.setInMemory(e,t)}serialize(){return Object.fromEntries([...this.inMemoryCache].map(([t,n])=>[t,e.CustomJSONStringify(n)]))}attach(t){if(this.isAttached)throw Error(`can't reattach cache device`);return this.isAttached=!0,(...n)=>{let r=e.CustomJSONStringify(n),i=this.get(r);if(i!==void 0)return i;let a=t(...n);return this.set(r,a),a}}};exports.AttachableMemoryCacheDevice=n;

package/data-structures/cacheDevices/AttachableMemoryCacheDevice.d.ts

@@ -0,0 +1,8 @@
+import { BaseCacheDevice } from './BaseCacheDevice';
+export declare class AttachableMemoryCacheDevice<T> extends BaseCacheDevice<T> {
+    private isAttached;
+    get(key: string): T | undefined;
+    set(key: string, value: T): void;
+    serialize(): Record<string, string>;
+    attach<ArgsType extends unknown[]>(func: (...args: ArgsType) => T): (...args: ArgsType) => T;
+}

package/data-structures/cacheDevices/AttachableMemoryCacheDevice.mjs

@@ -0,0 +1,26 @@
+import { CustomJSONStringify as e } from "../../functions/utils/serialize.utils.mjs";
+import { BaseCacheDevice as t } from "./BaseCacheDevice.mjs";
+//#region libs/shared/common/src/data-structures/cacheDevices/AttachableMemoryCacheDevice.ts
+var n = class extends t {
+	isAttached = !1;
+	get(e) {
+		return this.getInMemory(e);
+	}
+	set(e, t) {
+		this.setInMemory(e, t);
+	}
+	serialize() {
+		return Object.fromEntries([...this.inMemoryCache].map(([t, n]) => [t, e(n)]));
+	}
+	attach(t) {
+		if (this.isAttached) throw Error("can't reattach cache device");
+		return this.isAttached = !0, (...n) => {
+			let r = e(n), i = this.get(r);
+			if (i !== void 0) return i;
+			let a = t(...n);
+			return this.set(r, a), a;
+		};
+	}
+};
+//#endregion
+export { n as AttachableMemoryCacheDevice };

package/data-structures/cacheDevices/BaseCacheDevice.cjs

@@ -0,0 +1 @@
+const e=require(`../../functions/utils/serialize.utils.cjs`);var t=class{inMemoryCache=new Map;constructor(e){e&&this.mergeWithSerialized(e)}getInMemory(e){return this.inMemoryCache.get(e)??void 0}setInMemory(e,t){this.inMemoryCache.set(e,t)}mergeWithSerialized(t){Object.entries(t).forEach(([t,n])=>{this.set(t,e.CustomJSONParse(n))})}};exports.BaseCacheDevice=t;

package/data-structures/cacheDevices/BaseCacheDevice.d.ts

@@ -0,0 +1,11 @@
+import { ICacheDevice } from '../../types/ICacheDevice';
+export declare abstract class BaseCacheDevice<T = string> implements ICacheDevice<T> {
+    protected inMemoryCache: Map<string, T>;
+    constructor(serialized?: Record<string, string>);
+    protected getInMemory(key: string): T | undefined;
+    protected setInMemory(key: string, value: T): void;
+    abstract get(key: string): T | undefined;
+    abstract set(key: string, value: T): void;
+    abstract serialize(): Record<string, string>;
+    mergeWithSerialized(serialized: Record<string, string>): void;
+}

package/data-structures/cacheDevices/BaseCacheDevice.mjs

@@ -0,0 +1,21 @@
+import { CustomJSONParse as e } from "../../functions/utils/serialize.utils.mjs";
+//#region libs/shared/common/src/data-structures/cacheDevices/BaseCacheDevice.ts
+var t = class {
+	inMemoryCache = /* @__PURE__ */ new Map();
+	constructor(e) {
+		e && this.mergeWithSerialized(e);
+	}
+	getInMemory(e) {
+		return this.inMemoryCache.get(e) ?? void 0;
+	}
+	setInMemory(e, t) {
+		this.inMemoryCache.set(e, t);
+	}
+	mergeWithSerialized(t) {
+		Object.entries(t).forEach(([t, n]) => {
+			this.set(t, e(n));
+		});
+	}
+};
+//#endregion
+export { t as BaseCacheDevice };

package/data-structures/cacheDevices/FileCacheDevice.cjs

@@ -0,0 +1 @@
+const e=require(`../../functions/utils/serialize.utils.cjs`),t=require(`./BaseCacheDevice.cjs`),n=require(`../../error-handling/logError.cjs`);var r=class extends t.BaseCacheDevice{filePath;useFileCache;constructor(e,t){super(),this.useFileCache=!!e,this.filePath=t,this.readFileFromDevice()}readFileFromDevice(){if(this.useFileCache&&this.filePath)try{let e=require(`fs`);if(e.existsSync(this.filePath)){let t=JSON.parse(e.readFileSync(this.filePath).toString());Object.entries(t).forEach(([e,t])=>{this.setInMemory(e,t)})}}catch(e){n.logError(`FileCacheDevice Constructor Error`,{err:e})}}get(e){return this.getInMemory(e)}set(t,r){if(this.readFileFromDevice(),this.setInMemory(t,r),this.useFileCache&&this.filePath)try{require(`fs`).writeFileSync(this.filePath,e.safeJsonStringify(Object.fromEntries(this.inMemoryCache)))}catch(e){n.logError(`FileCacheDevice set function`,{err:e})}}serialize(){return Object.fromEntries([...this.inMemoryCache].map(([t,n])=>[t,e.CustomJSONStringify(n)]))}};exports.FileCacheDevice=r;

package/data-structures/cacheDevices/FileCacheDevice.d.ts

@@ -0,0 +1,10 @@
+import { BaseCacheDevice } from './BaseCacheDevice';
+export declare class FileCacheDevice extends BaseCacheDevice {
+    private filePath;
+    private useFileCache;
+    constructor(useFileCache: boolean | undefined, filePath: string);
+    private readFileFromDevice;
+    get(key: string): string | undefined;
+    set(key: string, value: string): void;
+    serialize(): Record<string, string>;
+}

package/data-structures/cacheDevices/FileCacheDevice.mjs

@@ -0,0 +1,40 @@
+import { __require as e } from "../../_virtual/_rolldown/runtime.mjs";
+import { CustomJSONStringify as t, safeJsonStringify as n } from "../../functions/utils/serialize.utils.mjs";
+import { BaseCacheDevice as r } from "./BaseCacheDevice.mjs";
+import { logError as i } from "../../error-handling/logError.mjs";
+//#region libs/shared/common/src/data-structures/cacheDevices/FileCacheDevice.ts
+var a = class extends r {
+	filePath;
+	useFileCache;
+	constructor(e, t) {
+		super(), this.useFileCache = !!e, this.filePath = t, this.readFileFromDevice();
+	}
+	readFileFromDevice() {
+		if (this.useFileCache && this.filePath) try {
+			let t = e("fs");
+			if (t.existsSync(this.filePath)) {
+				let e = JSON.parse(t.readFileSync(this.filePath).toString());
+				Object.entries(e).forEach(([e, t]) => {
+					this.setInMemory(e, t);
+				});
+			}
+		} catch (e) {
+			i("FileCacheDevice Constructor Error", { err: e });
+		}
+	}
+	get(e) {
+		return this.getInMemory(e);
+	}
+	set(t, r) {
+		if (this.readFileFromDevice(), this.setInMemory(t, r), this.useFileCache && this.filePath) try {
+			e("fs").writeFileSync(this.filePath, n(Object.fromEntries(this.inMemoryCache)));
+		} catch (e) {
+			i("FileCacheDevice set function", { err: e });
+		}
+	}
+	serialize() {
+		return Object.fromEntries([...this.inMemoryCache].map(([e, n]) => [e, t(n)]));
+	}
+};
+//#endregion
+export { a as FileCacheDevice };

package/data-structures/cacheDevices/LocalStorageCacheDevice.cjs

@@ -0,0 +1 @@
+const e=require(`../../functions/utils/serialize.utils.cjs`),t=require(`./BaseCacheDevice.cjs`);var n=class extends t.BaseCacheDevice{localDataStorage;constructor(e,t){super(),!e&&typeof localStorage<`u`&&(this.localDataStorage=localStorage),t&&this.mergeWithSerialized(t)}get(e){return this.localDataStorage?this.localDataStorage.getItem(e)??void 0:this.getInMemory(e)}set(e,t){this.localDataStorage?this.localDataStorage.setItem(e,t):this.setInMemory(e,t)}serialize(){let t=this.localDataStorage?Object.entries(localStorage):[...this.inMemoryCache];return Object.fromEntries(t.map(([t,n])=>[t,e.CustomJSONStringify(n)]))}};exports.LocalStorageCacheDevice=n;

package/data-structures/cacheDevices/LocalStorageCacheDevice.d.ts

@@ -0,0 +1,8 @@
+import { BaseCacheDevice } from './BaseCacheDevice';
+export declare class LocalStorageCacheDevice extends BaseCacheDevice {
+    private localDataStorage;
+    constructor(disableCaching?: boolean, serializedCache?: Record<string, string>);
+    get(key: string): string | undefined;
+    set(key: string, value: string): void;
+    serialize(): Record<string, string>;
+}

package/data-structures/cacheDevices/LocalStorageCacheDevice.mjs

@@ -0,0 +1,21 @@
+import { CustomJSONStringify as e } from "../../functions/utils/serialize.utils.mjs";
+import { BaseCacheDevice as t } from "./BaseCacheDevice.mjs";
+//#region libs/shared/common/src/data-structures/cacheDevices/LocalStorageCacheDevice.ts
+var n = class extends t {
+	localDataStorage;
+	constructor(e, t) {
+		super(), !e && typeof localStorage < "u" && (this.localDataStorage = localStorage), t && this.mergeWithSerialized(t);
+	}
+	get(e) {
+		return this.localDataStorage ? this.localDataStorage.getItem(e) ?? void 0 : this.getInMemory(e);
+	}
+	set(e, t) {
+		this.localDataStorage ? this.localDataStorage.setItem(e, t) : this.setInMemory(e, t);
+	}
+	serialize() {
+		let t = this.localDataStorage ? Object.entries(localStorage) : [...this.inMemoryCache];
+		return Object.fromEntries(t.map(([t, n]) => [t, e(n)]));
+	}
+};
+//#endregion
+export { n as LocalStorageCacheDevice };

package/data-structures/cacheDevices/index.cjs

@@ -0,0 +1 @@
+require(`./FileCacheDevice.cjs`),require(`./LocalStorageCacheDevice.cjs`);

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

@@ -0,0 +1,2 @@
+export * from './FileCacheDevice';
+export * from './LocalStorageCacheDevice';

package/data-structures/cacheDevices/index.mjs

@@ -0,0 +1,2 @@
+import "./FileCacheDevice.mjs";
+import "./LocalStorageCacheDevice.mjs";

package/data-structures/crypto-keys/decodeUTXO.cjs

@@ -0,0 +1 @@
+require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../constants/chains.constants.cjs`),t=require(`../../crypto/poseidon.cjs`),n=require(`./keys.cjs`),r=require(`../utxo/Utxo.cjs`),i=require(`../../functions/utils/bit.operations.cjs`);let a=require(`ethers`),o=require(`@solana/web3.js`);var s=`solana-on-chain-utxo:`,c=8,l=e=>{if(e.length!==c)throw Error(`Expected ${c} on-chain fields, received ${e.length}`);let t=e.map((e,t)=>{let n=e instanceof Uint8Array?e:Uint8Array.from(e);if(n.length!==32)throw Error(`Expected bytes32 length 32 at position ${t}, got ${n.length}`);return`0x${Buffer.from(n).toString(`hex`)}`});return`${s}${a.ethers.AbiCoder.defaultAbiCoder().encode([`bytes32[8]`],[t])}`},u=e=>e.startsWith(s),d=e=>{if(!u(e))throw Error(`Invalid encoded Solana UTXO payload`);let[n]=a.ethers.AbiCoder.defaultAbiCoder().decode([`bytes32[8]`],e.slice(21)),r=n;if(!Array.isArray(r)||r.length!==c)throw Error(`Malformed encoded Solana UTXO payload`);let[s,l,d,f,p,m,h,g]=r,_=BigInt(s),v=BigInt(f),y=i.extractHighestBit(v)===1n,b=i.takeOffHighestBit(v),x=a.ethers.toBeHex(BigInt(p)),S=BigInt(m),C=BigInt(h),w=BigInt(g).toString(),T=Array.from(a.ethers.getBytes(l)),E=Array.from(a.ethers.getBytes(d)),D=new o.PublicKey(Uint8Array.from([...T.slice(16),...E.slice(16)])).toBase58();return{amount:_,erc20TokenAddress:t.poseidonHash(BigInt(l),BigInt(d)),mintAddress:D,randomization:b,stealthAddress:x,H0:S,H1:C,timeStamp:w,isNewStyle:y}},f=e=>{let t=a.ethers.AbiCoder.defaultAbiCoder().decode([`uint256`,`address`,`tuple(uint256, uint256, uint256, uint256)`,`uint256`,`uint256`],e),n=BigInt(t[0]),r=t[1],o=BigInt(t[2][0]),s=i.extractHighestBit(o),c=i.takeOffHighestBit(o),l=a.ethers.toBeHex(BigInt(t[2][1])),u=BigInt(t[2][2]),d=BigInt(t[2][3]),f=BigInt(t[3]).toString(),p=Number(t[4]);return{amount:n,erc20TokenAddress:r,randomization:c,isNewStyle:s===1n,stealthAddress:l,H0:u,H1:d,timeStamp:f,tokenId:p}},p=(t,r,i)=>{let{randomization:a,H0:o,H1:s,isNewStyle:c}=e.isSolanaLike(i)?d(t):f(t),l=c?n.UserKeys.verifyStealthPair([a,o],[0n,s],r):n.UserKeys.checkSignature(a,o,s,r);if(!l)throw Error(`UTXO doesn't belong to user`);return l},m=(t,n,r)=>{if(e.isSolanaLike(r)){let{amount:e,erc20TokenAddress:r,mintAddress:i,randomization:a,stealthAddress:o,timeStamp:s,isNewStyle:c,H0:l}=d(t);return{amount:e,erc20TokenAddress:r,mintAddress:i,timeStamp:s,nullifyingKey:n,stealthAddress:o,isNewStyle:c,...c?{H0:[a,l]}:{randomization:a}}}let{amount:i,erc20TokenAddress:a,timeStamp:o,randomization:s,isNewStyle:c,stealthAddress:l,H0:u}=f(t);return{amount:i,erc20TokenAddress:a,timeStamp:o,nullifyingKey:n,stealthAddress:l,isNewStyle:c,...c?{H0:[s,u]}:{randomization:s}}},h=(e,t,n)=>new r.Utxo(m(e,t,n));exports.checkUtxoSignature=p,exports.decodeEvmUtxo=f,exports.decodeSolanaUtxo=d,exports.decodeUtxo=h,exports.decodeUtxoConstructorArgs=m,exports.encodeSolanaOnChainUtxo=l,exports.isSolanaOnChainUtxo=u;

package/data-structures/crypto-keys/decodeUTXO.d.ts

@@ -0,0 +1,28 @@
+import { IUtxoConstructor, Utxo } from '../utxo/Utxo';
+export declare const encodeSolanaOnChainUtxo: (onChainData: number[][]) => string;
+export declare const isSolanaOnChainUtxo: (encodedOutput: string) => boolean;
+export declare const decodeSolanaUtxo: (encodedOutput: string) => {
+    amount: bigint;
+    erc20TokenAddress: string;
+    mintAddress: string;
+    randomization: bigint;
+    stealthAddress: string;
+    H0: bigint;
+    H1: bigint;
+    timeStamp: string;
+    isNewStyle: boolean;
+};
+export declare const decodeEvmUtxo: (encryptedOutput: string) => {
+    amount: bigint;
+    erc20TokenAddress: string;
+    randomization: bigint;
+    isNewStyle: boolean;
+    stealthAddress: string;
+    H0: bigint;
+    H1: bigint;
+    timeStamp: string;
+    tokenId: number;
+};
+export declare const checkUtxoSignature: (encryptedOutput: string, privateKey: string, chainId: number) => boolean;
+export declare const decodeUtxoConstructorArgs: (encryptedOutput: string, privateKey: string, chainId: number) => IUtxoConstructor;
+export declare const decodeUtxo: (encryptedOutput: string, privateKey: string, chainId: number) => Utxo;

package/data-structures/crypto-keys/decodeUTXO.mjs

@@ -0,0 +1,82 @@
+import { isSolanaLike as e } from "../../constants/chains.constants.mjs";
+import { poseidonHash as t } from "../../crypto/poseidon.mjs";
+import { UserKeys as n } from "./keys.mjs";
+import { Utxo as r } from "../utxo/Utxo.mjs";
+import { extractHighestBit as i, takeOffHighestBit as a } from "../../functions/utils/bit.operations.mjs";
+import { ethers as o } from "ethers";
+import { PublicKey as s } from "@solana/web3.js";
+//#region libs/shared/common/src/data-structures/crypto-keys/decodeUTXO.ts
+var c = "solana-on-chain-utxo:", l = 8, u = (e) => {
+	if (e.length !== l) throw Error(`Expected ${l} on-chain fields, received ${e.length}`);
+	let t = e.map((e, t) => {
+		let n = e instanceof Uint8Array ? e : Uint8Array.from(e);
+		if (n.length !== 32) throw Error(`Expected bytes32 length 32 at position ${t}, got ${n.length}`);
+		return `0x${Buffer.from(n).toString("hex")}`;
+	});
+	return `${c}${o.AbiCoder.defaultAbiCoder().encode(["bytes32[8]"], [t])}`;
+}, d = (e) => e.startsWith(c), f = (e) => {
+	if (!d(e)) throw Error("Invalid encoded Solana UTXO payload");
+	let [n] = o.AbiCoder.defaultAbiCoder().decode(["bytes32[8]"], e.slice(21)), r = n;
+	if (!Array.isArray(r) || r.length !== l) throw Error("Malformed encoded Solana UTXO payload");
+	let [c, u, f, p, m, h, g, _] = r, v = BigInt(c), y = BigInt(p), b = i(y) === 1n, x = a(y), S = o.toBeHex(BigInt(m)), C = BigInt(h), w = BigInt(g), T = BigInt(_).toString(), E = Array.from(o.getBytes(u)), D = Array.from(o.getBytes(f)), O = new s(Uint8Array.from([...E.slice(16), ...D.slice(16)])).toBase58();
+	return {
+		amount: v,
+		erc20TokenAddress: t(BigInt(u), BigInt(f)),
+		mintAddress: O,
+		randomization: x,
+		stealthAddress: S,
+		H0: C,
+		H1: w,
+		timeStamp: T,
+		isNewStyle: b
+	};
+}, p = (e) => {
+	let t = o.AbiCoder.defaultAbiCoder().decode([
+		"uint256",
+		"address",
+		"tuple(uint256, uint256, uint256, uint256)",
+		"uint256",
+		"uint256"
+	], e), n = BigInt(t[0]), r = t[1], s = BigInt(t[2][0]), c = i(s), l = a(s), u = o.toBeHex(BigInt(t[2][1])), d = BigInt(t[2][2]), f = BigInt(t[2][3]), p = BigInt(t[3]).toString(), m = Number(t[4]);
+	return {
+		amount: n,
+		erc20TokenAddress: r,
+		randomization: l,
+		isNewStyle: c === 1n,
+		stealthAddress: u,
+		H0: d,
+		H1: f,
+		timeStamp: p,
+		tokenId: m
+	};
+}, m = (t, r, i) => {
+	let { randomization: a, H0: o, H1: s, isNewStyle: c } = e(i) ? f(t) : p(t), l = c ? n.verifyStealthPair([a, o], [0n, s], r) : n.checkSignature(a, o, s, r);
+	if (!l) throw Error("UTXO doesn't belong to user");
+	return l;
+}, h = (t, n, r) => {
+	if (e(r)) {
+		let { amount: e, erc20TokenAddress: r, mintAddress: i, randomization: a, stealthAddress: o, timeStamp: s, isNewStyle: c, H0: l } = f(t);
+		return {
+			amount: e,
+			erc20TokenAddress: r,
+			mintAddress: i,
+			timeStamp: s,
+			nullifyingKey: n,
+			stealthAddress: o,
+			isNewStyle: c,
+			...c ? { H0: [a, l] } : { randomization: a }
+		};
+	}
+	let { amount: i, erc20TokenAddress: a, timeStamp: o, randomization: s, isNewStyle: c, stealthAddress: l, H0: u } = p(t);
+	return {
+		amount: i,
+		erc20TokenAddress: a,
+		timeStamp: o,
+		nullifyingKey: n,
+		stealthAddress: l,
+		isNewStyle: c,
+		...c ? { H0: [s, u] } : { randomization: s }
+	};
+}, g = (e, t, n) => new r(h(e, t, n));
+//#endregion
+export { m as checkUtxoSignature, p as decodeEvmUtxo, f as decodeSolanaUtxo, g as decodeUtxo, h as decodeUtxoConstructorArgs, u as encodeSolanaOnChainUtxo, d as isSolanaOnChainUtxo };

package/data-structures/crypto-keys/encryptDecryptUtxo.cjs

@@ -0,0 +1 @@
+require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../crypto/ecdh.cjs`),t=require(`../../crypto/ecdh-sealed-keys.cjs`),n=require(`./keys.cjs`),r=require(`../utxo/Utxo.cjs`);let i=require(`ethers`),a=require(`@solana/web3.js`);var o=e=>e.startsWith(`0x`)?e:`0x${e}`,s=54912,c=2,l=e=>Uint8Array.from([Math.floor(e/256),e%256]),u=e=>e[0]*256+e[1],d=e=>{let n=[Buffer.from(i.ethers.toBeHex(e.amount)),Buffer.from(o(e.erc20TokenAddress)),Buffer.from(i.ethers.toBeHex(e.randomization??0n)),Buffer.from(o(e.getStealthAddress())),Buffer.from(i.ethers.toBeHex(BigInt(e.timeStamp))),Buffer.from(i.ethers.toBeHex(e.isNewStyle?1n:0n)),Buffer.from(i.ethers.toBeHex(e.H0?.[0]??0n)),Buffer.from(i.ethers.toBeHex(e.H0?.[1]??0n))];if(e.mintAddress){let t=new a.PublicKey(e.mintAddress),r=i.ethers.hexlify(t.toBytes());n.push(Buffer.from(r))}let r=t.encryptSealedKeys(Buffer.concat(n),[e.getEncryptionKey()]);return Buffer.concat([Buffer.from(l(s)),Buffer.from(r)])},f=(r,i)=>{let{privateKey:o,publicKey:l}=n.UserKeys.getEncryptionKeyPair(i.getShieldedPrivateKey()),d=u(r)===s?t.decryptSealedKeys(r.slice(c),o,l,0):e.decryptBoxSeal(r,o,l),f=Buffer.from(d).toString(`utf-8`).split(`0x`).filter(e=>e.length!==0),p=e=>BigInt(`0x${e}`),m=e=>`0x${e}`,h=f.length>=8,g=h&&p(f[5])===1n,_=h?8:6,v=f[_]?m(f[_]):void 0,y=v?new a.PublicKey(Buffer.from(v.slice(2),`hex`)).toString():void 0;return{amount:p(f[0]),erc20TokenAddress:m(f[1]),randomization:p(f[2]),stealthAddress:m(f[3]),nullifyingKey:i.getShieldedPrivateKey(),timeStamp:p(f[4]).toString(),isNewStyle:g,...g?{H0:[p(f[6]),p(f[7])]}:{},mintAddress:y}},p=(e,t)=>new r.Utxo(f(e,t));exports.decryptUtxo=p,exports.decryptUtxoConstructorArgs=f,exports.encryptUtxo=d;

package/data-structures/crypto-keys/encryptDecryptUtxo.d.ts

@@ -0,0 +1,18 @@
+import { IUtxoConstructor, Utxo } from '../utxo/Utxo';
+import { UserKeys } from './keys';
+/**
+ * encrypt data for the UTXO
+ * @param amount UTXO amount
+ * @param blinding UTXO blinding
+ * @param publicKey sender's encryption public key
+ * @returns returns encrypted data {Uint8Array}
+ */
+export declare const encryptUtxo: (utxo: Utxo) => Uint8Array;
+export declare const decryptUtxoConstructorArgs: (encryptedData: Uint8Array, userKeys: UserKeys) => IUtxoConstructor;
+/**
+ * decrypt UTXO data from events
+ * @param encryptedData encrypted UTXO data {Uint8Array}
+ * @param publicKey/privateKey sender's encryption keys
+ * @returns decrypted UTXO data Object {amount, blinding}
+ */
+export declare const decryptUtxo: (encryptedData: Uint8Array, userKeys: UserKeys) => Utxo;

package/data-structures/crypto-keys/encryptDecryptUtxo.mjs

@@ -0,0 +1,40 @@
+import { decryptBoxSeal as e } from "../../crypto/ecdh.mjs";
+import { decryptSealedKeys as t, encryptSealedKeys as n } from "../../crypto/ecdh-sealed-keys.mjs";
+import { UserKeys as r } from "./keys.mjs";
+import { Utxo as i } from "../utxo/Utxo.mjs";
+import { ethers as a } from "ethers";
+import { PublicKey as o } from "@solana/web3.js";
+//#region libs/shared/common/src/data-structures/crypto-keys/encryptDecryptUtxo.ts
+var s = (e) => e.startsWith("0x") ? e : `0x${e}`, c = 54912, l = 2, u = (e) => Uint8Array.from([Math.floor(e / 256), e % 256]), d = (e) => e[0] * 256 + e[1], f = (e) => {
+	let t = [
+		Buffer.from(a.toBeHex(e.amount)),
+		Buffer.from(s(e.erc20TokenAddress)),
+		Buffer.from(a.toBeHex(e.randomization ?? 0n)),
+		Buffer.from(s(e.getStealthAddress())),
+		Buffer.from(a.toBeHex(BigInt(e.timeStamp))),
+		Buffer.from(a.toBeHex(e.isNewStyle ? 1n : 0n)),
+		Buffer.from(a.toBeHex(e.H0?.[0] ?? 0n)),
+		Buffer.from(a.toBeHex(e.H0?.[1] ?? 0n))
+	];
+	if (e.mintAddress) {
+		let n = new o(e.mintAddress), r = a.hexlify(n.toBytes());
+		t.push(Buffer.from(r));
+	}
+	let r = n(Buffer.concat(t), [e.getEncryptionKey()]);
+	return Buffer.concat([Buffer.from(u(c)), Buffer.from(r)]);
+}, p = (n, i) => {
+	let { privateKey: a, publicKey: s } = r.getEncryptionKeyPair(i.getShieldedPrivateKey()), u = d(n) === c ? t(n.slice(l), a, s, 0) : e(n, a, s), f = Buffer.from(u).toString("utf-8").split("0x").filter((e) => e.length !== 0), p = (e) => BigInt(`0x${e}`), m = (e) => `0x${e}`, h = f.length >= 8, g = h && p(f[5]) === 1n, _ = h ? 8 : 6, v = f[_] ? m(f[_]) : void 0, y = v ? new o(Buffer.from(v.slice(2), "hex")).toString() : void 0;
+	return {
+		amount: p(f[0]),
+		erc20TokenAddress: m(f[1]),
+		randomization: p(f[2]),
+		stealthAddress: m(f[3]),
+		nullifyingKey: i.getShieldedPrivateKey(),
+		timeStamp: p(f[4]).toString(),
+		isNewStyle: g,
+		...g ? { H0: [p(f[6]), p(f[7])] } : {},
+		mintAddress: y
+	};
+}, m = (e, t) => new i(p(e, t));
+//#endregion
+export { m as decryptUtxo, p as decryptUtxoConstructorArgs, f as encryptUtxo };

package/data-structures/crypto-keys/index.cjs

@@ -0,0 +1 @@
+require(`./keyUtils.cjs`),require(`./keys.cjs`),require(`./decodeUTXO.cjs`),require(`./encryptDecryptUtxo.cjs`);

package/data-structures/crypto-keys/index.d.ts

@@ -0,0 +1,4 @@
+export * from './decodeUTXO';
+export * from './encryptDecryptUtxo';
+export * from './keys';
+export * from './keyUtils';

package/data-structures/crypto-keys/index.mjs

@@ -0,0 +1,4 @@
+import "./keyUtils.mjs";
+import "./keys.mjs";
+import "./decodeUTXO.mjs";
+import "./encryptDecryptUtxo.mjs";

package/data-structures/crypto-keys/keyUtils.cjs

@@ -0,0 +1 @@
+const e=require(`../../constants/protocol.constants.cjs`);var t=t=>{if(t<0n||t>=21888242871839275222246405745257275088548364400416034343698204186575808495617n)throw RangeError();return t>e.CIRCOM_P_HALF},n=e=>t(e)?1n:0n;exports.getCircomSign=n,exports.isCircomNegative=t;

package/data-structures/crypto-keys/keyUtils.d.ts

@@ -0,0 +1,2 @@
+export declare const isCircomNegative: (n: bigint) => boolean;
+export declare const getCircomSign: (n: bigint) => 0n | 1n;

package/data-structures/crypto-keys/keyUtils.mjs

@@ -0,0 +1,8 @@
+import { CIRCOM_P_HALF as e } from "../../constants/protocol.constants.mjs";
+//#region libs/shared/common/src/data-structures/crypto-keys/keyUtils.ts
+var t = (t) => {
+	if (t < 0n || t >= 21888242871839275222246405745257275088548364400416034343698204186575808495617n) throw RangeError();
+	return t > e;
+}, n = (e) => t(e) ? 1n : 0n;
+//#endregion
+export { n as getCircomSign, t as isCircomNegative };

package/data-structures/crypto-keys/keys.cjs

@@ -0,0 +1 @@
+const e=require(`../../_virtual/_rolldown/runtime.cjs`),t=require(`../../constants/protocol.constants.cjs`),n=require(`../../crypto/poseidon.cjs`),r=require(`../../crypto/babyJub.cjs`),i=require(`../../crypto/eddsa.cjs`),a=require(`../cacheDevices/AttachableMemoryCacheDevice.cjs`),o=require(`./keyUtils.cjs`);let s=require(`ethers`),c=require(`@solana/web3.js`),l=require(`tronweb`),u=require(`libsodium-wrappers`);u=e.__toESM(u);let d=require(`bs58`);d=e.__toESM(d);let f=require(`tweetnacl`);f=e.__toESM(f);var p=new a.AttachableMemoryCacheDevice,m=new a.AttachableMemoryCacheDevice,h=new a.AttachableMemoryCacheDevice,g={privateKey:``,publicKey:``},_=class{signature;nullifyingKey;PREFIX_FOR_SPENDING_PAIR=`1`;PREFIX_FOR_NULLIFYING_PAIR=`2`;constructor(e,t){this.signature=e,this.nullifyingKey=t}getSignature(){return this.requireSignature(),this.signature}setSignature(e){this.signature=e}requireSignature(){if(!this.signature)throw Error(`No signature provided`)}requireKeyMaterial(){if(!this.signature&&!this.nullifyingKey)throw Error(`No signature or private key provided`)}verifyTronMessage(e,t){return this.requireSignature(),t===l.Trx.verifyMessageV2(e,this.signature)}getShieldedPrivateKey=()=>(this.requireKeyMaterial(),this.nullifyingKey||=s.ethers.keccak256(this.signature),this.nullifyingKey);getShieldedPublicKey=()=>(this.requireKeyMaterial(),n.poseidonHash(this.getShieldedPrivateKey()));getSpendingKeyPair=()=>{this.requireSignature();let e=i.eddsaInstance(),t=r.babyJubInstance(),a=n.poseidonHash(this.PREFIX_FOR_SPENDING_PAIR,this.getSignature()),o=Buffer.from(s.ethers.getBytes(a)),c=e.prv2pub(o);return{privSpendingKey:a,pubSpendingBJJPoint:[BigInt(t.F.toString(c[0])),BigInt(t.F.toString(c[1]))]}};signEddsa=e=>{this.requireSignature();let t=r.babyJubInstance(),n=i.eddsaInstance(),a=Buffer.from(s.ethers.getBytes(this.getSpendingKeyPair().privSpendingKey)),o=t.F.e(e),c=n.signPoseidon(a,o);return{R8:[BigInt(t.F.toString(c.R8[0])),BigInt(t.F.toString(c.R8[1]))],S:BigInt(c.S)}};getShieldedPrivateKeyFromNonce=e=>{this.requireKeyMaterial();let t=n.poseidonHash(e,this.getShieldedPrivateKey(),this.getShieldedPublicKey());return s.ethers.keccak256(s.ethers.toUtf8Bytes(`hinkal-offchain-shielded-key:${t}`))};getClaimableSignatureFromNonce=e=>{this.requireKeyMaterial();let t=n.poseidonHash(e,this.getShieldedPrivateKey(),this.getShieldedPublicKey());return s.ethers.keccak256(s.ethers.toUtf8Bytes(`hinkal-claimable-utxo-signature:${t}`))};getDerivedEthereumAddress=()=>(this.requireKeyMaterial(),new s.ethers.Wallet(this.getShieldedPrivateKey()).address);getDerivedSolanaPublicKey=()=>(this.requireKeyMaterial(),c.Keypair.fromSeed(s.ethers.getBytes(this.getShieldedPrivateKey())).publicKey.toBase58());getSignerPrivateKeyFromNonce=e=>{this.requireKeyMaterial();let t=n.poseidonHash(e,this.getShieldedPrivateKey(),this.getShieldedPublicKey());return s.ethers.keccak256(s.ethers.toUtf8Bytes(t))};getSignerSolanaPrivateKeyFromNonce=e=>{let t=this.getSignerPrivateKeyFromNonce(e),n=s.ethers.getBytes(t),r=c.Keypair.fromSeed(n);return d.default.encode(r.secretKey)};verifyMessage(e){return this.requireSignature(),s.ethers.verifyMessage(e,this.signature)}verifySolanaMessage(e,t){this.requireSignature();let n=new TextEncoder().encode(e),r=s.ethers.getBytes(this.signature),i=new c.PublicKey(t).toBytes();return f.default.sign.detached.verify(n,r,i)}static getRandomizedStealthPairOld=m.attach((e,n)=>{let i=r.babyJubInstance(),a=e*(BigInt(n)%t.CIRCOM_P)%t.CIRCOM_P,o=i.mulPointEscalar(i.Base8,e),s=i.mulPointEscalar(i.Base8,a);return{H0:[BigInt(i.F.toString(o[0])),BigInt(i.F.toString(o[1]))],H1:[BigInt(i.F.toString(s[0])),BigInt(i.F.toString(s[1]))]}});static getRandomizedStealthPair=p.attach((e,n)=>{let i=r.babyJubInstance(),a=BigInt(n)%t.CIRCOM_P,o=i.mulPointEscalar(i.Base8,e),s=i.mulPointEscalar(o,a);return{H0:[BigInt(i.F.toString(o[0])),BigInt(i.F.toString(o[1]))],H1:[BigInt(i.F.toString(s[0])),BigInt(i.F.toString(s[1]))]}});static getStealthAddressCompressedPoints=(e,t)=>{let{H0:n,H1:r}=this.getRandomizedStealthPairOld(e,t),[i,a]=[n,r].map(e=>BigInt(e[1])+2n**255n*o.getCircomSign(e[0]));return{h0:i,h1:a}};static checkSignature=(e,t,n,r)=>{let{h0:i,h1:a}=this.getStealthAddressCompressedPoints(e,r);return t===i&&n===a};static getStealthAddress=h.attach((e,t)=>{let{H0:r,H1:i}=this.getRandomizedStealthPairOld(e,t);return n.poseidonHash(2n*o.getCircomSign(r[0])+o.getCircomSign(i[0]),r[1],i[1])});static getH1FromH0=(e,n)=>{let i=r.babyJubInstance(),a=BigInt(n)%t.CIRCOM_P,o=[i.F.e(e[0]),i.F.e(e[1])],s=i.mulPointEscalar(o,a);return[BigInt(i.F.toString(s[0])),BigInt(i.F.toString(s[1]))]};static verifyStealthPair=(e,t,n,r=!0)=>{let i=this.getH1FromH0(e,n);return r?i[1]===t[1]:i===t};static getStealthAddressNewStyle=(e,t,r)=>{if(r?.length!==2)throw Error(`Spending public key must be an array of 2 elements`);let i=this.getH1FromH0(e,t);return n.poseidonHash(2n*o.getCircomSign(e[0])+o.getCircomSign(i[0]),e[1],i[1],r[0],r[1],t)};static findCorrectRandomization(e,n){if(!n)throw Error(`No Private Shielded Key Provided`);let r=BigInt(n)%t.CIRCOM_P,i,a,o=0n;do i=e*10n**o%t.CIRCOM_P,a=i*r%t.CIRCOM_P,o+=1n;while(a>=2n**253n||i>=2n**253n);return i}static getH0FromRandomization=e=>{let t=r.babyJubInstance(),n=t.mulPointEscalar(t.Base8,e);return[BigInt(t.F.toString(n[0])),BigInt(t.F.toString(n[1]))]};static findH0(e,t){if(!t)return;let{H0:n}=this.getRandomizedStealthPair(e,t);return n}static getEncryptionKeyPair=e=>{let t=u.default.crypto_box_seed_keypair(s.ethers.getBytes(e));return{privateKey:s.ethers.hexlify(t.privateKey),publicKey:s.ethers.hexlify(t.publicKey)}};getAccessKey=()=>(this.requireKeyMaterial(),n.poseidonHash(this.getShieldedPrivateKey(),this.getShieldedPublicKey()));getBackendToken=()=>(this.requireKeyMaterial(),n.poseidonHash(this.getAccessKey(),this.getShieldedPublicKey()))};exports.EncryptionKeyPairDefaultValue=g,exports.UserKeys=_,exports.stealthAddressCacheDevice=h,exports.stealthPairCacheDevice=p,exports.stealthPairOldCacheDevice=m;

package/data-structures/crypto-keys/keys.d.ts

@@ -0,0 +1,113 @@
+import { JubPoint } from '../../crypto/babyJub';
+import { AttachableMemoryCacheDevice } from '../cacheDevices/AttachableMemoryCacheDevice';
+export declare const stealthPairCacheDevice: AttachableMemoryCacheDevice<{
+    H0: [bigint, bigint];
+    H1: [bigint, bigint];
+}>;
+export declare const stealthPairOldCacheDevice: AttachableMemoryCacheDevice<{
+    H0: [bigint, bigint];
+    H1: [bigint, bigint];
+}>;
+export declare const stealthAddressCacheDevice: AttachableMemoryCacheDevice<string>;
+export interface EncryptionKeyPair {
+    privateKey: string;
+    publicKey: string;
+}
+export declare const EncryptionKeyPairDefaultValue: EncryptionKeyPair;
+export declare class UserKeys {
+    private signature;
+    private nullifyingKey;
+    private readonly PREFIX_FOR_SPENDING_PAIR;
+    private readonly PREFIX_FOR_NULLIFYING_PAIR;
+    constructor(_signature?: string, _nullifyingKey?: string);
+    getSignature(): string;
+    setSignature(_signature: string): void;
+    private requireSignature;
+    private requireKeyMaterial;
+    verifyTronMessage(signingMessage: string, signerAddress: string): boolean;
+    /**
+     * get shielded private key from message signature used to login to the application,
+     * this private key is used to generate encryption keypairs as well as public key
+     * @retuns 0x-prefixed shielded private key
+     */
+    getShieldedPrivateKey: () => string;
+    /**
+     * generate shielded public key from private key
+     * @param privateKey the key used to generate the shielded public key, this should be the signature
+     * that the user provided
+     * @retuns shielded public key in hexstring with 0x prefixed
+     */
+    getShieldedPublicKey: () => string;
+    /**
+     * derive the EdDSA-Poseidon BabyJubJub public key for the spending private key. This must match
+     * the key that `signEddsa` (circomlib's signPoseidon) signs with, i.e. the scalar is derived from
+     * blake512(prv) + clamping, not from privSpendingKey directly.
+     */
+    getSpendingKeyPair: () => {
+        privSpendingKey: string;
+        pubSpendingBJJPoint: JubPoint;
+    };
+    /**
+     * EdDSA-Poseidon sign a message (a circom field element as bigint) using the shielded private key
+     * as the EdDSA secret. Returns { R8, S } with R8 as a JubPoint and S as a bigint scalar.
+     */
+    signEddsa: (message: bigint) => {
+        R8: JubPoint;
+        S: bigint;
+    };
+    /**
+     * Currently used for creating shielded private keys for deposit UTXOs, which are encrypted and sent to enclave for private send
+     * @param nonce Used to deterministically generate new shielded private key
+     * @returns new shielded private key in hexstring with 0x prefixed
+     */
+    getShieldedPrivateKeyFromNonce: (nonce: bigint) => string;
+    getClaimableSignatureFromNonce: (nonce: bigint) => string;
+    /**
+     * deterministically derive an EVM address from the shielded private key
+     */
+    getDerivedEthereumAddress: () => string;
+    /**
+     * deterministically derive a Solana public key from the shielded private key
+     */
+    getDerivedSolanaPublicKey: () => string;
+    getSignerPrivateKeyFromNonce: (walletNonce: bigint) => string;
+    getSignerSolanaPrivateKeyFromNonce: (walletNonce: bigint) => string;
+    verifyMessage(signingMessage: string): string;
+    verifySolanaMessage(signingMessage: string, signerPublicKey: string): boolean;
+    static getRandomizedStealthPairOld: (s: bigint, privateKey: string) => {
+        H0: [bigint, bigint];
+        H1: [bigint, bigint];
+    };
+    static getRandomizedStealthPair: (s: bigint, privateKey: string) => {
+        H0: [bigint, bigint];
+        H1: [bigint, bigint];
+    };
+    static getStealthAddressCompressedPoints: (s: bigint, privateKey: string) => {
+        h0: bigint;
+        h1: bigint;
+    };
+    static checkSignature: (s: bigint, stealthAddressH0: bigint, stealthAddressH1: bigint, privateKey: string) => boolean;
+    static getStealthAddress: (s: bigint, privateKey: string) => string;
+    static getH1FromH0: (H0: JubPoint, privateKey: string) => JubPoint;
+    static verifyStealthPair: (H0: JubPoint, H1: JubPoint, privateKey: string, onlyYCheck?: boolean) => boolean;
+    static getStealthAddressNewStyle: (H0: JubPoint, nullifyingPrivateKey: string, spendingPublicKey?: bigint[]) => string;
+    static findCorrectRandomization(initialRandomization: bigint, privateKey?: string): bigint;
+    static getH0FromRandomization: (randomization: bigint) => JubPoint;
+    static findH0(randomization: bigint, privateKey: string | undefined): JubPoint | undefined;
+    /**
+     * generate private and public keypair
+     * @param seed seed to use to deterministically generate key, must be in DataHexString format
+     * and must correspond to 32 bytes
+     */
+    static getEncryptionKeyPair: (privateKey: string) => EncryptionKeyPair;
+    /**
+     * generate access token, this accessKey is what should be sent to the server for signing
+     * @returns accessKey in hexstring with 0x prefixed
+     */
+    getAccessKey: () => string;
+    /**
+     * generate backend token, which is used for access control on backend
+     * @returns accessKey in hexstring with 0x prefixed
+     */
+    getBackendToken: () => string;
+}