@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,378 +0,0 @@
1
- // Bitcoin metaprotocol reads (ordinals / runes).
2
- // Pluggable indexer base. No keys in repo — optional API keys via env.
3
- //
4
- // Free keyless tier: ordinals.com recursive ("/r/*") endpoints. Verified live
5
- // 2026-07: blockheight, blockhash, blockinfo, inscription metadata, children,
6
- // sat. These are the ord node's own recursive API and need no key.
7
- //
8
- // Indexer landscape as probed (do not re-litigate without re-probing):
9
- // ordinals.com /r/* 200, keyless -> wired below
10
- // Hiro ordinals/brc20 410 GONE, deprecated -> dead, do not use
11
- // Ordiscan 402 payment required
12
- // UniSat open-api 403 without Bearer
13
- // BestInSlot 301 (moved; needs key)
14
- // Magic Eden BTC 503 "no healthy upstream" -> dead
15
- // Satflow 403 without x-api-key -> marketplace, separate provider
16
- //
17
- // Known gap: ordinals.com has NO address-indexed endpoint (/r/address 404).
18
- // Address -> inscriptions/runes REQUIRES a keyed indexer. Keyless mode can
19
- // answer "what is this inscription" but not "what does this wallet hold".
20
-
21
- import { btcAddress } from "./bitcoin-esplora.mjs";
22
- import { resolveProviderEndpoint, credentialedHeaders } from "../provider-endpoint.mjs";
23
-
24
- export const ORDINALS_RECURSIVE_BASE = "https://ordinals.com";
25
-
26
- function metaBase(opts = {}) {
27
- return String(
28
- opts.baseUrl ||
29
- process.env.BTC_META_API_URL ||
30
- process.env.UNISAT_API_URL ||
31
- ""
32
- )
33
- .trim()
34
- .replace(/\/$/, "");
35
- }
36
-
37
- // This provider has NO fixed default endpoint: the operator points it at their
38
- // own UniSat / Best-in-Slot deployment. Trust is therefore decided by an
39
- // explicit host allowlist rather than a built-in default.
40
- const BTC_META_HOSTS = [
41
- "open-api.unisat.io",
42
- "open-api-testnet.unisat.io",
43
- "api.bestinslot.xyz",
44
- "api.hiro.so",
45
- ];
46
-
47
- function metaEndpoint(opts = {}) {
48
- const url = metaBase(opts);
49
- if (!url) return { baseUrl: "", trusted: false, host: null };
50
- return resolveProviderEndpoint({
51
- provider: "bitcoin-meta",
52
- defaultUrl: url,
53
- hosts: BTC_META_HOSTS,
54
- url,
55
- });
56
- }
57
-
58
- function headers(opts = {}) {
59
- const key =
60
- opts.apiKey ||
61
- process.env.UNISAT_API_KEY ||
62
- process.env.BESTINSLOT_API_KEY ||
63
- process.env.BTC_META_API_KEY ||
64
- "";
65
- // An operator-configured base is only credentialed when its host is one of
66
- // the known indexers; a redirected base gets the request without the key.
67
- let trusted = false;
68
- try {
69
- const url = metaBase(opts);
70
- if (url) {
71
- const host = new URL(url).host;
72
- const proto = new URL(url).protocol;
73
- const loopback = /^(127\.0\.0\.1|localhost|\[::1\])(:\d+)?$/i.test(host);
74
- trusted = BTC_META_HOSTS.includes(host) && (proto === "https:" || loopback);
75
- }
76
- } catch {
77
- trusted = false;
78
- }
79
- return credentialedHeaders(
80
- { accept: "application/json", "user-agent": "oracle-btc-meta/0.1" },
81
- { authorization: key ? `Bearer ${key}` : "", "x-api-key": key },
82
- trusted
83
- );
84
- }
85
-
86
- async function getJson(url, opts = {}) {
87
- const fetchImpl = opts.fetchImpl || fetch;
88
- const res = await fetchImpl(url, {
89
- method: "GET",
90
- headers: headers(opts),
91
- signal: AbortSignal.timeout(opts.timeoutMs ?? 12_000),
92
- });
93
- const text = await res.text();
94
- let body;
95
- try {
96
- body = JSON.parse(text);
97
- } catch {
98
- body = text;
99
- }
100
- if (!res.ok) {
101
- throw new Error(`bitcoin-meta GET ${url}: HTTP ${res.status} ${String(text).slice(0, 160)}`);
102
- }
103
- return body;
104
- }
105
-
106
- export async function btcMetaHealth(opts = {}) {
107
- const base = metaBase(opts);
108
- // Always can hit ordinals.com tip as chain liveness (not full meta)
109
- let tip = null;
110
- try {
111
- const fetchImpl = opts.fetchImpl || fetch;
112
- const r = await fetchImpl("https://ordinals.com/r/blockheight", {
113
- signal: AbortSignal.timeout(8000),
114
- });
115
- tip = Number(await r.text());
116
- } catch {
117
- tip = null;
118
- }
119
-
120
- if (!base) {
121
- return {
122
- ok: tip != null,
123
- provider: "bitcoin-meta",
124
- indexerConfigured: false,
125
- ordinalsComTip: tip,
126
- note: "Set BTC_META_API_URL and/or UNISAT_API_KEY / BESTINSLOT_API_KEY for balances. Marketplace = Satflow (SATFLOW_API_KEY). Magic Eden BTC is dead.",
127
- capabilities: {
128
- tip: tip != null,
129
- runeBalances: false,
130
- inscriptions: false,
131
- marketplace: false,
132
- },
133
- };
134
- }
135
-
136
- // Probe common paths; tolerate 404
137
- let probe = { ok: false, path: null, status: null };
138
- for (const path of ["/v1/indexer/brc20/best-height", "/v1/health", "/health", "/"]) {
139
- try {
140
- const fetchImpl = opts.fetchImpl || fetch;
141
- const res = await fetchImpl(`${base}${path}`, {
142
- headers: headers(opts),
143
- signal: AbortSignal.timeout(8000),
144
- });
145
- probe = { ok: res.status > 0 && res.status < 500, path, status: res.status };
146
- if (res.ok) break;
147
- } catch {
148
- /* try next */
149
- }
150
- }
151
-
152
- return {
153
- ok: probe.ok || tip != null,
154
- provider: "bitcoin-meta",
155
- indexerConfigured: true,
156
- baseUrl: base,
157
- probe,
158
- ordinalsComTip: tip,
159
- apiKeyPresent: Boolean(
160
- process.env.UNISAT_API_KEY ||
161
- process.env.BESTINSLOT_API_KEY ||
162
- process.env.BTC_META_API_KEY
163
- ),
164
- capabilities: {
165
- tip: tip != null,
166
- runeBalances: true,
167
- inscriptions: true,
168
- marketplace: Boolean(process.env.SATFLOW_API_KEY),
169
- },
170
- };
171
- }
172
-
173
- /**
174
- * Rune balances for an address. Requires configured indexer.
175
- * Normalizes heterogeneous API shapes into a common list.
176
- */
177
- export async function btcRuneBalances(args = {}, opts = {}) {
178
- const address = btcAddress(args.address || args.addr, "address");
179
- const base = metaBase(opts);
180
- if (!base) {
181
- return {
182
- provider: "bitcoin-meta",
183
- address,
184
- ok: false,
185
- balances: [],
186
- error: "no indexer configured (set BTC_META_API_URL or vendor API key env)",
187
- };
188
- }
189
-
190
- // Try UniSat-shaped path first, then generic
191
- const candidates = [
192
- `${base}/v1/indexer/address/${address}/runes/balance-list?start=0&limit=100`,
193
- `${base}/v1/runes/address/${address}`,
194
- `${base}/runes/balance/${address}`,
195
- `${base}/address/${address}/runes`,
196
- ];
197
-
198
- let lastErr = null;
199
- for (const url of candidates) {
200
- try {
201
- const body = await getJson(url, opts);
202
- const list = normalizeRuneBalances(body);
203
- return {
204
- provider: "bitcoin-meta",
205
- address,
206
- ok: true,
207
- count: list.length,
208
- balances: list,
209
- source: url,
210
- };
211
- } catch (e) {
212
- lastErr = e;
213
- }
214
- }
215
- return {
216
- provider: "bitcoin-meta",
217
- address,
218
- ok: false,
219
- balances: [],
220
- error: String(lastErr?.message || lastErr || "all indexer paths failed"),
221
- };
222
- }
223
-
224
- function normalizeRuneBalances(body) {
225
- const raw =
226
- body?.data?.detail ||
227
- body?.data?.list ||
228
- body?.data ||
229
- body?.balances ||
230
- body?.results ||
231
- body?.runes ||
232
- (Array.isArray(body) ? body : []);
233
- const arr = Array.isArray(raw) ? raw : [];
234
- return arr.map((r) => ({
235
- rune: r.rune || r.runeid || r.runeId || r.spacedRune || r.name || r.ticker || null,
236
- runeId: r.runeid || r.runeId || r.id || null,
237
- amount: String(r.amount ?? r.balance ?? r.total ?? r.qty ?? "0"),
238
- symbol: r.symbol || null,
239
- divisibility: r.divisibility ?? r.div ?? null,
240
- raw: r,
241
- }));
242
- }
243
-
244
- /**
245
- * Inscriptions controlled by an address.
246
- *
247
- * NOTE: requires a KEYED indexer. ordinals.com recursive has no address index
248
- * (verified: /r/address -> 404), so the free tier cannot answer this. We say so
249
- * explicitly rather than returning an empty list that reads like "you own
250
- * nothing" — a false negative here can get an inscription spent as fee change.
251
- */
252
- export async function btcInscriptions(args = {}, opts = {}) {
253
- const address = btcAddress(args.address || args.addr, "address");
254
- const base = metaBase(opts);
255
- if (!base) {
256
- return {
257
- provider: "bitcoin-meta",
258
- address,
259
- ok: false,
260
- inscriptions: [],
261
- error:
262
- "no indexer configured — address-indexed lookups need a keyed indexer " +
263
- "(BTC_META_API_URL + UNISAT_API_KEY / BESTINSLOT_API_KEY). " +
264
- "ordinals.com recursive is keyless but has no address index.",
265
- unknownNotEmpty: true,
266
- keylessAlternatives: ["btc_inscription_info (by inscription id)", "btc_meta_health"],
267
- };
268
- }
269
- const limit = Math.min(Number(args.limit || 50), 200);
270
- const candidates = [
271
- `${base}/v1/indexer/address/${address}/inscription-data?cursor=0&size=${limit}`,
272
- `${base}/v1/inscriptions/address/${address}?limit=${limit}`,
273
- `${base}/address/${address}/inscriptions?limit=${limit}`,
274
- ];
275
- let lastErr = null;
276
- for (const url of candidates) {
277
- try {
278
- const body = await getJson(url, opts);
279
- const list = normalizeInscriptions(body);
280
- return {
281
- provider: "bitcoin-meta",
282
- address,
283
- ok: true,
284
- count: list.length,
285
- inscriptions: list,
286
- source: url,
287
- };
288
- } catch (e) {
289
- lastErr = e;
290
- }
291
- }
292
- return {
293
- provider: "bitcoin-meta",
294
- address,
295
- ok: false,
296
- inscriptions: [],
297
- error: String(lastErr?.message || lastErr || "all indexer paths failed"),
298
- };
299
- }
300
-
301
- /**
302
- * Inscription metadata by inscription id — KEYLESS via ordinals.com recursive.
303
- * Verified live: returns content_type, content_length, height, sat, fee, etc.
304
- */
305
- export async function btcInscriptionInfo(args = {}, opts = {}) {
306
- const id = String(args.inscriptionId || args.id || "").trim();
307
- if (!/^[0-9a-f]{64}i\d+$/i.test(id)) {
308
- throw new Error("bitcoin-meta: inscriptionId must look like <64-hex-txid>i<index>");
309
- }
310
- const base = opts.ordinalsBase || ORDINALS_RECURSIVE_BASE;
311
- const info = await getJson(`${base}/r/inscription/${id}`, opts);
312
- return {
313
- provider: "bitcoin-meta",
314
- source: "ordinals.com/r",
315
- keyless: true,
316
- inscriptionId: id,
317
- info,
318
- };
319
- }
320
-
321
- /**
322
- * Child inscriptions (collection/parent-child) — KEYLESS via ordinals.com.
323
- */
324
- export async function btcInscriptionChildren(args = {}, opts = {}) {
325
- const id = String(args.inscriptionId || args.id || "").trim();
326
- if (!/^[0-9a-f]{64}i\d+$/i.test(id)) {
327
- throw new Error("bitcoin-meta: inscriptionId must look like <64-hex-txid>i<index>");
328
- }
329
- const base = opts.ordinalsBase || ORDINALS_RECURSIVE_BASE;
330
- const page = Number(args.page || 0);
331
- const body = await getJson(`${base}/r/children/${id}${page ? `/${page}` : ""}`, opts);
332
- return {
333
- provider: "bitcoin-meta",
334
- source: "ordinals.com/r",
335
- keyless: true,
336
- inscriptionId: id,
337
- page,
338
- children: Array.isArray(body?.ids) ? body.ids : [],
339
- more: Boolean(body?.more),
340
- };
341
- }
342
-
343
- /**
344
- * Block info from the ord node itself — KEYLESS. Useful to confirm the ord
345
- * indexer is at the same tip as Esplora before trusting any metaprotocol read.
346
- */
347
- export async function btcOrdBlockInfo(args = {}, opts = {}) {
348
- const base = opts.ordinalsBase || ORDINALS_RECURSIVE_BASE;
349
- const height = args.height ?? (await getJson(`${base}/r/blockheight`, opts));
350
- const info = await getJson(`${base}/r/blockinfo/${Number(height)}`, opts);
351
- return {
352
- provider: "bitcoin-meta",
353
- source: "ordinals.com/r",
354
- keyless: true,
355
- height: Number(height),
356
- info,
357
- };
358
- }
359
-
360
- function normalizeInscriptions(body) {
361
- const raw =
362
- body?.data?.inscription ||
363
- body?.data?.detail ||
364
- body?.data?.list ||
365
- body?.data ||
366
- body?.inscriptions ||
367
- body?.results ||
368
- (Array.isArray(body) ? body : []);
369
- const arr = Array.isArray(raw) ? raw : [];
370
- return arr.map((i) => ({
371
- id: i.inscriptionId || i.id || i.inscription_id || null,
372
- number: i.inscriptionNumber ?? i.number ?? null,
373
- sat: i.sat || i.satoshi || null,
374
- contentType: i.contentType || i.content_type || null,
375
- utxo: i.utxo || i.output || (i.txid != null ? `${i.txid}:${i.vout ?? i.n}` : null),
376
- raw: i,
377
- }));
378
- }
@@ -1,14 +0,0 @@
1
- // Blockscout REST API v2 — verified public explorer instances, no key.
2
- import { httpJson } from "../http.mjs";
3
- export const BLOCKSCOUT_CHAINS=Object.freeze({
4
- 1:"https://eth.blockscout.com",
5
- 10:"https://optimism.blockscout.com",
6
- 137:"https://polygon.blockscout.com",
7
- 42161:"https://arbitrum.blockscout.com",
8
- 8453:"https://base.blockscout.com",
9
- });
10
- function base(chainId,o={}) { const id=Number(chainId); const u=o.baseUrl || BLOCKSCOUT_CHAINS[id]; if(!u) throw new Error(`Blockscout not configured for chainId ${id}`); return u.replace(/\/$/,""); }
11
- export async function blockscoutStats(args={},opts={}) { return httpJson(`${base(args.chainId||1,opts)}/api/v2/stats`,{fetchImpl:opts.fetchImpl,timeoutMs:opts.timeoutMs}); }
12
- export async function blockscoutAddress(args={},opts={}) { if(!args.address)throw new Error("address required"); return httpJson(`${base(args.chainId||1,opts)}/api/v2/addresses/${encodeURIComponent(args.address)}`,{fetchImpl:opts.fetchImpl,timeoutMs:opts.timeoutMs}); }
13
- export async function blockscoutToken(args={},opts={}) { if(!args.address && !args.tokenAddress)throw new Error("token address required"); return httpJson(`${base(args.chainId||1,opts)}/api/v2/tokens/${encodeURIComponent(args.address||args.tokenAddress)}`,{fetchImpl:opts.fetchImpl,timeoutMs:opts.timeoutMs}); }
14
- export async function blockscoutHealth(opts={}) { const data=await blockscoutStats({chainId:8453},opts); return {ok:data?.total_blocks!=null || data?.total_transactions!=null,chainId:8453}; }
@@ -1,242 +0,0 @@
1
- // Bridge quote pack — Across, Hop, Relay (public, no key).
2
-
3
- import { httpJson } from "../http.mjs";
4
- import { attachAutoSlippage, bindAutoSlippageGuardToCall, resolveAutoSlippage } from "../../auto-slippage.mjs";
5
- import { QUOTE_PLACEHOLDER_ADDRESS, quoteAddress } from "../quote-placeholder.mjs";
6
- import { stampPrepared } from "../../prepare-envelope.mjs";
7
-
8
- export const ACROSS_API = "https://across.to/api";
9
- export const HOP_API = "https://api.hop.exchange/v1";
10
- export const RELAY_API = "https://api.relay.link";
11
-
12
- const HOP_CHAIN_IDS = {
13
- ethereum: 1,
14
- optimism: 10,
15
- bsc: 56,
16
- polygon: 137,
17
- arbitrum: 42161,
18
- avalanche: 43114,
19
- base: 8453,
20
- };
21
-
22
- // ── Across ──────────────────────────────────────────────────────────────────
23
-
24
- export async function acrossHealth(opts = {}) {
25
- try {
26
- const q = await acrossSuggestedFees(
27
- {
28
- token: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
29
- destinationToken: "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1",
30
- originChainId: 1,
31
- destinationChainId: 42161,
32
- amount: "1000000000000000",
33
- },
34
- opts
35
- );
36
- return { ok: true, estimatedFillTimeSec: q.estimatedFillTimeSec };
37
- } catch (e) {
38
- return { ok: false, error: String(e.message || e).slice(0, 160) };
39
- }
40
- }
41
-
42
- export async function acrossSuggestedFees(q = {}, opts = {}) {
43
- const {
44
- token,
45
- destinationToken = token,
46
- originChainId,
47
- destinationChainId,
48
- amount,
49
- } = q;
50
- if (!token || originChainId == null || destinationChainId == null || !amount) {
51
- throw new Error("acrossSuggestedFees requires token, originChainId, destinationChainId, amount");
52
- }
53
- const params = new URLSearchParams({
54
- token,
55
- destinationToken,
56
- originChainId: String(originChainId),
57
- destinationChainId: String(destinationChainId),
58
- amount: String(amount),
59
- });
60
- const base = (opts.baseUrl || process.env.ACROSS_API_URL || ACROSS_API).replace(/\/$/, "");
61
- return httpJson(`${base}/suggested-fees?${params}`, {
62
- fetchImpl: opts.fetchImpl,
63
- timeoutMs: opts.timeoutMs ?? 15_000,
64
- });
65
- }
66
-
67
- // ── Hop ─────────────────────────────────────────────────────────────────────
68
-
69
- export async function hopHealth(opts = {}) {
70
- try {
71
- const q = await hopQuote(
72
- {
73
- amount: "1000000000000000",
74
- token: "ETH",
75
- fromChain: "ethereum",
76
- toChain: "arbitrum",
77
- slippage: 0.5,
78
- },
79
- opts
80
- );
81
- return { ok: true, estimatedRecieved: q.estimatedRecieved || q.estimatedReceived };
82
- } catch (e) {
83
- return { ok: false, error: String(e.message || e).slice(0, 160) };
84
- }
85
- }
86
-
87
- export async function hopQuote(q = {}, opts = {}) {
88
- const {
89
- amount,
90
- token = "ETH",
91
- fromChain = "ethereum",
92
- toChain = "arbitrum",
93
- } = q;
94
- if (!amount) throw new Error("hopQuote requires amount");
95
- const legacyCap = q.slippage == null ? undefined : Math.round(Number(q.slippage) * 100);
96
- const selected = resolveAutoSlippage({
97
- liquidityUsd: q.liquidityUsd,
98
- priceChange5m: q.priceChange5m,
99
- crossChain: fromChain !== toChain,
100
- requestedCapBps: q.maxSlippageBps ?? q.slippageBps ?? legacyCap,
101
- });
102
- if (!selected.executable) {
103
- throw new Error(`hop: route requires ${selected.requiredBps} bps above cap ${selected.capBps}`);
104
- }
105
- const params = new URLSearchParams({
106
- amount: String(amount),
107
- token,
108
- fromChain,
109
- toChain,
110
- // Hop expresses slippage as percentage points: 0.5 = 50 bps.
111
- slippage: String(selected.selectedBps / 100),
112
- });
113
- const base = (opts.baseUrl || process.env.HOP_API_URL || HOP_API).replace(/\/$/, "");
114
- const result = await httpJson(`${base}/quote?${params}`, {
115
- fetchImpl: opts.fetchImpl,
116
- timeoutMs: opts.timeoutMs ?? 15_000,
117
- });
118
- const amountOut = result?.estimatedRecieved || result?.estimatedReceived;
119
- if (!amountOut) return { ...result, autoSlippagePolicy: selected };
120
- return attachAutoSlippage(result, {
121
- chainId: Number(q.originChainId || q.chainId || HOP_CHAIN_IDS[fromChain] || 0),
122
- venue: result?.tx?.to || "hop",
123
- amountOut,
124
- liquidityUsd: q.liquidityUsd,
125
- priceChange5m: q.priceChange5m,
126
- crossChain: fromChain !== toChain,
127
- requestedCapBps: q.maxSlippageBps ?? q.slippageBps ?? legacyCap,
128
- });
129
- }
130
-
131
- // ── Relay ───────────────────────────────────────────────────────────────────
132
-
133
- export async function relayHealth(opts = {}) {
134
- try {
135
- const q = await relayQuote(
136
- {
137
- user: QUOTE_PLACEHOLDER_ADDRESS,
138
- originChainId: 1,
139
- destinationChainId: 8453,
140
- originCurrency: "0x0000000000000000000000000000000000000000",
141
- destinationCurrency: "0x0000000000000000000000000000000000000000",
142
- amount: "1000000000000000",
143
- tradeType: "EXACT_INPUT",
144
- },
145
- opts
146
- );
147
- return { ok: true, hasSteps: Array.isArray(q.steps), stepCount: q.steps?.length || 0 };
148
- } catch (e) {
149
- return { ok: false, error: String(e.message || e).slice(0, 160) };
150
- }
151
- }
152
-
153
- export async function relayQuote(q = {}, opts = {}) {
154
- const {
155
- user = QUOTE_PLACEHOLDER_ADDRESS,
156
- originChainId,
157
- destinationChainId,
158
- originCurrency = "0x0000000000000000000000000000000000000000",
159
- destinationCurrency = "0x0000000000000000000000000000000000000000",
160
- amount,
161
- tradeType = "EXACT_INPUT",
162
- } = q;
163
- if (originChainId == null || destinationChainId == null || !amount) {
164
- throw new Error("relayQuote requires originChainId, destinationChainId, amount");
165
- }
166
- const selected = resolveAutoSlippage({
167
- liquidityUsd: q.liquidityUsd,
168
- priceChange5m: q.priceChange5m,
169
- crossChain: Number(originChainId) !== Number(destinationChainId),
170
- requestedCapBps: q.maxSlippageBps ?? q.slippageBps,
171
- });
172
- if (!selected.executable) {
173
- throw new Error(`relay: route requires ${selected.requiredBps} bps above cap ${selected.capBps}`);
174
- }
175
- const base = (opts.baseUrl || process.env.RELAY_API_URL || RELAY_API).replace(/\/$/, "");
176
- const result = await httpJson(`${base}/quote`, {
177
- method: "POST",
178
- body: {
179
- user,
180
- originChainId: Number(originChainId),
181
- destinationChainId: Number(destinationChainId),
182
- originCurrency,
183
- destinationCurrency,
184
- amount: String(amount),
185
- tradeType,
186
- // Relay expects an integer-string in basis points ("50" = 0.50%).
187
- slippageTolerance: String(selected.selectedBps),
188
- },
189
- fetchImpl: opts.fetchImpl,
190
- timeoutMs: opts.timeoutMs ?? 20_000,
191
- });
192
- const amountOut = result?.details?.currencyOut?.amount;
193
- if (!amountOut || !/^\d+$/.test(String(amountOut))) {
194
- return { ...result, autoSlippagePolicy: selected };
195
- }
196
- return attachAutoSlippage(result, {
197
- chainId: Number(originChainId),
198
- venue: result?.steps?.[0]?.items?.[0]?.data?.to || "relay",
199
- amountOut,
200
- liquidityUsd: q.liquidityUsd,
201
- priceChange5m: q.priceChange5m,
202
- crossChain: Number(originChainId) !== Number(destinationChainId),
203
- requestedCapBps: q.maxSlippageBps ?? q.slippageBps,
204
- });
205
- }
206
-
207
- export async function relayPrepare(q = {}, opts = {}) {
208
- const quote = await relayQuote(q, opts);
209
- const chainId = Number(q.originChainId);
210
- const items = (quote.steps || []).flatMap((step) =>
211
- (step.items || []).filter((item) => item?.data?.to && item?.data?.data).map((item) => ({ stepId: step.id, ...item.data }))
212
- );
213
- if (!items.length) throw new Error("relay: quote returned no executable transaction items");
214
- const venue = String(quote?.autoSlippage?.venue || "").toLowerCase();
215
- if (items.some((tx) => String(tx.to).toLowerCase() !== venue)) {
216
- throw new Error("relay: route includes a separate approval/transaction that is not yet safely bound");
217
- }
218
- const transactions = items.map((tx) => ({
219
- chainId,
220
- from: tx.from || q.user,
221
- to: tx.to,
222
- data: tx.data,
223
- value: tx.value ?? "0x0",
224
- ...(tx.gasLimit != null || tx.gas != null ? { gasLimit: tx.gasLimit ?? tx.gas } : {}),
225
- slippageGuard: bindAutoSlippageGuardToCall(quote.autoSlippage, { chainId, venue: tx.to, data: tx.data }),
226
- }));
227
- return stampPrepared({
228
- provider: "relay",
229
- calldataReady: true,
230
- // NOT executable authority. The bytes are assembled but nothing is signed:
231
- // the user's wallet is still the only thing that can authorize this. The
232
- // previous `executionReady: true` read as "cleared to execute" and trained
233
- // agents to treat a quote as permission.
234
- requiresUserSignature: true,
235
- signingReady: false,
236
- broadcastReady: false,
237
- chainId,
238
- quote,
239
- autoSlippage: quote.autoSlippage,
240
- transactions,
241
- }, { provider: "relay", kind: "relay-tx" });
242
- }