@gurge/sdk 0.3.142 → 0.3.151

package/README.md

@@ -43,11 +43,12 @@ Initializing the SDK creates a `Hinkal` object that encapsulates:
 - Actions the user can perform, such as shielding (depositing), transfers, and swapping
 - Cryptographic keys for privacy-preserving operations
 
-Each provider exposes three prepare helpers:
+Each provider exposes four prepare helpers:
 
 - `prepare*Hinkal` — signs the Hinkal login message and initializes user keys (deterministic signers)
 - `prepare*HinkalWithEnclaveSignIn` — signs in through the secure enclave and stabilizes identity for non-deterministic signers (smart contract wallets, some hardware wallets)
 - `prepare*HinkalFromSignature` — initializes user keys from a previously stored signature
+- `prepare*HinkalFromNullifyingKey` — initializes a read-only session from an exported nullifying key (balance viewing only, no signing capability)
 
 **ethers.js:**
 
@@ -83,7 +84,7 @@ import { prepareTronHinkal } from '@hinkal/common/providers/prepareTronHinkal';
 const hinkal = await prepareTronHinkal(connector, hinkalConfig);
 ```
 
-The same `WithEnclaveSignIn` and `FromSignature` variants are available for each provider (for example, `prepareWagmiHinkalWithEnclaveSignIn`, `prepareSolanaHinkalFromSignature`).
+The same `WithEnclaveSignIn`, `FromSignature`, and `FromNullifyingKey` variants are available for each provider (for example, `prepareWagmiHinkalWithEnclaveSignIn`, `prepareSolanaHinkalFromSignature`, `prepareEthersHinkalFromNullifyingKey`).
 
 The `hinkalConfig` is defined as follows:
 
@@ -127,18 +128,12 @@ When that happens, a returning user appears as a new account. Funds deposited in
 **Manual approach:** if you manage identity yourself, call `storeAndGetInitialSignature` and then either `initUserKeysWithSignature` or `prepare*HinkalFromSignature`:
 
 ```typescript
-function storeAndGetInitialSignature(
-  authSignature: string,
-  isSolanaLedger?: boolean,
-  txMessageForSolanaLedger?: string,
-): Promise<string>;
+function storeAndGetInitialSignature(authSignature: string): Promise<string>;
 ```
 
 Parameters:
 
-- `authSignature` — signature from the current login session
-- `isSolanaLedger` — set to `true` for a Solana Ledger wallet. Defaults to `false`
-- `txMessageForSolanaLedger` — base64-encoded transaction message used for Solana Ledger authentication. Required when `isSolanaLedger` is `true`
+- `authSignature` — signature from the current login session. For Solana Ledger wallets, sign with `signSolanaLedgerMessage()` first
 
 Typical flow with a stored signature:
 
@@ -161,6 +156,27 @@ At rest, only the encrypted signature and encrypted key are stored in the databa
 
 Requests that fail this check are rejected. The first signature stored for a given address is never replaced. Later logins only use a fresh signature to authenticate retrieval of the original.
 
+### Read-only sessions (view keys)
+
+A signed-in session can export a nullifying key: a value derived from the login signature that resolves to the same shielded account but cannot authorize spends. Use it to view balances on another device, in a backend job, or anywhere handing out the wallet's signing capability is not acceptable.
+
+```typescript
+// on a fully signed-in session
+const nullifyingKey = hinkal.getNullifyingKey();
+```
+
+Initialize a separate, read-only session from that key alone, either through a provider helper or directly on an existing `Hinkal` instance:
+
+```typescript
+const readOnlyHinkal = await prepareWagmiHinkalFromNullifyingKey(connector, wagmiConfig, nullifyingKey, hinkalConfig);
+// or:
+readOnlyHinkal.initUserKeysWithNullifyingKey(nullifyingKey);
+```
+
+A read-only session can fetch balances (`getTotalBalance`, `privateBalancesWithUSD`), decrypt incoming shielded outputs, and call `getRecipientInfo()` to receive funds — everything needed to view holdings. It cannot spend: `transfer`, `withdraw`, `swap`, `actionPrivateWallet`, and every other value-moving call throw, because they require the EdDSA spending key derived from the original wallet signature, which a nullifying key cannot reproduce.
+
+Treat an exported nullifying key as sensitive account-specific material, not a public value — hand it out only to contexts you trust with read access to the account's balances and incoming transfers.
+
 ### Shielded balance
 
 Shielded balances are encrypted token holdings stored within the Hinkal protocol. Unlike regular blockchain balances that are publicly visible, shielded balances are hidden from external observers.
@@ -362,10 +378,11 @@ Possible values for `ScheduledTransactionStatus` are:
 - `sent_on_chain` — the withdrawal was submitted on-chain and `txHash` is available
 - `completed` — the withdrawal was confirmed on-chain
 - `failed` — the withdrawal transaction failed
+- `deposit_failed` — the deposit transaction did not confirm; the withdrawal was not attempted
 
 ### Swapping tokens from the shielded balance
 
-Swapping allows you to exchange tokens directly from your shielded balance without revealing your identity. The swap is executed through integrated DEX protocols (Uniswap, 1Inch, Odos) while keeping your transaction private. Your tokens are withdrawn from your shielded balance, swapped through the specified protocol, and the resulting tokens are deposited back into your shielded balance—all in a single private transaction.
+Swapping allows you to exchange tokens directly from your shielded balance without revealing your identity. On EVM chains the swap is executed through the LI.FI aggregator (OKX on Solana) while keeping your transaction private. Your tokens are withdrawn from your shielded balance, swapped through the aggregator, and the resulting tokens are deposited back into your shielded balance—all in a single private transaction.
 
 A user can swap tokens directly from their shielded balance using:
 
@@ -383,14 +400,14 @@ function swap(
 
 where:
 
-- `externalActionId` — swap protocol to use (`ExternalActionId.Uniswap`, `ExternalActionId.OneInch`, `ExternalActionId.Odos`, etc.)
+- `externalActionId` — swap external action to use (`ExternalActionId.Lifi` on EVM, `ExternalActionId.Okx` on Solana)
 - `swapData` — encoded swap parameters for the chosen protocol
 - `feeToken` — optional fee-payment token address
 - `feeStructureOverride` — optional custom fee structure
 
 **Getting swap quotes and calldata:**
 
-Fetch quotes from all supported aggregators for a chain in one call.
+Fetch the swap quote for a chain in one call.
 
 **EVM chains:**
 
@@ -400,22 +417,19 @@ function getEvmSwapPrices(
   inSwapAmount: string,
   inSwapTokenAddress: string,
   outSwapTokenAddress: string,
-): Promise<EvmSwapPrices>;
+): Promise<EvmSwapPrice | null>;
 ```
 
 ```typescript
-type EvmSwapPrices = {
-  uniswap: { tokenPrice: bigint; poolFee: string } | null;
-  odos: { outSwapAmountValue: bigint; odosDataValue: string } | null;
-  oneInch: { outSwapAmountValue: bigint; oneInchDataValue: string } | null;
+type EvmSwapPrice = {
+  outSwapAmountValue: bigint;
+  lifiDataValue: string;
 };
 ```
 
-Pass the swap calldata from the chosen quote to `swap` as `swapData`, with the matching `externalActionId`:
+Returns `null` if no quote could be fetched. Pass the swap calldata from the quote to `swap` as `swapData`, with `ExternalActionId.Lifi` (`outSwapAmountValue` is the quoted output amount):
 
-- **Uniswap** — `uniswap.poolFee` with `ExternalActionId.Uniswap` (`uniswap.tokenPrice` is the quoted output amount)
-- **Odos** — `odos.odosDataValue` with `ExternalActionId.Odos`
-- **1Inch** — `oneInch.oneInchDataValue` with `ExternalActionId.OneInch`
+- **LI.FI** — `lifiDataValue` with `ExternalActionId.Lifi`
 
 **Solana:**
 
@@ -425,16 +439,17 @@ function getSolanaSwapPrices(
   inSwapAmount: string,
   inSwapTokenAddress: string,
   outSwapTokenAddress: string,
-): Promise<SolanaSwapPrices>;
+): Promise<SolanaSwapPrice | null>;
 ```
 
 ```typescript
-type SolanaSwapPrices = {
-  okx: { outSwapAmountValue: bigint; okxDataValue: string } | null;
+type SolanaSwapPrice = {
+  outSwapAmountValue: bigint;
+  okxDataValue: string;
 };
 ```
 
-Pass `okx.okxDataValue` to `swap` as `swapData` with `ExternalActionId.Okx`.
+Returns `null` if no quote could be fetched. Pass `okxDataValue` to `swap` as `swapData` with `ExternalActionId.Okx`.
 
 ### Interacting with smart contracts privately
 
@@ -540,14 +555,13 @@ Hinkal SDK is available on the following blockchain networks:
 | --------------- | ---------- | ------- |
 | Ethereum        | 1          | ✅ Live |
 | Arbitrum        | 42161      | ✅ Live |
-| Optimism        | 10         | ✅ Live |
 | Polygon         | 137        | ✅ Live |
 | Base            | 8453       | ✅ Live |
+| Tempo           | 4217       | ✅ Live |
+| BNB             | 56         | ✅ Live |
 | Solana          | 501        | ✅ Live |
 | Tron            | 728126428  | ✅ Live |
-| Tempo           | 4217       | ✅ Live |
 | Arc Testnet     | 5042002    | ✅ Live |
-| Sepolia Testnet | 11155111   | ✅ Live |
 | Tron Nile       | 3448148188 | ✅ Live |
 
 Each chain supports the full suite of Hinkal privacy features including shielding, transfers, and confidential interactions with DeFi protocols.

package/common/src/API/API.cjs

@@ -1 +1 @@
-const e=require(`./scheduled-transactions-calls.cjs`),t=require(`./relayCalls.cjs`),n=require(`./getTokenPrice.cjs`),r=require(`./callOdosAPI.cjs`),i=require(`./simulate-transaction.cjs`),a=require(`./simulate-batch-tx.cjs`),o=require(`./token-calls.cjs`),s=require(`./get-token-data.cjs`),c=require(`./enclaveUtxoCalls.cjs`),l=require(`./generate-trading-points.cjs`),u=require(`./brotherhoodCalls.cjs`),d=require(`./leaderboardCalls.cjs`),f=require(`./referralsCalls.cjs`),p=require(`./accessCodeCalls.cjs`),m=require(`./rewardsUserCalls.cjs`),h=require(`./weeklyAnalyticCalls.cjs`),g=require(`./send-telegram-callback.cjs`),_=require(`./proxyAccountsCalls.cjs`),v=require(`./callMonitor.cjs`),y=require(`./callRelayer.cjs`),b=require(`./seedless-calls.cjs`),x=require(`./temporaryWalletCalls.cjs`),S=require(`./onrampCalls.cjs`),C=require(`./get-token-price-chart-data.cjs`),w=require(`./privacy-score-calls.cjs`),T=require(`./privateSendRecipientInfoCalls.cjs`),E=require(`./privateSendNonceCalls.cjs`),D=require(`./snapshot-event-calls.cjs`),O=require(`./privateSendEmailNotificationsCalls.cjs`),k=require(`./tronSubsidyCalls.cjs`),A=require(`./dashboardAccountCalls.cjs`),j=require(`./dashboardContactCalls.cjs`),M=require(`./dashboardPayoutCalls.cjs`),N=require(`./dashboardAccountMemberCalls.cjs`),P=require(`./dashboardBalanceCalls.cjs`),F=require(`./dashboardTransactionCalls.cjs`);var I={getTokenPrices:n.getTokenPrices,getOdosPriceForToken:r.getOdosPriceForToken,getTokenPriceChartData:C.getTokenPriceChartData,getTokenPreviousDayPrices:n.getTokenPreviousDayPrices,getIdleRelay:t.getIdleRelay,generateTradingPoints:l.generateTradingPoints,generateAumPoints:l.generateAumPoints,getBrotherhoodUsers:u.getBrotherhoodUsers,getCurrentUserBrotherhoodUsers:u.getCurrentUserBrotherhoodUsers,getBrotherhood:u.getBrotherhood,editBrotherhood:u.editBrotherhood,createBrotherhood:u.createBrotherhood,getCurrentUserBrotherhood:u.getCurrentUserBrotherhood,getPublicBrotherhoods:u.getPublicBrotherhoods,leaveBrotherhood:u.leaveBrotherhood,joinBrotherhood:u.joinBrotherhood,getUserAnalytics:h.getUserAnalytics,getBrotherhoodAnalytics:h.getBrotherhoodAnalytics,connectRewardsUser:m.connectRewardsUser,updateRewardsUser:m.updateRewardsUser,getRewardsUser:m.getRewardsUser,checkUsernameAvailability:m.checkUsernameAvailability,disconnectSocialNetwork:m.disconnectSocialNetwork,getUserCurrentLeaderboard:d.getUserCurrentLeaderboard,getBrotherhoodsLeaderboard:d.getBrotherhoodsLeaderboard,getCurrentUserReferral:f.getCurrentUserReferral,submitReferralCode:f.submitReferralCode,getCurrentUserAppliedReferralCode:f.getCurrentUserAppliedReferralCode,submitAccessCode:p.submitAccessCode,getAccessCodeBenefits:p.getAccessCodeBenefits,simulateTransaction:i.simulateTransaction,simulateBatchTx:a.simulateBatchTx,tokensInfoCall:o.tokensInfoCall,getTokenData:s.getTokenData,decryptUtxoEnclaveCall:c.decryptUtxoEnclaveCall,storeUtxoEnclaveCall:c.storeUtxoEnclaveCall,getUtxosEnclaveCall:c.getUtxosEnclaveCall,sendTelegramCallback:g.sendTelegramCallback,getTasksProgress:m.getTasksProgress,getSwapStreak:m.getSwapStreak,getProxyAccounts:_.getProxyAccounts,updateProxyAccounts:_.updateProxyAccounts,getNftMultiplier:m.getNftMultiplier,monitor:v.monitor,callRelayerSolanaTransactBatchAPI:y.callRelayerSolanaTransactBatchAPI,seedlessInit:b.seedlessInit,seedlessBackup:b.seedlessBackup,seedlessCheckPassword:b.seedlessCheckPassword,seedlessStatus:b.seedlessStatus,seedlessSalt:b.seedlessSalt,getScheduledTransactions:e.getScheduledTransactions,getTemporaryWalletNonces:x.getTemporaryWalletNonces,addTemporaryWalletNonce:x.addTemporaryWalletNonce,removeTemporaryWalletNonce:x.removeTemporaryWalletNonce,encodeMoonPayBuyUrl:S.encodeMoonPayBuyUrl,generateMoonPayQuote:S.generateMoonPayQuote,getPrivateTransactionRatio:w.getPrivateTransactionRatio,savePrivacyScoreAndGetPrivacyRank:w.savePrivacyScoreAndGetPrivacyRank,allocatePrivateSendRecipientInfos:T.allocatePrivateSendRecipientInfos,syncPrivateSendNonce:E.syncPrivateSendNonce,reservePrivateSendNonceRange:E.reservePrivateSendNonceRange,getSnapshotServerEvents:D.getSnapshotServerEvents,sendPrivateSendEmailNotifications:O.sendPrivateSendEmailNotifications,checkTronSubsidyEligibility:k.checkTronSubsidyEligibility,recordTronSubsidyUsage:k.recordTronSubsidyUsage,getDashboardAccount:A.getDashboardAccount,updateDashboardAccount:A.updateDashboardAccount,addDashboardContact:j.addDashboardContact,deleteDashboardContact:j.deleteDashboardContact,deleteDashboardAccount:A.deleteDashboardAccount,updateDashboardContact:j.updateDashboardContact,getDashboardContacts:j.getDashboardContacts,updateUserProfile:N.updateUserProfile,sendDashboardInvitationEmail:N.sendDashboardInvitationEmail,removeMember:N.removeMember,editMember:N.editMember,createDashboardPayout:M.createDashboardPayout,getDashboardPayouts:M.getDashboardPayouts,syncDashboardBalances:P.syncDashboardBalances,getDashboardBalances:P.getDashboardBalances,changePayoutStatus:M.changePayoutStatus,createDashboardTransactions:F.createDashboardTransactions,getDashboardTransactions:F.getDashboardTransactions};exports.API=I;
+const e=require(`./relayCalls.cjs`),t=require(`./getTokenPrice.cjs`),n=require(`./getOdosPriceForToken.cjs`),r=require(`./simulate-transaction.cjs`),i=require(`./simulate-batch-tx.cjs`),a=require(`./token-calls.cjs`),o=require(`./get-token-data.cjs`),s=require(`./proxyAccountsCalls.cjs`),c=require(`./callMonitor.cjs`),l=require(`./callRelayer.cjs`),u=require(`./seedless-calls.cjs`),d=require(`./temporaryWalletCalls.cjs`),f=require(`./onrampCalls.cjs`),p=require(`./get-token-price-chart-data.cjs`),m=require(`./privacy-score-calls.cjs`),h=require(`./privateSendRecipientInfoCalls.cjs`),g=require(`./privateSendNonceCalls.cjs`),_=require(`./snapshot-event-calls.cjs`),v=require(`./privateSendEmailNotificationsCalls.cjs`),y=require(`./tronSubsidyCalls.cjs`),b=require(`./dashboardAccountCalls.cjs`),x=require(`./dashboardContactCalls.cjs`),S=require(`./dashboardPayoutCalls.cjs`),C=require(`./dashboardAccountMemberCalls.cjs`),w=require(`./dashboardBalanceCalls.cjs`),T=require(`./dashboardTransactionCalls.cjs`),E=require(`./payoutNotificationStateCalls.cjs`),D=require(`./enclaveUtxoCalls.cjs`),O=require(`./rewardsUserCalls.cjs`),k=require(`./weeklyAnalyticCalls.cjs`);var A={getTokenPrices:t.getTokenPrices,getOdosPriceForToken:n.getOdosPriceForToken,getTokenPriceChartData:p.getTokenPriceChartData,getTokenPreviousDayPrices:t.getTokenPreviousDayPrices,getIdleRelay:e.getIdleRelay,getUserAnalytics:k.getUserAnalytics,updateRewardsUser:O.updateRewardsUser,getRewardsUser:O.getRewardsUser,checkUsernameAvailability:O.checkUsernameAvailability,simulateTransaction:r.simulateTransaction,simulateBatchTx:i.simulateBatchTx,tokensInfoCall:a.tokensInfoCall,getTokenData:o.getTokenData,getBalancesEnclaveCall:D.getBalancesEnclaveCall,storeClaimableKeyEnclaveCall:D.storeClaimableKeyEnclaveCall,getUtxosEnclaveCall:D.getUtxosEnclaveCall,getProxyAccounts:s.getProxyAccounts,updateProxyAccounts:s.updateProxyAccounts,monitor:c.monitor,callRelayerSolanaTransactBatchAPI:l.callRelayerSolanaTransactBatchAPI,callRelayerSolanaSponsoredBuildAPI:l.callRelayerSolanaSponsoredBuildAPI,callRelayerSolanaSponsoredSubmitAPI:l.callRelayerSolanaSponsoredSubmitAPI,seedlessInit:u.seedlessInit,seedlessBackup:u.seedlessBackup,seedlessCheckPassword:u.seedlessCheckPassword,seedlessStatus:u.seedlessStatus,seedlessSalt:u.seedlessSalt,getTemporaryWalletNonces:d.getTemporaryWalletNonces,addTemporaryWalletNonce:d.addTemporaryWalletNonce,encodeMoonPayBuyUrl:f.encodeMoonPayBuyUrl,generateMoonPayQuote:f.generateMoonPayQuote,getPrivateTransactionRatio:m.getPrivateTransactionRatio,savePrivacyScoreAndGetPrivacyRank:m.savePrivacyScoreAndGetPrivacyRank,allocateRecipientInfosEnclaveCall:h.allocateRecipientInfosEnclaveCall,syncPrivateSendNonce:g.syncPrivateSendNonce,reservePrivateSendNonceRange:g.reservePrivateSendNonceRange,getSnapshotServerEvents:_.getSnapshotServerEvents,sendPrivateSendEmailNotifications:v.sendPrivateSendEmailNotifications,checkTronSubsidyEligibility:y.checkTronSubsidyEligibility,recordTronSubsidyUsage:y.recordTronSubsidyUsage,getDashboardAccount:b.getDashboardAccount,updateDashboardAccount:b.updateDashboardAccount,addDashboardContact:x.addDashboardContact,deleteDashboardContact:x.deleteDashboardContact,deleteDashboardAccount:b.deleteDashboardAccount,updateDashboardContact:x.updateDashboardContact,getDashboardContacts:x.getDashboardContacts,updateUserProfile:C.updateUserProfile,sendDashboardInvitationEmail:C.sendDashboardInvitationEmail,resolveInviteRequest:C.resolveInviteRequest,deleteInviteRequest:C.deleteInviteRequest,removeMember:C.removeMember,editMember:C.editMember,createDashboardPayout:S.createDashboardPayout,getDashboardPayouts:S.getDashboardPayouts,syncDashboardBalances:w.syncDashboardBalances,getDashboardBalances:w.getDashboardBalances,changePayoutStatus:S.changePayoutStatus,createDashboardTransactions:T.createDashboardTransactions,getDashboardTransactions:T.getDashboardTransactions,getDashboardScheduledTransactions:T.getDashboardScheduledTransactions,getPayoutNotifications:E.getPayoutNotifications,markPayoutNotificationsRead:E.markPayoutNotificationsRead,dismissPayoutNotification:E.dismissPayoutNotification};exports.API=A;

package/common/src/API/API.d.ts

@@ -0,0 +1,97 @@
+import { getIdleRelay } from './relayCalls';
+import { getTokenPreviousDayPrices, getTokenPrices } from './getTokenPrice';
+import { getOdosPriceForToken } from './getOdosPriceForToken';
+import { simulateTransaction } from './simulate-transaction';
+import { simulateBatchTx } from './simulate-batch-tx';
+import { tokensInfoCall } from './token-calls';
+import { getTokenData } from './get-token-data';
+import { getProxyAccounts, updateProxyAccounts } from './proxyAccountsCalls';
+import { monitor } from './callMonitor';
+import { callRelayerSolanaSponsoredBuildAPI, callRelayerSolanaSponsoredSubmitAPI, callRelayerSolanaTransactBatchAPI } from './callRelayer';
+import { seedlessBackup, seedlessCheckPassword, seedlessInit, seedlessSalt, seedlessStatus } from './seedless-calls';
+import { addTemporaryWalletNonce, getTemporaryWalletNonces } from './temporaryWalletCalls';
+import { encodeMoonPayBuyUrl, generateMoonPayQuote } from './onrampCalls';
+import { getTokenPriceChartData } from './get-token-price-chart-data';
+import { getPrivateTransactionRatio, savePrivacyScoreAndGetPrivacyRank } from './privacy-score-calls';
+import { allocateRecipientInfosEnclaveCall } from './privateSendRecipientInfoCalls';
+import { reservePrivateSendNonceRange, syncPrivateSendNonce } from './privateSendNonceCalls';
+import { getSnapshotServerEvents } from './snapshot-event-calls';
+import { sendPrivateSendEmailNotifications } from './privateSendEmailNotificationsCalls';
+import { checkTronSubsidyEligibility, recordTronSubsidyUsage } from './tronSubsidyCalls';
+import { deleteDashboardAccount, getDashboardAccount, updateDashboardAccount } from './dashboardAccountCalls';
+import { addDashboardContact, deleteDashboardContact, getDashboardContacts, updateDashboardContact } from './dashboardContactCalls';
+import { changePayoutStatus, createDashboardPayout, getDashboardPayouts } from './dashboardPayoutCalls';
+import { deleteInviteRequest, editMember, removeMember, resolveInviteRequest, sendDashboardInvitationEmail, updateUserProfile } from './dashboardAccountMemberCalls';
+import { getDashboardBalances, syncDashboardBalances } from './dashboardBalanceCalls';
+import { createDashboardTransactions, getDashboardScheduledTransactions, getDashboardTransactions } from './dashboardTransactionCalls';
+import { dismissPayoutNotification, getPayoutNotifications, markPayoutNotificationsRead } from './payoutNotificationStateCalls';
+import { getBalancesEnclaveCall, getUtxosEnclaveCall, storeClaimableKeyEnclaveCall } from './enclaveUtxoCalls';
+import { checkUsernameAvailability, getRewardsUser, updateRewardsUser } from './rewardsUserCalls';
+import { getUserAnalytics } from './weeklyAnalyticCalls';
+export type IAPI = {
+    getTokenPrices: typeof getTokenPrices;
+    getOdosPriceForToken: typeof getOdosPriceForToken;
+    getTokenPriceChartData: typeof getTokenPriceChartData;
+    getTokenPreviousDayPrices: typeof getTokenPreviousDayPrices;
+    getIdleRelay: typeof getIdleRelay;
+    simulateTransaction: typeof simulateTransaction;
+    simulateBatchTx: typeof simulateBatchTx;
+    tokensInfoCall: typeof tokensInfoCall;
+    getTokenData: typeof getTokenData;
+    getBalancesEnclaveCall: typeof getBalancesEnclaveCall;
+    storeClaimableKeyEnclaveCall: typeof storeClaimableKeyEnclaveCall;
+    getUtxosEnclaveCall: typeof getUtxosEnclaveCall;
+    getUserAnalytics: typeof getUserAnalytics;
+    updateRewardsUser: typeof updateRewardsUser;
+    getRewardsUser: typeof getRewardsUser;
+    checkUsernameAvailability: typeof checkUsernameAvailability;
+    getProxyAccounts: typeof getProxyAccounts;
+    updateProxyAccounts: typeof updateProxyAccounts;
+    monitor: typeof monitor;
+    callRelayerSolanaTransactBatchAPI: typeof callRelayerSolanaTransactBatchAPI;
+    callRelayerSolanaSponsoredBuildAPI: typeof callRelayerSolanaSponsoredBuildAPI;
+    callRelayerSolanaSponsoredSubmitAPI: typeof callRelayerSolanaSponsoredSubmitAPI;
+    seedlessInit: typeof seedlessInit;
+    seedlessBackup: typeof seedlessBackup;
+    seedlessCheckPassword: typeof seedlessCheckPassword;
+    seedlessStatus: typeof seedlessStatus;
+    seedlessSalt: typeof seedlessSalt;
+    getTemporaryWalletNonces: typeof getTemporaryWalletNonces;
+    addTemporaryWalletNonce: typeof addTemporaryWalletNonce;
+    encodeMoonPayBuyUrl: typeof encodeMoonPayBuyUrl;
+    generateMoonPayQuote: typeof generateMoonPayQuote;
+    getPrivateTransactionRatio: typeof getPrivateTransactionRatio;
+    savePrivacyScoreAndGetPrivacyRank: typeof savePrivacyScoreAndGetPrivacyRank;
+    allocateRecipientInfosEnclaveCall: typeof allocateRecipientInfosEnclaveCall;
+    syncPrivateSendNonce: typeof syncPrivateSendNonce;
+    reservePrivateSendNonceRange: typeof reservePrivateSendNonceRange;
+    getSnapshotServerEvents: typeof getSnapshotServerEvents;
+    sendPrivateSendEmailNotifications: typeof sendPrivateSendEmailNotifications;
+    checkTronSubsidyEligibility: typeof checkTronSubsidyEligibility;
+    recordTronSubsidyUsage: typeof recordTronSubsidyUsage;
+    getDashboardAccount: typeof getDashboardAccount;
+    updateDashboardAccount: typeof updateDashboardAccount;
+    deleteDashboardAccount: typeof deleteDashboardAccount;
+    updateUserProfile: typeof updateUserProfile;
+    addDashboardContact: typeof addDashboardContact;
+    deleteDashboardContact: typeof deleteDashboardContact;
+    updateDashboardContact: typeof updateDashboardContact;
+    getDashboardContacts: typeof getDashboardContacts;
+    sendDashboardInvitationEmail: typeof sendDashboardInvitationEmail;
+    resolveInviteRequest: typeof resolveInviteRequest;
+    deleteInviteRequest: typeof deleteInviteRequest;
+    removeMember: typeof removeMember;
+    editMember: typeof editMember;
+    createDashboardPayout: typeof createDashboardPayout;
+    getDashboardPayouts: typeof getDashboardPayouts;
+    syncDashboardBalances: typeof syncDashboardBalances;
+    getDashboardBalances: typeof getDashboardBalances;
+    changePayoutStatus: typeof changePayoutStatus;
+    createDashboardTransactions: typeof createDashboardTransactions;
+    getDashboardTransactions: typeof getDashboardTransactions;
+    getDashboardScheduledTransactions: typeof getDashboardScheduledTransactions;
+    getPayoutNotifications: typeof getPayoutNotifications;
+    markPayoutNotificationsRead: typeof markPayoutNotificationsRead;
+    dismissPayoutNotification: typeof dismissPayoutNotification;
+};
+export declare const API: IAPI;

package/common/src/API/API.mjs

@@ -1,124 +1,99 @@
-import { getScheduledTransactions as e } from "./scheduled-transactions-calls.mjs";
-import { getIdleRelay as t } from "./relayCalls.mjs";
-import { getTokenPreviousDayPrices as n, getTokenPrices as r } from "./getTokenPrice.mjs";
-import { getOdosPriceForToken as i } from "./callOdosAPI.mjs";
-import { simulateTransaction as a } from "./simulate-transaction.mjs";
-import { simulateBatchTx as o } from "./simulate-batch-tx.mjs";
-import { tokensInfoCall as s } from "./token-calls.mjs";
-import { getTokenData as c } from "./get-token-data.mjs";
-import { decryptUtxoEnclaveCall as l, getUtxosEnclaveCall as u, storeUtxoEnclaveCall as d } from "./enclaveUtxoCalls.mjs";
-import { generateAumPoints as f, generateTradingPoints as p } from "./generate-trading-points.mjs";
-import { createBrotherhood as m, editBrotherhood as h, getBrotherhood as g, getBrotherhoodUsers as _, getCurrentUserBrotherhood as v, getCurrentUserBrotherhoodUsers as y, getPublicBrotherhoods as b, joinBrotherhood as x, leaveBrotherhood as S } from "./brotherhoodCalls.mjs";
-import { getBrotherhoodsLeaderboard as C, getUserCurrentLeaderboard as w } from "./leaderboardCalls.mjs";
-import { getCurrentUserAppliedReferralCode as T, getCurrentUserReferral as E, submitReferralCode as D } from "./referralsCalls.mjs";
-import { getAccessCodeBenefits as O, submitAccessCode as k } from "./accessCodeCalls.mjs";
-import { checkUsernameAvailability as A, connectRewardsUser as j, disconnectSocialNetwork as M, getNftMultiplier as N, getRewardsUser as P, getSwapStreak as F, getTasksProgress as I, updateRewardsUser as L } from "./rewardsUserCalls.mjs";
-import { getBrotherhoodAnalytics as R, getUserAnalytics as z } from "./weeklyAnalyticCalls.mjs";
-import { sendTelegramCallback as B } from "./send-telegram-callback.mjs";
-import { getProxyAccounts as V, updateProxyAccounts as H } from "./proxyAccountsCalls.mjs";
-import { monitor as U } from "./callMonitor.mjs";
-import { callRelayerSolanaTransactBatchAPI as W } from "./callRelayer.mjs";
-import { seedlessBackup as G, seedlessCheckPassword as K, seedlessInit as q, seedlessSalt as J, seedlessStatus as Y } from "./seedless-calls.mjs";
-import { addTemporaryWalletNonce as X, getTemporaryWalletNonces as Z, removeTemporaryWalletNonce as Q } from "./temporaryWalletCalls.mjs";
-import { encodeMoonPayBuyUrl as $, generateMoonPayQuote as ee } from "./onrampCalls.mjs";
-import { getTokenPriceChartData as te } from "./get-token-price-chart-data.mjs";
-import { getPrivateTransactionRatio as ne, savePrivacyScoreAndGetPrivacyRank as re } from "./privacy-score-calls.mjs";
-import { allocatePrivateSendRecipientInfos as ie } from "./privateSendRecipientInfoCalls.mjs";
-import { reservePrivateSendNonceRange as ae, syncPrivateSendNonce as oe } from "./privateSendNonceCalls.mjs";
-import { getSnapshotServerEvents as se } from "./snapshot-event-calls.mjs";
-import { sendPrivateSendEmailNotifications as ce } from "./privateSendEmailNotificationsCalls.mjs";
-import { checkTronSubsidyEligibility as le, recordTronSubsidyUsage as ue } from "./tronSubsidyCalls.mjs";
-import { deleteDashboardAccount as de, getDashboardAccount as fe, updateDashboardAccount as pe } from "./dashboardAccountCalls.mjs";
-import { addDashboardContact as me, deleteDashboardContact as he, getDashboardContacts as ge, updateDashboardContact as _e } from "./dashboardContactCalls.mjs";
-import { changePayoutStatus as ve, createDashboardPayout as ye, getDashboardPayouts as be } from "./dashboardPayoutCalls.mjs";
-import { editMember as xe, removeMember as Se, sendDashboardInvitationEmail as Ce, updateUserProfile as we } from "./dashboardAccountMemberCalls.mjs";
-import { getDashboardBalances as Te, syncDashboardBalances as Ee } from "./dashboardBalanceCalls.mjs";
-import { createDashboardTransactions as De, getDashboardTransactions as Oe } from "./dashboardTransactionCalls.mjs";
+import { getIdleRelay as e } from "./relayCalls.mjs";
+import { getTokenPreviousDayPrices as t, getTokenPrices as n } from "./getTokenPrice.mjs";
+import { getOdosPriceForToken as r } from "./getOdosPriceForToken.mjs";
+import { simulateTransaction as i } from "./simulate-transaction.mjs";
+import { simulateBatchTx as a } from "./simulate-batch-tx.mjs";
+import { tokensInfoCall as o } from "./token-calls.mjs";
+import { getTokenData as s } from "./get-token-data.mjs";
+import { getProxyAccounts as c, updateProxyAccounts as l } from "./proxyAccountsCalls.mjs";
+import { monitor as u } from "./callMonitor.mjs";
+import { callRelayerSolanaSponsoredBuildAPI as d, callRelayerSolanaSponsoredSubmitAPI as f, callRelayerSolanaTransactBatchAPI as p } from "./callRelayer.mjs";
+import { seedlessBackup as m, seedlessCheckPassword as h, seedlessInit as g, seedlessSalt as _, seedlessStatus as v } from "./seedless-calls.mjs";
+import { addTemporaryWalletNonce as y, getTemporaryWalletNonces as b } from "./temporaryWalletCalls.mjs";
+import { encodeMoonPayBuyUrl as x, generateMoonPayQuote as S } from "./onrampCalls.mjs";
+import { getTokenPriceChartData as C } from "./get-token-price-chart-data.mjs";
+import { getPrivateTransactionRatio as w, savePrivacyScoreAndGetPrivacyRank as T } from "./privacy-score-calls.mjs";
+import { allocateRecipientInfosEnclaveCall as E } from "./privateSendRecipientInfoCalls.mjs";
+import { reservePrivateSendNonceRange as D, syncPrivateSendNonce as O } from "./privateSendNonceCalls.mjs";
+import { getSnapshotServerEvents as k } from "./snapshot-event-calls.mjs";
+import { sendPrivateSendEmailNotifications as A } from "./privateSendEmailNotificationsCalls.mjs";
+import { checkTronSubsidyEligibility as j, recordTronSubsidyUsage as M } from "./tronSubsidyCalls.mjs";
+import { deleteDashboardAccount as N, getDashboardAccount as P, updateDashboardAccount as F } from "./dashboardAccountCalls.mjs";
+import { addDashboardContact as I, deleteDashboardContact as L, getDashboardContacts as R, updateDashboardContact as z } from "./dashboardContactCalls.mjs";
+import { changePayoutStatus as B, createDashboardPayout as V, getDashboardPayouts as H } from "./dashboardPayoutCalls.mjs";
+import { deleteInviteRequest as U, editMember as W, removeMember as G, resolveInviteRequest as K, sendDashboardInvitationEmail as q, updateUserProfile as J } from "./dashboardAccountMemberCalls.mjs";
+import { getDashboardBalances as Y, syncDashboardBalances as X } from "./dashboardBalanceCalls.mjs";
+import { createDashboardTransactions as Z, getDashboardScheduledTransactions as Q, getDashboardTransactions as $ } from "./dashboardTransactionCalls.mjs";
+import { dismissPayoutNotification as ee, getPayoutNotifications as te, markPayoutNotificationsRead as ne } from "./payoutNotificationStateCalls.mjs";
+import { getBalancesEnclaveCall as re, getUtxosEnclaveCall as ie, storeClaimableKeyEnclaveCall as ae } from "./enclaveUtxoCalls.mjs";
+import { checkUsernameAvailability as oe, getRewardsUser as se, updateRewardsUser as ce } from "./rewardsUserCalls.mjs";
+import { getUserAnalytics as le } from "./weeklyAnalyticCalls.mjs";
 //#region libs/shared/common/src/API/API.ts
-var ke = {
-	getTokenPrices: r,
-	getOdosPriceForToken: i,
-	getTokenPriceChartData: te,
-	getTokenPreviousDayPrices: n,
-	getIdleRelay: t,
-	generateTradingPoints: p,
-	generateAumPoints: f,
-	getBrotherhoodUsers: _,
-	getCurrentUserBrotherhoodUsers: y,
-	getBrotherhood: g,
-	editBrotherhood: h,
-	createBrotherhood: m,
-	getCurrentUserBrotherhood: v,
-	getPublicBrotherhoods: b,
-	leaveBrotherhood: S,
-	joinBrotherhood: x,
-	getUserAnalytics: z,
-	getBrotherhoodAnalytics: R,
-	connectRewardsUser: j,
-	updateRewardsUser: L,
-	getRewardsUser: P,
-	checkUsernameAvailability: A,
-	disconnectSocialNetwork: M,
-	getUserCurrentLeaderboard: w,
-	getBrotherhoodsLeaderboard: C,
-	getCurrentUserReferral: E,
-	submitReferralCode: D,
-	getCurrentUserAppliedReferralCode: T,
-	submitAccessCode: k,
-	getAccessCodeBenefits: O,
-	simulateTransaction: a,
-	simulateBatchTx: o,
-	tokensInfoCall: s,
-	getTokenData: c,
-	decryptUtxoEnclaveCall: l,
-	storeUtxoEnclaveCall: d,
-	getUtxosEnclaveCall: u,
-	sendTelegramCallback: B,
-	getTasksProgress: I,
-	getSwapStreak: F,
-	getProxyAccounts: V,
-	updateProxyAccounts: H,
-	getNftMultiplier: N,
-	monitor: U,
-	callRelayerSolanaTransactBatchAPI: W,
-	seedlessInit: q,
-	seedlessBackup: G,
-	seedlessCheckPassword: K,
-	seedlessStatus: Y,
-	seedlessSalt: J,
-	getScheduledTransactions: e,
-	getTemporaryWalletNonces: Z,
-	addTemporaryWalletNonce: X,
-	removeTemporaryWalletNonce: Q,
-	encodeMoonPayBuyUrl: $,
-	generateMoonPayQuote: ee,
-	getPrivateTransactionRatio: ne,
-	savePrivacyScoreAndGetPrivacyRank: re,
-	allocatePrivateSendRecipientInfos: ie,
-	syncPrivateSendNonce: oe,
-	reservePrivateSendNonceRange: ae,
-	getSnapshotServerEvents: se,
-	sendPrivateSendEmailNotifications: ce,
-	checkTronSubsidyEligibility: le,
-	recordTronSubsidyUsage: ue,
-	getDashboardAccount: fe,
-	updateDashboardAccount: pe,
-	addDashboardContact: me,
-	deleteDashboardContact: he,
-	deleteDashboardAccount: de,
-	updateDashboardContact: _e,
-	getDashboardContacts: ge,
-	updateUserProfile: we,
-	sendDashboardInvitationEmail: Ce,
-	removeMember: Se,
-	editMember: xe,
-	createDashboardPayout: ye,
-	getDashboardPayouts: be,
-	syncDashboardBalances: Ee,
-	getDashboardBalances: Te,
-	changePayoutStatus: ve,
-	createDashboardTransactions: De,
-	getDashboardTransactions: Oe
+var ue = {
+	getTokenPrices: n,
+	getOdosPriceForToken: r,
+	getTokenPriceChartData: C,
+	getTokenPreviousDayPrices: t,
+	getIdleRelay: e,
+	getUserAnalytics: le,
+	updateRewardsUser: ce,
+	getRewardsUser: se,
+	checkUsernameAvailability: oe,
+	simulateTransaction: i,
+	simulateBatchTx: a,
+	tokensInfoCall: o,
+	getTokenData: s,
+	getBalancesEnclaveCall: re,
+	storeClaimableKeyEnclaveCall: ae,
+	getUtxosEnclaveCall: ie,
+	getProxyAccounts: c,
+	updateProxyAccounts: l,
+	monitor: u,
+	callRelayerSolanaTransactBatchAPI: p,
+	callRelayerSolanaSponsoredBuildAPI: d,
+	callRelayerSolanaSponsoredSubmitAPI: f,
+	seedlessInit: g,
+	seedlessBackup: m,
+	seedlessCheckPassword: h,
+	seedlessStatus: v,
+	seedlessSalt: _,
+	getTemporaryWalletNonces: b,
+	addTemporaryWalletNonce: y,
+	encodeMoonPayBuyUrl: x,
+	generateMoonPayQuote: S,
+	getPrivateTransactionRatio: w,
+	savePrivacyScoreAndGetPrivacyRank: T,
+	allocateRecipientInfosEnclaveCall: E,
+	syncPrivateSendNonce: O,
+	reservePrivateSendNonceRange: D,
+	getSnapshotServerEvents: k,
+	sendPrivateSendEmailNotifications: A,
+	checkTronSubsidyEligibility: j,
+	recordTronSubsidyUsage: M,
+	getDashboardAccount: P,
+	updateDashboardAccount: F,
+	addDashboardContact: I,
+	deleteDashboardContact: L,
+	deleteDashboardAccount: N,
+	updateDashboardContact: z,
+	getDashboardContacts: R,
+	updateUserProfile: J,
+	sendDashboardInvitationEmail: q,
+	resolveInviteRequest: K,
+	deleteInviteRequest: U,
+	removeMember: G,
+	editMember: W,
+	createDashboardPayout: V,
+	getDashboardPayouts: H,
+	syncDashboardBalances: X,
+	getDashboardBalances: Y,
+	changePayoutStatus: B,
+	createDashboardTransactions: Z,
+	getDashboardTransactions: $,
+	getDashboardScheduledTransactions: Q,
+	getPayoutNotifications: te,
+	markPayoutNotificationsRead: ne,
+	dismissPayoutNotification: ee
 };
 //#endregion
-export { ke as API };
+export { ue as API };

package/common/src/API/TokenCallsCachedHelper.d.ts

@@ -0,0 +1,15 @@
+import { ERC20Token } from '../types';
+declare class TokenCallsCachedHelper {
+    private tokenCache;
+    private requestCache;
+    private post;
+    private cachedPost;
+    private postWithCacheCleanupOnError;
+    private storeTokensInCache;
+    private getCachedOrFetch;
+    tokensInfoCall(chainId: number, tokenAddresses: string[], waitForOffsetUpdate?: boolean): Promise<(ERC20Token | undefined)[]>;
+    getTokensBySymbolsCall(chainId: number, symbols: string[]): Promise<(ERC20Token | undefined)[]>;
+    getTokensForChainCall(chainId: number): Promise<ERC20Token[]>;
+}
+export declare const tokenCallsCachedHelper: TokenCallsCachedHelper;
+export {};

package/common/src/API/admin-calls.cjs

@@ -1 +1 @@
-const e=require(`../constants/server.constants.cjs`),t=require(`./getServerURL.cjs`),n=require(`../data-structures/http/HttpClient.cjs`);require(`../data-structures/http/index.cjs`);var r=r=>n.httpClient.post(`${t.RELAYER_URL}${e.RELAYER_CONFIG.emitTxPublicData}`,{adminData:r});exports.emitTxPublicData=r;
+const e=require(`../constants/server.constants.cjs`),t=require(`./getServerURL.cjs`),n=require(`../data-structures/http/HttpClient.cjs`);require(`../data-structures/http/index.cjs`);var r=r=>{if(r)return n.httpClient.post(`${t.RELAYER_URL}${e.RELAYER_CONFIG.emitTxPublicData}`,{adminData:r})};exports.emitTxPublicData=r;

package/common/src/API/admin-calls.d.ts

@@ -0,0 +1,9 @@
+import { AdminDataType } from '../types/admin.types';
+export declare const emitTxPublicData: (adminData: AdminDataType | undefined) => Promise<any> | undefined;
+export declare const emitReferralTx: (payload: {
+    txHash: string;
+    ref: string;
+    chainId: number;
+    tokenAddresses: string[];
+    amountChanges: number[];
+}) => Promise<any>;

package/common/src/API/admin-calls.mjs

@@ -3,6 +3,8 @@ import { RELAYER_URL as t } from "./getServerURL.mjs";
 import { httpClient as n } from "../data-structures/http/HttpClient.mjs";
 import "../data-structures/http/index.mjs";
 //#region libs/shared/common/src/API/admin-calls.ts
-var r = (r) => n.post(`${t}${e.emitTxPublicData}`, { adminData: r });
+var r = (r) => {
+	if (r) return n.post(`${t}${e.emitTxPublicData}`, { adminData: r });
+};
 //#endregion
 export { r as emitTxPublicData };

package/common/src/API/callLifiAPI.cjs

@@ -1 +1 @@
-require(`../constants/server.constants.cjs`),require(`./getServerURL.cjs`),require(`../data-structures/http/index.cjs`);
+const e=require(`../constants/server.constants.cjs`),t=require(`./getServerURL.cjs`),n=require(`../data-structures/http/HttpClient.cjs`);require(`../data-structures/http/index.cjs`);var r=async r=>n.httpClient.post(`${t.SERVER_URL}${e.API_CONFIG.ROUTES.callLifiAPI}`,r);exports.callLifiAPI=r;

package/common/src/API/callLifiAPI.d.ts

@@ -0,0 +1,37 @@
+export interface LifiRequestData {
+    fromChain: number;
+    toChain: number;
+    fromToken: string;
+    toToken: string;
+    fromAddress: string;
+    toAddress?: string;
+    fromAmount: string;
+    order: 'FASTEST' | 'CHEAPEST';
+    slippage: number;
+}
+export interface LifiBridgeResponse {
+    id: string;
+    type: 'swap' | 'cross' | 'lifi';
+    tool: string;
+    transactionRequest: {
+        from: string;
+        to: string;
+        chainId: string;
+        value: string;
+        data: string;
+    };
+    estimate: {
+        tool: string;
+        approvalAddress?: string;
+        fromAmount: string;
+        toAmount: string;
+        toAmountMin: string;
+        fromAmountUSD: string;
+        toAmountUSD: string;
+        executionDuration: number;
+    };
+}
+export declare const callLifiAPI: (requestBody: LifiRequestData) => Promise<{
+    status: "success";
+    lifiResponse: LifiBridgeResponse;
+}>;

package/common/src/API/callLifiAPI.mjs

@@ -1,3 +1,8 @@
-import "../constants/server.constants.mjs";
-import "./getServerURL.mjs";
+import { API_CONFIG as e } from "../constants/server.constants.mjs";
+import { SERVER_URL as t } from "./getServerURL.mjs";
+import { httpClient as n } from "../data-structures/http/HttpClient.mjs";
 import "../data-structures/http/index.mjs";
+//#region libs/shared/common/src/API/callLifiAPI.ts
+var r = async (r) => n.post(`${t}${e.ROUTES.callLifiAPI}`, r);
+//#endregion
+export { r as callLifiAPI };

package/common/src/API/callMonitor.d.ts

@@ -0,0 +1,9 @@
+export declare const monitor: (address: string) => Promise<void>;
+type MonitorBatchResponse = {
+    riskyAddresses: {
+        address: string;
+        blockedReason?: string;
+    }[];
+};
+export declare const monitorBatch: (addresses: string[]) => Promise<MonitorBatchResponse>;
+export {};

package/common/src/API/callNearIntentsAPI.cjs

@@ -1 +1 @@
-const e=require(`../constants/server.constants.cjs`),t=require(`./getServerURL.cjs`),n=require(`../data-structures/http/HttpClient.cjs`);require(`../data-structures/http/index.cjs`);var r=r=>n.httpClient.post(`${t.SERVER_URL}${e.API_CONFIG.ROUTES.callNearIntentsQuote}`,r);exports.getNearIntentsQuote=r;
+const e=require(`../constants/server.constants.cjs`),t=require(`./getServerURL.cjs`),n=require(`../data-structures/http/HttpClient.cjs`);require(`../data-structures/http/index.cjs`);var r=r=>n.httpClient.post(`${t.SERVER_URL}${e.API_CONFIG.ROUTES.callNearIntentsQuote}`,r),i=()=>n.httpClient.get(`${t.SERVER_URL}${e.API_CONFIG.ROUTES.callNearIntentsTokens}`);exports.getNearIntentsQuote=r,exports.getNearIntentsTokens=i;