@mikeatlast/ponder 0.16.1-fork.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (619) hide show
  1. package/CHANGELOG.md +3415 -0
  2. package/README.md +186 -0
  3. package/dist/esm/bin/commands/codegen.js +46 -0
  4. package/dist/esm/bin/commands/codegen.js.map +1 -0
  5. package/dist/esm/bin/commands/createViews.js +196 -0
  6. package/dist/esm/bin/commands/createViews.js.map +1 -0
  7. package/dist/esm/bin/commands/dev.js +430 -0
  8. package/dist/esm/bin/commands/dev.js.map +1 -0
  9. package/dist/esm/bin/commands/list.js +148 -0
  10. package/dist/esm/bin/commands/list.js.map +1 -0
  11. package/dist/esm/bin/commands/prune.js +223 -0
  12. package/dist/esm/bin/commands/prune.js.map +1 -0
  13. package/dist/esm/bin/commands/serve.js +198 -0
  14. package/dist/esm/bin/commands/serve.js.map +1 -0
  15. package/dist/esm/bin/commands/start.js +253 -0
  16. package/dist/esm/bin/commands/start.js.map +1 -0
  17. package/dist/esm/bin/isolatedController.js +200 -0
  18. package/dist/esm/bin/isolatedController.js.map +1 -0
  19. package/dist/esm/bin/isolatedWorker.js +146 -0
  20. package/dist/esm/bin/isolatedWorker.js.map +1 -0
  21. package/dist/esm/bin/ponder.js +137 -0
  22. package/dist/esm/bin/ponder.js.map +1 -0
  23. package/dist/esm/bin/utils/codegen.js +25 -0
  24. package/dist/esm/bin/utils/codegen.js.map +1 -0
  25. package/dist/esm/bin/utils/exit.js +100 -0
  26. package/dist/esm/bin/utils/exit.js.map +1 -0
  27. package/dist/esm/build/config.js +745 -0
  28. package/dist/esm/build/config.js.map +1 -0
  29. package/dist/esm/build/factory.js +82 -0
  30. package/dist/esm/build/factory.js.map +1 -0
  31. package/dist/esm/build/index.js +567 -0
  32. package/dist/esm/build/index.js.map +1 -0
  33. package/dist/esm/build/plugin.js +53 -0
  34. package/dist/esm/build/plugin.js.map +1 -0
  35. package/dist/esm/build/pre.js +83 -0
  36. package/dist/esm/build/pre.js.map +1 -0
  37. package/dist/esm/build/schema.js +202 -0
  38. package/dist/esm/build/schema.js.map +1 -0
  39. package/dist/esm/build/stacktrace.js +137 -0
  40. package/dist/esm/build/stacktrace.js.map +1 -0
  41. package/dist/esm/client/index.js +441 -0
  42. package/dist/esm/client/index.js.map +1 -0
  43. package/dist/esm/config/address.js +2 -0
  44. package/dist/esm/config/address.js.map +1 -0
  45. package/dist/esm/config/eventFilter.js +2 -0
  46. package/dist/esm/config/eventFilter.js.map +1 -0
  47. package/dist/esm/config/index.js +2 -0
  48. package/dist/esm/config/index.js.map +1 -0
  49. package/dist/esm/config/utilityTypes.js +2 -0
  50. package/dist/esm/config/utilityTypes.js.map +1 -0
  51. package/dist/esm/database/actions.js +445 -0
  52. package/dist/esm/database/actions.js.map +1 -0
  53. package/dist/esm/database/index.js +604 -0
  54. package/dist/esm/database/index.js.map +1 -0
  55. package/dist/esm/database/queryBuilder.js +314 -0
  56. package/dist/esm/database/queryBuilder.js.map +1 -0
  57. package/dist/esm/drizzle/bigint.js +38 -0
  58. package/dist/esm/drizzle/bigint.js.map +1 -0
  59. package/dist/esm/drizzle/bytes.js +47 -0
  60. package/dist/esm/drizzle/bytes.js.map +1 -0
  61. package/dist/esm/drizzle/hex.js +40 -0
  62. package/dist/esm/drizzle/hex.js.map +1 -0
  63. package/dist/esm/drizzle/index.js +28 -0
  64. package/dist/esm/drizzle/index.js.map +1 -0
  65. package/dist/esm/drizzle/json.js +123 -0
  66. package/dist/esm/drizzle/json.js.map +1 -0
  67. package/dist/esm/drizzle/kit/index.js +927 -0
  68. package/dist/esm/drizzle/kit/index.js.map +1 -0
  69. package/dist/esm/drizzle/onchain.js +184 -0
  70. package/dist/esm/drizzle/onchain.js.map +1 -0
  71. package/dist/esm/drizzle/text.js +61 -0
  72. package/dist/esm/drizzle/text.js.map +1 -0
  73. package/dist/esm/graphql/graphiql.html.js +59 -0
  74. package/dist/esm/graphql/graphiql.html.js.map +1 -0
  75. package/dist/esm/graphql/index.js +934 -0
  76. package/dist/esm/graphql/index.js.map +1 -0
  77. package/dist/esm/graphql/json.js +42 -0
  78. package/dist/esm/graphql/json.js.map +1 -0
  79. package/dist/esm/graphql/middleware.js +83 -0
  80. package/dist/esm/graphql/middleware.js.map +1 -0
  81. package/dist/esm/index.js +9 -0
  82. package/dist/esm/index.js.map +1 -0
  83. package/dist/esm/indexing/addStackTrace.js +54 -0
  84. package/dist/esm/indexing/addStackTrace.js.map +1 -0
  85. package/dist/esm/indexing/client.js +675 -0
  86. package/dist/esm/indexing/client.js.map +1 -0
  87. package/dist/esm/indexing/index.js +663 -0
  88. package/dist/esm/indexing/index.js.map +1 -0
  89. package/dist/esm/indexing/profile.js +584 -0
  90. package/dist/esm/indexing/profile.js.map +1 -0
  91. package/dist/esm/indexing-store/cache.js +666 -0
  92. package/dist/esm/indexing-store/cache.js.map +1 -0
  93. package/dist/esm/indexing-store/index.js +461 -0
  94. package/dist/esm/indexing-store/index.js.map +1 -0
  95. package/dist/esm/indexing-store/profile.js +428 -0
  96. package/dist/esm/indexing-store/profile.js.map +1 -0
  97. package/dist/esm/indexing-store/utils.js +111 -0
  98. package/dist/esm/indexing-store/utils.js.map +1 -0
  99. package/dist/esm/internal/common.js +2 -0
  100. package/dist/esm/internal/common.js.map +1 -0
  101. package/dist/esm/internal/errors.js +300 -0
  102. package/dist/esm/internal/errors.js.map +1 -0
  103. package/dist/esm/internal/logger.js +178 -0
  104. package/dist/esm/internal/logger.js.map +1 -0
  105. package/dist/esm/internal/metrics.js +1049 -0
  106. package/dist/esm/internal/metrics.js.map +1 -0
  107. package/dist/esm/internal/options.js +73 -0
  108. package/dist/esm/internal/options.js.map +1 -0
  109. package/dist/esm/internal/shutdown.js +24 -0
  110. package/dist/esm/internal/shutdown.js.map +1 -0
  111. package/dist/esm/internal/telemetry.js +200 -0
  112. package/dist/esm/internal/telemetry.js.map +1 -0
  113. package/dist/esm/internal/types.js +2 -0
  114. package/dist/esm/internal/types.js.map +1 -0
  115. package/dist/esm/rpc/actions.js +988 -0
  116. package/dist/esm/rpc/actions.js.map +1 -0
  117. package/dist/esm/rpc/http.js +130 -0
  118. package/dist/esm/rpc/http.js.map +1 -0
  119. package/dist/esm/rpc/index.js +749 -0
  120. package/dist/esm/rpc/index.js.map +1 -0
  121. package/dist/esm/runtime/events.js +664 -0
  122. package/dist/esm/runtime/events.js.map +1 -0
  123. package/dist/esm/runtime/filter.js +476 -0
  124. package/dist/esm/runtime/filter.js.map +1 -0
  125. package/dist/esm/runtime/fragments.js +478 -0
  126. package/dist/esm/runtime/fragments.js.map +1 -0
  127. package/dist/esm/runtime/historical.js +954 -0
  128. package/dist/esm/runtime/historical.js.map +1 -0
  129. package/dist/esm/runtime/index.js +316 -0
  130. package/dist/esm/runtime/index.js.map +1 -0
  131. package/dist/esm/runtime/init.js +12 -0
  132. package/dist/esm/runtime/init.js.map +1 -0
  133. package/dist/esm/runtime/isolated.js +464 -0
  134. package/dist/esm/runtime/isolated.js.map +1 -0
  135. package/dist/esm/runtime/multichain.js +511 -0
  136. package/dist/esm/runtime/multichain.js.map +1 -0
  137. package/dist/esm/runtime/omnichain.js +546 -0
  138. package/dist/esm/runtime/omnichain.js.map +1 -0
  139. package/dist/esm/runtime/realtime.js +722 -0
  140. package/dist/esm/runtime/realtime.js.map +1 -0
  141. package/dist/esm/server/error.js +56 -0
  142. package/dist/esm/server/error.js.map +1 -0
  143. package/dist/esm/server/index.js +121 -0
  144. package/dist/esm/server/index.js.map +1 -0
  145. package/dist/esm/sync-historical/index.js +703 -0
  146. package/dist/esm/sync-historical/index.js.map +1 -0
  147. package/dist/esm/sync-realtime/bloom.js +76 -0
  148. package/dist/esm/sync-realtime/bloom.js.map +1 -0
  149. package/dist/esm/sync-realtime/index.js +918 -0
  150. package/dist/esm/sync-realtime/index.js.map +1 -0
  151. package/dist/esm/sync-store/encode.js +105 -0
  152. package/dist/esm/sync-store/encode.js.map +1 -0
  153. package/dist/esm/sync-store/index.js +885 -0
  154. package/dist/esm/sync-store/index.js.map +1 -0
  155. package/dist/esm/sync-store/migrations.js +1595 -0
  156. package/dist/esm/sync-store/migrations.js.map +1 -0
  157. package/dist/esm/sync-store/schema.js +181 -0
  158. package/dist/esm/sync-store/schema.js.map +1 -0
  159. package/dist/esm/types/db.js +2 -0
  160. package/dist/esm/types/db.js.map +1 -0
  161. package/dist/esm/types/eth.js +2 -0
  162. package/dist/esm/types/eth.js.map +1 -0
  163. package/dist/esm/types/utils.js +2 -0
  164. package/dist/esm/types/utils.js.map +1 -0
  165. package/dist/esm/types/virtual.js +2 -0
  166. package/dist/esm/types/virtual.js.map +1 -0
  167. package/dist/esm/ui/app.js +157 -0
  168. package/dist/esm/ui/app.js.map +1 -0
  169. package/dist/esm/ui/index.js +29 -0
  170. package/dist/esm/ui/index.js.map +1 -0
  171. package/dist/esm/ui/patch.js +140 -0
  172. package/dist/esm/ui/patch.js.map +1 -0
  173. package/dist/esm/utils/abi.js +55 -0
  174. package/dist/esm/utils/abi.js.map +1 -0
  175. package/dist/esm/utils/bigint.js +37 -0
  176. package/dist/esm/utils/bigint.js.map +1 -0
  177. package/dist/esm/utils/chains.js +21 -0
  178. package/dist/esm/utils/chains.js.map +1 -0
  179. package/dist/esm/utils/checkpoint.js +139 -0
  180. package/dist/esm/utils/checkpoint.js.map +1 -0
  181. package/dist/esm/utils/chunk.js +8 -0
  182. package/dist/esm/utils/chunk.js.map +1 -0
  183. package/dist/esm/utils/copy.js +129 -0
  184. package/dist/esm/utils/copy.js.map +1 -0
  185. package/dist/esm/utils/date.js +27 -0
  186. package/dist/esm/utils/date.js.map +1 -0
  187. package/dist/esm/utils/debug.js +2 -0
  188. package/dist/esm/utils/debug.js.map +1 -0
  189. package/dist/esm/utils/decodeAbiParameters.js +290 -0
  190. package/dist/esm/utils/decodeAbiParameters.js.map +1 -0
  191. package/dist/esm/utils/decodeEventLog.js +75 -0
  192. package/dist/esm/utils/decodeEventLog.js.map +1 -0
  193. package/dist/esm/utils/dedupe.js +29 -0
  194. package/dist/esm/utils/dedupe.js.map +1 -0
  195. package/dist/esm/utils/duplicates.js +19 -0
  196. package/dist/esm/utils/duplicates.js.map +1 -0
  197. package/dist/esm/utils/estimate.js +6 -0
  198. package/dist/esm/utils/estimate.js.map +1 -0
  199. package/dist/esm/utils/finality.js +38 -0
  200. package/dist/esm/utils/finality.js.map +1 -0
  201. package/dist/esm/utils/format.js +20 -0
  202. package/dist/esm/utils/format.js.map +1 -0
  203. package/dist/esm/utils/generators.js +121 -0
  204. package/dist/esm/utils/generators.js.map +1 -0
  205. package/dist/esm/utils/hash.js +11 -0
  206. package/dist/esm/utils/hash.js.map +1 -0
  207. package/dist/esm/utils/interval.js +171 -0
  208. package/dist/esm/utils/interval.js.map +1 -0
  209. package/dist/esm/utils/lowercase.js +7 -0
  210. package/dist/esm/utils/lowercase.js.map +1 -0
  211. package/dist/esm/utils/mutex.js +26 -0
  212. package/dist/esm/utils/mutex.js.map +1 -0
  213. package/dist/esm/utils/never.js +4 -0
  214. package/dist/esm/utils/never.js.map +1 -0
  215. package/dist/esm/utils/offset.js +101 -0
  216. package/dist/esm/utils/offset.js.map +1 -0
  217. package/dist/esm/utils/order.js +18 -0
  218. package/dist/esm/utils/order.js.map +1 -0
  219. package/dist/esm/utils/partition.js +46 -0
  220. package/dist/esm/utils/partition.js.map +1 -0
  221. package/dist/esm/utils/pg.js +175 -0
  222. package/dist/esm/utils/pg.js.map +1 -0
  223. package/dist/esm/utils/pglite.js +80 -0
  224. package/dist/esm/utils/pglite.js.map +1 -0
  225. package/dist/esm/utils/port.js +30 -0
  226. package/dist/esm/utils/port.js.map +1 -0
  227. package/dist/esm/utils/print.js +23 -0
  228. package/dist/esm/utils/print.js.map +1 -0
  229. package/dist/esm/utils/promiseAllSettledWithThrow.js +19 -0
  230. package/dist/esm/utils/promiseAllSettledWithThrow.js.map +1 -0
  231. package/dist/esm/utils/promiseWithResolvers.js +13 -0
  232. package/dist/esm/utils/promiseWithResolvers.js.map +1 -0
  233. package/dist/esm/utils/queue.js +150 -0
  234. package/dist/esm/utils/queue.js.map +1 -0
  235. package/dist/esm/utils/range.js +8 -0
  236. package/dist/esm/utils/range.js.map +1 -0
  237. package/dist/esm/utils/result.js +10 -0
  238. package/dist/esm/utils/result.js.map +1 -0
  239. package/dist/esm/utils/sql-parse.js +1326 -0
  240. package/dist/esm/utils/sql-parse.js.map +1 -0
  241. package/dist/esm/utils/timer.js +9 -0
  242. package/dist/esm/utils/timer.js.map +1 -0
  243. package/dist/esm/utils/truncate.js +15 -0
  244. package/dist/esm/utils/truncate.js.map +1 -0
  245. package/dist/esm/utils/wait.js +10 -0
  246. package/dist/esm/utils/wait.js.map +1 -0
  247. package/dist/esm/utils/zipper.js +67 -0
  248. package/dist/esm/utils/zipper.js.map +1 -0
  249. package/dist/types/bin/commands/codegen.d.ts +5 -0
  250. package/dist/types/bin/commands/codegen.d.ts.map +1 -0
  251. package/dist/types/bin/commands/createViews.d.ts +8 -0
  252. package/dist/types/bin/commands/createViews.d.ts.map +1 -0
  253. package/dist/types/bin/commands/dev.d.ts +5 -0
  254. package/dist/types/bin/commands/dev.d.ts.map +1 -0
  255. package/dist/types/bin/commands/list.d.ts +5 -0
  256. package/dist/types/bin/commands/list.d.ts.map +1 -0
  257. package/dist/types/bin/commands/prune.d.ts +5 -0
  258. package/dist/types/bin/commands/prune.d.ts.map +1 -0
  259. package/dist/types/bin/commands/serve.d.ts +5 -0
  260. package/dist/types/bin/commands/serve.d.ts.map +1 -0
  261. package/dist/types/bin/commands/start.d.ts +19 -0
  262. package/dist/types/bin/commands/start.d.ts.map +1 -0
  263. package/dist/types/bin/isolatedController.d.ts +13 -0
  264. package/dist/types/bin/isolatedController.d.ts.map +1 -0
  265. package/dist/types/bin/isolatedWorker.d.ts +9 -0
  266. package/dist/types/bin/isolatedWorker.d.ts.map +1 -0
  267. package/dist/types/bin/ponder.d.ts +37 -0
  268. package/dist/types/bin/ponder.d.ts.map +1 -0
  269. package/dist/types/bin/utils/codegen.d.ts +6 -0
  270. package/dist/types/bin/utils/codegen.d.ts.map +1 -0
  271. package/dist/types/bin/utils/exit.d.ts +10 -0
  272. package/dist/types/bin/utils/exit.d.ts.map +1 -0
  273. package/dist/types/build/config.d.ts +97 -0
  274. package/dist/types/build/config.d.ts.map +1 -0
  275. package/dist/types/build/factory.d.ts +15 -0
  276. package/dist/types/build/factory.d.ts.map +1 -0
  277. package/dist/types/build/index.d.ts +84 -0
  278. package/dist/types/build/index.d.ts.map +1 -0
  279. package/dist/types/build/plugin.d.ts +4 -0
  280. package/dist/types/build/plugin.d.ts.map +1 -0
  281. package/dist/types/build/pre.d.ts +29 -0
  282. package/dist/types/build/pre.d.ts.map +1 -0
  283. package/dist/types/build/schema.d.ts +20 -0
  284. package/dist/types/build/schema.d.ts.map +1 -0
  285. package/dist/types/build/stacktrace.d.ts +13 -0
  286. package/dist/types/build/stacktrace.d.ts.map +1 -0
  287. package/dist/types/client/index.d.ts +27 -0
  288. package/dist/types/client/index.d.ts.map +1 -0
  289. package/dist/types/config/address.d.ts +34 -0
  290. package/dist/types/config/address.d.ts.map +1 -0
  291. package/dist/types/config/eventFilter.d.ts +18 -0
  292. package/dist/types/config/eventFilter.d.ts.map +1 -0
  293. package/dist/types/config/index.d.ts +144 -0
  294. package/dist/types/config/index.d.ts.map +1 -0
  295. package/dist/types/config/utilityTypes.d.ts +43 -0
  296. package/dist/types/config/utilityTypes.d.ts.map +1 -0
  297. package/dist/types/database/actions.d.ts +99 -0
  298. package/dist/types/database/actions.d.ts.map +1 -0
  299. package/dist/types/database/index.d.ts +493 -0
  300. package/dist/types/database/index.d.ts.map +1 -0
  301. package/dist/types/database/queryBuilder.d.ts +65 -0
  302. package/dist/types/database/queryBuilder.d.ts.map +1 -0
  303. package/dist/types/drizzle/bigint.d.ts +25 -0
  304. package/dist/types/drizzle/bigint.d.ts.map +1 -0
  305. package/dist/types/drizzle/bytes.d.ts +31 -0
  306. package/dist/types/drizzle/bytes.d.ts.map +1 -0
  307. package/dist/types/drizzle/hex.d.ts +25 -0
  308. package/dist/types/drizzle/hex.d.ts.map +1 -0
  309. package/dist/types/drizzle/index.d.ts +6 -0
  310. package/dist/types/drizzle/index.d.ts.map +1 -0
  311. package/dist/types/drizzle/json.d.ts +51 -0
  312. package/dist/types/drizzle/json.d.ts.map +1 -0
  313. package/dist/types/drizzle/kit/index.d.ts +187 -0
  314. package/dist/types/drizzle/kit/index.d.ts.map +1 -0
  315. package/dist/types/drizzle/onchain.d.ts +298 -0
  316. package/dist/types/drizzle/onchain.d.ts.map +1 -0
  317. package/dist/types/drizzle/text.d.ts +29 -0
  318. package/dist/types/drizzle/text.d.ts.map +1 -0
  319. package/dist/types/graphql/graphiql.html.d.ts +2 -0
  320. package/dist/types/graphql/graphiql.html.d.ts.map +1 -0
  321. package/dist/types/graphql/index.d.ts +12 -0
  322. package/dist/types/graphql/index.d.ts.map +1 -0
  323. package/dist/types/graphql/json.d.ts +3 -0
  324. package/dist/types/graphql/json.d.ts.map +1 -0
  325. package/dist/types/graphql/middleware.d.ts +29 -0
  326. package/dist/types/graphql/middleware.d.ts.map +1 -0
  327. package/dist/types/index.d.ts +23 -0
  328. package/dist/types/index.d.ts.map +1 -0
  329. package/dist/types/indexing/addStackTrace.d.ts +3 -0
  330. package/dist/types/indexing/addStackTrace.d.ts.map +1 -0
  331. package/dist/types/indexing/client.d.ts +154 -0
  332. package/dist/types/indexing/client.d.ts.map +1 -0
  333. package/dist/types/indexing/index.d.ts +72 -0
  334. package/dist/types/indexing/index.d.ts.map +1 -0
  335. package/dist/types/indexing/profile.d.ts +16 -0
  336. package/dist/types/indexing/profile.d.ts.map +1 -0
  337. package/dist/types/indexing-store/cache.d.ts +115 -0
  338. package/dist/types/indexing-store/cache.d.ts.map +1 -0
  339. package/dist/types/indexing-store/index.d.ts +24 -0
  340. package/dist/types/indexing-store/index.d.ts.map +1 -0
  341. package/dist/types/indexing-store/profile.d.ts +7 -0
  342. package/dist/types/indexing-store/profile.d.ts.map +1 -0
  343. package/dist/types/indexing-store/utils.d.ts +19 -0
  344. package/dist/types/indexing-store/utils.d.ts.map +1 -0
  345. package/dist/types/internal/common.d.ts +15 -0
  346. package/dist/types/internal/common.d.ts.map +1 -0
  347. package/dist/types/internal/errors.d.ts +101 -0
  348. package/dist/types/internal/errors.d.ts.map +1 -0
  349. package/dist/types/internal/logger.d.ts +37 -0
  350. package/dist/types/internal/logger.d.ts.map +1 -0
  351. package/dist/types/internal/metrics.d.ts +120 -0
  352. package/dist/types/internal/metrics.d.ts.map +1 -0
  353. package/dist/types/internal/options.d.ts +62 -0
  354. package/dist/types/internal/options.d.ts.map +1 -0
  355. package/dist/types/internal/shutdown.d.ts +8 -0
  356. package/dist/types/internal/shutdown.d.ts.map +1 -0
  357. package/dist/types/internal/telemetry.d.ts +43 -0
  358. package/dist/types/internal/telemetry.d.ts.map +1 -0
  359. package/dist/types/internal/types.d.ts +443 -0
  360. package/dist/types/internal/types.d.ts.map +1 -0
  361. package/dist/types/rpc/actions.d.ts +360 -0
  362. package/dist/types/rpc/actions.d.ts.map +1 -0
  363. package/dist/types/rpc/http.d.ts +17 -0
  364. package/dist/types/rpc/http.d.ts.map +1 -0
  365. package/dist/types/rpc/index.d.ts +43 -0
  366. package/dist/types/rpc/index.d.ts.map +1 -0
  367. package/dist/types/runtime/events.d.ts +40 -0
  368. package/dist/types/runtime/events.d.ts.map +1 -0
  369. package/dist/types/runtime/filter.d.ts +96 -0
  370. package/dist/types/runtime/filter.d.ts.map +1 -0
  371. package/dist/types/runtime/fragments.d.ts +30 -0
  372. package/dist/types/runtime/fragments.d.ts.map +1 -0
  373. package/dist/types/runtime/historical.d.ts +123 -0
  374. package/dist/types/runtime/historical.d.ts.map +1 -0
  375. package/dist/types/runtime/index.d.ts +89 -0
  376. package/dist/types/runtime/index.d.ts.map +1 -0
  377. package/dist/types/runtime/init.d.ts +28 -0
  378. package/dist/types/runtime/init.d.ts.map +1 -0
  379. package/dist/types/runtime/isolated.d.ts +14 -0
  380. package/dist/types/runtime/isolated.d.ts.map +1 -0
  381. package/dist/types/runtime/multichain.d.ts +13 -0
  382. package/dist/types/runtime/multichain.d.ts.map +1 -0
  383. package/dist/types/runtime/omnichain.d.ts +23 -0
  384. package/dist/types/runtime/omnichain.d.ts.map +1 -0
  385. package/dist/types/runtime/realtime.d.ts +93 -0
  386. package/dist/types/runtime/realtime.d.ts.map +1 -0
  387. package/dist/types/server/error.d.ts +5 -0
  388. package/dist/types/server/error.d.ts.map +1 -0
  389. package/dist/types/server/index.d.ts +13 -0
  390. package/dist/types/server/index.d.ts.map +1 -0
  391. package/dist/types/sync-historical/index.d.ts +36 -0
  392. package/dist/types/sync-historical/index.d.ts.map +1 -0
  393. package/dist/types/sync-realtime/bloom.d.ts +18 -0
  394. package/dist/types/sync-realtime/bloom.d.ts.map +1 -0
  395. package/dist/types/sync-realtime/index.d.ts +48 -0
  396. package/dist/types/sync-realtime/index.d.ts.map +1 -0
  397. package/dist/types/sync-store/encode.d.ts +25 -0
  398. package/dist/types/sync-store/encode.d.ts.map +1 -0
  399. package/dist/types/sync-store/index.d.ts +135 -0
  400. package/dist/types/sync-store/index.d.ts.map +1 -0
  401. package/dist/types/sync-store/migrations.d.ts +8 -0
  402. package/dist/types/sync-store/migrations.d.ts.map +1 -0
  403. package/dist/types/sync-store/schema.d.ts +1828 -0
  404. package/dist/types/sync-store/schema.d.ts.map +1 -0
  405. package/dist/types/types/db.d.ts +213 -0
  406. package/dist/types/types/db.d.ts.map +1 -0
  407. package/dist/types/types/eth.d.ts +196 -0
  408. package/dist/types/types/eth.d.ts.map +1 -0
  409. package/dist/types/types/utils.d.ts +38 -0
  410. package/dist/types/types/utils.d.ts.map +1 -0
  411. package/dist/types/types/virtual.d.ts +99 -0
  412. package/dist/types/types/virtual.d.ts.map +1 -0
  413. package/dist/types/ui/app.d.ts +22 -0
  414. package/dist/types/ui/app.d.ts.map +1 -0
  415. package/dist/types/ui/index.d.ts +5 -0
  416. package/dist/types/ui/index.d.ts.map +1 -0
  417. package/dist/types/ui/patch.d.ts +7 -0
  418. package/dist/types/ui/patch.d.ts.map +1 -0
  419. package/dist/types/utils/abi.d.ts +23 -0
  420. package/dist/types/utils/abi.d.ts.map +1 -0
  421. package/dist/types/utils/bigint.d.ts +15 -0
  422. package/dist/types/utils/bigint.d.ts.map +1 -0
  423. package/dist/types/utils/chains.d.ts +42 -0
  424. package/dist/types/utils/chains.d.ts.map +1 -0
  425. package/dist/types/utils/checkpoint.d.ts +52 -0
  426. package/dist/types/utils/checkpoint.d.ts.map +1 -0
  427. package/dist/types/utils/chunk.d.ts +2 -0
  428. package/dist/types/utils/chunk.d.ts.map +1 -0
  429. package/dist/types/utils/copy.d.ts +16 -0
  430. package/dist/types/utils/copy.d.ts.map +1 -0
  431. package/dist/types/utils/date.d.ts +7 -0
  432. package/dist/types/utils/date.d.ts.map +1 -0
  433. package/dist/types/utils/debug.d.ts +105 -0
  434. package/dist/types/utils/debug.d.ts.map +1 -0
  435. package/dist/types/utils/decodeAbiParameters.d.ts +28 -0
  436. package/dist/types/utils/decodeAbiParameters.d.ts.map +1 -0
  437. package/dist/types/utils/decodeEventLog.d.ts +12 -0
  438. package/dist/types/utils/decodeEventLog.d.ts.map +1 -0
  439. package/dist/types/utils/dedupe.d.ts +20 -0
  440. package/dist/types/utils/dedupe.d.ts.map +1 -0
  441. package/dist/types/utils/duplicates.d.ts +7 -0
  442. package/dist/types/utils/duplicates.d.ts.map +1 -0
  443. package/dist/types/utils/estimate.d.ts +11 -0
  444. package/dist/types/utils/estimate.d.ts.map +1 -0
  445. package/dist/types/utils/finality.d.ts +12 -0
  446. package/dist/types/utils/finality.d.ts.map +1 -0
  447. package/dist/types/utils/format.d.ts +3 -0
  448. package/dist/types/utils/format.d.ts.map +1 -0
  449. package/dist/types/utils/generators.d.ts +42 -0
  450. package/dist/types/utils/generators.d.ts.map +1 -0
  451. package/dist/types/utils/hash.d.ts +11 -0
  452. package/dist/types/utils/hash.d.ts.map +1 -0
  453. package/dist/types/utils/interval.d.ts +53 -0
  454. package/dist/types/utils/interval.d.ts.map +1 -0
  455. package/dist/types/utils/lowercase.d.ts +5 -0
  456. package/dist/types/utils/lowercase.d.ts.map +1 -0
  457. package/dist/types/utils/mutex.d.ts +5 -0
  458. package/dist/types/utils/mutex.d.ts.map +1 -0
  459. package/dist/types/utils/never.d.ts +2 -0
  460. package/dist/types/utils/never.d.ts.map +1 -0
  461. package/dist/types/utils/offset.d.ts +8 -0
  462. package/dist/types/utils/offset.d.ts.map +1 -0
  463. package/dist/types/utils/order.d.ts +2 -0
  464. package/dist/types/utils/order.d.ts.map +1 -0
  465. package/dist/types/utils/partition.d.ts +22 -0
  466. package/dist/types/utils/partition.d.ts.map +1 -0
  467. package/dist/types/utils/pg.d.ts +8 -0
  468. package/dist/types/utils/pg.d.ts.map +1 -0
  469. package/dist/types/utils/pglite.d.ts +25 -0
  470. package/dist/types/utils/pglite.d.ts.map +1 -0
  471. package/dist/types/utils/port.d.ts +5 -0
  472. package/dist/types/utils/port.d.ts.map +1 -0
  473. package/dist/types/utils/print.d.ts +2 -0
  474. package/dist/types/utils/print.d.ts.map +1 -0
  475. package/dist/types/utils/promiseAllSettledWithThrow.d.ts +8 -0
  476. package/dist/types/utils/promiseAllSettledWithThrow.d.ts.map +1 -0
  477. package/dist/types/utils/promiseWithResolvers.d.ts +10 -0
  478. package/dist/types/utils/promiseWithResolvers.d.ts.map +1 -0
  479. package/dist/types/utils/queue.d.ts +33 -0
  480. package/dist/types/utils/queue.d.ts.map +1 -0
  481. package/dist/types/utils/range.d.ts +8 -0
  482. package/dist/types/utils/range.d.ts.map +1 -0
  483. package/dist/types/utils/result.d.ts +17 -0
  484. package/dist/types/utils/result.d.ts.map +1 -0
  485. package/dist/types/utils/sql-parse.d.ts +21 -0
  486. package/dist/types/utils/sql-parse.d.ts.map +1 -0
  487. package/dist/types/utils/timer.d.ts +6 -0
  488. package/dist/types/utils/timer.d.ts.map +1 -0
  489. package/dist/types/utils/truncate.d.ts +9 -0
  490. package/dist/types/utils/truncate.d.ts.map +1 -0
  491. package/dist/types/utils/wait.d.ts +6 -0
  492. package/dist/types/utils/wait.d.ts.map +1 -0
  493. package/dist/types/utils/zipper.d.ts +36 -0
  494. package/dist/types/utils/zipper.d.ts.map +1 -0
  495. package/package.json +114 -0
  496. package/src/bin/commands/codegen.ts +56 -0
  497. package/src/bin/commands/createViews.ts +318 -0
  498. package/src/bin/commands/dev.ts +490 -0
  499. package/src/bin/commands/list.ts +208 -0
  500. package/src/bin/commands/prune.ts +322 -0
  501. package/src/bin/commands/serve.ts +236 -0
  502. package/src/bin/commands/start.ts +319 -0
  503. package/src/bin/isolatedController.ts +300 -0
  504. package/src/bin/isolatedWorker.ts +192 -0
  505. package/src/bin/ponder.ts +208 -0
  506. package/src/bin/utils/codegen.ts +32 -0
  507. package/src/bin/utils/exit.ts +112 -0
  508. package/src/build/config.ts +1141 -0
  509. package/src/build/factory.ts +147 -0
  510. package/src/build/index.ts +790 -0
  511. package/src/build/plugin.ts +58 -0
  512. package/src/build/pre.ts +114 -0
  513. package/src/build/schema.ts +358 -0
  514. package/src/build/stacktrace.ts +137 -0
  515. package/src/client/index.ts +551 -0
  516. package/src/config/address.ts +45 -0
  517. package/src/config/eventFilter.ts +33 -0
  518. package/src/config/index.ts +240 -0
  519. package/src/config/utilityTypes.ts +152 -0
  520. package/src/database/actions.ts +873 -0
  521. package/src/database/index.ts +1029 -0
  522. package/src/database/queryBuilder.ts +537 -0
  523. package/src/drizzle/bigint.ts +57 -0
  524. package/src/drizzle/bytes.ts +68 -0
  525. package/src/drizzle/hex.ts +58 -0
  526. package/src/drizzle/index.ts +40 -0
  527. package/src/drizzle/json.ts +159 -0
  528. package/src/drizzle/kit/index.ts +1348 -0
  529. package/src/drizzle/onchain.ts +476 -0
  530. package/src/drizzle/text.ts +77 -0
  531. package/src/graphql/graphiql.html.ts +59 -0
  532. package/src/graphql/index.ts +1351 -0
  533. package/src/graphql/json.ts +62 -0
  534. package/src/graphql/middleware.ts +115 -0
  535. package/src/index.ts +139 -0
  536. package/src/indexing/addStackTrace.ts +69 -0
  537. package/src/indexing/client.ts +1184 -0
  538. package/src/indexing/index.ts +976 -0
  539. package/src/indexing/profile.ts +771 -0
  540. package/src/indexing-store/cache.ts +1057 -0
  541. package/src/indexing-store/index.ts +628 -0
  542. package/src/indexing-store/profile.ts +557 -0
  543. package/src/indexing-store/utils.ts +162 -0
  544. package/src/internal/common.ts +15 -0
  545. package/src/internal/errors.ts +228 -0
  546. package/src/internal/logger.ts +252 -0
  547. package/src/internal/metrics.ts +1030 -0
  548. package/src/internal/options.ts +130 -0
  549. package/src/internal/shutdown.ts +32 -0
  550. package/src/internal/telemetry.ts +303 -0
  551. package/src/internal/types.ts +611 -0
  552. package/src/rpc/actions.ts +1344 -0
  553. package/src/rpc/http.ts +164 -0
  554. package/src/rpc/index.ts +959 -0
  555. package/src/runtime/events.ts +875 -0
  556. package/src/runtime/filter.ts +705 -0
  557. package/src/runtime/fragments.ts +674 -0
  558. package/src/runtime/historical.ts +1522 -0
  559. package/src/runtime/index.ts +569 -0
  560. package/src/runtime/init.ts +49 -0
  561. package/src/runtime/isolated.ts +775 -0
  562. package/src/runtime/multichain.ts +860 -0
  563. package/src/runtime/omnichain.ts +920 -0
  564. package/src/runtime/realtime.ts +1164 -0
  565. package/src/server/error.ts +68 -0
  566. package/src/server/index.ts +173 -0
  567. package/src/sync-historical/index.ts +1065 -0
  568. package/src/sync-realtime/bloom.ts +102 -0
  569. package/src/sync-realtime/index.ts +1304 -0
  570. package/src/sync-store/encode.ts +153 -0
  571. package/src/sync-store/index.ts +1633 -0
  572. package/src/sync-store/migrations.ts +1801 -0
  573. package/src/sync-store/schema.ts +248 -0
  574. package/src/types/db.ts +292 -0
  575. package/src/types/eth.ts +216 -0
  576. package/src/types/utils.ts +47 -0
  577. package/src/types/virtual.ts +244 -0
  578. package/src/types.d.ts +38 -0
  579. package/src/ui/app.ts +207 -0
  580. package/src/ui/index.ts +37 -0
  581. package/src/ui/patch.ts +204 -0
  582. package/src/utils/abi.ts +103 -0
  583. package/src/utils/bigint.ts +41 -0
  584. package/src/utils/chains.ts +22 -0
  585. package/src/utils/checkpoint.ts +203 -0
  586. package/src/utils/chunk.ts +7 -0
  587. package/src/utils/copy.ts +151 -0
  588. package/src/utils/date.ts +26 -0
  589. package/src/utils/debug.ts +110 -0
  590. package/src/utils/decodeAbiParameters.ts +428 -0
  591. package/src/utils/decodeEventLog.ts +100 -0
  592. package/src/utils/dedupe.ts +32 -0
  593. package/src/utils/duplicates.ts +19 -0
  594. package/src/utils/estimate.ts +27 -0
  595. package/src/utils/finality.ts +40 -0
  596. package/src/utils/format.ts +22 -0
  597. package/src/utils/generators.ts +157 -0
  598. package/src/utils/hash.ts +22 -0
  599. package/src/utils/interval.ts +212 -0
  600. package/src/utils/lowercase.ts +6 -0
  601. package/src/utils/mutex.ts +33 -0
  602. package/src/utils/never.ts +3 -0
  603. package/src/utils/offset.ts +133 -0
  604. package/src/utils/order.ts +16 -0
  605. package/src/utils/partition.ts +53 -0
  606. package/src/utils/pg.ts +230 -0
  607. package/src/utils/pglite.ts +97 -0
  608. package/src/utils/port.ts +34 -0
  609. package/src/utils/print.ts +31 -0
  610. package/src/utils/promiseAllSettledWithThrow.ts +27 -0
  611. package/src/utils/promiseWithResolvers.ts +20 -0
  612. package/src/utils/queue.ts +258 -0
  613. package/src/utils/range.ts +8 -0
  614. package/src/utils/result.ts +26 -0
  615. package/src/utils/sql-parse.ts +1477 -0
  616. package/src/utils/timer.ts +8 -0
  617. package/src/utils/truncate.ts +15 -0
  618. package/src/utils/wait.ts +8 -0
  619. package/src/utils/zipper.ts +80 -0
@@ -0,0 +1,749 @@
1
+ import crypto, {} from "node:crypto";
2
+ import url from "node:url";
3
+ import { eth_getBlockByNumber, standardizeBlock } from './actions.js';
4
+ import { createQueue } from '../utils/queue.js';
5
+ import { startClock } from '../utils/timer.js';
6
+ import { wait } from '../utils/wait.js';
7
+ import { getLogsRetryHelper, } from "@ponder/utils";
8
+ import { BlockNotFoundError, HttpRequestError, JsonRpcVersionUnsupportedError, MethodNotFoundRpcError, MethodNotSupportedRpcError, ParseRpcError, TimeoutError, custom, hexToNumber, isHex, webSocket, } from "viem";
9
+ import { WebSocket } from "ws";
10
+ import { getHttpRpcClient } from "./http.js";
11
+ const RETRY_COUNT = 9;
12
+ const BASE_DURATION = 125;
13
+ const INITIAL_REACTIVATION_DELAY = 100;
14
+ const MAX_REACTIVATION_DELAY = 5000;
15
+ const BACKOFF_FACTOR = 1.5;
16
+ const LATENCY_WINDOW_SIZE = 500;
17
+ /** Hurdle rate for switching to a faster bucket. */
18
+ const LATENCY_HURDLE_RATE = 0.1;
19
+ /** Exploration rate. */
20
+ const EPSILON = 0.1;
21
+ const INITIAL_MAX_RPS = 20;
22
+ const MIN_RPS = 3;
23
+ const MAX_RPS = 500;
24
+ const RPS_INCREASE_FACTOR = 1.05;
25
+ const RPS_DECREASE_FACTOR = 0.95;
26
+ const RPS_INCREASE_QUALIFIER = 0.9;
27
+ const SUCCESS_MULTIPLIER = 5;
28
+ const addLatency = (bucket, latency, success) => {
29
+ bucket.latencyMetadata.latencies.push({ value: latency, success });
30
+ bucket.latencyMetadata.latencySum += latency;
31
+ if (success) {
32
+ bucket.latencyMetadata.successfulLatencies++;
33
+ }
34
+ if (bucket.latencyMetadata.latencies.length > LATENCY_WINDOW_SIZE) {
35
+ const record = bucket.latencyMetadata.latencies.shift();
36
+ bucket.latencyMetadata.latencySum -= record.value;
37
+ if (record.success) {
38
+ bucket.latencyMetadata.successfulLatencies--;
39
+ }
40
+ }
41
+ bucket.expectedLatency =
42
+ bucket.latencyMetadata.latencySum /
43
+ bucket.latencyMetadata.successfulLatencies;
44
+ };
45
+ /**
46
+ * Return `true` if the bucket is available to send a request.
47
+ */
48
+ const isAvailable = (bucket) => {
49
+ if (bucket.isActive === false)
50
+ return false;
51
+ const now = Math.floor(Date.now() / 1000);
52
+ const currentRPS = bucket.rps.find((r) => r.timestamp === now);
53
+ if (currentRPS && currentRPS.count + 1 > bucket.rpsLimit) {
54
+ return false;
55
+ }
56
+ if (bucket.rps.length > 0 && bucket.rps[0].timestamp < now) {
57
+ const elapsed = now - bucket.rps[0].timestamp;
58
+ const totalCount = bucket.rps.reduce((acc, rps) => acc + rps.count, 0);
59
+ if (totalCount > bucket.rpsLimit * (1 + elapsed)) {
60
+ return false;
61
+ }
62
+ }
63
+ if (bucket.isWarmingUp && bucket.activeConnections > 3) {
64
+ return false;
65
+ }
66
+ return true;
67
+ };
68
+ export const createRpc = ({ common, chain, concurrency = 25, }) => {
69
+ let backends;
70
+ let requestId;
71
+ if (typeof chain.rpc === "string") {
72
+ const protocol = new url.URL(chain.rpc).protocol;
73
+ const hostname = new url.URL(chain.rpc).hostname;
74
+ if (protocol === "https:" || protocol === "http:") {
75
+ const httpRpcClient = getHttpRpcClient(chain.rpc, {
76
+ common,
77
+ chain,
78
+ timeout: 10000,
79
+ });
80
+ backends = [
81
+ {
82
+ request: custom({
83
+ request(body) {
84
+ if (requestId) {
85
+ return httpRpcClient.request({
86
+ body,
87
+ fetchOptions: { headers: { "X-Request-ID": requestId } },
88
+ });
89
+ }
90
+ return httpRpcClient.request({ body });
91
+ },
92
+ })({
93
+ chain: chain.viemChain,
94
+ retryCount: 0,
95
+ }).request,
96
+ hostname,
97
+ },
98
+ ];
99
+ }
100
+ else if (protocol === "wss:" || protocol === "ws:") {
101
+ backends = [
102
+ {
103
+ request: webSocket(chain.rpc)({
104
+ chain: chain.viemChain,
105
+ retryCount: 0,
106
+ timeout: 10000,
107
+ }).request,
108
+ hostname,
109
+ },
110
+ ];
111
+ }
112
+ else {
113
+ throw new Error(`Unsupported RPC URL protocol: ${protocol}`);
114
+ }
115
+ }
116
+ else if (Array.isArray(chain.rpc)) {
117
+ backends = chain.rpc.map((rpc) => {
118
+ const protocol = new url.URL(rpc).protocol;
119
+ const hostname = new url.URL(chain.rpc).hostname;
120
+ if (protocol === "https:" || protocol === "http:") {
121
+ const httpRpcClient = getHttpRpcClient(rpc, {
122
+ common,
123
+ chain,
124
+ timeout: 10000,
125
+ });
126
+ return {
127
+ request: custom({
128
+ request(body) {
129
+ if (requestId) {
130
+ return httpRpcClient.request({
131
+ body,
132
+ fetchOptions: { headers: { "X-Request-ID": requestId } },
133
+ });
134
+ }
135
+ return httpRpcClient.request({ body });
136
+ },
137
+ })({
138
+ chain: chain.viemChain,
139
+ retryCount: 0,
140
+ }).request,
141
+ hostname,
142
+ };
143
+ }
144
+ else if (protocol === "wss:" || protocol === "ws:") {
145
+ return {
146
+ request: webSocket(rpc)({
147
+ chain: chain.viemChain,
148
+ retryCount: 0,
149
+ timeout: 10000,
150
+ }).request,
151
+ hostname,
152
+ };
153
+ }
154
+ else {
155
+ throw new Error(`Unsupported RPC URL protocol: ${protocol}`);
156
+ }
157
+ });
158
+ }
159
+ else {
160
+ backends = [
161
+ {
162
+ request: chain.rpc({
163
+ chain: chain.viemChain,
164
+ retryCount: 0,
165
+ timeout: 10000,
166
+ }).request,
167
+ hostname: "custom_transport",
168
+ },
169
+ ];
170
+ }
171
+ if (typeof chain.ws === "string") {
172
+ const protocol = new url.URL(chain.ws).protocol;
173
+ if (protocol !== "wss:" && protocol !== "ws:") {
174
+ throw new Error(`Inconsistent RPC URL protocol: ${protocol}. Expected wss or ws.`);
175
+ }
176
+ }
177
+ const buckets = backends.map(({ request, hostname }, index) => ({
178
+ index,
179
+ hostname,
180
+ reactivationDelay: INITIAL_REACTIVATION_DELAY,
181
+ activeConnections: 0,
182
+ isActive: true,
183
+ isWarmingUp: false,
184
+ latencyMetadata: {
185
+ latencies: [],
186
+ successfulLatencies: 0,
187
+ latencySum: 0,
188
+ },
189
+ expectedLatency: 200,
190
+ rps: [],
191
+ consecutiveSuccessfulRequests: 0,
192
+ rpsLimit: INITIAL_MAX_RPS,
193
+ request,
194
+ }));
195
+ let noAvailableBucketsTimer;
196
+ /** Tracks all active bucket reactivation timeouts to cleanup during shutdown */
197
+ const timeouts = new Set();
198
+ const scheduleBucketActivation = (bucket) => {
199
+ const delay = bucket.reactivationDelay;
200
+ const timeoutId = setTimeout(() => {
201
+ bucket.isActive = true;
202
+ bucket.isWarmingUp = true;
203
+ timeouts.delete(timeoutId);
204
+ common.logger.debug({
205
+ msg: "JSON-RPC provider reactivated after rate limiting",
206
+ chain: chain.name,
207
+ chain_id: chain.id,
208
+ hostname: bucket.hostname,
209
+ retry_delay: Math.round(delay),
210
+ });
211
+ }, delay);
212
+ common.logger.debug({
213
+ msg: "JSON-RPC provider deactivated due to rate limiting",
214
+ chain: chain.name,
215
+ chain_id: chain.id,
216
+ hostname: bucket.hostname,
217
+ retry_delay: Math.round(delay),
218
+ });
219
+ timeouts.add(timeoutId);
220
+ };
221
+ const getBucket = async () => {
222
+ let availableBuckets;
223
+ // Note: wait for the next event loop to ensure that the bucket rps are updated
224
+ await new Promise((resolve) => setImmediate(resolve));
225
+ while (true) {
226
+ // Remove old request per second data
227
+ const timestamp = Math.floor(Date.now() / 1000);
228
+ for (const bucket of buckets) {
229
+ bucket.rps = bucket.rps.filter((r) => r.timestamp > timestamp - 10);
230
+ }
231
+ availableBuckets = buckets.filter(isAvailable);
232
+ if (availableBuckets.length > 0) {
233
+ break;
234
+ }
235
+ if (noAvailableBucketsTimer === undefined) {
236
+ noAvailableBucketsTimer = setTimeout(() => {
237
+ common.logger.warn({
238
+ msg: "All JSON-RPC providers are inactive due to rate limiting",
239
+ chain: chain.name,
240
+ chain_id: chain.id,
241
+ rate_limits: JSON.stringify(buckets.map((b) => b.rpsLimit)),
242
+ });
243
+ }, 5000);
244
+ }
245
+ await wait(20);
246
+ }
247
+ clearTimeout(noAvailableBucketsTimer);
248
+ noAvailableBucketsTimer = undefined;
249
+ if (Math.random() < EPSILON) {
250
+ const randomBucket = availableBuckets[Math.floor(Math.random() * availableBuckets.length)];
251
+ randomBucket.activeConnections++;
252
+ return randomBucket;
253
+ }
254
+ const fastestBucket = availableBuckets.reduce((fastest, current) => {
255
+ const currentLatency = current.expectedLatency;
256
+ const fastestLatency = fastest.expectedLatency;
257
+ if (currentLatency < fastestLatency * (1 - LATENCY_HURDLE_RATE)) {
258
+ return current;
259
+ }
260
+ if (currentLatency <= fastestLatency &&
261
+ current.activeConnections < fastest.activeConnections) {
262
+ return current;
263
+ }
264
+ return fastest;
265
+ }, availableBuckets[0]);
266
+ fastestBucket.activeConnections++;
267
+ return fastestBucket;
268
+ };
269
+ const increaseMaxRPS = (bucket) => {
270
+ if (bucket.rps.length < 10)
271
+ return;
272
+ if (bucket.consecutiveSuccessfulRequests <
273
+ bucket.rpsLimit * SUCCESS_MULTIPLIER) {
274
+ return;
275
+ }
276
+ for (const { count } of bucket.rps) {
277
+ if (count < bucket.rpsLimit * RPS_INCREASE_QUALIFIER) {
278
+ return;
279
+ }
280
+ }
281
+ bucket.rpsLimit = Math.min(bucket.rpsLimit * RPS_INCREASE_FACTOR, MAX_RPS);
282
+ bucket.consecutiveSuccessfulRequests = 0;
283
+ common.logger.debug({
284
+ msg: "Increased JSON-RPC provider RPS limit",
285
+ chain: chain.name,
286
+ chain_id: chain.id,
287
+ hostname: bucket.hostname,
288
+ rps_limit: Math.floor(bucket.rpsLimit),
289
+ });
290
+ };
291
+ const queue = createQueue({
292
+ initialStart: true,
293
+ concurrency,
294
+ worker: async ({ body, context }) => {
295
+ const logger = context?.logger ?? common.logger;
296
+ for (let i = 0; i <= RETRY_COUNT; i++) {
297
+ let endClock = startClock();
298
+ const t = setTimeout(() => {
299
+ logger.warn({
300
+ msg: "Unable to find available JSON-RPC provider within expected time",
301
+ chain: chain.name,
302
+ chain_id: chain.id,
303
+ rate_limit: JSON.stringify(buckets.map((b) => b.rpsLimit)),
304
+ is_active: JSON.stringify(buckets.map((b) => b.isActive)),
305
+ is_warming_up: JSON.stringify(buckets.map((b) => b.isWarmingUp)),
306
+ duration: 15000,
307
+ });
308
+ }, 15000);
309
+ const bucket = await getBucket();
310
+ clearTimeout(t);
311
+ const getBucketDuration = endClock();
312
+ endClock = startClock();
313
+ const id = crypto.randomUUID();
314
+ const surpassTimeout = setTimeout(() => {
315
+ logger.warn({
316
+ msg: "JSON-RPC request unexpectedly surpassed timeout",
317
+ chain: chain.name,
318
+ chain_id: chain.id,
319
+ hostname: bucket.hostname,
320
+ request_id: id,
321
+ method: body.method,
322
+ duration: 15000,
323
+ });
324
+ }, 15000);
325
+ try {
326
+ logger.trace({
327
+ msg: "Sent JSON-RPC request",
328
+ chain: chain.name,
329
+ chain_id: chain.id,
330
+ hostname: bucket.hostname,
331
+ request_id: id,
332
+ method: body.method,
333
+ duration: getBucketDuration,
334
+ });
335
+ // Add request per second data
336
+ const timestamp = Math.floor(Date.now() / 1000);
337
+ if (bucket.rps.length === 0 ||
338
+ bucket.rps[bucket.rps.length - 1].timestamp < timestamp) {
339
+ bucket.rps.push({ count: 1, timestamp });
340
+ }
341
+ else {
342
+ bucket.rps[bucket.rps.length - 1].count++;
343
+ }
344
+ requestId = id;
345
+ const response = await bucket.request(body);
346
+ if (response === undefined) {
347
+ throw new Error("Response is undefined");
348
+ }
349
+ if (response === null &&
350
+ (body.method === "eth_getBlockByNumber" ||
351
+ body.method === "eth_getBlockByHash") &&
352
+ context?.retryNullBlockRequest === true) {
353
+ // Note: Throwing this error will cause the request to be retried.
354
+ throw new BlockNotFoundError({
355
+ // @ts-ignore
356
+ blockNumber: body.params[0],
357
+ });
358
+ }
359
+ const duration = endClock();
360
+ logger.trace({
361
+ msg: "Received JSON-RPC response",
362
+ chain: chain.name,
363
+ chain_id: chain.id,
364
+ hostname: bucket.hostname,
365
+ request_id: id,
366
+ method: body.method,
367
+ duration,
368
+ });
369
+ common.metrics.ponder_rpc_request_duration.observe({ method: body.method, chain: chain.name }, duration);
370
+ addLatency(bucket, duration, true);
371
+ bucket.consecutiveSuccessfulRequests++;
372
+ increaseMaxRPS(bucket);
373
+ bucket.isWarmingUp = false;
374
+ bucket.reactivationDelay = INITIAL_REACTIVATION_DELAY;
375
+ return response;
376
+ }
377
+ catch (e) {
378
+ const error = e;
379
+ common.metrics.ponder_rpc_request_error_total.inc({ method: body.method, chain: chain.name }, 1);
380
+ if (body.method === "eth_getLogs" &&
381
+ isHex(body.params[0].fromBlock) &&
382
+ isHex(body.params[0].toBlock) &&
383
+ chain.ethGetLogsBlockRange === undefined) {
384
+ const getLogsErrorResponse = getLogsRetryHelper({
385
+ params: body.params,
386
+ error: error,
387
+ });
388
+ if (getLogsErrorResponse.shouldRetry) {
389
+ common.logger.trace({
390
+ msg: "Caught eth_getLogs range error",
391
+ chain: chain.name,
392
+ chain_id: chain.id,
393
+ hostname: bucket.hostname,
394
+ request_id: id,
395
+ method: body.method,
396
+ request: JSON.stringify(body),
397
+ retry_ranges: JSON.stringify(getLogsErrorResponse.ranges),
398
+ error: error,
399
+ });
400
+ throw error;
401
+ }
402
+ else {
403
+ // @ts-ignore
404
+ error.meta = [
405
+ "Tip: Use the ethGetLogsBlockRange option to override the default behavior for this chain",
406
+ ];
407
+ }
408
+ }
409
+ addLatency(bucket, endClock(), false);
410
+ if (
411
+ // @ts-ignore
412
+ error.code === 429 ||
413
+ // @ts-ignore
414
+ error.status === 429 ||
415
+ error instanceof TimeoutError) {
416
+ if (bucket.isActive) {
417
+ bucket.isActive = false;
418
+ bucket.isWarmingUp = false;
419
+ bucket.rpsLimit = Math.max(bucket.rpsLimit * RPS_DECREASE_FACTOR, MIN_RPS);
420
+ bucket.consecutiveSuccessfulRequests = 0;
421
+ common.logger.debug({
422
+ msg: "JSON-RPC provider rate limited",
423
+ chain: chain.name,
424
+ chain_id: chain.id,
425
+ hostname: bucket.hostname,
426
+ rps_limit: Math.floor(bucket.rpsLimit),
427
+ });
428
+ scheduleBucketActivation(bucket);
429
+ if (buckets.every((b) => b.isActive === false)) {
430
+ logger.warn({
431
+ msg: "All JSON-RPC providers are inactive",
432
+ chain: chain.name,
433
+ chain_id: chain.id,
434
+ });
435
+ }
436
+ bucket.reactivationDelay =
437
+ error instanceof TimeoutError
438
+ ? INITIAL_REACTIVATION_DELAY
439
+ : Math.min(bucket.reactivationDelay * BACKOFF_FACTOR, MAX_REACTIVATION_DELAY);
440
+ }
441
+ }
442
+ if (shouldRetry(error) === false) {
443
+ logger.warn({
444
+ msg: "Received JSON-RPC error",
445
+ chain: chain.name,
446
+ chain_id: chain.id,
447
+ hostname: bucket.hostname,
448
+ request_id: id,
449
+ method: body.method,
450
+ request: JSON.stringify(body),
451
+ duration: endClock(),
452
+ error,
453
+ });
454
+ throw error;
455
+ }
456
+ if (i === RETRY_COUNT) {
457
+ logger.warn({
458
+ msg: "Received JSON-RPC error",
459
+ chain: chain.name,
460
+ chain_id: chain.id,
461
+ hostname: bucket.hostname,
462
+ request_id: id,
463
+ method: body.method,
464
+ request: JSON.stringify(body),
465
+ duration: endClock(),
466
+ retry_count: i + 1,
467
+ error,
468
+ });
469
+ throw error;
470
+ }
471
+ const duration = BASE_DURATION * 2 ** i;
472
+ logger.warn({
473
+ msg: "Received JSON-RPC error",
474
+ chain: chain.name,
475
+ chain_id: chain.id,
476
+ hostname: bucket.hostname,
477
+ request_id: id,
478
+ method: body.method,
479
+ request: JSON.stringify(body),
480
+ duration: endClock(),
481
+ retry_count: i + 1,
482
+ retry_delay: duration,
483
+ error,
484
+ });
485
+ await wait(duration);
486
+ }
487
+ finally {
488
+ bucket.activeConnections--;
489
+ clearTimeout(surpassTimeout);
490
+ }
491
+ }
492
+ throw "unreachable";
493
+ },
494
+ });
495
+ let ws;
496
+ let isUnsubscribed = false;
497
+ let subscriptionId;
498
+ let webSocketErrorCount = 0;
499
+ let interval;
500
+ const rpc = {
501
+ hostnames: backends.map((backend) => backend.hostname),
502
+ // @ts-ignore
503
+ request: (parameters, context) => queue.add({ body: parameters, context }),
504
+ subscribe({ onBlock, onError }) {
505
+ (async () => {
506
+ while (true) {
507
+ if (isUnsubscribed)
508
+ return;
509
+ if (chain.ws === undefined || webSocketErrorCount >= RETRY_COUNT) {
510
+ common.logger.debug({
511
+ msg: "Created JSON-RPC polling subscription",
512
+ chain: chain.name,
513
+ chain_id: chain.id,
514
+ polling_interval: chain.pollingInterval,
515
+ });
516
+ interval = setInterval(async () => {
517
+ try {
518
+ const block = await eth_getBlockByNumber(rpc, ["latest", true]);
519
+ common.logger.trace({
520
+ msg: "Received successful JSON-RPC polling response",
521
+ chain: chain.name,
522
+ chain_id: chain.id,
523
+ block_number: hexToNumber(block.number),
524
+ block_hash: block.hash,
525
+ });
526
+ // Note: `onBlock` should never throw.
527
+ await onBlock(block);
528
+ }
529
+ catch (error) {
530
+ onError(error);
531
+ }
532
+ }, chain.pollingInterval);
533
+ common.shutdown.add(() => {
534
+ clearInterval(interval);
535
+ });
536
+ return;
537
+ }
538
+ await new Promise((resolve) => {
539
+ ws = new WebSocket(chain.ws);
540
+ ws.on("open", () => {
541
+ common.logger.debug({
542
+ msg: "Created JSON-RPC WebSocket connection",
543
+ chain: chain.name,
544
+ chain_id: chain.id,
545
+ });
546
+ const subscriptionRequest = {
547
+ jsonrpc: "2.0",
548
+ id: 1,
549
+ method: "eth_subscribe",
550
+ params: ["newHeads"],
551
+ };
552
+ ws?.send(JSON.stringify(subscriptionRequest));
553
+ });
554
+ ws.on("message", (data) => {
555
+ try {
556
+ const msg = JSON.parse(data.toString());
557
+ if (msg.method === "eth_subscription" &&
558
+ msg.params.subscription === subscriptionId) {
559
+ common.logger.trace({
560
+ msg: "Received successful JSON-RPC WebSocket subscription data",
561
+ chain: chain.name,
562
+ chain_id: chain.id,
563
+ block_number: msg.params.result.number
564
+ ? hexToNumber(msg.params.result.number)
565
+ : undefined,
566
+ block_hash: msg.params.result.hash,
567
+ });
568
+ webSocketErrorCount = 0;
569
+ onBlock(standardizeBlock(msg.params.result, {
570
+ method: "eth_subscribe",
571
+ params: ["newHeads"],
572
+ }));
573
+ }
574
+ else if (msg.result) {
575
+ common.logger.debug({
576
+ msg: "Created JSON-RPC WebSocket subscription",
577
+ chain: chain.name,
578
+ chain_id: chain.id,
579
+ request: JSON.stringify({
580
+ method: "eth_subscribe",
581
+ params: ["newHeads"],
582
+ }),
583
+ subscription: msg.result,
584
+ });
585
+ subscriptionId = msg.result;
586
+ }
587
+ else if (msg.error) {
588
+ common.logger.warn({
589
+ msg: "Failed JSON-RPC WebSocket subscription",
590
+ chain: chain.name,
591
+ chain_id: chain.id,
592
+ request: JSON.stringify({
593
+ method: "eth_subscribe",
594
+ params: ["newHeads"],
595
+ }),
596
+ retry_count: webSocketErrorCount + 1,
597
+ error: msg.error,
598
+ });
599
+ if (webSocketErrorCount < RETRY_COUNT) {
600
+ webSocketErrorCount += 1;
601
+ }
602
+ ws?.close();
603
+ }
604
+ else {
605
+ common.logger.warn({
606
+ msg: "Received unrecognized JSON-RPC WebSocket message",
607
+ chain: chain.name,
608
+ websocket_message: msg,
609
+ });
610
+ }
611
+ }
612
+ catch (error) {
613
+ common.logger.warn({
614
+ msg: "Failed JSON-RPC WebSocket subscription",
615
+ chain: chain.name,
616
+ chain_id: chain.id,
617
+ request: JSON.stringify({
618
+ method: "eth_subscribe",
619
+ params: ["newHeads"],
620
+ }),
621
+ retry_count: webSocketErrorCount + 1,
622
+ error: error,
623
+ });
624
+ if (webSocketErrorCount < RETRY_COUNT) {
625
+ webSocketErrorCount += 1;
626
+ }
627
+ ws?.close();
628
+ }
629
+ });
630
+ ws.on("error", async (error) => {
631
+ common.logger.warn({
632
+ msg: "Failed JSON-RPC WebSocket subscription",
633
+ chain: chain.name,
634
+ chain_id: chain.id,
635
+ request: JSON.stringify({
636
+ method: "eth_subscribe",
637
+ params: ["newHeads"],
638
+ }),
639
+ retry_count: webSocketErrorCount + 1,
640
+ error: error,
641
+ });
642
+ if (webSocketErrorCount < RETRY_COUNT) {
643
+ webSocketErrorCount += 1;
644
+ }
645
+ if (ws && ws.readyState === ws.OPEN) {
646
+ ws.close();
647
+ }
648
+ else {
649
+ resolve();
650
+ }
651
+ });
652
+ ws.on("close", async () => {
653
+ common.logger.debug({
654
+ msg: "Closed JSON-RPC WebSocket connection",
655
+ chain: chain.name,
656
+ chain_id: chain.id,
657
+ });
658
+ ws = undefined;
659
+ if (isUnsubscribed || webSocketErrorCount >= RETRY_COUNT) {
660
+ resolve();
661
+ }
662
+ else {
663
+ const duration = BASE_DURATION * 2 ** webSocketErrorCount;
664
+ common.logger.debug({
665
+ msg: "Retrying JSON-RPC WebSocket connection",
666
+ chain: chain.name,
667
+ retry_count: webSocketErrorCount + 1,
668
+ retry_delay: duration,
669
+ });
670
+ await wait(duration);
671
+ resolve();
672
+ }
673
+ });
674
+ });
675
+ }
676
+ })();
677
+ },
678
+ async unsubscribe() {
679
+ clearInterval(interval);
680
+ isUnsubscribed = true;
681
+ if (ws) {
682
+ if (subscriptionId) {
683
+ const unsubscribeRequest = {
684
+ jsonrpc: "2.0",
685
+ id: 1,
686
+ method: "eth_unsubscribe",
687
+ params: [subscriptionId],
688
+ };
689
+ common.logger.debug({
690
+ msg: "Ended JSON-RPC WebSocket subscription",
691
+ chain: chain.name,
692
+ chain_id: chain.id,
693
+ request: JSON.stringify({
694
+ method: "eth_unsubscribe",
695
+ params: [subscriptionId],
696
+ }),
697
+ });
698
+ ws.send(JSON.stringify(unsubscribeRequest));
699
+ }
700
+ ws.close();
701
+ }
702
+ },
703
+ };
704
+ common.shutdown.add(() => {
705
+ for (const timeoutId of timeouts) {
706
+ clearTimeout(timeoutId);
707
+ }
708
+ timeouts.clear();
709
+ });
710
+ return rpc;
711
+ };
712
+ /**
713
+ * @link https://github.com/wevm/viem/blob/main/src/utils/buildtask.ts#L192
714
+ */
715
+ function shouldRetry(error) {
716
+ if ("code" in error && typeof error.code === "number") {
717
+ // Invalid JSON
718
+ if (error.code === ParseRpcError.code)
719
+ return false;
720
+ // Method does not exist
721
+ if (error.code === MethodNotFoundRpcError.code)
722
+ return false;
723
+ // Method is not implemented
724
+ if (error.code === MethodNotSupportedRpcError.code)
725
+ return false;
726
+ // Version of JSON-RPC protocol is not supported
727
+ if (error.code === JsonRpcVersionUnsupportedError.code)
728
+ return false;
729
+ // eth_call reverted
730
+ if (error.message.includes("revert"))
731
+ return false;
732
+ }
733
+ if (error instanceof HttpRequestError && error.status) {
734
+ // Method Not Allowed
735
+ if (error.status === 405)
736
+ return false;
737
+ // Not Found
738
+ if (error.status === 404)
739
+ return false;
740
+ // Not Implemented
741
+ if (error.status === 501)
742
+ return false;
743
+ // HTTP Version Not Supported
744
+ if (error.status === 505)
745
+ return false;
746
+ }
747
+ return true;
748
+ }
749
+ //# sourceMappingURL=index.js.map