@oracle-agent/oracle 0.11.0 → 0.12.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 (308) hide show
  1. package/LICENSE +115 -201
  2. package/README.md +66 -84
  3. package/SECURITY.md +37 -12
  4. package/SETUP.md +207 -272
  5. package/dist/action-receipts.mjs +1 -0
  6. package/dist/action-semantics.mjs +1 -0
  7. package/dist/address-book.mjs +2 -0
  8. package/dist/bin/desk-server.mjs +14 -0
  9. package/dist/bin/oracle-data-mcp.mjs +8 -0
  10. package/dist/bin/oracle-init.mjs +24 -0
  11. package/dist/bin/oracle-public-server.mjs +5 -0
  12. package/dist/bin/oracle-route.mjs +22 -0
  13. package/dist/bin/oracle-scan.mjs +18 -0
  14. package/dist/bin/oracle-upgrade.mjs +21 -0
  15. package/dist/bin/oracle.mjs +68 -0
  16. package/dist/chains.mjs +1 -0
  17. package/dist/cli/commands/auth.mjs +16 -0
  18. package/dist/cli/commands/bootstrap.mjs +18 -0
  19. package/dist/cli/commands/chain.mjs +21 -0
  20. package/dist/cli/commands/chat.mjs +35 -0
  21. package/dist/cli/commands/credential.mjs +1 -0
  22. package/dist/cli/commands/data-mcp.mjs +2 -0
  23. package/dist/cli/commands/data.mjs +12 -0
  24. package/dist/cli/commands/doctor.mjs +5 -0
  25. package/dist/cli/commands/gate.mjs +13 -0
  26. package/dist/cli/commands/help.mjs +1 -0
  27. package/dist/cli/commands/init.mjs +3 -0
  28. package/dist/cli/commands/mcp.mjs +33 -0
  29. package/dist/cli/commands/model.mjs +44 -0
  30. package/dist/cli/commands/prepare.mjs +2 -0
  31. package/dist/cli/commands/public.mjs +3 -0
  32. package/dist/cli/commands/route.mjs +2 -0
  33. package/dist/cli/commands/runner.mjs +1 -0
  34. package/dist/cli/commands/scan.mjs +2 -0
  35. package/dist/cli/commands/setup.mjs +34 -0
  36. package/dist/cli/commands/sign.mjs +4 -0
  37. package/dist/cli/commands/signer.mjs +1 -0
  38. package/dist/cli/commands/upgrade.mjs +2 -0
  39. package/dist/cli/commands/vault.mjs +1 -0
  40. package/dist/cli/commands/version.mjs +2 -0
  41. package/dist/data/desk-data.mjs +12 -0
  42. package/dist/index.mjs +17 -0
  43. package/dist/nft-gas-war-guard.mjs +1 -0
  44. package/dist/onboarding/harness-configs.mjs +4 -0
  45. package/dist/portfolio-risk.mjs +1 -0
  46. package/dist/prepare-envelope.mjs +1 -0
  47. package/dist/public-control/policy-schema.mjs +1 -0
  48. package/dist/router/index.mjs +2 -0
  49. package/dist/scanner/index.mjs +4 -0
  50. package/dist/signals/index.mjs +1 -0
  51. package/dist/watch-preferences.mjs +1 -0
  52. package/package.json +27 -65
  53. package/public/oracle-splash/index.html +11 -1
  54. package/CONTRIBUTING.md +0 -98
  55. package/bin/desk-server.mjs +0 -440
  56. package/bin/oracle-data-mcp.mjs +0 -1019
  57. package/bin/oracle-init.mjs +0 -496
  58. package/bin/oracle-public-server.mjs +0 -36
  59. package/bin/oracle-route.mjs +0 -254
  60. package/bin/oracle-scan.mjs +0 -192
  61. package/bin/oracle-upgrade.mjs +0 -42
  62. package/bin/oracle.mjs +0 -33
  63. package/docs/adding-a-chain.md +0 -229
  64. package/docs/architecture.md +0 -138
  65. package/docs/cli.md +0 -47
  66. package/docs/connectors.md +0 -13
  67. package/docs/oracle-pack-standard.md +0 -29
  68. package/docs/profiles.md +0 -151
  69. package/docs/public-surface.md +0 -133
  70. package/examples/add-a-chain.mjs +0 -65
  71. package/examples/oracle-pack-template.mjs +0 -38
  72. package/examples/research-a-token.mjs +0 -70
  73. package/plugins/oracle-owner-gate/__init__.py +0 -227
  74. package/plugins/oracle-owner-gate/plugin.yaml +0 -9
  75. package/profiles/_template/SOUL.md +0 -54
  76. package/profiles/_template/profile.json +0 -22
  77. package/profiles/bitcoin-agent/SOUL.md +0 -31
  78. package/profiles/bitcoin-agent/profile.json +0 -32
  79. package/profiles/hyperliquid-agent/SOUL.md +0 -34
  80. package/profiles/hyperliquid-agent/profile.json +0 -37
  81. package/profiles/oracle/SOUL.md +0 -107
  82. package/profiles/oracle/profile.json +0 -39
  83. package/profiles/polymarket-agent/SOUL.md +0 -35
  84. package/profiles/polymarket-agent/profile.json +0 -34
  85. package/profiles/profile.schema.json +0 -90
  86. package/profiles/protocol-builder/SOUL.md +0 -57
  87. package/profiles/protocol-builder/profile.json +0 -39
  88. package/profiles/robinhood-agent/SOUL.md +0 -53
  89. package/profiles/robinhood-agent/profile.json +0 -40
  90. package/profiles/solana-agent/SOUL.md +0 -37
  91. package/profiles/solana-agent/profile.json +0 -37
  92. package/profiles/stable-agent/SOUL.md +0 -43
  93. package/profiles/stable-agent/profile.json +0 -37
  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-inscription.py +0 -230
  101. package/scripts/check-doc-drift.mjs +0 -123
  102. package/scripts/check-test-count.mjs +0 -105
  103. package/scripts/e2e-hl-markets.mjs +0 -21
  104. package/scripts/e2e-hl-perps.mjs +0 -48
  105. package/scripts/e2e-hypercore-staking.mjs +0 -128
  106. package/scripts/e2e-solana-bitcoin.mjs +0 -183
  107. package/scripts/protocol-template-gate.mjs +0 -15
  108. package/scripts/public-api-scan.mjs +0 -23
  109. package/scripts/secret-scan.mjs +0 -181
  110. package/scripts/verify-v3-venues.mjs +0 -192
  111. package/skills/balance/SKILL.md +0 -176
  112. package/skills/oracle-action-semantics/SKILL.md +0 -40
  113. package/skills/oracle-best-execution/SKILL.md +0 -127
  114. package/skills/oracle-bitcoin/SKILL.md +0 -53
  115. package/skills/oracle-chain-graphs-telegram-cards/SKILL.md +0 -59
  116. package/skills/oracle-chat/SKILL.md +0 -61
  117. package/skills/oracle-chat/chain.SKILL.md +0 -31
  118. package/skills/oracle-chat/setup.SKILL.md +0 -37
  119. package/skills/oracle-circuit-breaker/SKILL.md +0 -51
  120. package/skills/oracle-contract-research/SKILL.md +0 -55
  121. package/skills/oracle-desk/SKILL.md +0 -58
  122. package/skills/oracle-dex-launch/SKILL.md +0 -38
  123. package/skills/oracle-grants/SKILL.md +0 -69
  124. package/skills/oracle-hypercore-staking/SKILL.md +0 -57
  125. package/skills/oracle-hyperliquid/SKILL.md +0 -56
  126. package/skills/oracle-meme-token-sniper/SKILL.md +0 -73
  127. package/skills/oracle-multichain-nft-launch/SKILL.md +0 -338
  128. package/skills/oracle-multichain-token-launch/SKILL.md +0 -300
  129. package/skills/oracle-nft-gacha-launch/SKILL.md +0 -48
  130. package/skills/oracle-nft-mint-gas-war/SKILL.md +0 -63
  131. package/skills/oracle-polymarket/SKILL.md +0 -60
  132. package/skills/oracle-protocol-builder/SKILL.md +0 -59
  133. package/skills/oracle-protocol-security/SKILL.md +0 -60
  134. package/skills/oracle-public-product/SKILL.md +0 -44
  135. package/skills/oracle-receipts/SKILL.md +0 -52
  136. package/skills/oracle-rfq-tokenized-assets/SKILL.md +0 -69
  137. package/skills/oracle-smart-wallet-scanner/SKILL.md +0 -49
  138. package/skills/oracle-solana/SKILL.md +0 -65
  139. package/skills/oracle-solana-nft/SKILL.md +0 -54
  140. package/skills/oracle-token-research/SKILL.md +0 -67
  141. package/skins/oracle.yaml +0 -56
  142. package/src/action-receipts.mjs +0 -265
  143. package/src/action-semantics.mjs +0 -62
  144. package/src/address-book.mjs +0 -208
  145. package/src/agent-auth.mjs +0 -206
  146. package/src/approval-guard.mjs +0 -282
  147. package/src/attestation-secret.mjs +0 -88
  148. package/src/audit-log.mjs +0 -196
  149. package/src/auth/oauth.mjs +0 -672
  150. package/src/auto-slippage.mjs +0 -378
  151. package/src/capability-posture.mjs +0 -125
  152. package/src/chains.mjs +0 -62
  153. package/src/cli/chain-catalog.mjs +0 -215
  154. package/src/cli/chain-state.mjs +0 -74
  155. package/src/cli/commands/auth.mjs +0 -193
  156. package/src/cli/commands/bootstrap.mjs +0 -87
  157. package/src/cli/commands/chain.mjs +0 -143
  158. package/src/cli/commands/chat.mjs +0 -434
  159. package/src/cli/commands/credential.mjs +0 -9
  160. package/src/cli/commands/data-mcp.mjs +0 -18
  161. package/src/cli/commands/data.mjs +0 -75
  162. package/src/cli/commands/doctor.mjs +0 -136
  163. package/src/cli/commands/help.mjs +0 -7
  164. package/src/cli/commands/init.mjs +0 -27
  165. package/src/cli/commands/mcp.mjs +0 -142
  166. package/src/cli/commands/model.mjs +0 -99
  167. package/src/cli/commands/prepare.mjs +0 -12
  168. package/src/cli/commands/public.mjs +0 -20
  169. package/src/cli/commands/route.mjs +0 -12
  170. package/src/cli/commands/runner.mjs +0 -9
  171. package/src/cli/commands/scan.mjs +0 -12
  172. package/src/cli/commands/setup.mjs +0 -275
  173. package/src/cli/commands/sign.mjs +0 -21
  174. package/src/cli/commands/signer.mjs +0 -9
  175. package/src/cli/commands/upgrade.mjs +0 -12
  176. package/src/cli/commands/vault.mjs +0 -9
  177. package/src/cli/commands/version.mjs +0 -22
  178. package/src/cli/first-run.mjs +0 -23
  179. package/src/cli/kernel.mjs +0 -239
  180. package/src/cli/mcp-targets/chatgpt.mjs +0 -51
  181. package/src/cli/mcp-targets/claude-code.mjs +0 -39
  182. package/src/cli/mcp-targets/claude-desktop.mjs +0 -24
  183. package/src/cli/mcp-targets/codex.mjs +0 -41
  184. package/src/cli/mcp-targets/shared.mjs +0 -61
  185. package/src/cli/messaging-platforms.mjs +0 -209
  186. package/src/cli/model-config.mjs +0 -70
  187. package/src/cli/operator-dispatch.mjs +0 -258
  188. package/src/cli/oracle-harness.py +0 -415
  189. package/src/cli/paths.mjs +0 -83
  190. package/src/cli/runtime.mjs +0 -351
  191. package/src/cli/setup-state.mjs +0 -168
  192. package/src/cli/spawn-child.mjs +0 -43
  193. package/src/data/catalog.mjs +0 -585
  194. package/src/data/desk-data.mjs +0 -695
  195. package/src/data/http.mjs +0 -253
  196. package/src/data/provider-endpoint.mjs +0 -94
  197. package/src/data/providers/aerodrome.mjs +0 -245
  198. package/src/data/providers/balancer.mjs +0 -209
  199. package/src/data/providers/bitcoin-esplora.mjs +0 -216
  200. package/src/data/providers/bitcoin-meta.mjs +0 -378
  201. package/src/data/providers/blockscout.mjs +0 -14
  202. package/src/data/providers/bridges.mjs +0 -242
  203. package/src/data/providers/cowswap.mjs +0 -415
  204. package/src/data/providers/curve.mjs +0 -201
  205. package/src/data/providers/defillama.mjs +0 -88
  206. package/src/data/providers/dexscreener.mjs +0 -43
  207. package/src/data/providers/evm-rpc.mjs +0 -225
  208. package/src/data/providers/geckoterminal.mjs +0 -34
  209. package/src/data/providers/gmx.mjs +0 -496
  210. package/src/data/providers/hl-assets.mjs +0 -165
  211. package/src/data/providers/hl-info.mjs +0 -108
  212. package/src/data/providers/hl-markets.mjs +0 -210
  213. package/src/data/providers/hl-outcome.mjs +0 -61
  214. package/src/data/providers/hl-perps.mjs +0 -387
  215. package/src/data/providers/hl-staking.mjs +0 -353
  216. package/src/data/providers/hl-ws.mjs +0 -119
  217. package/src/data/providers/hyperevm-dex.mjs +0 -49
  218. package/src/data/providers/jupiter-venues.mjs +0 -119
  219. package/src/data/providers/jupiter.mjs +0 -315
  220. package/src/data/providers/lifi.mjs +0 -151
  221. package/src/data/providers/magiceden-sol.mjs +0 -406
  222. package/src/data/providers/morpho.mjs +0 -177
  223. package/src/data/providers/nft-gallery.mjs +0 -163
  224. package/src/data/providers/nft-portfolio.mjs +0 -494
  225. package/src/data/providers/odos.mjs +0 -156
  226. package/src/data/providers/oneinch.mjs +0 -174
  227. package/src/data/providers/opensea-multichain.mjs +0 -136
  228. package/src/data/providers/opensea-nft.mjs +0 -371
  229. package/src/data/providers/paraswap.mjs +0 -118
  230. package/src/data/providers/pendle.mjs +0 -188
  231. package/src/data/providers/poly-clob.mjs +0 -283
  232. package/src/data/providers/poly-public.mjs +0 -96
  233. package/src/data/providers/poly-ws.mjs +0 -103
  234. package/src/data/providers/portfolio-history.mjs +0 -394
  235. package/src/data/providers/portfolio.mjs +0 -594
  236. package/src/data/providers/rfq.mjs +0 -15
  237. package/src/data/providers/rh-agent.mjs +0 -59
  238. package/src/data/providers/satflow.mjs +0 -341
  239. package/src/data/providers/signed-material-guard.mjs +0 -108
  240. package/src/data/providers/solana-rpc.mjs +0 -197
  241. package/src/data/providers/uniswap-v3.mjs +0 -349
  242. package/src/data/providers/uniswap-v4.mjs +0 -414
  243. package/src/data/providers/zerox.mjs +0 -167
  244. package/src/data/public-api-scan.mjs +0 -61
  245. package/src/data/quote-placeholder.mjs +0 -31
  246. package/src/exact-integer.mjs +0 -72
  247. package/src/exec-policy.mjs +0 -455
  248. package/src/flags.mjs +0 -15
  249. package/src/fresh-window.mjs +0 -76
  250. package/src/gmx-attestation.mjs +0 -176
  251. package/src/index.mjs +0 -100
  252. package/src/nft-gas-war-guard.mjs +0 -139
  253. package/src/onboarding/agent-keys.mjs +0 -161
  254. package/src/onboarding/harness-configs.mjs +0 -102
  255. package/src/onboarding/index.mjs +0 -18
  256. package/src/onboarding/tiers.mjs +0 -139
  257. package/src/oracle-env.mjs +0 -47
  258. package/src/portfolio-risk.mjs +0 -170
  259. package/src/prepare-envelope.mjs +0 -204
  260. package/src/profile-upgrade.mjs +0 -277
  261. package/src/protocol-execution.mjs +0 -84
  262. package/src/protocol-templates/gate.mjs +0 -179
  263. package/src/protocol-templates/prepare-deploy.mjs +0 -81
  264. package/src/public-api/buzz-integration.mjs +0 -256
  265. package/src/public-api/connect-agent.mjs +0 -416
  266. package/src/public-api/grants.mjs +0 -142
  267. package/src/public-api/http.mjs +0 -389
  268. package/src/public-control/aa-adapter.mjs +0 -402
  269. package/src/public-control/build-registry.mjs +0 -227
  270. package/src/public-control/bundler-client.mjs +0 -357
  271. package/src/public-control/grant-indexer.mjs +0 -296
  272. package/src/public-control/policy-render.mjs +0 -69
  273. package/src/public-control/policy-schema.mjs +0 -318
  274. package/src/public-control/runtime-config.mjs +0 -275
  275. package/src/public-control/session-key-model.mjs +0 -374
  276. package/src/public-control/session-orchestrator.mjs +0 -412
  277. package/src/rfq/intent.mjs +0 -180
  278. package/src/rfq/sources.mjs +0 -181
  279. package/src/route-attestation.mjs +0 -132
  280. package/src/router/best-execution.mjs +0 -326
  281. package/src/router/index.mjs +0 -226
  282. package/src/router/prepare-bridge.mjs +0 -289
  283. package/src/router/prepare-route.mjs +0 -398
  284. package/src/router/proposal.mjs +0 -311
  285. package/src/router/risk-classifier.mjs +0 -119
  286. package/src/router/route-sources.mjs +0 -364
  287. package/src/scanner/chains.config.mjs +0 -430
  288. package/src/scanner/contract.mjs +0 -270
  289. package/src/scanner/evm-scanner.mjs +0 -394
  290. package/src/scanner/index.mjs +0 -9
  291. package/src/scanner/v2-venue.mjs +0 -335
  292. package/src/scanner/v3-venue.mjs +0 -290
  293. package/src/scopes.mjs +0 -44
  294. package/src/sell-simulation.mjs +0 -167
  295. package/src/signals/engine.mjs +0 -146
  296. package/src/signals/index.mjs +0 -1
  297. package/src/token-transfer-guard.mjs +0 -188
  298. package/src/tui/app.mjs +0 -438
  299. package/src/tui/backend.mjs +0 -145
  300. package/src/tui/format.mjs +0 -272
  301. package/src/tui/gateway-client.mjs +0 -177
  302. package/src/tui/input.mjs +0 -501
  303. package/src/tui/renderer.mjs +0 -443
  304. package/src/tui/standalone-client.mjs +0 -666
  305. package/src/tui/theme.mjs +0 -81
  306. package/src/vault-attestation.mjs +0 -146
  307. package/src/venues.mjs +0 -206
  308. package/src/watch-preferences.mjs +0 -85
@@ -1,353 +0,0 @@
1
- // Hyperliquid HyperCore staking lane: HYPE stake / unstake / delegate.
2
- //
3
- // Reads are public info endpoints. Writes are PREPARE-ONLY: this module returns
4
- // EIP-712 typed data plus the exact action payload for the user's own wallet to
5
- // sign. It never signs, never posts to /exchange, never holds a key.
6
- //
7
- // Flow the user actually performs:
8
- // spot -> staking balance : cDeposit
9
- // staking balance -> validator : tokenDelegate (isUndelegate=false)
10
- // validator -> staking balance : tokenDelegate (isUndelegate=true) [1 day validator lockup]
11
- // staking balance -> spot : cWithdraw [7 day unstaking queue]
12
-
13
- import { stampPrepared } from "../../prepare-envelope.mjs";
14
- import { httpJson } from "../http.mjs";
15
- import { hlInfo } from "./hl-info.mjs";
16
- export const HYPE_STAKING_DECIMALS = 8;
17
- export const HYPE_WEI_PER_TOKEN = 10n ** BigInt(HYPE_STAKING_DECIMALS);
18
- export const HL_SIGNATURE_CHAIN_ID = "0xa4b1"; // Arbitrum One, per Hyperliquid user-signed action spec
19
- export const HL_UNSTAKING_QUEUE_DAYS = 7;
20
- export const HL_VALIDATOR_LOCKUP_DAYS = 1;
21
- // The signed action encodes wei as uint64.
22
- export const MAX_UINT64 = 2n ** 64n - 1n;
23
-
24
- function exchangeUrl(opts = {}) {
25
- if (opts.exchangeUrl) return opts.exchangeUrl;
26
- if (process.env.HL_EXCHANGE_URL) return process.env.HL_EXCHANGE_URL;
27
- const testnet = opts.testnet || process.env.HL_TESTNET === "1";
28
- return testnet ? "https://api.hyperliquid-testnet.xyz/exchange" : "https://api.hyperliquid.xyz/exchange";
29
- }
30
-
31
- function hyperliquidChain(opts = {}) {
32
- return opts.testnet || process.env.HL_TESTNET === "1" ? "Testnet" : "Mainnet";
33
- }
34
-
35
- function evmAddress(value, label) {
36
- const addr = String(value || "").trim();
37
- if (!/^0x[0-9a-fA-F]{40}$/.test(addr)) throw new Error(`hl-staking: ${label} must be a 0x EVM address`);
38
- return addr.toLowerCase();
39
- }
40
-
41
- /** HYPE amount (decimal string or number) -> integer wei string at 8 decimals. */
42
- export function hypeToWei(amount, label = "amount") {
43
- const text = String(amount ?? "").trim();
44
- if (!/^\d+(\.\d+)?$/.test(text)) throw new Error(`hl-staking: ${label} must be a positive decimal HYPE amount`);
45
- const [whole, frac = ""] = text.split(".");
46
- if (frac.length > HYPE_STAKING_DECIMALS) {
47
- throw new Error(`hl-staking: ${label} has more than ${HYPE_STAKING_DECIMALS} decimals`);
48
- }
49
- const wei = BigInt(whole) * HYPE_WEI_PER_TOKEN + BigInt((frac + "0".repeat(HYPE_STAKING_DECIMALS)).slice(0, HYPE_STAKING_DECIMALS) || "0");
50
- if (wei <= 0n) throw new Error(`hl-staking: ${label} must be greater than zero`);
51
- if (wei > MAX_UINT64) throw new Error(`hl-staking: ${label} exceeds the uint64 range the signed action encodes`);
52
- return wei.toString();
53
- }
54
-
55
- /**
56
- * The EIP-712 field is uint64. JavaScript's Number loses integer precision
57
- * above 2^53, so passing Number(wei) can hand the wallet a DIFFERENT amount
58
- * than the one Oracle prepared and displayed. Keep wei exact: emit a JS number
59
- * only while it is provably lossless, otherwise emit the decimal string, which
60
- * every EIP-712 encoder accepts for uintN.
61
- */
62
- function exactWei(weiString) {
63
- const n = BigInt(weiString);
64
- return n <= BigInt(Number.MAX_SAFE_INTEGER) ? Number(n) : weiString;
65
- }
66
-
67
- export function weiToHype(wei) {
68
- const n = BigInt(String(wei || "0"));
69
- const whole = n / HYPE_WEI_PER_TOKEN;
70
- const frac = (n % HYPE_WEI_PER_TOKEN).toString().padStart(HYPE_STAKING_DECIMALS, "0").replace(/0+$/, "");
71
- return frac ? `${whole}.${frac}` : String(whole);
72
- }
73
-
74
- // ---------------------------------------------------------------- reads
75
-
76
- export async function hlStakingHealth(opts = {}) {
77
- try {
78
- const validators = await hlValidatorSummaries(opts);
79
- return {
80
- ok: validators.count > 0,
81
- provider: "hl-staking",
82
- chain: hyperliquidChain(opts),
83
- validators: validators.count,
84
- exec: false,
85
- };
86
- } catch (error) {
87
- return { ok: false, provider: "hl-staking", error: String(error?.message || error).slice(0, 160), exec: false };
88
- }
89
- }
90
-
91
- export async function hlValidatorSummaries(opts = {}) {
92
- const raw = await hlInfo({ type: "validatorSummaries" }, opts);
93
- const list = Array.isArray(raw) ? raw : [];
94
- const validators = list.map((v) => ({
95
- validator: v.validator ?? null,
96
- name: v.name ?? null,
97
- isActive: v.isActive ?? null,
98
- isJailed: v.isJailed ?? null,
99
- commission: v.commission ?? null,
100
- stake: v.stake ?? null,
101
- nRecentBlocks: v.nRecentBlocks ?? null,
102
- }));
103
- return { provider: "hl-staking", count: validators.length, validators, exec: false, raw };
104
- }
105
-
106
- export async function hlDelegatorSummary(args = {}, opts = {}) {
107
- const user = evmAddress(args.user || args.address, "user");
108
- const raw = await hlInfo({ type: "delegatorSummary", user }, opts);
109
- return {
110
- provider: "hl-staking",
111
- user,
112
- delegatedWei: raw?.delegated ?? null,
113
- undelegatedWei: raw?.undelegated ?? null,
114
- totalPendingWithdrawalWei: raw?.totalPendingWithdrawal ?? null,
115
- nPendingWithdrawals: raw?.nPendingWithdrawals ?? null,
116
- delegatedHype: raw?.delegated != null ? String(raw.delegated) : null,
117
- undelegatedHype: raw?.undelegated != null ? String(raw.undelegated) : null,
118
- exec: false,
119
- raw,
120
- };
121
- }
122
-
123
- export async function hlDelegations(args = {}, opts = {}) {
124
- const user = evmAddress(args.user || args.address, "user");
125
- const raw = await hlInfo({ type: "delegations", user }, opts);
126
- const list = Array.isArray(raw) ? raw : [];
127
- return {
128
- provider: "hl-staking",
129
- user,
130
- count: list.length,
131
- delegations: list.map((d) => ({
132
- validator: d.validator ?? null,
133
- amount: d.amount ?? null,
134
- lockedUntilTimestamp: d.lockedUntilTimestamp ?? null,
135
- })),
136
- exec: false,
137
- raw,
138
- };
139
- }
140
-
141
- export async function hlDelegatorRewards(args = {}, opts = {}) {
142
- const user = evmAddress(args.user || args.address, "user");
143
- const raw = await hlInfo({ type: "delegatorRewards", user }, opts);
144
- return { provider: "hl-staking", user, rewards: Array.isArray(raw) ? raw : [], exec: false };
145
- }
146
-
147
- export async function hlDelegatorHistory(args = {}, opts = {}) {
148
- const user = evmAddress(args.user || args.address, "user");
149
- const raw = await hlInfo({ type: "delegatorHistory", user }, opts);
150
- return { provider: "hl-staking", user, history: Array.isArray(raw) ? raw : [], exec: false };
151
- }
152
-
153
- // ------------------------------------------------------------- prepares
154
-
155
- function nonceNow(args = {}) {
156
- const n = args.nonce == null ? Date.now() : Number(args.nonce);
157
- if (!Number.isInteger(n) || n <= 0) throw new Error("hl-staking: nonce must be a positive integer ms timestamp");
158
- return n;
159
- }
160
-
161
- function signatureChainId(opts = {}) {
162
- return String(opts.signatureChainId || process.env.HL_SIGNATURE_CHAIN_ID || HL_SIGNATURE_CHAIN_ID);
163
- }
164
-
165
- function eip712Domain(opts = {}) {
166
- return {
167
- name: "HyperliquidSignTransaction",
168
- version: "1",
169
- chainId: Number(BigInt(signatureChainId(opts))),
170
- verifyingContract: "0x0000000000000000000000000000000000000000",
171
- };
172
- }
173
-
174
- function preparedAction({ kind, action, types, primaryType, message, opts, notes, caps }) {
175
- return stampPrepared({
176
- provider: "hl-staking",
177
- venue: "hypercore",
178
- chain: hyperliquidChain(opts),
179
- kind,
180
- prepareReady: true,
181
- executionReady: false,
182
- signingReady: false,
183
- broadcastReady: false,
184
- requiresUserSignature: true,
185
- signWith: "user wallet (EIP-712 typed data)",
186
- submitTo: exchangeUrl(opts),
187
- submitShape: { action, nonce: action.nonce, signature: "<user 65-byte signature>" },
188
- action,
189
- typedData: {
190
- domain: eip712Domain(opts),
191
- types,
192
- primaryType,
193
- message,
194
- },
195
- caps: caps || null,
196
- notes,
197
- exec: false,
198
- }, { provider: "hl-staking", kind });
199
- }
200
-
201
- /** spot HYPE -> staking balance. Instant. */
202
- export function hlPrepareStakeDeposit(args = {}, opts = {}) {
203
- const wei = hypeToWei(args.amountHype ?? args.amount, "amountHype");
204
- const maxHype = args.maxHype == null ? null : hypeToWei(args.maxHype, "maxHype");
205
- if (maxHype && BigInt(wei) > BigInt(maxHype)) {
206
- throw new Error(`hl-staking: amount ${weiToHype(wei)} HYPE exceeds maxHype cap ${weiToHype(maxHype)} HYPE`);
207
- }
208
- const nonce = nonceNow(args);
209
- const chain = hyperliquidChain(opts);
210
- const action = {
211
- type: "cDeposit",
212
- hyperliquidChain: chain,
213
- signatureChainId: signatureChainId(opts),
214
- wei: exactWei(wei),
215
- nonce,
216
- };
217
- return preparedAction({
218
- kind: "hype-stake-deposit",
219
- action,
220
- primaryType: "HyperliquidTransaction:CDeposit",
221
- types: {
222
- "HyperliquidTransaction:CDeposit": [
223
- { name: "hyperliquidChain", type: "string" },
224
- { name: "wei", type: "uint64" },
225
- { name: "nonce", type: "uint64" },
226
- ],
227
- },
228
- message: { hyperliquidChain: chain, wei: exactWei(wei), nonce },
229
- opts,
230
- caps: { amountHype: weiToHype(wei), maxHype: maxHype ? weiToHype(maxHype) : null },
231
- notes: [
232
- "Moves HYPE from your Hyperliquid spot balance into your staking balance.",
233
- "Staking balance still earns nothing until it is delegated to a validator.",
234
- "Oracle prepared this. Your wallet signs it. Nothing was submitted.",
235
- ],
236
- });
237
- }
238
-
239
- /** staking balance -> spot HYPE. Enters the 7 day unstaking queue. */
240
- export function hlPrepareStakeWithdraw(args = {}, opts = {}) {
241
- const wei = hypeToWei(args.amountHype ?? args.amount, "amountHype");
242
- const nonce = nonceNow(args);
243
- const chain = hyperliquidChain(opts);
244
- const action = {
245
- type: "cWithdraw",
246
- hyperliquidChain: chain,
247
- signatureChainId: signatureChainId(opts),
248
- wei: exactWei(wei),
249
- nonce,
250
- };
251
- return preparedAction({
252
- kind: "hype-stake-withdraw",
253
- action,
254
- primaryType: "HyperliquidTransaction:CWithdraw",
255
- types: {
256
- "HyperliquidTransaction:CWithdraw": [
257
- { name: "hyperliquidChain", type: "string" },
258
- { name: "wei", type: "uint64" },
259
- { name: "nonce", type: "uint64" },
260
- ],
261
- },
262
- message: { hyperliquidChain: chain, wei: exactWei(wei), nonce },
263
- opts,
264
- caps: { amountHype: weiToHype(wei) },
265
- notes: [
266
- `Starts the ${HL_UNSTAKING_QUEUE_DAYS} day unstaking queue back to spot. The HYPE is not liquid during the queue.`,
267
- "Undelegate from the validator first: only undelegated staking balance can be withdrawn.",
268
- "Oracle prepared this. Your wallet signs it. Nothing was submitted.",
269
- ],
270
- });
271
- }
272
-
273
- /** staking balance <-> validator. isUndelegate=false stakes, true unstakes. */
274
- export function hlPrepareDelegate(args = {}, opts = {}) {
275
- const validator = evmAddress(args.validator, "validator");
276
- const wei = hypeToWei(args.amountHype ?? args.amount, "amountHype");
277
- const isUndelegate = Boolean(args.isUndelegate ?? args.undelegate ?? false);
278
- const maxHype = args.maxHype == null ? null : hypeToWei(args.maxHype, "maxHype");
279
- if (!isUndelegate && maxHype && BigInt(wei) > BigInt(maxHype)) {
280
- throw new Error(`hl-staking: delegate amount ${weiToHype(wei)} HYPE exceeds maxHype cap ${weiToHype(maxHype)} HYPE`);
281
- }
282
- const nonce = nonceNow(args);
283
- const chain = hyperliquidChain(opts);
284
- const action = {
285
- type: "tokenDelegate",
286
- hyperliquidChain: chain,
287
- signatureChainId: signatureChainId(opts),
288
- validator,
289
- wei: exactWei(wei),
290
- isUndelegate,
291
- nonce,
292
- };
293
- return preparedAction({
294
- kind: isUndelegate ? "hype-undelegate" : "hype-delegate",
295
- action,
296
- primaryType: "HyperliquidTransaction:TokenDelegate",
297
- types: {
298
- "HyperliquidTransaction:TokenDelegate": [
299
- { name: "hyperliquidChain", type: "string" },
300
- { name: "validator", type: "address" },
301
- { name: "wei", type: "uint64" },
302
- { name: "isUndelegate", type: "bool" },
303
- { name: "nonce", type: "uint64" },
304
- ],
305
- },
306
- message: { hyperliquidChain: chain, validator, wei: exactWei(wei), isUndelegate, nonce },
307
- opts,
308
- caps: { amountHype: weiToHype(wei), maxHype: maxHype ? weiToHype(maxHype) : null, validator },
309
- notes: isUndelegate
310
- ? [
311
- "Returns stake from the validator to your staking balance.",
312
- `Delegations carry a ${HL_VALIDATOR_LOCKUP_DAYS} day validator lockup before they can be undelegated.`,
313
- "Oracle prepared this. Your wallet signs it. Nothing was submitted.",
314
- ]
315
- : [
316
- "Delegates staking balance to the chosen validator so it starts earning.",
317
- `Once delegated, the stake is locked with that validator for ${HL_VALIDATOR_LOCKUP_DAYS} day.`,
318
- "Check the validator's commission and jail status before delegating.",
319
- "Oracle prepared this. Your wallet signs it. Nothing was submitted.",
320
- ],
321
- });
322
- }
323
-
324
- /**
325
- * Read-only preflight: does the user actually hold enough in the right bucket
326
- * for the requested stake/unstake move? Never mutates anything.
327
- */
328
- export async function hlStakingPreflight(args = {}, opts = {}) {
329
- const user = evmAddress(args.user || args.address, "user");
330
- const summary = await hlDelegatorSummary({ user }, opts);
331
- const delegations = await hlDelegations({ user }, opts);
332
- return {
333
- provider: "hl-staking",
334
- user,
335
- stakingBalanceUndelegated: summary.undelegatedWei,
336
- stakingBalanceDelegated: summary.delegatedWei,
337
- pendingWithdrawals: summary.nPendingWithdrawals,
338
- delegations: delegations.delegations,
339
- unstakingQueueDays: HL_UNSTAKING_QUEUE_DAYS,
340
- validatorLockupDays: HL_VALIDATOR_LOCKUP_DAYS,
341
- exec: false,
342
- };
343
- }
344
-
345
- /** Never used by Oracle itself. Exposed so a self-hoster can see the exact submit shape. */
346
- export function hlStakingSubmitShape(opts = {}) {
347
- return {
348
- method: "POST",
349
- url: exchangeUrl(opts),
350
- body: { action: "<prepared action>", nonce: "<action.nonce>", signature: "<user signature r/s/v>" },
351
- note: "Oracle does not submit this. The signing wallet or its owner posts it. There is deliberately no submit function in this module.",
352
- };
353
- }
@@ -1,119 +0,0 @@
1
- // Short-lived Hyperliquid WebSocket snapshots (subscribe → first payload → close).
2
- // No long-running daemon; safe for desk HTTP handlers.
3
-
4
- const HL_WS = process.env.HL_WS_URL || "wss://api.hyperliquid.xyz/ws";
5
-
6
- /**
7
- * @param {object} subscription e.g. { type: 'allMids' } | { type: 'l2Book', coin: 'BTC' }
8
- * @param {object} [opts]
9
- * @param {number} [opts.timeoutMs]
10
- * @param {number} [opts.maxMessages] stop after N data messages (default 1)
11
- */
12
- export async function hlWsSnapshot(subscription, opts = {}) {
13
- if (!subscription?.type) throw new Error("hlWsSnapshot requires subscription.type");
14
- const timeoutMs = opts.timeoutMs ?? 8_000;
15
- const maxMessages = opts.maxMessages ?? 1;
16
- const WebSocketImpl = opts.WebSocket || globalThis.WebSocket;
17
- if (!WebSocketImpl) throw new Error("WebSocket not available in this runtime");
18
-
19
- const url = opts.url || HL_WS;
20
- const started = Date.now();
21
-
22
- return new Promise((resolve, reject) => {
23
- let settled = false;
24
- const messages = [];
25
- let dataCount = 0;
26
- const ws = new WebSocketImpl(url);
27
- const timer = setTimeout(() => {
28
- cleanup();
29
- if (!settled) {
30
- settled = true;
31
- if (messages.length) {
32
- resolve({ ok: true, partial: true, ms: Date.now() - started, messages });
33
- } else {
34
- reject(new Error(`hl ws timeout after ${timeoutMs}ms`));
35
- }
36
- }
37
- }, timeoutMs);
38
-
39
- function cleanup() {
40
- clearTimeout(timer);
41
- try {
42
- ws.close();
43
- } catch {
44
- /* ignore */
45
- }
46
- }
47
-
48
- ws.addEventListener("open", () => {
49
- ws.send(JSON.stringify({ method: "subscribe", subscription }));
50
- });
51
-
52
- ws.addEventListener("message", (ev) => {
53
- let data;
54
- try {
55
- data = JSON.parse(typeof ev.data === "string" ? ev.data : String(ev.data));
56
- } catch {
57
- data = { raw: String(ev.data).slice(0, 200) };
58
- }
59
- messages.push(data);
60
- // skip pure subscriptionResponse for counting "data"
61
- if (data.channel && data.channel !== "subscriptionResponse") {
62
- dataCount += 1;
63
- } else if (data.data && data.channel === "subscriptionResponse") {
64
- // ignore ack
65
- } else if (!data.channel) {
66
- dataCount += 1;
67
- }
68
- if (dataCount >= maxMessages) {
69
- cleanup();
70
- if (!settled) {
71
- settled = true;
72
- resolve({
73
- ok: true,
74
- ms: Date.now() - started,
75
- subscription,
76
- messages,
77
- last: messages[messages.length - 1],
78
- });
79
- }
80
- }
81
- });
82
-
83
- ws.addEventListener("error", () => {
84
- cleanup();
85
- if (!settled) {
86
- settled = true;
87
- reject(new Error("hl ws error"));
88
- }
89
- });
90
- });
91
- }
92
-
93
- export async function hlWsHealth(opts = {}) {
94
- try {
95
- const snap = await hlWsSnapshot({ type: "allMids" }, { ...opts, maxMessages: 1 });
96
- const last = snap.last || {};
97
- const mids = last.data?.mids || last.data || {};
98
- const n = typeof mids === "object" ? Object.keys(mids).length : 0;
99
- return { ok: true, ms: snap.ms, midCount: n, channel: last.channel || null };
100
- } catch (e) {
101
- return { ok: false, error: String(e.message || e).slice(0, 160) };
102
- }
103
- }
104
-
105
- export async function hlWsAllMids(opts = {}) {
106
- const snap = await hlWsSnapshot({ type: "allMids" }, opts);
107
- const last = snap.last || {};
108
- return {
109
- ms: snap.ms,
110
- mids: last.data?.mids || last.data || {},
111
- channel: last.channel,
112
- };
113
- }
114
-
115
- export async function hlWsL2Book(coin, opts = {}) {
116
- if (!coin) throw new Error("coin required");
117
- const snap = await hlWsSnapshot({ type: "l2Book", coin: String(coin) }, opts);
118
- return { ms: snap.ms, book: snap.last?.data || snap.last, channel: snap.last?.channel };
119
- }
@@ -1,49 +0,0 @@
1
- // HyperEVM (chain 999) discovery via DexScreener + optional RPC health.
2
- // No dedicated public Uniswap QuoterV2 on HyperEVM assumed.
3
-
4
- import { dexscreenerSearch, dexscreenerToken } from "./dexscreener.mjs";
5
- import { rpcHealth } from "./evm-rpc.mjs";
6
-
7
- export const HYPEREVM_CHAIN_ID = 999;
8
-
9
- export async function hyperevmHealth(opts = {}) {
10
- const out = { chainId: HYPEREVM_CHAIN_ID, rpc: null, dex: null };
11
- try {
12
- out.rpc = await rpcHealth(HYPEREVM_CHAIN_ID, opts);
13
- } catch (e) {
14
- out.rpc = { ok: false, error: String(e.message || e).slice(0, 120) };
15
- }
16
- try {
17
- const s = await dexscreenerSearch("HYPE", opts);
18
- const pairs = (s.pairs || []).filter((p) =>
19
- /hyper|hl|hyperevm/i.test(String(p.chainId || p.chain || ""))
20
- );
21
- out.dex = {
22
- ok: true,
23
- hypePairs: pairs.length || (s.pairs || []).length,
24
- sample: (pairs[0] || s.pairs?.[0])?.pairAddress || null,
25
- };
26
- } catch (e) {
27
- out.dex = { ok: false, error: String(e.message || e).slice(0, 120) };
28
- }
29
- return {
30
- ok: Boolean(out.rpc?.ok || out.dex?.ok),
31
- ...out,
32
- };
33
- }
34
-
35
- export async function hyperevmSearch(q = "HYPE", opts = {}) {
36
- const s = await dexscreenerSearch(q, opts);
37
- const pairs = s.pairs || [];
38
- const hl = pairs.filter((p) => /hyper|hl|hyperevm/i.test(String(p.chainId || "")));
39
- return {
40
- query: q,
41
- hyperPairs: hl,
42
- allPairs: pairs.slice(0, 20),
43
- count: hl.length || pairs.length,
44
- };
45
- }
46
-
47
- export async function hyperevmToken(address, opts = {}) {
48
- return dexscreenerToken(address, opts);
49
- }
@@ -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
- }