@sabaaa1/common 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (445) hide show
  1. package/.env.example +5 -0
  2. package/.eslintrc.json +18 -0
  3. package/README.md +164 -0
  4. package/copyPackageJson.js +81 -0
  5. package/handleCDNWorkers.js +92 -0
  6. package/jest.config.ts +10 -0
  7. package/package.json +101 -0
  8. package/polyfillWorker.ts +15 -0
  9. package/project.json +32 -0
  10. package/src/API/API.ts +203 -0
  11. package/src/API/admin-calls.ts +8 -0
  12. package/src/API/ai-calls.ts +48 -0
  13. package/src/API/brotherhoodCalls.ts +184 -0
  14. package/src/API/callLifiAPI.ts +41 -0
  15. package/src/API/callMonitor.ts +9 -0
  16. package/src/API/callOdosAPI.ts +89 -0
  17. package/src/API/callOneInchAPI.ts +47 -0
  18. package/src/API/callRelayer.ts +23 -0
  19. package/src/API/checkRisk.ts +7 -0
  20. package/src/API/duneAPI.ts +26 -0
  21. package/src/API/enclaveCalls.ts +23 -0
  22. package/src/API/fetchCommitmentsCache.ts +63 -0
  23. package/src/API/generate-trading-points.ts +77 -0
  24. package/src/API/get-token-data.ts +12 -0
  25. package/src/API/getBridgeProtocols.ts +16 -0
  26. package/src/API/getCoingeckoPrice.ts +59 -0
  27. package/src/API/getGasEstimates.ts +30 -0
  28. package/src/API/getLifiStatus.ts +35 -0
  29. package/src/API/getRelayerURL.ts +27 -0
  30. package/src/API/getServerURL.ts +116 -0
  31. package/src/API/getTokenPrice.ts +39 -0
  32. package/src/API/getWebsiteURL.ts +58 -0
  33. package/src/API/index.ts +19 -0
  34. package/src/API/is-tx-stateless.ts +32 -0
  35. package/src/API/kycCalls.ts +81 -0
  36. package/src/API/leaderboardCalls.ts +32 -0
  37. package/src/API/mysteryBoxesCalls.ts +141 -0
  38. package/src/API/passwordCalls.ts +34 -0
  39. package/src/API/proxyAccountsCalls.ts +40 -0
  40. package/src/API/referralsCalls.ts +52 -0
  41. package/src/API/relayCalls.ts +14 -0
  42. package/src/API/restoreSnapshots.ts +7 -0
  43. package/src/API/rewardsUserCalls.ts +124 -0
  44. package/src/API/send-telegram-callback.ts +17 -0
  45. package/src/API/simulate-batch-tx.ts +19 -0
  46. package/src/API/tenderly.api.ts +96 -0
  47. package/src/API/token-calls.ts +19 -0
  48. package/src/API/weeklyAnalyticCalls.ts +43 -0
  49. package/src/constants/activity.constants.ts +10 -0
  50. package/src/constants/addresses.constants.ts +74 -0
  51. package/src/constants/assets.constants.ts +15 -0
  52. package/src/constants/backend.constants.ts +16 -0
  53. package/src/constants/balance.constants.ts +1 -0
  54. package/src/constants/bridging.constants.ts +5 -0
  55. package/src/constants/chains.constants.ts +194 -0
  56. package/src/constants/coingecko.constants.ts +67 -0
  57. package/src/constants/contracts.constants.ts +106 -0
  58. package/src/constants/conversion.constants.ts +1 -0
  59. package/src/constants/deploy-data/deploy-data-arbMainnet.json +5685 -0
  60. package/src/constants/deploy-data/deploy-data-arcTestnet.json +6157 -0
  61. package/src/constants/deploy-data/deploy-data-avalanche.json +5921 -0
  62. package/src/constants/deploy-data/deploy-data-base.json +5695 -0
  63. package/src/constants/deploy-data/deploy-data-bnbMainnet.json +5921 -0
  64. package/src/constants/deploy-data/deploy-data-ethMainnet.json +5922 -0
  65. package/src/constants/deploy-data/deploy-data-localhost.json +5921 -0
  66. package/src/constants/deploy-data/deploy-data-optimism.json +5687 -0
  67. package/src/constants/deploy-data/deploy-data-polygon.json +5695 -0
  68. package/src/constants/deploy-data/index.ts +21 -0
  69. package/src/constants/events.constants.ts +10 -0
  70. package/src/constants/fees.constants.ts +4 -0
  71. package/src/constants/function-signatures.constants.ts +6 -0
  72. package/src/constants/index.ts +30 -0
  73. package/src/constants/kyc.constants.ts +202 -0
  74. package/src/constants/lifi.constants.ts +1 -0
  75. package/src/constants/mediaUrls.constants.ts +25 -0
  76. package/src/constants/mystery-boxes.constants.ts +402 -0
  77. package/src/constants/oauthUrls.constants.ts +7 -0
  78. package/src/constants/permit2.constants.ts +28 -0
  79. package/src/constants/presale.constants.ts +503 -0
  80. package/src/constants/protocol.constants.ts +65 -0
  81. package/src/constants/reorg-depths.constants.ts +13 -0
  82. package/src/constants/rewards.constants.ts +27 -0
  83. package/src/constants/save-depths.ts +13 -0
  84. package/src/constants/server.constants.ts +233 -0
  85. package/src/constants/tasks.constants.ts +205 -0
  86. package/src/constants/token-data/ERC20Registry.ts +90 -0
  87. package/src/constants/token-data/arbMainnetRegistry.json +1841 -0
  88. package/src/constants/token-data/arbMainnetRegistryFixed.json +1841 -0
  89. package/src/constants/token-data/arcTestnetRegistry.json +436 -0
  90. package/src/constants/token-data/avalancheRegistry.json +729 -0
  91. package/src/constants/token-data/avalancheRegistryFixed.json +729 -0
  92. package/src/constants/token-data/baseRegistry.json +1134 -0
  93. package/src/constants/token-data/baseRegistryFixed.json +1134 -0
  94. package/src/constants/token-data/bnbMainnetRegistry.json +900 -0
  95. package/src/constants/token-data/bnbMainnetRegistryFixed.json +900 -0
  96. package/src/constants/token-data/ethMainnetRegistry.json +4298 -0
  97. package/src/constants/token-data/ethMainnetRegistryFixed.json +4298 -0
  98. package/src/constants/token-data/index.ts +60 -0
  99. package/src/constants/token-data/localhostRegistry.json +2784 -0
  100. package/src/constants/token-data/optimismRegistry.json +701 -0
  101. package/src/constants/token-data/optimismRegistryFixed.json +701 -0
  102. package/src/constants/token-data/polygonRegistry.json +2309 -0
  103. package/src/constants/token-data/polygonRegistryFixed.json +2309 -0
  104. package/src/constants/token-data/popularTokens.constants.ts +11 -0
  105. package/src/constants/token-data/tokenPricing.consts.ts +2 -0
  106. package/src/constants/token.limits.constants.ts +31 -0
  107. package/src/constants/vite.constants.ts +74 -0
  108. package/src/constants/wallet.constants.ts +9 -0
  109. package/src/crypto/babyJub.ts +31 -0
  110. package/src/crypto/index.ts +3 -0
  111. package/src/crypto/poseidon.ts +36 -0
  112. package/src/crypto/preProcessing.ts +20 -0
  113. package/src/data-structures/ApprovalDBs/EventsPublicApprovalsDB.ts +288 -0
  114. package/src/data-structures/ApprovalDBs/index.ts +1 -0
  115. package/src/data-structures/Hinkal/Hinkal.ts +746 -0
  116. package/src/data-structures/Hinkal/IHinkal.ts +315 -0
  117. package/src/data-structures/Hinkal/handleAutoDepositBack.ts +138 -0
  118. package/src/data-structures/Hinkal/hinkalActionFundApproveAndTransact.ts +64 -0
  119. package/src/data-structures/Hinkal/hinkalActionReceive.ts +65 -0
  120. package/src/data-structures/Hinkal/hinkalActionStake.ts +152 -0
  121. package/src/data-structures/Hinkal/hinkalApprove.ts +170 -0
  122. package/src/data-structures/Hinkal/hinkalCheckTokenRegistry.ts +26 -0
  123. package/src/data-structures/Hinkal/hinkalDeposit.ts +199 -0
  124. package/src/data-structures/Hinkal/hinkalGetRecipientInfo.ts +12 -0
  125. package/src/data-structures/Hinkal/hinkalGetZkMeProvider.ts +31 -0
  126. package/src/data-structures/Hinkal/hinkalInsideTransact.ts +190 -0
  127. package/src/data-structures/Hinkal/hinkalMultiSend.ts +26 -0
  128. package/src/data-structures/Hinkal/hinkalPrivateWallet.ts +198 -0
  129. package/src/data-structures/Hinkal/hinkalProoflessDeposit.ts +91 -0
  130. package/src/data-structures/Hinkal/hinkalProxySwap.ts +91 -0
  131. package/src/data-structures/Hinkal/hinkalSignSubAccount.ts +28 -0
  132. package/src/data-structures/Hinkal/hinkalSwap.ts +157 -0
  133. package/src/data-structures/Hinkal/hinkalTransfer.ts +171 -0
  134. package/src/data-structures/Hinkal/hinkalWithdraw.ts +161 -0
  135. package/src/data-structures/Hinkal/index.ts +9 -0
  136. package/src/data-structures/Hinkal/resetMerkleTrees.ts +64 -0
  137. package/src/data-structures/IndexedDB/activity-db.ts +204 -0
  138. package/src/data-structures/IndexedDB/balances-db.ts +97 -0
  139. package/src/data-structures/IndexedDB/contact-db.ts +81 -0
  140. package/src/data-structures/IndexedDB/index.ts +6 -0
  141. package/src/data-structures/IndexedDB/prices-db.ts +89 -0
  142. package/src/data-structures/IndexedDB/private-balances-db.ts +31 -0
  143. package/src/data-structures/IndexedDB/signatures-db.ts +62 -0
  144. package/src/data-structures/MultiThreadedUtxoUtils/MultiThreadedUtxoUtils.ts +152 -0
  145. package/src/data-structures/TokenDBs/AlchemyPublicTokensDB.ts +224 -0
  146. package/src/data-structures/TokenDBs/ArcPublicTokensDB.ts +198 -0
  147. package/src/data-structures/TokenDBs/EventsPublicTokensDB.ts +216 -0
  148. package/src/data-structures/TokenDBs/IPublicTokensDB.ts +7 -0
  149. package/src/data-structures/TokenDBs/PrivateTokensDB.ts +96 -0
  150. package/src/data-structures/TokenDBs/PublicTokensDB.ts +49 -0
  151. package/src/data-structures/TokenDBs/index.ts +4 -0
  152. package/src/data-structures/TokenDBs/token-visibility-db.ts +154 -0
  153. package/src/data-structures/ValueCache/ValueCache.ts +29 -0
  154. package/src/data-structures/ValueCache/index.ts +1 -0
  155. package/src/data-structures/cacheDevices/AttachableMemoryCacheDevice.ts +33 -0
  156. package/src/data-structures/cacheDevices/BaseCacheDevice.ts +30 -0
  157. package/src/data-structures/cacheDevices/FileCacheDevice.ts +59 -0
  158. package/src/data-structures/cacheDevices/LocalStorageCacheDevice.ts +36 -0
  159. package/src/data-structures/cacheDevices/index.ts +2 -0
  160. package/src/data-structures/crypto-keys/decodeUTXO.ts +60 -0
  161. package/src/data-structures/crypto-keys/encryptDecryptUtxo.ts +74 -0
  162. package/src/data-structures/crypto-keys/index.ts +4 -0
  163. package/src/data-structures/crypto-keys/keyUtils.ts +8 -0
  164. package/src/data-structures/crypto-keys/keys.ts +203 -0
  165. package/src/data-structures/custom-token-registry/CustomTokenRegistry.ts +49 -0
  166. package/src/data-structures/event-service/AbstractAccessTokenSnapshotService.ts +142 -0
  167. package/src/data-structures/event-service/AbstractApprovalsSnapshotService.ts +152 -0
  168. package/src/data-structures/event-service/AbstractCommitmentsSnapshotService.ts +116 -0
  169. package/src/data-structures/event-service/AbstractEventService.ts +44 -0
  170. package/src/data-structures/event-service/AbstractNullifierSnapshotService.ts +76 -0
  171. package/src/data-structures/event-service/AbstractSnapshotService.ts +63 -0
  172. package/src/data-structures/event-service/BlockchainEventEmitter.ts +132 -0
  173. package/src/data-structures/event-service/index.ts +7 -0
  174. package/src/data-structures/index.ts +18 -0
  175. package/src/data-structures/merkle-tree/MerkleTree.test.ts +77 -0
  176. package/src/data-structures/merkle-tree/MerkleTree.ts +253 -0
  177. package/src/data-structures/merkle-tree/MerkleTreeIncompleteError.ts +6 -0
  178. package/src/data-structures/merkle-tree/getPatchedAccessTokenMerkleTree.ts +24 -0
  179. package/src/data-structures/merkle-tree/index.ts +3 -0
  180. package/src/data-structures/presale/PresaleContractWrapper.ts +80 -0
  181. package/src/data-structures/presale/index.ts +1 -0
  182. package/src/data-structures/provider-adapter/IProviderAdapter.ts +43 -0
  183. package/src/data-structures/snapshot/ClientAccessTokenSnapshotService.ts +41 -0
  184. package/src/data-structures/snapshot/ClientApprovalsSnapshotService.ts +36 -0
  185. package/src/data-structures/snapshot/ClientCommitmentsSnapshotService.ts +30 -0
  186. package/src/data-structures/snapshot/ClientNullifierSnapshotService.ts +28 -0
  187. package/src/data-structures/snapshot/SnapshotFetcherService.ts +68 -0
  188. package/src/data-structures/snapshot/index.ts +1 -0
  189. package/src/data-structures/token-price-fetcher/TokenChecker.ts +45 -0
  190. package/src/data-structures/token-price-fetcher/index.ts +1 -0
  191. package/src/data-structures/tor/HttpClient.ts +118 -0
  192. package/src/data-structures/tor/TorAdapter.ts +94 -0
  193. package/src/data-structures/tor/TorClient.ts +283 -0
  194. package/src/data-structures/tor/WebSocketDuplex.ts +32 -0
  195. package/src/data-structures/tor/index.ts +3 -0
  196. package/src/data-structures/transactions-manager/history/history.types.ts +14 -0
  197. package/src/data-structures/transactions-manager/index.ts +1 -0
  198. package/src/data-structures/utxo/Utxo.ts +189 -0
  199. package/src/error-handling/customErrors/ErrorWithAmount.ts +8 -0
  200. package/src/error-handling/customErrors/ErrorWithTx.ts +10 -0
  201. package/src/error-handling/customErrors/FeeOverTransactionValueError.ts +16 -0
  202. package/src/error-handling/customErrors/SimulationFailureError.ts +9 -0
  203. package/src/error-handling/customErrors/customErrors.helpers.ts +39 -0
  204. package/src/error-handling/customErrors/index.ts +5 -0
  205. package/src/error-handling/error-codes.constants.ts +214 -0
  206. package/src/error-handling/get-error.message.ts +149 -0
  207. package/src/error-handling/handleErrorRestore.ts +25 -0
  208. package/src/error-handling/index.ts +7 -0
  209. package/src/error-handling/logError.ts +8 -0
  210. package/src/error-handling/logger.ts +21 -0
  211. package/src/error-handling/types.ts +10 -0
  212. package/src/externalABIs/BUSD.ts +516 -0
  213. package/src/externalABIs/BabPassport.json +24 -0
  214. package/src/externalABIs/DAI.ts +331 -0
  215. package/src/externalABIs/ERC1155.json +316 -0
  216. package/src/externalABIs/ERC20.json +297 -0
  217. package/src/externalABIs/ERC20.ts +1 -0
  218. package/src/externalABIs/ERC721.json +205 -0
  219. package/src/externalABIs/GalxePassport.json +23 -0
  220. package/src/externalABIs/IQuoterV2.json +211 -0
  221. package/src/externalABIs/ISwapRouter.json +568 -0
  222. package/src/externalABIs/IUniswapV3Factory.json +207 -0
  223. package/src/externalABIs/IUniswapV3Pool.json +999 -0
  224. package/src/externalABIs/NodeInterfaceABI.json +1 -0
  225. package/src/externalABIs/OptimismGasPriceOracle.json +1 -0
  226. package/src/externalABIs/PoLidoNftAbi.json +307 -0
  227. package/src/externalABIs/SanctionsList.ts +86 -0
  228. package/src/externalABIs/USDC.ts +718 -0
  229. package/src/externalABIs/USDR.ts +343 -0
  230. package/src/externalABIs/USDR3CRV.ts +539 -0
  231. package/src/externalABIs/USDT.ts +390 -0
  232. package/src/externalABIs/UniswapV2PoolAbi.json +66 -0
  233. package/src/externalABIs/WETH.ts +153 -0
  234. package/src/externalABIs/amToken.ts +347 -0
  235. package/src/externalABIs/index.ts +53 -0
  236. package/src/externalABIs/swapAbi.ts +442 -0
  237. package/src/externalABIs/transactionsProver.json +45 -0
  238. package/src/functions/index.ts +16 -0
  239. package/src/functions/kyc/aiPriseHelper.ts +0 -0
  240. package/src/functions/kyc/authentoHelper.ts +44 -0
  241. package/src/functions/kyc/index.ts +3 -0
  242. package/src/functions/kyc/openDefaultPassportWindow.ts +9 -0
  243. package/src/functions/kyc/passportHelper.ts +13 -0
  244. package/src/functions/kyc/zkMeHelper.ts +69 -0
  245. package/src/functions/pre-transaction/constructAdminData.ts +21 -0
  246. package/src/functions/pre-transaction/getExternalSwapAddress.ts +30 -0
  247. package/src/functions/pre-transaction/getFeeStructure.ts +44 -0
  248. package/src/functions/pre-transaction/getFlatFees.ts +88 -0
  249. package/src/functions/pre-transaction/getSignatureDataForTransact.ts +16 -0
  250. package/src/functions/pre-transaction/getVolatileTransferAmount.ts +56 -0
  251. package/src/functions/pre-transaction/index.ts +7 -0
  252. package/src/functions/pre-transaction/interaction-to-action.ts +17 -0
  253. package/src/functions/pre-transaction/merge-with-fee-structure-emporium.ts +50 -0
  254. package/src/functions/pre-transaction/merge-with-fee-structure.ts +35 -0
  255. package/src/functions/pre-transaction/outputApprovalDataProcessing.ts +95 -0
  256. package/src/functions/pre-transaction/outputUtxoProcessing.ts +52 -0
  257. package/src/functions/pre-transaction/process-gas-estimates.ts +36 -0
  258. package/src/functions/pre-transaction/shouldPatchAccessTokenMerkleTree.ts +15 -0
  259. package/src/functions/private-wallet/emporium.helpers.ts +296 -0
  260. package/src/functions/private-wallet/emporium.swap.helpers.ts +284 -0
  261. package/src/functions/private-wallet/index.ts +3 -0
  262. package/src/functions/private-wallet/opProducer.ts +33 -0
  263. package/src/functions/snarkjs/common.snarkjs.ts +377 -0
  264. package/src/functions/snarkjs/constant.ts +490 -0
  265. package/src/functions/snarkjs/constructEmporiumProof.ts +301 -0
  266. package/src/functions/snarkjs/constructGeneralZkProof.ts +281 -0
  267. package/src/functions/snarkjs/generateCircomData.ts +81 -0
  268. package/src/functions/snarkjs/generateZkProof.ts +21 -0
  269. package/src/functions/snarkjs/generateZkProofEnclave.ts +45 -0
  270. package/src/functions/snarkjs/generateZkProofSelf.ts +29 -0
  271. package/src/functions/snarkjs/getOriginalSender.ts +4 -0
  272. package/src/functions/snarkjs/getZKFiles.ts +29 -0
  273. package/src/functions/snarkjs/index.ts +4 -0
  274. package/src/functions/staking/index.ts +78 -0
  275. package/src/functions/utils/addresses.ts +37 -0
  276. package/src/functions/utils/amounts.utils.test.ts +91 -0
  277. package/src/functions/utils/amounts.utils.ts +119 -0
  278. package/src/functions/utils/arraysMatch.ts +4 -0
  279. package/src/functions/utils/cacheDevice.utils.ts +21 -0
  280. package/src/functions/utils/cacheFunctions.ts +154 -0
  281. package/src/functions/utils/caseInsensitive.utils.ts +10 -0
  282. package/src/functions/utils/convertEmporiumOpToCallInfo.ts +19 -0
  283. package/src/functions/utils/convertIntegrationProviderToExternalActionId.ts +14 -0
  284. package/src/functions/utils/create-provider.ts +11 -0
  285. package/src/functions/utils/encodeTokenWithId.ts +4 -0
  286. package/src/functions/utils/encryptInputForEnclave.ts +119 -0
  287. package/src/functions/utils/enum.utils.ts +30 -0
  288. package/src/functions/utils/erc20tokenFunctions.ts +110 -0
  289. package/src/functions/utils/ethers-formatter.utils.ts +32 -0
  290. package/src/functions/utils/evmNetworkFunctions.ts +9 -0
  291. package/src/functions/utils/external-action.utils.ts +15 -0
  292. package/src/functions/utils/fees.utils.ts +26 -0
  293. package/src/functions/utils/get-hinkal-approvals.ts +36 -0
  294. package/src/functions/utils/get-signature-header.ts +5 -0
  295. package/src/functions/utils/getBlockExplorerUrl.ts +14 -0
  296. package/src/functions/utils/getDataFromTransaction.ts +79 -0
  297. package/src/functions/utils/getRecipientInfoFromUserKeys.ts +28 -0
  298. package/src/functions/utils/inLogicMetadata.ts +9 -0
  299. package/src/functions/utils/index.ts +43 -0
  300. package/src/functions/utils/involves-permit2-op.ts +17 -0
  301. package/src/functions/utils/ipfs.ts +74 -0
  302. package/src/functions/utils/is-valid-url.ts +5 -0
  303. package/src/functions/utils/lifi.utils.ts +3 -0
  304. package/src/functions/utils/memoize.utils.ts +23 -0
  305. package/src/functions/utils/merkleTree.utils.ts +27 -0
  306. package/src/functions/utils/mutexes.utils.ts +3 -0
  307. package/src/functions/utils/mystery-box-auction.utils.ts +61 -0
  308. package/src/functions/utils/networks.utils.ts +6 -0
  309. package/src/functions/utils/nftTokenFunctions.ts +25 -0
  310. package/src/functions/utils/nickname.utils.ts +4 -0
  311. package/src/functions/utils/postToOffscreen.ts +6 -0
  312. package/src/functions/utils/prepareHinkal.ts +78 -0
  313. package/src/functions/utils/process.utils.ts +23 -0
  314. package/src/functions/utils/processUseApprovalUtxoData.ts +26 -0
  315. package/src/functions/utils/publicBalance.utils.ts +131 -0
  316. package/src/functions/utils/reloadPage.ts +1 -0
  317. package/src/functions/utils/replaceAddressInCalldata.ts +6 -0
  318. package/src/functions/utils/requireEnv.ts +10 -0
  319. package/src/functions/utils/resolve-sync.utils.ts +40 -0
  320. package/src/functions/utils/rpc-int-encode.ts +7 -0
  321. package/src/functions/utils/serialize.utils.ts +12 -0
  322. package/src/functions/utils/string.utils.ts +92 -0
  323. package/src/functions/utils/time.utils.ts +80 -0
  324. package/src/functions/utils/token-check.utils.ts +12 -0
  325. package/src/functions/utils/trimFieldValues.ts +24 -0
  326. package/src/functions/utils/upToDateState.ts +12 -0
  327. package/src/functions/utils/userAgent.ts +26 -0
  328. package/src/functions/utils/walletBalances.utils.ts +117 -0
  329. package/src/functions/web3/EIP-712.test.ts +302 -0
  330. package/src/functions/web3/EIP-712.ts +243 -0
  331. package/src/functions/web3/etherFunctions.test.ts +129 -0
  332. package/src/functions/web3/etherFunctions.ts +84 -0
  333. package/src/functions/web3/events/balanceChangedCustomHandler.ts +13 -0
  334. package/src/functions/web3/events/balanceChangedHandler.ts +10 -0
  335. package/src/functions/web3/events/getApprovedBalance.ts +154 -0
  336. package/src/functions/web3/events/getInputUtxoAndBalance.ts +305 -0
  337. package/src/functions/web3/events/getInputUtxosEnclave.ts +40 -0
  338. package/src/functions/web3/events/getShieldedBalance.ts +163 -0
  339. package/src/functions/web3/events/getTransactionLogEvents.ts +55 -0
  340. package/src/functions/web3/events/index.ts +7 -0
  341. package/src/functions/web3/events/web3RetrieveEvents.ts +33 -0
  342. package/src/functions/web3/functionCalls/accessTokenCalls.ts +27 -0
  343. package/src/functions/web3/functionCalls/approveToken.ts +180 -0
  344. package/src/functions/web3/functionCalls/approveTokensToHinkal.ts +21 -0
  345. package/src/functions/web3/functionCalls/estimateGasRelayer.ts +40 -0
  346. package/src/functions/web3/functionCalls/getRootHash.ts +7 -0
  347. package/src/functions/web3/functionCalls/inHinkalApprovalCalls.ts +60 -0
  348. package/src/functions/web3/functionCalls/relayFunctions.ts +12 -0
  349. package/src/functions/web3/functionCalls/transactCallDirect.ts +71 -0
  350. package/src/functions/web3/functionCalls/transactCallRelayer.ts +57 -0
  351. package/src/functions/web3/getContractMetadata.ts +43 -0
  352. package/src/functions/web3/getPublicAddressBalance.ts +17 -0
  353. package/src/functions/web3/getTokenHolder.ts +53 -0
  354. package/src/functions/web3/index.ts +9 -0
  355. package/src/functions/web3/lifiAPI.ts +41 -0
  356. package/src/functions/web3/odosAPI.ts +50 -0
  357. package/src/functions/web3/oneInchAPI.ts +47 -0
  358. package/src/functions/web3/runContractFunction.ts +116 -0
  359. package/src/functions/web3/uniswapAPI.ts +156 -0
  360. package/src/index.ts +9 -0
  361. package/src/mutexes/index.ts +1 -0
  362. package/src/mutexes/mutex.ts +3 -0
  363. package/src/providers/EthersProviderAdapter.ts +230 -0
  364. package/src/providers/TorExternalProvider.ts +36 -0
  365. package/src/providers/WagmiProviderAdapter.ts +311 -0
  366. package/src/providers/exportProviers.ts +11 -0
  367. package/src/providers/prepareEthersHinkal.ts +18 -0
  368. package/src/providers/prepareWagmiHinkal.ts +16 -0
  369. package/src/types/API.types.ts +23 -0
  370. package/src/types/ICacheDevice.ts +5 -0
  371. package/src/types/IMultiThreadedUtxoUtils.ts +16 -0
  372. package/src/types/RewardUserEnums.ts +12 -0
  373. package/src/types/TransactionSimulator.types.ts +30 -0
  374. package/src/types/WeeklyAnalytics.types.ts +44 -0
  375. package/src/types/activities.types.ts +90 -0
  376. package/src/types/admin.types.ts +30 -0
  377. package/src/types/all-points.types.ts +8 -0
  378. package/src/types/approvals.types.ts +45 -0
  379. package/src/types/balances.types.ts +20 -0
  380. package/src/types/big-intable.types.ts +3 -0
  381. package/src/types/bridging.types.ts +30 -0
  382. package/src/types/brotherhood-user.types.ts +13 -0
  383. package/src/types/cache.types.ts +42 -0
  384. package/src/types/circom-data.types.ts +120 -0
  385. package/src/types/coingecko.types.ts +216 -0
  386. package/src/types/commitments.types.ts +39 -0
  387. package/src/types/confirmation-request.types.ts +10 -0
  388. package/src/types/contacts.types.ts +6 -0
  389. package/src/types/crypto.types.ts +8 -0
  390. package/src/types/duneAPI.types.ts +9 -0
  391. package/src/types/eip5792.types.ts +31 -0
  392. package/src/types/ethereum-network.types.ts +70 -0
  393. package/src/types/external-action.types.ts +19 -0
  394. package/src/types/fee.types.ts +11 -0
  395. package/src/types/generatePoints.ts +14 -0
  396. package/src/types/hinkal.stake.types.ts +12 -0
  397. package/src/types/hinkal.types.ts +150 -0
  398. package/src/types/index.ts +50 -0
  399. package/src/types/kyc.types.ts +49 -0
  400. package/src/types/merch-order.types.ts +18 -0
  401. package/src/types/message.types.ts +6 -0
  402. package/src/types/mystery-boxes.types.ts +50 -0
  403. package/src/types/new-rewards.type.ts +181 -0
  404. package/src/types/offscreen.types.ts +8 -0
  405. package/src/types/presaleReferral.types.ts +4 -0
  406. package/src/types/proxy.types.ts +11 -0
  407. package/src/types/referral.types.ts +13 -0
  408. package/src/types/relayer.types.ts +16 -0
  409. package/src/types/remote-proof.types.ts +18 -0
  410. package/src/types/rewards.types.ts +53 -0
  411. package/src/types/routing.types.ts +7 -0
  412. package/src/types/sandbox.types.ts +246 -0
  413. package/src/types/session.types.ts +12 -0
  414. package/src/types/signature.types.ts +11 -0
  415. package/src/types/slippage.types.ts +3 -0
  416. package/src/types/snark.types.ts +43 -0
  417. package/src/types/tenderly.api.types.ts +200 -0
  418. package/src/types/token-prices.types.ts +8 -0
  419. package/src/types/token-with-id.types.ts +4 -0
  420. package/src/types/token.types.ts +86 -0
  421. package/src/types/transactions.types.ts +120 -0
  422. package/src/types/wc.types.ts +83 -0
  423. package/src/types/with-id.types.ts +1 -0
  424. package/src/webworker/performTaskWithWorker.ts +50 -0
  425. package/src/webworker/snarkjsWorker/snarkjs.d.ts +2 -0
  426. package/src/webworker/snarkjsWorker/snarkjsWorker.types.ts +18 -0
  427. package/src/webworker/snarkjsWorker/snarkjsWorkerLauncher.ts +19 -0
  428. package/src/webworker/snarkjsWorker/snarkjsWorkerLogic.ts +90 -0
  429. package/src/webworker/utxoWorker/utxoWorker.types.ts +41 -0
  430. package/src/webworker/utxoWorker/utxoWorkerLauncher.ts +19 -0
  431. package/src/webworker/utxoWorker/utxoWorkerLogic.ts +107 -0
  432. package/src/webworker/viteWorkerURL.constant.ts +25 -0
  433. package/src/webworker/worker.registry.ts +11 -0
  434. package/src/webworker/worker.types.ts +35 -0
  435. package/src/webworker/workerErrorHandler.ts +10 -0
  436. package/src/webworker/workerFactory.ts +47 -0
  437. package/src/webworker/workerProxy.ts +88 -0
  438. package/src/webworker/zkProofWorker/zkProofWorker.types.ts +52 -0
  439. package/src/webworker/zkProofWorker/zkProofWorkerLauncher.ts +19 -0
  440. package/src/webworker/zkProofWorker/zkProofWorkerLogic.ts +84 -0
  441. package/tsconfig.json +23 -0
  442. package/tsconfig.lib.json +10 -0
  443. package/tsconfig.spec.json +15 -0
  444. package/vite.config.ts +97 -0
  445. package/vite.config.workers.ts +51 -0
@@ -0,0 +1,301 @@
1
+ import { MerkleTree } from '../../data-structures/merkle-tree';
2
+ import { Utxo } from '../../data-structures/utxo/Utxo';
3
+ import { UserKeys } from '../../data-structures/crypto-keys/keys';
4
+ import { defaultSignatureData, zeroAddress } from '../../constants/protocol.constants';
5
+ import { chainIds } from '../../constants/chains.constants';
6
+ import {
7
+ ZKProofWorkerActionType,
8
+ ZKProofWorkerBuildInNullifiersReturn,
9
+ ZKProofWorkerCalcAccessTokenReturn,
10
+ ZKProofWorkerCalcCommitmentsReturn,
11
+ ZKProofWorkerPayload,
12
+ } from '../../webworker/zkProofWorker/zkProofWorker.types';
13
+ import { performTaskWithWorker } from '../../webworker/performTaskWithWorker';
14
+ import { WorkerVariant } from '../../webworker/worker.registry';
15
+ import {
16
+ buildOutCommitments,
17
+ calcAmountChanges,
18
+ calcEncryptedOutputs,
19
+ calcPublicSignalCount,
20
+ calcStealthAddressStructure,
21
+ createCallDataHash,
22
+ getSlippageValues,
23
+ } from './common.snarkjs';
24
+ import { randomBigInt } from '../web3/etherFunctions';
25
+ import { encodeEmporiumMetadata, getAuthorizationDataIfNeeded } from '../private-wallet/emporium.helpers';
26
+ import { ExternalActionId } from '../../types/external-action.types';
27
+ import { CircomDataBaseType, CircomDataV1x1, defaultHookData, DimDataType } from '../../types/circom-data.types';
28
+ import { generateCircomData } from './generateCircomData';
29
+ import { generateZkProof } from './generateZkProof';
30
+ import { ethers } from 'ethers';
31
+ import { getCurrentTimeInSeconds } from '../utils/time.utils';
32
+ import {
33
+ AuthorizationData,
34
+ defaultHinkalLogicArgs,
35
+ FeeStructure,
36
+ HinkalLogicArgs,
37
+ type ProverVersion,
38
+ } from '../../types/hinkal.types';
39
+ import { generateFeeStructure } from '../utils/fees.utils';
40
+ import {
41
+ createHinkalHelperFromData,
42
+ hinkalCheckTokenRegistry,
43
+ } from '../../data-structures/Hinkal/hinkalCheckTokenRegistry';
44
+ import { getPatchedAccessTokenMerkleTree } from '../../data-structures/merkle-tree/getPatchedAccessTokenMerkleTree';
45
+ import { Logger } from '../../error-handling/logger';
46
+ import { poseidonFunction } from '../../crypto';
47
+ import { SubAccount } from '../../types/proxy.types';
48
+
49
+ export const constructEmporiumProof = async <T = CircomDataV1x1>(
50
+ proverVersion: ProverVersion,
51
+ merkleTree: MerkleTree<bigint>,
52
+ merkleTreeAccessToken: MerkleTree<bigint>,
53
+ erc20TokenAddresses: string[],
54
+ tokenIds: number[],
55
+ inputUtxos: Utxo[][],
56
+ outputUtxos: Utxo[][],
57
+ userKeys: UserKeys,
58
+ tokenCount: number,
59
+ inputCount: number,
60
+ emporiumAddress: string,
61
+ operations: string[],
62
+ generateProofRemotely: boolean,
63
+ relay = zeroAddress,
64
+ chainId = chainIds.localhost,
65
+ onChainCreation = inputUtxos.map(() => false),
66
+ flatFees = inputUtxos.map(() => 0n),
67
+ subAccount?: SubAccount,
68
+ hinkalLogicArgs: HinkalLogicArgs | undefined = undefined,
69
+ patchAccessTokenMerkleTree = false,
70
+ slippageValues?: bigint[],
71
+ feeStructure: FeeStructure | undefined = undefined,
72
+ hinkalHelper?: ethers.Contract,
73
+ signatureData = defaultSignatureData,
74
+ messageSeedOverride?: bigint,
75
+ ) => {
76
+ const amountChanges = calcAmountChanges(inputUtxos, outputUtxos);
77
+
78
+ const encryptedOutputs = calcEncryptedOutputs(outputUtxos, false);
79
+
80
+ const shieldedPrivateKey = userKeys.getShieldedPrivateKey();
81
+
82
+ const extraRandomization = Utxo.findCorrectRandomization(randomBigInt(31), shieldedPrivateKey);
83
+
84
+ const kycRequired = await hinkalCheckTokenRegistry(
85
+ hinkalHelper ?? createHinkalHelperFromData(chainId),
86
+ erc20TokenAddresses,
87
+ calcAmountChanges(inputUtxos, outputUtxos, true),
88
+ );
89
+
90
+ const patchedMerkleTree = getPatchedAccessTokenMerkleTree(
91
+ merkleTreeAccessToken,
92
+ userKeys,
93
+ patchAccessTokenMerkleTree,
94
+ kycRequired,
95
+ );
96
+
97
+ Logger.log({ kycRequiredEmporium: kycRequired, patchedMerkleTree, amountChanges, erc20TokenAddresses });
98
+
99
+ const merkleTreeAccessTokenJSON = patchedMerkleTree.toJSON();
100
+
101
+ // get root hash
102
+ const rootHashHinkal = merkleTree.getRootHash();
103
+ const rootHashAccessToken = patchedMerkleTree.getRootHash();
104
+
105
+ const inputUtxosSerialized = inputUtxos.map((utxoList) => utxoList.map((utxo) => utxo.getConstructableParams()));
106
+ const userSignature = userKeys.getSignature();
107
+
108
+ const { accessTokenSiblings, accessTokenSiblingSides } = await performTaskWithWorker<
109
+ ZKProofWorkerPayload,
110
+ ZKProofWorkerCalcAccessTokenReturn
111
+ >({
112
+ type: WorkerVariant.ZKProof,
113
+ payload: {
114
+ type: ZKProofWorkerActionType.CALC_ACCESS_TOKEN_SIBLING_AND_SIDES,
115
+ data: {
116
+ userSignature,
117
+ merkleTreeAccessTokenSerialized: merkleTreeAccessTokenJSON,
118
+ },
119
+ },
120
+ });
121
+
122
+ const { inCommitmentSiblings, inCommitmentSiblingSides } = await performTaskWithWorker<
123
+ ZKProofWorkerPayload,
124
+ ZKProofWorkerCalcCommitmentsReturn
125
+ >({
126
+ type: WorkerVariant.ZKProof,
127
+ payload: {
128
+ type: ZKProofWorkerActionType.CALC_COMMITMENTS_SIBLING_AND_SIDES,
129
+ data: { inputUtxosSerialized, userSignature, merkleTreeSerialized: merkleTree.toJSON() },
130
+ },
131
+ });
132
+
133
+ const inNullifiers = await performTaskWithWorker<ZKProofWorkerPayload, ZKProofWorkerBuildInNullifiersReturn>({
134
+ type: WorkerVariant.ZKProof,
135
+ payload: {
136
+ type: ZKProofWorkerActionType.BUILD_IN_NULLIFIERS,
137
+ data: { inputUtxosSerialized, onChainCreation, proverVersion },
138
+ },
139
+ });
140
+
141
+ const outCommitments = buildOutCommitments(proverVersion, outputUtxos, onChainCreation);
142
+
143
+ const messageSeed = messageSeedOverride ?? randomBigInt(31);
144
+ const message = poseidonFunction(messageSeed);
145
+
146
+ const input: any = {
147
+ rootHashHinkal,
148
+ erc20TokenAddresses,
149
+ tokenIds,
150
+ inNullifiers,
151
+ outTimeStamp: outputUtxos.length > 0 ? BigInt(outputUtxos[0][0].timeStamp) : getCurrentTimeInSeconds(),
152
+ extraRandomization,
153
+ amountChanges,
154
+ outCommitments,
155
+ rootHashAccessToken,
156
+ calldataHash: 0n,
157
+ shieldedPrivateKey,
158
+ accessTokenSiblings,
159
+ accessTokenSiblingSides,
160
+ outAmounts: outputUtxos.map((out) => out[0].amount),
161
+ outPublicKeys: outputUtxos.map((out) => out[0].getStealthAddress()),
162
+ inAmounts: inputUtxos.map((token) => token.map((utxo) => utxo.amount.toString())),
163
+ inTimeStamps: inputUtxos.map((token) => token.map((utxo) => utxo.timeStamp)),
164
+ inRandomizations: inputUtxos.map((token) => token.map((utxo) => utxo.randomization)),
165
+ inCommitmentSiblings,
166
+ inCommitmentSiblingSides,
167
+ messageSeed,
168
+ };
169
+
170
+ const signerAddress = subAccount ? UserKeys.getSignerAddressFromPrivateKey(subAccount.privateKey) : undefined;
171
+
172
+ const externalAddress = emporiumAddress;
173
+ const externalActionId = ExternalActionId.Emporium;
174
+
175
+ const externalActionMetadata = await encodeEmporiumMetadata(
176
+ chainId,
177
+ emporiumAddress,
178
+ subAccount?.privateKey,
179
+ operations,
180
+ message,
181
+ signerAddress,
182
+ );
183
+
184
+ const verifierName =
185
+ outputUtxos.length === 0 ? 'swapperMWMin0' : `swapperMW${tokenCount}x${inputCount}x${outputUtxos[0].length}`;
186
+
187
+ const publicSignalCount = calcPublicSignalCount(
188
+ verifierName,
189
+ input.erc20TokenAddresses,
190
+ input.amountChanges,
191
+ input.inNullifiers,
192
+ input.outCommitments,
193
+ tokenIds.length,
194
+ );
195
+
196
+ if (!hinkalLogicArgs) {
197
+ hinkalLogicArgs = defaultHinkalLogicArgs(amountChanges.length, userKeys);
198
+ hinkalLogicArgs.interactionAddress = '0x032f580aFFE7a5f17025fAF83c13B4277A880532';
199
+ hinkalLogicArgs.inHinkalAddress = userKeys.getInHinkalAddress(hinkalLogicArgs.interactionAddress);
200
+ }
201
+
202
+ if (proverVersion === 'v1x1') {
203
+ input.interactionAddress = hinkalLogicArgs.interactionAddress;
204
+ if (userKeys.getInHinkalAddress(input.interactionAddress) !== hinkalLogicArgs.inHinkalAddress)
205
+ throw new Error('inHinkalAddress mismatch');
206
+ input.externalApprovalAddresses =
207
+ hinkalLogicArgs?.useApprovalUtxoData?.map(({ externalApprovalAddresses }) => externalApprovalAddresses) ??
208
+ Array(tokenCount).fill([zeroAddress, zeroAddress, zeroAddress]);
209
+ }
210
+
211
+ if (!feeStructure) {
212
+ feeStructure = generateFeeStructure(flatFees, erc20TokenAddresses);
213
+ }
214
+
215
+ // below amountchanges with negative values (not ones with CIRCOM_P-value)
216
+ const amountChangesBased = calcAmountChanges(inputUtxos, outputUtxos, true);
217
+
218
+ if (!slippageValues) {
219
+ slippageValues = getSlippageValues(amountChangesBased, hinkalLogicArgs);
220
+ }
221
+
222
+ input.calldataHash = createCallDataHash(
223
+ proverVersion,
224
+ publicSignalCount,
225
+ relay,
226
+ externalAddress,
227
+ externalActionId,
228
+ externalActionMetadata,
229
+ encryptedOutputs,
230
+ flatFees,
231
+ undefined,
232
+ slippageValues,
233
+ onChainCreation,
234
+ hinkalLogicArgs,
235
+ feeStructure,
236
+ signatureData,
237
+ );
238
+
239
+ const swapperMWMin0Input = {
240
+ outTimeStamp: getCurrentTimeInSeconds(),
241
+ rootHashAccessToken,
242
+ calldataHash: input.calldataHash,
243
+ shieldedPrivateKey,
244
+ accessTokenSiblings,
245
+ accessTokenSiblingSides,
246
+ messageSeed,
247
+ };
248
+
249
+ const { zkCallData } = await generateZkProof(
250
+ proverVersion,
251
+ chainId,
252
+ verifierName,
253
+ verifierName === 'swapperMWMin0' ? swapperMWMin0Input : input,
254
+ generateProofRemotely,
255
+ );
256
+
257
+ const stealthAddressStructure = calcStealthAddressStructure(extraRandomization, shieldedPrivateKey);
258
+
259
+ const circomData: CircomDataBaseType = await generateCircomData(
260
+ proverVersion,
261
+ outCommitments,
262
+ inNullifiers,
263
+ rootHashHinkal,
264
+ rootHashAccessToken,
265
+ amountChangesBased,
266
+ erc20TokenAddresses,
267
+ inputUtxos,
268
+ outputUtxos,
269
+ encryptedOutputs,
270
+ flatFees,
271
+ publicSignalCount,
272
+ externalActionId,
273
+ externalAddress,
274
+ externalActionMetadata,
275
+ relay,
276
+ input.calldataHash,
277
+ tokenIds,
278
+ stealthAddressStructure,
279
+ onChainCreation,
280
+ defaultHookData,
281
+ verifierName === 'swapperMWMin0' ? swapperMWMin0Input.outTimeStamp : input.outTimeStamp, // although these variables seem to contain the same value, there can actually be a single second difference if the timing is unlucky
282
+ hinkalLogicArgs,
283
+ slippageValues,
284
+ feeStructure,
285
+ signatureData,
286
+ );
287
+
288
+ // Logger.log('circomdata in emporium proof', { circomData });
289
+ const dimData: DimDataType = {
290
+ tokenNumber: inputUtxos.length,
291
+ nullifierAmount: inputUtxos.length > 0 ? inputUtxos[0].length : 0,
292
+ outputAmount: outputUtxos.length > 0 ? outputUtxos[0].length : 0,
293
+ };
294
+
295
+ const authorizationData: AuthorizationData | undefined = await getAuthorizationDataIfNeeded(
296
+ chainId,
297
+ subAccount?.privateKey,
298
+ );
299
+
300
+ return { zkCallData, circomData: <T>circomData, dimData, encryptedOutputs, authorizationData };
301
+ };
@@ -0,0 +1,281 @@
1
+ import { chainIds } from '../../constants/chains.constants';
2
+ import { defaultSignatureData, zeroAddress } from '../../constants/protocol.constants';
3
+
4
+ import { MerkleTree } from '../../data-structures/merkle-tree';
5
+ import { UserKeys } from '../../data-structures/crypto-keys/keys';
6
+ import { Utxo } from '../../data-structures/utxo/Utxo';
7
+
8
+ import { CircomDataBaseType, CircomDataV1x1, DimDataType, HookDataType } from '../../types/circom-data.types';
9
+ import { ExternalActionId } from '../../types/external-action.types';
10
+ import { HinkalStakeMode, StakeArgs } from '../../types/hinkal.stake.types';
11
+
12
+ import { performTaskWithWorker } from '../../webworker/performTaskWithWorker';
13
+ import { WorkerVariant } from '../../webworker/worker.registry';
14
+ import {
15
+ ZKProofWorkerActionType,
16
+ ZKProofWorkerBuildInNullifiersReturn,
17
+ ZKProofWorkerCalcAccessTokenReturn,
18
+ ZKProofWorkerCalcCommitmentsReturn,
19
+ ZKProofWorkerPayload,
20
+ } from '../../webworker/zkProofWorker/zkProofWorker.types';
21
+ import { randomBigInt } from '../web3/etherFunctions';
22
+ import {
23
+ buildOutCommitments,
24
+ calcAmountChanges,
25
+ calcEncryptedOutputs,
26
+ calcPublicSignalCount,
27
+ calcStealthAddressStructure,
28
+ createCallDataHash,
29
+ getSlippageValues,
30
+ } from './common.snarkjs';
31
+ import { generateCircomData } from './generateCircomData';
32
+ import { generateZkProof } from './generateZkProof';
33
+ import { getPatchedAccessTokenMerkleTree } from '../../data-structures/merkle-tree/getPatchedAccessTokenMerkleTree';
34
+ import { defaultHinkalLogicArgs, FeeStructure, HinkalLogicArgs, ProverVersion } from '../../types/hinkal.types';
35
+ import { generateFeeStructure } from '../utils/fees.utils';
36
+ import {
37
+ createHinkalHelperFromData,
38
+ hinkalCheckTokenRegistry,
39
+ } from '../../data-structures/Hinkal/hinkalCheckTokenRegistry';
40
+ import { Logger } from '../../error-handling/logger';
41
+ import { ethers } from 'ethers';
42
+
43
+ export const constructZkProof = async <T = CircomDataV1x1>(
44
+ proverVersion: ProverVersion,
45
+ merkleTree: MerkleTree<bigint>,
46
+ merkleTreeAccessToken: MerkleTree<bigint>,
47
+ inputUtxos: Utxo[][],
48
+ outputUtxos: Utxo[][],
49
+ userKeys: UserKeys,
50
+ verifierName: string,
51
+ externalActionId: ExternalActionId | 0n,
52
+ externalAddress: string | undefined,
53
+ externalActionMetadata: string,
54
+ generateProofRemotely: boolean,
55
+ relay = zeroAddress,
56
+ chainId = chainIds.localhost,
57
+ onChainCreation = inputUtxos.map(() => false),
58
+ flatFees = inputUtxos.map(() => 0n),
59
+ hookData: HookDataType | undefined = undefined,
60
+ stakeArgs?: StakeArgs,
61
+ patchAccessTokenMerkleTree = false,
62
+ hinkalLogicArgs: HinkalLogicArgs | undefined = undefined,
63
+ slippageValues?: bigint[],
64
+ feeStructure: FeeStructure | undefined = undefined,
65
+ // performance optimization, if we use hinkalHelper from `hinkal.getContractWithFetcher` it will be faster than creating a new JsonRpcProvider
66
+ hinkalHelper?: ethers.Contract,
67
+ signatureData = defaultSignatureData,
68
+ ) => {
69
+ // amount changes and encrypted outputs
70
+ const amountChanges = calcAmountChanges(inputUtxos, outputUtxos);
71
+ const erc20TokenAddresses = inputUtxos.map((utxo) => utxo[0].erc20TokenAddress);
72
+ const encryptedOutputs = calcEncryptedOutputs(
73
+ outputUtxos,
74
+ (stakeArgs && stakeArgs.mode !== HinkalStakeMode.Deposit) ?? false,
75
+ );
76
+
77
+ const shieldedPrivateKey = userKeys.getShieldedPrivateKey();
78
+
79
+ const extraRandomization = Utxo.findCorrectRandomization(randomBigInt(31), shieldedPrivateKey);
80
+
81
+ const kycRequired = await hinkalCheckTokenRegistry(
82
+ hinkalHelper ?? createHinkalHelperFromData(chainId),
83
+ erc20TokenAddresses,
84
+ calcAmountChanges(inputUtxos, outputUtxos, true),
85
+ );
86
+
87
+ const patchedMerkleTree = getPatchedAccessTokenMerkleTree(
88
+ merkleTreeAccessToken,
89
+ userKeys,
90
+ patchAccessTokenMerkleTree,
91
+ kycRequired,
92
+ );
93
+ // get root hash
94
+ const rootHashAccessToken = patchedMerkleTree.getRootHash();
95
+ const merkleTreeAccessTokenJSON = patchedMerkleTree.toJSON();
96
+ const rootHashHinkal = merkleTree.getRootHash();
97
+
98
+ const inputUtxosSerialized = inputUtxos.map((utxoList) => utxoList.map((utxo) => utxo.getConstructableParams()));
99
+ const userSignature = userKeys.getSignature();
100
+
101
+ const { accessTokenSiblings, accessTokenSiblingSides } = await performTaskWithWorker<
102
+ ZKProofWorkerPayload,
103
+ ZKProofWorkerCalcAccessTokenReturn
104
+ >({
105
+ type: WorkerVariant.ZKProof,
106
+ payload: {
107
+ type: ZKProofWorkerActionType.CALC_ACCESS_TOKEN_SIBLING_AND_SIDES,
108
+ data: {
109
+ userSignature,
110
+ merkleTreeAccessTokenSerialized: merkleTreeAccessTokenJSON,
111
+ },
112
+ },
113
+ });
114
+
115
+ const { inCommitmentSiblings, inCommitmentSiblingSides } = await performTaskWithWorker<
116
+ ZKProofWorkerPayload,
117
+ ZKProofWorkerCalcCommitmentsReturn
118
+ >({
119
+ type: WorkerVariant.ZKProof,
120
+ payload: {
121
+ type: ZKProofWorkerActionType.CALC_COMMITMENTS_SIBLING_AND_SIDES,
122
+ data: { inputUtxosSerialized, userSignature, merkleTreeSerialized: merkleTree.toJSON() },
123
+ },
124
+ });
125
+
126
+ const inNullifiers = await performTaskWithWorker<ZKProofWorkerPayload, ZKProofWorkerBuildInNullifiersReturn>({
127
+ type: WorkerVariant.ZKProof,
128
+ payload: {
129
+ type: ZKProofWorkerActionType.BUILD_IN_NULLIFIERS,
130
+ data: { inputUtxosSerialized, onChainCreation, proverVersion },
131
+ },
132
+ });
133
+
134
+ const outCommitments = buildOutCommitments(proverVersion, outputUtxos, onChainCreation);
135
+
136
+ const input: any = {
137
+ rootHashHinkal,
138
+ shieldedPrivateKey,
139
+ erc20TokenAddresses,
140
+ inAmounts: inputUtxos.map((token) => token.map((utxo) => utxo.amount.toString())),
141
+ inTimeStamps: inputUtxos.map((token) => token.map((utxo) => utxo.timeStamp)),
142
+ inRandomizations: inputUtxos.map((token) => token.map((utxo) => utxo.randomization)),
143
+ inNullifiers,
144
+ inCommitmentSiblings,
145
+ inCommitmentSiblingSides,
146
+ outAmounts: outputUtxos.map((token) => token.map((utxo) => utxo.amount.toString())),
147
+ outTimeStamp: BigInt(outputUtxos[0][0].timeStamp),
148
+ outPublicKeys: outputUtxos.map((token) => token.map((utxo) => utxo.getStealthAddress())),
149
+ extraRandomization,
150
+ amountChanges,
151
+ outCommitments,
152
+ rootHashAccessToken,
153
+ accessTokenSiblings,
154
+ accessTokenSiblingSides,
155
+ calldataHash: 0n,
156
+ };
157
+
158
+ // case with NFTs
159
+ const tokenIds = inputUtxos.map((utxos) => utxos[0].tokenId ?? 0);
160
+ const tokenIdsPositive = tokenIds.reduce((prev, cur) => prev + cur, 0) > 0 ? tokenIds.length : 0;
161
+ if (tokenIdsPositive > 0) input.tokenIds = tokenIds;
162
+
163
+ const publicSignalCount = calcPublicSignalCount(
164
+ verifierName,
165
+ input.erc20TokenAddresses,
166
+ input.amountChanges,
167
+ input.inNullifiers,
168
+ input.outCommitments,
169
+ tokenIdsPositive,
170
+ );
171
+
172
+ if (!hinkalLogicArgs) {
173
+ hinkalLogicArgs = defaultHinkalLogicArgs(amountChanges.length, userKeys);
174
+ hinkalLogicArgs.interactionAddress = externalAddress ?? zeroAddress;
175
+ const inHinkalAddress = userKeys.getInHinkalAddress(hinkalLogicArgs.interactionAddress);
176
+ hinkalLogicArgs.inHinkalAddress = inHinkalAddress;
177
+ }
178
+
179
+ if (proverVersion === 'v1x1') {
180
+ input.interactionAddress = hinkalLogicArgs?.interactionAddress ?? externalAddress ?? zeroAddress;
181
+ // sanity check to avoid confusing invalid proof errors
182
+ if (userKeys.getInHinkalAddress(input.interactionAddress) !== hinkalLogicArgs.inHinkalAddress)
183
+ throw new Error('inHinkalAddress mismatch');
184
+ input.externalApprovalAddresses = hinkalLogicArgs.useApprovalUtxoData?.map(
185
+ ({ externalApprovalAddresses }) => externalApprovalAddresses,
186
+ ) ?? [zeroAddress, zeroAddress, zeroAddress];
187
+ }
188
+
189
+ if (!feeStructure) {
190
+ feeStructure = generateFeeStructure(
191
+ flatFees,
192
+ inputUtxos.map((inputUtxoList) => inputUtxoList[0].erc20TokenAddress),
193
+ );
194
+ }
195
+
196
+ // below amountchanges with negative values (not ones with CIRCOM_P-value)
197
+ const amountChangesBased = calcAmountChanges(inputUtxos, outputUtxos, true);
198
+
199
+ if (!slippageValues) {
200
+ slippageValues = getSlippageValues(amountChangesBased, hinkalLogicArgs);
201
+ }
202
+
203
+ Logger.log({ publicSignalCount });
204
+
205
+ input.calldataHash = createCallDataHash(
206
+ proverVersion,
207
+ publicSignalCount,
208
+ relay,
209
+ externalAddress,
210
+ externalActionId,
211
+ externalActionMetadata,
212
+ encryptedOutputs,
213
+ flatFees,
214
+ hookData,
215
+ slippageValues,
216
+ onChainCreation,
217
+ hinkalLogicArgs,
218
+ feeStructure,
219
+ signatureData,
220
+ );
221
+
222
+ if (stakeArgs) {
223
+ if (stakeArgs.mode === HinkalStakeMode.Deposit) input.mode = 0;
224
+ if (stakeArgs.mode === HinkalStakeMode.Stake) input.mode = 1;
225
+ if (stakeArgs.mode === HinkalStakeMode.Unstake) input.mode = 2;
226
+ input.stakedTokenRecipient = stakeArgs.stakedTokenRecipient;
227
+ input.stakeBlinding = stakeArgs.stakeBlinding;
228
+ input.depositorAddress = stakeArgs.depositorAddress;
229
+ }
230
+
231
+ const { zkCallData, publicSignals } = await generateZkProof(
232
+ proverVersion,
233
+ chainId,
234
+ verifierName,
235
+ input,
236
+ generateProofRemotely,
237
+ );
238
+
239
+ Logger.log({ publicSignals });
240
+
241
+ const stealthAddressStructure = calcStealthAddressStructure(extraRandomization, shieldedPrivateKey);
242
+
243
+ const circomData: CircomDataBaseType = await generateCircomData(
244
+ proverVersion,
245
+ outCommitments,
246
+ inNullifiers,
247
+ rootHashHinkal,
248
+ rootHashAccessToken,
249
+ amountChangesBased,
250
+ erc20TokenAddresses,
251
+ inputUtxos,
252
+ outputUtxos,
253
+ encryptedOutputs,
254
+ flatFees,
255
+ publicSignalCount,
256
+ externalActionId,
257
+ externalAddress,
258
+ externalActionMetadata,
259
+ relay,
260
+ input.calldataHash,
261
+ tokenIds,
262
+ stealthAddressStructure,
263
+ onChainCreation,
264
+ hookData,
265
+ undefined,
266
+ hinkalLogicArgs,
267
+ slippageValues,
268
+ feeStructure,
269
+ signatureData,
270
+ );
271
+
272
+ Logger.log({ circomData });
273
+
274
+ const dimData: DimDataType = {
275
+ tokenNumber: inputUtxos.length,
276
+ nullifierAmount: inputUtxos[0].length,
277
+ outputAmount: outputUtxos[0].length,
278
+ };
279
+
280
+ return { zkCallData, circomData: <T>circomData, dimData, encryptedOutputs };
281
+ };
@@ -0,0 +1,81 @@
1
+ import { FeeStructure, HinkalLogicArgs, ProverVersion } from '../../types/hinkal.types';
2
+ import { defaultSignatureData, zeroAddress } from '../../constants/protocol.constants';
3
+ import { Utxo } from '../../data-structures/utxo/Utxo';
4
+
5
+ import {
6
+ CircomDataBaseType,
7
+ CircomDataV1,
8
+ CircomDataV1x1,
9
+ defaultHookData,
10
+ HookDataType,
11
+ StealthAddressStructure,
12
+ } from '../../types/circom-data.types';
13
+ import { ExternalActionId } from '../../types/external-action.types';
14
+
15
+ import { getExternalActionIdHash } from '../utils/external-action.utils';
16
+ import { getOriginalSender } from './getOriginalSender';
17
+
18
+ export const generateCircomData = async (
19
+ proverVersion: ProverVersion,
20
+ outCommitments: string[][],
21
+ inputNullifiers: string[][],
22
+ rootHashHinkal: bigint | undefined,
23
+ rootHashAccessToken: bigint | undefined,
24
+ amountChanges: bigint[],
25
+ erc20TokenAddresses: string[],
26
+ inputUtxos: Utxo[][],
27
+ outputUtxos: Utxo[][],
28
+ encryptedOutputs: string[][],
29
+ flatFees: bigint[],
30
+ publicSignalCount: number,
31
+ externalActionId: ExternalActionId | bigint,
32
+ externalAddress: string | undefined,
33
+ externalActionMetadata: string,
34
+ relay: string,
35
+ calldataHash: bigint,
36
+ tokenIds: number[],
37
+ stealthAddressStructure: StealthAddressStructure,
38
+ onChainCreation: boolean[],
39
+ hookData: HookDataType | undefined,
40
+ timeStampFallback: number | undefined,
41
+ hinkalLogicArgs: HinkalLogicArgs,
42
+ slippageValues: bigint[],
43
+ feeStructure: FeeStructure,
44
+ signatureData = defaultSignatureData,
45
+ ): Promise<CircomDataBaseType> => {
46
+ const circomData: CircomDataBaseType = {
47
+ rootHashHinkal,
48
+ erc20TokenAddresses,
49
+ tokenIds: tokenIds.map((tokenId) => String(tokenId)),
50
+ amountChanges,
51
+ inputNullifiers,
52
+ outCommitments,
53
+ encryptedOutputs,
54
+ timeStamp: outputUtxos.length > 0 ? outputUtxos[0][0].timeStamp : String(timeStampFallback ?? ''),
55
+ stealthAddressStructure,
56
+ rootHashAccessToken,
57
+ relay,
58
+ externalAddress: externalAddress === undefined ? zeroAddress : externalAddress,
59
+ externalActionMetadata,
60
+ externalActionId: typeof externalActionId === 'bigint' ? 0n : getExternalActionIdHash(externalActionId),
61
+ hookData: hookData || defaultHookData,
62
+ publicSignalCount,
63
+ calldataHash,
64
+ };
65
+ if (proverVersion === 'v1x0') {
66
+ const circomDataV1 = circomData as CircomDataV1;
67
+ circomDataV1.flatFees = flatFees;
68
+ return circomDataV1;
69
+ } else {
70
+ const circomDataV1x1 = circomData as CircomDataV1x1;
71
+ circomDataV1x1.onChainCreation = onChainCreation;
72
+ circomDataV1x1.slippageValues = slippageValues;
73
+ const newHinkalLogicArgs = structuredClone(hinkalLogicArgs);
74
+ if ('interactionAddress' in newHinkalLogicArgs) delete newHinkalLogicArgs.interactionAddress;
75
+ circomDataV1x1.hinkalLogicArgs = newHinkalLogicArgs;
76
+ circomDataV1x1.feeStructure = feeStructure;
77
+ circomDataV1x1.signatureData = signatureData;
78
+ circomDataV1x1.originalSender = getOriginalSender(externalAddress ?? zeroAddress, relay);
79
+ return circomDataV1x1;
80
+ }
81
+ };
@@ -0,0 +1,21 @@
1
+ import { Logger } from '../../error-handling/logger';
2
+ import { NewZkCallDataType, ProverVersion } from '../../types';
3
+ import { generateZkProofEnclave } from './generateZkProofEnclave';
4
+ import { generateZkProofSelf } from './generateZkProofSelf';
5
+
6
+ export const generateZkProof = async (
7
+ proverVersion: ProverVersion,
8
+ chainId: number,
9
+ verifierName: string,
10
+ input: any,
11
+ remotely?: boolean,
12
+ ): Promise<{ zkCallData: NewZkCallDataType; publicSignals: string[] }> => {
13
+ if (remotely) {
14
+ try {
15
+ return await generateZkProofEnclave(proverVersion, chainId, verifierName, input);
16
+ } catch (err) {
17
+ Logger.error('enclave proof error', err);
18
+ }
19
+ }
20
+ return generateZkProofSelf(proverVersion, chainId, verifierName, input);
21
+ };