@oracle-agent/oracle 0.35.49 → 0.35.50

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 (81) hide show
  1. package/README.md +3 -2
  2. package/artifacts/specialist-packs/oracle-full-crypto.json +11 -0
  3. package/dist/agent-sessions.mjs +19 -19
  4. package/dist/artifacts/token-dashboard.mjs +1 -1
  5. package/dist/assets/profiles/near-agent/SOUL.md +46 -0
  6. package/dist/assets/profiles/near-agent/profile.json +30 -0
  7. package/dist/assets/profiles/oracle/SOUL.md +1 -0
  8. package/dist/assets/skills/oracle-desk-product/SKILL.md +1 -1
  9. package/dist/assets/skills/oracle-near/SKILL.md +66 -0
  10. package/dist/automation-plan.mjs +1 -1
  11. package/dist/bin/desk-server.mjs +33 -33
  12. package/dist/bin/oracle-data-mcp.mjs +16 -16
  13. package/dist/bin/oracle-gateway.mjs +3 -3
  14. package/dist/bin/oracle-launch-radar-shadow.mjs +3 -3
  15. package/dist/bin/oracle-mev-arb-shadow.mjs +4 -4
  16. package/dist/bin/oracle-mev-shadow.mjs +4 -4
  17. package/dist/bin/oracle-public-server.mjs +5 -5
  18. package/dist/bin/oracle-route.mjs +27 -27
  19. package/dist/bin/oracle-scan.mjs +3 -3
  20. package/dist/bin/oracle-telegram-mcp.mjs +1 -1
  21. package/dist/chains.mjs +1 -1
  22. package/dist/cli/commands/account.mjs +22 -22
  23. package/dist/cli/commands/agent-session.mjs +23 -23
  24. package/dist/cli/commands/auth.mjs +16 -15
  25. package/dist/cli/commands/chain.mjs +5 -5
  26. package/dist/cli/commands/chat.mjs +310 -228
  27. package/dist/cli/commands/data.mjs +37 -37
  28. package/dist/cli/commands/doctor.mjs +5 -5
  29. package/dist/cli/commands/eval.mjs +249 -167
  30. package/dist/cli/commands/farm.mjs +1 -1
  31. package/dist/cli/commands/follow.mjs +4 -4
  32. package/dist/cli/commands/harness.mjs +6 -6
  33. package/dist/cli/commands/mint.mjs +11 -11
  34. package/dist/cli/commands/model.mjs +313 -231
  35. package/dist/cli/commands/project.mjs +8 -7
  36. package/dist/cli/commands/quickstart.mjs +2 -2
  37. package/dist/cli/commands/receipt.mjs +2 -2
  38. package/dist/cli/commands/resolve.mjs +4 -4
  39. package/dist/cli/commands/session-vault.mjs +4 -4
  40. package/dist/cli/commands/setup.mjs +53 -52
  41. package/dist/cli/commands/snipe.mjs +13 -13
  42. package/dist/cli/commands/strategy.mjs +5 -5
  43. package/dist/cli/commands/swap.mjs +11 -11
  44. package/dist/cli/commands/telegram.mjs +7 -7
  45. package/dist/cli/commands/venues.mjs +1 -1
  46. package/dist/cli/project-access.mjs +4 -3
  47. package/dist/data/desk-data.mjs +31 -31
  48. package/dist/data/holder-table.mjs +2 -2
  49. package/dist/data/market-tape.mjs +1 -1
  50. package/dist/data/names.mjs +3 -3
  51. package/dist/data/providers/farming.mjs +2 -2
  52. package/dist/data/providers/lp-destination-discovery.mjs +4 -4
  53. package/dist/index.mjs +49 -49
  54. package/dist/launch-radar/index.mjs +5 -5
  55. package/dist/lp/index.mjs +4 -4
  56. package/dist/nft/universal-mint-router.mjs +4 -4
  57. package/dist/notifications/index.mjs +1 -1
  58. package/dist/router/index.mjs +3 -3
  59. package/dist/router/prepare-bridge.mjs +2 -2
  60. package/dist/router/prepare-route.mjs +3 -3
  61. package/dist/scanner/index.mjs +3 -3
  62. package/dist/strategy/index.mjs +4 -4
  63. package/dist/task.mjs +1 -1
  64. package/dist/teams/index.mjs +6 -6
  65. package/dist/telegram/chart-card.mjs +5 -5
  66. package/dist/telegram/market-commands.mjs +1 -1
  67. package/dist/tui/standalone-client.mjs +179 -97
  68. package/package.json +2 -2
  69. package/public/oracle-splash/docs/browser-and-web/index.html +2 -2
  70. package/public/oracle-splash/docs/connectors/index.html +2 -2
  71. package/public/oracle-splash/docs/getting-started/index.html +2 -2
  72. package/public/oracle-splash/docs/index.html +3 -3
  73. package/public/oracle-splash/docs/reference/index.html +2 -2
  74. package/public/oracle-splash/docs/security/index.html +2 -2
  75. package/public/oracle-splash/docs/using-oracle/index.html +2 -2
  76. package/public/oracle-splash/download/index.html +3 -3
  77. package/public/oracle-splash/downloads/index.html +1 -1
  78. package/public/oracle-splash/eval/index.html +19 -19
  79. package/public/oracle-splash/eval/releases/oracle-0.35.49.json +852 -0
  80. package/public/oracle-splash/index.html +9 -9
  81. package/server.json +2 -2
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@oracle-agent/oracle",
3
- "version": "0.35.49",
3
+ "version": "0.35.50",
4
4
  "description": "Oracle: standalone multichain agent control plane with an optional encrypted, loopback-only self-hosted signer.",
5
5
  "license": "BUSL-1.1",
6
6
  "type": "module",
@@ -130,7 +130,7 @@
130
130
  "@noble/curves": "^2.2.0",
131
131
  "@noble/hashes": "^2.3.0",
132
132
  "@scure/base": "^2.2.0",
133
- "@scure/bip39": "^1.6.0",
133
+ "@scure/bip39": "^2.4.0",
134
134
  "@scure/btc-signer": "2.4.1",
135
135
  "@solana/addresses": "^7.1.0",
136
136
  "@solana/transaction-messages": "8.0.0",
@@ -1,8 +1,8 @@
1
1
  <!doctype html>
2
2
  <html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Browser and web tools | Oracle</title><meta name="description" content="Choose the narrowest web surface that can finish the job: search and fetch for public sources, isolated Browser Use for rendered interaction, Oracle Sidecar for an explicitly granted Chrome-profile tab, and xurl for the official X API."><meta name="theme-color" content="#0b1018"><meta name="robots" content="index,follow"><link rel="icon" href="../../favicon.svg" type="image/svg+xml"><link rel="stylesheet" href="../docs.css"></head>
3
3
  <body data-doc-page="browser-and-web"><a class="skip-link" href="#main-content">Skip to content</a><div class="grain" aria-hidden="true"></div>
4
- <header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.49</span></a><button class="docs-search-button" id="docs-search-button" type="button" aria-haspopup="dialog"><span class="search-icon" aria-hidden="true">⌕</span><span>Search documentation</span><kbd aria-hidden="true">⌘ K</kbd></button><div class="docs-top-actions"><a class="top-link product-link" href="/">Product</a><a class="top-link download-link" href="/download/">Download</a><button class="mobile-menu" id="docs-menu-button" type="button" aria-label="Open documentation menu" aria-expanded="false" aria-controls="docs-sidebar">☰</button></div></header>
5
- <div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link is-active" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.49. <a href="https://github.com/demi-hl/oracle/tree/main/packages/oracle" target="_blank" rel="noopener noreferrer">View the repository</a>.</div></aside><main class="docs-main" id="main-content" tabindex="-1"><article class="docs-article"><p class="docs-kicker">Integrations</p><h1>Browser and web tools</h1><p class="docs-lede">Choose the narrowest web surface that can finish the job: search and fetch for public sources, isolated Browser Use for rendered interaction, Oracle Sidecar for an explicitly granted Chrome-profile tab, and xurl for the official X API.</p><div class="docs-meta"><span class="meta-chip">Public web</span><span class="meta-chip">Per-tab grants</span><span class="meta-chip">xurl read-first</span></div>
4
+ <header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.50</span></a><button class="docs-search-button" id="docs-search-button" type="button" aria-haspopup="dialog"><span class="search-icon" aria-hidden="true">⌕</span><span>Search documentation</span><kbd aria-hidden="true">⌘ K</kbd></button><div class="docs-top-actions"><a class="top-link product-link" href="/">Product</a><a class="top-link download-link" href="/download/">Download</a><button class="mobile-menu" id="docs-menu-button" type="button" aria-label="Open documentation menu" aria-expanded="false" aria-controls="docs-sidebar">☰</button></div></header>
5
+ <div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link is-active" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.50. <a href="https://github.com/demi-hl/oracle/tree/main/packages/oracle" target="_blank" rel="noopener noreferrer">View the repository</a>.</div></aside><main class="docs-main" id="main-content" tabindex="-1"><article class="docs-article"><p class="docs-kicker">Integrations</p><h1>Browser and web tools</h1><p class="docs-lede">Choose the narrowest web surface that can finish the job: search and fetch for public sources, isolated Browser Use for rendered interaction, Oracle Sidecar for an explicitly granted Chrome-profile tab, and xurl for the official X API.</p><div class="docs-meta"><span class="meta-chip">Public web</span><span class="meta-chip">Per-tab grants</span><span class="meta-chip">xurl read-first</span></div>
6
6
  <section id="modes"><h2>Choose a web mode</h2><div class="docs-table-wrap"><table><thead><tr><th>Mode</th><th>Use it for</th><th>Boundary</th></tr></thead><tbody><tr><td>web_search + web_fetch</td><td>Discover and read public sources</td><td>No browser session</td></tr><tr><td>browser_exec</td><td>Rendered public pages and bounded interaction</td><td>Oracle-owned isolated profile</td></tr><tr><td>Oracle Sidecar</td><td>Context from a logged-in browser profile</td><td>Explicit grant for one tab and origin</td></tr><tr><td>xurl</td><td>X search, timelines, posts, and account actions</td><td>Official CLI, reads first, writes separately gated</td></tr></tbody></table></div></section>
7
7
  <section id="search-fetch"><h2>Search and fetch</h2><p><code>web_search</code> discovers candidate sources. <code>web_fetch</code> reads one exact public URL and returns bounded text. Both refuse private, loopback, metadata, and credential-bearing destinations.</p><p>Search queries use Exa's keyless, rate-limited public service by default. A custom <code>ORACLE_SEARCH_URL</code> JSON backend takes precedence; <code>ORACLE_SEARCH_KEY</code> is sent only to that custom backend. Set <code>ORACLE_SEARCH_PROVIDER=disabled</code> to disable search, or <code>ORACLE_SEARCH_PROVIDER=custom</code> to require your own URL. Failures remain explicit. No Python, system service, local broker or extra MCP configuration is required.</p>
8
8
  <div class="callout safe"><span class="callout-title">Research order</span><p>Search, open the primary source, corroborate material claims, and cite the URL. Treat snippets as leads rather than evidence.</p></div></section>
@@ -1,8 +1,8 @@
1
1
  <!doctype html>
2
2
  <html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>MCP connectors | Oracle</title><meta name="description" content="Use Oracle from the agent client you already run. Generated connector configs expose the read and prepare plane, not a wallet key or control bypass."><meta name="theme-color" content="#0b1018"><meta name="robots" content="index,follow"><link rel="icon" href="../../favicon.svg" type="image/svg+xml"><link rel="stylesheet" href="../docs.css"></head>
3
3
  <body data-doc-page="connectors"><a class="skip-link" href="#main-content">Skip to content</a><div class="grain" aria-hidden="true"></div>
4
- <header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.49</span></a><button class="docs-search-button" id="docs-search-button" type="button" aria-haspopup="dialog"><span class="search-icon" aria-hidden="true">⌕</span><span>Search documentation</span><kbd aria-hidden="true">⌘ K</kbd></button><div class="docs-top-actions"><a class="top-link product-link" href="/">Product</a><a class="top-link download-link" href="/download/">Download</a><button class="mobile-menu" id="docs-menu-button" type="button" aria-label="Open documentation menu" aria-expanded="false" aria-controls="docs-sidebar">☰</button></div></header>
5
- <div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link is-active" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.49. <a href="https://github.com/demi-hl/oracle/tree/main/packages/oracle" target="_blank" rel="noopener noreferrer">View the repository</a>.</div></aside><main class="docs-main" id="main-content" tabindex="-1"><article class="docs-article"><p class="docs-kicker">Integrations</p><h1>MCP connectors</h1><p class="docs-lede">Use Oracle from the agent client you already run. Generated connector configs expose the read and prepare plane, not a wallet key or control bypass.</p><div class="docs-meta"><span class="meta-chip">MCP stdio</span><span class="meta-chip">Registry listed</span><span class="meta-chip">Prepare only</span></div>
4
+ <header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.50</span></a><button class="docs-search-button" id="docs-search-button" type="button" aria-haspopup="dialog"><span class="search-icon" aria-hidden="true">⌕</span><span>Search documentation</span><kbd aria-hidden="true">⌘ K</kbd></button><div class="docs-top-actions"><a class="top-link product-link" href="/">Product</a><a class="top-link download-link" href="/download/">Download</a><button class="mobile-menu" id="docs-menu-button" type="button" aria-label="Open documentation menu" aria-expanded="false" aria-controls="docs-sidebar">☰</button></div></header>
5
+ <div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link is-active" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.50. <a href="https://github.com/demi-hl/oracle/tree/main/packages/oracle" target="_blank" rel="noopener noreferrer">View the repository</a>.</div></aside><main class="docs-main" id="main-content" tabindex="-1"><article class="docs-article"><p class="docs-kicker">Integrations</p><h1>MCP connectors</h1><p class="docs-lede">Use Oracle from the agent client you already run. Generated connector configs expose the read and prepare plane, not a wallet key or control bypass.</p><div class="docs-meta"><span class="meta-chip">MCP stdio</span><span class="meta-chip">Registry listed</span><span class="meta-chip">Prepare only</span></div>
6
6
  <section id="install"><h2>Install a connector</h2><p>Oracle can print or install MCP configuration for supported clients. Inspect the generated configuration before accepting it.</p>
7
7
  <div class="code-block"><div class="code-label">terminal</div><pre><code>oracle mcp print --target claude-code
8
8
  oracle mcp install claude-code
@@ -1,8 +1,8 @@
1
1
  <!doctype html>
2
2
  <html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Getting started | Oracle</title><meta name="description" content="From a clean machine to a verified Oracle chat in a few minutes. The default path needs a model login, not a wallet key."><meta name="theme-color" content="#0b1018"><meta name="robots" content="index,follow"><link rel="icon" href="../../favicon.svg" type="image/svg+xml"><link rel="stylesheet" href="../docs.css"></head>
3
3
  <body data-doc-page="getting-started"><a class="skip-link" href="#main-content">Skip to content</a><div class="grain" aria-hidden="true"></div>
4
- <header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.49</span></a><button class="docs-search-button" id="docs-search-button" type="button" aria-haspopup="dialog"><span class="search-icon" aria-hidden="true">⌕</span><span>Search documentation</span><kbd aria-hidden="true">⌘ K</kbd></button><div class="docs-top-actions"><a class="top-link product-link" href="/">Product</a><a class="top-link download-link" href="/download/">Download</a><button class="mobile-menu" id="docs-menu-button" type="button" aria-label="Open documentation menu" aria-expanded="false" aria-controls="docs-sidebar">☰</button></div></header>
5
- <div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link is-active" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.49. <a href="https://github.com/demi-hl/oracle/tree/main/packages/oracle" target="_blank" rel="noopener noreferrer">View the repository</a>.</div></aside><main class="docs-main" id="main-content" tabindex="-1"><article class="docs-article"><p class="docs-kicker">Start here</p><h1>Getting started</h1><p class="docs-lede">From a clean machine to a verified Oracle chat in a few minutes. The default path needs a model login, not a wallet key.</p><div class="docs-meta"><span class="meta-chip">Linux</span><span class="meta-chip">macOS</span><span class="meta-chip">Windows beta</span></div>
4
+ <header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.50</span></a><button class="docs-search-button" id="docs-search-button" type="button" aria-haspopup="dialog"><span class="search-icon" aria-hidden="true">⌕</span><span>Search documentation</span><kbd aria-hidden="true">⌘ K</kbd></button><div class="docs-top-actions"><a class="top-link product-link" href="/">Product</a><a class="top-link download-link" href="/download/">Download</a><button class="mobile-menu" id="docs-menu-button" type="button" aria-label="Open documentation menu" aria-expanded="false" aria-controls="docs-sidebar">☰</button></div></header>
5
+ <div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link is-active" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.50. <a href="https://github.com/demi-hl/oracle/tree/main/packages/oracle" target="_blank" rel="noopener noreferrer">View the repository</a>.</div></aside><main class="docs-main" id="main-content" tabindex="-1"><article class="docs-article"><p class="docs-kicker">Start here</p><h1>Getting started</h1><p class="docs-lede">From a clean machine to a verified Oracle chat in a few minutes. The default path needs a model login, not a wallet key.</p><div class="docs-meta"><span class="meta-chip">Linux</span><span class="meta-chip">macOS</span><span class="meta-chip">Windows beta</span></div>
6
6
  <section id="requirements"><h2>Requirements</h2><ul><li><strong>Node.js 20.19.0 or newer</strong></li><li>npm</li><li>A supported model OAuth login or API key</li><li>A user-controlled wallet only when you want to sign a prepared action</li></ul></section>
7
7
  <section id="install"><h2>Install Oracle</h2><div class="code-block"><div class="code-label">recommended</div><pre><code>curl -fsSL https://oracle.demi.la/install.sh | bash
8
8
  oracle --version</code></pre></div>
@@ -1,14 +1,14 @@
1
1
  <!doctype html>
2
2
  <html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Oracle documentation | Oracle</title><meta name="description" content="Install, configure, and operate Oracle as a self-custody multichain agent control plane. Start with reads and quotes, prepare exact artifacts, and keep authorization separate from model output."><meta name="theme-color" content="#0b1018"><meta name="robots" content="index,follow"><link rel="icon" href="../favicon.svg" type="image/svg+xml"><link rel="stylesheet" href="./docs.css"></head>
3
3
  <body data-doc-page="overview"><a class="skip-link" href="#main-content">Skip to content</a><div class="grain" aria-hidden="true"></div>
4
- <header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.49</span></a><button class="docs-search-button" id="docs-search-button" type="button" aria-haspopup="dialog"><span class="search-icon" aria-hidden="true">⌕</span><span>Search documentation</span><kbd aria-hidden="true">⌘ K</kbd></button><div class="docs-top-actions"><a class="top-link product-link" href="/">Product</a><a class="top-link download-link" href="/download/">Download</a><button class="mobile-menu" id="docs-menu-button" type="button" aria-label="Open documentation menu" aria-expanded="false" aria-controls="docs-sidebar">☰</button></div></header>
5
- <div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link is-active" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.49. <a href="https://github.com/demi-hl/oracle/tree/main/packages/oracle" target="_blank" rel="noopener noreferrer">View the repository</a>.</div></aside><main class="docs-main" id="main-content" tabindex="-1"><article class="docs-article"><p class="docs-kicker">Documentation</p><h1>Oracle documentation</h1><p class="docs-lede">Install, configure, and operate Oracle as a self-custody multichain agent control plane. Start with reads and quotes, prepare exact artifacts, and keep authorization separate from model output.</p><div class="docs-meta"><span class="meta-chip">Oracle 0.35.49</span><span class="meta-chip">Node 20.19+</span><span class="meta-chip">Public self-host</span></div>
4
+ <header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.50</span></a><button class="docs-search-button" id="docs-search-button" type="button" aria-haspopup="dialog"><span class="search-icon" aria-hidden="true">⌕</span><span>Search documentation</span><kbd aria-hidden="true">⌘ K</kbd></button><div class="docs-top-actions"><a class="top-link product-link" href="/">Product</a><a class="top-link download-link" href="/download/">Download</a><button class="mobile-menu" id="docs-menu-button" type="button" aria-label="Open documentation menu" aria-expanded="false" aria-controls="docs-sidebar">☰</button></div></header>
5
+ <div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link is-active" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.50. <a href="https://github.com/demi-hl/oracle/tree/main/packages/oracle" target="_blank" rel="noopener noreferrer">View the repository</a>.</div></aside><main class="docs-main" id="main-content" tabindex="-1"><article class="docs-article"><p class="docs-kicker">Documentation</p><h1>Oracle documentation</h1><p class="docs-lede">Install, configure, and operate Oracle as a self-custody multichain agent control plane. Start with reads and quotes, prepare exact artifacts, and keep authorization separate from model output.</p><div class="docs-meta"><span class="meta-chip">Oracle 0.35.50</span><span class="meta-chip">Node 20.19+</span><span class="meta-chip">Public self-host</span></div>
6
6
  <section id="install"><h2>Install</h2><p>Oracle runs on Linux, macOS, and Windows. The installer uses a user-local directory and does not require a global npm install.</p>
7
7
  <div class="code-block"><div class="code-label">terminal</div><pre><code>curl -fsSL https://oracle.demi.la/install.sh | bash
8
8
  oracle --version
9
9
  oracle setup model
10
10
  oracle</code></pre></div>
11
- <p>Oracle 0.35.49 requires <strong>Node.js 20.19.0 or newer</strong>. If you prefer npm, install <code>@oracle-agent/oracle</code> globally.</p>
11
+ <p>Oracle 0.35.50 requires <strong>Node.js 20.19.0 or newer</strong>. If you prefer npm, install <code>@oracle-agent/oracle</code> globally.</p>
12
12
  <div class="code-block"><div class="code-label">npm</div><pre><code>npm i -g @oracle-agent/oracle
13
13
  oracle --version</code></pre></div>
14
14
  <div class="callout safe"><span class="callout-title">Start keyless</span><p>Reads, research, quotes, simulations, and unsigned preparation do not require a wallet key. Never paste a seed phrase, private key, passphrase, or API credential into chat.</p></div></section>
@@ -1,8 +1,8 @@
1
1
  <!doctype html>
2
2
  <html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>CLI and API reference | Oracle</title><meta name="description" content="The common public commands, executables, import paths, environment settings, and capability tiers in Oracle's published package."><meta name="theme-color" content="#0b1018"><meta name="robots" content="index,follow"><link rel="icon" href="../../favicon.svg" type="image/svg+xml"><link rel="stylesheet" href="../docs.css"></head>
3
3
  <body data-doc-page="reference"><a class="skip-link" href="#main-content">Skip to content</a><div class="grain" aria-hidden="true"></div>
4
- <header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.49</span></a><button class="docs-search-button" id="docs-search-button" type="button" aria-haspopup="dialog"><span class="search-icon" aria-hidden="true">⌕</span><span>Search documentation</span><kbd aria-hidden="true">⌘ K</kbd></button><div class="docs-top-actions"><a class="top-link product-link" href="/">Product</a><a class="top-link download-link" href="/download/">Download</a><button class="mobile-menu" id="docs-menu-button" type="button" aria-label="Open documentation menu" aria-expanded="false" aria-controls="docs-sidebar">☰</button></div></header>
5
- <div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link is-active" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.49. <a href="https://github.com/demi-hl/oracle/tree/main/packages/oracle" target="_blank" rel="noopener noreferrer">View the repository</a>.</div></aside><main class="docs-main" id="main-content" tabindex="-1"><article class="docs-article"><p class="docs-kicker">Reference</p><h1>CLI and API reference</h1><p class="docs-lede">The common public commands, executables, import paths, environment settings, and capability tiers in Oracle's published package.</p><div class="docs-meta"><span class="meta-chip">Package 0.35.49</span><span class="meta-chip">21 executables</span><span class="meta-chip">56 exports</span></div>
4
+ <header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.50</span></a><button class="docs-search-button" id="docs-search-button" type="button" aria-haspopup="dialog"><span class="search-icon" aria-hidden="true">⌕</span><span>Search documentation</span><kbd aria-hidden="true">⌘ K</kbd></button><div class="docs-top-actions"><a class="top-link product-link" href="/">Product</a><a class="top-link download-link" href="/download/">Download</a><button class="mobile-menu" id="docs-menu-button" type="button" aria-label="Open documentation menu" aria-expanded="false" aria-controls="docs-sidebar">☰</button></div></header>
5
+ <div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link is-active" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.50. <a href="https://github.com/demi-hl/oracle/tree/main/packages/oracle" target="_blank" rel="noopener noreferrer">View the repository</a>.</div></aside><main class="docs-main" id="main-content" tabindex="-1"><article class="docs-article"><p class="docs-kicker">Reference</p><h1>CLI and API reference</h1><p class="docs-lede">The common public commands, executables, import paths, environment settings, and capability tiers in Oracle's published package.</p><div class="docs-meta"><span class="meta-chip">Package 0.35.50</span><span class="meta-chip">21 executables</span><span class="meta-chip">56 exports</span></div>
6
6
  <section id="cli"><h2>CLI commands</h2><div class="docs-table-wrap"><table><thead><tr><th>Command</th><th>Purpose</th></tr></thead><tbody><tr><td>oracle</td><td>Open native Oracle chat</td></tr><tr><td>oracle setup model</td><td>Configure model OAuth or API-key access</td></tr><tr><td>oracle chain list</td><td>List chain selections</td></tr><tr><td>oracle chain use &lt;name&gt;</td><td>Select the active chain</td></tr><tr><td>oracle doctor</td><td>Verify installation and local posture</td></tr><tr><td>oracle auth status</td><td>Show provider status without credentials</td></tr><tr><td>oracle mcp install &lt;target&gt;</td><td>Install a read and prepare connector</td></tr><tr><td>oracle data serve</td><td>Run the loopback data plane</td></tr><tr><td>oracle public serve --port 8799</td><td>Run the loopback public plane</td></tr><tr><td>oracle eval all --mode playwright</td><td>Run the deterministic evaluation aggregate</td></tr></tbody></table></div></section>
7
7
  <section id="executables"><h2>Installed executables</h2><div class="docs-table-wrap"><table><thead><tr><th>Executable</th><th>Purpose</th></tr></thead><tbody><tr><td>oracle</td><td>Main CLI and native chat</td></tr><tr><td>oracle-investigate</td><td>Bounded report-only wallet evidence</td></tr><tr><td>oracle-data</td><td>Local read-plane server</td></tr><tr><td>oracle-public</td><td>Loopback public-plane server</td></tr><tr><td>oracle-data-mcp</td><td>MCP stdio read plane</td></tr><tr><td>oracle-scan</td><td>Token, pool, risk, and exit scanner</td></tr><tr><td>oracle-route</td><td>Swap and bridge route comparison and preparation</td></tr><tr><td>oracle-equities</td><td>Cross-venue on-chain equities desk</td></tr><tr><td>oracle-gateway</td><td>Authenticated messaging transport</td></tr><tr><td>oracle-init</td><td>Dry-run or apply profile and attestation setup</td></tr></tbody></table></div><p>The package currently declares 21 executable bins. Specialized MEV and restoration tools are intentionally not presented as general user commands here. See the package manifest for the complete list.</p></section>
8
8
  <section id="library"><h2>Library imports</h2><div class="code-block"><div class="code-label">javascript</div><pre><code>import { data } from "@oracle-agent/oracle";
@@ -1,8 +1,8 @@
1
1
  <!doctype html>
2
2
  <html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Security and execution | Oracle</title><meta name="description" content="Assume the model can be wrong or adversarially steered. Oracle keeps proposal separate from authorization and verifies the boundaries in code."><meta name="theme-color" content="#0b1018"><meta name="robots" content="index,follow"><link rel="icon" href="../../favicon.svg" type="image/svg+xml"><link rel="stylesheet" href="../docs.css"></head>
3
3
  <body data-doc-page="security"><a class="skip-link" href="#main-content">Skip to content</a><div class="grain" aria-hidden="true"></div>
4
- <header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.49</span></a><button class="docs-search-button" id="docs-search-button" type="button" aria-haspopup="dialog"><span class="search-icon" aria-hidden="true">⌕</span><span>Search documentation</span><kbd aria-hidden="true">⌘ K</kbd></button><div class="docs-top-actions"><a class="top-link product-link" href="/">Product</a><a class="top-link download-link" href="/download/">Download</a><button class="mobile-menu" id="docs-menu-button" type="button" aria-label="Open documentation menu" aria-expanded="false" aria-controls="docs-sidebar">☰</button></div></header>
5
- <div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link is-active" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.49. <a href="https://github.com/demi-hl/oracle/tree/main/packages/oracle" target="_blank" rel="noopener noreferrer">View the repository</a>.</div></aside><main class="docs-main" id="main-content" tabindex="-1"><article class="docs-article"><p class="docs-kicker">Core concepts</p><h1>Security and execution</h1><p class="docs-lede">Assume the model can be wrong or adversarially steered. Oracle keeps proposal separate from authorization and verifies the boundaries in code.</p><div class="docs-meta"><span class="meta-chip">Disarmed by default</span><span class="meta-chip">Fail closed</span><span class="meta-chip">Exact grants</span></div>
4
+ <header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.50</span></a><button class="docs-search-button" id="docs-search-button" type="button" aria-haspopup="dialog"><span class="search-icon" aria-hidden="true">⌕</span><span>Search documentation</span><kbd aria-hidden="true">⌘ K</kbd></button><div class="docs-top-actions"><a class="top-link product-link" href="/">Product</a><a class="top-link download-link" href="/download/">Download</a><button class="mobile-menu" id="docs-menu-button" type="button" aria-label="Open documentation menu" aria-expanded="false" aria-controls="docs-sidebar">☰</button></div></header>
5
+ <div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link is-active" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.50. <a href="https://github.com/demi-hl/oracle/tree/main/packages/oracle" target="_blank" rel="noopener noreferrer">View the repository</a>.</div></aside><main class="docs-main" id="main-content" tabindex="-1"><article class="docs-article"><p class="docs-kicker">Core concepts</p><h1>Security and execution</h1><p class="docs-lede">Assume the model can be wrong or adversarially steered. Oracle keeps proposal separate from authorization and verifies the boundaries in code.</p><div class="docs-meta"><span class="meta-chip">Disarmed by default</span><span class="meta-chip">Fail closed</span><span class="meta-chip">Exact grants</span></div>
6
6
  <section id="planes"><h2>Three planes</h2><div class="plane-grid"><div class="plane"><b>Data</b><span>Chain state, prices, protocol health, reads, and quotes. No key custody.</span></div><div class="plane"><b>Policy</b><span>Destination allowlists, slippage, caps, attestations, and approval binding.</span></div><div class="plane exec"><b>Execution</b><span>User wallet or optional self-hosted local signer. Never model authority.</span></div></div><p>The public import boundary is checked by tests. Hosted and keyless Oracle prepares unsigned artifacts. Self-hosting does not automatically enable signing.</p></section>
7
7
  <section id="grants"><h2>Grants and confirmation</h2><p>A grant is authorization. A prompt is not. Live grants bind chain, surface, action, destination, value, expiry, and other action-specific limits. Empty allowlists refuse rather than widening access.</p><ul><li>One exact action cannot be silently reused for another destination or calldata</li><li>Policy is rechecked near sign and broadcast time</li><li>Slippage input is a maximum, not permission to widen automatically</li><li>Disarm and revoke remain dominant</li></ul></section>
8
8
  <section id="local-signer"><h2>Optional self-hosted local signer</h2><p>The optional self-hosted local signer uses an encrypted vault, sealed policy, loopback-only service, and one-use confirmation. It stays inert until the owner initializes it.</p>
@@ -1,8 +1,8 @@
1
1
  <!doctype html>
2
2
  <html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Using Oracle | Oracle</title><meta name="description" content="Oracle separates research, proposal, authorization, broadcast, and proof. That separation is the product, not extra ceremony."><meta name="theme-color" content="#0b1018"><meta name="robots" content="index,follow"><link rel="icon" href="../../favicon.svg" type="image/svg+xml"><link rel="stylesheet" href="../docs.css"></head>
3
3
  <body data-doc-page="using-oracle"><a class="skip-link" href="#main-content">Skip to content</a><div class="grain" aria-hidden="true"></div>
4
- <header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.49</span></a><button class="docs-search-button" id="docs-search-button" type="button" aria-haspopup="dialog"><span class="search-icon" aria-hidden="true">⌕</span><span>Search documentation</span><kbd aria-hidden="true">⌘ K</kbd></button><div class="docs-top-actions"><a class="top-link product-link" href="/">Product</a><a class="top-link download-link" href="/download/">Download</a><button class="mobile-menu" id="docs-menu-button" type="button" aria-label="Open documentation menu" aria-expanded="false" aria-controls="docs-sidebar">☰</button></div></header>
5
- <div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link is-active" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.49. <a href="https://github.com/demi-hl/oracle/tree/main/packages/oracle" target="_blank" rel="noopener noreferrer">View the repository</a>.</div></aside><main class="docs-main" id="main-content" tabindex="-1"><article class="docs-article"><p class="docs-kicker">User guide</p><h1>Using Oracle</h1><p class="docs-lede">Oracle separates research, proposal, authorization, broadcast, and proof. That separation is the product, not extra ceremony.</p><div class="docs-meta"><span class="meta-chip">Native chat</span><span class="meta-chip">Prepare first</span><span class="meta-chip">Receipt verified</span></div>
4
+ <header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.50</span></a><button class="docs-search-button" id="docs-search-button" type="button" aria-haspopup="dialog"><span class="search-icon" aria-hidden="true">⌕</span><span>Search documentation</span><kbd aria-hidden="true">⌘ K</kbd></button><div class="docs-top-actions"><a class="top-link product-link" href="/">Product</a><a class="top-link download-link" href="/download/">Download</a><button class="mobile-menu" id="docs-menu-button" type="button" aria-label="Open documentation menu" aria-expanded="false" aria-controls="docs-sidebar">☰</button></div></header>
5
+ <div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link is-active" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.50. <a href="https://github.com/demi-hl/oracle/tree/main/packages/oracle" target="_blank" rel="noopener noreferrer">View the repository</a>.</div></aside><main class="docs-main" id="main-content" tabindex="-1"><article class="docs-article"><p class="docs-kicker">User guide</p><h1>Using Oracle</h1><p class="docs-lede">Oracle separates research, proposal, authorization, broadcast, and proof. That separation is the product, not extra ceremony.</p><div class="docs-meta"><span class="meta-chip">Native chat</span><span class="meta-chip">Prepare first</span><span class="meta-chip">Receipt verified</span></div>
6
6
  <section id="chat"><h2>Native chat</h2><p>The bare <code>oracle</code> command starts Oracle's own agent loop. The selected model can change without changing the Oracle persona, sessions, or active chain.</p>
7
7
  <div class="code-block"><div class="code-label">chat commands</div><pre><code>/sessions list sessions
8
8
  /new research ARB create a session
@@ -1624,9 +1624,9 @@ footer{margin-top:clamp(64px,10vh,100px);border-top:1px solid var(--line);paddin
1624
1624
  <figcaption>Native desktop. Connect a provider, then chat.</figcaption>
1625
1625
  </figure>
1626
1626
  <div class="os-dl">
1627
- <a class="os-link" href="/downloads/artifacts/Oracle-0.4.22.AppImage">Linux AppImage</a>
1628
- <a class="os-link" href="/downloads/artifacts/Oracle-0.4.22-arm64.dmg">macOS DMG</a>
1629
- <a class="os-link" href="/downloads/artifacts/Oracle-Setup-0.4.22.exe">Windows Setup</a>
1627
+ <a class="os-link" href="/downloads/artifacts/Oracle-0.4.24.AppImage">Linux AppImage</a>
1628
+ <a class="os-link" href="/downloads/artifacts/Oracle-0.4.24-arm64.dmg">macOS DMG</a>
1629
+ <a class="os-link" href="/downloads/artifacts/Oracle-Setup-0.4.24.exe">Windows Setup</a>
1630
1630
  </div>
1631
1631
  </section>
1632
1632
  </main>
@@ -27,7 +27,7 @@ section{padding-top:72px;scroll-margin-top:90px}.sub{color:var(--muted);line-hei
27
27
  <aside class="policy"><h2>Locals Only means 0% Oracle fees</h2><p>A Locals Only NFT waives the <b>Oracle integrator fee</b>. It does not unlock the product, waive provider or network costs, or change the hosted/keyless custody boundary. Self-host execution uses the local signer.</p></aside>
28
28
  <section id="cli"><p class="eyebrow">Oracle CLI</p><h2>Install with curl</h2><p class="sub">One line. Linux and macOS. Requires Node 20.19+ (the script checks and tells you how to get it). Installs into <code>~/.local</code> — no sudo, no global npm.</p><div class="install"><div class="cmd"><code id="cmd">curl -fL https://oracle.demi.la/install.sh | bash</code><button class="copy" id="copy" type="button">Copy</button></div><div class="meta"><span>curl install</span><span>hosted keyless</span><span>hosted wallet signs</span><span>user prefix</span></div></div><p class="sub" style="margin-top:18px">npm still works if you prefer: <code>npm i -g @oracle-agent/oracle</code></p></section>
29
29
  <section id="windows"><p class="eyebrow">Oracle CLI · Windows</p><h2>Install with PowerShell</h2><p class="sub">Same shape as Hermes: one line. Installs the CLI (<code>npm i -g @oracle-agent/oracle</code>). Never asks for a key or seed.</p><div class="install"><div class="cmd"><code id="cmd-win">iex (irm https://oracle.demi.la/install.ps1)</code><button class="copy" id="copy-win" type="button">Copy</button></div><div class="meta"><span>irm | iex</span><span>CLI only</span><span>no keys ever</span></div></div></section>
30
- <section id="desktop"><p class="eyebrow">Desktop</p><h2>Linux, macOS, Windows</h2><p class="sub">Packaged <b>0.4.22</b>. Settings can Check for updates against this feed.</p><p class="sub">The Windows installer is unsigned and may trigger a SmartScreen warning.</p><div class="artifacts"><div class="artifact"><div><h3>Linux</h3><small>AppImage · x64</small></div><div class="build">Oracle-0.4.22.AppImage</div><div class="hash">sha256 20db8fc1782ed32cb5829d3202ce1bd1c8787febedafa3aff4548e9b4d8970fb</div><a class="dl-btn" href="/downloads/artifacts/Oracle-0.4.22.AppImage">Download</a></div><div class="artifact"><div><h3>macOS</h3><small>DMG · arm64</small></div><div class="build">Oracle-0.4.22-arm64.dmg</div><div class="hash">sha256 90e58db5ca2da0c3d880bd88b5991ef98c61dd71ae8a291ebc088406ccc22de3</div><a class="dl-btn" href="/downloads/artifacts/Oracle-0.4.22-arm64.dmg">Download</a></div><div class="artifact"><div><h3>Windows</h3><small>NSIS Setup · x64</small></div><div class="build">Oracle-Setup-0.4.22.exe</div><div class="hash">sha256 f2b13178644cc754286b4595560a020b2ccb2d45909a07b081e05ebb13269c45</div><a class="dl-btn" href="/downloads/artifacts/Oracle-Setup-0.4.22.exe">Download</a></div></div><p class="platform-note"><a class="checksum" href="/downloads/SHA256SUMS.txt">SHA256SUMS.txt</a></p></section>
30
+ <section id="desktop"><p class="eyebrow">Desktop</p><h2>Linux, macOS, Windows</h2><p class="sub">Packaged <b>0.4.24</b>. Settings can Check for updates against this feed.</p><p class="sub">The Windows installer is unsigned and may trigger a SmartScreen warning.</p><div class="artifacts"><div class="artifact"><div><h3>Linux</h3><small>AppImage · x64</small></div><div class="build">Oracle-0.4.24.AppImage</div><div class="hash">sha256 5720488d8512a8f14b792eaf80e98714ce705efa9404975e73aff8780ff44197</div><a class="dl-btn" href="/downloads/artifacts/Oracle-0.4.24.AppImage">Download</a></div><div class="artifact"><div><h3>macOS</h3><small>DMG · arm64</small></div><div class="build">Oracle-0.4.24-arm64.dmg</div><div class="hash">sha256 647ccbec816538591a3e32071699d04067658c18d8358a6fef8051851db25439</div><a class="dl-btn" href="/downloads/artifacts/Oracle-0.4.24-arm64.dmg">Download</a></div><div class="artifact"><div><h3>Windows</h3><small>NSIS Setup · x64</small></div><div class="build">Oracle-Setup-0.4.24.exe</div><div class="hash">sha256 1448659677a2d741fe5117e8199dc18572bc96f283e465b8f37b98279a5435db</div><a class="dl-btn" href="/downloads/artifacts/Oracle-Setup-0.4.24.exe">Download</a></div></div><p class="platform-note"><a class="checksum" href="/downloads/SHA256SUMS.txt">SHA256SUMS.txt</a></p></section>
31
31
  </main>
32
32
  <footer><div class="nav-inner"><span>oracle · locals only labs</span><span>public / self-custody / local signer</span></div></footer>
33
33
  <script>
@@ -68,54 +68,54 @@
68
68
  </div></div>
69
69
  <details class="pinned" id="pinned-release"><summary class="wrap"><span>Release evidence, separate from development runs</span><strong>Pinned release snapshot</strong></summary>
70
70
  <div class="wrap">
71
- <aside class="verdict" data-state="attention" aria-label="Snapshot verdict"><span class="verdict-label">Verdict</span><p class="verdict-value">PINNED RELEASE EVIDENCE · NOT CURRENT TREE</p><span class="nav-meta">8 reported suites · 9 required slices</span></aside>
72
- <aside class="warning" aria-labelledby="historical-title"><h2 id="historical-title">Historical snapshot</h2><p><strong>This is evidence for the report commit only.</strong> The exact report commit <code>6a9feb3a90b596b22744777143d6d909bc4d31df</code> does not match the current tree. Do not read this page as a claim about untested changes.</p></aside>
71
+ <aside class="verdict" data-state="attention" aria-label="Snapshot verdict"><span class="verdict-label">Verdict</span><p class="verdict-value">PINNED RELEASE EVIDENCE · NOT CURRENT TREE</p><span class="nav-meta">9 reported suites · 9 required slices</span></aside>
72
+ <aside class="warning" aria-labelledby="historical-title"><h2 id="historical-title">Historical snapshot</h2><p><strong>This is evidence for the report commit only.</strong> The exact report commit <code>b6c7f0716a8094ba94e2cde1e975d73177af5324</code> does not match the current tree. Do not read this page as a claim about untested changes.</p></aside>
73
73
  </div>
74
74
  <section aria-labelledby="suite-title"><div class="wrap"><div class="section-head"><span class="kicker">02 / Evidence map</span><div><h2 id="suite-title">Expected eval slices</h2><p>Every expected slice has a place. Absent, blocked, skipped, and unavailable results are neutral or adverse states—never green and never counted as zero.</p></div></div><div class="suite-grid">
75
75
  <article class="suite-card" data-slice="guards" data-state="unattested" aria-labelledby="suite-guards">
76
76
  <div class="suite-topline"><span class="slice-index">01</span><span class="state-pill">recorded pass · unattested</span></div>
77
77
  <h3 id="suite-guards">guards</h3>
78
- <ul><li>5 of 5 checks passed</li><li>0 failures</li><li>Duration: 617 ms</li></ul>
78
+ <ul><li>5 of 5 checks passed</li><li>0 failures</li><li>Duration: 1.12 s</li></ul>
79
79
  </article>
80
80
  <article class="suite-card" data-slice="fidelity" data-state="unattested" aria-labelledby="suite-fidelity">
81
81
  <div class="suite-topline"><span class="slice-index">02</span><span class="state-pill">recorded pass · unattested</span></div>
82
82
  <h3 id="suite-fidelity">fidelity</h3>
83
- <ul><li>summary: 3/3 ok, 0 prepare-fail, 0 structural-fail, 0 sim-fail, 3 simulated</li><li>Duration: 9.71 s</li></ul>
83
+ <ul><li>summary: 3/3 ok, 0 prepare-fail, 0 structural-fail, 0 sim-fail, 3 simulated</li><li>Duration: 9.08 s</li></ul>
84
84
  </article>
85
- <article class="suite-card" data-slice="golden-prepare" data-state="unavailable" aria-labelledby="suite-golden-prepare">
86
- <div class="suite-topline"><span class="slice-index">03</span><span class="state-pill">not in this snapshot</span></div>
85
+ <article class="suite-card" data-slice="golden-prepare" data-state="unattested" aria-labelledby="suite-golden-prepare">
86
+ <div class="suite-topline"><span class="slice-index">03</span><span class="state-pill">recorded pass · unattested</span></div>
87
87
  <h3 id="suite-golden-prepare">golden-prepare</h3>
88
- <ul><li>No result was recorded for this slice.</li></ul>
88
+ <ul><li>2/2 ok, 0 wrong-scaling, 0 no-usable-route</li><li>Duration: 357 ms</li></ul>
89
89
  </article>
90
90
  <article class="suite-card" data-slice="hybrid" data-state="unattested" aria-labelledby="suite-hybrid">
91
91
  <div class="suite-topline"><span class="slice-index">04</span><span class="state-pill">recorded pass · unattested</span></div>
92
92
  <h3 id="suite-hybrid">hybrid</h3>
93
- <ul><li>Duration: 6.05 s</li></ul>
93
+ <ul><li>Duration: 6.62 s</li></ul>
94
94
  </article>
95
95
  <article class="suite-card" data-slice="desk" data-state="unattested" aria-labelledby="suite-desk">
96
96
  <div class="suite-topline"><span class="slice-index">05</span><span class="state-pill">recorded pass · unattested</span></div>
97
97
  <h3 id="suite-desk">desk</h3>
98
- <ul><li>115 of 115 package tests passed</li><li>0 package-test failures</li><li>Duration: 530 ms</li></ul>
98
+ <ul><li>115 of 115 package tests passed</li><li>0 package-test failures</li><li>Duration: 1.01 s</li></ul>
99
99
  </article>
100
100
  <article class="suite-card" data-slice="agentic" data-state="unattested" aria-labelledby="suite-agentic">
101
101
  <div class="suite-topline"><span class="slice-index">06</span><span class="state-pill">recorded pass · unattested</span></div>
102
102
  <h3 id="suite-agentic">agentic</h3>
103
- <ul><li>46 of 46 package tests passed</li><li>0 package-test failures</li><li>Duration: 338 ms</li></ul>
103
+ <ul><li>46 of 46 package tests passed</li><li>0 package-test failures</li><li>Duration: 837 ms</li></ul>
104
104
  </article>
105
105
  <article class="suite-card" data-slice="adversarial" data-state="unattested" aria-labelledby="suite-adversarial">
106
106
  <div class="suite-topline"><span class="slice-index">07</span><span class="state-pill">recorded pass · unattested</span></div>
107
107
  <h3 id="suite-adversarial">adversarial</h3>
108
- <ul><li>160 of 160 package tests passed</li><li>0 package-test failures</li><li>7 named guard scenarios</li><li>Duration: 8.19 s</li></ul>
108
+ <ul><li>164 of 164 package tests passed</li><li>0 package-test failures</li><li>7 named guard scenarios</li><li>Duration: 9.12 s</li></ul>
109
109
  </article>
110
110
  <article class="suite-card" data-slice="contracts" data-state="unattested" aria-labelledby="suite-contracts">
111
111
  <div class="suite-topline"><span class="slice-index">08</span><span class="state-pill">recorded pass · unattested</span></div>
112
112
  <h3 id="suite-contracts">contracts</h3>
113
- <ul><li>9 of 9 checks passed</li><li>0 failures</li><li>Duration: 976 ms</li></ul>
113
+ <ul><li>9 of 9 checks passed</li><li>0 failures</li><li>Duration: 35.3 s</li></ul>
114
114
  </article>
115
115
  <article class="suite-card" data-slice="rlm" data-state="unattested" aria-labelledby="suite-rlm">
116
116
  <div class="suite-topline"><span class="slice-index">09</span><span class="state-pill">recorded pass · unattested</span></div>
117
117
  <h3 id="suite-rlm">rlm</h3>
118
- <ul><li>12 of 12 checks passed</li><li>0 failures</li><li>Duration: 3 ms</li></ul>
118
+ <ul><li>12 of 12 checks passed</li><li>0 failures</li><li>Duration: 330 ms</li></ul>
119
119
  </article>
120
120
  <article class="suite-card" data-slice="native" data-state="unavailable" aria-labelledby="suite-native">
121
121
  <div class="suite-topline"><span class="slice-index">10</span><span class="state-pill">not in this snapshot</span></div>
@@ -125,13 +125,13 @@
125
125
  </div></div></section>
126
126
  <section aria-labelledby="coverage-title"><div class="wrap"><div class="section-head"><span class="kicker">03 / Attack surface</span><div><h2 id="coverage-title">Adversarial coverage</h2><p>Classes explicitly named by the committed report. No inferred coverage and no synthetic score.</p></div></div><ul class="coverage"><li>exact-confirmation</li><li>artifact-mutation</li><li>replay-idempotency</li><li>receipt-finality</li><li>autonomous-mint-gates</li><li>exact-nft-contract</li><li>hyperliquid-position-drift</li></ul></div></section>
127
127
  <section aria-labelledby="provenance-title"><div class="wrap"><div class="section-head"><span class="kicker">04 / Provenance</span><div><h2 id="provenance-title">Pin the claim</h2><p>The timestamp, package, commit, and reproduction command define the boundary of this evidence.</p></div></div><dl class="provenance">
128
- <div class="datum"><dt>Exact report commit</dt><dd><a href="https://github.com/demi-hl/oracle/commit/6a9feb3a90b596b22744777143d6d909bc4d31df">6a9feb3a90b596b22744777143d6d909bc4d31df</a></dd></div>
129
- <div class="datum"><dt>Generated at</dt><dd><time datetime="2026-09-05T01:10:54.826Z">2026-09-05T01:10:54.826Z</time></dd></div>
130
- <div class="datum"><dt>Package version</dt><dd><a href="https://www.npmjs.com/package/@oracle-agent/oracle/v/0.35.41">@oracle-agent/oracle · 0.35.41</a></dd></div>
131
- <div class="datum"><dt>Eval SHA-256 · canonical JSON</dt><dd>5e5c03861006c8d1c783381adf9d0184b6e185b9982db1141e0275674b5169be</dd></div>
128
+ <div class="datum"><dt>Exact report commit</dt><dd><a href="https://github.com/demi-hl/oracle/commit/b6c7f0716a8094ba94e2cde1e975d73177af5324">b6c7f0716a8094ba94e2cde1e975d73177af5324</a></dd></div>
129
+ <div class="datum"><dt>Generated at</dt><dd><time datetime="2026-09-23T23:04:49.764Z">2026-09-23T23:04:49.764Z</time></dd></div>
130
+ <div class="datum"><dt>Package version</dt><dd><a href="https://www.npmjs.com/package/@oracle-agent/oracle/v/0.35.49">@oracle-agent/oracle · 0.35.49</a></dd></div>
131
+ <div class="datum"><dt>Eval SHA-256 · canonical JSON</dt><dd>33cf7b557403619994d4186c0ee0738ba8699814a492b3e941a8a8a69aaaf71a</dd></div>
132
132
  <div class="datum method"><dt>Evidence boundary</dt><dd>Digest integrity is not cryptographic attestation. The embedded eval payload matches this digest and the release-report schema; serialized producer claims do not independently prove execution or npm-to-source equivalence. This record concerns only the declared package version and exact source commit, never subsequent changes. For source reproduction, check out that commit; the version-pinned npm command is a separate package reproduction. Live read-only providers and the public-site probe can change between runs.</dd></div>
133
- <div class="datum method"><dt>Methodology and reproduction</dt><dd>Exact-commit evidence generated by the deterministic oracle eval all aggregate. Fidelity uses read-only chain calls and changes no chain state.<code class="reproduce">npx @oracle-agent/oracle@0.35.41 eval all --mode playwright --json</code></dd></div>
134
- <div class="datum method"><dt>Download records</dt><dd><a href="./releases/oracle-0.35.41.json">Full 0.35.41 release report</a> · <a href="./archive/oracle-0.35.40.json">Archived 0.35.40 report</a> · <a href="./archive/oracle-0.35.41-blocked-attempt.json">Prior blocked attempt</a>. The public records declare their local-path redaction and retain original stdout hashes. The first fresh run failed closed during Chromium process cleanup; the separately recorded retry passed.</dd></div>
133
+ <div class="datum method"><dt>Methodology and reproduction</dt><dd>Exact-commit evidence generated by the deterministic oracle eval all aggregate. Fidelity uses read-only chain calls and changes no chain state.<code class="reproduce">npx @oracle-agent/oracle@0.35.49 eval all --mode playwright --json</code></dd></div>
134
+ <div class="datum method"><dt>Download records</dt><dd><a href="./releases/oracle-0.35.49.json">Full 0.35.49 release report</a> · <a href="./releases/oracle-0.35.41.json">Previous 0.35.41 release report</a> · <a href="./archive/oracle-0.35.40.json">Archived 0.35.40 report</a> · <a href="./archive/oracle-0.35.41-blocked-attempt.json">Prior blocked attempt</a>. The public records declare their local-path redaction and retain original stdout hashes. The 0.35.49 record also replaces the home directory in the evaluator browser path with ~ and recomputes the config digest over that redacted value. For 0.35.41, the first fresh run failed closed during Chromium process cleanup; the separately recorded retry passed.</dd></div>
135
135
  </dl></div></section>
136
136
  </details>
137
137
  </main>