@oracle-agent/oracle 0.14.0 → 0.15.0

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 (447) hide show
  1. package/README.md +2 -2
  2. package/SETUP.md +4 -4
  3. package/dist/action-receipts.mjs +1 -0
  4. package/dist/action-semantics.mjs +1 -0
  5. package/dist/address-book.mjs +2 -0
  6. package/dist/bin/desk-server.mjs +59 -0
  7. package/dist/bin/oracle-data-mcp.mjs +8 -0
  8. package/dist/bin/oracle-equities.mjs +20 -0
  9. package/dist/bin/oracle-init.mjs +24 -0
  10. package/dist/bin/oracle-public-server.mjs +5 -0
  11. package/dist/bin/oracle-route.mjs +22 -0
  12. package/dist/bin/oracle-scan.mjs +18 -0
  13. package/dist/bin/oracle-upgrade.mjs +21 -0
  14. package/dist/bin/oracle.mjs +61 -0
  15. package/dist/chains.mjs +1 -0
  16. package/dist/cli/commands/auth.mjs +16 -0
  17. package/dist/cli/commands/bootstrap.mjs +18 -0
  18. package/dist/cli/commands/chain.mjs +21 -0
  19. package/dist/cli/commands/chat.mjs +45 -0
  20. package/dist/cli/commands/credential.mjs +1 -0
  21. package/dist/cli/commands/data-mcp.mjs +2 -0
  22. package/dist/cli/commands/data.mjs +12 -0
  23. package/dist/cli/commands/doctor.mjs +5 -0
  24. package/dist/cli/commands/equities.mjs +15 -0
  25. package/dist/cli/commands/farm.mjs +59 -0
  26. package/dist/cli/commands/fees.mjs +10 -0
  27. package/dist/cli/commands/follow.mjs +28 -0
  28. package/dist/cli/commands/harness.mjs +15 -0
  29. package/dist/cli/commands/help.mjs +1 -0
  30. package/dist/cli/commands/init.mjs +3 -0
  31. package/dist/cli/commands/mcp.mjs +36 -0
  32. package/dist/cli/commands/model.mjs +54 -0
  33. package/dist/cli/commands/plugins.mjs +43 -0
  34. package/dist/cli/commands/prepare.mjs +2 -0
  35. package/dist/cli/commands/public.mjs +3 -0
  36. package/dist/cli/commands/resolve.mjs +23 -0
  37. package/dist/cli/commands/route.mjs +2 -0
  38. package/dist/cli/commands/runner.mjs +1 -0
  39. package/dist/cli/commands/scan.mjs +2 -0
  40. package/dist/cli/commands/setup.mjs +34 -0
  41. package/dist/cli/commands/sign.mjs +4 -0
  42. package/dist/cli/commands/signer.mjs +1 -0
  43. package/dist/cli/commands/swap.mjs +36 -0
  44. package/dist/cli/commands/upgrade.mjs +2 -0
  45. package/dist/cli/commands/vault.mjs +1 -0
  46. package/dist/cli/commands/version.mjs +2 -0
  47. package/dist/data/desk-data.mjs +55 -0
  48. package/dist/data/names.mjs +2 -0
  49. package/dist/data/providers/farming.mjs +2 -0
  50. package/dist/equities/index.mjs +1 -0
  51. package/dist/index.mjs +60 -0
  52. package/dist/nft-gas-war-guard.mjs +1 -0
  53. package/dist/onboarding/harness-configs.mjs +4 -0
  54. package/dist/portfolio-risk.mjs +1 -0
  55. package/dist/prepare-envelope.mjs +1 -0
  56. package/dist/public-api/agent-grants.mjs +3 -0
  57. package/dist/public-control/policy-schema.mjs +1 -0
  58. package/dist/router/index.mjs +2 -0
  59. package/dist/scanner/index.mjs +4 -0
  60. package/dist/signals/index.mjs +1 -0
  61. package/dist/watch-preferences.mjs +1 -0
  62. package/package.json +32 -78
  63. package/public/oracle-splash/_variants/ice.html +5 -18
  64. package/public/oracle-splash/_variants/ivory.html +5 -18
  65. package/public/oracle-splash/index.html +114 -34
  66. package/CONTRIBUTING.md +0 -99
  67. package/bin/desk-server.mjs +0 -473
  68. package/bin/oracle-data-mcp.mjs +0 -1252
  69. package/bin/oracle-equities.mjs +0 -168
  70. package/bin/oracle-init.mjs +0 -525
  71. package/bin/oracle-public-server.mjs +0 -36
  72. package/bin/oracle-route.mjs +0 -254
  73. package/bin/oracle-scan.mjs +0 -192
  74. package/bin/oracle-upgrade.mjs +0 -42
  75. package/bin/oracle.mjs +0 -34
  76. package/docs/adding-a-chain.md +0 -229
  77. package/docs/architecture.md +0 -139
  78. package/docs/buzz-integration.md +0 -115
  79. package/docs/cli.md +0 -143
  80. package/docs/connectors.md +0 -13
  81. package/docs/hyperliquid-builder-code.md +0 -50
  82. package/docs/locals-only-fee-waiver.md +0 -34
  83. package/docs/oracle-pack-standard.md +0 -29
  84. package/docs/profiles.md +0 -151
  85. package/docs/public-surface.md +0 -206
  86. package/examples/add-a-chain.mjs +0 -65
  87. package/examples/oracle-pack-template.mjs +0 -38
  88. package/examples/research-a-token.mjs +0 -70
  89. package/plugins/oracle-owner-gate/__init__.py +0 -288
  90. package/plugins/oracle-owner-gate/plugin.yaml +0 -9
  91. package/protocols/templates/safe-erc20/SECURITY.md +0 -16
  92. package/protocols/templates/safe-erc20/foundry.toml +0 -12
  93. package/protocols/templates/safe-erc20/remappings.txt +0 -2
  94. package/protocols/templates/safe-erc20/src/SafeERC20.sol +0 -53
  95. package/protocols/templates/safe-erc20/test/SafeERC20.t.sol +0 -72
  96. package/scripts/adversarial-bench.mjs +0 -114
  97. package/scripts/build-dist.mjs +0 -119
  98. package/scripts/build-inscription.py +0 -230
  99. package/scripts/check-doc-drift.mjs +0 -123
  100. package/scripts/check-test-count.mjs +0 -105
  101. package/scripts/e2e-hl-markets.mjs +0 -21
  102. package/scripts/e2e-hl-perps.mjs +0 -48
  103. package/scripts/e2e-hypercore-staking.mjs +0 -128
  104. package/scripts/e2e-solana-bitcoin.mjs +0 -183
  105. package/scripts/guard-publish.mjs +0 -22
  106. package/scripts/protocol-template-gate.mjs +0 -15
  107. package/scripts/public-api-scan.mjs +0 -23
  108. package/scripts/publish-dist.mjs +0 -67
  109. package/scripts/record-hero-cli.sh +0 -80
  110. package/scripts/secret-scan.mjs +0 -168
  111. package/scripts/smoke-dist-bins.mjs +0 -89
  112. package/scripts/verify-dist.mjs +0 -29
  113. package/scripts/verify-v3-venues.mjs +0 -233
  114. package/skins/oracle.yaml +0 -56
  115. package/src/action-receipts.mjs +0 -265
  116. package/src/action-semantics.mjs +0 -62
  117. package/src/address-book.mjs +0 -208
  118. package/src/agent-auth.mjs +0 -206
  119. package/src/approval-guard.mjs +0 -282
  120. package/src/attestation-secret.mjs +0 -94
  121. package/src/audit-log.mjs +0 -196
  122. package/src/auth/oauth.mjs +0 -672
  123. package/src/auto-slippage.mjs +0 -378
  124. package/src/capability-posture.mjs +0 -125
  125. package/src/cards.mjs +0 -422
  126. package/src/chains.mjs +0 -62
  127. package/src/cli/chain-catalog.mjs +0 -215
  128. package/src/cli/chain-state.mjs +0 -74
  129. package/src/cli/commands/auth.mjs +0 -193
  130. package/src/cli/commands/bootstrap.mjs +0 -87
  131. package/src/cli/commands/chain.mjs +0 -143
  132. package/src/cli/commands/chat.mjs +0 -465
  133. package/src/cli/commands/credential.mjs +0 -9
  134. package/src/cli/commands/data-mcp.mjs +0 -18
  135. package/src/cli/commands/data.mjs +0 -75
  136. package/src/cli/commands/doctor.mjs +0 -136
  137. package/src/cli/commands/equities.mjs +0 -41
  138. package/src/cli/commands/farm.mjs +0 -129
  139. package/src/cli/commands/fees.mjs +0 -109
  140. package/src/cli/commands/follow.mjs +0 -130
  141. package/src/cli/commands/harness.mjs +0 -63
  142. package/src/cli/commands/help.mjs +0 -7
  143. package/src/cli/commands/init.mjs +0 -27
  144. package/src/cli/commands/mcp.mjs +0 -154
  145. package/src/cli/commands/model.mjs +0 -106
  146. package/src/cli/commands/plugins.mjs +0 -241
  147. package/src/cli/commands/prepare.mjs +0 -12
  148. package/src/cli/commands/public.mjs +0 -20
  149. package/src/cli/commands/resolve.mjs +0 -64
  150. package/src/cli/commands/route.mjs +0 -12
  151. package/src/cli/commands/runner.mjs +0 -9
  152. package/src/cli/commands/scan.mjs +0 -12
  153. package/src/cli/commands/setup.mjs +0 -294
  154. package/src/cli/commands/sign.mjs +0 -21
  155. package/src/cli/commands/signer.mjs +0 -9
  156. package/src/cli/commands/swap.mjs +0 -102
  157. package/src/cli/commands/upgrade.mjs +0 -12
  158. package/src/cli/commands/vault.mjs +0 -9
  159. package/src/cli/commands/version.mjs +0 -22
  160. package/src/cli/first-run.mjs +0 -23
  161. package/src/cli/kernel.mjs +0 -262
  162. package/src/cli/mcp-targets/chatgpt.mjs +0 -51
  163. package/src/cli/mcp-targets/claude-code.mjs +0 -39
  164. package/src/cli/mcp-targets/claude-desktop.mjs +0 -24
  165. package/src/cli/mcp-targets/codex.mjs +0 -41
  166. package/src/cli/mcp-targets/cursor.mjs +0 -32
  167. package/src/cli/mcp-targets/shared.mjs +0 -71
  168. package/src/cli/mcp-targets/vscode.mjs +0 -39
  169. package/src/cli/messaging-platforms.mjs +0 -217
  170. package/src/cli/model-config.mjs +0 -78
  171. package/src/cli/operator-dispatch.mjs +0 -257
  172. package/src/cli/oracle-harness.py +0 -415
  173. package/src/cli/paths.mjs +0 -107
  174. package/src/cli/runtime.mjs +0 -351
  175. package/src/cli/setup-state.mjs +0 -168
  176. package/src/cli/spawn-child.mjs +0 -43
  177. package/src/data/catalog.mjs +0 -858
  178. package/src/data/desk-data.mjs +0 -877
  179. package/src/data/http.mjs +0 -253
  180. package/src/data/names.mjs +0 -188
  181. package/src/data/provider-endpoint.mjs +0 -94
  182. package/src/data/providers/aave-v3.mjs +0 -139
  183. package/src/data/providers/across-bridge.mjs +0 -41
  184. package/src/data/providers/aerodrome.mjs +0 -245
  185. package/src/data/providers/aevo.mjs +0 -33
  186. package/src/data/providers/approval-indexer.mjs +0 -133
  187. package/src/data/providers/approvals.mjs +0 -594
  188. package/src/data/providers/babylon-staking.mjs +0 -149
  189. package/src/data/providers/balancer.mjs +0 -209
  190. package/src/data/providers/beefy-yields.mjs +0 -45
  191. package/src/data/providers/birdeye-tokens.mjs +0 -33
  192. package/src/data/providers/bisq-markets.mjs +0 -145
  193. package/src/data/providers/bitcoin-esplora.mjs +0 -216
  194. package/src/data/providers/bitcoin-meta.mjs +0 -378
  195. package/src/data/providers/blockscout.mjs +0 -14
  196. package/src/data/providers/bob-rootstock.mjs +0 -198
  197. package/src/data/providers/braiins-insights.mjs +0 -103
  198. package/src/data/providers/bridge-aggregator.mjs +0 -259
  199. package/src/data/providers/bridges.mjs +0 -242
  200. package/src/data/providers/bungee.mjs +0 -29
  201. package/src/data/providers/celestia-da.mjs +0 -38
  202. package/src/data/providers/changenow.mjs +0 -135
  203. package/src/data/providers/compound.mjs +0 -32
  204. package/src/data/providers/connext.mjs +0 -28
  205. package/src/data/providers/convex.mjs +0 -30
  206. package/src/data/providers/cow-protocol.mjs +0 -110
  207. package/src/data/providers/cowswap.mjs +0 -415
  208. package/src/data/providers/curve.mjs +0 -201
  209. package/src/data/providers/das-assets.mjs +0 -59
  210. package/src/data/providers/debridge.mjs +0 -109
  211. package/src/data/providers/defillama.mjs +0 -88
  212. package/src/data/providers/dexscreener.mjs +0 -43
  213. package/src/data/providers/drift.mjs +0 -32
  214. package/src/data/providers/dydx.mjs +0 -41
  215. package/src/data/providers/evm-rpc.mjs +0 -225
  216. package/src/data/providers/farming.mjs +0 -291
  217. package/src/data/providers/geckoterminal.mjs +0 -34
  218. package/src/data/providers/gmx.mjs +0 -496
  219. package/src/data/providers/hiro-stacks.mjs +0 -150
  220. package/src/data/providers/hl-assets.mjs +0 -165
  221. package/src/data/providers/hl-info.mjs +0 -108
  222. package/src/data/providers/hl-markets.mjs +0 -210
  223. package/src/data/providers/hl-outcome.mjs +0 -61
  224. package/src/data/providers/hl-perps.mjs +0 -419
  225. package/src/data/providers/hl-staking.mjs +0 -353
  226. package/src/data/providers/hl-ws.mjs +0 -119
  227. package/src/data/providers/hyperevm-dex.mjs +0 -49
  228. package/src/data/providers/jito-mev.mjs +0 -117
  229. package/src/data/providers/jupiter-venues.mjs +0 -119
  230. package/src/data/providers/jupiter.mjs +0 -315
  231. package/src/data/providers/kamino-strategies.mjs +0 -143
  232. package/src/data/providers/l2beat-tvl.mjs +0 -42
  233. package/src/data/providers/lifi.mjs +0 -166
  234. package/src/data/providers/liquid-esplora.mjs +0 -152
  235. package/src/data/providers/magiceden-ordinals.mjs +0 -141
  236. package/src/data/providers/magiceden-sol.mjs +0 -406
  237. package/src/data/providers/mempool-lightning.mjs +0 -144
  238. package/src/data/providers/mempool-mining.mjs +0 -142
  239. package/src/data/providers/meteora-dlmm.mjs +0 -168
  240. package/src/data/providers/morpho.mjs +0 -177
  241. package/src/data/providers/nft-gallery.mjs +0 -163
  242. package/src/data/providers/nft-portfolio.mjs +0 -494
  243. package/src/data/providers/odos.mjs +0 -156
  244. package/src/data/providers/ondo.mjs +0 -31
  245. package/src/data/providers/oneinch.mjs +0 -174
  246. package/src/data/providers/opensea-multichain.mjs +0 -136
  247. package/src/data/providers/opensea-nft.mjs +0 -371
  248. package/src/data/providers/orca.mjs +0 -29
  249. package/src/data/providers/ordinals-runes.mjs +0 -180
  250. package/src/data/providers/pancakeswap.mjs +0 -28
  251. package/src/data/providers/paraswap.mjs +0 -125
  252. package/src/data/providers/pendle.mjs +0 -188
  253. package/src/data/providers/poly-clob.mjs +0 -283
  254. package/src/data/providers/poly-public.mjs +0 -96
  255. package/src/data/providers/poly-ws.mjs +0 -103
  256. package/src/data/providers/polygon-staking.mjs +0 -227
  257. package/src/data/providers/portfolio-history.mjs +0 -394
  258. package/src/data/providers/portfolio.mjs +0 -600
  259. package/src/data/providers/pyth-price-feeds.mjs +0 -172
  260. package/src/data/providers/raydium.mjs +0 -35
  261. package/src/data/providers/relayscan-mev.mjs +0 -72
  262. package/src/data/providers/rfq.mjs +0 -15
  263. package/src/data/providers/rh-agent.mjs +0 -59
  264. package/src/data/providers/sanctum-lst.mjs +0 -180
  265. package/src/data/providers/satflow.mjs +0 -341
  266. package/src/data/providers/signed-material-guard.mjs +0 -108
  267. package/src/data/providers/solana-rpc.mjs +0 -197
  268. package/src/data/providers/solend-lending.mjs +0 -166
  269. package/src/data/providers/spark-lend.mjs +0 -42
  270. package/src/data/providers/squid-router.mjs +0 -29
  271. package/src/data/providers/stargate.mjs +0 -29
  272. package/src/data/providers/sushiswap.mjs +0 -30
  273. package/src/data/providers/symbiotic-restaking.mjs +0 -41
  274. package/src/data/providers/thorchain.mjs +0 -36
  275. package/src/data/providers/traderjoe.mjs +0 -28
  276. package/src/data/providers/twap.mjs +0 -152
  277. package/src/data/providers/uniswap-v3.mjs +0 -457
  278. package/src/data/providers/uniswap-v4.mjs +0 -414
  279. package/src/data/providers/vertex.mjs +0 -41
  280. package/src/data/providers/wallet-watch.mjs +0 -264
  281. package/src/data/providers/wormhole.mjs +0 -28
  282. package/src/data/providers/yearn.mjs +0 -31
  283. package/src/data/providers/zerox.mjs +0 -167
  284. package/src/data/public-api-scan.mjs +0 -61
  285. package/src/data/quote-placeholder.mjs +0 -31
  286. package/src/desk/swap-prepare.mjs +0 -194
  287. package/src/equities/bridge.mjs +0 -388
  288. package/src/equities/fixtures/bridge_routes.json +0 -159
  289. package/src/equities/fixtures/dst_transitions.json +0 -29
  290. package/src/equities/fixtures/equity_dex_pools.json +0 -154
  291. package/src/equities/fixtures/hip3_l2books.json +0 -2711
  292. package/src/equities/fixtures/nyse_holidays.json +0 -1
  293. package/src/equities/fixtures/oracles.json +0 -100
  294. package/src/equities/fixtures/rh_pool_state.json +0 -244
  295. package/src/equities/fixtures/solana_xstocks.json +0 -704
  296. package/src/equities/fixtures/ton_xstocks.json +0 -35
  297. package/src/equities/fixtures/universe.json +0 -411
  298. package/src/equities/fixtures/venues.json +0 -3542
  299. package/src/equities/fixtures.mjs +0 -405
  300. package/src/equities/funding.mjs +0 -142
  301. package/src/equities/index.mjs +0 -166
  302. package/src/equities/liveness.mjs +0 -148
  303. package/src/equities/marketHours.mjs +0 -249
  304. package/src/equities/normalize.mjs +0 -295
  305. package/src/equities/num.mjs +0 -146
  306. package/src/equities/prepare.mjs +0 -95
  307. package/src/equities/rank.mjs +0 -260
  308. package/src/equities/sourceNum.mjs +0 -69
  309. package/src/equities/types.mjs +0 -220
  310. package/src/equities/venues/arcus-perp.mjs +0 -84
  311. package/src/equities/venues/arcus-spot.mjs +0 -105
  312. package/src/equities/venues/hyperliquid-hip3.mjs +0 -224
  313. package/src/equities/venues/rh-uniswap.mjs +0 -216
  314. package/src/equities/venues/solana-xstocks.mjs +0 -139
  315. package/src/equities/venues/ton-stonfi.mjs +0 -139
  316. package/src/exact-integer.mjs +0 -72
  317. package/src/exec-policy.mjs +0 -419
  318. package/src/flags.mjs +0 -15
  319. package/src/fresh-window.mjs +0 -76
  320. package/src/gmx-attestation.mjs +0 -176
  321. package/src/index.mjs +0 -107
  322. package/src/licensing/locals-only.mjs +0 -25
  323. package/src/nft-gas-war-guard.mjs +0 -139
  324. package/src/onboarding/agent-keys.mjs +0 -161
  325. package/src/onboarding/harness-configs.mjs +0 -102
  326. package/src/onboarding/index.mjs +0 -18
  327. package/src/onboarding/tiers.mjs +0 -139
  328. package/src/oracle-env.mjs +0 -55
  329. package/src/package-manifest.mjs +0 -42
  330. package/src/plugins/agent-plugin-loader.mjs +0 -225
  331. package/src/portfolio-risk.mjs +0 -170
  332. package/src/prepare-envelope.mjs +0 -204
  333. package/src/profile-upgrade.mjs +0 -277
  334. package/src/protocol-execution.mjs +0 -84
  335. package/src/protocol-templates/gate.mjs +0 -179
  336. package/src/protocol-templates/prepare-deploy.mjs +0 -81
  337. package/src/public-api/agent-grants.mjs +0 -57
  338. package/src/public-api/buzz-integration.mjs +0 -267
  339. package/src/public-api/connect-agent.mjs +0 -424
  340. package/src/public-api/grants.mjs +0 -142
  341. package/src/public-api/http.mjs +0 -707
  342. package/src/public-api/metering.mjs +0 -111
  343. package/src/public-control/aa-adapter.mjs +0 -402
  344. package/src/public-control/build-registry.mjs +0 -227
  345. package/src/public-control/bundler-client.mjs +0 -357
  346. package/src/public-control/grant-indexer.mjs +0 -296
  347. package/src/public-control/policy-render.mjs +0 -69
  348. package/src/public-control/policy-schema.mjs +0 -322
  349. package/src/public-control/runtime-config.mjs +0 -275
  350. package/src/public-control/session-key-model.mjs +0 -379
  351. package/src/public-control/session-orchestrator.mjs +0 -418
  352. package/src/rfq/intent.mjs +0 -180
  353. package/src/rfq/sources.mjs +0 -181
  354. package/src/route-attestation.mjs +0 -132
  355. package/src/router/best-execution.mjs +0 -326
  356. package/src/router/index.mjs +0 -250
  357. package/src/router/integrator-fee.mjs +0 -135
  358. package/src/router/prepare-bridge.mjs +0 -293
  359. package/src/router/prepare-route.mjs +0 -398
  360. package/src/router/proposal.mjs +0 -311
  361. package/src/router/risk-classifier.mjs +0 -119
  362. package/src/router/route-sources.mjs +0 -364
  363. package/src/scanner/chains.config.mjs +0 -543
  364. package/src/scanner/contract.mjs +0 -270
  365. package/src/scanner/evm-scanner.mjs +0 -394
  366. package/src/scanner/index.mjs +0 -9
  367. package/src/scanner/v2-venue.mjs +0 -351
  368. package/src/scanner/v3-venue.mjs +0 -308
  369. package/src/scopes.mjs +0 -44
  370. package/src/sell-simulation.mjs +0 -167
  371. package/src/signals/engine.mjs +0 -146
  372. package/src/signals/index.mjs +0 -1
  373. package/src/token-transfer-guard.mjs +0 -188
  374. package/src/tui/app.mjs +0 -438
  375. package/src/tui/backend.mjs +0 -215
  376. package/src/tui/format.mjs +0 -272
  377. package/src/tui/gateway-client.mjs +0 -177
  378. package/src/tui/input.mjs +0 -501
  379. package/src/tui/memory.mjs +0 -105
  380. package/src/tui/meta-learn.mjs +0 -85
  381. package/src/tui/renderer.mjs +0 -443
  382. package/src/tui/scheduler.mjs +0 -205
  383. package/src/tui/skills-loader.mjs +0 -140
  384. package/src/tui/standalone-client.mjs +0 -752
  385. package/src/tui/theme.mjs +0 -81
  386. package/src/vault-attestation.mjs +0 -146
  387. package/src/venues.mjs +0 -206
  388. package/src/watch-preferences.mjs +0 -85
  389. /package/{profiles → dist/assets/profiles}/_template/SOUL.md +0 -0
  390. /package/{profiles → dist/assets/profiles}/_template/profile.json +0 -0
  391. /package/{profiles → dist/assets/profiles}/bitcoin-agent/SOUL.md +0 -0
  392. /package/{profiles → dist/assets/profiles}/bitcoin-agent/profile.json +0 -0
  393. /package/{profiles → dist/assets/profiles}/hyperliquid-agent/SOUL.md +0 -0
  394. /package/{profiles → dist/assets/profiles}/hyperliquid-agent/profile.json +0 -0
  395. /package/{profiles → dist/assets/profiles}/oracle/SOUL.md +0 -0
  396. /package/{profiles → dist/assets/profiles}/oracle/profile.json +0 -0
  397. /package/{profiles → dist/assets/profiles}/polymarket-agent/SOUL.md +0 -0
  398. /package/{profiles → dist/assets/profiles}/polymarket-agent/profile.json +0 -0
  399. /package/{profiles → dist/assets/profiles}/profile.schema.json +0 -0
  400. /package/{profiles → dist/assets/profiles}/protocol-builder/SOUL.md +0 -0
  401. /package/{profiles → dist/assets/profiles}/protocol-builder/profile.json +0 -0
  402. /package/{profiles → dist/assets/profiles}/robinhood-agent/SOUL.md +0 -0
  403. /package/{profiles → dist/assets/profiles}/robinhood-agent/profile.json +0 -0
  404. /package/{profiles → dist/assets/profiles}/solana-agent/SOUL.md +0 -0
  405. /package/{profiles → dist/assets/profiles}/solana-agent/profile.json +0 -0
  406. /package/{profiles → dist/assets/profiles}/stable-agent/SOUL.md +0 -0
  407. /package/{profiles → dist/assets/profiles}/stable-agent/profile.json +0 -0
  408. /package/{skills → dist/assets/skills}/balance/SKILL.md +0 -0
  409. /package/{skills → dist/assets/skills}/bitcoin-l1.md +0 -0
  410. /package/{skills → dist/assets/skills}/chain-defi-ecosystem-profiling.md +0 -0
  411. /package/{skills → dist/assets/skills}/evm-contract-research.md +0 -0
  412. /package/{skills → dist/assets/skills}/hyperliquid.md +0 -0
  413. /package/{skills → dist/assets/skills}/multichain-exec-desk.md +0 -0
  414. /package/{skills → dist/assets/skills}/oracle-action-semantics/SKILL.md +0 -0
  415. /package/{skills → dist/assets/skills}/oracle-best-execution/SKILL.md +0 -0
  416. /package/{skills → dist/assets/skills}/oracle-best-execution.md +0 -0
  417. /package/{skills → dist/assets/skills}/oracle-bitcoin/SKILL.md +0 -0
  418. /package/{skills → dist/assets/skills}/oracle-chain-graphs-telegram-cards/SKILL.md +0 -0
  419. /package/{skills → dist/assets/skills}/oracle-chat/SKILL.md +0 -0
  420. /package/{skills → dist/assets/skills}/oracle-chat/chain.SKILL.md +0 -0
  421. /package/{skills → dist/assets/skills}/oracle-chat/setup.SKILL.md +0 -0
  422. /package/{skills → dist/assets/skills}/oracle-circuit-breaker/SKILL.md +0 -0
  423. /package/{skills → dist/assets/skills}/oracle-contract-research/SKILL.md +0 -0
  424. /package/{skills → dist/assets/skills}/oracle-desk/SKILL.md +0 -0
  425. /package/{skills → dist/assets/skills}/oracle-desk.md +0 -0
  426. /package/{skills → dist/assets/skills}/oracle-dex-launch/SKILL.md +0 -0
  427. /package/{skills → dist/assets/skills}/oracle-equities/SKILL.md +0 -0
  428. /package/{skills → dist/assets/skills}/oracle-grants/SKILL.md +0 -0
  429. /package/{skills → dist/assets/skills}/oracle-hypercore-staking/SKILL.md +0 -0
  430. /package/{skills → dist/assets/skills}/oracle-hyperliquid/SKILL.md +0 -0
  431. /package/{skills → dist/assets/skills}/oracle-meme-token-sniper/SKILL.md +0 -0
  432. /package/{skills → dist/assets/skills}/oracle-multichain-nft-launch/SKILL.md +0 -0
  433. /package/{skills → dist/assets/skills}/oracle-multichain-token-launch/SKILL.md +0 -0
  434. /package/{skills → dist/assets/skills}/oracle-nft-gacha-launch/SKILL.md +0 -0
  435. /package/{skills → dist/assets/skills}/oracle-nft-mint-gas-war/SKILL.md +0 -0
  436. /package/{skills → dist/assets/skills}/oracle-polymarket/SKILL.md +0 -0
  437. /package/{skills → dist/assets/skills}/oracle-protocol-builder/SKILL.md +0 -0
  438. /package/{skills → dist/assets/skills}/oracle-protocol-security/SKILL.md +0 -0
  439. /package/{skills → dist/assets/skills}/oracle-public-product/SKILL.md +0 -0
  440. /package/{skills → dist/assets/skills}/oracle-receipts/SKILL.md +0 -0
  441. /package/{skills → dist/assets/skills}/oracle-receipts.md +0 -0
  442. /package/{skills → dist/assets/skills}/oracle-rfq-tokenized-assets/SKILL.md +0 -0
  443. /package/{skills → dist/assets/skills}/oracle-smart-wallet-scanner/SKILL.md +0 -0
  444. /package/{skills → dist/assets/skills}/oracle-solana/SKILL.md +0 -0
  445. /package/{skills → dist/assets/skills}/oracle-solana-nft/SKILL.md +0 -0
  446. /package/{skills → dist/assets/skills}/oracle-token-research/SKILL.md +0 -0
  447. /package/{skills → dist/assets/skills}/solana.md +0 -0
@@ -1,136 +0,0 @@
1
- import fs from "node:fs";
2
- import path from "node:path";
3
- import { DOCTOR_SIGNING_OPTIONAL } from "../first-run.mjs";
4
- import { resolveHermes } from "../runtime.mjs";
5
-
6
- function nodeVersionOk() {
7
- const [maj, min] = process.versions.node.split(".").map(Number);
8
- return maj > 20 || (maj === 20 && min >= 19);
9
- }
10
-
11
- function loadExecEnv(p) {
12
- if (!fs.existsSync(p)) return {};
13
- const out = {};
14
- for (const line of fs.readFileSync(p, "utf8").split(/\r?\n/)) {
15
- const m = line.match(/^([A-Z0-9_]+)=(.*)$/);
16
- if (m) out[m[1]] = m[2];
17
- }
18
- return out;
19
- }
20
-
21
-
22
- async function probeDataServer(url) {
23
- try {
24
- // The server serves /health; / intentionally 404s with a route list, so
25
- // probing / reported a healthy server as down.
26
- const res = await fetch(url.replace(/\/$/, "") + "/health");
27
- return res.ok;
28
- } catch {
29
- return false;
30
- }
31
- }
32
-
33
- export default {
34
- name: "doctor",
35
- summary: "check read plane; checks signer too when installed",
36
- group: "read",
37
- usage: "oracle doctor [--json]",
38
- async run(ctx) {
39
- const json = ctx.argv.includes("--json");
40
- const checks = [];
41
- let failed = false;
42
- const push = (id, status, detail, fix = null) => {
43
- checks.push({ id, status, detail, fix });
44
- if (status === "fail") failed = true;
45
- };
46
-
47
- push("node", nodeVersionOk() ? "ok" : "fail", `node ${process.versions.node}`,
48
- nodeVersionOk() ? null : "install node >= 20.19");
49
-
50
- const execEnvPath = ctx.paths.oracleExecEnvPath();
51
- const envFile = loadExecEnv(execEnvPath);
52
- // `oracle init --apply` writes ORACLE_ROUTE_ATTESTATION_SECRET (see
53
- // bin/oracle-init.mjs), but doctor checked only ORACLE_ATTESTATION_SECRET
54
- // and ORACLE_STAMP_HMAC_SECRET — so it told the user to rerun an init step
55
- // that could never satisfy the check.
56
- const att =
57
- process.env.ORACLE_ROUTE_ATTESTATION_SECRET ||
58
- process.env.MAD_ROUTE_ATTESTATION_SECRET ||
59
- process.env.ORACLE_ATTESTATION_SECRET ||
60
- process.env.ORACLE_STAMP_HMAC_SECRET ||
61
- envFile.ORACLE_ROUTE_ATTESTATION_SECRET ||
62
- envFile.MAD_ROUTE_ATTESTATION_SECRET ||
63
- envFile.ORACLE_ATTESTATION_SECRET ||
64
- envFile.ORACLE_STAMP_HMAC_SECRET;
65
- push("attestation_secret", att ? "ok" : "warn", att ? "present" : "missing",
66
- att ? null : "run oracle init --apply (writes ~/.config/oracle/exec.env)");
67
-
68
- const dataUrl = process.env.ORACLE_DATA_URL || "http://127.0.0.1:8787";
69
- const dataUp = await probeDataServer(dataUrl);
70
- push("data_server", dataUp ? "ok" : "warn", dataUp ? `reachable ${dataUrl}` : `down ${dataUrl}`,
71
- dataUp ? null : "oracle data serve");
72
-
73
- const runtime = resolveHermes();
74
- push("agent_runtime", runtime.ok ? "ok" : "warn",
75
- runtime.ok ? `present ${runtime.bin} (${runtime.source})` : "not installed",
76
- runtime.ok ? null : "oracle bootstrap");
77
-
78
- const profilesDir = path.join(ctx.paths.hermesRoot(), "profiles");
79
- let laneCount = 0;
80
- if (fs.existsSync(profilesDir)) {
81
- laneCount = fs.readdirSync(profilesDir, { withFileTypes: true }).filter((e) => e.isDirectory()).length;
82
- }
83
- push("hermes_lanes", laneCount > 0 ? "ok" : "warn",
84
- laneCount > 0 ? `${laneCount} profile dir(s)` : "no lane profiles found",
85
- laneCount > 0 ? null : "oracle init --apply");
86
-
87
- const operator = ctx.resolveOperator();
88
- let operatorBlock = { installed: false };
89
- if (operator.ok) {
90
- const r = ctx.dispatchOperator("oracle-agentic-doctor", ["--json"], { stdio: "pipe" });
91
- let detail = { installed: true, version: operator.version, source: operator.source };
92
- if (r && typeof r === "object" && r.stdout) {
93
- try {
94
- const parsed = JSON.parse(r.stdout);
95
- detail = {
96
- installed: true,
97
- version: operator.version,
98
- source: operator.source,
99
- signingReady: parsed.signingReady,
100
- broadcastReady: parsed.broadcastReady,
101
- executionReady: parsed.executionReady,
102
- masterKillSwitch: parsed.masterKillSwitch,
103
- raw: parsed,
104
- };
105
- } catch {
106
- detail.doctorParseError = true;
107
- detail.doctorExit = r.code;
108
- }
109
- } else if (typeof r === "number") {
110
- detail.doctorExit = r;
111
- }
112
- operatorBlock = detail;
113
- const signingReady = detail.signingReady === true;
114
- push(
115
- "signing",
116
- signingReady ? "ok" : "warn",
117
- signingReady
118
- ? `operator ${operator.version} ready via ${operator.source}`
119
- : `operator ${operator.version} installed but signing is not ready`,
120
- signingReady ? null : "oracle sign doctor --json",
121
- );
122
- }
123
-
124
- const report = { ok: !failed, checks, operator: operatorBlock };
125
- if (json) {
126
- process.stdout.write(JSON.stringify(report, null, 2) + "\n");
127
- } else {
128
- for (const c of checks) {
129
- process.stdout.write(`${c.status.toUpperCase().padEnd(4)} ${c.id}: ${c.detail}\n`);
130
- if (c.fix) process.stdout.write(` fix: ${c.fix}\n`);
131
- }
132
- if (!operator.ok) process.stdout.write(`INFO ${DOCTOR_SIGNING_OPTIONAL}\n`);
133
- }
134
- return failed ? 1 : 0;
135
- },
136
- };
@@ -1,41 +0,0 @@
1
- import { spawnSync } from "node:child_process";
2
-
3
- /**
4
- * Crossbook product surface.
5
- *
6
- * Separate protocol product (tokenized / on-chain equities best execution across
7
- * HIP-3, Arcus, RH Uniswap, Solana xStocks, TON), shipped inside the Oracle CLI
8
- * so one install reaches it. Prepare-only; never signs.
9
- */
10
- export default {
11
- name: "equities",
12
- summary: "Crossbook — HIP-3 / Arcus / RH / Solana / TON best execution",
13
- group: "read",
14
- usage: "oracle equities <venues|quote|prepare> [ticker] [flags]",
15
- async run(ctx) {
16
- if (ctx.argv.includes("-h") || ctx.argv.includes("--help") || ctx.argv.length === 0) {
17
- process.stdout.write(`Crossbook — separate Oracle product for on-chain equities best execution
18
-
19
- Venues: HIP-3 builder DEXes · Arcus spot/perp · RH Uniswap (4663) · Solana xStocks · TON ston.fi
20
- Custody: prepare-only. Quote-only winners are never sold as signable here.
21
- Only rh_uniswap can emit an unsigned tx (your wallet signs).
22
-
23
- Usage:
24
- oracle equities venues
25
- oracle equities quote NVDA --size 1000
26
- oracle equities quote SPY --size 500 --json
27
- oracle equities prepare NVDA --recipient 0xYourWallet --size 1000
28
-
29
- Alias bin: oracle-equities
30
- `);
31
- return 0;
32
- }
33
- const bin = ctx.bin("oracle-equities.mjs");
34
- const r = spawnSync(process.execPath, [bin, ...ctx.argv], { stdio: "inherit" });
35
- if (r.error) {
36
- process.stderr.write(`oracle: failed to spawn oracle-equities: ${r.error.message}\n`);
37
- return 1;
38
- }
39
- return typeof r.status === "number" ? r.status : 1;
40
- },
41
- };
@@ -1,129 +0,0 @@
1
- import { FARMING_METHODS, discoverFarms, airdropEV } from "../../data/providers/farming.mjs";
2
-
3
- const USAGE = `oracle farm <methods|discover|airdrop> [options]
4
-
5
- oracle farm methods list the delta-aware farming playbooks
6
- oracle farm methods --id stable-loop full setup/exposure/hedge/monitor/exit for one method
7
- oracle farm discover [--chain base] rank live pools by net APR after costs and risk haircut
8
- [--limit 12] [--min-tvl 2000000] [--json]
9
- oracle farm airdrop [--wallets 5] [--tasks-weekly 6] [--hours-weekly 4]
10
- [--hourly-cost 25] [--gas-per-task 0.4] [--bridge-monthly 12]
11
- [--expected-reward 900] [--probability 22]
12
- [--sybil-haircut 25] [--lockup-months 6] [--json]
13
-
14
- Read-only. Ranks opportunities and designs prepare plans; never signs or broadcasts.`;
15
-
16
- function parseFlags(argv) {
17
- const out = { _: [] };
18
- for (let i = 0; i < argv.length; i += 1) {
19
- const arg = argv[i];
20
- if (arg === "--json") { out.json = true; continue; }
21
- if (arg.startsWith("--")) {
22
- const key = arg.slice(2);
23
- const next = argv[i + 1];
24
- if (next === undefined || next.startsWith("--")) { out[key] = true; continue; }
25
- out[key] = next;
26
- i += 1;
27
- continue;
28
- }
29
- out._.push(arg);
30
- }
31
- return out;
32
- }
33
-
34
- const usd = (n) => `$${Math.round(Number(n) || 0).toLocaleString("en-US")}`;
35
- const pct = (n) => `${(Number(n) || 0).toFixed(1)}%`;
36
-
37
- function printMethods(flags) {
38
- const id = typeof flags.id === "string" ? flags.id : null;
39
- if (id) {
40
- const method = FARMING_METHODS.find((m) => m.id === id);
41
- if (!method) {
42
- process.stderr.write(`oracle farm: unknown method '${id}'. Known: ${FARMING_METHODS.map((m) => m.id).join(", ")}\n`);
43
- return 1;
44
- }
45
- if (flags.json) { process.stdout.write(JSON.stringify(method, null, 2) + "\n"); return 0; }
46
- process.stdout.write(`\n ${method.label} [${method.risk}] target delta ${method.targetDelta}\n\n`);
47
- for (const [label, key] of [["setup", "setup"], ["exposure", "exposure"], ["hedge", "hedge"], ["monitor", "monitor"], ["exit", "exit"]]) {
48
- process.stdout.write(` ${label.padEnd(9)} ${method[key]}\n`);
49
- }
50
- process.stdout.write("\n");
51
- return 0;
52
- }
53
- if (flags.json) { process.stdout.write(JSON.stringify(FARMING_METHODS, null, 2) + "\n"); return 0; }
54
- process.stdout.write("\n farming methods\n\n");
55
- for (const m of FARMING_METHODS) {
56
- process.stdout.write(` ${m.id.padEnd(18)} ${m.label.padEnd(30)} ${m.risk}\n`);
57
- }
58
- process.stdout.write("\n oracle farm methods --id <id> for setup, exposure, hedge, monitor, and exit rules.\n\n");
59
- return 0;
60
- }
61
-
62
- async function printDiscover(flags) {
63
- const result = await discoverFarms({
64
- chain: typeof flags.chain === "string" ? flags.chain : null,
65
- limit: flags.limit,
66
- minTvl: flags["min-tvl"],
67
- });
68
- if (flags.json) { process.stdout.write(JSON.stringify(result, null, 2) + "\n"); return 0; }
69
- if (!result.live) {
70
- process.stderr.write(`oracle farm: discovery unavailable — ${result.error}\n`);
71
- return 1;
72
- }
73
- process.stdout.write(`\n live farm discovery — ${result.source}, ${result.considered.toLocaleString("en-US")} pools considered (${result.consideredNote}), chain=${result.chain}\n\n`);
74
- process.stdout.write(` ${"verdict".padEnd(10)}${"net apr".padStart(9)} ${"tvl".padStart(12)} ${"chain".padEnd(12)}${"recipe".padEnd(18)}pool\n`);
75
- for (const c of result.candidates) {
76
- process.stdout.write(
77
- ` ${c.verdict.padEnd(10)}${pct(c.netApr).padStart(9)} ${usd(c.tvlUsd).padStart(12)} ${c.chain.slice(0, 11).padEnd(12)}${c.recipe.padEnd(18)}${c.label}\n`,
78
- );
79
- }
80
- process.stdout.write(`\n net apr = apy − borrow − funding − gas − risk haircut.\n ${result.posture}.\n\n`);
81
- return 0;
82
- }
83
-
84
- function printAirdrop(flags) {
85
- const ev = airdropEV({
86
- wallets: flags.wallets,
87
- tasksWeekly: flags["tasks-weekly"],
88
- hoursWeekly: flags["hours-weekly"],
89
- hourlyCost: flags["hourly-cost"],
90
- gasPerTask: flags["gas-per-task"],
91
- bridgeMonthly: flags["bridge-monthly"],
92
- expectedReward: flags["expected-reward"],
93
- probability: flags.probability,
94
- sybilHaircut: flags["sybil-haircut"],
95
- lockupMonths: flags["lockup-months"],
96
- });
97
- if (flags.json) { process.stdout.write(JSON.stringify(ev, null, 2) + "\n"); return 0; }
98
- const i = ev.inputs;
99
- process.stdout.write(`\n airdrop expected value\n\n`);
100
- process.stdout.write(` ${i.wallets} wallets · ${i.tasksWeekly} tasks/wk · ${i.hoursWeekly} hrs/wk @ ${usd(i.hourlyCost)}/hr\n`);
101
- process.stdout.write(` ${pct(i.probabilityPct)} eligibility · ${pct(i.sybilHaircutPct)} sybil haircut · ${i.lockupMonths}mo lockup\n\n`);
102
- process.stdout.write(` monthly cost ${usd(ev.monthlyCost).padStart(12)} (gas ${usd(ev.monthlyGas)} + labor ${usd(ev.laborMonthly)} + bridges ${usd(i.bridgeMonthly)})\n`);
103
- process.stdout.write(` gross EV ${usd(ev.grossExpectedValue).padStart(12)}\n`);
104
- process.stdout.write(` after haircuts ${usd(ev.adjustedExpectedValue).padStart(12)} (lockup discount ${(ev.lockupDiscount * 100).toFixed(0)}%)\n`);
105
- process.stdout.write(` net EV ${usd(ev.netExpectedValue).padStart(12)} ${ev.verdict}\n`);
106
- if (ev.roiPct != null) process.stdout.write(` ROI ${pct(ev.roiPct).padStart(12)}\n`);
107
- if (ev.breakevenProbabilityPct != null) {
108
- process.stdout.write(` breakeven odds ${pct(ev.breakevenProbabilityPct).padStart(12)} campaign must clear this to profit\n`);
109
- }
110
- process.stdout.write(`\n ${ev.posture}.\n\n`);
111
- return 0;
112
- }
113
-
114
- export default {
115
- name: "farm",
116
- summary: "farming methods, live farm discovery, airdrop EV",
117
- group: "read",
118
- usage: USAGE,
119
- async run(ctx) {
120
- const flags = parseFlags(ctx.argv);
121
- const sub = flags._[0];
122
- if (!sub || sub === "help") { process.stdout.write(USAGE + "\n"); return 0; }
123
- if (sub === "methods") return printMethods(flags);
124
- if (sub === "discover") return printDiscover(flags);
125
- if (sub === "airdrop") return printAirdrop(flags);
126
- process.stderr.write(`oracle farm: unknown subcommand '${sub}'\n\n${USAGE}\n`);
127
- return 1;
128
- },
129
- };
@@ -1,109 +0,0 @@
1
- import { readFileSync, existsSync } from "node:fs";
2
- import {
3
- holderBalance,
4
- isAddress,
5
- LOCALS_ONLY_CONTRACT,
6
- LOCALS_ONLY_CHAIN_ID,
7
- } from "../../licensing/locals-only.mjs";
8
- import { oracleExecEnvPath } from "../paths.mjs";
9
-
10
- const HELP = `oracle fees — Oracle fee-waiver status
11
-
12
- oracle fees status check the configured agent wallet
13
- oracle fees check <address> check any address
14
- oracle fees info show the Locals Only collection
15
-
16
- Oracle is public to everyone. A Locals Only NFT only waives Oracle's integrator
17
- fee. This command reads balanceOf on HyperEVM; it does not sign or request keys.`;
18
-
19
- export function agentAddress(envPath = oracleExecEnvPath()) {
20
- if (!existsSync(envPath)) return null;
21
- try {
22
- const body = readFileSync(envPath, "utf8");
23
- for (const line of body.split("\n")) {
24
- const match = line.match(/^\s*(?:export\s+)?ORACLE_EVM_ADDRESS\s*=\s*(.+)\s*$/);
25
- if (!match) continue;
26
- const value = match[1].trim().replace(/^["']|["']$/g, "");
27
- if (isAddress(value)) return value;
28
- }
29
- } catch {
30
- return null;
31
- }
32
- return null;
33
- }
34
-
35
- function line(out, text) {
36
- out.write(text + "\n");
37
- }
38
-
39
- export async function run(argv = [], io = {}) {
40
- const out = io.out ?? process.stdout;
41
- const err = io.err ?? process.stderr;
42
- const balanceOf = io.balanceOf ?? holderBalance;
43
- const sub = argv[0];
44
-
45
- if (!sub || sub === "--help" || sub === "-h" || sub === "help") {
46
- line(out, HELP);
47
- return 0;
48
- }
49
-
50
- if (sub === "info") {
51
- line(out, `contract: ${LOCALS_ONLY_CONTRACT}`);
52
- line(out, `chain: HyperEVM (${LOCALS_ONLY_CHAIN_ID})`);
53
- line(out, "benefit: 0% Oracle integrator fee");
54
- line(out, "access: public to everyone");
55
- return 0;
56
- }
57
-
58
- let address;
59
- if (sub === "status") {
60
- address = io.agentAddress ? io.agentAddress() : agentAddress();
61
- if (!address) {
62
- line(out, "wallet: not configured");
63
- line(out, "Locals Only fee-waiver status: unavailable");
64
- line(out, "standard Oracle fee applies when configured");
65
- line(out, "Oracle access remains public to everyone.");
66
- return 0;
67
- }
68
- } else if (sub === "check") {
69
- address = argv[1];
70
- if (!isAddress(address)) {
71
- line(err, "usage: oracle fees check <0x address>");
72
- return 2;
73
- }
74
- } else {
75
- line(err, `oracle fees: unknown subcommand '${sub}'`);
76
- return 2;
77
- }
78
-
79
- try {
80
- const balance = await balanceOf(address);
81
- line(out, `wallet: ${address}`);
82
- if (BigInt(balance) > 0n) {
83
- line(out, `Locals Only balance: ${balance}`);
84
- line(out, "Oracle integrator fee: 0%");
85
- } else {
86
- line(out, "Locals Only balance: 0");
87
- line(out, "standard Oracle fee applies when configured");
88
- }
89
- line(out, "Oracle access remains public to everyone.");
90
- return 0;
91
- } catch {
92
- line(out, "Locals Only fee-waiver status: unavailable");
93
- line(out, "standard Oracle fee applies when configured");
94
- line(out, "Oracle access remains public to everyone.");
95
- return 0;
96
- }
97
- }
98
-
99
- export const help = "check Locals Only zero-fee eligibility";
100
-
101
- export default {
102
- name: "fees",
103
- summary: "check Locals Only zero-fee eligibility",
104
- group: "read",
105
- usage: HELP,
106
- async run(ctx) {
107
- return run(ctx.argv ?? []);
108
- },
109
- };
@@ -1,130 +0,0 @@
1
- import { followWallet, DEFAULT_ENDPOINTS } from "../../data/providers/wallet-watch.mjs";
2
- import { resolveName, ADDRESS_RE } from "../../data/names.mjs";
3
-
4
- const CHAIN_NAMES = { 1: "ethereum", 8453: "base", 42161: "arbitrum" };
5
- const NAME_TO_ID = Object.fromEntries(Object.entries(CHAIN_NAMES).map(([id, n]) => [n, Number(id)]));
6
-
7
- const USAGE = `oracle follow <name-or-address> [--chain <name>] [--blocks <n>] [--json]
8
-
9
- oracle follow vitalik.eth
10
- oracle follow demi.hl --chain base
11
- oracle follow 0x4d47b6757afd42c3dbd9691b71b43d74afa4b6b2 --blocks 20000 --json
12
-
13
- Reads ERC20 transfer activity for a wallet. Read-only: this calls
14
- eth_getLogs and eth_blockNumber and nothing else, so it can never move funds.
15
-
16
- Chains: ${Object.values(CHAIN_NAMES).join(", ")}. Default: ethereum.
17
- Lookback defaults to 40000 blocks. Endpoints are keyless.
18
-
19
- Note publicnode-class RPCs are deliberately excluded: they retain only ~128
20
- blocks, so they return an empty result instead of an error.`;
21
-
22
- function flagValue(argv, flag) {
23
- const i = argv.indexOf(flag);
24
- return i >= 0 ? argv[i + 1] : undefined;
25
- }
26
-
27
- function fmtValue(v) {
28
- const s = String(v ?? "");
29
- return s.length > 22 ? `${s.slice(0, 19)}...` : s;
30
- }
31
-
32
- async function runFollow(argv = []) {
33
- const asJson = argv.includes("--json");
34
- const positional = [];
35
- for (let i = 0; i < argv.length; i += 1) {
36
- const a = argv[i];
37
- if (a === "--json") continue;
38
- if (a === "--chain" || a === "--blocks") { i += 1; continue; }
39
- positional.push(a);
40
- }
41
- const query = (positional[0] || "").trim();
42
-
43
- if (!query || query === "--help" || query === "-h") {
44
- process.stdout.write(`${USAGE}\n`);
45
- return query ? 0 : 1;
46
- }
47
-
48
- const chainArg = (flagValue(argv, "--chain") || "ethereum").toLowerCase();
49
- const chainId = NAME_TO_ID[chainArg] ?? Number(chainArg);
50
- if (!DEFAULT_ENDPOINTS[chainId]) {
51
- process.stderr.write(`follow: unsupported chain "${chainArg}". Supported: ${Object.values(CHAIN_NAMES).join(", ")}\n`);
52
- return 1;
53
- }
54
-
55
- const blocksArg = flagValue(argv, "--blocks");
56
- const lookbackBlocks = blocksArg ? Number(blocksArg) : 40000;
57
- if (!Number.isFinite(lookbackBlocks) || lookbackBlocks <= 0) {
58
- process.stderr.write(`follow: --blocks must be a positive number, got "${blocksArg}"\n`);
59
- return 1;
60
- }
61
-
62
- try {
63
- // A name is a fine way to name a wallet, so resolve it the same way
64
- // `oracle resolve` does rather than making the user paste hex.
65
- let address = query;
66
- let resolvedFrom = null;
67
- if (!ADDRESS_RE.test(query)) {
68
- const hit = await resolveName(query);
69
- if (!hit?.address) {
70
- process.stderr.write(`follow: could not resolve "${query}" to an address\n`);
71
- return 1;
72
- }
73
- address = hit.address;
74
- resolvedFrom = query;
75
- }
76
-
77
- const result = await followWallet(address, {
78
- chains: [chainId],
79
- lookback: lookbackBlocks,
80
- onWarn: asJson ? undefined : (m) => process.stderr.write(` warn: ${m}\n`),
81
- });
82
-
83
- const events = result.events || [];
84
- if (asJson) {
85
- process.stdout.write(`${JSON.stringify({
86
- address,
87
- resolvedFrom,
88
- chain: CHAIN_NAMES[chainId] || String(chainId),
89
- lookbackBlocks,
90
- count: events.length,
91
- errors: result.errors || [],
92
- events,
93
- })}\n`);
94
- return 0;
95
- }
96
-
97
- const label = resolvedFrom ? `${resolvedFrom} ${address}` : address;
98
- process.stdout.write(`${label}\n`);
99
- process.stdout.write(` ${CHAIN_NAMES[chainId] || chainId} · last ${lookbackBlocks} blocks · ${events.length} transfer${events.length === 1 ? "" : "s"}\n`);
100
-
101
- if (!events.length) {
102
- // Empty is a scoped result, not proof the wallet is idle.
103
- process.stdout.write(` no ERC20 transfers in this window\n`);
104
- }
105
- for (const e of events.slice(0, 25)) {
106
- const dir = e.to?.toLowerCase() === address.toLowerCase() ? "in " : "out";
107
- process.stdout.write(` ${dir} blk ${e.blockNumber} token ${e.token} ${fmtValue(e.value)}\n`);
108
- }
109
- if (events.length > 25) {
110
- process.stdout.write(` ... ${events.length - 25} more (use --json for all)\n`);
111
- }
112
- for (const err of result.errors || []) {
113
- process.stderr.write(` error: ${err.stage || "rpc"}: ${err.error}\n`);
114
- }
115
- return 0;
116
- } catch (err) {
117
- process.stderr.write(`follow failed: ${err?.message || err}\n`);
118
- return 1;
119
- }
120
- }
121
-
122
- export default {
123
- name: "follow",
124
- summary: "read a wallet's recent ERC20 transfer activity",
125
- group: "read",
126
- usage: USAGE,
127
- async run(ctx) {
128
- return runFollow(ctx.argv || []);
129
- },
130
- };
@@ -1,63 +0,0 @@
1
- // oracle harness — detect installed agent harnesses on this machine.
2
- //
3
- // Scans PATH for Agent Plugins-compatible clients, shows which ones
4
- // Oracle can delegate to. Native standalone is always the default.
5
- //
6
- // Commands:
7
- // oracle harness detect scan PATH, print installed harnesses
8
- // oracle harness list same as detect (alias)
9
-
10
- import { detectInstalledHarnesses } from "../../tui/backend.mjs";
11
-
12
- function usage() {
13
- return [
14
- "oracle harness — detect installed agent harnesses",
15
- "",
16
- " oracle harness detect scan PATH for Agent Plugins-compatible clients",
17
- "",
18
- "Oracle runs natively. If you prefer a different harness,",
19
- "set ORACLE_CHAT_BACKEND=<name>.",
20
- "",
21
- "Detected: opencode, claude, codex, cursor, windsurf, aider, continue, hermes",
22
- ].join("\n");
23
- }
24
-
25
- export default {
26
- name: "harness",
27
- summary: "detect installed agent harnesses",
28
- usage,
29
- async run(args, _ctx) {
30
- const sub = args[0];
31
- if (sub === "help" || sub === "--help" || sub === "-h") {
32
- process.stdout.write(usage() + "\n");
33
- return 0;
34
- }
35
- if (sub && sub !== "detect" && sub !== "list") {
36
- process.stderr.write(`oracle harness: unknown subcommand '${sub}'\n`);
37
- process.stderr.write(usage() + "\n");
38
- return 1;
39
- }
40
-
41
- const harnesses = detectInstalledHarnesses();
42
-
43
- if (harnesses.length === 0) {
44
- process.stderr.write("No agent harnesses detected on PATH.\n");
45
- process.stderr.write("Oracle runs natively — no external agent required.\n");
46
- return 0;
47
- }
48
-
49
- const native = harnesses.find(h => h.kind === "oracle");
50
- const others = harnesses.filter(h => h.kind !== "oracle");
51
-
52
- process.stdout.write("\nOracle native chat: default\n\n");
53
- process.stdout.write("Installed harnesses:\n");
54
- for (const h of others) {
55
- process.stdout.write(` ${h.label.padEnd(22)} ${h.path}\n`);
56
- }
57
- if (others.length === 0) {
58
- process.stdout.write(" (none — Oracle runs standalone)\n");
59
- }
60
- process.stdout.write(`\nSet ORACLE_CHAT_BACKEND=<name> to use a different harness.\n`);
61
- return 0;
62
- },
63
- };
@@ -1,7 +0,0 @@
1
- export default {
2
- name: "help",
3
- summary: "show command help",
4
- group: "meta",
5
- usage: "oracle help [noun]",
6
- async run() { return 0; },
7
- };
@@ -1,27 +0,0 @@
1
- import { spawnSync } from "node:child_process";
2
- import path from "node:path";
3
- import { renderNextSteps } from "../first-run.mjs";
4
-
5
- export default {
6
- name: "init",
7
- summary: "install agent lanes + read plane (dry-run by default)",
8
- group: "read",
9
- usage: "oracle init [--apply --force --only <lane> --json --yes]",
10
- async run(ctx) {
11
- const argv = [...ctx.argv];
12
- if (argv.includes("--yes") && !argv.includes("--apply")) argv.push("--apply");
13
- const bin = ctx.bin("oracle-init.mjs");
14
- const r = spawnSync(process.execPath, [bin, ...argv], { encoding: "utf8", env: process.env });
15
- if (r.error) {
16
- process.stderr.write(`oracle: failed to spawn oracle-init: ${r.error.message}\n`);
17
- return 1;
18
- }
19
- if (r.stdout) process.stdout.write(r.stdout);
20
- if (r.stderr) process.stderr.write(r.stderr);
21
- const code = typeof r.status === "number" ? r.status : 1;
22
- if (code === 0 && argv.includes("--apply") && !argv.includes("--json")) {
23
- process.stdout.write(renderNextSteps());
24
- }
25
- return code;
26
- },
27
- };