@jinn-network/client 0.1.1 → 0.1.2-canary.6237288d

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 (424) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/CONTRIBUTING.md +123 -0
  3. package/README.md +213 -37
  4. package/deployments/deployment-claim-registry-baseSepolia.json +13 -0
  5. package/deployments/deployment-jinn-testnet-faucet-baseSepolia-fast.json +15 -0
  6. package/dist/adapters/adapter.d.ts +7 -0
  7. package/dist/adapters/claim-registry/abi.d.ts +127 -0
  8. package/dist/adapters/claim-registry/abi.js +93 -0
  9. package/dist/adapters/claim-registry/abi.js.map +1 -0
  10. package/dist/adapters/claim-registry/client.d.ts +89 -0
  11. package/dist/adapters/claim-registry/client.js +205 -0
  12. package/dist/adapters/claim-registry/client.js.map +1 -0
  13. package/dist/adapters/mech/adapter.d.ts +5 -0
  14. package/dist/adapters/mech/adapter.js +211 -56
  15. package/dist/adapters/mech/adapter.js.map +1 -1
  16. package/dist/adapters/mech/contracts.d.ts +19 -1
  17. package/dist/adapters/mech/contracts.js +112 -8
  18. package/dist/adapters/mech/contracts.js.map +1 -1
  19. package/dist/adapters/mech/ipfs.d.ts +38 -5
  20. package/dist/adapters/mech/ipfs.js +174 -17
  21. package/dist/adapters/mech/ipfs.js.map +1 -1
  22. package/dist/adapters/mech/safe.js +8 -6
  23. package/dist/adapters/mech/safe.js.map +1 -1
  24. package/dist/adapters/mech/types.d.ts +22 -46
  25. package/dist/adapters/mech/types.js +16 -35
  26. package/dist/adapters/mech/types.js.map +1 -1
  27. package/dist/api/balance-build.js +3 -3
  28. package/dist/api/balance-build.js.map +1 -1
  29. package/dist/api/fleet-build.js +35 -40
  30. package/dist/api/fleet-build.js.map +1 -1
  31. package/dist/api/gather-status.d.ts +6 -0
  32. package/dist/api/gather-status.js +187 -4
  33. package/dist/api/gather-status.js.map +1 -1
  34. package/dist/api/history-build.d.ts +5 -1
  35. package/dist/api/history-build.js +51 -26
  36. package/dist/api/history-build.js.map +1 -1
  37. package/dist/api/portfolio-v0-build.d.ts +83 -0
  38. package/dist/api/portfolio-v0-build.js +143 -0
  39. package/dist/api/portfolio-v0-build.js.map +1 -0
  40. package/dist/api/portfolio-v0-doctor.d.ts +37 -0
  41. package/dist/api/portfolio-v0-doctor.js +123 -0
  42. package/dist/api/portfolio-v0-doctor.js.map +1 -0
  43. package/dist/api/rewards-build.js +30 -14
  44. package/dist/api/rewards-build.js.map +1 -1
  45. package/dist/api/status-build.d.ts +39 -6
  46. package/dist/api/status-build.js +3 -1
  47. package/dist/api/status-build.js.map +1 -1
  48. package/dist/api/status-rollup-build.d.ts +2 -0
  49. package/dist/api/status-rollup-build.js +30 -3
  50. package/dist/api/status-rollup-build.js.map +1 -1
  51. package/dist/bin/jinn-mcp.d.ts +0 -12
  52. package/dist/bin/jinn-mcp.js +5 -14
  53. package/dist/bin/jinn-mcp.js.map +1 -1
  54. package/dist/build-meta.json +1 -1
  55. package/dist/cli/commands/auth.js +137 -25
  56. package/dist/cli/commands/auth.js.map +1 -1
  57. package/dist/cli/commands/balance.js +8 -1
  58. package/dist/cli/commands/balance.js.map +1 -1
  59. package/dist/cli/commands/bootstrap.js +23 -0
  60. package/dist/cli/commands/bootstrap.js.map +1 -1
  61. package/dist/cli/commands/doctor.js +160 -14
  62. package/dist/cli/commands/doctor.js.map +1 -1
  63. package/dist/cli/commands/fleet-scale.js +1 -0
  64. package/dist/cli/commands/fleet-scale.js.map +1 -1
  65. package/dist/cli/commands/fleet.js +10 -1
  66. package/dist/cli/commands/fleet.js.map +1 -1
  67. package/dist/cli/commands/fund-requirements.js +2 -0
  68. package/dist/cli/commands/fund-requirements.js.map +1 -1
  69. package/dist/cli/commands/history.js +25 -6
  70. package/dist/cli/commands/history.js.map +1 -1
  71. package/dist/cli/commands/intents.d.ts +17 -0
  72. package/dist/cli/commands/intents.js +489 -0
  73. package/dist/cli/commands/intents.js.map +1 -0
  74. package/dist/cli/commands/keys-backup.js +13 -11
  75. package/dist/cli/commands/keys-backup.js.map +1 -1
  76. package/dist/cli/commands/logs.js +35 -11
  77. package/dist/cli/commands/logs.js.map +1 -1
  78. package/dist/cli/commands/mcp.d.ts +3 -0
  79. package/dist/cli/commands/mcp.js +19 -0
  80. package/dist/cli/commands/mcp.js.map +1 -0
  81. package/dist/cli/commands/plugin-install.js +8 -4
  82. package/dist/cli/commands/plugin-install.js.map +1 -1
  83. package/dist/cli/commands/quickstart.js +99 -5
  84. package/dist/cli/commands/quickstart.js.map +1 -1
  85. package/dist/cli/commands/rewards.js +27 -1
  86. package/dist/cli/commands/rewards.js.map +1 -1
  87. package/dist/cli/commands/run.js +38 -0
  88. package/dist/cli/commands/run.js.map +1 -1
  89. package/dist/cli/commands/status.js +11 -1
  90. package/dist/cli/commands/status.js.map +1 -1
  91. package/dist/cli/commands/submit-intent.js +110 -44
  92. package/dist/cli/commands/submit-intent.js.map +1 -1
  93. package/dist/cli/commands/version.js +1 -0
  94. package/dist/cli/commands/version.js.map +1 -1
  95. package/dist/cli/deployment-digest.js +5 -0
  96. package/dist/cli/deployment-digest.js.map +1 -1
  97. package/dist/cli/execution-context.js +1 -0
  98. package/dist/cli/execution-context.js.map +1 -1
  99. package/dist/cli/index.js +4 -0
  100. package/dist/cli/index.js.map +1 -1
  101. package/dist/cli/intent-registry-access.d.ts +62 -0
  102. package/dist/cli/intent-registry-access.js +165 -0
  103. package/dist/cli/intent-registry-access.js.map +1 -0
  104. package/dist/cli/introspection-context.js +12 -8
  105. package/dist/cli/introspection-context.js.map +1 -1
  106. package/dist/cli/password.d.ts +21 -9
  107. package/dist/cli/password.js +45 -24
  108. package/dist/cli/password.js.map +1 -1
  109. package/dist/config.d.ts +137 -8
  110. package/dist/config.js +70 -12
  111. package/dist/config.js.map +1 -1
  112. package/dist/daemon/balance-topup-loop.js +32 -4
  113. package/dist/daemon/balance-topup-loop.js.map +1 -1
  114. package/dist/daemon/creator.d.ts +7 -4
  115. package/dist/daemon/creator.js +55 -26
  116. package/dist/daemon/creator.js.map +1 -1
  117. package/dist/daemon/daemon.d.ts +35 -3
  118. package/dist/daemon/daemon.js +99 -7
  119. package/dist/daemon/daemon.js.map +1 -1
  120. package/dist/daemon/delivery-watcher.d.ts +3 -1
  121. package/dist/daemon/delivery-watcher.js +19 -1
  122. package/dist/daemon/delivery-watcher.js.map +1 -1
  123. package/dist/daemon/reward-claim-loop.js +38 -1
  124. package/dist/daemon/reward-claim-loop.js.map +1 -1
  125. package/dist/dashboard/index.html +71 -496
  126. package/dist/discovery/registry.d.ts +54 -0
  127. package/dist/discovery/registry.js +73 -0
  128. package/dist/discovery/registry.js.map +1 -1
  129. package/dist/earning/bootstrap.d.ts +2 -1
  130. package/dist/earning/bootstrap.js +71 -33
  131. package/dist/earning/bootstrap.js.map +1 -1
  132. package/dist/earning/contracts.d.ts +10 -0
  133. package/dist/earning/contracts.js +24 -0
  134. package/dist/earning/contracts.js.map +1 -1
  135. package/dist/earning/jinn-rewards.d.ts +9 -0
  136. package/dist/earning/jinn-rewards.js +7 -0
  137. package/dist/earning/jinn-rewards.js.map +1 -1
  138. package/dist/earning/stolas-claim.d.ts +6 -0
  139. package/dist/earning/stolas-claim.js +7 -0
  140. package/dist/earning/stolas-claim.js.map +1 -1
  141. package/dist/intents/kinds/constants.d.ts +5 -0
  142. package/dist/intents/kinds/constants.js +6 -0
  143. package/dist/intents/kinds/constants.js.map +1 -0
  144. package/dist/intents/kinds/index.d.ts +28 -0
  145. package/dist/intents/kinds/index.js +50 -0
  146. package/dist/intents/kinds/index.js.map +1 -0
  147. package/dist/intents/kinds/portfolio-v0.d.ts +2 -0
  148. package/dist/intents/kinds/portfolio-v0.js +13 -0
  149. package/dist/intents/kinds/portfolio-v0.js.map +1 -0
  150. package/dist/intents/kinds/prediction-apy-v0.d.ts +3 -0
  151. package/dist/intents/kinds/prediction-apy-v0.js +21 -0
  152. package/dist/intents/kinds/prediction-apy-v0.js.map +1 -0
  153. package/dist/intents/kinds/prediction-v0.d.ts +3 -0
  154. package/dist/intents/kinds/prediction-v0.js +32 -0
  155. package/dist/intents/kinds/prediction-v0.js.map +1 -0
  156. package/dist/intents/kinds/spec-kind.d.ts +38 -0
  157. package/dist/intents/kinds/spec-kind.js +6 -0
  158. package/dist/intents/kinds/spec-kind.js.map +1 -0
  159. package/dist/intents/posting-service.d.ts +26 -0
  160. package/dist/intents/posting-service.js +218 -0
  161. package/dist/intents/posting-service.js.map +1 -0
  162. package/dist/intents/prediction-apy-v0-auto.d.ts +11 -0
  163. package/dist/intents/prediction-apy-v0-auto.js +46 -0
  164. package/dist/intents/prediction-apy-v0-auto.js.map +1 -0
  165. package/dist/intents/prediction-apy-v0-template.d.ts +8 -0
  166. package/dist/intents/prediction-apy-v0-template.js +22 -0
  167. package/dist/intents/prediction-apy-v0-template.js.map +1 -0
  168. package/dist/intents/prediction-v0-auto.d.ts +53 -0
  169. package/dist/intents/prediction-v0-auto.js +84 -0
  170. package/dist/intents/prediction-v0-auto.js.map +1 -0
  171. package/dist/intents/prediction-v0-template.d.ts +70 -0
  172. package/dist/intents/prediction-v0-template.js +145 -0
  173. package/dist/intents/prediction-v0-template.js.map +1 -0
  174. package/dist/intents/sources.d.ts +39 -0
  175. package/dist/intents/sources.js +42 -0
  176. package/dist/intents/sources.js.map +1 -0
  177. package/dist/main.js +175 -3
  178. package/dist/main.js.map +1 -1
  179. package/dist/mcp/operator-server.d.ts +1 -1
  180. package/dist/mcp/operator-server.js +1 -1
  181. package/dist/mcp/server.js +8 -4
  182. package/dist/mcp/server.js.map +1 -1
  183. package/dist/observability/emit-event.d.ts +12 -0
  184. package/dist/observability/emit-event.js +27 -0
  185. package/dist/observability/emit-event.js.map +1 -0
  186. package/dist/preflight/api-port.d.ts +13 -0
  187. package/dist/preflight/api-port.js +32 -0
  188. package/dist/preflight/api-port.js.map +1 -0
  189. package/dist/preflight/claude-auth.d.ts +12 -1
  190. package/dist/preflight/claude-auth.js +21 -3
  191. package/dist/preflight/claude-auth.js.map +1 -1
  192. package/dist/preflight/rpc-network.d.ts +44 -0
  193. package/dist/preflight/rpc-network.js +121 -0
  194. package/dist/preflight/rpc-network.js.map +1 -0
  195. package/dist/restorer/engine/canonical-json.d.ts +18 -0
  196. package/dist/restorer/engine/canonical-json.js +59 -0
  197. package/dist/restorer/engine/canonical-json.js.map +1 -0
  198. package/dist/restorer/engine/claim.d.ts +69 -0
  199. package/dist/restorer/engine/claim.js +104 -0
  200. package/dist/restorer/engine/claim.js.map +1 -0
  201. package/dist/restorer/engine/delivery.d.ts +52 -0
  202. package/dist/restorer/engine/delivery.js +63 -0
  203. package/dist/restorer/engine/delivery.js.map +1 -0
  204. package/dist/restorer/engine/engine.d.ts +213 -0
  205. package/dist/restorer/engine/engine.js +769 -0
  206. package/dist/restorer/engine/engine.js.map +1 -0
  207. package/dist/restorer/engine/manifest-assembly.d.ts +67 -0
  208. package/dist/restorer/engine/manifest-assembly.js +79 -0
  209. package/dist/restorer/engine/manifest-assembly.js.map +1 -0
  210. package/dist/restorer/engine/packaging.d.ts +87 -0
  211. package/dist/restorer/engine/packaging.js +350 -0
  212. package/dist/restorer/engine/packaging.js.map +1 -0
  213. package/dist/restorer/engine/persistence.d.ts +170 -0
  214. package/dist/restorer/engine/persistence.js +381 -0
  215. package/dist/restorer/engine/persistence.js.map +1 -0
  216. package/dist/restorer/engine/recovery.d.ts +22 -0
  217. package/dist/restorer/engine/recovery.js +24 -0
  218. package/dist/restorer/engine/recovery.js.map +1 -0
  219. package/dist/restorer/engine/registry.d.ts +62 -0
  220. package/dist/restorer/engine/registry.js +73 -0
  221. package/dist/restorer/engine/registry.js.map +1 -0
  222. package/dist/restorer/engine/signing.d.ts +30 -0
  223. package/dist/restorer/engine/signing.js +39 -0
  224. package/dist/restorer/engine/signing.js.map +1 -0
  225. package/dist/restorer/engine/state.d.ts +42 -0
  226. package/dist/restorer/engine/state.js +87 -0
  227. package/dist/restorer/engine/state.js.map +1 -0
  228. package/dist/restorer/impls/claude-mcp-hyperliquid/api-wallet.d.ts +64 -0
  229. package/dist/restorer/impls/claude-mcp-hyperliquid/api-wallet.js +96 -0
  230. package/dist/restorer/impls/claude-mcp-hyperliquid/api-wallet.js.map +1 -0
  231. package/dist/restorer/impls/claude-mcp-hyperliquid/index.d.ts +104 -0
  232. package/dist/restorer/impls/claude-mcp-hyperliquid/index.js +721 -0
  233. package/dist/restorer/impls/claude-mcp-hyperliquid/index.js.map +1 -0
  234. package/dist/restorer/impls/claude-mcp-hyperliquid/mcp-tools.d.ts +137 -0
  235. package/dist/restorer/impls/claude-mcp-hyperliquid/mcp-tools.js +865 -0
  236. package/dist/restorer/impls/claude-mcp-hyperliquid/mcp-tools.js.map +1 -0
  237. package/dist/restorer/impls/claude-mcp-hyperliquid/safety-rails.d.ts +74 -0
  238. package/dist/restorer/impls/claude-mcp-hyperliquid/safety-rails.js +74 -0
  239. package/dist/restorer/impls/claude-mcp-hyperliquid/safety-rails.js.map +1 -0
  240. package/dist/restorer/impls/claude-mcp-hyperliquid/session-orchestrator.d.ts +97 -0
  241. package/dist/restorer/impls/claude-mcp-hyperliquid/session-orchestrator.js +226 -0
  242. package/dist/restorer/impls/claude-mcp-hyperliquid/session-orchestrator.js.map +1 -0
  243. package/dist/restorer/impls/claude-mcp-prediction/index.d.ts +44 -0
  244. package/dist/restorer/impls/claude-mcp-prediction/index.js +239 -0
  245. package/dist/restorer/impls/claude-mcp-prediction/index.js.map +1 -0
  246. package/dist/restorer/impls/claude-mcp-prediction/mcp-tools.d.ts +38 -0
  247. package/dist/restorer/impls/claude-mcp-prediction/mcp-tools.js +135 -0
  248. package/dist/restorer/impls/claude-mcp-prediction/mcp-tools.js.map +1 -0
  249. package/dist/restorer/impls/claude-mcp-prediction/prompt.d.ts +8 -0
  250. package/dist/restorer/impls/claude-mcp-prediction/prompt.js +54 -0
  251. package/dist/restorer/impls/claude-mcp-prediction/prompt.js.map +1 -0
  252. package/dist/restorer/impls/claude-mcp-prediction/session-orchestrator.d.ts +36 -0
  253. package/dist/restorer/impls/claude-mcp-prediction/session-orchestrator.js +137 -0
  254. package/dist/restorer/impls/claude-mcp-prediction/session-orchestrator.js.map +1 -0
  255. package/dist/restorer/impls/claude-mcp-prediction/types.d.ts +84 -0
  256. package/dist/restorer/impls/claude-mcp-prediction/types.js +6 -0
  257. package/dist/restorer/impls/claude-mcp-prediction/types.js.map +1 -0
  258. package/dist/restorer/impls/claude-mcp-prediction-apy/index.d.ts +34 -0
  259. package/dist/restorer/impls/claude-mcp-prediction-apy/index.js +233 -0
  260. package/dist/restorer/impls/claude-mcp-prediction-apy/index.js.map +1 -0
  261. package/dist/restorer/impls/claude-mcp-prediction-apy/mcp-tools.d.ts +18 -0
  262. package/dist/restorer/impls/claude-mcp-prediction-apy/mcp-tools.js +136 -0
  263. package/dist/restorer/impls/claude-mcp-prediction-apy/mcp-tools.js.map +1 -0
  264. package/dist/restorer/impls/claude-mcp-prediction-apy/prompt.d.ts +7 -0
  265. package/dist/restorer/impls/claude-mcp-prediction-apy/prompt.js +46 -0
  266. package/dist/restorer/impls/claude-mcp-prediction-apy/prompt.js.map +1 -0
  267. package/dist/restorer/impls/claude-mcp-prediction-apy/session-orchestrator.d.ts +27 -0
  268. package/dist/restorer/impls/claude-mcp-prediction-apy/session-orchestrator.js +128 -0
  269. package/dist/restorer/impls/claude-mcp-prediction-apy/session-orchestrator.js.map +1 -0
  270. package/dist/restorer/impls/claude-mcp-prediction-apy/types.d.ts +64 -0
  271. package/dist/restorer/impls/claude-mcp-prediction-apy/types.js +6 -0
  272. package/dist/restorer/impls/claude-mcp-prediction-apy/types.js.map +1 -0
  273. package/dist/restorer/impls/evaluation-context.d.ts +16 -0
  274. package/dist/restorer/impls/evaluation-context.js +18 -0
  275. package/dist/restorer/impls/evaluation-context.js.map +1 -0
  276. package/dist/restorer/impls/index.d.ts +46 -0
  277. package/dist/restorer/impls/index.js +88 -0
  278. package/dist/restorer/impls/index.js.map +1 -0
  279. package/dist/restorer/impls/legacy-claude/index.d.ts +52 -0
  280. package/dist/restorer/impls/legacy-claude/index.js +140 -0
  281. package/dist/restorer/impls/legacy-claude/index.js.map +1 -0
  282. package/dist/restorer/impls/portfolio-v0-evaluator/canonical-metrics.d.ts +68 -0
  283. package/dist/restorer/impls/portfolio-v0-evaluator/canonical-metrics.js +117 -0
  284. package/dist/restorer/impls/portfolio-v0-evaluator/canonical-metrics.js.map +1 -0
  285. package/dist/restorer/impls/portfolio-v0-evaluator/checks/availability.d.ts +49 -0
  286. package/dist/restorer/impls/portfolio-v0-evaluator/checks/availability.js +91 -0
  287. package/dist/restorer/impls/portfolio-v0-evaluator/checks/availability.js.map +1 -0
  288. package/dist/restorer/impls/portfolio-v0-evaluator/checks/consistency.d.ts +78 -0
  289. package/dist/restorer/impls/portfolio-v0-evaluator/checks/consistency.js +274 -0
  290. package/dist/restorer/impls/portfolio-v0-evaluator/checks/consistency.js.map +1 -0
  291. package/dist/restorer/impls/portfolio-v0-evaluator/checks/eligibility.d.ts +23 -0
  292. package/dist/restorer/impls/portfolio-v0-evaluator/checks/eligibility.js +49 -0
  293. package/dist/restorer/impls/portfolio-v0-evaluator/checks/eligibility.js.map +1 -0
  294. package/dist/restorer/impls/portfolio-v0-evaluator/checks/integrity.d.ts +25 -0
  295. package/dist/restorer/impls/portfolio-v0-evaluator/checks/integrity.js +44 -0
  296. package/dist/restorer/impls/portfolio-v0-evaluator/checks/integrity.js.map +1 -0
  297. package/dist/restorer/impls/portfolio-v0-evaluator/checks/spec.d.ts +17 -0
  298. package/dist/restorer/impls/portfolio-v0-evaluator/checks/spec.js +43 -0
  299. package/dist/restorer/impls/portfolio-v0-evaluator/checks/spec.js.map +1 -0
  300. package/dist/restorer/impls/portfolio-v0-evaluator/index.d.ts +44 -0
  301. package/dist/restorer/impls/portfolio-v0-evaluator/index.js +440 -0
  302. package/dist/restorer/impls/portfolio-v0-evaluator/index.js.map +1 -0
  303. package/dist/restorer/impls/portfolio-v0-evaluator/score.d.ts +21 -0
  304. package/dist/restorer/impls/portfolio-v0-evaluator/score.js +32 -0
  305. package/dist/restorer/impls/portfolio-v0-evaluator/score.js.map +1 -0
  306. package/dist/restorer/impls/portfolio-v0-evaluator/types.d.ts +34 -0
  307. package/dist/restorer/impls/portfolio-v0-evaluator/types.js +8 -0
  308. package/dist/restorer/impls/portfolio-v0-evaluator/types.js.map +1 -0
  309. package/dist/restorer/impls/prediction-apy-v0-baseline/index.d.ts +40 -0
  310. package/dist/restorer/impls/prediction-apy-v0-baseline/index.js +107 -0
  311. package/dist/restorer/impls/prediction-apy-v0-baseline/index.js.map +1 -0
  312. package/dist/restorer/impls/prediction-apy-v0-baseline/strategy.d.ts +2 -0
  313. package/dist/restorer/impls/prediction-apy-v0-baseline/strategy.js +7 -0
  314. package/dist/restorer/impls/prediction-apy-v0-baseline/strategy.js.map +1 -0
  315. package/dist/restorer/impls/prediction-apy-v0-baseline/types.d.ts +4 -0
  316. package/dist/restorer/impls/prediction-apy-v0-baseline/types.js +2 -0
  317. package/dist/restorer/impls/prediction-apy-v0-baseline/types.js.map +1 -0
  318. package/dist/restorer/impls/prediction-apy-v0-evaluator/canonical-metrics.d.ts +6 -0
  319. package/dist/restorer/impls/prediction-apy-v0-evaluator/canonical-metrics.js +11 -0
  320. package/dist/restorer/impls/prediction-apy-v0-evaluator/canonical-metrics.js.map +1 -0
  321. package/dist/restorer/impls/prediction-apy-v0-evaluator/index.d.ts +42 -0
  322. package/dist/restorer/impls/prediction-apy-v0-evaluator/index.js +208 -0
  323. package/dist/restorer/impls/prediction-apy-v0-evaluator/index.js.map +1 -0
  324. package/dist/restorer/impls/prediction-apy-v0-evaluator/parse-submission.d.ts +7 -0
  325. package/dist/restorer/impls/prediction-apy-v0-evaluator/parse-submission.js +29 -0
  326. package/dist/restorer/impls/prediction-apy-v0-evaluator/parse-submission.js.map +1 -0
  327. package/dist/restorer/impls/prediction-apy-v0-evaluator/score.d.ts +9 -0
  328. package/dist/restorer/impls/prediction-apy-v0-evaluator/score.js +20 -0
  329. package/dist/restorer/impls/prediction-apy-v0-evaluator/score.js.map +1 -0
  330. package/dist/restorer/impls/prediction-apy-v0-evaluator/types.d.ts +7 -0
  331. package/dist/restorer/impls/prediction-apy-v0-evaluator/types.js +2 -0
  332. package/dist/restorer/impls/prediction-apy-v0-evaluator/types.js.map +1 -0
  333. package/dist/restorer/impls/prediction-v0-baseline/index.d.ts +31 -0
  334. package/dist/restorer/impls/prediction-v0-baseline/index.js +100 -0
  335. package/dist/restorer/impls/prediction-v0-baseline/index.js.map +1 -0
  336. package/dist/restorer/impls/prediction-v0-baseline/strategy.d.ts +8 -0
  337. package/dist/restorer/impls/prediction-v0-baseline/strategy.js +41 -0
  338. package/dist/restorer/impls/prediction-v0-baseline/strategy.js.map +1 -0
  339. package/dist/restorer/impls/prediction-v0-baseline/types.d.ts +7 -0
  340. package/dist/restorer/impls/prediction-v0-baseline/types.js +2 -0
  341. package/dist/restorer/impls/prediction-v0-baseline/types.js.map +1 -0
  342. package/dist/restorer/impls/prediction-v0-evaluator/canonical-metrics.d.ts +20 -0
  343. package/dist/restorer/impls/prediction-v0-evaluator/canonical-metrics.js +66 -0
  344. package/dist/restorer/impls/prediction-v0-evaluator/canonical-metrics.js.map +1 -0
  345. package/dist/restorer/impls/prediction-v0-evaluator/checks/availability.d.ts +9 -0
  346. package/dist/restorer/impls/prediction-v0-evaluator/checks/availability.js +23 -0
  347. package/dist/restorer/impls/prediction-v0-evaluator/checks/availability.js.map +1 -0
  348. package/dist/restorer/impls/prediction-v0-evaluator/checks/eligibility.d.ts +3 -0
  349. package/dist/restorer/impls/prediction-v0-evaluator/checks/eligibility.js +13 -0
  350. package/dist/restorer/impls/prediction-v0-evaluator/checks/eligibility.js.map +1 -0
  351. package/dist/restorer/impls/prediction-v0-evaluator/checks/integrity.d.ts +13 -0
  352. package/dist/restorer/impls/prediction-v0-evaluator/checks/integrity.js +111 -0
  353. package/dist/restorer/impls/prediction-v0-evaluator/checks/integrity.js.map +1 -0
  354. package/dist/restorer/impls/prediction-v0-evaluator/checks/spec.d.ts +5 -0
  355. package/dist/restorer/impls/prediction-v0-evaluator/checks/spec.js +20 -0
  356. package/dist/restorer/impls/prediction-v0-evaluator/checks/spec.js.map +1 -0
  357. package/dist/restorer/impls/prediction-v0-evaluator/index.d.ts +36 -0
  358. package/dist/restorer/impls/prediction-v0-evaluator/index.js +234 -0
  359. package/dist/restorer/impls/prediction-v0-evaluator/index.js.map +1 -0
  360. package/dist/restorer/impls/prediction-v0-evaluator/score.d.ts +8 -0
  361. package/dist/restorer/impls/prediction-v0-evaluator/score.js +15 -0
  362. package/dist/restorer/impls/prediction-v0-evaluator/score.js.map +1 -0
  363. package/dist/restorer/impls/prediction-v0-evaluator/types.d.ts +7 -0
  364. package/dist/restorer/impls/prediction-v0-evaluator/types.js +2 -0
  365. package/dist/restorer/impls/prediction-v0-evaluator/types.js.map +1 -0
  366. package/dist/restorer/types.d.ts +194 -0
  367. package/dist/restorer/types.js +28 -0
  368. package/dist/restorer/types.js.map +1 -0
  369. package/dist/rpc-error-context.d.ts +10 -0
  370. package/dist/rpc-error-context.js +26 -0
  371. package/dist/rpc-error-context.js.map +1 -0
  372. package/dist/store/store.d.ts +101 -1
  373. package/dist/store/store.js +334 -4
  374. package/dist/store/store.js.map +1 -1
  375. package/dist/trajectory/schema.d.ts +510 -0
  376. package/dist/trajectory/schema.js +74 -0
  377. package/dist/trajectory/schema.js.map +1 -0
  378. package/dist/types/desired-state.d.ts +53 -0
  379. package/dist/types/desired-state.js +20 -0
  380. package/dist/types/desired-state.js.map +1 -1
  381. package/dist/types/index.d.ts +4 -1
  382. package/dist/types/index.js +4 -1
  383. package/dist/types/index.js.map +1 -1
  384. package/dist/types/portfolio.d.ts +1000 -0
  385. package/dist/types/portfolio.js +168 -0
  386. package/dist/types/portfolio.js.map +1 -0
  387. package/dist/types/prediction-apy.d.ts +930 -0
  388. package/dist/types/prediction-apy.js +133 -0
  389. package/dist/types/prediction-apy.js.map +1 -0
  390. package/dist/types/prediction.d.ts +926 -0
  391. package/dist/types/prediction.js +141 -0
  392. package/dist/types/prediction.js.map +1 -0
  393. package/dist/venues/aave-v3/addresses.d.ts +6 -0
  394. package/dist/venues/aave-v3/addresses.js +19 -0
  395. package/dist/venues/aave-v3/addresses.js.map +1 -0
  396. package/dist/venues/aave-v3/client.d.ts +85 -0
  397. package/dist/venues/aave-v3/client.js +106 -0
  398. package/dist/venues/aave-v3/client.js.map +1 -0
  399. package/dist/venues/chainlink/client.d.ts +99 -0
  400. package/dist/venues/chainlink/client.js +130 -0
  401. package/dist/venues/chainlink/client.js.map +1 -0
  402. package/dist/venues/chainlink/feeds.d.ts +8 -0
  403. package/dist/venues/chainlink/feeds.js +9 -0
  404. package/dist/venues/chainlink/feeds.js.map +1 -0
  405. package/dist/venues/hyperliquid/account-value.d.ts +30 -0
  406. package/dist/venues/hyperliquid/account-value.js +30 -0
  407. package/dist/venues/hyperliquid/account-value.js.map +1 -0
  408. package/dist/venues/hyperliquid/client.d.ts +63 -0
  409. package/dist/venues/hyperliquid/client.js +135 -0
  410. package/dist/venues/hyperliquid/client.js.map +1 -0
  411. package/dist/venues/hyperliquid/grid.d.ts +36 -0
  412. package/dist/venues/hyperliquid/grid.js +61 -0
  413. package/dist/venues/hyperliquid/grid.js.map +1 -0
  414. package/dist/venues/hyperliquid/types.d.ts +81 -0
  415. package/dist/venues/hyperliquid/types.js +8 -0
  416. package/dist/venues/hyperliquid/types.js.map +1 -0
  417. package/dist/withdraw/run-withdraw-plan.js +2 -0
  418. package/dist/withdraw/run-withdraw-plan.js.map +1 -1
  419. package/docker-compose.yml +44 -0
  420. package/package.json +15 -3
  421. package/skills/jinn-operator/SKILL.md +85 -0
  422. package/dist/daemon/restorer.d.ts +0 -19
  423. package/dist/daemon/restorer.js +0 -82
  424. package/dist/daemon/restorer.js.map +0 -1
@@ -0,0 +1,141 @@
1
+ /**
2
+ * prediction.v0 — typed intent spec, submission manifest, verdict manifest.
3
+ *
4
+ * §4 of spec/2026-04-20-prediction-v0-pis-phase-1-design.md
5
+ */
6
+ import { z } from 'zod';
7
+ import { WindowSchema } from './desired-state.js';
8
+ const HexStringSchema = z.string().regex(/^0x[0-9a-fA-F]*$/, 'must be a 0x-prefixed hex string');
9
+ const SignatureSchema = z.object({
10
+ algo: z.literal('secp256k1'),
11
+ signer: HexStringSchema,
12
+ hash: HexStringSchema,
13
+ sig: HexStringSchema,
14
+ });
15
+ const IntentProvenanceSchema = z.object({
16
+ cid: z.string().min(1),
17
+ onchainCreationTx: HexStringSchema,
18
+ onchainCreationBlock: z.number().int(),
19
+ requestId: HexStringSchema,
20
+ });
21
+ const ParticipantSchema = z.object({
22
+ safeAddress: HexStringSchema,
23
+ agentEoa: HexStringSchema,
24
+ });
25
+ // ── Question kinds ────────────────────────────────────────────────────────────
26
+ const ThresholdQuestionSchema = z.object({
27
+ kind: z.literal('threshold'),
28
+ operator: z.enum(['GT', 'GTE', 'LT', 'LTE']),
29
+ threshold: z.string(),
30
+ resolveTs: z.number().int(),
31
+ });
32
+ const RangeQuestionSchema = z.object({
33
+ kind: z.literal('range'),
34
+ lowerBound: z.string(),
35
+ upperBound: z.string(),
36
+ resolveTs: z.number().int(),
37
+ });
38
+ // ── Spec + eligibility + intent ────────────────────────────────────────────────
39
+ export const PredictionV0SpecSchema = z.object({
40
+ kind: z.literal('prediction.v0'),
41
+ oracle: z.object({
42
+ venue: z.enum(['chainlink-base-sepolia', 'chainlink-base']),
43
+ feed: HexStringSchema,
44
+ feedDescription: z.string(),
45
+ }),
46
+ question: z.discriminatedUnion('kind', [ThresholdQuestionSchema, RangeQuestionSchema]),
47
+ });
48
+ export const PredictionV0EligibilitySchema = z.object({
49
+ maxSubmissionDelayMs: z.number().int().default(60_000),
50
+ });
51
+ export const PredictionV0IntentSchema = z
52
+ .object({
53
+ id: z.string(),
54
+ description: z.string().min(1),
55
+ window: WindowSchema,
56
+ spec: PredictionV0SpecSchema,
57
+ eligibility: PredictionV0EligibilitySchema.default({}),
58
+ })
59
+ .refine(d => d.window.endTs > d.window.startTs, {
60
+ message: 'window.endTs must be > window.startTs',
61
+ path: ['window'],
62
+ })
63
+ .refine(d => d.window.endTs - d.window.startTs >= 60_000, {
64
+ message: 'window must be at least 1 minute',
65
+ path: ['window'],
66
+ })
67
+ .refine(d => d.window.endTs - d.window.startTs <= 86_400_000, {
68
+ message: 'window must be at most 24 hours',
69
+ path: ['window'],
70
+ })
71
+ .refine(d => d.spec.question.resolveTs >= d.window.endTs, {
72
+ message: 'resolveTs must be ≥ window.endTs',
73
+ path: ['spec', 'question', 'resolveTs'],
74
+ })
75
+ .refine(d => d.spec.question.resolveTs - d.window.endTs <= 3_600_000, {
76
+ message: 'resolve gap (resolveTs - endTs) must be ≤ 1 hour',
77
+ path: ['spec', 'question', 'resolveTs'],
78
+ });
79
+ // ── Submission manifest ───────────────────────────────────────────────────────
80
+ export const PredictionSubmissionManifestSchema = z.object({
81
+ schemaVersion: z.literal('prediction.v0.submission.v1'),
82
+ generatedAt: z.number().int(),
83
+ intent: IntentProvenanceSchema,
84
+ restorer: ParticipantSchema,
85
+ window: WindowSchema,
86
+ prediction: z.object({
87
+ probability: z.string().regex(/^(0(\.\d+)?|1(\.0+)?)$/, 'must be a decimal in [0,1]'),
88
+ submittedAt: z.number().int(),
89
+ modelId: z.string().min(1),
90
+ }),
91
+ oracleSnapshot: z
92
+ .object({
93
+ feed: HexStringSchema,
94
+ roundId: z.string(),
95
+ answer: z.string(),
96
+ updatedAt: z.number().int(),
97
+ })
98
+ .optional(),
99
+ rationale: z
100
+ .array(z.object({
101
+ ts: z.number().int(),
102
+ note: z.string(),
103
+ }))
104
+ .optional(),
105
+ signature: SignatureSchema,
106
+ });
107
+ // ── Verdict manifest ──────────────────────────────────────────────────────────
108
+ const CheckSchema = z.object({
109
+ name: z.string(),
110
+ status: z.enum(['PASS', 'FAIL', 'SKIP', 'INDETERMINATE']),
111
+ detail: z.union([z.string(), z.record(z.unknown())]).optional(),
112
+ });
113
+ export const PredictionVerdictManifestSchema = z.object({
114
+ schemaVersion: z.literal('prediction.v0.verdict.v1'),
115
+ generatedAt: z.number().int(),
116
+ intent: IntentProvenanceSchema,
117
+ evaluator: ParticipantSchema,
118
+ window: WindowSchema,
119
+ verdict: z.enum(['PASS', 'FAIL', 'REJECTED', 'INDETERMINATE']),
120
+ score: z.string(),
121
+ scoreBasis: z.literal('brier.v1'),
122
+ scoreVersion: z.string(),
123
+ oracleReading: z.object({
124
+ feed: HexStringSchema,
125
+ roundId: z.string(),
126
+ answer: z.string(),
127
+ updatedAt: z.number().int(),
128
+ nextRoundUpdatedAt: z.number().int().optional(),
129
+ }),
130
+ claimed: z.object({
131
+ probability: z.string(),
132
+ submittedAt: z.number().int(),
133
+ modelId: z.string(),
134
+ /** Present when the submission was registered on IPFS; omitted for inline/dev. */
135
+ submissionManifestCid: z.string().min(1).optional(),
136
+ }),
137
+ groundTruth: z.enum(['YES', 'NO']),
138
+ checks: z.array(CheckSchema),
139
+ signature: SignatureSchema,
140
+ });
141
+ //# sourceMappingURL=prediction.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prediction.js","sourceRoot":"","sources":["../../src/types/prediction.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ export interface AaveReserveAddressSet {
2
+ pool: `0x${string}`;
3
+ reserve: `0x${string}`;
4
+ symbol: string;
5
+ }
6
+ export declare const AAVE_V3_USDC: Record<'aave-v3-base-sepolia' | 'aave-v3-base' | 'aave-v3-mainnet', AaveReserveAddressSet>;
@@ -0,0 +1,19 @@
1
+ export const AAVE_V3_USDC = {
2
+ 'aave-v3-base-sepolia': {
3
+ // Base Sepolia pool proxy + USDC reserve (Aave v3 test deployment).
4
+ pool: '0x6Ae43d3271ff6888e7Fc43Fd7321a503ff738951',
5
+ reserve: '0x31d3A7711a10C45D72649D51E1c8D74282702572',
6
+ symbol: 'USDC',
7
+ },
8
+ 'aave-v3-base': {
9
+ pool: '0xA238Dd80C259a72e81d7e4664a9801593F98d1c5',
10
+ reserve: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
11
+ symbol: 'USDC',
12
+ },
13
+ 'aave-v3-mainnet': {
14
+ pool: '0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2',
15
+ reserve: '0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
16
+ symbol: 'USDC',
17
+ },
18
+ };
19
+ //# sourceMappingURL=addresses.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"addresses.js","sourceRoot":"","sources":["../../../src/venues/aave-v3/addresses.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,YAAY,GAA+F;IACtH,sBAAsB,EAAE;QACtB,oEAAoE;QACpE,IAAI,EAAE,4CAA4C;QAClD,OAAO,EAAE,4CAA4C;QACrD,MAAM,EAAE,MAAM;KACf;IACD,cAAc,EAAE;QACd,IAAI,EAAE,4CAA4C;QAClD,OAAO,EAAE,4CAA4C;QACrD,MAAM,EAAE,MAAM;KACf;IACD,iBAAiB,EAAE;QACjB,IAAI,EAAE,4CAA4C;QAClD,OAAO,EAAE,4CAA4C;QACrD,MAAM,EAAE,MAAM;KACf;CACF,CAAC"}
@@ -0,0 +1,85 @@
1
+ import type { PublicClient } from 'viem';
2
+ export declare const AAVE_POOL_ABI: readonly [{
3
+ readonly name: "getReserveData";
4
+ readonly type: "function";
5
+ readonly stateMutability: "view";
6
+ readonly inputs: readonly [{
7
+ readonly name: "asset";
8
+ readonly type: "address";
9
+ }];
10
+ readonly outputs: readonly [{
11
+ readonly name: "configuration";
12
+ readonly type: "uint256";
13
+ }, {
14
+ readonly name: "liquidityIndex";
15
+ readonly type: "uint128";
16
+ }, {
17
+ readonly name: "currentLiquidityRate";
18
+ readonly type: "uint128";
19
+ }, {
20
+ readonly name: "variableBorrowIndex";
21
+ readonly type: "uint128";
22
+ }, {
23
+ readonly name: "currentVariableBorrowRate";
24
+ readonly type: "uint128";
25
+ }, {
26
+ readonly name: "currentStableBorrowRate";
27
+ readonly type: "uint128";
28
+ }, {
29
+ readonly name: "lastUpdateTimestamp";
30
+ readonly type: "uint40";
31
+ }, {
32
+ readonly name: "id";
33
+ readonly type: "uint16";
34
+ }, {
35
+ readonly name: "aTokenAddress";
36
+ readonly type: "address";
37
+ }, {
38
+ readonly name: "stableDebtTokenAddress";
39
+ readonly type: "address";
40
+ }, {
41
+ readonly name: "variableDebtTokenAddress";
42
+ readonly type: "address";
43
+ }, {
44
+ readonly name: "interestRateStrategyAddress";
45
+ readonly type: "address";
46
+ }, {
47
+ readonly name: "accruedToTreasury";
48
+ readonly type: "uint128";
49
+ }, {
50
+ readonly name: "unbacked";
51
+ readonly type: "uint128";
52
+ }, {
53
+ readonly name: "isolationModeTotalDebt";
54
+ readonly type: "uint128";
55
+ }];
56
+ }];
57
+ export interface ReserveRateReading {
58
+ blockNumber: bigint;
59
+ blockTimestampMs: number;
60
+ currentLiquidityRateRay: bigint;
61
+ }
62
+ export interface TwaApyBpsResult {
63
+ twApyBps: number;
64
+ sampleCount: number;
65
+ sampleTimestampsMs: number[];
66
+ }
67
+ export declare function scheduleSampleTimestamps(windowEndTs: number, twaWindowSeconds: number, sampleCount: number): number[];
68
+ export declare function liquidityRateRayToApyBps(rateRay: bigint): number;
69
+ export declare function findBlockAtOrBeforeTimestamp(publicClient: PublicClient, targetTsMs: number, options?: {
70
+ minBlock?: bigint;
71
+ }): Promise<{
72
+ number: bigint;
73
+ timestampMs: number;
74
+ }>;
75
+ export declare function readReserveRateAtTimestamp(publicClient: PublicClient, pool: `0x${string}`, reserve: `0x${string}`, timestampMs: number, options?: {
76
+ minBlockForSearch?: bigint;
77
+ }): Promise<ReserveRateReading>;
78
+ export declare function twApyBpsOverWindow(params: {
79
+ publicClient: PublicClient;
80
+ pool: `0x${string}`;
81
+ reserve: `0x${string}`;
82
+ windowEndTs: number;
83
+ twaWindowSeconds: number;
84
+ sampleCount: number;
85
+ }): Promise<TwaApyBpsResult>;
@@ -0,0 +1,106 @@
1
+ export const AAVE_POOL_ABI = [
2
+ {
3
+ name: 'getReserveData',
4
+ type: 'function',
5
+ stateMutability: 'view',
6
+ inputs: [{ name: 'asset', type: 'address' }],
7
+ outputs: [
8
+ { name: 'configuration', type: 'uint256' },
9
+ { name: 'liquidityIndex', type: 'uint128' },
10
+ { name: 'currentLiquidityRate', type: 'uint128' },
11
+ { name: 'variableBorrowIndex', type: 'uint128' },
12
+ { name: 'currentVariableBorrowRate', type: 'uint128' },
13
+ { name: 'currentStableBorrowRate', type: 'uint128' },
14
+ { name: 'lastUpdateTimestamp', type: 'uint40' },
15
+ { name: 'id', type: 'uint16' },
16
+ { name: 'aTokenAddress', type: 'address' },
17
+ { name: 'stableDebtTokenAddress', type: 'address' },
18
+ { name: 'variableDebtTokenAddress', type: 'address' },
19
+ { name: 'interestRateStrategyAddress', type: 'address' },
20
+ { name: 'accruedToTreasury', type: 'uint128' },
21
+ { name: 'unbacked', type: 'uint128' },
22
+ { name: 'isolationModeTotalDebt', type: 'uint128' },
23
+ ],
24
+ },
25
+ ];
26
+ const RAY = 10n ** 27n;
27
+ const SECONDS_PER_YEAR = 31536000n;
28
+ export function scheduleSampleTimestamps(windowEndTs, twaWindowSeconds, sampleCount) {
29
+ if (sampleCount < 2)
30
+ throw new Error('sampleCount must be >= 2');
31
+ const windowMs = twaWindowSeconds * 1000;
32
+ const start = windowEndTs - windowMs;
33
+ if (start < 0)
34
+ throw new Error('twa window starts before unix epoch');
35
+ const step = Math.floor(windowMs / (sampleCount - 1));
36
+ if (step <= 0)
37
+ throw new Error('sample spacing must be positive');
38
+ const ts = [];
39
+ for (let i = 0; i < sampleCount; i++)
40
+ ts.push(start + i * step);
41
+ ts[ts.length - 1] = windowEndTs;
42
+ return ts;
43
+ }
44
+ export function liquidityRateRayToApyBps(rateRay) {
45
+ const apr = Number(rateRay) / Number(RAY);
46
+ const apy = Math.pow(1 + apr / Number(SECONDS_PER_YEAR), Number(SECONDS_PER_YEAR)) - 1;
47
+ return Math.round(apy * 10_000);
48
+ }
49
+ export async function findBlockAtOrBeforeTimestamp(publicClient, targetTsMs, options) {
50
+ const latest = await publicClient.getBlock({ blockTag: 'latest' });
51
+ let lo = options?.minBlock ?? 0n;
52
+ if (lo > latest.number) {
53
+ lo = 0n;
54
+ }
55
+ let hi = latest.number;
56
+ let best = 0n;
57
+ while (lo <= hi) {
58
+ const mid = (lo + hi) / 2n;
59
+ const block = await publicClient.getBlock({ blockNumber: mid });
60
+ const tsMs = Number(block.timestamp) * 1000;
61
+ if (tsMs <= targetTsMs) {
62
+ best = mid;
63
+ lo = mid + 1n;
64
+ }
65
+ else {
66
+ hi = mid - 1n;
67
+ }
68
+ }
69
+ const b = await publicClient.getBlock({ blockNumber: best });
70
+ return { number: b.number, timestampMs: Number(b.timestamp) * 1000 };
71
+ }
72
+ export async function readReserveRateAtTimestamp(publicClient, pool, reserve, timestampMs, options) {
73
+ const block = await findBlockAtOrBeforeTimestamp(publicClient, timestampMs, {
74
+ minBlock: options?.minBlockForSearch,
75
+ });
76
+ const reserveData = await publicClient.readContract({
77
+ address: pool,
78
+ abi: AAVE_POOL_ABI,
79
+ functionName: 'getReserveData',
80
+ args: [reserve],
81
+ blockNumber: block.number,
82
+ });
83
+ return {
84
+ blockNumber: block.number,
85
+ blockTimestampMs: block.timestampMs,
86
+ currentLiquidityRateRay: reserveData[2],
87
+ };
88
+ }
89
+ export async function twApyBpsOverWindow(params) {
90
+ const sampleTs = scheduleSampleTimestamps(params.windowEndTs, params.twaWindowSeconds, params.sampleCount);
91
+ let sum = 0;
92
+ let minBlock;
93
+ for (const ts of sampleTs) {
94
+ const r = await readReserveRateAtTimestamp(params.publicClient, params.pool, params.reserve, ts, {
95
+ minBlockForSearch: minBlock,
96
+ });
97
+ minBlock = r.blockNumber;
98
+ sum += liquidityRateRayToApyBps(r.currentLiquidityRateRay);
99
+ }
100
+ return {
101
+ twApyBps: Math.round(sum / sampleTs.length),
102
+ sampleCount: sampleTs.length,
103
+ sampleTimestampsMs: sampleTs,
104
+ };
105
+ }
106
+ //# sourceMappingURL=client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/venues/aave-v3/client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,99 @@
1
+ /**
2
+ * Chainlink AggregatorV3 read client.
3
+ *
4
+ * §7 of spec/2026-04-20-prediction-v0-pis-phase-1-design.md
5
+ */
6
+ import type { PublicClient } from 'viem';
7
+ export declare const AGGREGATOR_V3_ABI: readonly [{
8
+ readonly name: "latestRoundData";
9
+ readonly type: "function";
10
+ readonly stateMutability: "view";
11
+ readonly inputs: readonly [];
12
+ readonly outputs: readonly [{
13
+ readonly name: "roundId";
14
+ readonly type: "uint80";
15
+ }, {
16
+ readonly name: "answer";
17
+ readonly type: "int256";
18
+ }, {
19
+ readonly name: "startedAt";
20
+ readonly type: "uint256";
21
+ }, {
22
+ readonly name: "updatedAt";
23
+ readonly type: "uint256";
24
+ }, {
25
+ readonly name: "answeredInRound";
26
+ readonly type: "uint80";
27
+ }];
28
+ }, {
29
+ readonly name: "getRoundData";
30
+ readonly type: "function";
31
+ readonly stateMutability: "view";
32
+ readonly inputs: readonly [{
33
+ readonly name: "_roundId";
34
+ readonly type: "uint80";
35
+ }];
36
+ readonly outputs: readonly [{
37
+ readonly name: "roundId";
38
+ readonly type: "uint80";
39
+ }, {
40
+ readonly name: "answer";
41
+ readonly type: "int256";
42
+ }, {
43
+ readonly name: "startedAt";
44
+ readonly type: "uint256";
45
+ }, {
46
+ readonly name: "updatedAt";
47
+ readonly type: "uint256";
48
+ }, {
49
+ readonly name: "answeredInRound";
50
+ readonly type: "uint80";
51
+ }];
52
+ }, {
53
+ readonly name: "decimals";
54
+ readonly type: "function";
55
+ readonly stateMutability: "view";
56
+ readonly inputs: readonly [];
57
+ readonly outputs: readonly [{
58
+ readonly name: "";
59
+ readonly type: "uint8";
60
+ }];
61
+ }, {
62
+ readonly name: "description";
63
+ readonly type: "function";
64
+ readonly stateMutability: "view";
65
+ readonly inputs: readonly [];
66
+ readonly outputs: readonly [{
67
+ readonly name: "";
68
+ readonly type: "string";
69
+ }];
70
+ }];
71
+ export interface RoundReading {
72
+ roundId: bigint;
73
+ answer: bigint;
74
+ startedAt: number;
75
+ updatedAt: number;
76
+ answeredInRound: bigint;
77
+ decimals: number;
78
+ }
79
+ /** Scale a raw Chainlink int256 answer to a decimal string. */
80
+ export declare function scaleToDecimal(answer: bigint, decimals: number): string;
81
+ export declare function readChainlinkLatest(feed: `0x${string}`, publicClient: PublicClient): Promise<RoundReading>;
82
+ export declare function readChainlinkRound(feed: `0x${string}`, roundId: bigint, publicClient: PublicClient, decimals: number): Promise<RoundReading>;
83
+ export interface SpanningResult {
84
+ /** Round R with updatedAt ≤ resolveTs. */
85
+ round: RoundReading;
86
+ /** Round R+1 with updatedAt > resolveTs. null if no newer round exists yet. */
87
+ nextRound: RoundReading | null;
88
+ /** True iff nextRound exists — then the spanning property is satisfied. */
89
+ spanning: boolean;
90
+ }
91
+ /**
92
+ * Find the Chainlink round that "spans" resolveTs: round R where
93
+ * R.updatedAt ≤ resolveTs < (R+1).updatedAt.
94
+ *
95
+ * If the latest round's updatedAt ≤ resolveTs (i.e. no newer round yet),
96
+ * returns { round: latest, nextRound: null, spanning: false }. Caller should
97
+ * retry later (availability check will mark SKIP → INDETERMINATE verdict).
98
+ */
99
+ export declare function oraclePriceAtResolveTs(feed: `0x${string}`, resolveTs: number, publicClient: PublicClient): Promise<SpanningResult>;
@@ -0,0 +1,130 @@
1
+ export const AGGREGATOR_V3_ABI = [
2
+ {
3
+ name: 'latestRoundData',
4
+ type: 'function',
5
+ stateMutability: 'view',
6
+ inputs: [],
7
+ outputs: [
8
+ { name: 'roundId', type: 'uint80' },
9
+ { name: 'answer', type: 'int256' },
10
+ { name: 'startedAt', type: 'uint256' },
11
+ { name: 'updatedAt', type: 'uint256' },
12
+ { name: 'answeredInRound', type: 'uint80' },
13
+ ],
14
+ },
15
+ {
16
+ name: 'getRoundData',
17
+ type: 'function',
18
+ stateMutability: 'view',
19
+ inputs: [{ name: '_roundId', type: 'uint80' }],
20
+ outputs: [
21
+ { name: 'roundId', type: 'uint80' },
22
+ { name: 'answer', type: 'int256' },
23
+ { name: 'startedAt', type: 'uint256' },
24
+ { name: 'updatedAt', type: 'uint256' },
25
+ { name: 'answeredInRound', type: 'uint80' },
26
+ ],
27
+ },
28
+ {
29
+ name: 'decimals',
30
+ type: 'function',
31
+ stateMutability: 'view',
32
+ inputs: [],
33
+ outputs: [{ name: '', type: 'uint8' }],
34
+ },
35
+ {
36
+ name: 'description',
37
+ type: 'function',
38
+ stateMutability: 'view',
39
+ inputs: [],
40
+ outputs: [{ name: '', type: 'string' }],
41
+ },
42
+ ];
43
+ /** Scale a raw Chainlink int256 answer to a decimal string. */
44
+ export function scaleToDecimal(answer, decimals) {
45
+ if (answer < 0n) {
46
+ throw new Error(`scaleToDecimal: negative value not supported in v0 (got ${answer})`);
47
+ }
48
+ const s = answer.toString();
49
+ if (decimals === 0)
50
+ return s;
51
+ if (s.length <= decimals) {
52
+ const frac = s.padStart(decimals, '0').replace(/0+$/, '');
53
+ return frac.length > 0 ? `0.${frac}` : '0';
54
+ }
55
+ const intPart = s.slice(0, s.length - decimals);
56
+ const fracRaw = s.slice(s.length - decimals);
57
+ const frac = fracRaw.replace(/0+$/, '');
58
+ return frac.length > 0 ? `${intPart}.${frac}` : intPart;
59
+ }
60
+ export async function readChainlinkLatest(feed, publicClient) {
61
+ const [latest, decimals] = await Promise.all([
62
+ publicClient.readContract({
63
+ address: feed,
64
+ abi: AGGREGATOR_V3_ABI,
65
+ functionName: 'latestRoundData',
66
+ }),
67
+ publicClient.readContract({
68
+ address: feed,
69
+ abi: AGGREGATOR_V3_ABI,
70
+ functionName: 'decimals',
71
+ }),
72
+ ]);
73
+ const [roundId, answer, startedAt, updatedAt, answeredInRound] = latest;
74
+ return {
75
+ roundId,
76
+ answer,
77
+ // Chainlink timestamps are SECONDS → convert to ms for consistency with rest of codebase
78
+ startedAt: Number(startedAt) * 1000,
79
+ updatedAt: Number(updatedAt) * 1000,
80
+ answeredInRound,
81
+ decimals: decimals,
82
+ };
83
+ }
84
+ export async function readChainlinkRound(feed, roundId, publicClient, decimals) {
85
+ const round = await publicClient.readContract({
86
+ address: feed,
87
+ abi: AGGREGATOR_V3_ABI,
88
+ functionName: 'getRoundData',
89
+ args: [roundId],
90
+ });
91
+ const [rid, answer, startedAt, updatedAt, answeredInRound] = round;
92
+ return {
93
+ roundId: rid,
94
+ answer,
95
+ startedAt: Number(startedAt) * 1000,
96
+ updatedAt: Number(updatedAt) * 1000,
97
+ answeredInRound,
98
+ decimals,
99
+ };
100
+ }
101
+ /**
102
+ * Find the Chainlink round that "spans" resolveTs: round R where
103
+ * R.updatedAt ≤ resolveTs < (R+1).updatedAt.
104
+ *
105
+ * If the latest round's updatedAt ≤ resolveTs (i.e. no newer round yet),
106
+ * returns { round: latest, nextRound: null, spanning: false }. Caller should
107
+ * retry later (availability check will mark SKIP → INDETERMINATE verdict).
108
+ */
109
+ export async function oraclePriceAtResolveTs(feed, resolveTs, publicClient) {
110
+ const latest = await readChainlinkLatest(feed, publicClient);
111
+ // Case A: latest is at-or-before resolveTs → no newer round yet
112
+ if (latest.updatedAt <= resolveTs) {
113
+ return { round: latest, nextRound: null, spanning: false };
114
+ }
115
+ // Case B: latest is after resolveTs → walk back to find spanning round
116
+ let nextRound = latest;
117
+ let cursor = latest.roundId - 1n;
118
+ while (cursor > 0n) {
119
+ const r = await readChainlinkRound(feed, cursor, publicClient, latest.decimals);
120
+ if (r.updatedAt <= resolveTs) {
121
+ return { round: r, nextRound, spanning: true };
122
+ }
123
+ nextRound = r;
124
+ cursor -= 1n;
125
+ }
126
+ // Walked back to round 0 without finding a pre-resolveTs round — oracle is
127
+ // newer than the window. Surface as not-spanning so caller INDETERMINATE-s.
128
+ return { round: latest, nextRound: null, spanning: false };
129
+ }
130
+ //# sourceMappingURL=client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/venues/chainlink/client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ /** Known Chainlink AggregatorV3 feeds on Base + Base Sepolia. */
2
+ export declare const BASE_SEPOLIA_FEEDS: {
3
+ readonly 'ETH / USD': "0x4aDC67696bA383F43DD60A9e78F2C97Fbbfc7cb1";
4
+ readonly 'BTC / USD': "0x0FB99723Aee6f420beAD13e6bBB79b7E6F034298";
5
+ };
6
+ export declare const BASE_FEEDS: {
7
+ readonly 'ETH / USD': "0x71041dddad3595F9CEd3DcCFBe3D1F4b0a16Bb70";
8
+ };
@@ -0,0 +1,9 @@
1
+ /** Known Chainlink AggregatorV3 feeds on Base + Base Sepolia. */
2
+ export const BASE_SEPOLIA_FEEDS = {
3
+ 'ETH / USD': '0x4aDC67696bA383F43DD60A9e78F2C97Fbbfc7cb1',
4
+ 'BTC / USD': '0x0FB99723Aee6f420beAD13e6bBB79b7E6F034298',
5
+ };
6
+ export const BASE_FEEDS = {
7
+ 'ETH / USD': '0x71041dddad3595F9CEd3DcCFBe3D1F4b0a16Bb70',
8
+ };
9
+ //# sourceMappingURL=feeds.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"feeds.js","sourceRoot":"","sources":["../../../src/venues/chainlink/feeds.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,WAAW,EAAE,4CAAqD;IAClE,WAAW,EAAE,4CAAqD;CAC1D,CAAC;AAEX,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,WAAW,EAAE,4CAAqD;CAC1D,CAAC"}