@opendatalabs/vana-sdk 0.1.0-alpha.e2e45dd → 0.1.0-alpha.e2f8234

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 (992) hide show
  1. package/README.md +67 -300
  2. package/dist/__tests__/waitForTransactionEvents.test.d.ts +1 -0
  3. package/dist/browser.cjs +29 -0
  4. package/dist/browser.cjs.map +1 -0
  5. package/dist/browser.d.ts +36 -1
  6. package/dist/browser.js +1 -290
  7. package/dist/browser.js.map +1 -1
  8. package/dist/{chains.browser.cjs → chains/definitions.cjs} +16 -17
  9. package/dist/chains/definitions.cjs.map +1 -0
  10. package/dist/{chains.browser.d.cts → chains/definitions.d.ts} +9 -11
  11. package/dist/chains/definitions.js +67 -0
  12. package/dist/chains/definitions.js.map +1 -0
  13. package/dist/chains/index.cjs +37 -0
  14. package/dist/chains/index.cjs.map +1 -0
  15. package/dist/chains/index.d.ts +34 -0
  16. package/dist/chains/index.js +15 -0
  17. package/dist/chains/index.js.map +1 -0
  18. package/dist/chains.browser.d.ts +5 -50
  19. package/dist/chains.browser.js +7 -57
  20. package/dist/chains.browser.js.map +1 -1
  21. package/dist/chains.cjs +6 -65
  22. package/dist/chains.cjs.map +1 -1
  23. package/dist/chains.d.ts +8 -2
  24. package/dist/chains.js +7 -57
  25. package/dist/chains.js.map +1 -1
  26. package/dist/chains.node.cjs +6 -65
  27. package/dist/chains.node.cjs.map +1 -1
  28. package/dist/chains.node.d.ts +8 -2
  29. package/dist/chains.node.js +7 -57
  30. package/dist/chains.node.js.map +1 -1
  31. package/dist/client/__tests__/enhancedResponse.test.d.ts +1 -0
  32. package/dist/client/enhancedResponse.cjs +164 -0
  33. package/dist/client/enhancedResponse.cjs.map +1 -0
  34. package/dist/client/enhancedResponse.d.ts +120 -0
  35. package/dist/client/enhancedResponse.js +138 -0
  36. package/dist/client/enhancedResponse.js.map +1 -0
  37. package/dist/config/chains.cjs +93 -0
  38. package/dist/config/chains.cjs.map +1 -0
  39. package/dist/config/chains.d.ts +180 -0
  40. package/dist/config/chains.js +67 -0
  41. package/dist/config/chains.js.map +1 -0
  42. package/dist/config/contracts.config.cjs +400 -0
  43. package/dist/config/contracts.config.cjs.map +1 -0
  44. package/dist/config/contracts.config.d.ts +84 -0
  45. package/dist/config/contracts.config.js +375 -0
  46. package/dist/config/contracts.config.js.map +1 -0
  47. package/dist/config/default-services.cjs +60 -0
  48. package/dist/config/default-services.cjs.map +1 -0
  49. package/dist/config/default-services.d.ts +46 -0
  50. package/dist/config/default-services.js +33 -0
  51. package/dist/config/default-services.js.map +1 -0
  52. package/dist/config/default-services.test.d.ts +1 -0
  53. package/dist/config/features.cjs +52 -0
  54. package/dist/config/features.cjs.map +1 -0
  55. package/dist/config/features.d.ts +62 -0
  56. package/dist/config/features.js +28 -0
  57. package/dist/config/features.js.map +1 -0
  58. package/dist/config/tests/addresses.test.d.ts +1 -0
  59. package/dist/contracts/contractController.cjs +126 -0
  60. package/dist/contracts/contractController.cjs.map +1 -0
  61. package/dist/contracts/contractController.d.ts +135 -0
  62. package/dist/contracts/contractController.js +100 -0
  63. package/dist/contracts/contractController.js.map +1 -0
  64. package/dist/contracts/tests/contractController.test.d.ts +1 -0
  65. package/dist/controllers/__tests__/data-consistency-integration.test.d.ts +7 -0
  66. package/dist/controllers/__tests__/operations.processQueue.test.d.ts +1 -0
  67. package/dist/controllers/__tests__/schemas-edge-cases.test.d.ts +1 -0
  68. package/dist/controllers/accessSettlement.cjs +289 -0
  69. package/dist/controllers/accessSettlement.cjs.map +1 -0
  70. package/dist/controllers/accessSettlement.d.ts +157 -0
  71. package/dist/controllers/accessSettlement.js +265 -0
  72. package/dist/controllers/accessSettlement.js.map +1 -0
  73. package/dist/controllers/accessSettlement.test.d.ts +1 -0
  74. package/dist/controllers/base.cjs +116 -0
  75. package/dist/controllers/base.cjs.map +1 -0
  76. package/dist/controllers/base.d.ts +94 -0
  77. package/dist/controllers/base.js +92 -0
  78. package/dist/controllers/base.js.map +1 -0
  79. package/dist/controllers/data-error-handling.test.d.ts +1 -0
  80. package/dist/controllers/data.cjs +2633 -0
  81. package/dist/controllers/data.cjs.map +1 -0
  82. package/dist/controllers/data.d.ts +1067 -0
  83. package/dist/controllers/data.js +2626 -0
  84. package/dist/controllers/data.js.map +1 -0
  85. package/dist/controllers/operations.cjs +430 -0
  86. package/dist/controllers/operations.cjs.map +1 -0
  87. package/dist/controllers/operations.d.ts +229 -0
  88. package/dist/controllers/operations.js +406 -0
  89. package/dist/controllers/operations.js.map +1 -0
  90. package/dist/controllers/permissions.cjs +4363 -0
  91. package/dist/controllers/permissions.cjs.map +1 -0
  92. package/dist/controllers/permissions.d.ts +1411 -0
  93. package/dist/controllers/permissions.js +4339 -0
  94. package/dist/controllers/permissions.js.map +1 -0
  95. package/dist/controllers/protocol.cjs +183 -0
  96. package/dist/controllers/protocol.cjs.map +1 -0
  97. package/dist/controllers/protocol.d.ts +138 -0
  98. package/dist/controllers/protocol.js +163 -0
  99. package/dist/controllers/protocol.js.map +1 -0
  100. package/dist/controllers/runtimePermissions.cjs +285 -0
  101. package/dist/controllers/runtimePermissions.cjs.map +1 -0
  102. package/dist/controllers/runtimePermissions.d.ts +152 -0
  103. package/dist/controllers/runtimePermissions.js +264 -0
  104. package/dist/controllers/runtimePermissions.js.map +1 -0
  105. package/dist/controllers/runtimePermissions.test.d.ts +1 -0
  106. package/dist/controllers/schemas.cjs +678 -0
  107. package/dist/controllers/schemas.cjs.map +1 -0
  108. package/dist/controllers/schemas.d.ts +293 -0
  109. package/dist/controllers/schemas.js +654 -0
  110. package/dist/controllers/schemas.js.map +1 -0
  111. package/dist/controllers/server-additional.test.d.ts +1 -0
  112. package/dist/controllers/server.cjs +643 -0
  113. package/dist/controllers/server.cjs.map +1 -0
  114. package/dist/controllers/server.d.ts +322 -0
  115. package/dist/controllers/server.js +624 -0
  116. package/dist/controllers/server.js.map +1 -0
  117. package/dist/core/__tests__/health.test.d.ts +1 -0
  118. package/dist/core/__tests__/inMemoryNonceManager.test.d.ts +1 -0
  119. package/dist/core/__tests__/nonceManager.test.d.ts +1 -0
  120. package/dist/core/__tests__/pollingManager.test.d.ts +4 -0
  121. package/dist/core/apiClient.cjs +378 -0
  122. package/dist/core/apiClient.cjs.map +1 -0
  123. package/dist/core/apiClient.d.ts +286 -0
  124. package/dist/core/apiClient.js +359 -0
  125. package/dist/core/apiClient.js.map +1 -0
  126. package/dist/core/client.cjs +70 -0
  127. package/dist/core/client.cjs.map +1 -0
  128. package/dist/core/client.d.ts +89 -0
  129. package/dist/core/client.js +47 -0
  130. package/dist/core/client.js.map +1 -0
  131. package/dist/core/core.test.d.ts +1 -0
  132. package/dist/core/generics.cjs +417 -0
  133. package/dist/core/generics.cjs.map +1 -0
  134. package/dist/core/generics.d.ts +205 -0
  135. package/dist/core/generics.js +386 -0
  136. package/dist/core/generics.js.map +1 -0
  137. package/dist/core/health.cjs +289 -0
  138. package/dist/core/health.cjs.map +1 -0
  139. package/dist/core/health.d.ts +143 -0
  140. package/dist/core/health.js +265 -0
  141. package/dist/core/health.js.map +1 -0
  142. package/dist/core/inMemoryNonceManager.cjs +138 -0
  143. package/dist/core/inMemoryNonceManager.cjs.map +1 -0
  144. package/dist/core/inMemoryNonceManager.d.ts +69 -0
  145. package/dist/core/inMemoryNonceManager.js +114 -0
  146. package/dist/core/inMemoryNonceManager.js.map +1 -0
  147. package/dist/core/nonceManager.cjs +304 -0
  148. package/dist/core/nonceManager.cjs.map +1 -0
  149. package/dist/core/nonceManager.d.ts +116 -0
  150. package/dist/core/nonceManager.js +280 -0
  151. package/dist/core/nonceManager.js.map +1 -0
  152. package/dist/core/pollingManager.cjs +292 -0
  153. package/dist/core/pollingManager.cjs.map +1 -0
  154. package/dist/core/pollingManager.d.ts +120 -0
  155. package/dist/core/pollingManager.js +268 -0
  156. package/dist/core/pollingManager.js.map +1 -0
  157. package/dist/core/tests/apiClient.test.d.ts +1 -0
  158. package/dist/core/tests/client.test.d.ts +1 -0
  159. package/dist/core/tests/generics.test.d.ts +1 -0
  160. package/dist/core.cjs +785 -0
  161. package/dist/core.cjs.map +1 -0
  162. package/dist/core.d.ts +499 -0
  163. package/dist/core.js +760 -0
  164. package/dist/core.js.map +1 -0
  165. package/dist/crypto/ecies/__tests__/base.test.d.ts +4 -0
  166. package/dist/crypto/ecies/__tests__/compatibility.test.d.ts +8 -0
  167. package/dist/crypto/ecies/__tests__/constants.test.d.ts +4 -0
  168. package/dist/crypto/ecies/__tests__/interface.test.d.ts +1 -0
  169. package/dist/crypto/ecies/__tests__/native-parity.test.d.ts +7 -0
  170. package/dist/crypto/ecies/__tests__/normalization.test.d.ts +1 -0
  171. package/dist/crypto/ecies/__tests__/serialization.test.d.ts +8 -0
  172. package/dist/crypto/ecies/__tests__/test-vectors.cjs +102 -0
  173. package/dist/crypto/ecies/__tests__/test-vectors.cjs.map +1 -0
  174. package/dist/crypto/ecies/__tests__/test-vectors.d.ts +38 -0
  175. package/dist/crypto/ecies/__tests__/test-vectors.js +77 -0
  176. package/dist/crypto/ecies/__tests__/test-vectors.js.map +1 -0
  177. package/dist/crypto/ecies/__tests__/utils.test.d.ts +1 -0
  178. package/dist/crypto/ecies/base.cjs +268 -0
  179. package/dist/crypto/ecies/base.cjs.map +1 -0
  180. package/dist/crypto/ecies/base.d.ts +140 -0
  181. package/dist/crypto/ecies/base.js +244 -0
  182. package/dist/crypto/ecies/base.js.map +1 -0
  183. package/dist/crypto/ecies/browser.cjs +165 -0
  184. package/dist/crypto/ecies/browser.cjs.map +1 -0
  185. package/dist/crypto/ecies/browser.d.ts +43 -0
  186. package/dist/crypto/ecies/browser.js +131 -0
  187. package/dist/crypto/ecies/browser.js.map +1 -0
  188. package/dist/crypto/ecies/constants.cjs +123 -0
  189. package/dist/crypto/ecies/constants.cjs.map +1 -0
  190. package/dist/crypto/ecies/constants.d.ts +111 -0
  191. package/dist/crypto/ecies/constants.js +94 -0
  192. package/dist/crypto/ecies/constants.js.map +1 -0
  193. package/dist/crypto/ecies/index.cjs +35 -0
  194. package/dist/crypto/ecies/index.cjs.map +1 -0
  195. package/dist/crypto/ecies/index.d.ts +8 -0
  196. package/dist/crypto/ecies/index.js +13 -0
  197. package/dist/crypto/ecies/index.js.map +1 -0
  198. package/dist/crypto/ecies/interface.cjs +104 -0
  199. package/dist/crypto/ecies/interface.cjs.map +1 -0
  200. package/dist/crypto/ecies/interface.d.ts +174 -0
  201. package/dist/crypto/ecies/interface.js +77 -0
  202. package/dist/crypto/ecies/interface.js.map +1 -0
  203. package/dist/crypto/ecies/node.cjs +167 -0
  204. package/dist/crypto/ecies/node.cjs.map +1 -0
  205. package/dist/crypto/ecies/node.d.ts +45 -0
  206. package/dist/crypto/ecies/node.js +139 -0
  207. package/dist/crypto/ecies/node.js.map +1 -0
  208. package/dist/crypto/ecies/test-vectors/eccrypto-vectors.json +72 -0
  209. package/dist/crypto/ecies/utils.cjs +52 -0
  210. package/dist/crypto/ecies/utils.cjs.map +1 -0
  211. package/dist/crypto/ecies/utils.d.ts +30 -0
  212. package/dist/crypto/ecies/utils.js +26 -0
  213. package/dist/crypto/ecies/utils.js.map +1 -0
  214. package/dist/crypto/services/WalletKeyEncryptionService.cjs +128 -0
  215. package/dist/crypto/services/WalletKeyEncryptionService.cjs.map +1 -0
  216. package/dist/crypto/services/WalletKeyEncryptionService.d.ts +88 -0
  217. package/dist/crypto/services/WalletKeyEncryptionService.js +108 -0
  218. package/dist/crypto/services/WalletKeyEncryptionService.js.map +1 -0
  219. package/dist/crypto/services/WalletKeyEncryptionService.test.d.ts +1 -0
  220. package/dist/diagnostics.cjs +37 -0
  221. package/dist/diagnostics.cjs.map +1 -0
  222. package/dist/diagnostics.d.ts +24 -0
  223. package/dist/diagnostics.js +13 -0
  224. package/dist/diagnostics.js.map +1 -0
  225. package/dist/diagnostics.test.d.ts +1 -0
  226. package/dist/errors.cjs +186 -0
  227. package/dist/errors.cjs.map +1 -0
  228. package/dist/errors.d.ts +452 -0
  229. package/dist/errors.js +148 -0
  230. package/dist/errors.js.map +1 -0
  231. package/dist/generated/abi/AccessSettlementImplementation.cjs +635 -0
  232. package/dist/generated/abi/AccessSettlementImplementation.cjs.map +1 -0
  233. package/dist/generated/abi/AccessSettlementImplementation.d.ts +468 -0
  234. package/dist/generated/abi/AccessSettlementImplementation.js +611 -0
  235. package/dist/generated/abi/AccessSettlementImplementation.js.map +1 -0
  236. package/dist/generated/abi/AttestationPolicyImplementation.cjs +614 -0
  237. package/dist/generated/abi/AttestationPolicyImplementation.cjs.map +1 -0
  238. package/dist/generated/abi/AttestationPolicyImplementation.d.ts +449 -0
  239. package/dist/generated/abi/AttestationPolicyImplementation.js +590 -0
  240. package/dist/generated/abi/AttestationPolicyImplementation.js.map +1 -0
  241. package/dist/generated/abi/ComputeEngineImplementation.cjs +1313 -0
  242. package/dist/generated/abi/ComputeEngineImplementation.cjs.map +1 -0
  243. package/dist/generated/abi/ComputeEngineImplementation.d.ts +995 -0
  244. package/dist/generated/abi/ComputeEngineImplementation.js +1289 -0
  245. package/dist/generated/abi/ComputeEngineImplementation.js.map +1 -0
  246. package/dist/generated/abi/ComputeEngineTreasuryImplementation.cjs +536 -0
  247. package/dist/generated/abi/ComputeEngineTreasuryImplementation.cjs.map +1 -0
  248. package/dist/generated/abi/ComputeEngineTreasuryImplementation.d.ts +393 -0
  249. package/dist/generated/abi/ComputeEngineTreasuryImplementation.js +512 -0
  250. package/dist/generated/abi/ComputeEngineTreasuryImplementation.js.map +1 -0
  251. package/dist/generated/abi/ComputeInstructionRegistryImplementation.cjs +734 -0
  252. package/dist/generated/abi/ComputeInstructionRegistryImplementation.cjs.map +1 -0
  253. package/dist/generated/abi/ComputeInstructionRegistryImplementation.d.ts +544 -0
  254. package/dist/generated/abi/ComputeInstructionRegistryImplementation.js +710 -0
  255. package/dist/generated/abi/ComputeInstructionRegistryImplementation.js.map +1 -0
  256. package/dist/generated/abi/DATFactoryImplementation.cjs +882 -0
  257. package/dist/generated/abi/DATFactoryImplementation.cjs.map +1 -0
  258. package/dist/generated/abi/DATFactoryImplementation.d.ts +660 -0
  259. package/dist/generated/abi/DATFactoryImplementation.js +858 -0
  260. package/dist/generated/abi/DATFactoryImplementation.js.map +1 -0
  261. package/dist/generated/abi/DATImplementation.cjs +934 -0
  262. package/dist/generated/abi/DATImplementation.cjs.map +1 -0
  263. package/dist/generated/abi/DATImplementation.d.ts +692 -0
  264. package/dist/generated/abi/DATImplementation.js +910 -0
  265. package/dist/generated/abi/DATImplementation.js.map +1 -0
  266. package/dist/generated/abi/DATPausableImplementation.cjs +1523 -0
  267. package/dist/generated/abi/DATPausableImplementation.cjs.map +1 -0
  268. package/dist/generated/abi/DATPausableImplementation.d.ts +1144 -0
  269. package/dist/generated/abi/DATPausableImplementation.js +1499 -0
  270. package/dist/generated/abi/DATPausableImplementation.js.map +1 -0
  271. package/dist/generated/abi/DATVotesImplementation.cjs +1460 -0
  272. package/dist/generated/abi/DATVotesImplementation.cjs.map +1 -0
  273. package/dist/generated/abi/DATVotesImplementation.d.ts +1094 -0
  274. package/dist/generated/abi/DATVotesImplementation.js +1436 -0
  275. package/dist/generated/abi/DATVotesImplementation.js.map +1 -0
  276. package/dist/generated/abi/DLPPerformanceImplementation.cjs +1202 -0
  277. package/dist/generated/abi/DLPPerformanceImplementation.cjs.map +1 -0
  278. package/dist/generated/abi/DLPPerformanceImplementation.d.ts +914 -0
  279. package/dist/generated/abi/DLPPerformanceImplementation.js +1178 -0
  280. package/dist/generated/abi/DLPPerformanceImplementation.js.map +1 -0
  281. package/dist/generated/abi/DLPRegistryImplementation.cjs +1469 -0
  282. package/dist/generated/abi/DLPRegistryImplementation.cjs.map +1 -0
  283. package/dist/generated/abi/DLPRegistryImplementation.d.ts +1122 -0
  284. package/dist/generated/abi/DLPRegistryImplementation.js +1445 -0
  285. package/dist/generated/abi/DLPRegistryImplementation.js.map +1 -0
  286. package/dist/generated/abi/DLPRegistryTreasuryImplementation.cjs +612 -0
  287. package/dist/generated/abi/DLPRegistryTreasuryImplementation.cjs.map +1 -0
  288. package/dist/generated/abi/DLPRegistryTreasuryImplementation.d.ts +451 -0
  289. package/dist/generated/abi/DLPRegistryTreasuryImplementation.js +588 -0
  290. package/dist/generated/abi/DLPRegistryTreasuryImplementation.js.map +1 -0
  291. package/dist/generated/abi/DLPRewardDeployerImplementation.cjs +1112 -0
  292. package/dist/generated/abi/DLPRewardDeployerImplementation.cjs.map +1 -0
  293. package/dist/generated/abi/DLPRewardDeployerImplementation.d.ts +840 -0
  294. package/dist/generated/abi/DLPRewardDeployerImplementation.js +1088 -0
  295. package/dist/generated/abi/DLPRewardDeployerImplementation.js.map +1 -0
  296. package/dist/generated/abi/DLPRewardDeployerTreasuryImplementation.cjs +612 -0
  297. package/dist/generated/abi/DLPRewardDeployerTreasuryImplementation.cjs.map +1 -0
  298. package/dist/generated/abi/DLPRewardDeployerTreasuryImplementation.d.ts +451 -0
  299. package/dist/generated/abi/DLPRewardDeployerTreasuryImplementation.js +588 -0
  300. package/dist/generated/abi/DLPRewardDeployerTreasuryImplementation.js.map +1 -0
  301. package/dist/generated/abi/DLPRewardSwapImplementation.cjs +939 -0
  302. package/dist/generated/abi/DLPRewardSwapImplementation.cjs.map +1 -0
  303. package/dist/generated/abi/DLPRewardSwapImplementation.d.ts +705 -0
  304. package/dist/generated/abi/DLPRewardSwapImplementation.js +915 -0
  305. package/dist/generated/abi/DLPRewardSwapImplementation.js.map +1 -0
  306. package/dist/generated/abi/DLPRootImplementation.cjs +1644 -0
  307. package/dist/generated/abi/DLPRootImplementation.cjs.map +1 -0
  308. package/dist/generated/abi/DLPRootImplementation.d.ts +1246 -0
  309. package/dist/generated/abi/DLPRootImplementation.js +1620 -0
  310. package/dist/generated/abi/DLPRootImplementation.js.map +1 -0
  311. package/dist/generated/abi/DataLiquidityPoolImplementation.cjs +1167 -0
  312. package/dist/generated/abi/DataLiquidityPoolImplementation.cjs.map +1 -0
  313. package/dist/generated/abi/DataLiquidityPoolImplementation.d.ts +874 -0
  314. package/dist/generated/abi/DataLiquidityPoolImplementation.js +1143 -0
  315. package/dist/generated/abi/DataLiquidityPoolImplementation.js.map +1 -0
  316. package/dist/generated/abi/DataPortabilityGranteesImplementation.cjs +1036 -0
  317. package/dist/generated/abi/DataPortabilityGranteesImplementation.cjs.map +1 -0
  318. package/dist/generated/abi/DataPortabilityGranteesImplementation.d.ts +773 -0
  319. package/dist/generated/abi/DataPortabilityGranteesImplementation.js +1012 -0
  320. package/dist/generated/abi/DataPortabilityGranteesImplementation.js.map +1 -0
  321. package/dist/generated/abi/DataPortabilityPermissionsImplementation.cjs +1298 -0
  322. package/dist/generated/abi/DataPortabilityPermissionsImplementation.cjs.map +1 -0
  323. package/dist/generated/abi/DataPortabilityPermissionsImplementation.d.ts +974 -0
  324. package/dist/generated/abi/DataPortabilityPermissionsImplementation.js +1274 -0
  325. package/dist/generated/abi/DataPortabilityPermissionsImplementation.js.map +1 -0
  326. package/dist/generated/abi/DataPortabilityServersImplementation.cjs +1419 -0
  327. package/dist/generated/abi/DataPortabilityServersImplementation.cjs.map +1 -0
  328. package/dist/generated/abi/DataPortabilityServersImplementation.d.ts +1071 -0
  329. package/dist/generated/abi/DataPortabilityServersImplementation.js +1395 -0
  330. package/dist/generated/abi/DataPortabilityServersImplementation.js.map +1 -0
  331. package/dist/generated/abi/DataRefinerRegistryImplementation.cjs +984 -0
  332. package/dist/generated/abi/DataRefinerRegistryImplementation.cjs.map +1 -0
  333. package/dist/generated/abi/DataRefinerRegistryImplementation.d.ts +736 -0
  334. package/dist/generated/abi/DataRefinerRegistryImplementation.js +960 -0
  335. package/dist/generated/abi/DataRefinerRegistryImplementation.js.map +1 -0
  336. package/dist/generated/abi/DataRegistryImplementation.cjs +1328 -0
  337. package/dist/generated/abi/DataRegistryImplementation.cjs.map +1 -0
  338. package/dist/generated/abi/DataRegistryImplementation.d.ts +1003 -0
  339. package/dist/generated/abi/DataRegistryImplementation.js +1304 -0
  340. package/dist/generated/abi/DataRegistryImplementation.js.map +1 -0
  341. package/dist/generated/abi/DatasetRegistryImplementation.cjs +751 -0
  342. package/dist/generated/abi/DatasetRegistryImplementation.cjs.map +1 -0
  343. package/dist/generated/abi/DatasetRegistryImplementation.d.ts +557 -0
  344. package/dist/generated/abi/DatasetRegistryImplementation.js +727 -0
  345. package/dist/generated/abi/DatasetRegistryImplementation.js.map +1 -0
  346. package/dist/generated/abi/ProtocolConfigImplementation.cjs +578 -0
  347. package/dist/generated/abi/ProtocolConfigImplementation.cjs.map +1 -0
  348. package/dist/generated/abi/ProtocolConfigImplementation.d.ts +423 -0
  349. package/dist/generated/abi/ProtocolConfigImplementation.js +554 -0
  350. package/dist/generated/abi/ProtocolConfigImplementation.js.map +1 -0
  351. package/dist/generated/abi/QueryEngineImplementation.cjs +1319 -0
  352. package/dist/generated/abi/QueryEngineImplementation.cjs.map +1 -0
  353. package/dist/generated/abi/QueryEngineImplementation.d.ts +1000 -0
  354. package/dist/generated/abi/QueryEngineImplementation.js +1295 -0
  355. package/dist/generated/abi/QueryEngineImplementation.js.map +1 -0
  356. package/dist/generated/abi/SwapHelperImplementation.cjs +976 -0
  357. package/dist/generated/abi/SwapHelperImplementation.cjs.map +1 -0
  358. package/dist/generated/abi/SwapHelperImplementation.d.ts +728 -0
  359. package/dist/generated/abi/SwapHelperImplementation.js +952 -0
  360. package/dist/generated/abi/SwapHelperImplementation.js.map +1 -0
  361. package/dist/generated/abi/TeePoolDedicatedGpuImplementation.cjs +936 -0
  362. package/dist/generated/abi/TeePoolDedicatedGpuImplementation.cjs.map +1 -0
  363. package/dist/generated/abi/TeePoolDedicatedGpuImplementation.d.ts +700 -0
  364. package/dist/generated/abi/TeePoolDedicatedGpuImplementation.js +912 -0
  365. package/dist/generated/abi/TeePoolDedicatedGpuImplementation.js.map +1 -0
  366. package/dist/generated/abi/TeePoolDedicatedStandardImplementation.cjs +936 -0
  367. package/dist/generated/abi/TeePoolDedicatedStandardImplementation.cjs.map +1 -0
  368. package/dist/generated/abi/TeePoolDedicatedStandardImplementation.d.ts +700 -0
  369. package/dist/generated/abi/TeePoolDedicatedStandardImplementation.js +912 -0
  370. package/dist/generated/abi/TeePoolDedicatedStandardImplementation.js.map +1 -0
  371. package/dist/generated/abi/TeePoolEphemeralStandardImplementation.cjs +936 -0
  372. package/dist/generated/abi/TeePoolEphemeralStandardImplementation.cjs.map +1 -0
  373. package/dist/generated/abi/TeePoolEphemeralStandardImplementation.d.ts +700 -0
  374. package/dist/generated/abi/TeePoolEphemeralStandardImplementation.js +912 -0
  375. package/dist/generated/abi/TeePoolEphemeralStandardImplementation.js.map +1 -0
  376. package/dist/generated/abi/TeePoolImplementation.cjs +1313 -0
  377. package/dist/generated/abi/TeePoolImplementation.cjs.map +1 -0
  378. package/dist/generated/abi/TeePoolImplementation.d.ts +992 -0
  379. package/dist/generated/abi/TeePoolImplementation.js +1289 -0
  380. package/dist/generated/abi/TeePoolImplementation.js.map +1 -0
  381. package/dist/generated/abi/TeePoolPersistentGpuImplementation.cjs +936 -0
  382. package/dist/generated/abi/TeePoolPersistentGpuImplementation.cjs.map +1 -0
  383. package/dist/generated/abi/TeePoolPersistentGpuImplementation.d.ts +700 -0
  384. package/dist/generated/abi/TeePoolPersistentGpuImplementation.js +912 -0
  385. package/dist/generated/abi/TeePoolPersistentGpuImplementation.js.map +1 -0
  386. package/dist/generated/abi/TeePoolPersistentStandardImplementation.cjs +936 -0
  387. package/dist/generated/abi/TeePoolPersistentStandardImplementation.cjs.map +1 -0
  388. package/dist/generated/abi/TeePoolPersistentStandardImplementation.d.ts +700 -0
  389. package/dist/generated/abi/TeePoolPersistentStandardImplementation.js +912 -0
  390. package/dist/generated/abi/TeePoolPersistentStandardImplementation.js.map +1 -0
  391. package/dist/generated/abi/TeePoolPhalaImplementation.cjs +1313 -0
  392. package/dist/generated/abi/TeePoolPhalaImplementation.cjs.map +1 -0
  393. package/dist/generated/abi/TeePoolPhalaImplementation.d.ts +992 -0
  394. package/dist/generated/abi/TeePoolPhalaImplementation.js +1289 -0
  395. package/dist/generated/abi/TeePoolPhalaImplementation.js.map +1 -0
  396. package/dist/generated/abi/UniswapV3NonfungiblePositionManagerImplementation.cjs +1251 -0
  397. package/dist/generated/abi/UniswapV3NonfungiblePositionManagerImplementation.cjs.map +1 -0
  398. package/dist/generated/abi/UniswapV3NonfungiblePositionManagerImplementation.d.ts +948 -0
  399. package/dist/generated/abi/UniswapV3NonfungiblePositionManagerImplementation.js +1227 -0
  400. package/dist/generated/abi/UniswapV3NonfungiblePositionManagerImplementation.js.map +1 -0
  401. package/dist/generated/abi/UniswapV3QuoterV2Implementation.cjs +297 -0
  402. package/dist/generated/abi/UniswapV3QuoterV2Implementation.cjs.map +1 -0
  403. package/dist/generated/abi/UniswapV3QuoterV2Implementation.d.ts +206 -0
  404. package/dist/generated/abi/UniswapV3QuoterV2Implementation.js +273 -0
  405. package/dist/generated/abi/UniswapV3QuoterV2Implementation.js.map +1 -0
  406. package/dist/generated/abi/VanaEpochImplementation.cjs +1383 -0
  407. package/dist/generated/abi/VanaEpochImplementation.cjs.map +1 -0
  408. package/dist/generated/abi/VanaEpochImplementation.d.ts +1050 -0
  409. package/dist/generated/abi/VanaEpochImplementation.js +1359 -0
  410. package/dist/generated/abi/VanaEpochImplementation.js.map +1 -0
  411. package/dist/generated/abi/VanaPoolEntityImplementation.cjs +1191 -0
  412. package/dist/generated/abi/VanaPoolEntityImplementation.cjs.map +1 -0
  413. package/dist/generated/abi/VanaPoolEntityImplementation.d.ts +899 -0
  414. package/dist/generated/abi/VanaPoolEntityImplementation.js +1167 -0
  415. package/dist/generated/abi/VanaPoolEntityImplementation.js.map +1 -0
  416. package/dist/generated/abi/VanaPoolStakingImplementation.cjs +1033 -0
  417. package/dist/generated/abi/VanaPoolStakingImplementation.cjs.map +1 -0
  418. package/dist/generated/abi/VanaPoolStakingImplementation.d.ts +776 -0
  419. package/dist/generated/abi/VanaPoolStakingImplementation.js +1009 -0
  420. package/dist/generated/abi/VanaPoolStakingImplementation.js.map +1 -0
  421. package/dist/generated/abi/VanaPoolTreasuryImplementation.cjs +538 -0
  422. package/dist/generated/abi/VanaPoolTreasuryImplementation.cjs.map +1 -0
  423. package/dist/generated/abi/VanaPoolTreasuryImplementation.d.ts +393 -0
  424. package/dist/generated/abi/VanaPoolTreasuryImplementation.js +514 -0
  425. package/dist/generated/abi/VanaPoolTreasuryImplementation.js.map +1 -0
  426. package/dist/generated/abi/VanaRuntimePermissionsImplementation.cjs +759 -0
  427. package/dist/generated/abi/VanaRuntimePermissionsImplementation.cjs.map +1 -0
  428. package/dist/generated/abi/VanaRuntimePermissionsImplementation.d.ts +563 -0
  429. package/dist/generated/abi/VanaRuntimePermissionsImplementation.js +735 -0
  430. package/dist/generated/abi/VanaRuntimePermissionsImplementation.js.map +1 -0
  431. package/dist/generated/abi/VanaRuntimeServersImplementation.cjs +820 -0
  432. package/dist/generated/abi/VanaRuntimeServersImplementation.cjs.map +1 -0
  433. package/dist/generated/abi/VanaRuntimeServersImplementation.d.ts +609 -0
  434. package/dist/generated/abi/VanaRuntimeServersImplementation.js +796 -0
  435. package/dist/generated/abi/VanaRuntimeServersImplementation.js.map +1 -0
  436. package/dist/generated/abi/VanaTreasuryImplementation.cjs +536 -0
  437. package/dist/generated/abi/VanaTreasuryImplementation.cjs.map +1 -0
  438. package/dist/generated/abi/VanaTreasuryImplementation.d.ts +393 -0
  439. package/dist/generated/abi/VanaTreasuryImplementation.js +512 -0
  440. package/dist/generated/abi/VanaTreasuryImplementation.js.map +1 -0
  441. package/dist/generated/abi/WVANAImplementation.cjs +339 -0
  442. package/dist/generated/abi/WVANAImplementation.cjs.map +1 -0
  443. package/dist/generated/abi/WVANAImplementation.d.ts +244 -0
  444. package/dist/generated/abi/WVANAImplementation.js +315 -0
  445. package/dist/generated/abi/WVANAImplementation.js.map +1 -0
  446. package/dist/generated/abi/index.cjs +209 -0
  447. package/dist/generated/abi/index.cjs.map +1 -0
  448. package/dist/{index.node.d.cts → generated/abi/index.d.ts} +16715 -21763
  449. package/dist/generated/abi/index.js +142 -0
  450. package/dist/generated/abi/index.js.map +1 -0
  451. package/dist/generated/addresses.cjs +424 -0
  452. package/dist/generated/addresses.cjs.map +1 -0
  453. package/dist/generated/addresses.d.ts +373 -0
  454. package/dist/generated/addresses.js +394 -0
  455. package/dist/generated/addresses.js.map +1 -0
  456. package/dist/generated/event-types.cjs +17 -0
  457. package/dist/generated/event-types.cjs.map +1 -0
  458. package/dist/generated/event-types.d.ts +937 -0
  459. package/dist/generated/event-types.js +1 -0
  460. package/dist/generated/event-types.js.map +1 -0
  461. package/dist/generated/eventRegistry.cjs +5228 -0
  462. package/dist/generated/eventRegistry.cjs.map +1 -0
  463. package/dist/generated/eventRegistry.d.ts +14 -0
  464. package/dist/generated/eventRegistry.js +5203 -0
  465. package/dist/generated/eventRegistry.js.map +1 -0
  466. package/dist/generated/server/server-exports.cjs +45 -0
  467. package/dist/generated/server/server-exports.cjs.map +1 -0
  468. package/dist/generated/server/server-exports.d.ts +39 -0
  469. package/dist/generated/server/server-exports.js +19 -0
  470. package/dist/generated/server/server-exports.js.map +1 -0
  471. package/dist/generated/server/server.cjs +17 -0
  472. package/dist/generated/server/server.cjs.map +1 -0
  473. package/dist/generated/server/server.d.ts +907 -0
  474. package/dist/generated/server/server.js +1 -0
  475. package/dist/generated/server/server.js.map +1 -0
  476. package/dist/generated/subgraph.cjs +1440 -0
  477. package/dist/generated/subgraph.cjs.map +1 -0
  478. package/dist/generated/subgraph.d.ts +6113 -0
  479. package/dist/generated/subgraph.js +1404 -0
  480. package/dist/generated/subgraph.js.map +1 -0
  481. package/dist/index.browser.d.ts +50 -36684
  482. package/dist/index.browser.js +91 -45518
  483. package/dist/index.browser.js.map +1 -1
  484. package/dist/index.cjs +5 -0
  485. package/dist/index.cjs.map +1 -0
  486. package/dist/index.d.ts +0 -0
  487. package/dist/index.js +4 -0
  488. package/dist/index.js.map +1 -0
  489. package/dist/index.node.cjs +131 -46017
  490. package/dist/index.node.cjs.map +1 -1
  491. package/dist/index.node.d.ts +94 -36795
  492. package/dist/index.node.js +108 -45905
  493. package/dist/index.node.js.map +1 -1
  494. package/dist/lib/__tests__/redisAtomicStore.test.d.ts +1 -0
  495. package/dist/lib/redisAtomicStore.cjs +201 -0
  496. package/dist/lib/redisAtomicStore.cjs.map +1 -0
  497. package/dist/lib/redisAtomicStore.d.ts +120 -0
  498. package/dist/lib/redisAtomicStore.js +177 -0
  499. package/dist/lib/redisAtomicStore.js.map +1 -0
  500. package/dist/node.cjs +2 -323
  501. package/dist/node.cjs.map +1 -1
  502. package/dist/node.d.ts +42 -1
  503. package/dist/node.js +1 -309
  504. package/dist/node.js.map +1 -1
  505. package/dist/platform/browser-only.cjs +37 -0
  506. package/dist/platform/browser-only.cjs.map +1 -0
  507. package/dist/platform/browser-only.d.ts +22 -0
  508. package/dist/platform/browser-only.js +12 -0
  509. package/dist/platform/browser-only.js.map +1 -0
  510. package/dist/platform/browser-only.test.d.ts +1 -0
  511. package/dist/platform/browser-safe.cjs +57 -0
  512. package/dist/platform/browser-safe.cjs.map +1 -0
  513. package/dist/platform/browser-safe.d.ts +29 -0
  514. package/dist/platform/browser-safe.js +31 -0
  515. package/dist/platform/browser-safe.js.map +1 -0
  516. package/dist/platform/browser-safe.test.d.ts +1 -0
  517. package/dist/platform/browser.cjs +488 -0
  518. package/dist/platform/browser.cjs.map +1 -0
  519. package/dist/platform/browser.d.ts +291 -0
  520. package/dist/platform/browser.js +454 -0
  521. package/dist/platform/browser.js.map +1 -0
  522. package/dist/platform/browser.test.d.ts +1 -0
  523. package/dist/platform/index.cjs +50 -0
  524. package/dist/platform/index.cjs.map +1 -0
  525. package/dist/platform/index.d.ts +11 -0
  526. package/dist/platform/index.js +27 -0
  527. package/dist/platform/index.js.map +1 -0
  528. package/dist/platform/interface.cjs +17 -0
  529. package/dist/platform/interface.cjs.map +1 -0
  530. package/dist/platform/interface.d.ts +409 -0
  531. package/dist/platform/interface.js +1 -0
  532. package/dist/platform/interface.js.map +1 -0
  533. package/dist/platform/node.cjs +512 -0
  534. package/dist/platform/node.cjs.map +1 -0
  535. package/dist/platform/node.d.ts +86 -0
  536. package/dist/platform/node.js +481 -0
  537. package/dist/platform/node.js.map +1 -0
  538. package/dist/platform/ports/openpgp-port.cjs +74 -0
  539. package/dist/platform/ports/openpgp-port.cjs.map +1 -0
  540. package/dist/platform/ports/openpgp-port.d.ts +13 -0
  541. package/dist/platform/ports/openpgp-port.js +59 -0
  542. package/dist/platform/ports/openpgp-port.js.map +1 -0
  543. package/dist/platform/ports/pgp-port.cjs +17 -0
  544. package/dist/platform/ports/pgp-port.cjs.map +1 -0
  545. package/dist/platform/ports/pgp-port.d.ts +35 -0
  546. package/dist/platform/ports/pgp-port.js +1 -0
  547. package/dist/platform/ports/pgp-port.js.map +1 -0
  548. package/dist/platform/shared/error-utils.cjs +43 -0
  549. package/dist/platform/shared/error-utils.cjs.map +1 -0
  550. package/dist/platform/shared/error-utils.d.ts +23 -0
  551. package/dist/platform/shared/error-utils.js +18 -0
  552. package/dist/platform/shared/error-utils.js.map +1 -0
  553. package/dist/platform/shared/pgp-utils.cjs +55 -0
  554. package/dist/platform/shared/pgp-utils.cjs.map +1 -0
  555. package/dist/platform/shared/pgp-utils.d.ts +59 -0
  556. package/dist/platform/shared/pgp-utils.js +29 -0
  557. package/dist/platform/shared/pgp-utils.js.map +1 -0
  558. package/dist/platform/shared/stream-utils.cjs +49 -0
  559. package/dist/platform/shared/stream-utils.cjs.map +1 -0
  560. package/dist/platform/shared/stream-utils.d.ts +14 -0
  561. package/dist/platform/shared/stream-utils.js +25 -0
  562. package/dist/platform/shared/stream-utils.js.map +1 -0
  563. package/dist/platform/utils.cjs +114 -0
  564. package/dist/platform/utils.cjs.map +1 -0
  565. package/dist/platform/utils.d.ts +49 -0
  566. package/dist/platform/utils.js +76 -0
  567. package/dist/platform/utils.js.map +1 -0
  568. package/dist/platform/utils.test.d.ts +1 -0
  569. package/dist/platform.browser.d.ts +6 -57
  570. package/dist/platform.browser.js +10 -356
  571. package/dist/platform.browser.js.map +1 -1
  572. package/dist/platform.cjs +14 -698
  573. package/dist/platform.cjs.map +1 -1
  574. package/dist/platform.d.ts +11 -2
  575. package/dist/platform.js +14 -684
  576. package/dist/platform.js.map +1 -1
  577. package/dist/platform.node.cjs +14 -698
  578. package/dist/platform.node.cjs.map +1 -1
  579. package/dist/platform.node.d.ts +7 -98
  580. package/dist/platform.node.js +14 -684
  581. package/dist/platform.node.js.map +1 -1
  582. package/dist/schemas/dataSchema.schema.json +53 -0
  583. package/dist/schemas/grantFile.schema.json +43 -0
  584. package/dist/server/relayerHandler.cjs +452 -0
  585. package/dist/server/relayerHandler.cjs.map +1 -0
  586. package/dist/server/relayerHandler.d.ts +69 -0
  587. package/dist/server/relayerHandler.js +428 -0
  588. package/dist/server/relayerHandler.js.map +1 -0
  589. package/dist/storage/index.cjs +47 -0
  590. package/dist/storage/index.cjs.map +1 -0
  591. package/dist/storage/index.d.ts +57 -0
  592. package/dist/storage/index.js +17 -0
  593. package/dist/storage/index.js.map +1 -0
  594. package/dist/storage/manager.cjs +272 -0
  595. package/dist/storage/manager.cjs.map +1 -0
  596. package/dist/storage/manager.d.ts +241 -0
  597. package/dist/storage/manager.js +248 -0
  598. package/dist/storage/manager.js.map +1 -0
  599. package/dist/storage/providers/callback-storage.cjs +248 -0
  600. package/dist/storage/providers/callback-storage.cjs.map +1 -0
  601. package/dist/storage/providers/callback-storage.d.ts +183 -0
  602. package/dist/storage/providers/callback-storage.js +226 -0
  603. package/dist/storage/providers/callback-storage.js.map +1 -0
  604. package/dist/storage/providers/dropbox.cjs +237 -0
  605. package/dist/storage/providers/dropbox.cjs.map +1 -0
  606. package/dist/storage/providers/dropbox.d.ts +39 -0
  607. package/dist/storage/providers/dropbox.js +215 -0
  608. package/dist/storage/providers/dropbox.js.map +1 -0
  609. package/dist/storage/providers/dropbox.test.d.ts +1 -0
  610. package/dist/storage/providers/google-drive.cjs +516 -0
  611. package/dist/storage/providers/google-drive.cjs.map +1 -0
  612. package/dist/storage/providers/google-drive.d.ts +152 -0
  613. package/dist/storage/providers/google-drive.js +494 -0
  614. package/dist/storage/providers/google-drive.js.map +1 -0
  615. package/dist/storage/providers/google-drive.test.d.ts +1 -0
  616. package/dist/storage/providers/ipfs.cjs +283 -0
  617. package/dist/storage/providers/ipfs.cjs.map +1 -0
  618. package/dist/storage/providers/ipfs.d.ts +160 -0
  619. package/dist/storage/providers/ipfs.js +261 -0
  620. package/dist/storage/providers/ipfs.js.map +1 -0
  621. package/dist/storage/providers/pinata.cjs +339 -0
  622. package/dist/storage/providers/pinata.cjs.map +1 -0
  623. package/dist/storage/providers/pinata.d.ts +168 -0
  624. package/dist/storage/providers/pinata.js +317 -0
  625. package/dist/storage/providers/pinata.js.map +1 -0
  626. package/dist/storage/tests/callbackStorage.test.d.ts +1 -0
  627. package/dist/storage/tests/googleDriveStorage.test.d.ts +1 -0
  628. package/dist/storage/tests/ipfsStorage.test.d.ts +1 -0
  629. package/dist/storage/tests/pinataStorage.test.d.ts +1 -0
  630. package/dist/storage/tests/storageManager.test.d.ts +1 -0
  631. package/dist/tests/abi.test.d.ts +1 -0
  632. package/dist/tests/chains-definitions.test.d.ts +1 -0
  633. package/dist/tests/core-encryption.test.d.ts +1 -0
  634. package/dist/tests/core-extended.test.d.ts +1 -0
  635. package/dist/tests/core-generics-coverage.test.d.ts +1 -0
  636. package/dist/tests/coverage-boost.test.d.ts +1 -0
  637. package/dist/tests/crypto-cross-platform-compatibility.test.d.ts +1 -0
  638. package/dist/tests/data-addfile-permissions-schema.test.d.ts +1 -0
  639. package/dist/tests/data-additional-methods.test.d.ts +1 -0
  640. package/dist/tests/data-controller-edge-cases.test.d.ts +1 -0
  641. package/dist/tests/data-ipfs-gateways.test.d.ts +1 -0
  642. package/dist/tests/data-relayer.test.d.ts +1 -0
  643. package/dist/tests/data-schema-validation.test.d.ts +1 -0
  644. package/dist/tests/data-simple-methods.test.d.ts +1 -0
  645. package/dist/tests/data-upload-owner-validation.test.d.ts +1 -0
  646. package/dist/tests/data.test.d.ts +1 -0
  647. package/dist/tests/demo-integration.test.d.ts +1 -0
  648. package/dist/tests/demo-trusted-server-integration.test.d.ts +1 -0
  649. package/dist/tests/download-relayer.test.d.ts +1 -0
  650. package/dist/tests/dual-mode-permissions.test.d.ts +1 -0
  651. package/dist/tests/dual-mode-trusted-servers.test.d.ts +1 -0
  652. package/dist/tests/encryption-correct-implementation.test.d.ts +1 -0
  653. package/dist/tests/encryption-coverage.test.d.ts +1 -0
  654. package/dist/tests/encryption-edge-cases.test.d.ts +1 -0
  655. package/dist/tests/encryption-utils-updated.test.d.ts +1 -0
  656. package/dist/tests/errors-coverage.test.d.ts +1 -0
  657. package/dist/tests/errors.test.d.ts +1 -0
  658. package/dist/tests/factories/mockFactory.d.ts +316 -0
  659. package/dist/tests/fakes/FakeStorageManager.d.ts +200 -0
  660. package/dist/tests/fakes/FakeStorageManager.test.d.ts +1 -0
  661. package/dist/tests/fakes/FakeWaitForTransactionEvents.d.ts +170 -0
  662. package/dist/tests/fakes/FakeWaitForTransactionEvents.test.d.ts +1 -0
  663. package/dist/tests/fakes/fake-pgp-port.d.ts +13 -0
  664. package/dist/tests/grantValidation-edge-cases.test.d.ts +1 -0
  665. package/dist/tests/grantValidation-unreachable-branch.test.d.ts +1 -0
  666. package/dist/tests/helper-methods.test.d.ts +1 -0
  667. package/dist/tests/helpers/platformTestHelpers.d.ts +106 -0
  668. package/dist/tests/helpers/typedMocks.d.ts +64 -0
  669. package/dist/tests/index-browser.test.d.ts +1 -0
  670. package/dist/tests/index-node.test.d.ts +1 -0
  671. package/dist/tests/index.test.d.ts +1 -0
  672. package/dist/tests/mocks/platformAdapter.d.ts +12 -0
  673. package/dist/tests/new-permissions-methods.test.d.ts +1 -0
  674. package/dist/tests/no-buffer-browser.test.d.ts +1 -0
  675. package/dist/tests/permissions-grantee.test.d.ts +1 -0
  676. package/dist/tests/permissions-revoke-relayer.test.d.ts +1 -0
  677. package/dist/tests/permissions-schema-validation.test.d.ts +1 -0
  678. package/dist/tests/permissions-server-files.test.d.ts +1 -0
  679. package/dist/tests/permissions-transaction-options.test.d.ts +1 -0
  680. package/dist/tests/permissions-trust-servers.test.d.ts +1 -0
  681. package/dist/tests/permissions.test.d.ts +1 -0
  682. package/dist/tests/personal.test.d.ts +1 -0
  683. package/dist/tests/platform-browser.test.d.ts +1 -0
  684. package/dist/tests/platform-crypto-expanded.test.d.ts +1 -0
  685. package/dist/tests/platform-crypto.test.d.ts +1 -0
  686. package/dist/tests/platform-index.test.d.ts +1 -0
  687. package/dist/tests/platform-node.test.d.ts +1 -0
  688. package/dist/tests/platform-shared-utils.test.d.ts +1 -0
  689. package/dist/tests/platform-updated.test.d.ts +1 -0
  690. package/dist/tests/protocol-additional-methods.test.d.ts +1 -0
  691. package/dist/tests/protocol.test.d.ts +1 -0
  692. package/dist/tests/read-only-mode.test.d.ts +1 -0
  693. package/dist/tests/relayer-integration.test.d.ts +1 -0
  694. package/dist/tests/relayer-unified.test.d.ts +1 -0
  695. package/dist/tests/schemas.test.d.ts +1 -0
  696. package/dist/tests/server-relayer-handler.test.d.ts +1 -0
  697. package/dist/tests/setup.d.ts +7 -0
  698. package/dist/tests/signatureFormatter.test.d.ts +1 -0
  699. package/dist/tests/trusted-server-queries.test.d.ts +1 -0
  700. package/dist/tests/typedDataConverter.test.d.ts +1 -0
  701. package/dist/tests/types-contracts.test.d.ts +1 -0
  702. package/dist/tests/types-data.test.d.ts +1 -0
  703. package/dist/tests/types-external-apis.test.d.ts +1 -0
  704. package/dist/tests/types-generics.test.d.ts +1 -0
  705. package/dist/tests/types-permissions.test.d.ts +1 -0
  706. package/dist/tests/types-upload-params.test.d.ts +1 -0
  707. package/dist/tests/types.test.d.ts +1 -0
  708. package/dist/tests/utils-formatters.test.d.ts +1 -0
  709. package/dist/tests/utils-grantFiles-edge-cases.test.d.ts +1 -0
  710. package/dist/tests/utils-grantFiles-validation.test.d.ts +1 -0
  711. package/dist/tests/utils-grantFiles.test.d.ts +1 -0
  712. package/dist/tests/utils-grantValidation-consolidated.test.d.ts +1 -0
  713. package/dist/tests/utils-grants.test.d.ts +1 -0
  714. package/dist/tests/utils-ipfs-additional.test.d.ts +1 -0
  715. package/dist/tests/utils-ipfs.test.d.ts +4 -0
  716. package/dist/tests/utils-schemaValidation.test.d.ts +1 -0
  717. package/dist/tests/vana.test.d.ts +1 -0
  718. package/dist/tests/wallet-crypto-compatibility.test.d.ts +1 -0
  719. package/dist/types/accessSettlement.cjs +17 -0
  720. package/dist/types/accessSettlement.cjs.map +1 -0
  721. package/dist/types/accessSettlement.d.ts +66 -0
  722. package/dist/types/accessSettlement.js +1 -0
  723. package/dist/types/accessSettlement.js.map +1 -0
  724. package/dist/types/atomicStore.cjs +31 -0
  725. package/dist/types/atomicStore.cjs.map +1 -0
  726. package/dist/types/atomicStore.d.ts +236 -0
  727. package/dist/types/atomicStore.js +7 -0
  728. package/dist/types/atomicStore.js.map +1 -0
  729. package/dist/types/blockchain.cjs +17 -0
  730. package/dist/types/blockchain.cjs.map +1 -0
  731. package/dist/types/blockchain.d.ts +85 -0
  732. package/dist/types/blockchain.js +1 -0
  733. package/dist/types/blockchain.js.map +1 -0
  734. package/dist/types/chains-additional.test.d.ts +1 -0
  735. package/dist/types/chains.cjs +36 -0
  736. package/dist/types/chains.cjs.map +1 -0
  737. package/dist/types/chains.d.ts +98 -0
  738. package/dist/types/chains.js +11 -0
  739. package/dist/types/chains.js.map +1 -0
  740. package/dist/types/config.cjs +51 -0
  741. package/dist/types/config.cjs.map +1 -0
  742. package/dist/types/config.d.ts +720 -0
  743. package/dist/types/config.js +23 -0
  744. package/dist/types/config.js.map +1 -0
  745. package/dist/types/contracts.cjs +17 -0
  746. package/dist/types/contracts.cjs.map +1 -0
  747. package/dist/types/contracts.d.ts +129 -0
  748. package/dist/types/contracts.js +1 -0
  749. package/dist/types/contracts.js.map +1 -0
  750. package/dist/types/controller-context.cjs +17 -0
  751. package/dist/types/controller-context.cjs.map +1 -0
  752. package/dist/types/controller-context.d.ts +68 -0
  753. package/dist/types/controller-context.js +1 -0
  754. package/dist/types/controller-context.js.map +1 -0
  755. package/dist/types/data.cjs +17 -0
  756. package/dist/types/data.cjs.map +1 -0
  757. package/dist/types/data.d.ts +763 -0
  758. package/dist/types/data.js +1 -0
  759. package/dist/types/data.js.map +1 -0
  760. package/dist/types/eccrypto-js.d.cjs +2 -0
  761. package/dist/types/eccrypto-js.d.cjs.map +1 -0
  762. package/dist/types/eccrypto-js.d.js +1 -0
  763. package/dist/types/eccrypto-js.d.js.map +1 -0
  764. package/dist/types/external-apis.cjs +61 -0
  765. package/dist/types/external-apis.cjs.map +1 -0
  766. package/dist/types/external-apis.d.ts +184 -0
  767. package/dist/types/external-apis.js +34 -0
  768. package/dist/types/external-apis.js.map +1 -0
  769. package/dist/types/generics.cjs +17 -0
  770. package/dist/types/generics.cjs.map +1 -0
  771. package/dist/types/generics.d.ts +518 -0
  772. package/dist/types/generics.js +1 -0
  773. package/dist/types/generics.js.map +1 -0
  774. package/dist/types/index.cjs +65 -0
  775. package/dist/types/index.cjs.map +1 -0
  776. package/dist/types/index.d.ts +50 -0
  777. package/dist/types/index.js +42 -0
  778. package/dist/types/index.js.map +1 -0
  779. package/dist/types/operationStore.cjs +17 -0
  780. package/dist/types/operationStore.cjs.map +1 -0
  781. package/dist/types/operationStore.d.ts +171 -0
  782. package/dist/types/operationStore.js +1 -0
  783. package/dist/types/operationStore.js.map +1 -0
  784. package/dist/types/operations.cjs +53 -0
  785. package/dist/types/operations.cjs.map +1 -0
  786. package/dist/types/operations.d.ts +204 -0
  787. package/dist/types/operations.js +26 -0
  788. package/dist/types/operations.js.map +1 -0
  789. package/dist/types/options.cjs +17 -0
  790. package/dist/types/options.cjs.map +1 -0
  791. package/dist/types/options.d.ts +308 -0
  792. package/dist/types/options.js +1 -0
  793. package/dist/types/options.js.map +1 -0
  794. package/dist/types/permissions.cjs +17 -0
  795. package/dist/types/permissions.cjs.map +1 -0
  796. package/dist/types/permissions.d.ts +953 -0
  797. package/dist/types/permissions.js +1 -0
  798. package/dist/types/permissions.js.map +1 -0
  799. package/dist/types/personal.cjs +17 -0
  800. package/dist/types/personal.cjs.map +1 -0
  801. package/dist/types/personal.d.ts +174 -0
  802. package/dist/types/personal.js +1 -0
  803. package/dist/types/personal.js.map +1 -0
  804. package/dist/types/relayer.cjs +17 -0
  805. package/dist/types/relayer.cjs.map +1 -0
  806. package/dist/types/relayer.d.ts +553 -0
  807. package/dist/types/relayer.js +1 -0
  808. package/dist/types/relayer.js.map +1 -0
  809. package/dist/types/runtimePermissions.cjs +17 -0
  810. package/dist/types/runtimePermissions.cjs.map +1 -0
  811. package/dist/types/runtimePermissions.d.ts +122 -0
  812. package/dist/types/runtimePermissions.js +1 -0
  813. package/dist/types/runtimePermissions.js.map +1 -0
  814. package/dist/types/storage.cjs +39 -0
  815. package/dist/types/storage.cjs.map +1 -0
  816. package/dist/types/storage.d.ts +117 -0
  817. package/dist/types/storage.js +15 -0
  818. package/dist/types/storage.js.map +1 -0
  819. package/dist/types/transactionResults.cjs +17 -0
  820. package/dist/types/transactionResults.cjs.map +1 -0
  821. package/dist/types/transactionResults.d.ts +193 -0
  822. package/dist/types/transactionResults.js +1 -0
  823. package/dist/types/transactionResults.js.map +1 -0
  824. package/dist/types/utils.cjs +17 -0
  825. package/dist/types/utils.cjs.map +1 -0
  826. package/dist/types/utils.d.ts +771 -0
  827. package/dist/types/utils.js +1 -0
  828. package/dist/types/utils.js.map +1 -0
  829. package/dist/types.cjs +23 -0
  830. package/dist/types.cjs.map +1 -0
  831. package/dist/types.d.ts +30 -0
  832. package/dist/types.js +2 -0
  833. package/dist/types.js.map +1 -0
  834. package/dist/utils/__tests__/chainQuery.test.d.ts +1 -0
  835. package/dist/utils/__tests__/parseTransaction.test.d.ts +1 -0
  836. package/dist/utils/__tests__/pojo-serialization.test.d.ts +1 -0
  837. package/dist/utils/__tests__/signatureCache.test.d.ts +1 -0
  838. package/dist/utils/__tests__/subgraphConsistency.test.d.ts +4 -0
  839. package/dist/utils/__tests__/subgraphPagination.test.d.ts +4 -0
  840. package/dist/utils/__tests__/transaction-edge-cases.test.d.ts +1 -0
  841. package/dist/utils/__tests__/transactionHelpers.test.d.ts +1 -0
  842. package/dist/utils/__tests__/urlResolver.test.d.ts +4 -0
  843. package/dist/utils/blockchain/registry.cjs +81 -0
  844. package/dist/utils/blockchain/registry.cjs.map +1 -0
  845. package/dist/utils/blockchain/registry.d.ts +32 -0
  846. package/dist/utils/blockchain/registry.js +56 -0
  847. package/dist/utils/blockchain/registry.js.map +1 -0
  848. package/dist/utils/blockchain/registry.test.d.ts +1 -0
  849. package/dist/utils/chainQuery.cjs +107 -0
  850. package/dist/utils/chainQuery.cjs.map +1 -0
  851. package/dist/utils/chainQuery.d.ts +31 -0
  852. package/dist/utils/chainQuery.js +82 -0
  853. package/dist/utils/chainQuery.js.map +1 -0
  854. package/dist/utils/crypto-utils.cjs +108 -0
  855. package/dist/utils/crypto-utils.cjs.map +1 -0
  856. package/dist/utils/crypto-utils.d.ts +100 -0
  857. package/dist/utils/crypto-utils.js +76 -0
  858. package/dist/utils/crypto-utils.js.map +1 -0
  859. package/dist/utils/crypto-utils.test.d.ts +1 -0
  860. package/dist/utils/download.cjs +69 -0
  861. package/dist/utils/download.cjs.map +1 -0
  862. package/dist/utils/download.d.ts +40 -0
  863. package/dist/utils/download.js +45 -0
  864. package/dist/utils/download.js.map +1 -0
  865. package/dist/utils/encoding.cjs +66 -0
  866. package/dist/utils/encoding.cjs.map +1 -0
  867. package/dist/utils/encoding.d.ts +52 -0
  868. package/dist/utils/encoding.js +39 -0
  869. package/dist/utils/encoding.js.map +1 -0
  870. package/dist/utils/encoding.test.d.ts +1 -0
  871. package/dist/utils/encryption.cjs +176 -0
  872. package/dist/utils/encryption.cjs.map +1 -0
  873. package/dist/utils/encryption.d.ts +271 -0
  874. package/dist/utils/encryption.js +142 -0
  875. package/dist/utils/encryption.js.map +1 -0
  876. package/dist/utils/formatters.cjs +55 -0
  877. package/dist/utils/formatters.cjs.map +1 -0
  878. package/dist/utils/formatters.d.ts +118 -0
  879. package/dist/utils/formatters.js +28 -0
  880. package/dist/utils/formatters.js.map +1 -0
  881. package/dist/utils/grantFiles.cjs +181 -0
  882. package/dist/utils/grantFiles.cjs.map +1 -0
  883. package/dist/utils/grantFiles.d.ts +172 -0
  884. package/dist/utils/grantFiles.js +143 -0
  885. package/dist/utils/grantFiles.js.map +1 -0
  886. package/dist/utils/grantValidation.cjs +243 -0
  887. package/dist/utils/grantValidation.cjs.map +1 -0
  888. package/dist/utils/grantValidation.d.ts +226 -0
  889. package/dist/utils/grantValidation.js +201 -0
  890. package/dist/utils/grantValidation.js.map +1 -0
  891. package/dist/utils/grants.cjs +108 -0
  892. package/dist/utils/grants.cjs.map +1 -0
  893. package/dist/utils/grants.d.ts +148 -0
  894. package/dist/utils/grants.js +82 -0
  895. package/dist/utils/grants.js.map +1 -0
  896. package/dist/utils/ipfs.cjs +128 -0
  897. package/dist/utils/ipfs.cjs.map +1 -0
  898. package/dist/utils/ipfs.d.ts +88 -0
  899. package/dist/utils/ipfs.js +97 -0
  900. package/dist/utils/ipfs.js.map +1 -0
  901. package/dist/utils/lazy-import.cjs +38 -0
  902. package/dist/utils/lazy-import.cjs.map +1 -0
  903. package/dist/utils/lazy-import.d.ts +43 -0
  904. package/dist/utils/lazy-import.js +14 -0
  905. package/dist/utils/lazy-import.js.map +1 -0
  906. package/dist/utils/multicall.cjs +233 -0
  907. package/dist/utils/multicall.cjs.map +1 -0
  908. package/dist/utils/multicall.d.ts +126 -0
  909. package/dist/utils/multicall.js +208 -0
  910. package/dist/utils/multicall.js.map +1 -0
  911. package/dist/utils/parseTransactionPojo.cjs +87 -0
  912. package/dist/utils/parseTransactionPojo.cjs.map +1 -0
  913. package/dist/utils/parseTransactionPojo.d.ts +31 -0
  914. package/dist/utils/parseTransactionPojo.js +63 -0
  915. package/dist/utils/parseTransactionPojo.js.map +1 -0
  916. package/dist/utils/runtimeGrantFiles.cjs +84 -0
  917. package/dist/utils/runtimeGrantFiles.cjs.map +1 -0
  918. package/dist/utils/runtimeGrantFiles.d.ts +66 -0
  919. package/dist/utils/runtimeGrantFiles.js +58 -0
  920. package/dist/utils/runtimeGrantFiles.js.map +1 -0
  921. package/dist/utils/schemaValidation.cjs +258 -0
  922. package/dist/utils/schemaValidation.cjs.map +1 -0
  923. package/dist/utils/schemaValidation.d.ts +168 -0
  924. package/dist/utils/schemaValidation.js +219 -0
  925. package/dist/utils/schemaValidation.js.map +1 -0
  926. package/dist/utils/signatureCache.cjs +192 -0
  927. package/dist/utils/signatureCache.cjs.map +1 -0
  928. package/dist/utils/signatureCache.d.ts +172 -0
  929. package/dist/utils/signatureCache.js +167 -0
  930. package/dist/utils/signatureCache.js.map +1 -0
  931. package/dist/utils/signatureFormatter.cjs +42 -0
  932. package/dist/utils/signatureFormatter.cjs.map +1 -0
  933. package/dist/utils/signatureFormatter.d.ts +36 -0
  934. package/dist/utils/signatureFormatter.js +18 -0
  935. package/dist/utils/signatureFormatter.js.map +1 -0
  936. package/dist/utils/subgraphConsistency.cjs +184 -0
  937. package/dist/utils/subgraphConsistency.cjs.map +1 -0
  938. package/dist/utils/subgraphConsistency.d.ts +65 -0
  939. package/dist/utils/subgraphConsistency.js +155 -0
  940. package/dist/utils/subgraphConsistency.js.map +1 -0
  941. package/dist/utils/subgraphMetaCache.cjs +101 -0
  942. package/dist/utils/subgraphMetaCache.cjs.map +1 -0
  943. package/dist/utils/subgraphMetaCache.d.ts +56 -0
  944. package/dist/utils/subgraphMetaCache.js +76 -0
  945. package/dist/utils/subgraphMetaCache.js.map +1 -0
  946. package/dist/utils/subgraphPagination.cjs +104 -0
  947. package/dist/utils/subgraphPagination.cjs.map +1 -0
  948. package/dist/utils/subgraphPagination.d.ts +78 -0
  949. package/dist/utils/subgraphPagination.js +78 -0
  950. package/dist/utils/subgraphPagination.js.map +1 -0
  951. package/dist/utils/tests/multicall.test.d.ts +1 -0
  952. package/dist/utils/transactionHelpers.cjs +54 -0
  953. package/dist/utils/transactionHelpers.cjs.map +1 -0
  954. package/dist/utils/transactionHelpers.d.ts +80 -0
  955. package/dist/utils/transactionHelpers.js +29 -0
  956. package/dist/utils/transactionHelpers.js.map +1 -0
  957. package/dist/utils/typeGuards.cjs +109 -0
  958. package/dist/utils/typeGuards.cjs.map +1 -0
  959. package/dist/utils/typeGuards.d.ts +138 -0
  960. package/dist/utils/typeGuards.js +74 -0
  961. package/dist/utils/typeGuards.js.map +1 -0
  962. package/dist/utils/typedDataConverter.cjs +43 -0
  963. package/dist/utils/typedDataConverter.cjs.map +1 -0
  964. package/dist/utils/typedDataConverter.d.ts +46 -0
  965. package/dist/utils/typedDataConverter.js +19 -0
  966. package/dist/utils/typedDataConverter.js.map +1 -0
  967. package/dist/utils/urlResolver.cjs +62 -0
  968. package/dist/utils/urlResolver.cjs.map +1 -0
  969. package/dist/utils/urlResolver.d.ts +56 -0
  970. package/dist/utils/urlResolver.js +37 -0
  971. package/dist/utils/urlResolver.js.map +1 -0
  972. package/dist/utils/wallet.cjs +63 -0
  973. package/dist/utils/wallet.cjs.map +1 -0
  974. package/dist/utils/wallet.d.ts +94 -0
  975. package/dist/utils/wallet.js +37 -0
  976. package/dist/utils/wallet.js.map +1 -0
  977. package/dist/utils/withEvents.cjs +44 -0
  978. package/dist/utils/withEvents.cjs.map +1 -0
  979. package/dist/utils/withEvents.d.ts +56 -0
  980. package/dist/utils/withEvents.js +18 -0
  981. package/dist/utils/withEvents.js.map +1 -0
  982. package/package.json +79 -37
  983. package/dist/browser-cRpdLQ3-.d.ts +0 -237
  984. package/dist/chains.browser.cjs.map +0 -1
  985. package/dist/chains.d.cts +0 -2
  986. package/dist/chains.node.d.cts +0 -2
  987. package/dist/index.d.cts +0 -2
  988. package/dist/node-CkdgwBiv.d.cts +0 -237
  989. package/dist/node-CkdgwBiv.d.ts +0 -237
  990. package/dist/node.d.cts +0 -1
  991. package/dist/platform.d.cts +0 -2
  992. package/dist/platform.node.d.cts +0 -101
@@ -0,0 +1,36 @@
1
+ import { type Hash } from "viem";
2
+ /**
3
+ * Formats a signature for Ethereum smart contract compatibility by adjusting the v-value.
4
+ *
5
+ * @remarks
6
+ * This function ensures signature compatibility with Ethereum smart contracts by adjusting
7
+ * the v-value component of ECDSA signatures. Some wallet implementations and signing methods
8
+ * produce signatures with v-values in the range [0, 1], while Ethereum smart contracts
9
+ * expect v-values in the range [27, 28] for proper signature verification.
10
+ *
11
+ * The function automatically detects signatures with low v-values and applies the standard
12
+ * Ethereum offset (+27) to ensure compatibility. This is particularly important for gasless
13
+ * transactions and EIP-712 signature verification in smart contracts.
14
+ *
15
+ * **Technical Details:**
16
+ * - Ethereum signatures consist of r (32 bytes) + s (32 bytes) + v (1 byte) = 65 bytes total
17
+ * - Valid v-values for Ethereum are 27 or 28 (or 0/1 + chain-specific offset for EIP-155)
18
+ * - This function handles the common case where v ∈ [0, 1] needs adjustment to [27, 28]
19
+ *
20
+ * @param signature - The ECDSA signature hash to format (65 bytes as hex string)
21
+ * @returns The formatted signature with correct v-value for Ethereum contract verification
22
+ * @example
23
+ * ```typescript
24
+ * // Signature with v-value that needs adjustment
25
+ * const rawSignature = "0x1234...5600"; // v = 0 (last byte)
26
+ * const formatted = formatSignatureForContract(rawSignature);
27
+ * // Result: "0x1234...561b" // v = 27 (0x1b)
28
+ *
29
+ * // Already properly formatted signature remains unchanged
30
+ * const goodSignature = "0x1234...561b"; // v = 27
31
+ * const unchanged = formatSignatureForContract(goodSignature);
32
+ * // Result: "0x1234...561b" (no change needed)
33
+ * ```
34
+ * @category Cryptography
35
+ */
36
+ export declare function formatSignatureForContract(signature: Hash): Hash;
@@ -0,0 +1,18 @@
1
+ import { fromHex, toHex } from "viem";
2
+ const V_OFFSET_FOR_ETHEREUM = 27;
3
+ function formatSignatureForContract(signature) {
4
+ const sigBytes = fromHex(signature, "bytes");
5
+ if (sigBytes.length !== 65) {
6
+ return signature;
7
+ }
8
+ const v = sigBytes[64];
9
+ if (v < 27) {
10
+ sigBytes[64] = v + V_OFFSET_FOR_ETHEREUM;
11
+ return toHex(sigBytes);
12
+ }
13
+ return signature;
14
+ }
15
+ export {
16
+ formatSignatureForContract
17
+ };
18
+ //# sourceMappingURL=signatureFormatter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/utils/signatureFormatter.ts"],"sourcesContent":["import { type Hash, fromHex, toHex } from \"viem\";\n\nconst V_OFFSET_FOR_ETHEREUM = 27;\n\n/**\n * Formats a signature for Ethereum smart contract compatibility by adjusting the v-value.\n *\n * @remarks\n * This function ensures signature compatibility with Ethereum smart contracts by adjusting\n * the v-value component of ECDSA signatures. Some wallet implementations and signing methods\n * produce signatures with v-values in the range [0, 1], while Ethereum smart contracts\n * expect v-values in the range [27, 28] for proper signature verification.\n *\n * The function automatically detects signatures with low v-values and applies the standard\n * Ethereum offset (+27) to ensure compatibility. This is particularly important for gasless\n * transactions and EIP-712 signature verification in smart contracts.\n *\n * **Technical Details:**\n * - Ethereum signatures consist of r (32 bytes) + s (32 bytes) + v (1 byte) = 65 bytes total\n * - Valid v-values for Ethereum are 27 or 28 (or 0/1 + chain-specific offset for EIP-155)\n * - This function handles the common case where v ∈ [0, 1] needs adjustment to [27, 28]\n *\n * @param signature - The ECDSA signature hash to format (65 bytes as hex string)\n * @returns The formatted signature with correct v-value for Ethereum contract verification\n * @example\n * ```typescript\n * // Signature with v-value that needs adjustment\n * const rawSignature = \"0x1234...5600\"; // v = 0 (last byte)\n * const formatted = formatSignatureForContract(rawSignature);\n * // Result: \"0x1234...561b\" // v = 27 (0x1b)\n *\n * // Already properly formatted signature remains unchanged\n * const goodSignature = \"0x1234...561b\"; // v = 27\n * const unchanged = formatSignatureForContract(goodSignature);\n * // Result: \"0x1234...561b\" (no change needed)\n * ```\n * @category Cryptography\n */\nexport function formatSignatureForContract(signature: Hash): Hash {\n // Convert to bytes for safer manipulation\n const sigBytes = fromHex(signature, \"bytes\");\n\n if (sigBytes.length !== 65) {\n return signature;\n }\n\n // Extract v value (last byte)\n const v = sigBytes[64];\n\n if (v < 27) {\n // Adjust v value\n sigBytes[64] = v + V_OFFSET_FOR_ETHEREUM;\n // Convert back to hex\n return toHex(sigBytes);\n }\n\n return signature;\n}\n"],"mappings":"AAAA,SAAoB,SAAS,aAAa;AAE1C,MAAM,wBAAwB;AAoCvB,SAAS,2BAA2B,WAAuB;AAEhE,QAAM,WAAW,QAAQ,WAAW,OAAO;AAE3C,MAAI,SAAS,WAAW,IAAI;AAC1B,WAAO;AAAA,EACT;AAGA,QAAM,IAAI,SAAS,EAAE;AAErB,MAAI,IAAI,IAAI;AAEV,aAAS,EAAE,IAAI,IAAI;AAEnB,WAAO,MAAM,QAAQ;AAAA,EACvB;AAEA,SAAO;AACT;","names":[]}
@@ -0,0 +1,184 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+ var subgraphConsistency_exports = {};
20
+ __export(subgraphConsistency_exports, {
21
+ StaleDataError: () => StaleDataError,
22
+ addMetaToQuery: () => addMetaToQuery,
23
+ calculateStaleness: () => calculateStaleness,
24
+ checkSubgraphConsistency: () => checkSubgraphConsistency,
25
+ fetchSubgraphMeta: () => fetchSubgraphMeta,
26
+ waitForSubgraphSync: () => waitForSubgraphSync
27
+ });
28
+ module.exports = __toCommonJS(subgraphConsistency_exports);
29
+ var import_graphql = require("graphql");
30
+ var import_subgraph = require("../generated/subgraph");
31
+ var import_subgraphMetaCache = require("./subgraphMetaCache");
32
+ class StaleDataError extends Error {
33
+ constructor(requiredBlock, currentBlock, message) {
34
+ super(
35
+ message ?? `Subgraph data is stale. Required block: ${requiredBlock}, Current block: ${currentBlock}`
36
+ );
37
+ this.requiredBlock = requiredBlock;
38
+ this.currentBlock = currentBlock;
39
+ this.name = "StaleDataError";
40
+ }
41
+ }
42
+ async function fetchSubgraphMeta(subgraphUrl, useCache = true) {
43
+ if (useCache) {
44
+ const cached = import_subgraphMetaCache.globalMetaCache.get(subgraphUrl);
45
+ if (cached) {
46
+ return cached;
47
+ }
48
+ }
49
+ const response = await fetch(subgraphUrl, {
50
+ method: "POST",
51
+ headers: {
52
+ "Content-Type": "application/json"
53
+ },
54
+ body: JSON.stringify({
55
+ query: (0, import_graphql.print)(import_subgraph.GetSubgraphMetaDocument)
56
+ })
57
+ });
58
+ if (!response.ok) {
59
+ throw new Error(
60
+ `Failed to fetch subgraph metadata: ${response.status} ${response.statusText}`
61
+ );
62
+ }
63
+ const result = await response.json();
64
+ if (result.errors) {
65
+ throw new Error(
66
+ `Subgraph query errors: ${result.errors.map((e) => e.message).join(", ")}`
67
+ );
68
+ }
69
+ if (!result.data?._meta) {
70
+ throw new Error("No metadata returned from subgraph");
71
+ }
72
+ const meta = result.data._meta;
73
+ const subgraphMeta = {
74
+ blockNumber: meta.block.number,
75
+ blockTimestamp: meta.block.timestamp ?? void 0,
76
+ blockHash: meta.block.hash ?? void 0,
77
+ deployment: meta.deployment,
78
+ hasIndexingErrors: meta.hasIndexingErrors
79
+ };
80
+ if (useCache) {
81
+ import_subgraphMetaCache.globalMetaCache.set(subgraphUrl, subgraphMeta);
82
+ }
83
+ return subgraphMeta;
84
+ }
85
+ async function checkSubgraphConsistency(subgraphUrl, options) {
86
+ if (options?.signal?.aborted) {
87
+ throw new Error("Operation aborted");
88
+ }
89
+ if (!options?.minBlock) {
90
+ return fetchSubgraphMeta(subgraphUrl);
91
+ }
92
+ const meta = await fetchSubgraphMeta(subgraphUrl);
93
+ if (meta.blockNumber < options.minBlock) {
94
+ if (options.waitForSync && options.waitForSync > 0) {
95
+ return waitForSubgraphSync(
96
+ subgraphUrl,
97
+ options.minBlock,
98
+ options.waitForSync,
99
+ 2e3,
100
+ // pollInterval
101
+ options.signal
102
+ );
103
+ }
104
+ throw new StaleDataError(options.minBlock, meta.blockNumber);
105
+ }
106
+ return meta;
107
+ }
108
+ async function waitForSubgraphSync(subgraphUrl, targetBlock, maxWait, pollInterval = 2e3, signal) {
109
+ const startTime = Date.now();
110
+ if (signal?.aborted) {
111
+ throw new Error("Operation aborted");
112
+ }
113
+ const checkAbort = () => {
114
+ if (signal?.aborted) {
115
+ throw new Error("Operation aborted");
116
+ }
117
+ };
118
+ while (Date.now() - startTime < maxWait) {
119
+ checkAbort();
120
+ const meta = await fetchSubgraphMeta(subgraphUrl);
121
+ if (meta.blockNumber >= targetBlock) {
122
+ return meta;
123
+ }
124
+ await new Promise((resolve, reject) => {
125
+ const timer = setTimeout(resolve, pollInterval);
126
+ if (signal) {
127
+ const abortHandler = () => {
128
+ clearTimeout(timer);
129
+ reject(new Error("Operation aborted"));
130
+ };
131
+ if (signal.aborted) {
132
+ abortHandler();
133
+ } else {
134
+ signal.addEventListener("abort", abortHandler, { once: true });
135
+ }
136
+ }
137
+ });
138
+ }
139
+ checkAbort();
140
+ const finalMeta = await fetchSubgraphMeta(subgraphUrl);
141
+ if (finalMeta.blockNumber >= targetBlock) {
142
+ return finalMeta;
143
+ }
144
+ throw new StaleDataError(
145
+ targetBlock,
146
+ finalMeta.blockNumber,
147
+ `Subgraph did not sync to block ${targetBlock} within ${maxWait}ms. Current block: ${finalMeta.blockNumber}`
148
+ );
149
+ }
150
+ function calculateStaleness(meta, currentTimestamp) {
151
+ if (!meta.blockTimestamp) {
152
+ return void 0;
153
+ }
154
+ return Math.max(0, currentTimestamp - meta.blockTimestamp);
155
+ }
156
+ function addMetaToQuery(baseQuery) {
157
+ if (baseQuery.includes("_meta")) {
158
+ return baseQuery;
159
+ }
160
+ const queryMatch = baseQuery.match(/query\s+\w+[^{]*\{/);
161
+ if (!queryMatch) {
162
+ return baseQuery;
163
+ }
164
+ const insertPoint = queryMatch.index + queryMatch[0].length;
165
+ return baseQuery.slice(0, insertPoint) + `
166
+ _meta {
167
+ block {
168
+ number
169
+ timestamp
170
+ }
171
+ hasIndexingErrors
172
+ }
173
+ ` + baseQuery.slice(insertPoint);
174
+ }
175
+ // Annotate the CommonJS export names for ESM import in node:
176
+ 0 && (module.exports = {
177
+ StaleDataError,
178
+ addMetaToQuery,
179
+ calculateStaleness,
180
+ checkSubgraphConsistency,
181
+ fetchSubgraphMeta,
182
+ waitForSubgraphSync
183
+ });
184
+ //# sourceMappingURL=subgraphConsistency.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/utils/subgraphConsistency.ts"],"sourcesContent":["/**\n * @file Utilities for handling subgraph data consistency\n * @module vana-sdk/utils/subgraphConsistency\n */\n\nimport { print } from \"graphql\";\nimport type { ConsistencyOptions } from \"../types/options\";\nimport type { GetSubgraphMetaQuery } from \"../generated/subgraph\";\nimport { GetSubgraphMetaDocument } from \"../generated/subgraph\";\nimport { globalMetaCache } from \"./subgraphMetaCache\";\n\n/**\n * Error thrown when subgraph data is stale relative to consistency requirements\n */\nexport class StaleDataError extends Error {\n constructor(\n public readonly requiredBlock: number,\n public readonly currentBlock: number,\n message?: string,\n ) {\n super(\n message ??\n `Subgraph data is stale. Required block: ${requiredBlock}, Current block: ${currentBlock}`,\n );\n this.name = \"StaleDataError\";\n }\n}\n\n/**\n * Subgraph metadata response structure\n */\nexport interface SubgraphMeta {\n blockNumber: number;\n blockTimestamp?: number;\n blockHash?: string;\n deployment: string;\n hasIndexingErrors: boolean;\n}\n\n/**\n * Response structure from subgraph queries\n */\ninterface SubgraphResponse<T> {\n data?: T;\n errors?: Array<{ message: string }>;\n}\n\n/**\n * Fetches the current metadata from a subgraph\n *\n * @param subgraphUrl - The GraphQL endpoint URL\n * @returns Current block information and indexing status\n */\nexport async function fetchSubgraphMeta(\n subgraphUrl: string,\n useCache = true,\n): Promise<SubgraphMeta> {\n // Check cache first\n if (useCache) {\n const cached = globalMetaCache.get(subgraphUrl);\n if (cached) {\n return cached;\n }\n }\n\n const response = await fetch(subgraphUrl, {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({\n query: print(GetSubgraphMetaDocument),\n }),\n });\n\n if (!response.ok) {\n throw new Error(\n `Failed to fetch subgraph metadata: ${response.status} ${response.statusText}`,\n );\n }\n\n const result =\n (await response.json()) as SubgraphResponse<GetSubgraphMetaQuery>;\n\n if (result.errors) {\n throw new Error(\n `Subgraph query errors: ${result.errors.map((e) => e.message).join(\", \")}`,\n );\n }\n\n if (!result.data?._meta) {\n throw new Error(\"No metadata returned from subgraph\");\n }\n\n const meta = result.data._meta;\n const subgraphMeta: SubgraphMeta = {\n blockNumber: meta.block.number,\n blockTimestamp: meta.block.timestamp ?? undefined,\n blockHash: meta.block.hash ?? undefined,\n deployment: meta.deployment,\n hasIndexingErrors: meta.hasIndexingErrors,\n };\n\n // Cache the result\n if (useCache) {\n globalMetaCache.set(subgraphUrl, subgraphMeta);\n }\n\n return subgraphMeta;\n}\n\n/**\n * Checks if subgraph meets consistency requirements\n *\n * @param subgraphUrl - The GraphQL endpoint URL\n * @param options - Consistency requirements\n * @returns The subgraph metadata if requirements are met\n * @throws {StaleDataError} If subgraph is behind required block\n */\nexport async function checkSubgraphConsistency(\n subgraphUrl: string,\n options?: ConsistencyOptions,\n): Promise<SubgraphMeta> {\n // Check if already aborted\n if (options?.signal?.aborted) {\n throw new Error(\"Operation aborted\");\n }\n\n // If no consistency requirements, just return current metadata\n if (!options?.minBlock) {\n return fetchSubgraphMeta(subgraphUrl);\n }\n\n const meta = await fetchSubgraphMeta(subgraphUrl);\n\n // Check if subgraph has reached required block\n if (meta.blockNumber < options.minBlock) {\n // If waitForSync is specified, poll until caught up\n if (options.waitForSync && options.waitForSync > 0) {\n return waitForSubgraphSync(\n subgraphUrl,\n options.minBlock,\n options.waitForSync,\n 2000, // pollInterval\n options.signal,\n );\n }\n\n // Otherwise throw immediately\n throw new StaleDataError(options.minBlock, meta.blockNumber);\n }\n\n return meta;\n}\n\n/**\n * Waits for subgraph to sync to a specific block\n *\n * @param subgraphUrl - The GraphQL endpoint URL\n * @param targetBlock - Block number to wait for\n * @param maxWait - Maximum milliseconds to wait\n * @param pollInterval - How often to check (default: 2000ms)\n * @returns The subgraph metadata when target is reached\n * @throws {StaleDataError} If timeout is reached before sync\n */\nexport async function waitForSubgraphSync(\n subgraphUrl: string,\n targetBlock: number,\n maxWait: number,\n pollInterval = 2000,\n signal?: AbortSignal,\n): Promise<SubgraphMeta> {\n const startTime = Date.now();\n\n // Check if already aborted\n if (signal?.aborted) {\n throw new Error(\"Operation aborted\");\n }\n\n // Set up abort handling\n const checkAbort = () => {\n if (signal?.aborted) {\n throw new Error(\"Operation aborted\");\n }\n };\n\n while (Date.now() - startTime < maxWait) {\n checkAbort();\n const meta = await fetchSubgraphMeta(subgraphUrl);\n\n // Check if we've reached the target\n if (meta.blockNumber >= targetBlock) {\n return meta;\n }\n\n // Wait before next check with abort support\n await new Promise<void>((resolve, reject) => {\n const timer = setTimeout(resolve, pollInterval);\n\n if (signal) {\n const abortHandler = () => {\n clearTimeout(timer);\n reject(new Error(\"Operation aborted\"));\n };\n\n if (signal.aborted) {\n abortHandler();\n } else {\n signal.addEventListener(\"abort\", abortHandler, { once: true });\n }\n }\n });\n }\n\n // Timeout reached, check one more time\n checkAbort();\n const finalMeta = await fetchSubgraphMeta(subgraphUrl);\n if (finalMeta.blockNumber >= targetBlock) {\n return finalMeta;\n }\n\n throw new StaleDataError(\n targetBlock,\n finalMeta.blockNumber,\n `Subgraph did not sync to block ${targetBlock} within ${maxWait}ms. Current block: ${finalMeta.blockNumber}`,\n );\n}\n\n/**\n * Calculates staleness in seconds based on block timestamps\n *\n * @param meta - Subgraph metadata\n * @param currentTimestamp - Current chain timestamp\n * @returns Seconds behind the chain, or undefined if timestamps unavailable\n */\nexport function calculateStaleness(\n meta: SubgraphMeta,\n currentTimestamp: number,\n): number | undefined {\n if (!meta.blockTimestamp) {\n return undefined;\n }\n\n return Math.max(0, currentTimestamp - meta.blockTimestamp);\n}\n\n/**\n * Builds a GraphQL query with _meta field included\n *\n * @param baseQuery - The original query string\n * @returns Query with _meta field added\n */\nexport function addMetaToQuery(baseQuery: string): string {\n // Simple approach: inject _meta at the root level\n // This is a basic implementation - could be enhanced with proper AST manipulation\n if (baseQuery.includes(\"_meta\")) {\n return baseQuery; // Already has meta\n }\n\n // Find the first { after query name and inject _meta\n const queryMatch = baseQuery.match(/query\\s+\\w+[^{]*\\{/);\n if (!queryMatch) {\n return baseQuery; // Can't parse, return as-is\n }\n\n const insertPoint = queryMatch.index! + queryMatch[0].length;\n return (\n baseQuery.slice(0, insertPoint) +\n `\n _meta {\n block {\n number\n timestamp\n }\n hasIndexingErrors\n }\n ` +\n baseQuery.slice(insertPoint)\n );\n}\n"],"mappings":"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","names":[]}
@@ -0,0 +1,65 @@
1
+ /**
2
+ * @file Utilities for handling subgraph data consistency
3
+ * @module vana-sdk/utils/subgraphConsistency
4
+ */
5
+ import type { ConsistencyOptions } from "../types/options";
6
+ /**
7
+ * Error thrown when subgraph data is stale relative to consistency requirements
8
+ */
9
+ export declare class StaleDataError extends Error {
10
+ readonly requiredBlock: number;
11
+ readonly currentBlock: number;
12
+ constructor(requiredBlock: number, currentBlock: number, message?: string);
13
+ }
14
+ /**
15
+ * Subgraph metadata response structure
16
+ */
17
+ export interface SubgraphMeta {
18
+ blockNumber: number;
19
+ blockTimestamp?: number;
20
+ blockHash?: string;
21
+ deployment: string;
22
+ hasIndexingErrors: boolean;
23
+ }
24
+ /**
25
+ * Fetches the current metadata from a subgraph
26
+ *
27
+ * @param subgraphUrl - The GraphQL endpoint URL
28
+ * @returns Current block information and indexing status
29
+ */
30
+ export declare function fetchSubgraphMeta(subgraphUrl: string, useCache?: boolean): Promise<SubgraphMeta>;
31
+ /**
32
+ * Checks if subgraph meets consistency requirements
33
+ *
34
+ * @param subgraphUrl - The GraphQL endpoint URL
35
+ * @param options - Consistency requirements
36
+ * @returns The subgraph metadata if requirements are met
37
+ * @throws {StaleDataError} If subgraph is behind required block
38
+ */
39
+ export declare function checkSubgraphConsistency(subgraphUrl: string, options?: ConsistencyOptions): Promise<SubgraphMeta>;
40
+ /**
41
+ * Waits for subgraph to sync to a specific block
42
+ *
43
+ * @param subgraphUrl - The GraphQL endpoint URL
44
+ * @param targetBlock - Block number to wait for
45
+ * @param maxWait - Maximum milliseconds to wait
46
+ * @param pollInterval - How often to check (default: 2000ms)
47
+ * @returns The subgraph metadata when target is reached
48
+ * @throws {StaleDataError} If timeout is reached before sync
49
+ */
50
+ export declare function waitForSubgraphSync(subgraphUrl: string, targetBlock: number, maxWait: number, pollInterval?: number, signal?: AbortSignal): Promise<SubgraphMeta>;
51
+ /**
52
+ * Calculates staleness in seconds based on block timestamps
53
+ *
54
+ * @param meta - Subgraph metadata
55
+ * @param currentTimestamp - Current chain timestamp
56
+ * @returns Seconds behind the chain, or undefined if timestamps unavailable
57
+ */
58
+ export declare function calculateStaleness(meta: SubgraphMeta, currentTimestamp: number): number | undefined;
59
+ /**
60
+ * Builds a GraphQL query with _meta field included
61
+ *
62
+ * @param baseQuery - The original query string
63
+ * @returns Query with _meta field added
64
+ */
65
+ export declare function addMetaToQuery(baseQuery: string): string;
@@ -0,0 +1,155 @@
1
+ import { print } from "graphql";
2
+ import { GetSubgraphMetaDocument } from "../generated/subgraph";
3
+ import { globalMetaCache } from "./subgraphMetaCache";
4
+ class StaleDataError extends Error {
5
+ constructor(requiredBlock, currentBlock, message) {
6
+ super(
7
+ message ?? `Subgraph data is stale. Required block: ${requiredBlock}, Current block: ${currentBlock}`
8
+ );
9
+ this.requiredBlock = requiredBlock;
10
+ this.currentBlock = currentBlock;
11
+ this.name = "StaleDataError";
12
+ }
13
+ }
14
+ async function fetchSubgraphMeta(subgraphUrl, useCache = true) {
15
+ if (useCache) {
16
+ const cached = globalMetaCache.get(subgraphUrl);
17
+ if (cached) {
18
+ return cached;
19
+ }
20
+ }
21
+ const response = await fetch(subgraphUrl, {
22
+ method: "POST",
23
+ headers: {
24
+ "Content-Type": "application/json"
25
+ },
26
+ body: JSON.stringify({
27
+ query: print(GetSubgraphMetaDocument)
28
+ })
29
+ });
30
+ if (!response.ok) {
31
+ throw new Error(
32
+ `Failed to fetch subgraph metadata: ${response.status} ${response.statusText}`
33
+ );
34
+ }
35
+ const result = await response.json();
36
+ if (result.errors) {
37
+ throw new Error(
38
+ `Subgraph query errors: ${result.errors.map((e) => e.message).join(", ")}`
39
+ );
40
+ }
41
+ if (!result.data?._meta) {
42
+ throw new Error("No metadata returned from subgraph");
43
+ }
44
+ const meta = result.data._meta;
45
+ const subgraphMeta = {
46
+ blockNumber: meta.block.number,
47
+ blockTimestamp: meta.block.timestamp ?? void 0,
48
+ blockHash: meta.block.hash ?? void 0,
49
+ deployment: meta.deployment,
50
+ hasIndexingErrors: meta.hasIndexingErrors
51
+ };
52
+ if (useCache) {
53
+ globalMetaCache.set(subgraphUrl, subgraphMeta);
54
+ }
55
+ return subgraphMeta;
56
+ }
57
+ async function checkSubgraphConsistency(subgraphUrl, options) {
58
+ if (options?.signal?.aborted) {
59
+ throw new Error("Operation aborted");
60
+ }
61
+ if (!options?.minBlock) {
62
+ return fetchSubgraphMeta(subgraphUrl);
63
+ }
64
+ const meta = await fetchSubgraphMeta(subgraphUrl);
65
+ if (meta.blockNumber < options.minBlock) {
66
+ if (options.waitForSync && options.waitForSync > 0) {
67
+ return waitForSubgraphSync(
68
+ subgraphUrl,
69
+ options.minBlock,
70
+ options.waitForSync,
71
+ 2e3,
72
+ // pollInterval
73
+ options.signal
74
+ );
75
+ }
76
+ throw new StaleDataError(options.minBlock, meta.blockNumber);
77
+ }
78
+ return meta;
79
+ }
80
+ async function waitForSubgraphSync(subgraphUrl, targetBlock, maxWait, pollInterval = 2e3, signal) {
81
+ const startTime = Date.now();
82
+ if (signal?.aborted) {
83
+ throw new Error("Operation aborted");
84
+ }
85
+ const checkAbort = () => {
86
+ if (signal?.aborted) {
87
+ throw new Error("Operation aborted");
88
+ }
89
+ };
90
+ while (Date.now() - startTime < maxWait) {
91
+ checkAbort();
92
+ const meta = await fetchSubgraphMeta(subgraphUrl);
93
+ if (meta.blockNumber >= targetBlock) {
94
+ return meta;
95
+ }
96
+ await new Promise((resolve, reject) => {
97
+ const timer = setTimeout(resolve, pollInterval);
98
+ if (signal) {
99
+ const abortHandler = () => {
100
+ clearTimeout(timer);
101
+ reject(new Error("Operation aborted"));
102
+ };
103
+ if (signal.aborted) {
104
+ abortHandler();
105
+ } else {
106
+ signal.addEventListener("abort", abortHandler, { once: true });
107
+ }
108
+ }
109
+ });
110
+ }
111
+ checkAbort();
112
+ const finalMeta = await fetchSubgraphMeta(subgraphUrl);
113
+ if (finalMeta.blockNumber >= targetBlock) {
114
+ return finalMeta;
115
+ }
116
+ throw new StaleDataError(
117
+ targetBlock,
118
+ finalMeta.blockNumber,
119
+ `Subgraph did not sync to block ${targetBlock} within ${maxWait}ms. Current block: ${finalMeta.blockNumber}`
120
+ );
121
+ }
122
+ function calculateStaleness(meta, currentTimestamp) {
123
+ if (!meta.blockTimestamp) {
124
+ return void 0;
125
+ }
126
+ return Math.max(0, currentTimestamp - meta.blockTimestamp);
127
+ }
128
+ function addMetaToQuery(baseQuery) {
129
+ if (baseQuery.includes("_meta")) {
130
+ return baseQuery;
131
+ }
132
+ const queryMatch = baseQuery.match(/query\s+\w+[^{]*\{/);
133
+ if (!queryMatch) {
134
+ return baseQuery;
135
+ }
136
+ const insertPoint = queryMatch.index + queryMatch[0].length;
137
+ return baseQuery.slice(0, insertPoint) + `
138
+ _meta {
139
+ block {
140
+ number
141
+ timestamp
142
+ }
143
+ hasIndexingErrors
144
+ }
145
+ ` + baseQuery.slice(insertPoint);
146
+ }
147
+ export {
148
+ StaleDataError,
149
+ addMetaToQuery,
150
+ calculateStaleness,
151
+ checkSubgraphConsistency,
152
+ fetchSubgraphMeta,
153
+ waitForSubgraphSync
154
+ };
155
+ //# sourceMappingURL=subgraphConsistency.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/utils/subgraphConsistency.ts"],"sourcesContent":["/**\n * @file Utilities for handling subgraph data consistency\n * @module vana-sdk/utils/subgraphConsistency\n */\n\nimport { print } from \"graphql\";\nimport type { ConsistencyOptions } from \"../types/options\";\nimport type { GetSubgraphMetaQuery } from \"../generated/subgraph\";\nimport { GetSubgraphMetaDocument } from \"../generated/subgraph\";\nimport { globalMetaCache } from \"./subgraphMetaCache\";\n\n/**\n * Error thrown when subgraph data is stale relative to consistency requirements\n */\nexport class StaleDataError extends Error {\n constructor(\n public readonly requiredBlock: number,\n public readonly currentBlock: number,\n message?: string,\n ) {\n super(\n message ??\n `Subgraph data is stale. Required block: ${requiredBlock}, Current block: ${currentBlock}`,\n );\n this.name = \"StaleDataError\";\n }\n}\n\n/**\n * Subgraph metadata response structure\n */\nexport interface SubgraphMeta {\n blockNumber: number;\n blockTimestamp?: number;\n blockHash?: string;\n deployment: string;\n hasIndexingErrors: boolean;\n}\n\n/**\n * Response structure from subgraph queries\n */\ninterface SubgraphResponse<T> {\n data?: T;\n errors?: Array<{ message: string }>;\n}\n\n/**\n * Fetches the current metadata from a subgraph\n *\n * @param subgraphUrl - The GraphQL endpoint URL\n * @returns Current block information and indexing status\n */\nexport async function fetchSubgraphMeta(\n subgraphUrl: string,\n useCache = true,\n): Promise<SubgraphMeta> {\n // Check cache first\n if (useCache) {\n const cached = globalMetaCache.get(subgraphUrl);\n if (cached) {\n return cached;\n }\n }\n\n const response = await fetch(subgraphUrl, {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({\n query: print(GetSubgraphMetaDocument),\n }),\n });\n\n if (!response.ok) {\n throw new Error(\n `Failed to fetch subgraph metadata: ${response.status} ${response.statusText}`,\n );\n }\n\n const result =\n (await response.json()) as SubgraphResponse<GetSubgraphMetaQuery>;\n\n if (result.errors) {\n throw new Error(\n `Subgraph query errors: ${result.errors.map((e) => e.message).join(\", \")}`,\n );\n }\n\n if (!result.data?._meta) {\n throw new Error(\"No metadata returned from subgraph\");\n }\n\n const meta = result.data._meta;\n const subgraphMeta: SubgraphMeta = {\n blockNumber: meta.block.number,\n blockTimestamp: meta.block.timestamp ?? undefined,\n blockHash: meta.block.hash ?? undefined,\n deployment: meta.deployment,\n hasIndexingErrors: meta.hasIndexingErrors,\n };\n\n // Cache the result\n if (useCache) {\n globalMetaCache.set(subgraphUrl, subgraphMeta);\n }\n\n return subgraphMeta;\n}\n\n/**\n * Checks if subgraph meets consistency requirements\n *\n * @param subgraphUrl - The GraphQL endpoint URL\n * @param options - Consistency requirements\n * @returns The subgraph metadata if requirements are met\n * @throws {StaleDataError} If subgraph is behind required block\n */\nexport async function checkSubgraphConsistency(\n subgraphUrl: string,\n options?: ConsistencyOptions,\n): Promise<SubgraphMeta> {\n // Check if already aborted\n if (options?.signal?.aborted) {\n throw new Error(\"Operation aborted\");\n }\n\n // If no consistency requirements, just return current metadata\n if (!options?.minBlock) {\n return fetchSubgraphMeta(subgraphUrl);\n }\n\n const meta = await fetchSubgraphMeta(subgraphUrl);\n\n // Check if subgraph has reached required block\n if (meta.blockNumber < options.minBlock) {\n // If waitForSync is specified, poll until caught up\n if (options.waitForSync && options.waitForSync > 0) {\n return waitForSubgraphSync(\n subgraphUrl,\n options.minBlock,\n options.waitForSync,\n 2000, // pollInterval\n options.signal,\n );\n }\n\n // Otherwise throw immediately\n throw new StaleDataError(options.minBlock, meta.blockNumber);\n }\n\n return meta;\n}\n\n/**\n * Waits for subgraph to sync to a specific block\n *\n * @param subgraphUrl - The GraphQL endpoint URL\n * @param targetBlock - Block number to wait for\n * @param maxWait - Maximum milliseconds to wait\n * @param pollInterval - How often to check (default: 2000ms)\n * @returns The subgraph metadata when target is reached\n * @throws {StaleDataError} If timeout is reached before sync\n */\nexport async function waitForSubgraphSync(\n subgraphUrl: string,\n targetBlock: number,\n maxWait: number,\n pollInterval = 2000,\n signal?: AbortSignal,\n): Promise<SubgraphMeta> {\n const startTime = Date.now();\n\n // Check if already aborted\n if (signal?.aborted) {\n throw new Error(\"Operation aborted\");\n }\n\n // Set up abort handling\n const checkAbort = () => {\n if (signal?.aborted) {\n throw new Error(\"Operation aborted\");\n }\n };\n\n while (Date.now() - startTime < maxWait) {\n checkAbort();\n const meta = await fetchSubgraphMeta(subgraphUrl);\n\n // Check if we've reached the target\n if (meta.blockNumber >= targetBlock) {\n return meta;\n }\n\n // Wait before next check with abort support\n await new Promise<void>((resolve, reject) => {\n const timer = setTimeout(resolve, pollInterval);\n\n if (signal) {\n const abortHandler = () => {\n clearTimeout(timer);\n reject(new Error(\"Operation aborted\"));\n };\n\n if (signal.aborted) {\n abortHandler();\n } else {\n signal.addEventListener(\"abort\", abortHandler, { once: true });\n }\n }\n });\n }\n\n // Timeout reached, check one more time\n checkAbort();\n const finalMeta = await fetchSubgraphMeta(subgraphUrl);\n if (finalMeta.blockNumber >= targetBlock) {\n return finalMeta;\n }\n\n throw new StaleDataError(\n targetBlock,\n finalMeta.blockNumber,\n `Subgraph did not sync to block ${targetBlock} within ${maxWait}ms. Current block: ${finalMeta.blockNumber}`,\n );\n}\n\n/**\n * Calculates staleness in seconds based on block timestamps\n *\n * @param meta - Subgraph metadata\n * @param currentTimestamp - Current chain timestamp\n * @returns Seconds behind the chain, or undefined if timestamps unavailable\n */\nexport function calculateStaleness(\n meta: SubgraphMeta,\n currentTimestamp: number,\n): number | undefined {\n if (!meta.blockTimestamp) {\n return undefined;\n }\n\n return Math.max(0, currentTimestamp - meta.blockTimestamp);\n}\n\n/**\n * Builds a GraphQL query with _meta field included\n *\n * @param baseQuery - The original query string\n * @returns Query with _meta field added\n */\nexport function addMetaToQuery(baseQuery: string): string {\n // Simple approach: inject _meta at the root level\n // This is a basic implementation - could be enhanced with proper AST manipulation\n if (baseQuery.includes(\"_meta\")) {\n return baseQuery; // Already has meta\n }\n\n // Find the first { after query name and inject _meta\n const queryMatch = baseQuery.match(/query\\s+\\w+[^{]*\\{/);\n if (!queryMatch) {\n return baseQuery; // Can't parse, return as-is\n }\n\n const insertPoint = queryMatch.index! + queryMatch[0].length;\n return (\n baseQuery.slice(0, insertPoint) +\n `\n _meta {\n block {\n number\n timestamp\n }\n hasIndexingErrors\n }\n ` +\n baseQuery.slice(insertPoint)\n );\n}\n"],"mappings":"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","names":[]}
@@ -0,0 +1,101 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+ var subgraphMetaCache_exports = {};
20
+ __export(subgraphMetaCache_exports, {
21
+ SubgraphMetaCache: () => SubgraphMetaCache,
22
+ globalMetaCache: () => globalMetaCache
23
+ });
24
+ module.exports = __toCommonJS(subgraphMetaCache_exports);
25
+ class SubgraphMetaCache {
26
+ cache = /* @__PURE__ */ new Map();
27
+ maxSize;
28
+ ttl;
29
+ /**
30
+ * Create a new metadata cache
31
+ *
32
+ * @param ttl - Time to live in milliseconds (default: 2000ms)
33
+ * @param maxSize - Maximum cache entries (default: 10)
34
+ */
35
+ constructor(ttl = 2e3, maxSize = 10) {
36
+ this.ttl = ttl;
37
+ this.maxSize = maxSize;
38
+ }
39
+ /**
40
+ * Get cached metadata if fresh
41
+ *
42
+ * @param url - Subgraph URL as cache key
43
+ * @returns Cached metadata or undefined if stale/missing
44
+ */
45
+ get(url) {
46
+ const entry = this.cache.get(url);
47
+ if (!entry) {
48
+ return void 0;
49
+ }
50
+ if (Date.now() - entry.timestamp > this.ttl) {
51
+ this.cache.delete(url);
52
+ return void 0;
53
+ }
54
+ this.cache.delete(url);
55
+ this.cache.set(url, entry);
56
+ return entry.meta;
57
+ }
58
+ /**
59
+ * Store metadata in cache
60
+ *
61
+ * @param url - Subgraph URL as cache key
62
+ * @param meta - Metadata to cache
63
+ */
64
+ set(url, meta) {
65
+ if (this.cache.size >= this.maxSize && !this.cache.has(url)) {
66
+ const firstKey = this.cache.keys().next().value;
67
+ if (firstKey) {
68
+ this.cache.delete(firstKey);
69
+ }
70
+ }
71
+ this.cache.set(url, {
72
+ meta,
73
+ timestamp: Date.now()
74
+ });
75
+ }
76
+ /**
77
+ * Clear all cached entries
78
+ */
79
+ clear() {
80
+ this.cache.clear();
81
+ }
82
+ /**
83
+ * Get cache statistics
84
+ *
85
+ * @returns Cache size and TTL info
86
+ */
87
+ stats() {
88
+ return {
89
+ size: this.cache.size,
90
+ ttl: this.ttl,
91
+ maxSize: this.maxSize
92
+ };
93
+ }
94
+ }
95
+ const globalMetaCache = new SubgraphMetaCache();
96
+ // Annotate the CommonJS export names for ESM import in node:
97
+ 0 && (module.exports = {
98
+ SubgraphMetaCache,
99
+ globalMetaCache
100
+ });
101
+ //# sourceMappingURL=subgraphMetaCache.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/utils/subgraphMetaCache.ts"],"sourcesContent":["/**\n * @file Simple cache for subgraph metadata to reduce redundant queries\n * @module vana-sdk/utils/subgraphMetaCache\n */\n\nimport type { SubgraphMeta } from \"./subgraphConsistency\";\n\ninterface CacheEntry {\n meta: SubgraphMeta;\n timestamp: number;\n}\n\n/**\n * Simple LRU cache for subgraph metadata\n *\n * @remarks\n * Reduces redundant _meta queries when multiple SDK methods are called\n * in quick succession. Uses a very short TTL to avoid masking staleness.\n */\nexport class SubgraphMetaCache {\n private cache = new Map<string, CacheEntry>();\n private readonly maxSize: number;\n private readonly ttl: number;\n\n /**\n * Create a new metadata cache\n *\n * @param ttl - Time to live in milliseconds (default: 2000ms)\n * @param maxSize - Maximum cache entries (default: 10)\n */\n constructor(ttl = 2000, maxSize = 10) {\n this.ttl = ttl;\n this.maxSize = maxSize;\n }\n\n /**\n * Get cached metadata if fresh\n *\n * @param url - Subgraph URL as cache key\n * @returns Cached metadata or undefined if stale/missing\n */\n get(url: string): SubgraphMeta | undefined {\n const entry = this.cache.get(url);\n\n if (!entry) {\n return undefined;\n }\n\n // Check if still fresh\n if (Date.now() - entry.timestamp > this.ttl) {\n // Expired, remove it\n this.cache.delete(url);\n return undefined;\n }\n\n // Move to end (LRU)\n this.cache.delete(url);\n this.cache.set(url, entry);\n\n return entry.meta;\n }\n\n /**\n * Store metadata in cache\n *\n * @param url - Subgraph URL as cache key\n * @param meta - Metadata to cache\n */\n set(url: string, meta: SubgraphMeta): void {\n // Remove oldest if at capacity\n if (this.cache.size >= this.maxSize && !this.cache.has(url)) {\n const firstKey = this.cache.keys().next().value;\n if (firstKey) {\n this.cache.delete(firstKey);\n }\n }\n\n this.cache.set(url, {\n meta,\n timestamp: Date.now(),\n });\n }\n\n /**\n * Clear all cached entries\n */\n clear(): void {\n this.cache.clear();\n }\n\n /**\n * Get cache statistics\n *\n * @returns Cache size and TTL info\n */\n stats(): { size: number; ttl: number; maxSize: number } {\n return {\n size: this.cache.size,\n ttl: this.ttl,\n maxSize: this.maxSize,\n };\n }\n}\n\n/**\n * Global cache instance (optional, can be configured per SDK instance)\n */\nexport const globalMetaCache = new SubgraphMetaCache();\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmBO,MAAM,kBAAkB;AAAA,EACrB,QAAQ,oBAAI,IAAwB;AAAA,EAC3B;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQjB,YAAY,MAAM,KAAM,UAAU,IAAI;AACpC,SAAK,MAAM;AACX,SAAK,UAAU;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAI,KAAuC;AACzC,UAAM,QAAQ,KAAK,MAAM,IAAI,GAAG;AAEhC,QAAI,CAAC,OAAO;AACV,aAAO;AAAA,IACT;AAGA,QAAI,KAAK,IAAI,IAAI,MAAM,YAAY,KAAK,KAAK;AAE3C,WAAK,MAAM,OAAO,GAAG;AACrB,aAAO;AAAA,IACT;AAGA,SAAK,MAAM,OAAO,GAAG;AACrB,SAAK,MAAM,IAAI,KAAK,KAAK;AAEzB,WAAO,MAAM;AAAA,EACf;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAI,KAAa,MAA0B;AAEzC,QAAI,KAAK,MAAM,QAAQ,KAAK,WAAW,CAAC,KAAK,MAAM,IAAI,GAAG,GAAG;AAC3D,YAAM,WAAW,KAAK,MAAM,KAAK,EAAE,KAAK,EAAE;AAC1C,UAAI,UAAU;AACZ,aAAK,MAAM,OAAO,QAAQ;AAAA,MAC5B;AAAA,IACF;AAEA,SAAK,MAAM,IAAI,KAAK;AAAA,MAClB;AAAA,MACA,WAAW,KAAK,IAAI;AAAA,IACtB,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,QAAc;AACZ,SAAK,MAAM,MAAM;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,QAAwD;AACtD,WAAO;AAAA,MACL,MAAM,KAAK,MAAM;AAAA,MACjB,KAAK,KAAK;AAAA,MACV,SAAS,KAAK;AAAA,IAChB;AAAA,EACF;AACF;AAKO,MAAM,kBAAkB,IAAI,kBAAkB;","names":[]}