@fhevm/sdk 0.14.4 → 0.14.6

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 (286) hide show
  1. package/_cjs/core/_version.js +1 -1
  2. package/_cjs/core/actions/chain/fetchFheEncryptionKeyBytes.js +2 -1
  3. package/_cjs/core/actions/chain/fetchFheEncryptionKeyBytes.js.map +1 -1
  4. package/_cjs/core/chains/definitions/bscTestnet.js +36 -0
  5. package/_cjs/core/chains/definitions/bscTestnet.js.map +1 -0
  6. package/_cjs/core/chains/definitions/mainnet.js +3 -0
  7. package/_cjs/core/chains/definitions/mainnet.js.map +1 -1
  8. package/_cjs/core/chains/definitions/sepolia.js +3 -0
  9. package/_cjs/core/chains/definitions/sepolia.js.map +1 -1
  10. package/_cjs/core/chains/index.js +3 -1
  11. package/_cjs/core/chains/index.js.map +1 -1
  12. package/_cjs/core/clients/decorators/base.js.map +1 -1
  13. package/_cjs/core/clients/decorators/encrypt.js +4 -0
  14. package/_cjs/core/clients/decorators/encrypt.js.map +1 -1
  15. package/_cjs/core/coprocessor/ZkProofBuilder-p.js.map +1 -1
  16. package/_cjs/core/coprocessor/encrypt.js +5 -1
  17. package/_cjs/core/coprocessor/encrypt.js.map +1 -1
  18. package/_cjs/core/errors/FheEncryptionKeyVerificationError.js +14 -0
  19. package/_cjs/core/errors/FheEncryptionKeyVerificationError.js.map +1 -0
  20. package/_cjs/core/errors/FhevmErrorBase.js +0 -1
  21. package/_cjs/core/errors/FhevmErrorBase.js.map +1 -1
  22. package/_cjs/core/errors/RelayerErrorBase.js +0 -1
  23. package/_cjs/core/errors/RelayerErrorBase.js.map +1 -1
  24. package/_cjs/core/host-contracts/HostContractVersion-p.js +2 -0
  25. package/_cjs/core/host-contracts/HostContractVersion-p.js.map +1 -1
  26. package/_cjs/core/host-contracts/abi-fragments/fragments.js +50 -1
  27. package/_cjs/core/host-contracts/abi-fragments/fragments.js.map +1 -1
  28. package/_cjs/core/key/FheEncryptionKeyCache-p.js +50 -56
  29. package/_cjs/core/key/FheEncryptionKeyCache-p.js.map +1 -1
  30. package/_cjs/core/key/copyFheEncryptionKeyBytes-p.js +17 -0
  31. package/_cjs/core/key/copyFheEncryptionKeyBytes-p.js.map +1 -0
  32. package/_cjs/core/key/ensureFheEncryptionKeyDownload.js +134 -0
  33. package/_cjs/core/key/ensureFheEncryptionKeyDownload.js.map +1 -0
  34. package/_cjs/core/key/fetchFheEncryptionKey.js +4 -24
  35. package/_cjs/core/key/fetchFheEncryptionKey.js.map +1 -1
  36. package/_cjs/core/key/fetchFheEncryptionKeyBytes.js +2 -32
  37. package/_cjs/core/key/fetchFheEncryptionKeyBytes.js.map +1 -1
  38. package/_cjs/core/key/verifyFheEncryptionKeyBytes-p.js +245 -0
  39. package/_cjs/core/key/verifyFheEncryptionKeyBytes-p.js.map +1 -0
  40. package/_cjs/core/modules/encrypt/mock.js +7 -90
  41. package/_cjs/core/modules/encrypt/mock.js.map +1 -1
  42. package/_cjs/core/modules/encrypt/module/api-p.js +0 -65
  43. package/_cjs/core/modules/encrypt/module/api-p.js.map +1 -1
  44. package/_cjs/core/modules/encrypt/module/index.js +0 -3
  45. package/_cjs/core/modules/encrypt/module/index.js.map +1 -1
  46. package/_cjs/core/modules/relayer/cleartext/mock.js +1 -0
  47. package/_cjs/core/modules/relayer/cleartext/mock.js.map +1 -1
  48. package/_cjs/core/modules/relayer/module/RelayerAsyncRequest.js +12 -2
  49. package/_cjs/core/modules/relayer/module/RelayerAsyncRequest.js.map +1 -1
  50. package/_cjs/core/modules/relayer/module/fetchFheEncryptionKeySource.js +5 -3
  51. package/_cjs/core/modules/relayer/module/fetchFheEncryptionKeySource.js.map +1 -1
  52. package/_cjs/core/modules/relayer/module/relayerUrl.js +37 -0
  53. package/_cjs/core/modules/relayer/module/relayerUrl.js.map +1 -1
  54. package/_cjs/core/runtime/CoreFhevm-p.js +88 -11
  55. package/_cjs/core/runtime/CoreFhevm-p.js.map +1 -1
  56. package/_cjs/core/types/index.js.map +1 -1
  57. package/_cjs/ethers/clients/createFhevmDecryptClient.js +4 -1
  58. package/_cjs/ethers/clients/createFhevmDecryptClient.js.map +1 -1
  59. package/_cjs/viem/clients/createFhevmDecryptClient.js +4 -1
  60. package/_cjs/viem/clients/createFhevmDecryptClient.js.map +1 -1
  61. package/_cjs/wasm/tfhe/loadTfheLib.js.map +1 -1
  62. package/_cjs/wasm/tkms/loadKmsLib.js.map +1 -1
  63. package/_esm/core/_version.js +1 -1
  64. package/_esm/core/actions/chain/fetchFheEncryptionKeyBytes.js +7 -1
  65. package/_esm/core/actions/chain/fetchFheEncryptionKeyBytes.js.map +1 -1
  66. package/_esm/core/chains/definitions/bscTestnet.js +33 -0
  67. package/_esm/core/chains/definitions/bscTestnet.js.map +1 -0
  68. package/_esm/core/chains/definitions/mainnet.js +3 -0
  69. package/_esm/core/chains/definitions/mainnet.js.map +1 -1
  70. package/_esm/core/chains/definitions/sepolia.js +3 -0
  71. package/_esm/core/chains/definitions/sepolia.js.map +1 -1
  72. package/_esm/core/chains/index.js +1 -0
  73. package/_esm/core/chains/index.js.map +1 -1
  74. package/_esm/core/clients/decorators/base.js.map +1 -1
  75. package/_esm/core/clients/decorators/encrypt-p.js +1 -1
  76. package/_esm/core/clients/decorators/encrypt-p.js.map +1 -1
  77. package/_esm/core/clients/decorators/encrypt.js +6 -0
  78. package/_esm/core/clients/decorators/encrypt.js.map +1 -1
  79. package/_esm/core/coprocessor/ZkProofBuilder-p.js +1 -1
  80. package/_esm/core/coprocessor/ZkProofBuilder-p.js.map +1 -1
  81. package/_esm/core/coprocessor/encrypt.js +5 -1
  82. package/_esm/core/coprocessor/encrypt.js.map +1 -1
  83. package/_esm/core/errors/FheEncryptionKeyVerificationError.js +15 -0
  84. package/_esm/core/errors/FheEncryptionKeyVerificationError.js.map +1 -0
  85. package/_esm/core/errors/FhevmErrorBase.js +0 -1
  86. package/_esm/core/errors/FhevmErrorBase.js.map +1 -1
  87. package/_esm/core/errors/RelayerErrorBase.js +0 -1
  88. package/_esm/core/errors/RelayerErrorBase.js.map +1 -1
  89. package/_esm/core/host-contracts/HostContractVersion-p.js +2 -1
  90. package/_esm/core/host-contracts/HostContractVersion-p.js.map +1 -1
  91. package/_esm/core/host-contracts/abi-fragments/fragments.js +61 -0
  92. package/_esm/core/host-contracts/abi-fragments/fragments.js.map +1 -1
  93. package/_esm/core/key/FheEncryptionKeyCache-p.js +91 -75
  94. package/_esm/core/key/FheEncryptionKeyCache-p.js.map +1 -1
  95. package/_esm/core/key/copyFheEncryptionKeyBytes-p.js +21 -0
  96. package/_esm/core/key/copyFheEncryptionKeyBytes-p.js.map +1 -0
  97. package/_esm/core/key/ensureFheEncryptionKeyDownload.js +213 -0
  98. package/_esm/core/key/ensureFheEncryptionKeyDownload.js.map +1 -0
  99. package/_esm/core/key/fetchFheEncryptionKey.js +6 -26
  100. package/_esm/core/key/fetchFheEncryptionKey.js.map +1 -1
  101. package/_esm/core/key/fetchFheEncryptionKeyBytes.js +4 -41
  102. package/_esm/core/key/fetchFheEncryptionKeyBytes.js.map +1 -1
  103. package/_esm/core/key/verifyFheEncryptionKeyBytes-p.js +345 -0
  104. package/_esm/core/key/verifyFheEncryptionKeyBytes-p.js.map +1 -0
  105. package/_esm/core/modules/encrypt/mock.js +7 -96
  106. package/_esm/core/modules/encrypt/mock.js.map +1 -1
  107. package/_esm/core/modules/encrypt/module/api-p.js +0 -71
  108. package/_esm/core/modules/encrypt/module/api-p.js.map +1 -1
  109. package/_esm/core/modules/encrypt/module/index.js +1 -4
  110. package/_esm/core/modules/encrypt/module/index.js.map +1 -1
  111. package/_esm/core/modules/relayer/cleartext/mock.js +1 -0
  112. package/_esm/core/modules/relayer/cleartext/mock.js.map +1 -1
  113. package/_esm/core/modules/relayer/module/RelayerAsyncRequest.js +14 -2
  114. package/_esm/core/modules/relayer/module/RelayerAsyncRequest.js.map +1 -1
  115. package/_esm/core/modules/relayer/module/fetchFheEncryptionKeySource.js +7 -4
  116. package/_esm/core/modules/relayer/module/fetchFheEncryptionKeySource.js.map +1 -1
  117. package/_esm/core/modules/relayer/module/relayerUrl.js +48 -1
  118. package/_esm/core/modules/relayer/module/relayerUrl.js.map +1 -1
  119. package/_esm/core/runtime/CoreFhevm-p.js +128 -15
  120. package/_esm/core/runtime/CoreFhevm-p.js.map +1 -1
  121. package/_esm/core/types/index.js.map +1 -1
  122. package/_esm/ethers/clients/createFhevmDecryptClient.js +5 -1
  123. package/_esm/ethers/clients/createFhevmDecryptClient.js.map +1 -1
  124. package/_esm/viem/clients/createFhevmDecryptClient.js +5 -1
  125. package/_esm/viem/clients/createFhevmDecryptClient.js.map +1 -1
  126. package/_types/core/actions/chain/fetchFheEncryptionKeyBytes.d.ts +5 -0
  127. package/_types/core/actions/chain/fetchFheEncryptionKeyBytes.d.ts.map +1 -1
  128. package/_types/core/chains/definitions/bscTestnet.d.ts +3 -0
  129. package/_types/core/chains/definitions/bscTestnet.d.ts.map +1 -0
  130. package/_types/core/chains/definitions/mainnet.d.ts +3 -0
  131. package/_types/core/chains/definitions/mainnet.d.ts.map +1 -1
  132. package/_types/core/chains/definitions/sepolia.d.ts.map +1 -1
  133. package/_types/core/chains/index.d.ts +1 -0
  134. package/_types/core/chains/index.d.ts.map +1 -1
  135. package/_types/core/clients/decorators/base.d.ts +4 -1
  136. package/_types/core/clients/decorators/base.d.ts.map +1 -1
  137. package/_types/core/clients/decorators/encrypt.d.ts.map +1 -1
  138. package/_types/core/coprocessor/ZkProofBuilder-p.d.ts +2 -4
  139. package/_types/core/coprocessor/ZkProofBuilder-p.d.ts.map +1 -1
  140. package/_types/core/coprocessor/encrypt.d.ts +2 -8
  141. package/_types/core/coprocessor/encrypt.d.ts.map +1 -1
  142. package/_types/core/errors/FheEncryptionKeyVerificationError.d.ts +16 -0
  143. package/_types/core/errors/FheEncryptionKeyVerificationError.d.ts.map +1 -0
  144. package/_types/core/errors/FhevmErrorBase.d.ts.map +1 -1
  145. package/_types/core/errors/RelayerErrorBase.d.ts.map +1 -1
  146. package/_types/core/errors/TfheError.d.ts +1 -1
  147. package/_types/core/host-contracts/HostContractVersion-p.d.ts +4 -0
  148. package/_types/core/host-contracts/HostContractVersion-p.d.ts.map +1 -1
  149. package/_types/core/host-contracts/abi-fragments/fragments.d.ts +12 -0
  150. package/_types/core/host-contracts/abi-fragments/fragments.d.ts.map +1 -1
  151. package/_types/core/key/FheEncryptionKeyCache-p.d.ts +45 -21
  152. package/_types/core/key/FheEncryptionKeyCache-p.d.ts.map +1 -1
  153. package/_types/core/key/copyFheEncryptionKeyBytes-p.d.ts +9 -0
  154. package/_types/core/key/copyFheEncryptionKeyBytes-p.d.ts.map +1 -0
  155. package/_types/core/key/ensureFheEncryptionKeyDownload.d.ts +73 -0
  156. package/_types/core/key/ensureFheEncryptionKeyDownload.d.ts.map +1 -0
  157. package/_types/core/key/fetchFheEncryptionKey.d.ts +2 -4
  158. package/_types/core/key/fetchFheEncryptionKey.d.ts.map +1 -1
  159. package/_types/core/key/fetchFheEncryptionKeyBytes.d.ts +2 -4
  160. package/_types/core/key/fetchFheEncryptionKeyBytes.d.ts.map +1 -1
  161. package/_types/core/key/verifyFheEncryptionKeyBytes-p.d.ts +61 -0
  162. package/_types/core/key/verifyFheEncryptionKeyBytes-p.d.ts.map +1 -0
  163. package/_types/core/modules/encrypt/mock.d.ts +1 -4
  164. package/_types/core/modules/encrypt/mock.d.ts.map +1 -1
  165. package/_types/core/modules/encrypt/module/api-p.d.ts +1 -4
  166. package/_types/core/modules/encrypt/module/api-p.d.ts.map +1 -1
  167. package/_types/core/modules/encrypt/module/index.d.ts.map +1 -1
  168. package/_types/core/modules/encrypt/types.d.ts +2 -26
  169. package/_types/core/modules/encrypt/types.d.ts.map +1 -1
  170. package/_types/core/modules/relayer/cleartext/mock.d.ts.map +1 -1
  171. package/_types/core/modules/relayer/module/RelayerAsyncRequest.d.ts +1 -0
  172. package/_types/core/modules/relayer/module/RelayerAsyncRequest.d.ts.map +1 -1
  173. package/_types/core/modules/relayer/module/fetchFheEncryptionKeySource.d.ts.map +1 -1
  174. package/_types/core/modules/relayer/module/relayerUrl.d.ts +12 -1
  175. package/_types/core/modules/relayer/module/relayerUrl.d.ts.map +1 -1
  176. package/_types/core/modules/relayer/types.d.ts +9 -1
  177. package/_types/core/modules/relayer/types.d.ts.map +1 -1
  178. package/_types/core/runtime/CoreFhevm-p.d.ts +23 -1
  179. package/_types/core/runtime/CoreFhevm-p.d.ts.map +1 -1
  180. package/_types/core/types/coreFhevmClient.d.ts +31 -4
  181. package/_types/core/types/coreFhevmClient.d.ts.map +1 -1
  182. package/_types/core/types/fhevmChain.d.ts +7 -0
  183. package/_types/core/types/fhevmChain.d.ts.map +1 -1
  184. package/_types/core/types/hostContract.d.ts +1 -0
  185. package/_types/core/types/hostContract.d.ts.map +1 -1
  186. package/_types/core/types/index.d.ts +1 -0
  187. package/_types/core/types/index.d.ts.map +1 -1
  188. package/_types/core/types/relayer.d.ts +6 -0
  189. package/_types/core/types/relayer.d.ts.map +1 -1
  190. package/_types/core/types/zkProofBuilder-p.d.ts +2 -4
  191. package/_types/core/types/zkProofBuilder-p.d.ts.map +1 -1
  192. package/_types/ethers/cleartext/createFhevmCleartextBaseClient.d.ts +1 -1
  193. package/_types/ethers/cleartext/createFhevmCleartextBaseClient.d.ts.map +1 -1
  194. package/_types/ethers/cleartext/createFhevmCleartextClient.d.ts +1 -1
  195. package/_types/ethers/cleartext/createFhevmCleartextClient.d.ts.map +1 -1
  196. package/_types/ethers/cleartext/createFhevmCleartextDecryptClient.d.ts +1 -1
  197. package/_types/ethers/cleartext/createFhevmCleartextDecryptClient.d.ts.map +1 -1
  198. package/_types/ethers/cleartext/createFhevmCleartextEncryptClient.d.ts +1 -1
  199. package/_types/ethers/cleartext/createFhevmCleartextEncryptClient.d.ts.map +1 -1
  200. package/_types/ethers/clients/createFhevmBaseClient.d.ts +1 -1
  201. package/_types/ethers/clients/createFhevmBaseClient.d.ts.map +1 -1
  202. package/_types/ethers/clients/createFhevmClient.d.ts +2 -2
  203. package/_types/ethers/clients/createFhevmClient.d.ts.map +1 -1
  204. package/_types/ethers/clients/createFhevmDecryptClient.d.ts +2 -2
  205. package/_types/ethers/clients/createFhevmDecryptClient.d.ts.map +1 -1
  206. package/_types/ethers/clients/createFhevmEncryptClient.d.ts +2 -2
  207. package/_types/ethers/clients/createFhevmEncryptClient.d.ts.map +1 -1
  208. package/_types/viem/cleartext/createFhevmCleartextBaseClient.d.ts +1 -1
  209. package/_types/viem/cleartext/createFhevmCleartextBaseClient.d.ts.map +1 -1
  210. package/_types/viem/cleartext/createFhevmCleartextClient.d.ts +1 -1
  211. package/_types/viem/cleartext/createFhevmCleartextClient.d.ts.map +1 -1
  212. package/_types/viem/cleartext/createFhevmCleartextDecryptClient.d.ts +1 -1
  213. package/_types/viem/cleartext/createFhevmCleartextDecryptClient.d.ts.map +1 -1
  214. package/_types/viem/cleartext/createFhevmCleartextEncryptClient.d.ts +1 -1
  215. package/_types/viem/cleartext/createFhevmCleartextEncryptClient.d.ts.map +1 -1
  216. package/_types/viem/clients/createFhevmBaseClient.d.ts +1 -1
  217. package/_types/viem/clients/createFhevmBaseClient.d.ts.map +1 -1
  218. package/_types/viem/clients/createFhevmClient.d.ts +2 -2
  219. package/_types/viem/clients/createFhevmClient.d.ts.map +1 -1
  220. package/_types/viem/clients/createFhevmDecryptClient.d.ts +2 -2
  221. package/_types/viem/clients/createFhevmDecryptClient.d.ts.map +1 -1
  222. package/_types/viem/clients/createFhevmEncryptClient.d.ts +2 -2
  223. package/_types/viem/clients/createFhevmEncryptClient.d.ts.map +1 -1
  224. package/core/_version.ts +1 -1
  225. package/core/actions/chain/fetchFheEncryptionKeyBytes.ts +7 -1
  226. package/core/chains/definitions/bscTestnet.ts +34 -0
  227. package/core/chains/definitions/mainnet.ts +3 -0
  228. package/core/chains/definitions/sepolia.ts +3 -0
  229. package/core/chains/index.ts +1 -0
  230. package/core/clients/decorators/base.ts +4 -1
  231. package/core/clients/decorators/encrypt-p.ts +1 -1
  232. package/core/clients/decorators/encrypt.ts +6 -0
  233. package/core/coprocessor/ZkProofBuilder-p.ts +3 -5
  234. package/core/coprocessor/encrypt.ts +10 -10
  235. package/core/errors/FheEncryptionKeyVerificationError.ts +27 -0
  236. package/core/errors/FhevmErrorBase.ts +0 -1
  237. package/core/errors/RelayerErrorBase.ts +0 -1
  238. package/core/errors/TfheError.ts +1 -1
  239. package/core/host-contracts/HostContractVersion-p.ts +2 -1
  240. package/core/host-contracts/abi-fragments/fragments.ts +69 -0
  241. package/core/key/FheEncryptionKeyCache-p.ts +92 -91
  242. package/core/key/copyFheEncryptionKeyBytes-p.ts +23 -0
  243. package/core/key/ensureFheEncryptionKeyDownload.ts +293 -0
  244. package/core/key/fetchFheEncryptionKey.ts +8 -35
  245. package/core/key/fetchFheEncryptionKeyBytes.ts +7 -56
  246. package/core/key/verifyFheEncryptionKeyBytes-p.ts +452 -0
  247. package/core/modules/encrypt/mock.ts +4 -149
  248. package/core/modules/encrypt/module/api-p.ts +1 -126
  249. package/core/modules/encrypt/module/index.ts +0 -12
  250. package/core/modules/encrypt/types.ts +2 -57
  251. package/core/modules/relayer/cleartext/mock.ts +1 -0
  252. package/core/modules/relayer/module/RelayerAsyncRequest.ts +11 -2
  253. package/core/modules/relayer/module/fetchFheEncryptionKeySource.ts +12 -4
  254. package/core/modules/relayer/module/relayerUrl.ts +52 -1
  255. package/core/modules/relayer/types.ts +9 -1
  256. package/core/runtime/CoreFhevm-p.ts +159 -21
  257. package/core/types/coreFhevmClient.ts +33 -4
  258. package/core/types/fhevmChain.ts +7 -0
  259. package/core/types/hostContract.ts +2 -0
  260. package/core/types/index.ts +1 -0
  261. package/core/types/relayer.ts +6 -0
  262. package/core/types/zkProofBuilder-p.ts +2 -1
  263. package/ethers/cleartext/createFhevmCleartextBaseClient.ts +1 -1
  264. package/ethers/cleartext/createFhevmCleartextClient.ts +1 -1
  265. package/ethers/cleartext/createFhevmCleartextDecryptClient.ts +1 -1
  266. package/ethers/cleartext/createFhevmCleartextEncryptClient.ts +1 -1
  267. package/ethers/clients/createFhevmBaseClient.ts +1 -1
  268. package/ethers/clients/createFhevmClient.ts +2 -2
  269. package/ethers/clients/createFhevmDecryptClient.ts +7 -3
  270. package/ethers/clients/createFhevmEncryptClient.ts +2 -2
  271. package/package.json +1 -1
  272. package/viem/cleartext/createFhevmCleartextBaseClient.ts +1 -1
  273. package/viem/cleartext/createFhevmCleartextClient.ts +1 -1
  274. package/viem/cleartext/createFhevmCleartextDecryptClient.ts +1 -1
  275. package/viem/cleartext/createFhevmCleartextEncryptClient.ts +1 -1
  276. package/viem/clients/createFhevmBaseClient.ts +1 -1
  277. package/viem/clients/createFhevmClient.ts +2 -2
  278. package/viem/clients/createFhevmDecryptClient.ts +7 -3
  279. package/viem/clients/createFhevmEncryptClient.ts +2 -2
  280. package/_cjs/core/key/serializeFheEncryptionKey.js +0 -25
  281. package/_cjs/core/key/serializeFheEncryptionKey.js.map +0 -1
  282. package/_esm/core/key/serializeFheEncryptionKey.js +0 -24
  283. package/_esm/core/key/serializeFheEncryptionKey.js.map +0 -1
  284. package/_types/core/key/serializeFheEncryptionKey.d.ts +0 -6
  285. package/_types/core/key/serializeFheEncryptionKey.d.ts.map +0 -1
  286. package/core/key/serializeFheEncryptionKey.ts +0 -42
@@ -0,0 +1,213 @@
1
+ import { unsafeBytesEquals } from '../base/bytes.js';
2
+ import { FheEncryptionKeyVerificationError } from '../errors/FheEncryptionKeyVerificationError.js';
3
+ import { getProvidedFheEncryptionKey, getProvidedFheEncryptionKeyError, releaseProvidedFheEncryptionKey, } from '../runtime/CoreFhevm-p.js';
4
+ import { globalFheEncryptionKeyCache } from './FheEncryptionKeyCache-p.js';
5
+ import { requiresKeyVerification, resolveKmsGeneration, verifyFheEncryptionKeyBytes, } from './verifyFheEncryptionKeyBytes-p.js';
6
+ ////////////////////////////////////////////////////////////////////////////////
7
+ /**
8
+ * The client's slot in the global key cache: the relayer URL, then what the
9
+ * key is checked against:
10
+ * - `<relayer URL>|kmsgen:<chain id>:<address>`: the KMSGeneration contract;
11
+ * - `<relayer URL>|unverified`: nothing (see
12
+ * `skipsFheEncryptionKeyVerification`); clients that check keys never
13
+ * read it.
14
+ *
15
+ * Clients share a slot only when they name the same relayer and
16
+ * KMSGeneration, so a wrong setting evicts only its own slot. A client
17
+ * whose RPC returns other state for that same contract (e.g. a fork)
18
+ * still shares the slot and can evict it. Neither suffix contains `|`, so
19
+ * two different slots never give the same string.
20
+ *
21
+ * @throws {FhevmConfigError} when the client cannot check key material.
22
+ * @internal
23
+ */
24
+ export function getFheEncryptionKeySlot(context) {
25
+ const relayerUrl = context.chain.fhevm.relayerUrl;
26
+ if (!requiresKeyVerification(context.runtime)) {
27
+ return `${relayerUrl}|unverified`;
28
+ }
29
+ const { chainId, address } = resolveKmsGeneration(context);
30
+ return `${relayerUrl}|kmsgen:${chainId}:${address}`;
31
+ }
32
+ /**
33
+ * Starts the FHE encryption key download into the global cache, or joins the
34
+ * one in flight, then checks the key against `KMSGeneration` for this client,
35
+ * with its own settings (once per client and key). Builds the relayer request
36
+ * (e.g. auth) for both the bytes and the encryption paths. Does not convert
37
+ * the key.
38
+ *
39
+ * A caller-provided key (`options.fheEncryptionKey`) replaces the download:
40
+ * - equal to the cached key, once downloaded: the cached key is used, checked
41
+ * for this client;
42
+ * - otherwise (including while a download is in flight): checked, then cached,
43
+ * replacing a cached key, which is stale (only one key is active at a time),
44
+ * unless the cache holds the same key by then: that one is used, as above.
45
+ *
46
+ * Outcomes of the check:
47
+ * - pass: a provided key is cached and the client releases it;
48
+ * - {@link FheEncryptionKeyVerificationError}: a downloaded key leaves the
49
+ * cache, the next call downloads again; the client drops a provided key and
50
+ * keeps only the error: later calls throw it, with no RPC call and no
51
+ * download;
52
+ * - any other error (e.g. network): the key stays as is, the next call checks
53
+ * it again.
54
+ *
55
+ * Callers use the returned entry, the one checked, never the slot's current
56
+ * one: another entry may have taken the slot since.
57
+ *
58
+ * @throws {FhevmConfigError} when the client cannot check key material.
59
+ * @throws {FheEncryptionKeyVerificationError} when the key fails the check.
60
+ * @internal
61
+ */
62
+ export async function ensureFheEncryptionKeyDownload(context, parameters) {
63
+ const relayerUrl = context.chain.fhevm.relayerUrl;
64
+ const runtime = context.runtime;
65
+ const logger = runtime.config.logger;
66
+ // A provided key that failed the check: only its error is left.
67
+ const providedError = getProvidedFheEncryptionKeyError(context);
68
+ if (providedError !== undefined) {
69
+ throw providedError;
70
+ }
71
+ // Checks the client's own setup, even when another client filled the cache.
72
+ const slot = getFheEncryptionKeySlot(context);
73
+ const provided = getProvidedFheEncryptionKey(context);
74
+ if (provided !== undefined) {
75
+ return _useProvidedFheEncryptionKey(context, provided, slot);
76
+ }
77
+ // Caller-provided options override runtime config defaults (e.g. auth)
78
+ const relayerParameters = {
79
+ ...parameters,
80
+ options: { auth: context.runtime.config.auth, ...parameters.options },
81
+ };
82
+ // Shared by every client on the slot: a download in flight is joined, and
83
+ // runs with the request options (e.g. auth, abort signal, retries) of the
84
+ // client that started it.
85
+ const entry = globalFheEncryptionKeyCache.ensureBytes({
86
+ owner: runtime,
87
+ slot,
88
+ fetcher: async () => {
89
+ logger?.debug?.(`Fetching FHE encryption key/CRS bytes from relayer "${relayerUrl}" (chainId=${context.chain.id}).`);
90
+ try {
91
+ const bytes = await runtime.relayer.fetchFheEncryptionKeyBytes({ relayerUrl, chainId: context.chain.id }, relayerParameters);
92
+ logger?.debug?.(`Fetched FHE encryption key/CRS bytes from relayer "${relayerUrl}".`);
93
+ return bytes;
94
+ }
95
+ catch (e) {
96
+ logger?.error?.(`Failed to fetch FHE encryption key/CRS bytes from relayer "${relayerUrl}".`, e);
97
+ throw e;
98
+ }
99
+ },
100
+ metadata: { chainId: context.chain.id, relayerUrl },
101
+ });
102
+ return _verifyCachedFheEncryptionKey(context, slot, entry);
103
+ }
104
+ ////////////////////////////////////////////////////////////////////////////////
105
+ // Each client's check of each key (bytes object): concurrent calls on a
106
+ // client share one set of KMSGeneration reads. A key that fails the check stays
107
+ // failed; any other error (e.g. network) is retried by the next call.
108
+ const clientVerifications = new WeakMap();
109
+ function _verifyFheEncryptionKeyBytesForClient(context, bytes) {
110
+ if (!requiresKeyVerification(context.runtime)) {
111
+ return Promise.resolve();
112
+ }
113
+ const checks = clientVerifications.get(bytes) ?? new WeakMap();
114
+ clientVerifications.set(bytes, checks);
115
+ return _memoize(checks, context, () => verifyFheEncryptionKeyBytes(context, bytes).then(() => undefined), true);
116
+ }
117
+ async function _verifyCachedFheEncryptionKey(context, slot, entry) {
118
+ const bytes = await globalFheEncryptionKeyCache.entryBytes(entry);
119
+ try {
120
+ await _verifyFheEncryptionKeyBytesForClient(context, bytes);
121
+ }
122
+ catch (e) {
123
+ if (e instanceof FheEncryptionKeyVerificationError) {
124
+ // Clients on this slot check against the same KMSGeneration, so they
125
+ // reject these bytes too (unless their RPC serves other chain state).
126
+ globalFheEncryptionKeyCache.evict(slot, entry);
127
+ }
128
+ throw e;
129
+ }
130
+ return { slot, entry, bytes };
131
+ }
132
+ ////////////////////////////////////////////////////////////////////////////////
133
+ // The use of each client's provided key (its own copy): concurrent calls on a
134
+ // client share the one in flight. A failed use is forgotten: the client keeps
135
+ // the error of a key that fails the check (see ensureFheEncryptionKeyDownload),
136
+ // any other error is retried by the next call.
137
+ const providedKeyUses = new WeakMap();
138
+ function _useProvidedFheEncryptionKey(context, provided, slot) {
139
+ return _memoize(providedKeyUses, provided, async () => {
140
+ try {
141
+ const cachedEntry = await _getSameCachedEntry(slot, provided);
142
+ let checked;
143
+ if (cachedEntry !== undefined) {
144
+ checked = await _verifyCachedFheEncryptionKey(context, slot, cachedEntry);
145
+ }
146
+ else {
147
+ await _verifyFheEncryptionKeyBytesForClient(context, provided);
148
+ // Another client may have cached the same key during the check: use
149
+ // its entry rather than orphan it.
150
+ const sameEntry = await _getSameCachedEntry(slot, provided);
151
+ if (sameEntry !== undefined) {
152
+ checked = await _verifyCachedFheEncryptionKey(context, slot, sameEntry);
153
+ }
154
+ else {
155
+ const entry = globalFheEncryptionKeyCache.replaceBytes(context.runtime, slot, context.chain.fhevm.relayerUrl, provided);
156
+ checked = { slot, entry, bytes: provided };
157
+ }
158
+ }
159
+ // The cache holds the key from now on.
160
+ releaseProvidedFheEncryptionKey(context, provided);
161
+ return checked;
162
+ }
163
+ catch (e) {
164
+ if (e instanceof FheEncryptionKeyVerificationError) {
165
+ // The client keeps only the error, not the bytes.
166
+ releaseProvidedFheEncryptionKey(context, provided, e);
167
+ }
168
+ throw e;
169
+ }
170
+ }, false);
171
+ }
172
+ /**
173
+ * The slot's entry if it holds `provided`'s bytes. Compared only with a cached
174
+ * key already downloaded: never waits for another client's download.
175
+ */
176
+ async function _getSameCachedEntry(slot, provided) {
177
+ const entry = globalFheEncryptionKeyCache.get(slot);
178
+ if (entry?.resolvedKind === undefined) {
179
+ return undefined;
180
+ }
181
+ const cached = await globalFheEncryptionKeyCache.entryBytes(entry);
182
+ return _sameFheEncryptionKeyBytes(provided, cached) ? entry : undefined;
183
+ }
184
+ /**
185
+ * Memoizes `start()` under `key`: concurrent and later calls share it. A
186
+ * rejection is forgotten, so the next call starts again, except a
187
+ * {@link FheEncryptionKeyVerificationError} when `keepVerificationError`.
188
+ */
189
+ function _memoize(memo, key, start, keepVerificationError) {
190
+ const memoized = memo.get(key);
191
+ if (memoized !== undefined) {
192
+ return memoized;
193
+ }
194
+ const check = start();
195
+ memo.set(key, check);
196
+ check.catch((e) => {
197
+ if (!(keepVerificationError && e instanceof FheEncryptionKeyVerificationError) && memo.get(key) === check) {
198
+ memo.delete(key);
199
+ }
200
+ });
201
+ return check;
202
+ }
203
+ /**
204
+ * Ids aside: a label id and a 32-byte hex id can name the same bytes. The
205
+ * check against the active ids decides (a relayer serving the right bytes under
206
+ * a wrong id fails the check for clients reusing that entry).
207
+ */
208
+ function _sameFheEncryptionKeyBytes(a, b) {
209
+ return (a === b ||
210
+ (unsafeBytesEquals(a.publicKeyBytes.bytes, b.publicKeyBytes.bytes) &&
211
+ unsafeBytesEquals(a.crsBytes.bytes, b.crsBytes.bytes)));
212
+ }
213
+ //# sourceMappingURL=ensureFheEncryptionKeyDownload.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ensureFheEncryptionKeyDownload.js","sourceRoot":"","sources":["../../../core/key/ensureFheEncryptionKeyDownload.ts"],"names":[],"mappings":"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"}
@@ -1,37 +1,17 @@
1
1
  import { deserializeFheEncryptionKey } from './deserializeFheEncryptionKey.js';
2
2
  import { globalFheEncryptionKeyCache } from './FheEncryptionKeyCache-p.js';
3
+ import { ensureFheEncryptionKeyDownload } from './ensureFheEncryptionKeyDownload.js';
3
4
  export async function fetchFheEncryptionKeyWasm(context, parameters) {
4
- const relayerUrl = context.chain.fhevm.relayerUrl;
5
5
  const runtime = context.runtime;
6
- const logger = runtime.config.logger;
7
- // Ensure a bytes fetch is in-flight
8
- globalFheEncryptionKeyCache.ensureBytes({
9
- owner: runtime,
10
- relayerUrl,
11
- fetcher: async () => {
12
- logger?.debug?.(`Fetching FHE encryption key/CRS bytes from relayer "${relayerUrl}" (chainId=${context.chain.id}).`);
13
- try {
14
- const bytes = await runtime.relayer.fetchFheEncryptionKeyBytes({ relayerUrl, chainId: context.chain.id }, parameters);
15
- logger?.debug?.(`Fetched FHE encryption key/CRS bytes from relayer "${relayerUrl}".`);
16
- return bytes;
17
- }
18
- catch (e) {
19
- logger?.error?.(`Failed to fetch FHE encryption key/CRS bytes from relayer "${relayerUrl}".`, e);
20
- throw e;
21
- }
22
- },
23
- metadata: { chainId: context.chain.id, relayerUrl },
24
- });
25
- // Upgrade bytes → wasm (chains from pending bytes if still in-flight)
6
+ // Download (or join the download), then check the key for this client
7
+ const { slot, entry } = await ensureFheEncryptionKeyDownload(context, parameters);
8
+ // Upgrade bytes → wasm, on the entry checked (not the slot's current one)
26
9
  globalFheEncryptionKeyCache.ensureWasm({
27
10
  owner: runtime,
28
- relayerUrl,
11
+ slot,
12
+ entry,
29
13
  deserializeFn: (bytes) => deserializeFheEncryptionKey(context, { keyBytes: bytes, fhevmContext: parameters.fhevmContext }),
30
14
  });
31
- const entry = globalFheEncryptionKeyCache.get(relayerUrl);
32
- if (entry === undefined) {
33
- throw new Error('Failed to fetch global FHE PKE params');
34
- }
35
15
  await entry.ready;
36
16
  if (entry.resolvedKind !== 'wasm') {
37
17
  throw new Error('Expected wasm params but got ' + JSON.stringify(entry.resolvedKind));
@@ -1 +1 @@
1
- {"version":3,"file":"fetchFheEncryptionKey.js","sourceRoot":"","sources":["../../../core/key/fetchFheEncryptionKey.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAE3E,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAGC,EACD,UAIC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC;IAClD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;IAErC,oCAAoC;IACpC,2BAA2B,CAAC,WAAW,CAAC;QACtC,KAAK,EAAE,OAAO;QACd,UAAU;QACV,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,EAAE,KAAK,EAAE,CACb,uDAAuD,UAAU,cAAc,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,CACpG,CAAC;YACF,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,0BAA0B,CAC5D,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,EACzC,UAAU,CACX,CAAC;gBACF,MAAM,EAAE,KAAK,EAAE,CAAC,sDAAsD,UAAU,IAAI,CAAC,CAAC;gBACtF,OAAO,KAAK,CAAC;YACf,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,EAAE,KAAK,EAAE,CAAC,8DAA8D,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC;gBACjG,MAAM,CAAC,CAAC;YACV,CAAC;QACH,CAAC;QACD,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE;KACpD,CAAC,CAAC;IAEH,sEAAsE;IACtE,2BAA2B,CAAC,UAAU,CAAC;QACrC,KAAK,EAAE,OAAO;QACd,UAAU;QACV,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CACvB,2BAA2B,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,CAAC,YAAY,EAAE,CAAC;KACnG,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,2BAA2B,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC1D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,KAAK,CAAC,KAAK,CAAC;IAElB,IAAI,KAAK,CAAC,YAAY,KAAK,MAAM,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,+BAA+B,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IACxF,CAAC;IAED,OAAO,KAAK,CAAC,KAA6B,CAAC;AAC7C,CAAC"}
1
+ {"version":3,"file":"fetchFheEncryptionKey.js","sourceRoot":"","sources":["../../../core/key/fetchFheEncryptionKey.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AAErF,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAiE,EACjE,UAIC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAEhC,sEAAsE;IACtE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,8BAA8B,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAElF,0EAA0E;IAC1E,2BAA2B,CAAC,UAAU,CAAC;QACrC,KAAK,EAAE,OAAO;QACd,IAAI;QACJ,KAAK;QACL,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CACvB,2BAA2B,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,CAAC,YAAY,EAAE,CAAC;KACnG,CAAC,CAAC;IAEH,MAAM,KAAK,CAAC,KAAK,CAAC;IAElB,IAAI,KAAK,CAAC,YAAY,KAAK,MAAM,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,+BAA+B,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IACxF,CAAC;IAED,OAAO,KAAK,CAAC,KAA6B,CAAC;AAC7C,CAAC"}
@@ -1,46 +1,9 @@
1
- import { globalFheEncryptionKeyCache } from './FheEncryptionKeyCache-p.js';
2
- import { serializeFheEncryptionKeyWasm } from './serializeFheEncryptionKey.js';
3
- import { asFhevmRuntimeWith } from '../runtime/CoreFhevmRuntime-p.js';
1
+ import { ensureFheEncryptionKeyDownload } from './ensureFheEncryptionKeyDownload.js';
4
2
  ////////////////////////////////////////////////////////////////////////////////
5
3
  export async function fetchFheEncryptionKeyBytes(context, parameters) {
6
- const relayerUrl = context.chain.fhevm.relayerUrl;
7
- const runtime = context.runtime;
8
- // Caller-provided options override runtime config defaults (e.g. auth)
9
- const relayerParameters = {
10
- ...parameters,
11
- options: { auth: context.runtime.config.auth, ...parameters.options },
12
- };
13
- // Ensure a fetch is in-flight
14
- globalFheEncryptionKeyCache.ensureBytes({
15
- owner: runtime,
16
- relayerUrl,
17
- fetcher: () => runtime.relayer.fetchFheEncryptionKeyBytes({ relayerUrl, chainId: context.chain.id }, relayerParameters),
18
- metadata: { chainId: context.chain.id, relayerUrl },
19
- });
20
- const bytes = await globalFheEncryptionKeyCache.resolveBytes({
21
- relayerUrl,
22
- serializeFn: _getSerializeFn(context),
23
- });
24
- if (bytes === undefined) {
25
- throw new Error('Failed to fetch global FHE PKE params bytes');
26
- }
4
+ // Download (or join the download), then check the key for this client:
5
+ // the bytes checked, not the slot's current ones
6
+ const { bytes } = await ensureFheEncryptionKeyDownload(context, parameters);
27
7
  return bytes;
28
8
  }
29
- /**
30
- * Returns a serialize function that converts wasm params to bytes,
31
- * or `undefined` if the encrypt module is not available on the runtime.
32
- */
33
- function _getSerializeFn(context) {
34
- // Try to get a serialize fn if the encrypt module is available
35
- let serializeFn;
36
- try {
37
- // check if the 'encrypt' module is available
38
- const r = asFhevmRuntimeWith(context.runtime, 'encrypt');
39
- serializeFn = (args) => serializeFheEncryptionKeyWasm({ runtime: r }, args);
40
- }
41
- catch {
42
- // encrypt module not available
43
- }
44
- return serializeFn;
45
- }
46
9
  //# sourceMappingURL=fetchFheEncryptionKeyBytes.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"fetchFheEncryptionKeyBytes.js","sourceRoot":"","sources":["../../../core/key/fetchFheEncryptionKeyBytes.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEtE,gFAAgF;AAEhF,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,OAGC,EACD,UAIC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC;IAClD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAEhC,uEAAuE;IACvE,MAAM,iBAAiB,GAAyC;QAC9D,GAAG,UAAU;QACb,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,UAAU,CAAC,OAAO,EAAE;KACtE,CAAC;IAEF,8BAA8B;IAC9B,2BAA2B,CAAC,WAAW,CAAC;QACtC,KAAK,EAAE,OAAO;QACd,UAAU;QACV,OAAO,EAAE,GAAG,EAAE,CACZ,OAAO,CAAC,OAAO,CAAC,0BAA0B,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,iBAAiB,CAAC;QAC1G,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE;KACpD,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,MAAM,2BAA2B,CAAC,YAAY,CAAC;QAC3D,UAAU;QACV,WAAW,EAAE,eAAe,CAAC,OAAO,CAAC;KACtC,CAAC,CAAC;IAEH,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,OAExB;IACC,+DAA+D;IAC/D,IAAI,WAAyF,CAAC;IAE9F,IAAI,CAAC;QACH,6CAA6C;QAC7C,MAAM,CAAC,GAAG,kBAAkB,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACzD,WAAW,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,6BAA6B,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC9E,CAAC;IAAC,MAAM,CAAC;QACP,+BAA+B;IACjC,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}
1
+ {"version":3,"file":"fetchFheEncryptionKeyBytes.js","sourceRoot":"","sources":["../../../core/key/fetchFheEncryptionKeyBytes.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AAErF,gFAAgF;AAEhF,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,OAAkE,EAClE,UAIC;IAED,uEAAuE;IACvE,iDAAiD;IACjD,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,8BAA8B,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAE5E,OAAO,KAAK,CAAC;AACf,CAAC"}