@oracle-agent/oracle 0.14.1 → 0.16.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 (450) 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 +60 -0
  7. package/dist/bin/oracle-data-mcp.mjs +9 -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 +63 -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/strategy.mjs +18 -0
  44. package/dist/cli/commands/swap.mjs +36 -0
  45. package/dist/cli/commands/upgrade.mjs +2 -0
  46. package/dist/cli/commands/vault.mjs +1 -0
  47. package/dist/cli/commands/version.mjs +2 -0
  48. package/dist/data/desk-data.mjs +55 -0
  49. package/dist/data/names.mjs +2 -0
  50. package/dist/data/providers/farming.mjs +2 -0
  51. package/dist/equities/index.mjs +1 -0
  52. package/dist/index.mjs +60 -0
  53. package/dist/nft-gas-war-guard.mjs +1 -0
  54. package/dist/onboarding/harness-configs.mjs +4 -0
  55. package/dist/portfolio-risk.mjs +1 -0
  56. package/dist/prepare-envelope.mjs +1 -0
  57. package/dist/public-api/agent-grants.mjs +3 -0
  58. package/dist/public-control/policy-schema.mjs +1 -0
  59. package/dist/router/index.mjs +2 -0
  60. package/dist/scanner/index.mjs +4 -0
  61. package/dist/signals/index.mjs +1 -0
  62. package/dist/strategy/index.mjs +3 -0
  63. package/dist/watch-preferences.mjs +1 -0
  64. package/package.json +33 -78
  65. package/public/oracle-splash/_variants/ice.html +5 -18
  66. package/public/oracle-splash/_variants/ivory.html +5 -18
  67. package/public/oracle-splash/downloads/index.html +4 -4
  68. package/public/oracle-splash/index.html +113 -34
  69. package/CONTRIBUTING.md +0 -99
  70. package/bin/desk-server.mjs +0 -473
  71. package/bin/oracle-data-mcp.mjs +0 -1252
  72. package/bin/oracle-equities.mjs +0 -168
  73. package/bin/oracle-init.mjs +0 -525
  74. package/bin/oracle-public-server.mjs +0 -36
  75. package/bin/oracle-route.mjs +0 -254
  76. package/bin/oracle-scan.mjs +0 -192
  77. package/bin/oracle-upgrade.mjs +0 -42
  78. package/bin/oracle.mjs +0 -34
  79. package/docs/adding-a-chain.md +0 -229
  80. package/docs/architecture.md +0 -139
  81. package/docs/buzz-integration.md +0 -115
  82. package/docs/cli.md +0 -143
  83. package/docs/connectors.md +0 -13
  84. package/docs/hyperliquid-builder-code.md +0 -50
  85. package/docs/locals-only-fee-waiver.md +0 -34
  86. package/docs/oracle-pack-standard.md +0 -29
  87. package/docs/profiles.md +0 -151
  88. package/docs/public-surface.md +0 -206
  89. package/examples/add-a-chain.mjs +0 -65
  90. package/examples/oracle-pack-template.mjs +0 -38
  91. package/examples/research-a-token.mjs +0 -70
  92. package/plugins/oracle-owner-gate/__init__.py +0 -288
  93. package/plugins/oracle-owner-gate/plugin.yaml +0 -9
  94. package/protocols/templates/safe-erc20/SECURITY.md +0 -16
  95. package/protocols/templates/safe-erc20/foundry.toml +0 -12
  96. package/protocols/templates/safe-erc20/remappings.txt +0 -2
  97. package/protocols/templates/safe-erc20/src/SafeERC20.sol +0 -53
  98. package/protocols/templates/safe-erc20/test/SafeERC20.t.sol +0 -72
  99. package/scripts/adversarial-bench.mjs +0 -114
  100. package/scripts/build-dist.mjs +0 -119
  101. package/scripts/build-inscription.py +0 -230
  102. package/scripts/check-doc-drift.mjs +0 -123
  103. package/scripts/check-test-count.mjs +0 -105
  104. package/scripts/e2e-hl-markets.mjs +0 -21
  105. package/scripts/e2e-hl-perps.mjs +0 -48
  106. package/scripts/e2e-hypercore-staking.mjs +0 -128
  107. package/scripts/e2e-solana-bitcoin.mjs +0 -183
  108. package/scripts/guard-publish.mjs +0 -22
  109. package/scripts/protocol-template-gate.mjs +0 -15
  110. package/scripts/public-api-scan.mjs +0 -23
  111. package/scripts/publish-dist.mjs +0 -67
  112. package/scripts/record-hero-cli.sh +0 -80
  113. package/scripts/secret-scan.mjs +0 -169
  114. package/scripts/smoke-dist-bins.mjs +0 -89
  115. package/scripts/verify-dist.mjs +0 -29
  116. package/scripts/verify-v3-venues.mjs +0 -233
  117. package/skins/oracle.yaml +0 -56
  118. package/src/action-receipts.mjs +0 -265
  119. package/src/action-semantics.mjs +0 -62
  120. package/src/address-book.mjs +0 -208
  121. package/src/agent-auth.mjs +0 -206
  122. package/src/approval-guard.mjs +0 -282
  123. package/src/attestation-secret.mjs +0 -94
  124. package/src/audit-log.mjs +0 -196
  125. package/src/auth/oauth.mjs +0 -672
  126. package/src/auto-slippage.mjs +0 -378
  127. package/src/capability-posture.mjs +0 -125
  128. package/src/cards.mjs +0 -422
  129. package/src/chains.mjs +0 -62
  130. package/src/cli/chain-catalog.mjs +0 -215
  131. package/src/cli/chain-state.mjs +0 -74
  132. package/src/cli/commands/auth.mjs +0 -193
  133. package/src/cli/commands/bootstrap.mjs +0 -87
  134. package/src/cli/commands/chain.mjs +0 -143
  135. package/src/cli/commands/chat.mjs +0 -465
  136. package/src/cli/commands/credential.mjs +0 -9
  137. package/src/cli/commands/data-mcp.mjs +0 -18
  138. package/src/cli/commands/data.mjs +0 -75
  139. package/src/cli/commands/doctor.mjs +0 -136
  140. package/src/cli/commands/equities.mjs +0 -41
  141. package/src/cli/commands/farm.mjs +0 -129
  142. package/src/cli/commands/fees.mjs +0 -109
  143. package/src/cli/commands/follow.mjs +0 -130
  144. package/src/cli/commands/harness.mjs +0 -63
  145. package/src/cli/commands/help.mjs +0 -7
  146. package/src/cli/commands/init.mjs +0 -27
  147. package/src/cli/commands/mcp.mjs +0 -154
  148. package/src/cli/commands/model.mjs +0 -106
  149. package/src/cli/commands/plugins.mjs +0 -275
  150. package/src/cli/commands/prepare.mjs +0 -12
  151. package/src/cli/commands/public.mjs +0 -20
  152. package/src/cli/commands/resolve.mjs +0 -64
  153. package/src/cli/commands/route.mjs +0 -12
  154. package/src/cli/commands/runner.mjs +0 -9
  155. package/src/cli/commands/scan.mjs +0 -12
  156. package/src/cli/commands/setup.mjs +0 -294
  157. package/src/cli/commands/sign.mjs +0 -21
  158. package/src/cli/commands/signer.mjs +0 -9
  159. package/src/cli/commands/swap.mjs +0 -102
  160. package/src/cli/commands/upgrade.mjs +0 -12
  161. package/src/cli/commands/vault.mjs +0 -9
  162. package/src/cli/commands/version.mjs +0 -22
  163. package/src/cli/first-run.mjs +0 -23
  164. package/src/cli/kernel.mjs +0 -262
  165. package/src/cli/mcp-targets/chatgpt.mjs +0 -51
  166. package/src/cli/mcp-targets/claude-code.mjs +0 -39
  167. package/src/cli/mcp-targets/claude-desktop.mjs +0 -24
  168. package/src/cli/mcp-targets/codex.mjs +0 -41
  169. package/src/cli/mcp-targets/cursor.mjs +0 -32
  170. package/src/cli/mcp-targets/shared.mjs +0 -71
  171. package/src/cli/mcp-targets/vscode.mjs +0 -39
  172. package/src/cli/messaging-platforms.mjs +0 -217
  173. package/src/cli/model-config.mjs +0 -78
  174. package/src/cli/operator-dispatch.mjs +0 -194
  175. package/src/cli/oracle-harness.py +0 -415
  176. package/src/cli/paths.mjs +0 -107
  177. package/src/cli/runtime.mjs +0 -351
  178. package/src/cli/setup-state.mjs +0 -168
  179. package/src/cli/spawn-child.mjs +0 -43
  180. package/src/data/catalog.mjs +0 -858
  181. package/src/data/desk-data.mjs +0 -877
  182. package/src/data/http.mjs +0 -253
  183. package/src/data/names.mjs +0 -188
  184. package/src/data/provider-endpoint.mjs +0 -94
  185. package/src/data/providers/aave-v3.mjs +0 -139
  186. package/src/data/providers/across-bridge.mjs +0 -41
  187. package/src/data/providers/aerodrome.mjs +0 -245
  188. package/src/data/providers/aevo.mjs +0 -33
  189. package/src/data/providers/approval-indexer.mjs +0 -133
  190. package/src/data/providers/approvals.mjs +0 -594
  191. package/src/data/providers/babylon-staking.mjs +0 -149
  192. package/src/data/providers/balancer.mjs +0 -209
  193. package/src/data/providers/beefy-yields.mjs +0 -45
  194. package/src/data/providers/birdeye-tokens.mjs +0 -33
  195. package/src/data/providers/bisq-markets.mjs +0 -145
  196. package/src/data/providers/bitcoin-esplora.mjs +0 -216
  197. package/src/data/providers/bitcoin-meta.mjs +0 -378
  198. package/src/data/providers/blockscout.mjs +0 -14
  199. package/src/data/providers/bob-rootstock.mjs +0 -198
  200. package/src/data/providers/braiins-insights.mjs +0 -103
  201. package/src/data/providers/bridge-aggregator.mjs +0 -259
  202. package/src/data/providers/bridges.mjs +0 -242
  203. package/src/data/providers/bungee.mjs +0 -29
  204. package/src/data/providers/celestia-da.mjs +0 -38
  205. package/src/data/providers/changenow.mjs +0 -135
  206. package/src/data/providers/compound.mjs +0 -32
  207. package/src/data/providers/connext.mjs +0 -28
  208. package/src/data/providers/convex.mjs +0 -30
  209. package/src/data/providers/cow-protocol.mjs +0 -110
  210. package/src/data/providers/cowswap.mjs +0 -415
  211. package/src/data/providers/curve.mjs +0 -201
  212. package/src/data/providers/das-assets.mjs +0 -59
  213. package/src/data/providers/debridge.mjs +0 -109
  214. package/src/data/providers/defillama.mjs +0 -88
  215. package/src/data/providers/dexscreener.mjs +0 -43
  216. package/src/data/providers/drift.mjs +0 -32
  217. package/src/data/providers/dydx.mjs +0 -41
  218. package/src/data/providers/evm-rpc.mjs +0 -225
  219. package/src/data/providers/farming.mjs +0 -291
  220. package/src/data/providers/geckoterminal.mjs +0 -34
  221. package/src/data/providers/gmx.mjs +0 -496
  222. package/src/data/providers/hiro-stacks.mjs +0 -150
  223. package/src/data/providers/hl-assets.mjs +0 -165
  224. package/src/data/providers/hl-info.mjs +0 -108
  225. package/src/data/providers/hl-markets.mjs +0 -210
  226. package/src/data/providers/hl-outcome.mjs +0 -61
  227. package/src/data/providers/hl-perps.mjs +0 -419
  228. package/src/data/providers/hl-staking.mjs +0 -353
  229. package/src/data/providers/hl-ws.mjs +0 -119
  230. package/src/data/providers/hyperevm-dex.mjs +0 -49
  231. package/src/data/providers/jito-mev.mjs +0 -117
  232. package/src/data/providers/jupiter-venues.mjs +0 -119
  233. package/src/data/providers/jupiter.mjs +0 -315
  234. package/src/data/providers/kamino-strategies.mjs +0 -143
  235. package/src/data/providers/l2beat-tvl.mjs +0 -42
  236. package/src/data/providers/lifi.mjs +0 -166
  237. package/src/data/providers/liquid-esplora.mjs +0 -152
  238. package/src/data/providers/magiceden-ordinals.mjs +0 -141
  239. package/src/data/providers/magiceden-sol.mjs +0 -406
  240. package/src/data/providers/mempool-lightning.mjs +0 -144
  241. package/src/data/providers/mempool-mining.mjs +0 -142
  242. package/src/data/providers/meteora-dlmm.mjs +0 -168
  243. package/src/data/providers/morpho.mjs +0 -177
  244. package/src/data/providers/nft-gallery.mjs +0 -163
  245. package/src/data/providers/nft-portfolio.mjs +0 -494
  246. package/src/data/providers/odos.mjs +0 -156
  247. package/src/data/providers/ondo.mjs +0 -31
  248. package/src/data/providers/oneinch.mjs +0 -174
  249. package/src/data/providers/opensea-multichain.mjs +0 -136
  250. package/src/data/providers/opensea-nft.mjs +0 -371
  251. package/src/data/providers/orca.mjs +0 -29
  252. package/src/data/providers/ordinals-runes.mjs +0 -180
  253. package/src/data/providers/pancakeswap.mjs +0 -28
  254. package/src/data/providers/paraswap.mjs +0 -125
  255. package/src/data/providers/pendle.mjs +0 -188
  256. package/src/data/providers/poly-clob.mjs +0 -283
  257. package/src/data/providers/poly-public.mjs +0 -96
  258. package/src/data/providers/poly-ws.mjs +0 -103
  259. package/src/data/providers/polygon-staking.mjs +0 -227
  260. package/src/data/providers/portfolio-history.mjs +0 -394
  261. package/src/data/providers/portfolio.mjs +0 -600
  262. package/src/data/providers/pyth-price-feeds.mjs +0 -172
  263. package/src/data/providers/raydium.mjs +0 -35
  264. package/src/data/providers/relayscan-mev.mjs +0 -72
  265. package/src/data/providers/rfq.mjs +0 -15
  266. package/src/data/providers/rh-agent.mjs +0 -59
  267. package/src/data/providers/sanctum-lst.mjs +0 -180
  268. package/src/data/providers/satflow.mjs +0 -341
  269. package/src/data/providers/signed-material-guard.mjs +0 -108
  270. package/src/data/providers/solana-rpc.mjs +0 -197
  271. package/src/data/providers/solend-lending.mjs +0 -166
  272. package/src/data/providers/spark-lend.mjs +0 -42
  273. package/src/data/providers/squid-router.mjs +0 -29
  274. package/src/data/providers/stargate.mjs +0 -29
  275. package/src/data/providers/sushiswap.mjs +0 -30
  276. package/src/data/providers/symbiotic-restaking.mjs +0 -41
  277. package/src/data/providers/thorchain.mjs +0 -36
  278. package/src/data/providers/traderjoe.mjs +0 -28
  279. package/src/data/providers/twap.mjs +0 -152
  280. package/src/data/providers/uniswap-v3.mjs +0 -457
  281. package/src/data/providers/uniswap-v4.mjs +0 -414
  282. package/src/data/providers/vertex.mjs +0 -41
  283. package/src/data/providers/wallet-watch.mjs +0 -264
  284. package/src/data/providers/wormhole.mjs +0 -28
  285. package/src/data/providers/yearn.mjs +0 -31
  286. package/src/data/providers/zerox.mjs +0 -167
  287. package/src/data/public-api-scan.mjs +0 -61
  288. package/src/data/quote-placeholder.mjs +0 -31
  289. package/src/desk/swap-prepare.mjs +0 -194
  290. package/src/equities/bridge.mjs +0 -388
  291. package/src/equities/fixtures/bridge_routes.json +0 -159
  292. package/src/equities/fixtures/dst_transitions.json +0 -29
  293. package/src/equities/fixtures/equity_dex_pools.json +0 -154
  294. package/src/equities/fixtures/hip3_l2books.json +0 -2711
  295. package/src/equities/fixtures/nyse_holidays.json +0 -1
  296. package/src/equities/fixtures/oracles.json +0 -100
  297. package/src/equities/fixtures/rh_pool_state.json +0 -244
  298. package/src/equities/fixtures/solana_xstocks.json +0 -704
  299. package/src/equities/fixtures/ton_xstocks.json +0 -35
  300. package/src/equities/fixtures/universe.json +0 -411
  301. package/src/equities/fixtures/venues.json +0 -3542
  302. package/src/equities/fixtures.mjs +0 -405
  303. package/src/equities/funding.mjs +0 -142
  304. package/src/equities/index.mjs +0 -166
  305. package/src/equities/liveness.mjs +0 -148
  306. package/src/equities/marketHours.mjs +0 -249
  307. package/src/equities/normalize.mjs +0 -295
  308. package/src/equities/num.mjs +0 -146
  309. package/src/equities/prepare.mjs +0 -95
  310. package/src/equities/rank.mjs +0 -260
  311. package/src/equities/sourceNum.mjs +0 -69
  312. package/src/equities/types.mjs +0 -220
  313. package/src/equities/venues/arcus-perp.mjs +0 -84
  314. package/src/equities/venues/arcus-spot.mjs +0 -105
  315. package/src/equities/venues/hyperliquid-hip3.mjs +0 -224
  316. package/src/equities/venues/rh-uniswap.mjs +0 -216
  317. package/src/equities/venues/solana-xstocks.mjs +0 -139
  318. package/src/equities/venues/ton-stonfi.mjs +0 -139
  319. package/src/exact-integer.mjs +0 -72
  320. package/src/exec-policy.mjs +0 -419
  321. package/src/flags.mjs +0 -15
  322. package/src/fresh-window.mjs +0 -76
  323. package/src/gmx-attestation.mjs +0 -176
  324. package/src/index.mjs +0 -107
  325. package/src/licensing/locals-only.mjs +0 -25
  326. package/src/nft-gas-war-guard.mjs +0 -139
  327. package/src/onboarding/agent-keys.mjs +0 -161
  328. package/src/onboarding/harness-configs.mjs +0 -102
  329. package/src/onboarding/index.mjs +0 -18
  330. package/src/onboarding/tiers.mjs +0 -139
  331. package/src/oracle-env.mjs +0 -55
  332. package/src/package-manifest.mjs +0 -42
  333. package/src/plugins/agent-plugin-loader.mjs +0 -225
  334. package/src/portfolio-risk.mjs +0 -170
  335. package/src/prepare-envelope.mjs +0 -204
  336. package/src/profile-upgrade.mjs +0 -277
  337. package/src/protocol-execution.mjs +0 -84
  338. package/src/protocol-templates/gate.mjs +0 -179
  339. package/src/protocol-templates/prepare-deploy.mjs +0 -81
  340. package/src/public-api/agent-grants.mjs +0 -57
  341. package/src/public-api/buzz-integration.mjs +0 -267
  342. package/src/public-api/connect-agent.mjs +0 -424
  343. package/src/public-api/grants.mjs +0 -142
  344. package/src/public-api/http.mjs +0 -707
  345. package/src/public-api/metering.mjs +0 -111
  346. package/src/public-control/aa-adapter.mjs +0 -402
  347. package/src/public-control/build-registry.mjs +0 -227
  348. package/src/public-control/bundler-client.mjs +0 -357
  349. package/src/public-control/grant-indexer.mjs +0 -296
  350. package/src/public-control/policy-render.mjs +0 -69
  351. package/src/public-control/policy-schema.mjs +0 -322
  352. package/src/public-control/runtime-config.mjs +0 -275
  353. package/src/public-control/session-key-model.mjs +0 -379
  354. package/src/public-control/session-orchestrator.mjs +0 -418
  355. package/src/rfq/intent.mjs +0 -180
  356. package/src/rfq/sources.mjs +0 -181
  357. package/src/route-attestation.mjs +0 -132
  358. package/src/router/best-execution.mjs +0 -326
  359. package/src/router/index.mjs +0 -250
  360. package/src/router/integrator-fee.mjs +0 -135
  361. package/src/router/prepare-bridge.mjs +0 -293
  362. package/src/router/prepare-route.mjs +0 -398
  363. package/src/router/proposal.mjs +0 -311
  364. package/src/router/risk-classifier.mjs +0 -119
  365. package/src/router/route-sources.mjs +0 -364
  366. package/src/scanner/chains.config.mjs +0 -543
  367. package/src/scanner/contract.mjs +0 -270
  368. package/src/scanner/evm-scanner.mjs +0 -394
  369. package/src/scanner/index.mjs +0 -9
  370. package/src/scanner/v2-venue.mjs +0 -351
  371. package/src/scanner/v3-venue.mjs +0 -308
  372. package/src/scopes.mjs +0 -44
  373. package/src/sell-simulation.mjs +0 -167
  374. package/src/signals/engine.mjs +0 -146
  375. package/src/signals/index.mjs +0 -1
  376. package/src/token-transfer-guard.mjs +0 -188
  377. package/src/tui/app.mjs +0 -438
  378. package/src/tui/backend.mjs +0 -215
  379. package/src/tui/format.mjs +0 -272
  380. package/src/tui/gateway-client.mjs +0 -177
  381. package/src/tui/input.mjs +0 -501
  382. package/src/tui/memory.mjs +0 -105
  383. package/src/tui/meta-learn.mjs +0 -85
  384. package/src/tui/renderer.mjs +0 -443
  385. package/src/tui/scheduler.mjs +0 -205
  386. package/src/tui/skills-loader.mjs +0 -140
  387. package/src/tui/standalone-client.mjs +0 -752
  388. package/src/tui/theme.mjs +0 -81
  389. package/src/vault-attestation.mjs +0 -146
  390. package/src/venues.mjs +0 -206
  391. package/src/watch-preferences.mjs +0 -85
  392. /package/{profiles → dist/assets/profiles}/_template/SOUL.md +0 -0
  393. /package/{profiles → dist/assets/profiles}/_template/profile.json +0 -0
  394. /package/{profiles → dist/assets/profiles}/bitcoin-agent/SOUL.md +0 -0
  395. /package/{profiles → dist/assets/profiles}/bitcoin-agent/profile.json +0 -0
  396. /package/{profiles → dist/assets/profiles}/hyperliquid-agent/SOUL.md +0 -0
  397. /package/{profiles → dist/assets/profiles}/hyperliquid-agent/profile.json +0 -0
  398. /package/{profiles → dist/assets/profiles}/oracle/SOUL.md +0 -0
  399. /package/{profiles → dist/assets/profiles}/oracle/profile.json +0 -0
  400. /package/{profiles → dist/assets/profiles}/polymarket-agent/SOUL.md +0 -0
  401. /package/{profiles → dist/assets/profiles}/polymarket-agent/profile.json +0 -0
  402. /package/{profiles → dist/assets/profiles}/profile.schema.json +0 -0
  403. /package/{profiles → dist/assets/profiles}/protocol-builder/SOUL.md +0 -0
  404. /package/{profiles → dist/assets/profiles}/protocol-builder/profile.json +0 -0
  405. /package/{profiles → dist/assets/profiles}/robinhood-agent/SOUL.md +0 -0
  406. /package/{profiles → dist/assets/profiles}/robinhood-agent/profile.json +0 -0
  407. /package/{profiles → dist/assets/profiles}/solana-agent/SOUL.md +0 -0
  408. /package/{profiles → dist/assets/profiles}/solana-agent/profile.json +0 -0
  409. /package/{profiles → dist/assets/profiles}/stable-agent/SOUL.md +0 -0
  410. /package/{profiles → dist/assets/profiles}/stable-agent/profile.json +0 -0
  411. /package/{skills → dist/assets/skills}/balance/SKILL.md +0 -0
  412. /package/{skills → dist/assets/skills}/bitcoin-l1.md +0 -0
  413. /package/{skills → dist/assets/skills}/chain-defi-ecosystem-profiling.md +0 -0
  414. /package/{skills → dist/assets/skills}/evm-contract-research.md +0 -0
  415. /package/{skills → dist/assets/skills}/hyperliquid.md +0 -0
  416. /package/{skills → dist/assets/skills}/multichain-exec-desk.md +0 -0
  417. /package/{skills → dist/assets/skills}/oracle-action-semantics/SKILL.md +0 -0
  418. /package/{skills → dist/assets/skills}/oracle-best-execution/SKILL.md +0 -0
  419. /package/{skills → dist/assets/skills}/oracle-best-execution.md +0 -0
  420. /package/{skills → dist/assets/skills}/oracle-bitcoin/SKILL.md +0 -0
  421. /package/{skills → dist/assets/skills}/oracle-chain-graphs-telegram-cards/SKILL.md +0 -0
  422. /package/{skills → dist/assets/skills}/oracle-chat/SKILL.md +0 -0
  423. /package/{skills → dist/assets/skills}/oracle-chat/chain.SKILL.md +0 -0
  424. /package/{skills → dist/assets/skills}/oracle-chat/setup.SKILL.md +0 -0
  425. /package/{skills → dist/assets/skills}/oracle-circuit-breaker/SKILL.md +0 -0
  426. /package/{skills → dist/assets/skills}/oracle-contract-research/SKILL.md +0 -0
  427. /package/{skills → dist/assets/skills}/oracle-desk/SKILL.md +0 -0
  428. /package/{skills → dist/assets/skills}/oracle-desk.md +0 -0
  429. /package/{skills → dist/assets/skills}/oracle-dex-launch/SKILL.md +0 -0
  430. /package/{skills → dist/assets/skills}/oracle-equities/SKILL.md +0 -0
  431. /package/{skills → dist/assets/skills}/oracle-grants/SKILL.md +0 -0
  432. /package/{skills → dist/assets/skills}/oracle-hypercore-staking/SKILL.md +0 -0
  433. /package/{skills → dist/assets/skills}/oracle-hyperliquid/SKILL.md +0 -0
  434. /package/{skills → dist/assets/skills}/oracle-meme-token-sniper/SKILL.md +0 -0
  435. /package/{skills → dist/assets/skills}/oracle-multichain-nft-launch/SKILL.md +0 -0
  436. /package/{skills → dist/assets/skills}/oracle-multichain-token-launch/SKILL.md +0 -0
  437. /package/{skills → dist/assets/skills}/oracle-nft-gacha-launch/SKILL.md +0 -0
  438. /package/{skills → dist/assets/skills}/oracle-nft-mint-gas-war/SKILL.md +0 -0
  439. /package/{skills → dist/assets/skills}/oracle-polymarket/SKILL.md +0 -0
  440. /package/{skills → dist/assets/skills}/oracle-protocol-builder/SKILL.md +0 -0
  441. /package/{skills → dist/assets/skills}/oracle-protocol-security/SKILL.md +0 -0
  442. /package/{skills → dist/assets/skills}/oracle-public-product/SKILL.md +0 -0
  443. /package/{skills → dist/assets/skills}/oracle-receipts/SKILL.md +0 -0
  444. /package/{skills → dist/assets/skills}/oracle-receipts.md +0 -0
  445. /package/{skills → dist/assets/skills}/oracle-rfq-tokenized-assets/SKILL.md +0 -0
  446. /package/{skills → dist/assets/skills}/oracle-smart-wallet-scanner/SKILL.md +0 -0
  447. /package/{skills → dist/assets/skills}/oracle-solana/SKILL.md +0 -0
  448. /package/{skills → dist/assets/skills}/oracle-solana-nft/SKILL.md +0 -0
  449. /package/{skills → dist/assets/skills}/oracle-token-research/SKILL.md +0 -0
  450. /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
- }