@hinkal/common 0.3.11 → 0.3.13

package/common/src/functions/utils/receive-vault-scan.utils.cjs

@@ -0,0 +1 @@
+const e=require(`../../constants/chains.constants.cjs`),t=require(`./caseInsensitive.utils.cjs`),n=require(`../../error-handling/logger.cjs`),r=require(`./tron.utils.cjs`),i=require(`../../types/receive-vault.types.cjs`),a=require(`./receive-vault.utils.cjs`),o=require(`./erc20tokenFunctions.cjs`),s=require(`./publicBalance.utils.cjs`),c=require(`./wallet-token-discovery.utils.cjs`);var l=async(e,t,n)=>await s.getPublicBalanceByTokenAddress(t,r.addressToHexFormat(e),r.addressToHexFormat(n))??0n,u=t=>e.FRONT_END_SUPPORTED_CHAINS.filter(n=>a.isReceiveVaultSupported(n)&&e.isTronLike(n)===e.isTronLike(t.chainId)),d=async(t,r)=>{try{return await(e.isTronLike(t)?c.getTronWalletTokenAddresses(r,t):c.getEvmWalletTokenAddresses(t,r))}catch(e){return n.Logger.error(`receive-vault scan: token discovery failed for chain ${t}`,e),[]}},f=async(e,n)=>{let r=new Map,o=(e,t,n,i)=>r.set(`${t}:${e.vaultAddress}:${n}`.toLowerCase(),{record:e,chainId:t,token:n,reason:i});return await Promise.all(e.map(async e=>{let n=a.isReceiveVaultExpired(e),r=n?i.ReceiveVaultBlockReason.Expired:i.ReceiveVaultBlockReason.NotShieldable;await Promise.all(u(e).map(async a=>{(await d(a,e.vaultAddress)).forEach(s=>{if(a===e.chainId&&t.caseInsensitiveEqual(s,e.token)){n&&o(e,a,s,i.ReceiveVaultBlockReason.Expired);return}o(e,a,s,r)})}))})),n.forEach(n=>{let r=e.find(e=>t.caseInsensitiveEqual(e.vaultAddress,n.vaultAddress));r&&o(r,n.chainId,n.token,i.ReceiveVaultBlockReason.RiskySender)}),[...r.values()]},p=async(e,t)=>{try{return(await Promise.all((await f(e,t)).map(async e=>{try{let[t,n]=await Promise.all([o.getErc20TokenFromAPI(e.chainId,e.token),l(e.record.vaultAddress,e.chainId,e.token)]);return t&&!o.isArcNativeToken(t)&&n>0n?{record:e.record,token:t,amount:n,reason:e.reason}:void 0}catch(t){n.Logger.error(`receive-vault scan: balance lookup failed for chain ${e.chainId} token ${e.token}`,t);return}}))).filter(e=>!!e)}catch(e){return n.Logger.log(`Error fetching vault's blcoked balances`,e),[]}};exports.getReceiveVaultBlockedFunds=p;

package/common/src/functions/utils/receive-vault-scan.utils.d.ts

@@ -0,0 +1,2 @@
+import { ReceiveVaultBlock, ReceiveVaultBlockedFund, ReceiveVaultRecord } from '../../types/receive-vault.types';
+export declare const getReceiveVaultBlockedFunds: (records: ReceiveVaultRecord[], blocks: ReceiveVaultBlock[]) => Promise<ReceiveVaultBlockedFund[]>;

package/common/src/functions/utils/receive-vault-scan.utils.mjs

@@ -0,0 +1,60 @@
+import { FRONT_END_SUPPORTED_CHAINS as e, isTronLike as t } from "../../constants/chains.constants.mjs";
+import { caseInsensitiveEqual as n } from "./caseInsensitive.utils.mjs";
+import { Logger as r } from "../../error-handling/logger.mjs";
+import { addressToHexFormat as i } from "./tron.utils.mjs";
+import { ReceiveVaultBlockReason as a } from "../../types/receive-vault.types.mjs";
+import { isReceiveVaultExpired as o, isReceiveVaultSupported as s } from "./receive-vault.utils.mjs";
+import { getErc20TokenFromAPI as c, isArcNativeToken as l } from "./erc20tokenFunctions.mjs";
+import { getPublicBalanceByTokenAddress as u } from "./publicBalance.utils.mjs";
+import { getEvmWalletTokenAddresses as d, getTronWalletTokenAddresses as f } from "./wallet-token-discovery.utils.mjs";
+//#region libs/shared/common/src/functions/utils/receive-vault-scan.utils.ts
+var p = async (e, t, n) => await u(t, i(e), i(n)) ?? 0n, m = (n) => e.filter((e) => s(e) && t(e) === t(n.chainId)), h = async (e, n) => {
+	try {
+		return await (t(e) ? f(n, e) : d(e, n));
+	} catch (t) {
+		return r.error(`receive-vault scan: token discovery failed for chain ${e}`, t), [];
+	}
+}, g = async (e, t) => {
+	let r = /* @__PURE__ */ new Map(), i = (e, t, n, i) => r.set(`${t}:${e.vaultAddress}:${n}`.toLowerCase(), {
+		record: e,
+		chainId: t,
+		token: n,
+		reason: i
+	});
+	return await Promise.all(e.map(async (e) => {
+		let t = o(e), r = t ? a.Expired : a.NotShieldable;
+		await Promise.all(m(e).map(async (o) => {
+			(await h(o, e.vaultAddress)).forEach((s) => {
+				if (o === e.chainId && n(s, e.token)) {
+					t && i(e, o, s, a.Expired);
+					return;
+				}
+				i(e, o, s, r);
+			});
+		}));
+	})), t.forEach((t) => {
+		let r = e.find((e) => n(e.vaultAddress, t.vaultAddress));
+		r && i(r, t.chainId, t.token, a.RiskySender);
+	}), [...r.values()];
+}, _ = async (e, t) => {
+	try {
+		return (await Promise.all((await g(e, t)).map(async (e) => {
+			try {
+				let [t, n] = await Promise.all([c(e.chainId, e.token), p(e.record.vaultAddress, e.chainId, e.token)]);
+				return t && !l(t) && n > 0n ? {
+					record: e.record,
+					token: t,
+					amount: n,
+					reason: e.reason
+				} : void 0;
+			} catch (t) {
+				r.error(`receive-vault scan: balance lookup failed for chain ${e.chainId} token ${e.token}`, t);
+				return;
+			}
+		}))).filter((e) => !!e);
+	} catch (e) {
+		return r.log("Error fetching vault's blcoked balances", e), [];
+	}
+};
+//#endregion
+export { _ as getReceiveVaultBlockedFunds };

package/common/src/functions/utils/receive-vault.utils.cjs

@@ -0,0 +1,2 @@
+require(`../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../constants/chains.constants.cjs`),t=require(`../../constants/protocol.constants.cjs`),n=require(`../../data-structures/crypto-keys/keys.cjs`),r=require(`../../data-structures/utxo/Utxo.cjs`),i=require(`./tron.utils.cjs`);require(`../../data-structures/crypto-keys/index.cjs`);let a=require(`ethers`);var o=`HINKAL_RECEIVE_V1`,s=`HINKAL_RECEIVE_RECOVERY_V1`,c=`HINKAL_RECEIVE_RECOVER`,l=`HINKAL_RECEIVE_OUTPUT`,u=`HINKAL_RECEIVE_ACCOUNT_V1`,d=`HINKAL_RECEIVE_VAULT_ACCOUNT`,f=({chainId:e,token:t,index:n})=>`${e}:${i.addressToHexFormat(t).toLowerCase()}:${n}`,p=e=>e*t.RECEIVE_VAULT_FEE_CEILING_MULTIPLIER,m=()=>BigInt(Math.floor(Date.now()/1e3)+t.RECEIVE_VAULT_EXPIRY_SECONDS),h=(e,t)=>{let n=a.ethers.keccak256(a.ethers.toUtf8Bytes(`${s}:${e.getShieldedPrivateKey()}:${f(t)}`));return new a.ethers.Wallet(n)},g=e=>n.UserKeys.getEncryptionKeyPair(e.getShieldedPrivateKey()).publicKey,_=(e,s)=>{let c=e.getShieldedPrivateKey(),l=BigInt(a.ethers.keccak256(a.ethers.toUtf8Bytes(`${o}:${c}:${f(s)}`))),u=new r.Utxo({amount:0n,erc20TokenAddress:t.zeroAddress,nullifyingKey:c,randomization:n.UserKeys.findCorrectRandomization(l,c),spendingPublicKey:e.getSpendingKeyPair().pubSpendingBJJPoint}),{H0:d}=u;if(!d)throw Error(`receive vault: H0 is not set`);let p=n.UserKeys.getH1FromH0(d,c);return{recipient:{H0x:d[0],H0y:d[1],H1x:p[0],H1y:p[1],stealthAddress:BigInt(u.getStealthAddress())},owner:h(e,s).address,token:i.addressToHexFormat(s.token),maxFlatFee:BigInt(s.maxFlatFee),maxVariableRate:Number(t.RECEIVE_VAULT_VARIABLE_RATE),expiry:BigInt(s.expiry)}},v=e=>a.ethers.AbiCoder.defaultAbiCoder().encode([`tuple(tuple(uint256,uint256,uint256,uint256,uint256),address,address,uint256,uint16,uint64)`],[[[e.recipient.H0x,e.recipient.H0y,e.recipient.H1x,e.recipient.H1y,e.recipient.stealthAddress],e.owner,e.token,e.maxFlatFee,e.maxVariableRate,e.expiry]]),y=t=>e.isTronLike(t)?`0x41`:`0xff`,b=e=>[[e.recipient.H0x,e.recipient.H0y,e.recipient.H1x,e.recipient.H1y,e.recipient.stealthAddress],e.owner,e.token,e.maxFlatFee,e.maxVariableRate,e.expiry],x=(e,t,n,r)=>a.ethers.getAddress(a.ethers.dataSlice(a.ethers.solidityPackedKeccak256([`bytes1`,`address`,`bytes32`,`bytes32`],[y(r),i.addressToHexFormat(t),a.ethers.keccak256(v(e)),n]),12)),S=t=>e.networkRegistry[t]?.contractData?.receiveVaultFactoryAddress||void 0,C=`0xe5f823a7777291668021ab2734f77bc16b4854c16034051c86967a5eb2415e54`,w=`0xedef7fda070f3ae59616c754f3f10ec4dfe4cb5c531ae39141ab2d323b36e3ec`,T=t=>e.isTronLike(t)?w:C,E=e=>!!S(e),D=(t,n)=>{let r=S(n);if(!r)throw Error(`receive vault: no factory on chain ${n}`);let a=x(t,r,T(n),n);return e.isTronLike(n)?i.evmHexToTronBase58Address(a):a},O=(e,t)=>({...t,vaultAddress:D(_(e,t),t.chainId)}),k=({expiry:e})=>BigInt(e)<BigInt(Math.floor(Date.now()/1e3)),A=e=>({recipient:{H0x:e.recipient.H0x.toString(),H0y:e.recipient.H0y.toString(),H1x:e.recipient.H1x.toString(),H1y:e.recipient.H1y.toString(),stealthAddress:e.recipient.stealthAddress.toString()},owner:e.owner,token:e.token,maxFlatFee:e.maxFlatFee.toString(),maxVariableRate:e.maxVariableRate,expiry:e.expiry.toString()}),j=e=>new a.ethers.Wallet(a.ethers.keccak256(a.ethers.toUtf8Bytes(`${u}:${e.getShieldedPrivateKey()}`))),M=e=>j(e).address,N=(e,t)=>a.ethers.keccak256(a.ethers.solidityPacked([`string`,`address`,`uint256`],[d,e,t])),P=async(e,t)=>{let n=j(e),r=N(n.address,t);return{accountKey:n.address,deadline:t.toString(),signature:await n.signMessage(a.ethers.getBytes(r))}},F=(e,t,n,r)=>a.ethers.keccak256(a.ethers.solidityPacked([`string`,`uint256`,`address`,`address`,`bytes32`],[l,BigInt(e),i.addressToHexFormat(t),i.addressToHexFormat(n),a.ethers.keccak256(r)])),I=async(e,t,n)=>{let r=S(t.chainId);if(!r)throw Error(`receive vault: no factory on chain ${t.chainId}`);let i=F(t.chainId,r,t.vaultAddress,n);return h(e,t).signMessage(a.ethers.getBytes(i))},L=(t,n,r,o,s,l)=>{let u=a.ethers.keccak256(a.ethers.solidityPacked([`string`,`uint256`,`address`,`address`,`address`,`address`,`uint256`],[c,BigInt(t),i.addressToHexFormat(n),i.addressToHexFormat(r),i.addressToHexFormat(o),i.addressToHexFormat(s),l]));return e.isTronLike(t)?a.ethers.keccak256(a.ethers.concat([a.ethers.toUtf8Bytes(`TRON Signed Message:
+32`),u])):u},R=async(t,n,r,i,o,s)=>{let c=S(i);if(!c)throw Error(`receive vault: no factory on chain ${i}`);let l=L(i,c,n.vaultAddress,r,o,s),u=h(t,n);return e.isTronLike(i)?new a.ethers.SigningKey(u.privateKey).sign(l).serialized:u.signMessage(a.ethers.getBytes(l))};exports.buildReceiveVaultRecord=O,exports.computeReceiveVaultAddress=x,exports.encodeReceiveVaultParams=v,exports.getReceiveVaultAccountKey=M,exports.getReceiveVaultAddress=D,exports.getReceiveVaultEncryptionKey=g,exports.getReceiveVaultExpiry=m,exports.getReceiveVaultFactoryAddress=S,exports.getReceiveVaultFeeCeiling=p,exports.getReceiveVaultInitCodeHash=T,exports.getReceiveVaultOutputDigest=F,exports.getReceiveVaultParams=_,exports.getReceiveVaultRecoveryDigest=L,exports.getReceiveVaultRecoveryWallet=h,exports.isReceiveVaultExpired=k,exports.isReceiveVaultSupported=E,exports.receiveVaultParamsToTuple=b,exports.serializeReceiveVaultParams=A,exports.signReceiveVaultAccount=P,exports.signReceiveVaultOutput=I,exports.signReceiveVaultRecovery=R;

package/common/src/functions/utils/receive-vault.utils.d.ts

@@ -0,0 +1,29 @@
+import { ethers } from 'ethers';
+import { UserKeys } from '../../data-structures/crypto-keys';
+import { ReceiveVaultAccountProof, ReceiveVaultParams, ReceiveVaultRecord } from '../../types/receive-vault.types';
+export type ReceiveVaultTerms = Omit<ReceiveVaultRecord, 'vaultAddress'>;
+/** A ceiling, not a price: the relayer still charges what the settlement costs. It only has to stay
+ *  above that while gas moves under an unspent address. */
+export declare const getReceiveVaultFeeCeiling: (quotedFlatFee: bigint) => bigint;
+export declare const getReceiveVaultExpiry: () => bigint;
+export declare const getReceiveVaultRecoveryWallet: (userKeys: UserKeys, terms: ReceiveVaultTerms) => ethers.Wallet;
+export declare const getReceiveVaultEncryptionKey: (userKeys: UserKeys) => string;
+export declare const getReceiveVaultParams: (userKeys: UserKeys, terms: ReceiveVaultTerms) => ReceiveVaultParams;
+export declare const encodeReceiveVaultParams: (params: ReceiveVaultParams) => string;
+export declare const receiveVaultParamsToTuple: (params: ReceiveVaultParams) => (string | number | bigint | bigint[])[];
+export declare const computeReceiveVaultAddress: (params: ReceiveVaultParams, factoryAddress: string, initCodeHash: string, chainId: number) => string;
+export declare const getReceiveVaultFactoryAddress: (chainId: number) => string | undefined;
+export declare const getReceiveVaultInitCodeHash: (chainId: number) => string;
+export declare const isReceiveVaultSupported: (chainId: number) => boolean;
+export declare const getReceiveVaultAddress: (params: ReceiveVaultParams, chainId: number) => string;
+export declare const buildReceiveVaultRecord: (userKeys: UserKeys, terms: ReceiveVaultTerms) => ReceiveVaultRecord;
+export declare const isReceiveVaultExpired: ({ expiry }: ReceiveVaultTerms) => boolean;
+export declare const serializeReceiveVaultParams: (params: ReceiveVaultParams) => ReceiveVaultParams<string>;
+export declare const deserializeReceiveVaultParams: (params: ReceiveVaultParams<string>) => ReceiveVaultParams;
+export declare const getReceiveVaultRecipientInfo: (params: ReceiveVaultParams, encryptionKey: string) => string;
+export declare const getReceiveVaultAccountKey: (userKeys: UserKeys) => string;
+export declare const signReceiveVaultAccount: (userKeys: UserKeys, deadline: bigint) => Promise<ReceiveVaultAccountProof>;
+export declare const getReceiveVaultOutputDigest: (chainId: number, factoryAddress: string, vault: string, encryptedOutput: string) => string;
+export declare const signReceiveVaultOutput: (userKeys: UserKeys, record: ReceiveVaultRecord, encryptedOutput: string) => Promise<string>;
+export declare const getReceiveVaultRecoveryDigest: (chainId: number, factoryAddress: string, vault: string, token: string, to: string, deadline: bigint) => string;
+export declare const signReceiveVaultRecovery: (userKeys: UserKeys, record: ReceiveVaultRecord, token: string, chainId: number, to: string, deadline: bigint) => Promise<string>;

package/common/src/functions/utils/receive-vault.utils.mjs

@@ -0,0 +1,151 @@
+import { isTronLike as e, networkRegistry as t } from "../../constants/chains.constants.mjs";
+import { RECEIVE_VAULT_EXPIRY_SECONDS as n, RECEIVE_VAULT_FEE_CEILING_MULTIPLIER as r, RECEIVE_VAULT_VARIABLE_RATE as i, zeroAddress as a } from "../../constants/protocol.constants.mjs";
+import { UserKeys as o } from "../../data-structures/crypto-keys/keys.mjs";
+import { Utxo as s } from "../../data-structures/utxo/Utxo.mjs";
+import { addressToHexFormat as c, evmHexToTronBase58Address as l } from "./tron.utils.mjs";
+import "../../data-structures/crypto-keys/index.mjs";
+import { ethers as u } from "ethers";
+//#region libs/shared/common/src/functions/utils/receive-vault.utils.ts
+var d = "HINKAL_RECEIVE_V1", f = "HINKAL_RECEIVE_RECOVERY_V1", p = "HINKAL_RECEIVE_RECOVER", m = "HINKAL_RECEIVE_OUTPUT", h = "HINKAL_RECEIVE_ACCOUNT_V1", g = "HINKAL_RECEIVE_VAULT_ACCOUNT", _ = ({ chainId: e, token: t, index: n }) => `${e}:${c(t).toLowerCase()}:${n}`, v = (e) => e * r, y = () => BigInt(Math.floor(Date.now() / 1e3) + n), b = (e, t) => {
+	let n = u.keccak256(u.toUtf8Bytes(`${f}:${e.getShieldedPrivateKey()}:${_(t)}`));
+	return new u.Wallet(n);
+}, x = (e) => o.getEncryptionKeyPair(e.getShieldedPrivateKey()).publicKey, S = (e, t) => {
+	let n = e.getShieldedPrivateKey(), r = BigInt(u.keccak256(u.toUtf8Bytes(`${d}:${n}:${_(t)}`))), l = new s({
+		amount: 0n,
+		erc20TokenAddress: a,
+		nullifyingKey: n,
+		randomization: o.findCorrectRandomization(r, n),
+		spendingPublicKey: e.getSpendingKeyPair().pubSpendingBJJPoint
+	}), { H0: f } = l;
+	if (!f) throw Error("receive vault: H0 is not set");
+	let p = o.getH1FromH0(f, n);
+	return {
+		recipient: {
+			H0x: f[0],
+			H0y: f[1],
+			H1x: p[0],
+			H1y: p[1],
+			stealthAddress: BigInt(l.getStealthAddress())
+		},
+		owner: b(e, t).address,
+		token: c(t.token),
+		maxFlatFee: BigInt(t.maxFlatFee),
+		maxVariableRate: Number(i),
+		expiry: BigInt(t.expiry)
+	};
+}, C = (e) => u.AbiCoder.defaultAbiCoder().encode(["tuple(tuple(uint256,uint256,uint256,uint256,uint256),address,address,uint256,uint16,uint64)"], [[
+	[
+		e.recipient.H0x,
+		e.recipient.H0y,
+		e.recipient.H1x,
+		e.recipient.H1y,
+		e.recipient.stealthAddress
+	],
+	e.owner,
+	e.token,
+	e.maxFlatFee,
+	e.maxVariableRate,
+	e.expiry
+]]), w = (t) => e(t) ? "0x41" : "0xff", T = (e) => [
+	[
+		e.recipient.H0x,
+		e.recipient.H0y,
+		e.recipient.H1x,
+		e.recipient.H1y,
+		e.recipient.stealthAddress
+	],
+	e.owner,
+	e.token,
+	e.maxFlatFee,
+	e.maxVariableRate,
+	e.expiry
+], E = (e, t, n, r) => u.getAddress(u.dataSlice(u.solidityPackedKeccak256([
+	"bytes1",
+	"address",
+	"bytes32",
+	"bytes32"
+], [
+	w(r),
+	c(t),
+	u.keccak256(C(e)),
+	n
+]), 12)), D = (e) => t[e]?.contractData?.receiveVaultFactoryAddress || void 0, O = "0xe5f823a7777291668021ab2734f77bc16b4854c16034051c86967a5eb2415e54", k = "0xedef7fda070f3ae59616c754f3f10ec4dfe4cb5c531ae39141ab2d323b36e3ec", A = (t) => e(t) ? k : O, j = (e) => !!D(e), M = (t, n) => {
+	let r = D(n);
+	if (!r) throw Error(`receive vault: no factory on chain ${n}`);
+	let i = E(t, r, A(n), n);
+	return e(n) ? l(i) : i;
+}, N = (e, t) => ({
+	...t,
+	vaultAddress: M(S(e, t), t.chainId)
+}), P = ({ expiry: e }) => BigInt(e) < BigInt(Math.floor(Date.now() / 1e3)), F = (e) => ({
+	recipient: {
+		H0x: e.recipient.H0x.toString(),
+		H0y: e.recipient.H0y.toString(),
+		H1x: e.recipient.H1x.toString(),
+		H1y: e.recipient.H1y.toString(),
+		stealthAddress: e.recipient.stealthAddress.toString()
+	},
+	owner: e.owner,
+	token: e.token,
+	maxFlatFee: e.maxFlatFee.toString(),
+	maxVariableRate: e.maxVariableRate,
+	expiry: e.expiry.toString()
+}), I = (e) => new u.Wallet(u.keccak256(u.toUtf8Bytes(`${h}:${e.getShieldedPrivateKey()}`))), L = (e) => I(e).address, R = (e, t) => u.keccak256(u.solidityPacked([
+	"string",
+	"address",
+	"uint256"
+], [
+	g,
+	e,
+	t
+])), z = async (e, t) => {
+	let n = I(e), r = R(n.address, t);
+	return {
+		accountKey: n.address,
+		deadline: t.toString(),
+		signature: await n.signMessage(u.getBytes(r))
+	};
+}, B = (e, t, n, r) => u.keccak256(u.solidityPacked([
+	"string",
+	"uint256",
+	"address",
+	"address",
+	"bytes32"
+], [
+	m,
+	BigInt(e),
+	c(t),
+	c(n),
+	u.keccak256(r)
+])), V = async (e, t, n) => {
+	let r = D(t.chainId);
+	if (!r) throw Error(`receive vault: no factory on chain ${t.chainId}`);
+	let i = B(t.chainId, r, t.vaultAddress, n);
+	return b(e, t).signMessage(u.getBytes(i));
+}, H = (t, n, r, i, a, o) => {
+	let s = u.keccak256(u.solidityPacked([
+		"string",
+		"uint256",
+		"address",
+		"address",
+		"address",
+		"address",
+		"uint256"
+	], [
+		p,
+		BigInt(t),
+		c(n),
+		c(r),
+		c(i),
+		c(a),
+		o
+	]));
+	return e(t) ? u.keccak256(u.concat([u.toUtf8Bytes("TRON Signed Message:\n32"), s])) : s;
+}, U = async (t, n, r, i, a, o) => {
+	let s = D(i);
+	if (!s) throw Error(`receive vault: no factory on chain ${i}`);
+	let c = H(i, s, n.vaultAddress, r, a, o), l = b(t, n);
+	return e(i) ? new u.SigningKey(l.privateKey).sign(c).serialized : l.signMessage(u.getBytes(c));
+};
+//#endregion
+export { N as buildReceiveVaultRecord, E as computeReceiveVaultAddress, C as encodeReceiveVaultParams, L as getReceiveVaultAccountKey, M as getReceiveVaultAddress, x as getReceiveVaultEncryptionKey, y as getReceiveVaultExpiry, D as getReceiveVaultFactoryAddress, v as getReceiveVaultFeeCeiling, A as getReceiveVaultInitCodeHash, B as getReceiveVaultOutputDigest, S as getReceiveVaultParams, H as getReceiveVaultRecoveryDigest, b as getReceiveVaultRecoveryWallet, P as isReceiveVaultExpired, j as isReceiveVaultSupported, T as receiveVaultParamsToTuple, F as serializeReceiveVaultParams, z as signReceiveVaultAccount, V as signReceiveVaultOutput, U as signReceiveVaultRecovery };

package/common/src/functions/utils/string.utils.cjs

@@ -1 +1 @@
-const e=require(`../../constants/chains.constants.cjs`);var t=(t,n)=>{let r=`${t}-${n}`;return e.isSolanaLike(n)||e.isTronLike(n)?r:r.toLowerCase()},n=(t,n,r=!1)=>{let i=`${t}-${n}`;if(r){let{hinkalAddress:t}=e.networkRegistry[n].contractData;return`${i}-${t}`.toLowerCase()}return i.toLowerCase()},r=(e,t,n)=>{if(!t||!n)throw Error(`oldPart and newPart must be provided`);return e.toLowerCase().split(t.toLowerCase()).join(n.toLowerCase())};exports.getStateKey=n,exports.getTokenStateKey=t,exports.replaceAllInstances=r;
+const e=require(`../../constants/chains.constants.cjs`);var t=e=>{e.startsWith(`0x`)&&(e=e.slice(2));let t=[];for(let n=0;n<e.length;n+=2){let r=parseInt(e.slice(n,n+2),16);t.push(r)}return new TextDecoder(`utf-8`).decode(new Uint8Array(t))},n=(t,n)=>{let r=`${t}-${n}`;return e.isSolanaLike(n)||e.isTronLike(n)?r:r.toLowerCase()},r=(t,n,r=!1)=>{let i=`${t}-${n}`;if(r){let{hinkalAddress:t}=e.networkRegistry[n].contractData;return`${i}-${t}`.toLowerCase()}return i.toLowerCase()},i=(e,t,n)=>{if(!t||!n)throw Error(`oldPart and newPart must be provided`);return e.toLowerCase().split(t.toLowerCase()).join(n.toLowerCase())};exports.getStateKey=r,exports.getTokenStateKey=n,exports.hexToUtf8=t,exports.replaceAllInstances=i;

package/common/src/functions/utils/string.utils.mjs

@@ -1,18 +1,26 @@
 import { isSolanaLike as e, isTronLike as t, networkRegistry as n } from "../../constants/chains.constants.mjs";
 //#region libs/shared/common/src/functions/utils/string.utils.ts
-var r = (n, r) => {
+var r = (e) => {
+	e.startsWith("0x") && (e = e.slice(2));
+	let t = [];
+	for (let n = 0; n < e.length; n += 2) {
+		let r = parseInt(e.slice(n, n + 2), 16);
+		t.push(r);
+	}
+	return new TextDecoder("utf-8").decode(new Uint8Array(t));
+}, i = (n, r) => {
 	let i = `${n}-${r}`;
 	return e(r) || t(r) ? i : i.toLowerCase();
-}, i = (e, t, r = !1) => {
+}, a = (e, t, r = !1) => {
 	let i = `${e}-${t}`;
 	if (r) {
 		let { hinkalAddress: e } = n[t].contractData;
 		return `${i}-${e}`.toLowerCase();
 	}
 	return i.toLowerCase();
-}, a = (e, t, n) => {
+}, o = (e, t, n) => {
 	if (!t || !n) throw Error("oldPart and newPart must be provided");
 	return e.toLowerCase().split(t.toLowerCase()).join(n.toLowerCase());
 };
 //#endregion
-export { i as getStateKey, r as getTokenStateKey, a as replaceAllInstances };
+export { a as getStateKey, i as getTokenStateKey, r as hexToUtf8, o as replaceAllInstances };

package/common/src/functions/utils/temporary-wallet-recovery.utils.cjs

@@ -1 +1 @@
-require(`../../error-handling/error-codes.constants.cjs`),require(`../web3/etherFunctions.cjs`),require(`../../data-structures/crypto-keys/keys.cjs`),require(`./addresses.cjs`),require(`../pre-transaction/getFeeStructure.cjs`),require(`./getRecipientInfoFromUserKeys.cjs`),require(`./fees.utils.cjs`),require(`./enclave-utxo-storage.cjs`),require(`../../data-structures/Hinkal/hinkalSolanaSponsoredShield.cjs`),require(`./enclave-recipient-info-storage.cjs`);
+require(`../../error-handling/error-codes.constants.cjs`),require(`../web3/etherFunctions.cjs`),require(`../../data-structures/crypto-keys/keys.cjs`),require(`./addresses.cjs`),require(`../pre-transaction/getFeeStructure.cjs`),require(`./fees.utils.cjs`),require(`./getRecipientInfoFromUserKeys.cjs`),require(`./enclave-utxo-storage.cjs`),require(`../../data-structures/Hinkal/hinkalSolanaSponsoredShield.cjs`),require(`./enclave-recipient-info-storage.cjs`);

package/common/src/functions/utils/temporary-wallet-recovery.utils.mjs

@@ -3,8 +3,8 @@ import "../web3/etherFunctions.mjs";
 import "../../data-structures/crypto-keys/keys.mjs";
 import "./addresses.mjs";
 import "../pre-transaction/getFeeStructure.mjs";
-import "./getRecipientInfoFromUserKeys.mjs";
 import "./fees.utils.mjs";
+import "./getRecipientInfoFromUserKeys.mjs";
 import "./enclave-utxo-storage.mjs";
 import "../../data-structures/Hinkal/hinkalSolanaSponsoredShield.mjs";
 import "./enclave-recipient-info-storage.mjs";

package/common/src/functions/utils/transfer-claimable.utils.cjs

@@ -1 +1 @@
-require(`./token-check.utils.cjs`),require(`../../error-handling/index.cjs`),require(`../../constants/index.cjs`),require(`../../data-structures/crypto-keys/index.cjs`),require(`./getRecipientInfoFromUserKeys.cjs`),require(`./enclave-utxo-storage.cjs`),require(`./tx-confirmation.utils.cjs`);
+require(`../../data-structures/crypto-keys/index.cjs`),require(`./token-check.utils.cjs`),require(`../../error-handling/index.cjs`),require(`../../constants/index.cjs`),require(`./getRecipientInfoFromUserKeys.cjs`),require(`./enclave-utxo-storage.cjs`),require(`./tx-confirmation.utils.cjs`);

package/common/src/functions/utils/transfer-claimable.utils.mjs

@@ -1,7 +1,7 @@
+import "../../data-structures/crypto-keys/index.mjs";
 import "./token-check.utils.mjs";
 import "../../error-handling/index.mjs";
 import "../../constants/index.mjs";
-import "../../data-structures/crypto-keys/index.mjs";
 import "./getRecipientInfoFromUserKeys.mjs";
 import "./enclave-utxo-storage.mjs";
 import "./tx-confirmation.utils.mjs";

package/common/src/functions/utils/wallet-token-discovery.utils.cjs

@@ -0,0 +1 @@
+require(`../../constants/chains.constants.cjs`);const e=require(`../../constants/protocol.constants.cjs`),t=require(`../../data-structures/http/HttpClient.cjs`);require(`../../data-structures/http/index.cjs`);const n=require(`./tron.utils.cjs`);require(`./create-provider.cjs`);const r=require(`./publicBalance.utils.cjs`),i=require(`../../API/evm-token-assets.cjs`);require(`@solana/web3.js`),require(`@solana/spl-token`);var a=async(t,n)=>{let[a,o]=await Promise.all([r.getPublicBalanceByTokenAddress(t,n,e.zeroAddress),i.getEvmTokenBalancesFromServer(t,n)]);a&&a>0n&&o.push({contractAddress:e.zeroAddress,tokenBalance:a.toString()});let s={};return o.forEach(e=>{(!s[e.contractAddress]||BigInt(e.tokenBalance)>0n)&&(s[e.contractAddress]=e)}),Object.keys(s)},o=200,s=async(e,r)=>{let i=`${n.getTronWalletRpcUrl(r)}/v1/accounts/${e}/transactions/trc20?only_to=true&limit=${o}`,a=((await t.httpClient.get(i))?.data??[]).map(e=>e.token_info?.address).filter(e=>!!e).map(n.addressToHexFormat);return Array.from(new Set(a))},c=async(r,i)=>{let a=n.toTronBase58IfHex(r),o=`${n.getTronWalletRpcUrl(i)}/v1/accounts/${a}`,c=(await t.httpClient.get(o))?.data?.[0];if(!c)return s(a,i);let l=[];return c.balance&&c.balance>0&&l.push(e.zeroAddress),(c.trc20??[]).forEach(e=>{Object.entries(e).forEach(([e,t])=>{BigInt(t)>0n&&l.push(n.addressToHexFormat(e))})}),Array.from(new Set(l))};exports.getEvmWalletTokenAddresses=a,exports.getTronWalletTokenAddresses=c;

package/common/src/functions/utils/wallet-token-discovery.utils.d.ts

@@ -0,0 +1,4 @@
+export declare const getEvmWalletTokenAddresses: (chainId: number, walletAddress: string) => Promise<string[]>;
+export declare const getSolanaWalletTokenAddresses: (chainId: number, walletAddress: string) => Promise<string[]>;
+export declare const getWalletTokenAddresses: (chainId: number, walletAddress: string) => Promise<string[]>;
+export declare const getTronWalletTokenAddresses: (walletAddress: string, chainId: number) => Promise<string[]>;

package/common/src/functions/utils/wallet-token-discovery.utils.mjs

@@ -0,0 +1,36 @@
+import "../../constants/chains.constants.mjs";
+import { zeroAddress as e } from "../../constants/protocol.constants.mjs";
+import { httpClient as t } from "../../data-structures/http/HttpClient.mjs";
+import "../../data-structures/http/index.mjs";
+import { addressToHexFormat as n, getTronWalletRpcUrl as r, toTronBase58IfHex as i } from "./tron.utils.mjs";
+import "./create-provider.mjs";
+import { getPublicBalanceByTokenAddress as a } from "./publicBalance.utils.mjs";
+import { getEvmTokenBalancesFromServer as o } from "../../API/evm-token-assets.mjs";
+import "@solana/web3.js";
+import "@solana/spl-token";
+//#region libs/shared/common/src/functions/utils/wallet-token-discovery.utils.ts
+var s = async (t, n) => {
+	let [r, i] = await Promise.all([a(t, n, e), o(t, n)]);
+	r && r > 0n && i.push({
+		contractAddress: e,
+		tokenBalance: r.toString()
+	});
+	let s = {};
+	return i.forEach((e) => {
+		(!s[e.contractAddress] || BigInt(e.tokenBalance) > 0n) && (s[e.contractAddress] = e);
+	}), Object.keys(s);
+}, c = 200, l = async (e, i) => {
+	let a = `${r(i)}/v1/accounts/${e}/transactions/trc20?only_to=true&limit=${c}`, o = ((await t.get(a))?.data ?? []).map((e) => e.token_info?.address).filter((e) => !!e).map(n);
+	return Array.from(new Set(o));
+}, u = async (a, o) => {
+	let s = i(a), c = `${r(o)}/v1/accounts/${s}`, u = (await t.get(c))?.data?.[0];
+	if (!u) return l(s, o);
+	let d = [];
+	return u.balance && u.balance > 0 && d.push(e), (u.trc20 ?? []).forEach((e) => {
+		Object.entries(e).forEach(([e, t]) => {
+			BigInt(t) > 0n && d.push(n(e));
+		});
+	}), Array.from(new Set(d));
+};
+//#endregion
+export { s as getEvmWalletTokenAddresses, u as getTronWalletTokenAddresses };

package/common/src/functions/web3/functionCalls/transactCallDirect.cjs

@@ -1 +1 @@
-require(`../../../../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../../constants/protocol.constants.cjs`),t=require(`../../utils/time.utils.cjs`),n=require(`../../../types/ethereum-network.types.cjs`),r=require(`../../utils/getContractAddress.cjs`),i=require(`./recoverTransactionFromError.cjs`),a=require(`./approveTokensToHinkal.cjs`),o=require(`./constructBatchCall.cjs`),s=require(`./waitForErc20Approvals.cjs`);let c=require(`ethers`);var l=async(l,u,d,f,p,m,h,g,_,v=!0,y=!1)=>{let b=Array.isArray(d)?d:[d],x=Array.isArray(f)?f:[f];if(b.length!==x.length)throw Error(`token and amount length mismatch`);let S=l.getContractWithSigner(u,n.ContractType.HinkalContract),C=await l.getEthereumAddressByChain(u),w=g??S,T=_??S,E=`transact`,D=x.findIndex(({erc20TokenAddress:t})=>t===e.zeroAddress),O=x.some(({erc20TokenAddress:t})=>t!==e.zeroAddress),k=D===-1?0n:b[D],A=l.getProviderAdapter(u),j=await A.supportsBatchCall?.(u);if(!y&&O&&j&&A.sendBatchCallsTransaction){let e=o.buildApproveAndTransactCalls(x.map(e=>e.erc20TokenAddress),b,r.getContractAddress(w),T,p,h,m,k);return await A.sendBatchCallsTransaction(u,e)}if(!y&&(await a.approveTokensToHinkal(l,u,w,x,b),O)){let e=x.map(({erc20TokenAddress:e},t)=>({tokenAddress:e,requiredAmount:b[t]}));await s.waitForErc20Approvals(l,u,C,r.getContractAddress(w),e)}let M={value:k>0n?BigInt(k).toString():void 0,gasLimit:void 0},N,P=[p[0],p[1],p[2],h,m,{...M,from:C}],{runner:F}=T;if(!(F instanceof c.ethers.AbstractSigner))throw Error(`expected signer`);if(v)try{N=Number(await T[E].estimateGas(...P))}catch(e){console.log(`hinkalDeposit: gas estimation error`,{err:e})}let I=N&&N>=0?Math.ceil(N*12/10):void 0;I&&(P[5].gasLimit=I),await t.waitLittle();let L;try{L=y?await T[E].populateTransaction(...P):await T[E](...P)}catch(e){if(!e?.transactionHash)throw e;let t=await i.recoverTransactionFromError(F.provider,e.transactionHash);if(!t)throw e;L=t}return L};exports.transactCallDirect=l;
+const e=require(`../../../constants/protocol.constants.cjs`),t=require(`../../utils/time.utils.cjs`),n=require(`../../../types/ethereum-network.types.cjs`),r=require(`../../utils/getContractAddress.cjs`),i=require(`../../utils/isSigner.cjs`),a=require(`./recoverTransactionFromError.cjs`),o=require(`./approveTokensToHinkal.cjs`),s=require(`./constructBatchCall.cjs`),c=require(`./waitForErc20Approvals.cjs`);var l=async(l,u,d,f,p,m,h,g,_,v=!0,y=!1)=>{let b=Array.isArray(d)?d:[d],x=Array.isArray(f)?f:[f];if(b.length!==x.length)throw Error(`token and amount length mismatch`);let S=l.getContractWithSigner(u,n.ContractType.HinkalContract),C=await l.getEthereumAddressByChain(u),w=g??S,T=_??S,E=`transact`,D=x.findIndex(({erc20TokenAddress:t})=>t===e.zeroAddress),O=x.some(({erc20TokenAddress:t})=>t!==e.zeroAddress),k=D===-1?0n:b[D],A=l.getProviderAdapter(u),j=await A.supportsBatchCall?.(u);if(!y&&O&&j&&A.sendBatchCallsTransaction){let e=s.buildApproveAndTransactCalls(x.map(e=>e.erc20TokenAddress),b,r.getContractAddress(w),T,p,h,m,k);return await A.sendBatchCallsTransaction(u,e)}if(!y&&(await o.approveTokensToHinkal(l,u,w,x,b),O)){let e=x.map(({erc20TokenAddress:e},t)=>({tokenAddress:e,requiredAmount:b[t]}));await c.waitForErc20Approvals(l,u,C,r.getContractAddress(w),e)}let M={value:k>0n?BigInt(k).toString():void 0,gasLimit:void 0},N,P=[p[0],p[1],p[2],h,m,{...M,from:C}],{runner:F}=T;if(!i.isSigner(F))throw Error(`expected signer`);if(v)try{N=Number(await T[E].estimateGas(...P))}catch(e){console.log(`hinkalDeposit: gas estimation error`,{err:e})}let I=N&&N>=0?Math.ceil(N*12/10):void 0;I&&(P[5].gasLimit=I),await t.waitLittle();let L;try{L=y?await T[E].populateTransaction(...P):await T[E](...P)}catch(e){if(!e?.transactionHash||!F.provider)throw e;let t=await a.recoverTransactionFromError(F.provider,e.transactionHash);if(!t)throw e;L=t}return L};exports.transactCallDirect=l;

package/common/src/functions/web3/functionCalls/transactCallDirect.mjs

@@ -2,26 +2,26 @@ import { zeroAddress as e } from "../../../constants/protocol.constants.mjs";
 import { waitLittle as t } from "../../utils/time.utils.mjs";
 import { ContractType as n } from "../../../types/ethereum-network.types.mjs";
 import { getContractAddress as r } from "../../utils/getContractAddress.mjs";
-import { recoverTransactionFromError as i } from "./recoverTransactionFromError.mjs";
-import { approveTokensToHinkal as a } from "./approveTokensToHinkal.mjs";
-import { buildApproveAndTransactCalls as o } from "./constructBatchCall.mjs";
-import { waitForErc20Approvals as s } from "./waitForErc20Approvals.mjs";
-import { ethers as c } from "ethers";
+import { isSigner as i } from "../../utils/isSigner.mjs";
+import { recoverTransactionFromError as a } from "./recoverTransactionFromError.mjs";
+import { approveTokensToHinkal as o } from "./approveTokensToHinkal.mjs";
+import { buildApproveAndTransactCalls as s } from "./constructBatchCall.mjs";
+import { waitForErc20Approvals as c } from "./waitForErc20Approvals.mjs";
 //#region libs/shared/common/src/functions/web3/functionCalls/transactCallDirect.ts
 var l = async (l, u, d, f, p, m, h, g, _, v = !0, y = !1) => {
 	let b = Array.isArray(d) ? d : [d], x = Array.isArray(f) ? f : [f];
 	if (b.length !== x.length) throw Error("token and amount length mismatch");
 	let S = l.getContractWithSigner(u, n.HinkalContract), C = await l.getEthereumAddressByChain(u), w = g ?? S, T = _ ?? S, E = "transact", D = x.findIndex(({ erc20TokenAddress: t }) => t === e), O = x.some(({ erc20TokenAddress: t }) => t !== e), k = D === -1 ? 0n : b[D], A = l.getProviderAdapter(u), j = await A.supportsBatchCall?.(u);
 	if (!y && O && j && A.sendBatchCallsTransaction) {
-		let e = o(x.map((e) => e.erc20TokenAddress), b, r(w), T, p, h, m, k);
+		let e = s(x.map((e) => e.erc20TokenAddress), b, r(w), T, p, h, m, k);
 		return await A.sendBatchCallsTransaction(u, e);
 	}
-	if (!y && (await a(l, u, w, x, b), O)) {
+	if (!y && (await o(l, u, w, x, b), O)) {
 		let e = x.map(({ erc20TokenAddress: e }, t) => ({
 			tokenAddress: e,
 			requiredAmount: b[t]
 		}));
-		await s(l, u, C, r(w), e);
+		await c(l, u, C, r(w), e);
 	}
 	let M = {
 		value: k > 0n ? BigInt(k).toString() : void 0,
@@ -37,7 +37,7 @@ var l = async (l, u, d, f, p, m, h, g, _, v = !0, y = !1) => {
 			from: C
 		}
 	], { runner: F } = T;
-	if (!(F instanceof c.AbstractSigner)) throw Error("expected signer");
+	if (!i(F)) throw Error("expected signer");
 	if (v) try {
 		N = Number(await T[E].estimateGas(...P));
 	} catch (e) {
@@ -49,8 +49,8 @@ var l = async (l, u, d, f, p, m, h, g, _, v = !0, y = !1) => {
 	try {
 		L = y ? await T[E].populateTransaction(...P) : await T[E](...P);
 	} catch (e) {
-		if (!e?.transactionHash) throw e;
-		let t = await i(F.provider, e.transactionHash);
+		if (!e?.transactionHash || !F.provider) throw e;
+		let t = await a(F.provider, e.transactionHash);
 		if (!t) throw e;
 		L = t;
 	}

package/common/src/types/ethereum-network.types.cjs

@@ -1 +1 @@
-var e=function(e){return e[e.HinkalContract=0]=`HinkalContract`,e[e.HinkalHelperContract=1]=`HinkalHelperContract`,e[e.HinkalWrapperContract=2]=`HinkalWrapperContract`,e[e.DepositOnChainUtxosContract=3]=`DepositOnChainUtxosContract`,e[e.ERC20Contract=4]=`ERC20Contract`,e[e.ERC721Contract=5]=`ERC721Contract`,e[e.ERC1155Contract=6]=`ERC1155Contract`,e[e.WATokenContract=7]=`WATokenContract`,e[e.MerkleTreeContract=8]=`MerkleTreeContract`,e}({});exports.ContractType=e;
+var e=function(e){return e[e.HinkalContract=0]=`HinkalContract`,e[e.HinkalHelperContract=1]=`HinkalHelperContract`,e[e.HinkalWrapperContract=2]=`HinkalWrapperContract`,e[e.DepositOnChainUtxosContract=3]=`DepositOnChainUtxosContract`,e[e.ERC20Contract=4]=`ERC20Contract`,e[e.ERC721Contract=5]=`ERC721Contract`,e[e.ERC1155Contract=6]=`ERC1155Contract`,e[e.WATokenContract=7]=`WATokenContract`,e[e.MerkleTreeContract=8]=`MerkleTreeContract`,e[e.ReceiveVaultFactoryContract=9]=`ReceiveVaultFactoryContract`,e}({});exports.ContractType=e;

package/common/src/types/ethereum-network.types.d.ts

@@ -13,7 +13,8 @@ export declare enum ContractType {
     ERC721Contract = 5,
     ERC1155Contract = 6,
     WATokenContract = 7,
-    MerkleTreeContract = 8
+    MerkleTreeContract = 8,
+    ReceiveVaultFactoryContract = 9
 }
 export interface ContractData {
     hinkalAddress: string;
@@ -23,6 +24,8 @@ export interface ContractData {
     hinkalHelperABI?: InterfaceAbi;
     hinkalWrapperAddress?: string;
     hinkalWrapperABI?: InterfaceAbi;
+    receiveVaultFactoryAddress?: string;
+    receiveVaultFactoryABI?: InterfaceAbi;
     depositOnChainUtxosExternalActionAddress?: string;
     depositOnChainUtxosExternalActionABI?: InterfaceAbi;
     lifiExternalActionInstanceAddress?: string;

package/common/src/types/ethereum-network.types.mjs

@@ -1,6 +1,6 @@
 //#region libs/shared/common/src/types/ethereum-network.types.ts
 var e = /* @__PURE__ */ function(e) {
-	return e[e.HinkalContract = 0] = "HinkalContract", e[e.HinkalHelperContract = 1] = "HinkalHelperContract", e[e.HinkalWrapperContract = 2] = "HinkalWrapperContract", e[e.DepositOnChainUtxosContract = 3] = "DepositOnChainUtxosContract", e[e.ERC20Contract = 4] = "ERC20Contract", e[e.ERC721Contract = 5] = "ERC721Contract", e[e.ERC1155Contract = 6] = "ERC1155Contract", e[e.WATokenContract = 7] = "WATokenContract", e[e.MerkleTreeContract = 8] = "MerkleTreeContract", e;
+	return e[e.HinkalContract = 0] = "HinkalContract", e[e.HinkalHelperContract = 1] = "HinkalHelperContract", e[e.HinkalWrapperContract = 2] = "HinkalWrapperContract", e[e.DepositOnChainUtxosContract = 3] = "DepositOnChainUtxosContract", e[e.ERC20Contract = 4] = "ERC20Contract", e[e.ERC721Contract = 5] = "ERC721Contract", e[e.ERC1155Contract = 6] = "ERC1155Contract", e[e.WATokenContract = 7] = "WATokenContract", e[e.MerkleTreeContract = 8] = "MerkleTreeContract", e[e.ReceiveVaultFactoryContract = 9] = "ReceiveVaultFactoryContract", e;
 }({});
 //#endregion
 export { e as ContractType };

package/common/src/types/external-action.types.cjs

@@ -1 +1 @@
-var e=function(e){return e.Transact=`Transact`,e.Lifi=`Lifi`,e.Okx=`Okx`,e.Emporium=`Emporium`,e.Wallet=`Wallet`,e.DepositOnChainUtxos=`DepositOnChainUtxos`,e.ProofLess=`ProofLess`,e}({});exports.ExternalActionId=e;
+var e=function(e){return e.Transact=`Transact`,e.Lifi=`Lifi`,e.Okx=`Okx`,e.Emporium=`Emporium`,e.Wallet=`Wallet`,e.DepositOnChainUtxos=`DepositOnChainUtxos`,e.ProofLess=`ProofLess`,e.ReceiveVaultSettle=`ReceiveVaultSettle`,e}({});exports.ExternalActionId=e;

package/common/src/types/external-action.types.d.ts

@@ -5,7 +5,8 @@ export declare enum ExternalActionId {
     Emporium = "Emporium",
     Wallet = "Wallet",
     DepositOnChainUtxos = "DepositOnChainUtxos",
-    ProofLess = "ProofLess"
+    ProofLess = "ProofLess",// Note: not an actual external action, added to handle proofless deposit gas calculation
+    ReceiveVaultSettle = "ReceiveVaultSettle"
 }
 export interface ExternalActionData<T = 0n | ExternalActionId> {
     externalActionId: T;

package/common/src/types/external-action.types.mjs

@@ -1,6 +1,6 @@
 //#region libs/shared/common/src/types/external-action.types.ts
 var e = /* @__PURE__ */ function(e) {
-	return e.Transact = "Transact", e.Lifi = "Lifi", e.Okx = "Okx", e.Emporium = "Emporium", e.Wallet = "Wallet", e.DepositOnChainUtxos = "DepositOnChainUtxos", e.ProofLess = "ProofLess", e;
+	return e.Transact = "Transact", e.Lifi = "Lifi", e.Okx = "Okx", e.Emporium = "Emporium", e.Wallet = "Wallet", e.DepositOnChainUtxos = "DepositOnChainUtxos", e.ProofLess = "ProofLess", e.ReceiveVaultSettle = "ReceiveVaultSettle", e;
 }({});
 //#endregion
 export { e as ExternalActionId };

package/common/src/types/index.cjs

@@ -1 +1 @@
-require(`./chains.types.cjs`),require(`./hinkal.types.cjs`),require(`./circom-data.types.cjs`),require(`./ethereum-network.types.cjs`),require(`./external-action.types.cjs`),require(`./token.types.cjs`),require(`./transactions.types.cjs`),require(`./admin.types.cjs`),require(`./activities.types.cjs`),require(`./transaction.types.cjs`),require(`./balances.types.cjs`),require(`./cache.types.cjs`),require(`./eip5792.types.cjs`),require(`./offscreen.types.cjs`),require(`./solana.types.cjs`),require(`./events.types.cjs`),require(`./schedule.types.cjs`),require(`./transact.types.cjs`),require(`./solana-transact.types.cjs`);
+require(`./chains.types.cjs`),require(`./hinkal.types.cjs`),require(`./circom-data.types.cjs`),require(`./ethereum-network.types.cjs`),require(`./external-action.types.cjs`),require(`./token.types.cjs`),require(`./transactions.types.cjs`),require(`./admin.types.cjs`),require(`./activities.types.cjs`),require(`./transaction.types.cjs`),require(`./balances.types.cjs`),require(`./cache.types.cjs`),require(`./eip5792.types.cjs`),require(`./offscreen.types.cjs`),require(`./solana.types.cjs`),require(`./events.types.cjs`),require(`./schedule.types.cjs`),require(`./transact.types.cjs`),require(`./solana-transact.types.cjs`),require(`./receive-vault.types.cjs`);

package/common/src/types/index.d.ts

@@ -59,3 +59,4 @@ export * from './enclaveApi.types';
 export * from './transact.types';
 export * from './proxy-progress.types';
 export * from './solana-transact.types';
+export * from './receive-vault.types';

package/common/src/types/index.mjs

@@ -17,3 +17,4 @@ import "./events.types.mjs";
 import "./schedule.types.mjs";
 import "./transact.types.mjs";
 import "./solana-transact.types.mjs";
+import "./receive-vault.types.mjs";

package/common/src/types/receive-vault.types.cjs

@@ -0,0 +1 @@
+var e=function(e){return e.Expired=`expired`,e.NotShieldable=`notShieldable`,e.RiskySender=`riskySender`,e}({});exports.ReceiveVaultBlockReason=e;

package/common/src/types/receive-vault.types.d.ts

@@ -0,0 +1,68 @@
+import { StealthAddressStructure } from './circom-data.types';
+import { ERC20Token } from './token.types';
+/** Every field is part of the vault's CREATE2 salt, so the relayer cannot change one and still
+ *  point at an address that holds anything. */
+export type ReceiveVaultParams<T = bigint> = {
+    recipient: StealthAddressStructure<T>;
+    owner: string;
+    token: string;
+    maxFlatFee: T;
+    maxVariableRate: number;
+    expiry: T;
+};
+/** The terms sit in the salt, so a fresh quote cannot reproduce them: re-deriving a handed-out
+ *  address needs the ones it was built with. */
+export type ReceiveVaultRecord = {
+    index: number;
+    chainId: number;
+    token: string;
+    maxFlatFee: string;
+    maxVariableRate: number;
+    expiry: string;
+    vaultAddress: string;
+};
+/** Why a balance sitting in a deposit address is the owner's to recover rather than shieldable. */
+export declare enum ReceiveVaultBlockReason {
+    Expired = "expired",
+    NotShieldable = "notShieldable",
+    RiskySender = "riskySender"
+}
+/** The relayer declining to shield a token is the one thing the owner cannot work out on their own,
+ *  so it is the only thing recorded. The balance itself is read off chain. */
+export type ReceiveVaultBlock = {
+    vaultAddress: string;
+    chainId: number;
+    token: string;
+};
+export type ReceiveVaultRegistration = {
+    vaultAddress: string;
+    params: ReceiveVaultParams<string>;
+    encryptionKey: string;
+    encryptedOutput: string;
+    outputSignature: string;
+    chainId: number;
+};
+/** Proves control of the shielded account itself, rather than of one deposit address, so the terms
+ *  needed to re-derive an address can be fetched back after local storage is gone. */
+export type ReceiveVaultAccountProof = {
+    accountKey: string;
+    deadline: string;
+    signature: string;
+};
+/** A deposit address the user has handed out, with its token resolved. */
+export type ReceiveVaultEntry = {
+    record: ReceiveVaultRecord;
+    token: ERC20Token;
+    expiresAt: Date;
+};
+/** A balance the relayer declined to shield, sitting in a vault only its owner can derive. */
+export type ReceiveVaultBlockedFund = {
+    record: ReceiveVaultRecord;
+    token: ERC20Token;
+    amount: bigint;
+    reason: ReceiveVaultBlockReason;
+};
+export type ReceiveVaultAccount = {
+    entries: ReceiveVaultEntry[];
+    blockedFunds: ReceiveVaultBlockedFund[];
+};

package/common/src/types/receive-vault.types.mjs

@@ -0,0 +1,6 @@
+//#region libs/shared/common/src/types/receive-vault.types.ts
+var e = /* @__PURE__ */ function(e) {
+	return e.Expired = "expired", e.NotShieldable = "notShieldable", e.RiskySender = "riskySender", e;
+}({});
+//#endregion
+export { e as ReceiveVaultBlockReason };