@gurge/sdk 0.3.5 → 0.3.8

package/common/src/functions/utils/erc20tokenFunctions.d.ts

@@ -0,0 +1,16 @@
+import { ERC20Token, TokenChanges } from '../../types/token.types';
+export declare const getErc20TokenFromAPI: (chainId: number, address: string) => Promise<ERC20Token | undefined>;
+export declare const getErc20TokensForChainAPI: (chainId: number) => Promise<ERC20Token[]>;
+export declare const getErc20TokenBySymbolFromAPI: (symbol: string, chainId: number) => Promise<ERC20Token | undefined>;
+export declare const overlayTokenWithRegistryData: (token: ERC20Token, chainId: number) => Promise<ERC20Token>;
+export declare const aggregateTokenChanges: (tokenChanges: TokenChanges<bigint>[]) => TokenChanges<bigint>[];
+export declare const formatTokenChangesList: (tokenChanges: TokenChanges<bigint>[]) => {
+    token: ERC20Token;
+    amount: string;
+    nftIds: string[] | undefined;
+}[];
+export declare const isNFTToken: (token: ERC20Token) => boolean;
+export declare const isArcNativeToken: (token: ERC20Token) => boolean;
+export declare const searchCompareFunction: (token: ERC20Token, searchString: string) => boolean;
+export declare const sortTokens: (tokens: ERC20Token[]) => ERC20Token[];
+export declare const findTokenBySymbolFromTokenList: (tokens: ERC20Token[], symbol: string) => ERC20Token | undefined;

package/common/src/functions/utils/evmNetworkFunctions.d.ts

@@ -0,0 +1,3 @@
+import { EthereumNetwork, EthereumNetworkType } from '../../types';
+export declare const getNetworkObject: (chainId: number) => EthereumNetwork;
+export declare const getNetworkType: (network: EthereumNetwork) => EthereumNetworkType;

package/common/src/functions/utils/external-action.utils.d.ts

@@ -0,0 +1,3 @@
+import { ExternalActionId } from '../../types/external-action.types';
+export declare const getExternalActionIdHash: (externalActionId: ExternalActionId | 0n) => bigint;
+export declare const getExternalActionIdFromNumber: (externalActionIdNumber: string | bigint) => ExternalActionId | undefined;

package/common/src/functions/utils/fees.utils.d.ts

@@ -0,0 +1,6 @@
+import { FeeStructure } from '../../types/hinkal.types';
+import { ERC20Token } from '../../types/token.types';
+export declare const getGasTokenSymbols: (chainId: number | undefined) => Promise<string[]>;
+export declare const calculateTotalFee: (amount: bigint, feeStructure: FeeStructure) => bigint;
+export declare const calculateModifiedFeeStructure: (chainId: number, amountToken: ERC20Token, amount: bigint, feeStructure: FeeStructure) => Promise<FeeStructure>;
+export declare const calculateWithdrawalAmount: (amountWithFee: bigint, feeStructure: FeeStructure) => bigint;

package/common/src/functions/utils/formatter.d.ts

@@ -0,0 +1 @@
+export declare const formatUSDNumber: (amount: number | null | undefined) => string;

package/common/src/functions/utils/get-signature-header.d.ts

@@ -0,0 +1,5 @@
+export declare const getSignatureHeader: (signature?: string) => {
+    headers: {
+        'x-user-signature': string | undefined;
+    };
+};

package/common/src/functions/utils/getBlockExplorerUrl.d.ts

@@ -0,0 +1 @@
+export declare const getBlockExplorerUrl: (nonLocalChainId: number) => string;

package/common/src/functions/utils/getContractAddress.d.ts

@@ -0,0 +1,2 @@
+import { ethers } from 'ethers';
+export declare const getContractAddress: (contract: ethers.BaseContract) => string;

package/common/src/functions/utils/getDataFromTransaction.d.ts

@@ -0,0 +1,33 @@
+import { DecodedTx, DecodedTxWithUtxos } from '../../types';
+export declare const deserializeDecodedTxs: (decodedTx: DecodedTxWithUtxos<string, string>) => DecodedTxWithUtxos;
+export declare const serializeDecodedTxs: (decodedTxs: DecodedTx[]) => {
+    input: string;
+    decodedInput: {
+        amountChanges: string[];
+        flatFees: string[];
+        externalActionId: string;
+        stealthAddressStructure: {
+            extraRandomization: string;
+            stealthAddress: string;
+            H0: string;
+            H1: string;
+        };
+        erc20TokenAddresses: string[];
+        externalActionMetadata: string;
+        encryptedOutputs: string[];
+        hookData: import('../..').HookDataType;
+    };
+    status: string;
+    blockNumber: number;
+    timeStamp: number;
+    isError: string;
+    methodId: string;
+    logs: {
+        topics: readonly string[];
+        data: string;
+    }[];
+    hash: string;
+    gas: number;
+    gasPrice: number;
+    contract?: string;
+}[];

package/common/src/functions/utils/getRecipientInfoFromUserKeys.d.ts

@@ -0,0 +1,4 @@
+import { UserKeys } from '../../data-structures/crypto-keys';
+import { StealthAddressStructure } from '../../types/circom-data.types';
+export declare const getRecipientInfoFromUserKeys: (userKeys: UserKeys) => string;
+export declare const getStealthAddressStructureFromUserKeys: (userKeys: UserKeys) => StealthAddressStructure;

package/common/src/functions/utils/getSignerFromContract.d.ts

@@ -0,0 +1,3 @@
+import { ethers } from 'ethers';
+export declare const getSignerFromContract: (contract: ethers.Contract) => ethers.AbstractSigner<any>;
+export declare const getProviderFromContract: (contract: ethers.Contract) => ethers.Provider;

package/common/src/functions/utils/getUtxosFromReceipt.utils.d.ts

@@ -0,0 +1,6 @@
+import { ethers } from 'ethers';
+import { Utxo } from '../../data-structures/utxo/Utxo';
+import { IHinkal } from '../../data-structures/Hinkal/IHinkal';
+export declare const getOnChainUtxosFromReceipt: (receipt: ethers.TransactionReceipt, hinkal: IHinkal, chainId: number, tokenAddress: string) => Utxo[];
+export declare const getUtxosFromReceipt: (receipt: ethers.TransactionReceipt, hinkal: IHinkal, chainId: number, tokenAddress: string, shieldedPrivateKey: string) => Utxo[];
+export declare const getOutputCommitmentsFromEvmReceipt: (chainId: number, receipt: ethers.TransactionReceipt) => string[];

package/common/src/functions/utils/getUtxosFromReceiptSolana.d.ts

@@ -0,0 +1,7 @@
+import { TransactionResponse, VersionedTransactionResponse } from '@solana/web3.js';
+import { Utxo } from '../../data-structures/utxo/Utxo';
+import { Program } from '@coral-xyz/anchor';
+import { UserKeys } from '../../data-structures/crypto-keys/keys';
+export declare const getOnChainUtxosFromReceiptSolana: (tx: VersionedTransactionResponse | TransactionResponse, hinkalProgram: Program, userKeys: UserKeys, tokenAddress: string) => Utxo[];
+export declare const getUtxosFromReceiptSolana: (tx: VersionedTransactionResponse | TransactionResponse, hinkalProgram: Program, userKeys: UserKeys, tokenAddress: string) => Utxo[];
+export declare const getOutputCommitmentsFromSolanaReceipt: (chainId: number, tx: VersionedTransactionResponse | TransactionResponse) => string[];

package/common/src/functions/utils/getWalletGroupKey.utils.d.ts

@@ -0,0 +1 @@
+export declare const getWalletGroupKey: (name: string) => string;

package/common/src/functions/utils/inLogicMetadata.d.ts

@@ -0,0 +1,2 @@
+import { ParsedInLogicMetadata } from '../../types/hinkal.types';
+export declare const encodeParsedInLogicMetadata: (metadata: ParsedInLogicMetadata) => string;

package/common/src/functions/utils/index.d.ts

@@ -0,0 +1,72 @@
+export * from './amounts.utils';
+export * from './cacheFunctions';
+export * from './create-provider';
+export * from './external-action.utils';
+export * from './erc20tokenFunctions';
+export * from './requireEnv';
+export * from './resolve-sync.utils';
+export * from './convertIntegrationProviderToExternalActionId';
+export * from '../pre-transaction';
+export * from './evmNetworkFunctions';
+export * from './userAgent';
+export * from './getDataFromTransaction';
+export * from './reloadPage';
+export * from './string.utils';
+export * from './nickname.utils';
+export * from './caseInsensitive.utils';
+export * from './time.utils';
+export * from './cacheDevice.utils';
+export * from './process.utils';
+export * from './getBlockExplorerUrl';
+export * from './involves-permit2-op';
+export * from './upToDateState';
+export * from './serialize.utils';
+export * from './convertEmporiumOpToCallInfo';
+export * from './getRecipientInfoFromUserKeys';
+export * from './publicBalance.utils';
+export * from './rpc-int-encode';
+export * from './token-check.utils';
+export * from './arraysMatch';
+export * from './addresses';
+export * from './trimFieldValues';
+export * from './walletBalances.utils';
+export * from './mutexes.utils';
+export * from './nftTokenFunctions';
+export * from './inLogicMetadata';
+export * from './networks.utils';
+export * from './is-valid-url';
+export * from './postToOffscreen';
+export * from './get-signature-header';
+export * from './solanaMint.utils';
+export * from './solanaSendPreflight.utils';
+export * from './prepareHinkal';
+export * from './bytes32.utils';
+export * from './getUtxosFromReceipt.utils';
+export * from './getUtxosFromReceiptSolana';
+export * from './fees.utils';
+export * from './proxyAvatar.utils';
+export * from './validateUsername';
+export * from './enclave-utxo-storage';
+export * from './enclave-signature-storage';
+export * from './serialize-utxos.utils';
+export * from './tx-confirmation.utils';
+export * from './buildClaimableDepositPlan';
+export * from './pay-routing.utils';
+export * from './formatter';
+export * from './tron.utils';
+export * from './tronSimulation.utils';
+export * from './getSignerFromContract';
+export * from './getContractAddress';
+export * from './deposit-claimable.utils';
+export * from './transfer-claimable.utils';
+export * from './auth.utils';
+export * from './getWalletGroupKey.utils';
+export * from './encryptInputForEnclave';
+export * from './dispatchBalanceRefreshes';
+export * from './lifi.utils';
+export * from './enclave-recipient-info-storage';
+export * from './solana-memo';
+export * from './mnemonics';
+export * from './customEnclaveFunctionsRegister';
+export * from './bit.operations';
+export * from './nearIntents.utils';

package/common/src/functions/utils/involves-permit2-op.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Uniswap appends extra data at the end of the calldada,
+ * which can cause permit and V3 pool approvals to fail.
+ * This function checks whether a workaround is needed by detecting
+ * if any operation includes a known Uniswap-related address.
+ */
+export declare const uniswapWorkaround: (ops: string[]) => boolean;

package/common/src/functions/utils/ipfs.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Formats URL correctly for use retrieving assets hosted on IPFS.
+ *
+ * @param ipfsUrl - The IFPS URL pointed at the asset.
+ * @param subdomainSupported - Boolean indicating whether the URL should be formatted with subdomains or not.
+ * @returns A formatted URL, with the user's preferred IPFS gateway and format (subdomain or not), pointing to an asset hosted on IPFS.
+ */
+export declare const getFormattedIpfsUrl: (ipfsUrl: string, subdomainSupported: boolean) => string;

package/common/src/functions/utils/is-valid-url.d.ts

@@ -0,0 +1 @@
+export declare const isValidUrl: (url?: string) => boolean;

package/common/src/functions/utils/lifi.utils.d.ts

@@ -0,0 +1,4 @@
+import { ERC20Token } from '../../types/token.types';
+export declare const getLifiScanURL: (txHash: string) => string;
+export declare const getEquivalentBridgedTokenForTempo: (sourceToken: ERC20Token, destChainId: number, destTokenList: ERC20Token[]) => ERC20Token | undefined;
+export declare const getEquivalentNativeToken: (sourceChainId: number, destChainId: number, fullTokenList: ERC20Token[]) => ERC20Token | undefined;

package/common/src/functions/utils/memoize.utils.d.ts

@@ -0,0 +1 @@
+export declare const memoizeFunc: <T extends any[], R>(fn: (...args: T) => R) => (...args: T) => R;

package/common/src/functions/utils/merkleTree.utils.d.ts

@@ -0,0 +1,2 @@
+import { MerkleTree, MerkleTreeJson } from '../../data-structures/merkle-tree/MerkleTree';
+export declare const contructMerkleTreeFromSerialized: (merkleTreeSerialized: MerkleTreeJson) => MerkleTree<bigint>;

package/common/src/functions/utils/mnemonics.d.ts

@@ -0,0 +1 @@
+export declare const generateHashFromSeedPhrases: (seedPhrases: string[]) => string;

package/common/src/functions/utils/mutexes.utils.d.ts

@@ -0,0 +1,2 @@
+import { Mutex } from 'async-mutex';
+export declare const getChainBalanceFetchingMutex: (chainId: number) => Mutex;

package/common/src/functions/utils/nearIntents.utils.d.ts

@@ -0,0 +1,11 @@
+import { FeeStructure } from '../../types/hinkal.types';
+import { NearIntentsToken } from '../../types/near-intents.types';
+import { ERC20Token } from '../../types/token.types';
+/**
+ * Reverse of resolveNearAssetId: map a NEAR Intents token back to the in-app ERC20Token so a
+ * bridge refund sitting in the user's Intents account can be displayed and claimed like any other
+ * balance. Returns undefined for assets on chains/tokens the app does not support.
+ */
+export declare const getErc20TokenForNearAsset: (token: NearIntentsToken) => Promise<ERC20Token | undefined>;
+export declare const resolveNearAssetId: (chainId: number, tokenAddress: string) => Promise<string>;
+export declare const buildNearBridgeFeeStructure: (chainId: number, token: ERC20Token, recipient: string) => Promise<FeeStructure>;

package/common/src/functions/utils/networks.utils.d.ts

@@ -0,0 +1 @@
+export declare const getNetworkName: (chainId: number) => string;

package/common/src/functions/utils/nftTokenFunctions.d.ts

@@ -0,0 +1,2 @@
+import { RPCSimulationAssetChange } from '../../types/tenderly.api.types';
+export declare const extractTokenIdsFromAssetChanges: (assetChanges: RPCSimulationAssetChange[]) => Record<string, string[]>;

package/common/src/functions/utils/nickname.utils.d.ts

@@ -0,0 +1 @@
+export declare const isNicknameValid: (input: string) => boolean;

package/common/src/functions/utils/pay-routing.utils.d.ts

@@ -0,0 +1,4 @@
+import { PrivateSendAllocation } from '../../API';
+import { RecipientRequest, RecipientRoutingResult } from '../../types';
+export declare const mapRecipientRequests: (recipientAddresses: string[], recipientAmounts: bigint[]) => RecipientRequest[];
+export declare const splitRecipientsByAllocations: (recipients: RecipientRequest[], allocations: PrivateSendAllocation[]) => RecipientRoutingResult;

package/common/src/functions/utils/postToOffscreen.d.ts

@@ -0,0 +1,2 @@
+import { MessagesFromOffscreen } from '../../types/offscreen.types';
+export declare const postToOffscreen: (type: MessagesFromOffscreen, payload: any) => void;

package/common/src/functions/utils/prepareHinkal.d.ts

@@ -0,0 +1,11 @@
+import { ethers } from 'ethers';
+import { IHinkal } from '../../data-structures/Hinkal/IHinkal';
+import { SolanaWallet } from '../../types/solana.types';
+export declare const createSigner: (privateKey: string) => ethers.Wallet;
+export declare const createVoidSigner: (address: string) => ethers.VoidSigner;
+export declare const prepareHinkal: (hinkal: IHinkal, signer: ethers.Wallet) => Promise<void>;
+export declare const prepareEthersProviderAdapter: (hinkal: IHinkal, ethereumAddress: string) => Promise<void>;
+export declare const createVoidSolanaWallet: (hinkal: IHinkal) => SolanaWallet;
+export declare const prepareSolanaProviderAdapter: (hinkal: IHinkal, ethereumAddress: string) => Promise<void>;
+export declare const prepareHinkalWithSignature: (hinkal: IHinkal, ethereumAddress: string, signature: string) => Promise<void>;
+export declare const prepareHinkalFromSeedPhrases: (hinkal: IHinkal, seedPhrases: string[]) => Promise<void>;

package/common/src/functions/utils/process.utils.d.ts

@@ -0,0 +1,13 @@
+/** pause execution for a number of miliseconds */
+export declare const wait: (miliseconds: number) => Promise<unknown>;
+type PollForValueOptions = {
+    intervalMs?: number;
+    timeoutMs?: number;
+};
+export declare const pollForValue: <T>(fetcher: () => Promise<T | null | undefined>, options?: PollForValueOptions) => Promise<T | undefined>;
+/** only call function once with a given number of milliseconds
+ * Ex: let debounceMyFunc = debounce(myFunc, 1000);
+ * debounceMyFunc(); debounceMyFunc();
+ */
+export declare function debounce(func: (...args: any[]) => void, debounceForMs: number): (...args: any[]) => void;
+export {};

package/common/src/functions/utils/proxyAvatar.utils.d.ts

@@ -0,0 +1,2 @@
+export declare const PROXY_AVATAR_INDEX_COUNT = 353;
+export declare const getRandomProxyAvatarIndex: () => number;

package/common/src/functions/utils/publicBalance.utils.d.ts

@@ -0,0 +1,7 @@
+import { ethers } from 'ethers';
+import { ERC20Token, TokenBalance } from '../../types/token.types';
+export declare const getPublicBalance: (provider: ethers.JsonRpcProvider, ethereumAddress: string, token: ERC20Token) => Promise<TokenBalance | null>;
+export declare const getPublicBalancesOfTokens: (chainId: number, ethereumAddress: string, tokens?: ERC20Token[]) => Promise<TokenBalance[]>;
+export declare const getPublicBalanceByTokenAddress: (chainId: number, ethereumAddress: string, tokenAddress: string) => Promise<bigint | null>;
+export declare const getPublicTransactionCount: (chainId: number, address: string) => Promise<number>;
+export declare const getSolanaPublicBalances: (chainId: number, ethereumAddress: string, tokensToUpdate: ERC20Token[]) => Promise<TokenBalance[]>;

package/common/src/functions/utils/reloadPage.d.ts

@@ -0,0 +1 @@
+export declare const reloadPage: () => void;

package/common/src/functions/utils/requireEnv.d.ts

@@ -0,0 +1 @@
+export declare const requireEnv: (environmentVariableName: string) => string;

package/common/src/functions/utils/resolve-sync.utils.d.ts

@@ -0,0 +1,6 @@
+export declare const resolveSync: (promiseFns: (() => Promise<any>)[]) => Promise<void>;
+export declare const getSequence: (fromBlockNumber: number, lastBlockNumber: number, maxPageSize: number | undefined) => {
+    from: number;
+    to: number;
+}[];
+export declare const promisify: (callback: () => Promise<any>, timeout?: number) => Promise<unknown>;

package/common/src/functions/utils/rpc-int-encode.d.ts

@@ -0,0 +1 @@
+export declare const rpcIntEncode: (value: string | number | bigint) => string;

package/common/src/functions/utils/serialize-utxos.utils.d.ts

@@ -0,0 +1,3 @@
+import { IUtxoConstructor } from '../../data-structures/utxo/Utxo';
+export declare const serializeUtxoConstructorParams: (params: IUtxoConstructor<bigint>) => IUtxoConstructor<string>;
+export declare const deserializeUtxoConstructorParams: (params: IUtxoConstructor<string>) => IUtxoConstructor<bigint>;

package/common/src/functions/utils/serialize.utils.d.ts

@@ -0,0 +1,10 @@
+type JsonReplacer = ((key: string, value: any) => any) | null;
+/**
+ * Deep-clones a value into plain JSON-serializable data: every `bigint` becomes a decimal string.
+ * Use with `res.json(...)` so Express never hits "Do not know how to serialize a BigInt".
+ */
+export declare const toJsonSafe: (value: unknown) => unknown;
+export declare const safeJsonStringify: (value: unknown, replacer?: JsonReplacer, space?: string | number) => string;
+export declare const CustomJSONStringify: (args: any) => string;
+export declare const CustomJSONParse: (stringifiedJSON: string) => any;
+export {};

package/common/src/functions/utils/solana-memo.d.ts

@@ -0,0 +1,3 @@
+import { MessageAccountKeys, MessageCompiledInstruction, TransactionInstruction } from '@solana/web3.js';
+export declare const buildOrderIdMemoInstruction: (orderId: string) => TransactionInstruction;
+export declare const extractOrderIdFromMemos: (instructions: MessageCompiledInstruction[], accountKeys: MessageAccountKeys) => string | null;

package/common/src/functions/utils/solanaMint.utils.d.ts

@@ -0,0 +1,10 @@
+import { PublicKey } from '@solana/web3.js';
+type FormattedMintAddress = {
+    mintAccountPart1: bigint;
+    mintAccountPart2: bigint;
+    compressedAddress: string;
+    mintPublicKey: PublicKey;
+};
+export declare const convertPublicKeyToBigint: (key: PublicKey) => bigint;
+export declare const formatMintAddress: (mint: PublicKey | string) => FormattedMintAddress;
+export {};

package/common/src/functions/utils/solanaSendPreflight.utils.d.ts

@@ -0,0 +1,6 @@
+import { ERC20Token } from '../../types/token.types';
+export interface SolanaRecipientRentPreflightData {
+    systemRentExemptLamports: bigint;
+    recipientSolBalanceLamports: bigint;
+}
+export declare const buildSolanaRecipientRentErrorMessages: (recipientsData: SolanaRecipientRentPreflightData[], tokenAmounts: string[] | undefined, selectedToken: ERC20Token | undefined, validToAddresses: string[], solanaNativeToken: ERC20Token | undefined, rowNumbers?: number[]) => string[];

package/common/src/functions/utils/string.utils.d.ts

@@ -0,0 +1,16 @@
+/** Capitalize the first letter of each word
+ * "This is an example" => "This Is An Example"
+ */
+export declare function toTitleCase(str: string): string;
+/** Capitalize the first letter of a string */
+export declare function capitalizeFirstLetter(str: string): string;
+/** Returns true if a value is null, undefined, or an empty object, array (length 0), or string (e.g. '') */
+export declare function isNullOrEmpty(obj: unknown): boolean;
+export declare const hexToUtf8: (hex: string) => string;
+export declare const getTokenStateKey: (address: string, chainId: number) => string;
+export declare const getStateKey: (address: string, chainId: number, withHinkalContractAddress?: boolean) => string;
+export declare const getChainIdFromStateKey: (stateKey: string) => number;
+export declare const getAddressFromStateKey: (stateKey: string) => string;
+export declare const replaceAllInstances: (text: string, oldPart: string, newPart: string) => string;
+export declare const capitalizeName: (name: string | undefined | null) => string | null;
+export declare const validateEmail: (email: string | undefined | null) => boolean;

package/common/src/functions/utils/time.utils.d.ts

@@ -0,0 +1,20 @@
+export declare const MS_PER_DAY: number;
+export declare const waitLittle: (time?: number) => Promise<unknown>;
+export declare const getCurrentTimeInSeconds: () => number;
+export declare const msToISOString: (ms: number) => string;
+export declare const getEffectiveToday: () => Date;
+export declare const getEffectiveSevenDaysAgo: () => Date;
+export declare const getCurrentWeekStart: () => Date;
+export declare const getPreviousWeekStart: () => Date;
+export declare const getNextDayDelay: () => number;
+export declare const getDelayUntilUtc8: () => number;
+export declare const getCurrentDayStart: () => Date;
+export declare const getUtcDayStart: (date?: Date) => Date;
+export declare const getNextDayISO: () => string;
+export declare const formatDate: (date: Date) => string;
+export declare const formatTxTimestamp: (input: string) => string;
+export declare const calculateRelativeTime: (targetDate: string) => string;
+export declare const isSameDay: (a: Date, b: Date) => boolean;
+export declare const formatTimestampDate: (date: Date) => string;
+export declare const secondsToMs: (seconds?: number) => number;
+export declare const isWithinDays: (date: Date, days: number) => boolean;

package/common/src/functions/utils/token-check.utils.d.ts

@@ -0,0 +1,4 @@
+import { ERC20Token } from '../../types/token.types';
+export declare const checkTokensForShielding: (chainId: number, erc20Addresses: string[]) => Promise<string[]>;
+export declare const validateAndGetChainId: (tokens: ERC20Token[]) => number;
+export declare const isSameERC20Token: (a?: ERC20Token, b?: ERC20Token) => boolean;

package/common/src/functions/utils/transfer-claimable.utils.d.ts

@@ -0,0 +1,9 @@
+import { ErrorWithIndex } from '../../error-handling';
+import { PrivateSendAllocation } from '../../API';
+import { AdminTransactionType, ERC20Token, FeeStructure, PendingEnclaveUtxo, RecipientRequest } from '../../types';
+import { IHinkal } from '../../data-structures/Hinkal/IHinkal';
+export declare const transferClaimableUtxos: (hinkal: IHinkal, token: ERC20Token, recipients: RecipientRequest[], allocations: PrivateSendAllocation[], baseNonce: bigint, feeToken?: string, feeStructure?: FeeStructure, action?: AdminTransactionType) => Promise<{
+    pendingEnclaveUtxos: PendingEnclaveUtxo[];
+    txHashes: string[];
+    failedRecipientErrorMessage: ErrorWithIndex | undefined;
+}>;

package/common/src/functions/utils/trimFieldValues.d.ts

@@ -0,0 +1,4 @@
+export declare const trimFieldValues: (value: number, demarcations?: {
+    value: number;
+    unit: string;
+}[], showDollarSign?: boolean) => string;

package/common/src/functions/utils/tron.utils.d.ts

@@ -0,0 +1,43 @@
+import { ethers } from 'ethers';
+import { CircomDataType, DimDataType } from '../../types/circom-data.types';
+import { NewZkCallDataType } from '../../types/snark.types';
+import { TronAccountResources, TronChainParameter } from '../../types/tron.types';
+import { TronWeb } from 'tronweb';
+import { ERC20Token } from '../../types/token.types';
+export declare const detectTronChainIdFromHost: (fullNodeHost: string) => number;
+export declare const normalizeTronPrivateKey: (privateKey: string) => string;
+export declare const createTronWeb: (chainId: number, privateKey?: string) => TronWeb;
+export declare const evmHexToTronBase58Address: (addr: string) => string;
+export declare const toTronBase58IfHex: (addr: string) => string;
+export declare const addressToHexFormat: (addr: string) => string;
+export declare const normalizeTronAddr: (addr: string) => string;
+export declare const createTronCallData: (abi: ethers.InterfaceAbi, functionName: string, args: unknown[]) => string;
+export declare const getAvailableResource: (resources: TronAccountResources | undefined, limitKey: string, usedKey: string) => bigint;
+export declare const getChainParameterValue: (params: TronChainParameter[], key: string) => bigint;
+export declare const fetchTronChainParameters: (chainId: number) => Promise<TronChainParameter[]>;
+export declare const fetchTronAccountResources: (chainId: number, ownerAddress: string) => Promise<TronAccountResources>;
+export declare const estimateTronFeeSunWithPadding: (tronWeb: TronWeb, chainId: number, contractAddress: string, ownerAddress: string, callData: string, callValueSun: bigint) => Promise<bigint>;
+export declare const parseZkCalldata: (zkCallData: NewZkCallDataType) => {
+    a: bigint[];
+    b: bigint[][];
+    c: bigint[];
+    publicSignals: bigint[];
+};
+export declare const getVerifierId: (dimensionsArg: DimDataType, externalActionId: bigint) => bigint;
+export declare const generateProofSignatureRemotely: (a: bigint[], b: bigint[][], c: bigint[], input: bigint[], dimensionsArg: DimDataType, externalActionId: bigint) => Promise<{
+    v: number;
+    r: string;
+    s: string;
+}>;
+export declare const circomDataToArray: (circomData: CircomDataType) => (string | number | bigint | (string | number)[] | string[][] | (string | bigint)[] | (bigint | boolean | import('../..').HinkalLogicAction | bigint[] | (string[] | bigint[])[][])[] | undefined)[];
+export declare const reorderZkCallData: (isTron: boolean, zkCallData: NewZkCallDataType, dimData: DimDataType, circomData: CircomDataType, modifyZkCallData?: boolean) => Promise<{
+    v: number;
+    r: string;
+    s: string;
+} | undefined>;
+export declare const splitTronTokensByNative: (erc20Tokens: ERC20Token[], amountChanges: bigint[]) => {
+    totalTrxValue: bigint;
+    tokensNeedingApproval: Map<string, bigint>;
+};
+export declare const assertTronSufficientBalance: (tronWeb: TronWeb, chainId: number, contractBase58: string, ownerAddress: string, callData: string, totalTrxValue: bigint) => Promise<void>;
+export declare const approveTronTokens: (tronWeb: TronWeb, ethereumAddress: string, spenderBase58: string, tokensNeedingApproval: Map<string, bigint>) => Promise<void>;

package/common/src/functions/utils/tronSimulation.utils.d.ts

@@ -0,0 +1 @@
+export declare const simulateTronTransaction: (chainId: number, contractAddress: string, functionName: string, abi: any, args: unknown[], from: string, value?: bigint) => Promise<void>;

package/common/src/functions/utils/tx-confirmation.utils.d.ts

@@ -0,0 +1,10 @@
+import { Commitment } from '@solana/web3.js';
+type TxConfirmationOptions = {
+    evmConfirmations?: number;
+    evmTimeoutMs?: number;
+    solanaCommitment?: Commitment;
+};
+export declare const waitForEthereumTransactionConfirmation: (chainId: number, txHash: string, opts?: TxConfirmationOptions) => Promise<import('ethers').TransactionReceipt>;
+export declare const waitForSolanaTransactionConfirmation: (chainId: number, txHash: string, opts?: TxConfirmationOptions) => Promise<import('@solana/web3.js').RpcResponseAndContext<import('@solana/web3.js').SignatureResult>>;
+export declare const waitForTransactionConfirmation: (chainId: number, txHash: string, opts?: TxConfirmationOptions) => Promise<void>;
+export {};

package/common/src/functions/utils/upToDateState.d.ts

@@ -0,0 +1,2 @@
+import { IHinkal } from '../../data-structures/Hinkal/IHinkal';
+export declare const checkAddressNotUpdated: (hinkal: IHinkal, oldEthAddress: string) => Promise<boolean>;

package/common/src/functions/utils/userAgent.d.ts

@@ -0,0 +1,2 @@
+export declare const browserSupported: () => boolean;
+export declare const isMobileDevice: () => boolean;

package/common/src/functions/utils/validateUsername.d.ts

@@ -0,0 +1,5 @@
+export interface UsernameValidationResult {
+    isValid: boolean;
+    message: string | null;
+}
+export declare const validateUsername: (username: string, isAvailable: boolean) => UsernameValidationResult;

package/common/src/functions/utils/walletBalances.utils.d.ts

@@ -0,0 +1,2 @@
+import { ERC20Token } from '../../types/token.types';
+export declare const hasEnoughBalance: (tokenAmount: string, maxPossibleAmount: string, token: ERC20Token | undefined, isDollarMode: boolean, tokenPriceDollar: number | undefined) => boolean;

package/common/src/functions/web3/EIP-712.d.ts

@@ -0,0 +1,23 @@
+import { ethers } from 'ethers';
+import { DecodedTypedMessageValue } from '../../types/message.types';
+export declare const decodeMessage: (message: Record<string, any>, typeDefinition: ethers.TypedDataField[], types: Record<string, ethers.TypedDataField[]>) => Record<string, DecodedTypedMessageValue>;
+export declare const getDecodedMessage: (message: Record<string, any>, types: Record<string, ethers.TypedDataField[]>, primaryType: string) => {
+    primaryType: {
+        value: string;
+        type: string;
+    };
+};
+type TokenDetail = {
+    token: string;
+    amount: string;
+};
+export declare const getPermitInfo: (message: Record<string, any>, types: Record<string, ethers.TypedDataField[]>, domain: Record<string, unknown>, primaryType: string) => {
+    isPermit: boolean;
+    tokenDetails?: undefined;
+    spender?: undefined;
+} | {
+    isPermit: true;
+    tokenDetails: TokenDetail[];
+    spender: string | undefined;
+};
+export {};

package/common/src/functions/web3/connectors.utils.d.ts

@@ -0,0 +1,8 @@
+import { Connector } from 'wagmi';
+import { WalletGroup } from '../connectors.types';
+export declare const isInjectedConnector: (c: Connector) => boolean;
+export declare const isMockConnector: (c: Connector) => boolean;
+export declare const isSolanaConnector: (c: Connector) => boolean;
+export declare const isTronConnector: (c: Connector) => boolean;
+export declare const isWalletConnectConnector: (c: Connector) => boolean;
+export declare const groupConnectorsByWallet: (connectors: Connector[]) => WalletGroup[];

package/common/src/functions/web3/crypto.d.ts

@@ -0,0 +1 @@
+export declare const hmacSha512: (key: string | Uint8Array, data: Uint8Array) => Promise<Uint8Array>;

package/common/src/functions/web3/etherFunctions.d.ts

@@ -0,0 +1,20 @@
+import { ERC20Token } from '../../types/token.types';
+export declare const ethToWei: (amount: string) => bigint;
+export declare const randomBigInt: (numberOfBytes: number) => bigint;
+export declare const getAmountInToken: (token: ERC20Token, amount: bigint) => string;
+export declare const getAmountInWei: (token: ERC20Token, amount: string) => bigint;
+/**
+ * Convert a decimal number into bigint through string method and return a bigint and number of decimal places.
+ * @param decimal
+ * @returns a tuple of [ theBigInt, numberOfDecimalPlaces]
+ */
+export declare const toBigIntWithDecimals: (decimal: number) => [bigint, number];
+/** Return getAmountInWei or 0 if error */
+export declare const getAmountInWeiOrZero: (token: ERC20Token, amount: string) => bigint;
+export declare const getAmountWithPrecision: (balance: bigint, token: ERC20Token, precision: number) => string;
+export declare const calculateDollarValue: (token: ERC20Token, tokenAmount: bigint, tokenPriceDollar: number, precision: number) => {
+    totalValueDollarsBigInt: bigint;
+    precision: number;
+};
+/** Returns same as getAmountWithPrecision but '0' if empty */
+export declare const getAmountWithPrecisionOrZero: (token: ERC20Token | undefined, amount: bigint | undefined) => string;

package/common/src/functions/web3/events/balanceChangedHandler.d.ts

@@ -0,0 +1,5 @@
+import { PrivateBalanceUpdateEventType } from '../../../types';
+type BalanceChangeListener = (detail?: PrivateBalanceUpdateEventType) => void;
+export declare const subscribeToBalanceChange: (listener: BalanceChangeListener) => (() => void);
+export declare const balanceChangedHandler: (detail: PrivateBalanceUpdateEventType) => void;
+export {};