@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,119 +0,0 @@
1
- // Solana venue labels routed through the Jupiter aggregator provider.
2
- //
3
- // Preserved as source data on 2026-08-03: this roster previously existed only
4
- // as markup in the splash page, so deleting that markup silently deleted the
5
- // evidence behind the README/site claim. Data belongs in src/, not in a
6
- // presentation layer that a redesign can drop.
7
- //
8
- // 101 program labels resolving to 98 unique venue brands: Aldrin/Aldrin V2,
9
- // Orca V1/Orca V2, and SolFi/SolFi V2 are version variants of one venue.
10
-
11
- export const JUPITER_VENUE_LABELS = Object.freeze([
12
- "1DEX",
13
- "Aldrin",
14
- "Aldrin V2",
15
- "AlphaQ",
16
- "Aquifer",
17
- "BinaryFi",
18
- "BisonFi",
19
- "BisonFi Predict",
20
- "Bonkswap",
21
- "Boop.fun",
22
- "Byreal",
23
- "Carrot",
24
- "Crema",
25
- "Cropper",
26
- "customizable",
27
- "DefiTuna",
28
- "Denali",
29
- "Deriverse",
30
- "DexLab",
31
- "Dynamic Bonding Curve",
32
- "Flint",
33
- "Flux",
34
- "FluxBeam",
35
- "GatorSwap",
36
- "Gavel",
37
- "GoonFi V2",
38
- "GooseFX GAMMA",
39
- "Guacswap",
40
- "Hadron",
41
- "Heaven",
42
- "Helium Network",
43
- "Huma",
44
- "HumidiFi",
45
- "Hylo Exchange",
46
- "Hylo Stability Pool",
47
- "Invariant",
48
- "Jupiter Lend Earn",
49
- "JupiterRfqV2",
50
- "JupLend AMM",
51
- "Kipseli",
52
- "LemmingsFi",
53
- "Manifest",
54
- "Mercurial",
55
- "MetaDAO",
56
- "Meteora",
57
- "Meteora DAMM v2",
58
- "Meteora DLMM",
59
- "Metric",
60
- "Moonit",
61
- "more chains",
62
- "M Swap",
63
- "Obric V2",
64
- "Obsidian",
65
- "Omnipair",
66
- "OpenBook V2",
67
- "Orca V1",
68
- "Orca V2",
69
- "PancakeSwap",
70
- "Penguin",
71
- "Perena",
72
- "Perena Star",
73
- "Perps",
74
- "Phoenix",
75
- "protocol builder",
76
- "Pump.fun",
77
- "Pump.fun Amm",
78
- "Quantum",
79
- "Raydium",
80
- "Raydium CLMM",
81
- "Raydium CP",
82
- "Raydium Launchlab",
83
- "Riptide",
84
- "RunnerRodeo",
85
- "Saber",
86
- "Saber (Decimals)",
87
- "Sanctum",
88
- "Sanctum Infinity",
89
- "Saros",
90
- "Saros DLMM",
91
- "Scale Amm",
92
- "Scale Vmm",
93
- "Scorch",
94
- "Solayer",
95
- "SolFi",
96
- "SolFi V2",
97
- "Stabble CLMM",
98
- "Stabble Stable Swap",
99
- "Stabble Weighted Swap",
100
- "StepN",
101
- "TaurusFi",
102
- "TesseraV",
103
- "Token Swap",
104
- "Trends",
105
- "VaultLiquidUnstake",
106
- "Virtuals",
107
- "Voltr",
108
- "WhaleStreet",
109
- "Whirlpool",
110
- "Woofi",
111
- "XOrca",
112
- "ZeroFi"
113
- ]);
114
-
115
- /** Unique venue brands, collapsing version variants. */
116
- export function uniqueVenueBrands() {
117
- const norm = (s) => s.toLowerCase().replace(/\s+v[0-9]+$/, "").replace(/[^a-z0-9]/g, "");
118
- return new Set(JUPITER_VENUE_LABELS.map(norm));
119
- }
@@ -1,315 +0,0 @@
1
- // Jupiter Swap API lane for Solana. Prepare-only: returns a serialized
2
- // transaction for the user's Solana wallet to sign. No local signer, no broadcast.
3
-
4
- import { httpJson } from "../http.mjs";
5
- import { solanaPubkey } from "./solana-rpc.mjs";
6
- import { stampPrepared } from "../../prepare-envelope.mjs";
7
- import { assertNoSignedMaterial } from "./signed-material-guard.mjs";
8
-
9
- export const JUPITER_SWAP_API = "https://lite-api.jup.ag/swap/v1";
10
- export const SOL_MINT = "So11111111111111111111111111111111111111112";
11
- export const USDC_MINT = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
12
- export const JUPITER_MAX_SLIPPAGE_BPS = 100;
13
- const DEFAULT_QUOTE_TTL_MS = 20_000;
14
-
15
- function baseUrl(opts = {}) {
16
- return String(opts.baseUrl || process.env.JUPITER_SWAP_API_URL || JUPITER_SWAP_API).replace(/\/$/, "");
17
- }
18
-
19
- function amountString(value, label = "amount") {
20
- try {
21
- const n = BigInt(String(value));
22
- if (n <= 0n) throw new Error("nonpositive");
23
- return n.toString();
24
- } catch {
25
- throw new Error(`jupiter: ${label} must be a positive integer string`);
26
- }
27
- }
28
-
29
- function slippageBps(value) {
30
- const n = value == null ? 50 : Number(value);
31
- if (!Number.isInteger(n) || n < 0) throw new Error("jupiter: slippageBps must be a non-negative integer");
32
- if (n > JUPITER_MAX_SLIPPAGE_BPS) throw new Error("jupiter: slippage exceeds hard 100 bps cap");
33
- return n;
34
- }
35
-
36
- function boolDefault(value, fallback) {
37
- return value == null ? fallback : Boolean(value);
38
- }
39
-
40
- function base64Tx(value) {
41
- const text = String(value || "").trim();
42
- if (!/^[A-Za-z0-9+/]+={0,2}$/.test(text) || text.length % 4 !== 0) throw new Error("jupiter: swapTransaction must be base64");
43
- return text;
44
- }
45
-
46
- function solanaGuard(quote = {}, { quotedAtMs = Date.now(), ttlMs = DEFAULT_QUOTE_TTL_MS } = {}) {
47
- const inputMint = solanaPubkey(quote.inputMint, "inputMint");
48
- const outputMint = solanaPubkey(quote.outputMint, "outputMint");
49
- const inAmount = amountString(quote.inAmount, "inAmount");
50
- const outAmount = amountString(quote.outAmount, "outAmount");
51
- const otherAmountThreshold = amountString(quote.otherAmountThreshold ?? quote.outAmount, "otherAmountThreshold");
52
- const bps = slippageBps(quote.slippageBps ?? 50);
53
- return {
54
- mode: "solana-jupiter-quote",
55
- provider: "jupiter",
56
- venue: "jupiter-swap-v1",
57
- inputMint,
58
- outputMint,
59
- inAmount,
60
- outAmount,
61
- otherAmountThreshold,
62
- slippageBps: bps,
63
- contextSlot: quote.contextSlot ?? null,
64
- quotedAtMs,
65
- expiresAtMs: quotedAtMs + Math.min(Math.max(Number(ttlMs) || DEFAULT_QUOTE_TTL_MS, 1_000), 30_000),
66
- };
67
- }
68
-
69
- // Known BPF loaders. A program is only real if it is BOTH executable AND owned
70
- // by one of these. `executable: true` alone is claimable by any account, so
71
- // checking it in isolation is not proof.
72
- const SOLANA_LOADERS = new Set([
73
- "BPFLoaderUpgradeab1e11111111111111111111111",
74
- "BPFLoader2111111111111111111111111111111111",
75
- "BPFLoader1111111111111111111111111111111111",
76
- ]);
77
-
78
- const B58_ALPHA = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
79
-
80
- function isSolanaPubkey(s) {
81
- if (typeof s !== "string" || !s.length) return false;
82
- let num = 0n;
83
- for (const ch of s) {
84
- const v = B58_ALPHA.indexOf(ch);
85
- if (v < 0) return false;
86
- num = num * 58n + BigInt(v);
87
- }
88
- let hex = num.toString(16);
89
- if (hex.length % 2) hex = "0" + hex;
90
- let bytes = hex.length / 2;
91
- for (const ch of s) {
92
- if (ch === "1") bytes++;
93
- else break;
94
- }
95
- return bytes === 32;
96
- }
97
-
98
- export async function jupiterVenues(args = {}, opts = {}) {
99
- const rpcUrl = args.rpc || opts.solanaRpc || process.env.SOLANA_RPC || "https://api.mainnet-beta.solana.com";
100
- const fetchImpl = opts.fetchImpl || fetch;
101
-
102
- const res = await fetchImpl(`${JUPITER_SWAP_API}/program-id-to-label`, {
103
- signal: AbortSignal.timeout(Number(opts.timeoutMs) || 15_000),
104
- });
105
- if (!res.ok) throw new Error(`jupiter venue map failed: HTTP ${res.status}`);
106
- const labelMap = await res.json();
107
-
108
- const entries = Object.entries(labelMap);
109
- const wellFormed = entries.filter(([id]) => isSolanaPubkey(id));
110
- const verified = [];
111
- const unresolved = entries
112
- .filter(([id]) => !isSolanaPubkey(id))
113
- .map(([id, label]) => ({ programId: id, label, reason: "malformed program id" }));
114
-
115
- if (args.verify === false) {
116
- return {
117
- source: `${JUPITER_SWAP_API}/program-id-to-label`,
118
- verified: wellFormed.map(([programId, label]) => ({ programId, label })),
119
- unresolved,
120
- verifiedOnChain: false,
121
- totals: { fromRouterMap: entries.length, verified: wellFormed.length },
122
- };
123
- }
124
-
125
- const call = async (body) => {
126
- const r = await fetchImpl(rpcUrl, {
127
- method: "POST",
128
- headers: { "content-type": "application/json" },
129
- body: JSON.stringify(body),
130
- signal: AbortSignal.timeout(Number(opts.timeoutMs) || 20_000),
131
- });
132
- const j = await r.json();
133
- if (j.error) throw new Error(j.error.message);
134
- return j.result;
135
- };
136
-
137
- for (let i = 0; i < wellFormed.length; i += 90) {
138
- const chunk = wellFormed.slice(i, i + 90);
139
- let out = null;
140
- for (let attempt = 0; attempt < 3 && !out; attempt++) {
141
- try {
142
- out = await call({
143
- jsonrpc: "2.0",
144
- id: 1,
145
- method: "getMultipleAccounts",
146
- params: [chunk.map(([id]) => id), { encoding: "base64", dataSlice: { offset: 0, length: 0 } }],
147
- });
148
- } catch {
149
- await new Promise((r) => setTimeout(r, 2000 * (attempt + 1)));
150
- }
151
- }
152
- if (!out) {
153
- for (const [programId, label] of chunk) {
154
- unresolved.push({ programId, label, reason: "rpc batch failed after 3 attempts" });
155
- }
156
- continue;
157
- }
158
- out.value.forEach((acc, k) => {
159
- const [programId, label] = chunk[k];
160
- if (acc && acc.executable === true && SOLANA_LOADERS.has(acc.owner)) {
161
- verified.push({ programId, label, owner: acc.owner });
162
- } else {
163
- unresolved.push({
164
- programId,
165
- label,
166
- reason: !acc ? "account not found" : acc.executable !== true ? "not executable" : `unknown owner ${acc.owner}`,
167
- });
168
- }
169
- });
170
- if (i + 90 < wellFormed.length) await new Promise((r) => setTimeout(r, 700));
171
- }
172
-
173
- const brands = new Set(
174
- verified.map((v) => v.label.replace(/\s+(CLMM|CP|V\d+|Launchlab|DLMM|Pools?)$/i, "").trim())
175
- );
176
-
177
- return {
178
- source: `${JUPITER_SWAP_API}/program-id-to-label`,
179
- rpc: rpcUrl,
180
- verifiedOnChain: true,
181
- verifiedAt: new Date().toISOString(),
182
- totals: {
183
- fromRouterMap: entries.length,
184
- verified: verified.length,
185
- unresolved: unresolved.length,
186
- distinctLabels: new Set(verified.map((v) => v.label)).size,
187
- distinctBrands: brands.size,
188
- },
189
- verified: verified.sort((a, b) => a.label.localeCompare(b.label)),
190
- unresolved,
191
- };
192
- }
193
-
194
- export async function jupiterHealth(opts = {}) {
195
- try {
196
- const q = await jupiterQuote({ inputMint: SOL_MINT, outputMint: USDC_MINT, amount: "1000000", slippageBps: 50 }, opts);
197
- return { ok: true, provider: "jupiter", outAmount: q.quote.outAmount, exec: false };
198
- } catch (error) {
199
- return { ok: false, provider: "jupiter", error: String(error?.message || error), exec: false };
200
- }
201
- }
202
-
203
- export async function jupiterQuote(args = {}, opts = {}) {
204
- const inputMint = solanaPubkey(args.inputMint || args.fromMint || SOL_MINT, "inputMint");
205
- const outputMint = solanaPubkey(args.outputMint || args.toMint || USDC_MINT, "outputMint");
206
- const amount = amountString(args.amount || args.inAmount, "amount");
207
- const bps = slippageBps(args.slippageBps ?? args.maxSlippageBps ?? 50);
208
- const url = new URL(`${baseUrl(opts)}/quote`);
209
- url.searchParams.set("inputMint", inputMint);
210
- url.searchParams.set("outputMint", outputMint);
211
- url.searchParams.set("amount", amount);
212
- url.searchParams.set("slippageBps", String(bps));
213
- url.searchParams.set("swapMode", args.swapMode || "ExactIn");
214
- if (args.onlyDirectRoutes != null) url.searchParams.set("onlyDirectRoutes", String(Boolean(args.onlyDirectRoutes)));
215
- if (args.platformFeeBps != null) url.searchParams.set("platformFeeBps", String(args.platformFeeBps));
216
- const quote = await httpJson(url.toString(), {
217
- fetchImpl: opts.fetchImpl,
218
- timeoutMs: opts.timeoutMs ?? 12_000,
219
- });
220
- const guard = solanaGuard({ ...quote, slippageBps: bps }, opts);
221
- return {
222
- provider: "jupiter",
223
- chain: "solana-mainnet-beta",
224
- quoteReady: true,
225
- executionReady: false,
226
- inputMint,
227
- outputMint,
228
- amount,
229
- quote,
230
- solanaGuard: guard,
231
- };
232
- }
233
-
234
- function compactBody(body) {
235
- return Object.fromEntries(Object.entries(body).filter(([, v]) => v !== undefined));
236
- }
237
-
238
- export async function jupiterPrepareSwap(args = {}, opts = {}) {
239
- const userPublicKey = solanaPubkey(args.userPublicKey || args.owner || args.wallet, "userPublicKey");
240
- const quoteEnvelope = args.quoteResponse
241
- ? { quote: args.quoteResponse, solanaGuard: solanaGuard(args.quoteResponse, opts) }
242
- : await jupiterQuote(args, opts);
243
- const quoteResponse = quoteEnvelope.quote;
244
- const guard = quoteEnvelope.solanaGuard || solanaGuard(quoteResponse, opts);
245
-
246
- // dynamicSlippage lets Jupiter widen the on-chain slippage floor at build
247
- // time, which silently voids the hard bps ceiling the quote path enforced —
248
- // the returned guard would still advertise the capped number. Refuse it
249
- // rather than return a transaction whose real tolerance exceeds the cap.
250
- if (boolDefault(args.dynamicSlippage, false) === true) {
251
- throw new Error(
252
- "jupiter: dynamicSlippage would override the enforced slippage ceiling — pass an explicit slippageBps instead"
253
- );
254
- }
255
-
256
- const response = await httpJson(`${baseUrl(opts)}/swap`, {
257
- method: "POST",
258
- body: compactBody({
259
- quoteResponse,
260
- userPublicKey,
261
- wrapAndUnwrapSol: boolDefault(args.wrapAndUnwrapSol, true),
262
- dynamicComputeUnitLimit: boolDefault(args.dynamicComputeUnitLimit, true),
263
- dynamicSlippage: false,
264
- prioritizationFeeLamports: args.prioritizationFeeLamports,
265
- }),
266
- fetchImpl: opts.fetchImpl,
267
- timeoutMs: opts.timeoutMs ?? 15_000,
268
- });
269
- const swapTransaction = base64Tx(response?.swapTransaction);
270
-
271
- // Refuse pre-signed material by PRESENCE. The primary `swapTransaction` field
272
- // stays unsigned, but the full upstream body was echoed as `raw` and
273
- // hash-bound into the envelope, so a hostile endpoint could smuggle a signed
274
- // sibling that downstream tooling might select instead.
275
- assertNoSignedMaterial("jupiter", response);
276
-
277
- // Bind the returned transaction to the quote it claims to implement. A
278
- // compromised or impersonated endpoint can return any bytes while Oracle
279
- // stamps the optimistic quote on top; the user signs the bytes, not the
280
- // guard. Jupiter echoes the quote it built from — require it to match.
281
- const echoed = response?.quoteResponse ?? response?.quote ?? null;
282
- if (echoed) {
283
- for (const field of ["inAmount", "outAmount", "otherAmountThreshold", "inputMint", "outputMint"]) {
284
- const want = quoteResponse?.[field];
285
- const got = echoed?.[field];
286
- if (want != null && got != null && String(want) !== String(got)) {
287
- throw new Error(
288
- `jupiter: swap response ${field} (${got}) does not match the quoted ${field} (${want}) — refusing to prepare`
289
- );
290
- }
291
- }
292
- }
293
-
294
- return stampPrepared({
295
- provider: "jupiter",
296
- chain: "solana-mainnet-beta",
297
- prepareReady: true,
298
- executionReady: false,
299
- signingReady: false,
300
- broadcastReady: false,
301
- requiresUserSignature: true,
302
- // The prepared bytes are NOT verified against the quote beyond the fields
303
- // Jupiter echoes. Simulate before signing.
304
- verifiedAgainstQuote: Boolean(echoed),
305
- userPublicKey,
306
- quote: quoteResponse,
307
- solanaGuard: guard,
308
- swapTransaction,
309
- swapTransactionEncoding: "base64",
310
- lastValidBlockHeight: response?.lastValidBlockHeight ?? null,
311
- prioritizationFeeLamports: response?.prioritizationFeeLamports ?? null,
312
- computeUnitLimit: response?.computeUnitLimit ?? null,
313
- raw: response,
314
- }, { provider: "jupiter", kind: "jupiter-swap" });
315
- }
@@ -1,143 +0,0 @@
1
- // Kamino Finance — Solana concentrated-liquidity vault strategies and APY.
2
- //
3
- // One upstream call returns metrics for every live strategy (500+), so this
4
- // module fetches once and filters/sorts locally rather than issuing a request
5
- // per strategy. Read-only: no deposit or withdraw preparation.
6
-
7
- import { httpJson } from "../http.mjs";
8
-
9
- export const KAMINO_API = "https://api.kamino.finance";
10
-
11
- function base(opts = {}) {
12
- return String(opts.baseUrl || process.env.KAMINO_API_URL || KAMINO_API).replace(/\/$/, "");
13
- }
14
-
15
- function num(value) {
16
- const n = Number(value);
17
- return Number.isFinite(n) ? n : null;
18
- }
19
-
20
- function normalizeStrategy(entry = {}) {
21
- const tvl = num(entry.totalValueLocked) ?? 0;
22
- // Kamino splits yield: `apy` is trading fees + pool rewards, `kaminoApy` is
23
- // the kToken incentive layer. Neither alone is the number a depositor earns.
24
- const feeApy = num(entry.apy?.totalApy) ?? 0;
25
- const rewardApy = num(entry.kaminoApy?.totalApy) ?? 0;
26
- return {
27
- strategy: entry.strategy || null,
28
- pair: entry.tokenA && entry.tokenB ? `${entry.tokenA}-${entry.tokenB}` : null,
29
- tokenA: entry.tokenA || null,
30
- tokenB: entry.tokenB || null,
31
- tokenAMint: entry.tokenAMint || null,
32
- tokenBMint: entry.tokenBMint || null,
33
- tvlUsd: tvl,
34
- sharePrice: num(entry.sharePrice),
35
- sharesIssued: num(entry.sharesIssued),
36
- profitAndLoss: num(entry.profitAndLoss),
37
- feeApy,
38
- feeApyPct: feeApy * 100,
39
- rewardApy,
40
- rewardApyPct: rewardApy * 100,
41
- totalApy: feeApy + rewardApy,
42
- totalApyPct: (feeApy + rewardApy) * 100,
43
- apr24h: num(entry.apy?.vault?.totalApr),
44
- apy24h: num(entry.kaminoApy?.vault?.apy24h),
45
- apy7d: num(entry.kaminoApy?.vault?.apy7d),
46
- apy30d: num(entry.kaminoApy?.vault?.apy30d),
47
- poolPrice: num(entry.apy?.vault?.poolPrice),
48
- priceLower: num(entry.apy?.vault?.priceLower),
49
- priceUpper: num(entry.apy?.vault?.priceUpper),
50
- // A range-exited strategy has stopped earning fees — surface it loudly.
51
- outOfRange: Boolean(entry.apy?.vault?.strategyOutOfRange),
52
- rewardMints: entry.rewardMints || [],
53
- balances: entry.vaultBalances || null,
54
- lastCalculated: entry.kaminoApy?.vault?.lastCalculated || null,
55
- };
56
- }
57
-
58
- async function fetchMetrics(args = {}, opts = {}) {
59
- const url = new URL(`${base(opts)}/strategies/metrics`);
60
- url.searchParams.set("env", String(args.env || "mainnet-beta"));
61
- url.searchParams.set("status", String(args.status || "LIVE"));
62
- const data = await httpJson(url.toString(), {
63
- fetchImpl: opts.fetchImpl,
64
- // 500+ strategies with nested APY blocks — this is a large, slow payload.
65
- timeoutMs: opts.timeoutMs ?? 45_000,
66
- });
67
- return Array.isArray(data) ? data : [];
68
- }
69
-
70
- export async function kaminoHealth(opts = {}) {
71
- try {
72
- const raw = await fetchMetrics({}, opts);
73
- const funded = raw.filter((s) => (Number(s.totalValueLocked) || 0) > 0).length;
74
- return {
75
- ok: raw.length > 0,
76
- provider: "kamino-strategies",
77
- strategies: raw.length,
78
- funded,
79
- exec: false,
80
- };
81
- } catch (error) {
82
- return { ok: false, provider: "kamino-strategies", error: String(error?.message || error), exec: false };
83
- }
84
- }
85
-
86
- /**
87
- * Live strategies, filterable and ranked. Defaults hide the long tail of
88
- * empty/dust vaults, which are the bulk of the 500+ raw rows and are not
89
- * actionable yield.
90
- */
91
- export async function kaminoStrategies(args = {}, opts = {}) {
92
- const raw = await fetchMetrics(args, opts);
93
- let strategies = raw.map(normalizeStrategy);
94
- const total = strategies.length;
95
-
96
- const minTvl = Number.isFinite(Number(args.minTvlUsd)) ? Number(args.minTvlUsd) : 10_000;
97
- strategies = strategies.filter((s) => s.tvlUsd >= minTvl);
98
-
99
- if (args.token) {
100
- const want = String(args.token).toLowerCase();
101
- strategies = strategies.filter(
102
- (s) =>
103
- String(s.tokenA || "").toLowerCase() === want ||
104
- String(s.tokenB || "").toLowerCase() === want ||
105
- s.tokenAMint === args.token ||
106
- s.tokenBMint === args.token
107
- );
108
- }
109
- if (args.pair) {
110
- const want = String(args.pair).toLowerCase().replace(/[/_]/g, "-");
111
- strategies = strategies.filter((s) => String(s.pair || "").toLowerCase() === want);
112
- }
113
- if (args.inRangeOnly === true) strategies = strategies.filter((s) => !s.outOfRange);
114
-
115
- const sortBy = String(args.sortBy || "apy");
116
- strategies.sort((a, b) => (sortBy === "tvl" ? b.tvlUsd - a.tvlUsd : b.totalApy - a.totalApy));
117
-
118
- const limit = Number.isFinite(Number(args.limit)) && Number(args.limit) > 0 ? Number(args.limit) : 25;
119
- const page = strategies.slice(0, limit);
120
-
121
- return {
122
- provider: "kamino-strategies",
123
- chain: "solana-mainnet-beta",
124
- env: args.env || "mainnet-beta",
125
- status: args.status || "LIVE",
126
- totalStrategies: total,
127
- matched: strategies.length,
128
- count: page.length,
129
- minTvlUsd: minTvl,
130
- tvlUsdMatched: strategies.reduce((a, s) => a + s.tvlUsd, 0),
131
- strategies: page,
132
- };
133
- }
134
-
135
- /** Metrics for one strategy address. */
136
- export async function kaminoStrategyMetrics(args = {}, opts = {}) {
137
- const address = String(args.strategy || args.address || "").trim();
138
- if (!address) throw new Error("kamino-strategies: strategy address required");
139
- const raw = await fetchMetrics({ ...args, status: args.status || "ALL" }, opts);
140
- const found = raw.find((s) => s.strategy === address);
141
- if (!found) throw new Error(`kamino-strategies: strategy ${address} not found`);
142
- return { provider: "kamino-strategies", chain: "solana-mainnet-beta", ...normalizeStrategy(found), raw: found };
143
- }
@@ -1,42 +0,0 @@
1
- // L2Beat — L2 scaling TVL and activity data (no API key).
2
-
3
- import { httpJson } from "../http.mjs";
4
-
5
- export const L2BEAT_API = "https://api.l2beat.com";
6
-
7
- function base(opts = {}) {
8
- return (opts.baseUrl || process.env.L2BEAT_API_URL || L2BEAT_API).replace(/\/$/, "");
9
- }
10
-
11
- export async function l2beatHealth(opts = {}) {
12
- try {
13
- const data = await httpJson(`${base(opts)}/api/scaling/tvl`, {
14
- fetchImpl: opts.fetchImpl,
15
- timeoutMs: opts.timeoutMs ?? 15_000,
16
- });
17
- return { ok: data && typeof data.totalUsd === "string", provider: "l2beat-tvl" };
18
- } catch (e) {
19
- return { ok: false, provider: "l2beat-tvl", error: String(e.message || e).slice(0, 120) };
20
- }
21
- }
22
-
23
- export async function l2beatTvl(args = {}, opts = {}) {
24
- const data = await httpJson(`${base(opts)}/api/scaling/tvl`, {
25
- fetchImpl: opts.fetchImpl,
26
- timeoutMs: opts.timeoutMs ?? 20_000,
27
- });
28
- if (args.project) {
29
- const name = String(args.project).toLowerCase();
30
- const projects = data?.projects || {};
31
- const found = Object.entries(projects).find(([k]) => String(k).toLowerCase() === name);
32
- return found ? { [found[0]]: found[1] } : {};
33
- }
34
- return data;
35
- }
36
-
37
- export async function l2beatActivity(args = {}, opts = {}) {
38
- return httpJson(`${base(opts)}/api/scaling/activity`, {
39
- fetchImpl: opts.fetchImpl,
40
- timeoutMs: opts.timeoutMs ?? 20_000,
41
- });
42
- }