@oracle-agent/oracle 0.35.39 → 0.35.41
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.
- package/dist/agent-sessions.mjs +11 -11
- package/dist/assets/skills/oracle-desk-product/SKILL.md +1 -1
- package/dist/bin/desk-server.mjs +28 -28
- package/dist/bin/oracle-data-mcp.mjs +19 -19
- package/dist/bin/oracle-gateway.mjs +43 -43
- package/dist/bin/oracle-investigate.mjs +5 -5
- package/dist/bin/oracle-launch-radar-shadow.mjs +6 -6
- package/dist/bin/oracle-mev-arb-shadow.mjs +6 -6
- package/dist/bin/oracle-mev-shadow.mjs +6 -6
- package/dist/bin/oracle-public-server.mjs +5 -5
- package/dist/bin/oracle-route.mjs +18 -18
- package/dist/bin/oracle-scan.mjs +11 -11
- package/dist/cli/commands/agent-session.mjs +18 -18
- package/dist/cli/commands/airdrop.mjs +8 -8
- package/dist/cli/commands/chat.mjs +207 -207
- package/dist/cli/commands/doctor.mjs +9 -9
- package/dist/cli/commands/eval.mjs +147 -197
- package/dist/cli/commands/farm.mjs +17 -17
- package/dist/cli/commands/follow.mjs +17 -17
- package/dist/cli/commands/mint.mjs +10 -10
- package/dist/cli/commands/model.mjs +211 -211
- package/dist/cli/commands/quickstart.mjs +6 -6
- package/dist/cli/commands/receipt.mjs +12 -12
- package/dist/cli/commands/resolve.mjs +7 -7
- package/dist/cli/commands/sign.mjs +4 -4
- package/dist/cli/commands/signer.mjs +14 -14
- package/dist/cli/commands/snipe.mjs +9 -9
- package/dist/cli/commands/strategy.mjs +4 -4
- package/dist/cli/commands/swap.mjs +14 -14
- package/dist/cli/commands/venues.mjs +2 -2
- package/dist/data/desk-data.mjs +26 -26
- package/dist/data/names.mjs +3 -3
- package/dist/data/providers/farming.mjs +2 -2
- package/dist/data/providers/lp-destination-discovery.mjs +4 -4
- package/dist/index.mjs +44 -44
- package/dist/investigator/index.mjs +2 -2
- package/dist/launch-radar/index.mjs +5 -5
- package/dist/local-signer/anvil-attestation-worker.mjs +1 -1
- package/dist/local-signer/index.mjs +2 -2
- package/dist/local-signer/runtime.mjs +8 -8
- package/dist/nft/universal-mint-router.mjs +4 -4
- package/dist/notifications/index.mjs +7 -7
- package/dist/router/index.mjs +3 -3
- package/dist/router/prepare-bridge.mjs +2 -2
- package/dist/router/prepare-route.mjs +3 -3
- package/dist/scanner/index.mjs +4 -4
- package/dist/strategy/index.mjs +3 -3
- package/dist/teams/index.mjs +6 -6
- package/dist/tui/standalone-client.mjs +82 -82
- package/package.json +4 -4
- package/public/eval-report.json +3 -3
- package/public/oracle-splash/_variants/ice.html +2 -4
- package/public/oracle-splash/_variants/ivory.html +2 -4
- package/public/oracle-splash/assets/fonts/LICENSE-Cormorant-Garamond.txt +93 -0
- package/public/oracle-splash/assets/fonts/LICENSE-IBM-Plex-Mono.txt +93 -0
- package/public/oracle-splash/assets/fonts/LICENSE-Outfit.txt +93 -0
- package/public/oracle-splash/assets/fonts/LICENSE-UnifrakturCook.txt +94 -0
- package/public/oracle-splash/assets/fonts/font-provenance.json +426 -0
- package/public/oracle-splash/assets/fonts/oracle-font-00.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-01.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-02.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-03.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-04.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-05.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-06.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-07.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-08.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-09.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-10.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-11.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-12.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-13.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-14.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-15.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-16.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-17.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-18.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-19.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-20.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-21.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-22.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-23.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-24.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-25.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-26.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-font-27.woff2 +0 -0
- package/public/oracle-splash/assets/fonts/oracle-fonts.css +504 -0
- package/public/oracle-splash/assets/transport-probe-sw.js +2 -0
- package/public/oracle-splash/docs/browser-and-web/index.html +6 -6
- package/public/oracle-splash/docs/connectors/index.html +5 -5
- package/public/oracle-splash/docs/docs.css +4 -4
- package/public/oracle-splash/docs/docs.js +119 -7
- package/public/oracle-splash/docs/getting-started/index.html +5 -5
- package/public/oracle-splash/docs/index.html +6 -6
- package/public/oracle-splash/docs/reference/index.html +5 -5
- package/public/oracle-splash/docs/security/index.html +5 -5
- package/public/oracle-splash/docs/using-oracle/index.html +5 -5
- package/public/oracle-splash/download/index.html +8 -10
- package/public/oracle-splash/downloads/index.html +3 -5
- package/public/oracle-splash/eval/index.html +96 -0
- package/public/oracle-splash/index.html +16 -18
- package/public/oracle-splash/mesh-graph.svg +1 -1
- package/public/oracle-splash/pricing/index.html +6 -8
- package/public/oracle-splash/security/index.html +3 -5
- package/public/oracle-splash/what-it-does/index.html +4 -6
- package/public/oracle-splash/where-it-works/index.html +3 -5
- package/server.json +2 -2
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
@import url('
|
|
1
|
+
@import url('../assets/fonts/oracle-fonts.css');
|
|
2
2
|
:root{
|
|
3
3
|
--bg:#0b1018;--bg2:#0e1621;--panel:#111925;--panel2:#152031;
|
|
4
4
|
--ink:#f4f9fe;--cool:#c9daec;--muted:#91a9c1;--faint:#607a95;
|
|
@@ -6,16 +6,16 @@
|
|
|
6
6
|
--display:"Cormorant Garamond",Georgia,serif;--sans:"Outfit",system-ui,sans-serif;--mono:"IBM Plex Mono",ui-monospace,monospace;
|
|
7
7
|
--top:64px;--side:270px;--toc:210px;--content:760px;--ease:cubic-bezier(.16,1,.3,1)
|
|
8
8
|
}
|
|
9
|
-
*{box-sizing:border-box}html{scroll-behavior:smooth;scroll-padding-top:92px}body{margin:0;background:var(--bg);color:var(--ink);font-family:var(--sans);font-size:16px;line-height:1.68;-webkit-font-smoothing:antialiased}a{color:inherit;text-decoration:none}button,input{font:inherit}.grain{position:fixed;inset:0;pointer-events:none;z-index:80;opacity:.03;mix-blend-mode:soft-light;background-image:url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='180' height='180'><filter id='n'><feTurbulence type='fractalNoise' baseFrequency='.9' numOctaves='2'/></filter><rect width='100%25' height='100%25' filter='url(%23n)'/></svg>")}
|
|
9
|
+
*{box-sizing:border-box}html{scroll-behavior:smooth;scroll-padding-top:92px;max-width:100%;overflow-x:clip}body{margin:0;max-width:100%;overflow-x:clip;background:var(--bg);color:var(--ink);font-family:var(--sans);font-size:16px;line-height:1.68;-webkit-font-smoothing:antialiased}a{color:inherit;text-decoration:none}button,input{font:inherit}:focus-visible{outline:2px solid var(--blue2);outline-offset:3px}.skip-link{position:fixed;z-index:120;top:10px;left:10px;padding:10px 14px;border-radius:7px;background:var(--ink);color:var(--bg);font:600 12px/1 var(--mono);transform:translateY(-160%);transition:transform .2s var(--ease)}.skip-link:focus-visible{transform:translateY(0)}.grain{position:fixed;inset:0;pointer-events:none;z-index:80;opacity:.03;mix-blend-mode:soft-light;background-image:url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='180' height='180'><filter id='n'><feTurbulence type='fractalNoise' baseFrequency='.9' numOctaves='2'/></filter><rect width='100%25' height='100%25' filter='url(%23n)'/></svg>")}
|
|
10
10
|
.docs-topbar{height:var(--top);position:fixed;inset:0 0 auto;z-index:70;display:grid;grid-template-columns:var(--side) 1fr auto;align-items:center;border-bottom:1px solid var(--line);background:rgba(11,16,24,.9);backdrop-filter:blur(18px);padding:0 28px}.docs-brand{display:flex;align-items:center;gap:11px;font-family:var(--mono);font-weight:600;letter-spacing:.14em;text-transform:uppercase}.brand-orbit{width:25px;height:25px;border:1px solid var(--blue);border-radius:50%;position:relative;box-shadow:0 0 20px rgba(124,196,255,.18)}.brand-orbit:before,.brand-orbit:after{content:"";position:absolute;inset:5px;border:1px solid rgba(124,196,255,.7);border-radius:50%;transform:rotateX(62deg)}.brand-orbit:after{transform:rotateY(62deg);border-color:rgba(80,210,193,.7)}.docs-word{font-family:var(--display);font-size:22px;font-weight:500;letter-spacing:.02em;text-transform:none}.docs-version{font-family:var(--mono);font-size:9px;letter-spacing:.1em;color:var(--blue);border:1px solid var(--line2);border-radius:99px;padding:3px 7px}.docs-top-actions{display:flex;align-items:center;gap:14px}.top-link{font:500 11px/1 var(--mono);letter-spacing:.08em;text-transform:uppercase;color:var(--muted);transition:color .2s}.top-link:hover{color:var(--ink)}.download-link{padding:10px 15px;border:1px solid var(--line2);border-radius:99px;color:var(--blue2)}
|
|
11
11
|
.docs-search-button{justify-self:center;width:min(420px,90%);height:38px;border:1px solid var(--line);background:rgba(17,25,37,.72);border-radius:9px;color:var(--muted);display:flex;align-items:center;gap:10px;padding:0 12px;cursor:pointer;text-align:left;transition:border-color .2s,background .2s}.docs-search-button:hover{border-color:var(--line2);background:var(--panel)}.search-icon{font-size:15px;color:var(--blue)}.docs-search-button span:nth-child(2){flex:1}.docs-search-button kbd{font:500 10px/1 var(--mono);border:1px solid var(--line2);border-radius:5px;padding:5px 7px;color:var(--cool);background:#0a111a}
|
|
12
12
|
.docs-shell{display:grid;grid-template-columns:var(--side) minmax(0,var(--content)) var(--toc);justify-content:center;gap:clamp(28px,4vw,62px);padding:var(--top) 30px 80px}.docs-sidebar{position:sticky;top:var(--top);height:calc(100dvh - var(--top));overflow:auto;padding:34px 22px 50px 0;border-right:1px solid var(--line);scrollbar-width:thin;scrollbar-color:var(--line2) transparent}.side-group{margin-bottom:30px}.side-title{margin:0 0 9px;font:600 10px/1 var(--mono);letter-spacing:.17em;text-transform:uppercase;color:var(--faint)}.side-link{display:block;margin:1px 0;padding:7px 11px;border-left:1px solid transparent;color:var(--muted);font-size:14px;line-height:1.25;border-radius:0 6px 6px 0;transition:color .2s,border-color .2s,background .2s}.side-link:hover{color:var(--ink);background:rgba(124,196,255,.05)}.side-link.is-active{color:var(--blue2);border-left-color:var(--blue);background:linear-gradient(90deg,rgba(124,196,255,.1),transparent)}.side-source{margin-top:34px;padding:14px;border:1px solid var(--line);border-radius:9px;color:var(--muted);font-size:12px;line-height:1.5}.side-source b{display:block;color:var(--cool);font-weight:500;margin-bottom:4px}.side-source a{color:var(--blue2)}
|
|
13
13
|
.docs-main{min-width:0;padding-top:56px}.docs-article{padding-bottom:70px}.docs-kicker{font:500 10px/1 var(--mono);letter-spacing:.18em;text-transform:uppercase;color:var(--blue);margin:0 0 17px}.docs-article h1{font:400 clamp(49px,6vw,78px)/.96 var(--display);letter-spacing:-.025em;margin:0 0 24px;max-width:12ch}.docs-article h1 em{font-weight:400;color:var(--blue2)}.docs-lede{font-size:20px;line-height:1.55;color:var(--cool);max-width:650px;margin:0 0 44px}.docs-meta{display:flex;gap:12px;flex-wrap:wrap;margin:-22px 0 42px}.meta-chip{font:500 10px/1 var(--mono);letter-spacing:.08em;text-transform:uppercase;color:var(--muted);border:1px solid var(--line);border-radius:99px;padding:7px 10px}.docs-article section{padding-top:22px;margin-top:34px}.docs-article h2{font:500 34px/1.1 var(--display);letter-spacing:-.01em;margin:0 0 14px;color:var(--ink)}.docs-article h3{font-size:18px;line-height:1.3;margin:31px 0 10px;color:var(--blue2);font-weight:500}.docs-article p{margin:0 0 17px;color:var(--cool)}.docs-article strong{color:var(--ink);font-weight:500}.docs-article a:not(.card):not(.pager-link){color:var(--blue2);text-decoration:underline;text-decoration-color:rgba(124,196,255,.3);text-underline-offset:3px}.docs-article ul,.docs-article ol{margin:12px 0 22px;padding-left:23px;color:var(--cool)}.docs-article li{margin:7px 0;padding-left:4px}.docs-article code{font:500 .84em/1.5 var(--mono);color:var(--blue2);background:rgba(124,196,255,.08);border:1px solid rgba(124,196,255,.11);border-radius:4px;padding:2px 5px}.code-block{position:relative;margin:20px 0 27px;border:1px solid var(--line2);border-radius:11px;overflow:hidden;background:#080e15;box-shadow:0 24px 70px rgba(0,0,0,.2)}.code-label{height:34px;display:flex;align-items:center;padding:0 13px;border-bottom:1px solid var(--line);font:500 9px/1 var(--mono);letter-spacing:.13em;text-transform:uppercase;color:var(--faint)}pre{margin:0;padding:18px 20px 20px;overflow:auto;color:#dcecff;font:400 13px/1.7 var(--mono);tab-size:2}.docs-article pre code{font:inherit;color:inherit;background:none;border:0;padding:0}.copy-button{position:absolute;top:7px;right:8px;border:1px solid var(--line);background:var(--panel);border-radius:5px;color:var(--muted);font:500 9px/1 var(--mono);letter-spacing:.08em;text-transform:uppercase;padding:6px 8px;cursor:pointer}.copy-button:hover{color:var(--ink);border-color:var(--line2)}
|
|
14
14
|
.callout{border-left:2px solid var(--blue);background:rgba(124,196,255,.055);padding:17px 19px;margin:24px 0;border-radius:0 9px 9px 0}.callout.warn{border-left-color:#f0b90b;background:rgba(240,185,11,.055)}.callout.safe{border-left-color:var(--teal);background:rgba(80,210,193,.055)}.callout-title{display:block;margin-bottom:5px;font:600 10px/1 var(--mono);letter-spacing:.12em;text-transform:uppercase;color:var(--blue2)}.callout.warn .callout-title{color:#f3ca55}.callout.safe .callout-title{color:#8aeadc}.callout p:last-child{margin-bottom:0}.quick-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:12px;margin:23px 0 35px}.card{display:block;padding:20px;border:1px solid var(--line);border-radius:11px;background:linear-gradient(145deg,rgba(21,32,49,.7),rgba(12,19,29,.45));transition:transform .25s var(--ease),border-color .25s,background .25s}.card:hover{transform:translateY(-3px);border-color:var(--line2);background:var(--panel)}.card small{display:block;font:500 9px/1 var(--mono);letter-spacing:.13em;text-transform:uppercase;color:var(--blue);margin-bottom:9px}.card b{display:block;font:500 18px/1.2 var(--display);color:var(--ink);margin-bottom:6px}.card span{display:block;color:var(--muted);font-size:13px;line-height:1.5}.steps{counter-reset:step;margin:23px 0}.step{position:relative;padding:0 0 26px 48px;border-left:1px solid var(--line);margin-left:14px}.step:last-child{border-left-color:transparent}.step:before{counter-increment:step;content:counter(step);position:absolute;left:-15px;top:0;width:28px;height:28px;border-radius:50%;display:grid;place-items:center;background:var(--bg2);border:1px solid var(--line2);color:var(--blue);font:500 10px/1 var(--mono)}.step h3{margin:0 0 6px;color:var(--ink)}.step p{margin:0}.docs-table-wrap{overflow:auto;margin:20px 0 28px;border:1px solid var(--line);border-radius:10px}table{border-collapse:collapse;width:100%;min-width:580px;font-size:14px}th,td{padding:13px 15px;border-bottom:1px solid var(--line);text-align:left;vertical-align:top}th{font:600 9px/1.2 var(--mono);letter-spacing:.12em;text-transform:uppercase;color:var(--faint);background:rgba(17,25,37,.75)}td{color:var(--cool)}td:first-child{color:var(--blue2);font-family:var(--mono);font-size:12px}tr:last-child td{border-bottom:0}.plane-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:10px;margin:21px 0}.plane{padding:18px 16px;border:1px solid var(--line);border-radius:9px;background:var(--panel)}.plane b{display:block;color:var(--ink);font-size:15px;margin-bottom:7px}.plane span{display:block;color:var(--muted);font-size:12px;line-height:1.55}.plane.exec{border-color:rgba(80,210,193,.3)}.pager{display:grid;grid-template-columns:1fr 1fr;gap:12px;border-top:1px solid var(--line);padding-top:28px;margin-top:58px}.pager-link{padding:14px 16px;border:1px solid var(--line);border-radius:8px;color:var(--muted);font-size:13px;transition:border-color .2s,color .2s}.pager-link:hover{border-color:var(--line2);color:var(--ink)}.pager-link.next{text-align:right;grid-column:2}.pager-link small{display:block;font:500 9px/1 var(--mono);letter-spacing:.1em;text-transform:uppercase;color:var(--faint);margin-bottom:6px}
|
|
15
15
|
.docs-toc{position:sticky;top:calc(var(--top) + 48px);align-self:start;padding-top:8px}.toc-title{font:600 9px/1 var(--mono);letter-spacing:.15em;text-transform:uppercase;color:var(--faint);margin-bottom:12px}.toc-link{display:block;padding:5px 0;color:var(--faint);font-size:12px;line-height:1.35;transition:color .2s}.toc-link:hover,.toc-link.is-active{color:var(--blue2)}
|
|
16
|
-
.search-dialog[hidden]{display:none}.search-dialog{position:fixed;inset:0;z-index:100;background:rgba(4,8,12,.74);backdrop-filter:blur(10px);display:grid;place-items:start center;padding-top:min(15vh,130px)}.search-panel{width:min(680px,calc(100vw - 28px));max-height:min(650px,76vh);border:1px solid var(--line2);border-radius:13px;background:#0d151f;box-shadow:0 35px 120px rgba(0,0,0,.55);overflow:hidden}.search-field{display:flex;align-items:center;border-bottom:1px solid var(--line);padding:0 18px}.search-field input{width:100%;height:58px;border:0;
|
|
16
|
+
.search-dialog[hidden]{display:none}.search-dialog{position:fixed;inset:0;z-index:100;background:rgba(4,8,12,.74);backdrop-filter:blur(10px);display:grid;place-items:start center;padding-top:min(15vh,130px)}.search-panel{width:min(680px,calc(100vw - 28px));max-height:min(650px,76vh);border:1px solid var(--line2);border-radius:13px;background:#0d151f;box-shadow:0 35px 120px rgba(0,0,0,.55);overflow:hidden}.search-field{display:flex;align-items:center;border-bottom:1px solid var(--line);padding:0 18px}.search-field input{width:100%;height:58px;border:0;background:transparent;color:var(--ink);font-size:17px}.search-field input::placeholder{color:var(--faint)}.search-close{border:1px solid var(--line);background:transparent;color:var(--muted);border-radius:5px;padding:5px 8px;font:500 9px/1 var(--mono);cursor:pointer}.search-status{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0}.search-results{padding:8px;overflow:auto;max-height:540px}.search-result{display:block;padding:13px 14px;border-radius:8px}.search-result:hover,.search-result.is-selected{background:rgba(124,196,255,.08)}.search-result b{display:block;color:var(--ink);font-weight:500;font-size:14px}.search-result span{display:block;color:var(--muted);font-size:12px;margin-top:3px}.search-empty{padding:28px;color:var(--muted);text-align:center}.mobile-menu{display:none}
|
|
17
17
|
@media(max-width:1120px){.docs-shell{grid-template-columns:var(--side) minmax(0,var(--content));max-width:1100px}.docs-toc{display:none}}
|
|
18
18
|
@media(max-width:800px){:root{--top:58px}.docs-topbar{grid-template-columns:1fr auto auto;padding:0 16px}.docs-word{font-size:19px}.docs-version,.top-link.product-link{display:none}.docs-search-button{width:38px;padding:0;justify-content:center}.docs-search-button span:nth-child(2),.docs-search-button kbd{display:none}.docs-top-actions{gap:8px}.download-link{padding:8px 11px}.mobile-menu{display:grid;width:38px;height:38px;place-items:center;border:1px solid var(--line);border-radius:7px;background:transparent;color:var(--cool);cursor:pointer}.docs-shell{display:block;padding:var(--top) 20px 60px}.docs-sidebar{position:fixed;z-index:65;left:0;top:var(--top);width:min(310px,86vw);height:calc(100dvh - var(--top));padding:24px 24px 50px;background:#0c131d;border-right:1px solid var(--line2);transform:translateX(-104%);transition:transform .3s var(--ease);box-shadow:30px 0 80px rgba(0,0,0,.35)}body.menu-open .docs-sidebar{transform:none}.docs-main{padding-top:42px}.docs-article h1{font-size:clamp(46px,14vw,64px)}.docs-lede{font-size:18px}.quick-grid{grid-template-columns:1fr}.plane-grid{grid-template-columns:1fr}.pager{grid-template-columns:1fr}.pager-link.next{grid-column:1;text-align:left}}
|
|
19
19
|
@media(max-width:800px){.docs-article pre{white-space:pre-wrap;overflow-wrap:anywhere;word-break:break-word}}
|
|
20
20
|
@media(max-width:480px){.docs-shell{padding-left:17px;padding-right:17px}.docs-article h2{font-size:30px}.docs-meta{gap:7px}.meta-chip{font-size:8px}.docs-top-actions .download-link{font-size:9px}.code-block{margin-left:-5px;margin-right:-5px}pre{font-size:12px;padding:17px 15px}.docs-table-wrap{margin-left:-5px;margin-right:-5px}}
|
|
21
|
-
@media(prefers-reduced-motion:reduce){html{scroll-behavior:auto}.card,.docs-sidebar{transition:none}}
|
|
21
|
+
@media(prefers-reduced-motion:reduce){html{scroll-behavior:auto}.card,.docs-sidebar,.skip-link{transition:none}}
|
|
@@ -32,27 +32,125 @@
|
|
|
32
32
|
const close = document.getElementById("docs-search-close");
|
|
33
33
|
const input = document.getElementById("docs-search-input");
|
|
34
34
|
const results = document.getElementById("docs-search-results");
|
|
35
|
+
const status = document.getElementById("docs-search-status");
|
|
36
|
+
const menuButton = document.getElementById("docs-menu-button");
|
|
37
|
+
const sidebar = document.getElementById("docs-sidebar");
|
|
38
|
+
const firstSidebarLink = sidebar?.querySelector("a[href]");
|
|
39
|
+
const mobileMenuQuery = window.matchMedia("(max-width: 800px)");
|
|
35
40
|
let selected = 0;
|
|
41
|
+
let searchReturnFocus = null;
|
|
42
|
+
let backgroundState = null;
|
|
36
43
|
|
|
37
44
|
function render(query = "") {
|
|
38
45
|
const terms = query.toLowerCase().trim().split(/\s+/).filter(Boolean);
|
|
39
46
|
const rows = entries.filter(row => terms.every(term => row.join(" ").toLowerCase().includes(term))).slice(0, 10);
|
|
40
47
|
selected = Math.min(selected, Math.max(rows.length - 1, 0));
|
|
41
|
-
results.innerHTML = rows.length ? rows.map((row, i) => `<a class="search-result${i === selected ? " is-selected" : ""}" href="${row[2]}"><b>${row[0]}</b><span>${row[1]}</span></a>`).join("") : '<div class="search-empty">No matching documentation.</div>';
|
|
48
|
+
results.innerHTML = rows.length ? rows.map((row, i) => `<a id="docs-search-option-${i}" role="option" aria-selected="${i === selected}" class="search-result${i === selected ? " is-selected" : ""}" href="${row[2]}"><b>${row[0]}</b><span>${row[1]}</span></a>`).join("") : '<div class="search-empty">No matching documentation.</div>';
|
|
49
|
+
input?.setAttribute("aria-activedescendant", rows.length ? `docs-search-option-${selected}` : "");
|
|
50
|
+
if (status) status.textContent = `${rows.length} ${rows.length === 1 ? "result" : "results"}`;
|
|
42
51
|
}
|
|
43
52
|
function openSearch() {
|
|
44
|
-
if (!dialog) return;
|
|
53
|
+
if (!dialog || !input) return;
|
|
54
|
+
const opening = dialog.hidden;
|
|
55
|
+
if (opening) searchReturnFocus = document.activeElement;
|
|
45
56
|
dialog.hidden = false;
|
|
57
|
+
input.setAttribute("aria-expanded", "true");
|
|
46
58
|
selected = 0;
|
|
47
59
|
render(input.value);
|
|
48
|
-
|
|
60
|
+
input.focus();
|
|
61
|
+
if (opening) isolateSearchBackground();
|
|
49
62
|
}
|
|
50
63
|
function closeSearch() {
|
|
51
|
-
if (!dialog) return;
|
|
64
|
+
if (!dialog || !input) return;
|
|
52
65
|
dialog.hidden = true;
|
|
66
|
+
input.setAttribute("aria-expanded", "false");
|
|
67
|
+
input.removeAttribute("aria-activedescendant");
|
|
53
68
|
input.value = "";
|
|
54
|
-
button
|
|
69
|
+
const target = searchReturnFocus?.isConnected ? searchReturnFocus : button;
|
|
70
|
+
searchReturnFocus = null;
|
|
71
|
+
restoreSearchBackground();
|
|
72
|
+
target?.focus();
|
|
55
73
|
}
|
|
74
|
+
function isolateSearchBackground() {
|
|
75
|
+
if (!dialog || backgroundState) return;
|
|
76
|
+
backgroundState = [...document.body.children]
|
|
77
|
+
.filter(child => child !== dialog && child.tagName !== "SCRIPT")
|
|
78
|
+
.map(child => ({
|
|
79
|
+
child,
|
|
80
|
+
inert: child.hasAttribute("inert"),
|
|
81
|
+
ariaHidden: child.getAttribute("aria-hidden"),
|
|
82
|
+
}));
|
|
83
|
+
backgroundState.forEach(({ child }) => {
|
|
84
|
+
child.setAttribute("inert", "");
|
|
85
|
+
child.setAttribute("aria-hidden", "true");
|
|
86
|
+
});
|
|
87
|
+
}
|
|
88
|
+
function restoreSearchBackground() {
|
|
89
|
+
if (!backgroundState) return;
|
|
90
|
+
backgroundState.forEach(({ child, inert, ariaHidden }) => {
|
|
91
|
+
if (inert) child.setAttribute("inert", "");
|
|
92
|
+
else child.removeAttribute("inert");
|
|
93
|
+
if (ariaHidden === null) child.removeAttribute("aria-hidden");
|
|
94
|
+
else child.setAttribute("aria-hidden", ariaHidden);
|
|
95
|
+
});
|
|
96
|
+
backgroundState = null;
|
|
97
|
+
}
|
|
98
|
+
function trapSearchFocus(event) {
|
|
99
|
+
if (event.key !== "Tab" || !dialog || dialog.hidden) return;
|
|
100
|
+
const focusable = [...dialog.querySelectorAll('input,button,a[href]:not([tabindex="-1"])')];
|
|
101
|
+
if (!focusable.length) return;
|
|
102
|
+
const first = focusable[0];
|
|
103
|
+
const last = focusable[focusable.length - 1];
|
|
104
|
+
if (event.shiftKey && document.activeElement === first) {
|
|
105
|
+
event.preventDefault();
|
|
106
|
+
last.focus();
|
|
107
|
+
} else if (!event.shiftKey && document.activeElement === last) {
|
|
108
|
+
event.preventDefault();
|
|
109
|
+
first.focus();
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
function trapMenuFocus(event) {
|
|
113
|
+
if (event.key !== "Tab" || !mobileMenuQuery.matches || !document.body.classList.contains("menu-open")) return;
|
|
114
|
+
const focusable = [menuButton, ...sidebar.querySelectorAll('a[href],button:not([disabled]),[tabindex]:not([tabindex="-1"])')].filter(Boolean);
|
|
115
|
+
if (!focusable.length) return;
|
|
116
|
+
const first = focusable[0];
|
|
117
|
+
const last = focusable[focusable.length - 1];
|
|
118
|
+
if (event.shiftKey && document.activeElement === first) {
|
|
119
|
+
event.preventDefault();
|
|
120
|
+
last.focus();
|
|
121
|
+
} else if (!event.shiftKey && document.activeElement === last) {
|
|
122
|
+
event.preventDefault();
|
|
123
|
+
first.focus();
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
function syncMenuAccessibility(open) {
|
|
127
|
+
if (!sidebar) return;
|
|
128
|
+
if (mobileMenuQuery.matches) {
|
|
129
|
+
if (open) {
|
|
130
|
+
sidebar.removeAttribute("inert");
|
|
131
|
+
sidebar.removeAttribute("aria-hidden");
|
|
132
|
+
} else {
|
|
133
|
+
sidebar.setAttribute("inert", "");
|
|
134
|
+
sidebar.setAttribute("aria-hidden", "true");
|
|
135
|
+
}
|
|
136
|
+
} else {
|
|
137
|
+
document.body.classList.remove("menu-open");
|
|
138
|
+
sidebar.removeAttribute("inert");
|
|
139
|
+
sidebar.removeAttribute("aria-hidden");
|
|
140
|
+
menuButton?.setAttribute("aria-expanded", "false");
|
|
141
|
+
menuButton?.setAttribute("aria-label", "Open documentation menu");
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
function setMenu(open, { returnFocus = false } = {}) {
|
|
145
|
+
open = Boolean(open && mobileMenuQuery.matches);
|
|
146
|
+
document.body.classList.toggle("menu-open", open);
|
|
147
|
+
menuButton?.setAttribute("aria-expanded", String(open));
|
|
148
|
+
menuButton?.setAttribute("aria-label", open ? "Close documentation menu" : "Open documentation menu");
|
|
149
|
+
syncMenuAccessibility(open);
|
|
150
|
+
if (open) requestAnimationFrame(() => firstSidebarLink?.focus());
|
|
151
|
+
else if (returnFocus) menuButton?.focus();
|
|
152
|
+
}
|
|
153
|
+
|
|
56
154
|
button?.addEventListener("click", openSearch);
|
|
57
155
|
close?.addEventListener("click", closeSearch);
|
|
58
156
|
dialog?.addEventListener("click", event => { if (event.target === dialog) closeSearch(); });
|
|
@@ -73,10 +171,24 @@
|
|
|
73
171
|
if ((event.metaKey || event.ctrlKey) && event.key.toLowerCase() === "k") { event.preventDefault(); openSearch(); }
|
|
74
172
|
else if (event.key === "/" && !typing && dialog?.hidden) { event.preventDefault(); openSearch(); }
|
|
75
173
|
else if (event.key === "Escape" && dialog && !dialog.hidden) closeSearch();
|
|
174
|
+
else if (event.key === "Escape" && document.body.classList.contains("menu-open")) setMenu(false, { returnFocus: true });
|
|
175
|
+
else {
|
|
176
|
+
trapSearchFocus(event);
|
|
177
|
+
trapMenuFocus(event);
|
|
178
|
+
}
|
|
76
179
|
});
|
|
77
180
|
|
|
78
|
-
|
|
79
|
-
document.querySelectorAll(".docs-sidebar a").forEach(link => link.addEventListener("click", () =>
|
|
181
|
+
menuButton?.addEventListener("click", () => setMenu(!document.body.classList.contains("menu-open")));
|
|
182
|
+
document.querySelectorAll(".docs-sidebar a").forEach(link => link.addEventListener("click", () => {
|
|
183
|
+
if (mobileMenuQuery.matches) setMenu(false, { returnFocus: true });
|
|
184
|
+
}));
|
|
185
|
+
document.addEventListener("click", event => {
|
|
186
|
+
if (!document.body.classList.contains("menu-open")) return;
|
|
187
|
+
if (sidebar?.contains(event.target) || menuButton?.contains(event.target)) return;
|
|
188
|
+
setMenu(false, { returnFocus: true });
|
|
189
|
+
});
|
|
190
|
+
mobileMenuQuery.addEventListener("change", () => syncMenuAccessibility(document.body.classList.contains("menu-open")));
|
|
191
|
+
syncMenuAccessibility(false);
|
|
80
192
|
|
|
81
193
|
document.querySelectorAll("pre").forEach(pre => {
|
|
82
194
|
const wrap = pre.closest(".code-block");
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
<!doctype html>
|
|
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="
|
|
3
|
-
<body data-doc-page="getting-started"><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.
|
|
5
|
-
<div class="docs-shell"><aside class="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.
|
|
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
|
+
<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.41</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.41. <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>
|
|
@@ -33,4 +33,4 @@ oracle doctor</code></pre></div>
|
|
|
33
33
|
# or
|
|
34
34
|
npm i -g @oracle-agent/oracle@latest</code></pre></div>
|
|
35
35
|
<p>Before removing Oracle, export anything you need from your local config. Never copy vault files into a public backup.</p></section><nav class="pager" aria-label="Documentation pages"><a class="pager-link" href="/docs/"><small>Previous</small>Overview</a><a class="pager-link next" href="/docs/using-oracle/"><small>Next</small>Using Oracle</a></nav></article></main><aside class="docs-toc"><p class="toc-title">On this page</p><a class="toc-link is-active" href="#requirements">Requirements</a><a class="toc-link" href="#install">Install</a><a class="toc-link" href="#model">Configure a model</a><a class="toc-link" href="#first-run">First run</a><a class="toc-link" href="#maintenance">Update or remove</a></aside></div>
|
|
36
|
-
<div class="search-dialog" id="docs-search-dialog" hidden><div class="search-panel" role="dialog" aria-modal="true" aria-label="Search documentation"><div class="search-field"><input id="docs-search-input" type="search" placeholder="Search commands, chains, security..."><button class="search-close" id="docs-search-close" type="button">Esc</button></div><div class="search-results" id="docs-search-results"></div></div></div><script src="
|
|
36
|
+
<div class="search-dialog" id="docs-search-dialog" hidden><div class="search-panel" role="dialog" aria-modal="true" aria-label="Search documentation"><div class="search-field"><input id="docs-search-input" type="search" role="combobox" aria-label="Search documentation" aria-autocomplete="list" aria-controls="docs-search-results" aria-expanded="false" placeholder="Search commands, chains, security..."><button class="search-close" id="docs-search-close" type="button" aria-label="Close search">Esc</button></div><div class="search-status" id="docs-search-status" role="status" aria-live="polite" aria-atomic="true"></div><div class="search-results" id="docs-search-results" role="listbox" aria-label="Documentation search results"></div></div></div><script src="../docs.js"></script></body></html>
|
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
<!doctype html>
|
|
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="
|
|
3
|
-
<body data-doc-page="overview"><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.
|
|
5
|
-
<div class="docs-shell"><aside class="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.
|
|
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
|
+
<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.41</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.41. <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.41</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.
|
|
11
|
+
<p>Oracle 0.35.41 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>
|
|
@@ -23,4 +23,4 @@ oracle --version</code></pre></div>
|
|
|
23
23
|
<a class="card" href="/docs/security/"><small>Core concept</small><b>Security and execution</b><span>Understand grants, confirmation, local signing, autonomous opt-in, and receipts.</span></a>
|
|
24
24
|
</div></section>
|
|
25
25
|
<section id="safe-defaults"><h2>Safe defaults</h2><ul><li>Oracle starts <strong>disarmed</strong>.</li><li>Unknown data stays unknown. Missing values do not become zero.</li><li>Route rankings use net received when gas and fees are measurable.</li><li>Prepare is not sign. Sign is not broadcast.</li><li>An action is complete only with a transaction hash and a successful receipt.</li></ul></section><nav class="pager" aria-label="Documentation pages"><a class="pager-link next" href="/docs/getting-started/"><small>Next</small>Getting started</a></nav></article></main><aside class="docs-toc"><p class="toc-title">On this page</p><a class="toc-link is-active" href="#install">Install</a><a class="toc-link" href="#what">What Oracle is</a><a class="toc-link" href="#quick-links">Quick links</a><a class="toc-link" href="#safe-defaults">Safe defaults</a></aside></div>
|
|
26
|
-
<div class="search-dialog" id="docs-search-dialog" hidden><div class="search-panel" role="dialog" aria-modal="true" aria-label="Search documentation"><div class="search-field"><input id="docs-search-input" type="search" placeholder="Search commands, chains, security..."><button class="search-close" id="docs-search-close" type="button">Esc</button></div><div class="search-results" id="docs-search-results"></div></div></div><script src="
|
|
26
|
+
<div class="search-dialog" id="docs-search-dialog" hidden><div class="search-panel" role="dialog" aria-modal="true" aria-label="Search documentation"><div class="search-field"><input id="docs-search-input" type="search" role="combobox" aria-label="Search documentation" aria-autocomplete="list" aria-controls="docs-search-results" aria-expanded="false" placeholder="Search commands, chains, security..."><button class="search-close" id="docs-search-close" type="button" aria-label="Close search">Esc</button></div><div class="search-status" id="docs-search-status" role="status" aria-live="polite" aria-atomic="true"></div><div class="search-results" id="docs-search-results" role="listbox" aria-label="Documentation search results"></div></div></div><script src="./docs.js"></script></body></html>
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
<!doctype html>
|
|
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="
|
|
3
|
-
<body data-doc-page="reference"><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.
|
|
5
|
-
<div class="docs-shell"><aside class="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.
|
|
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
|
+
<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.41</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.41. <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.41</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 <name></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 <target></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";
|
|
@@ -17,4 +17,4 @@ const prepared = await data.call("hl-perps", "prepareOrder", {
|
|
|
17
17
|
<div class="docs-table-wrap"><table><thead><tr><th>Import</th><th>Surface</th></tr></thead><tbody><tr><td>@oracle-agent/oracle</td><td>Common package root</td></tr><tr><td>@oracle-agent/oracle/data</td><td>Provider catalog and data calls</td></tr><tr><td>@oracle-agent/oracle/scanner</td><td>Chain and token scanner</td></tr><tr><td>@oracle-agent/oracle/prepare-route</td><td>Same-chain route comparison and unsigned preparation</td></tr><tr><td>@oracle-agent/oracle/prepare-bridge</td><td>Bridge comparison and ordered unsigned preparation</td></tr><tr><td>@oracle-agent/oracle/policy</td><td>Grant validation and cap constants</td></tr><tr><td>@oracle-agent/oracle/local-signer</td><td>Explicit self-host-only signer surface</td></tr><tr><td>@oracle-agent/oracle/verified-receipts</td><td>Pure receipt verification over supplied facts</td></tr><tr><td>@oracle-agent/oracle/connect</td><td>MCP harness configuration snippets</td></tr></tbody></table></div></section>
|
|
18
18
|
<section id="environment"><h2>Environment variables</h2><div class="docs-table-wrap"><table><thead><tr><th>Name</th><th>Default</th><th>Meaning</th></tr></thead><tbody><tr><td>ORACLE_CONFIG_DIR</td><td>~/.config/oracle</td><td>Local configuration directory</td></tr><tr><td>ORACLE_DATA_HOST</td><td>127.0.0.1</td><td>Read-plane bind host, loopback enforced</td></tr><tr><td>ORACLE_DATA_PORT</td><td>8787</td><td>Read-plane port</td></tr><tr><td>ORACLE_PUBLIC_HOST</td><td>127.0.0.1</td><td>Public-plane bind host, loopback enforced</td></tr><tr><td>ORACLE_ALLOWED_CHAINS</td><td>unset</td><td>Optional chain allowlist</td></tr><tr><td>ORACLE_VALUE_CAPS_ENABLED</td><td>on</td><td>Per-transaction value caps</td></tr><tr><td>ORACLE_AUTONOMOUS_TRADING</td><td>off</td><td>Additional self-hosted unattended-trading gate</td></tr><tr><td>ORACLE_REDACT_SECRETS</td><td>true</td><td>Redact recognized secret material before model context</td></tr></tbody></table></div></section>
|
|
19
19
|
<section id="tiers"><h2>Capability tiers</h2><div class="docs-table-wrap"><table><thead><tr><th>Tier</th><th>Meaning</th></tr></thead><tbody><tr><td>read-only</td><td>Data only. No execution claim.</td></tr><tr><td>quote-only</td><td>Can price an action. No reviewed transaction builder.</td></tr><tr><td>prepare</td><td>Returns a policy-bound unsigned artifact.</td></tr><tr><td>intent</td><td>Returns typed data for a protocol-native or solver order.</td></tr></tbody></table></div><p>API coverage is not execution support. Unsupported and unconfigured routes fail closed instead of returning plausible placeholders.</p></section><nav class="pager" aria-label="Documentation pages"><a class="pager-link" href="/docs/security/"><small>Previous</small>Security and execution</a></nav></article></main><aside class="docs-toc"><p class="toc-title">On this page</p><a class="toc-link is-active" href="#cli">CLI commands</a><a class="toc-link" href="#executables">Executables</a><a class="toc-link" href="#library">Library imports</a><a class="toc-link" href="#environment">Environment</a><a class="toc-link" href="#tiers">Capability tiers</a></aside></div>
|
|
20
|
-
<div class="search-dialog" id="docs-search-dialog" hidden><div class="search-panel" role="dialog" aria-modal="true" aria-label="Search documentation"><div class="search-field"><input id="docs-search-input" type="search" placeholder="Search commands, chains, security..."><button class="search-close" id="docs-search-close" type="button">Esc</button></div><div class="search-results" id="docs-search-results"></div></div></div><script src="
|
|
20
|
+
<div class="search-dialog" id="docs-search-dialog" hidden><div class="search-panel" role="dialog" aria-modal="true" aria-label="Search documentation"><div class="search-field"><input id="docs-search-input" type="search" role="combobox" aria-label="Search documentation" aria-autocomplete="list" aria-controls="docs-search-results" aria-expanded="false" placeholder="Search commands, chains, security..."><button class="search-close" id="docs-search-close" type="button" aria-label="Close search">Esc</button></div><div class="search-status" id="docs-search-status" role="status" aria-live="polite" aria-atomic="true"></div><div class="search-results" id="docs-search-results" role="listbox" aria-label="Documentation search results"></div></div></div><script src="../docs.js"></script></body></html>
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
<!doctype html>
|
|
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="
|
|
3
|
-
<body data-doc-page="security"><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.
|
|
5
|
-
<div class="docs-shell"><aside class="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.
|
|
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
|
+
<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.41</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.41. <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>
|
|
@@ -16,4 +16,4 @@ oracle sign lock</code></pre></div>
|
|
|
16
16
|
<section id="autonomous"><h2>Autonomous trading</h2><p>Unattended trading is a separate opt-in for trusted self-hosted code. It requires <code>ORACLE_AUTONOMOUS_TRADING=1</code>, compatible policy mode, and a verified trigger attestation. The environment flag alone does not bypass local policy or grant bounds.</p></section>
|
|
17
17
|
<section id="receipts"><h2>Receipt proof</h2><p>Broadcast acceptance is not success. Oracle reports success only when a transaction hash and a successful receipt are coherent with the prepared artifact and observed chain state. Missing finality or balance evidence stays unknown.</p></section>
|
|
18
18
|
<section id="secrets"><h2>Secret handling</h2><ul><li>Hosted surfaces do not accept wallet keys</li><li>Local vault material stays on the self-hosted machine</li><li>Provider status commands do not print credentials</li><li>Secret-shaped fields are rejected or redacted from model context and logs</li><li>Public HTTP services bind to loopback by default and need a controlled admission layer before hosted exposure</li></ul></section><nav class="pager" aria-label="Documentation pages"><a class="pager-link" href="/docs/browser-and-web/"><small>Previous</small>Browser and web tools</a><a class="pager-link next" href="/docs/reference/"><small>Next</small>CLI and API reference</a></nav></article></main><aside class="docs-toc"><p class="toc-title">On this page</p><a class="toc-link is-active" href="#planes">Three planes</a><a class="toc-link" href="#grants">Grants</a><a class="toc-link" href="#local-signer">Local signer</a><a class="toc-link" href="#autonomous">Autonomous trading</a><a class="toc-link" href="#receipts">Receipt proof</a><a class="toc-link" href="#secrets">Secret handling</a></aside></div>
|
|
19
|
-
<div class="search-dialog" id="docs-search-dialog" hidden><div class="search-panel" role="dialog" aria-modal="true" aria-label="Search documentation"><div class="search-field"><input id="docs-search-input" type="search" placeholder="Search commands, chains, security..."><button class="search-close" id="docs-search-close" type="button">Esc</button></div><div class="search-results" id="docs-search-results"></div></div></div><script src="
|
|
19
|
+
<div class="search-dialog" id="docs-search-dialog" hidden><div class="search-panel" role="dialog" aria-modal="true" aria-label="Search documentation"><div class="search-field"><input id="docs-search-input" type="search" role="combobox" aria-label="Search documentation" aria-autocomplete="list" aria-controls="docs-search-results" aria-expanded="false" placeholder="Search commands, chains, security..."><button class="search-close" id="docs-search-close" type="button" aria-label="Close search">Esc</button></div><div class="search-status" id="docs-search-status" role="status" aria-live="polite" aria-atomic="true"></div><div class="search-results" id="docs-search-results" role="listbox" aria-label="Documentation search results"></div></div></div><script src="../docs.js"></script></body></html>
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
<!doctype html>
|
|
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="
|
|
3
|
-
<body data-doc-page="using-oracle"><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.
|
|
5
|
-
<div class="docs-shell"><aside class="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.
|
|
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
|
+
<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.41</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.41. <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
|
|
@@ -29,4 +29,4 @@ export ORACLE_BITCOIN_ADDRESS=bc1...
|
|
|
29
29
|
export ORACLE_HYPERLIQUID_ADDRESS=0x...
|
|
30
30
|
oracle data serve</code></pre></div></section>
|
|
31
31
|
<section id="receipts"><h2>Receipts</h2><p>Oracle does not treat an RPC acceptance response as settlement. A successful result requires coherent transaction and chain references plus included or final evidence under the configured finality rule.</p><ul><li>Transaction hash matches the prepared action</li><li>Receipt indicates success</li><li>Sender, destination, calldata, and chain remain bound</li><li>Balance deltas are marked verified only when snapshots prove them</li><li>Unknown, dropped, replaced, or reorganized outcomes stay explicit</li></ul></section><nav class="pager" aria-label="Documentation pages"><a class="pager-link" href="/docs/getting-started/"><small>Previous</small>Getting started</a><a class="pager-link next" href="/docs/connectors/"><small>Next</small>MCP connectors</a></nav></article></main><aside class="docs-toc"><p class="toc-title">On this page</p><a class="toc-link is-active" href="#chat">Native chat</a><a class="toc-link" href="#lifecycle">Action lifecycle</a><a class="toc-link" href="#routing">Best execution</a><a class="toc-link" href="#building">Build and mint</a><a class="toc-link" href="#portfolio">Portfolio reads</a><a class="toc-link" href="#receipts">Receipts</a></aside></div>
|
|
32
|
-
<div class="search-dialog" id="docs-search-dialog" hidden><div class="search-panel" role="dialog" aria-modal="true" aria-label="Search documentation"><div class="search-field"><input id="docs-search-input" type="search" placeholder="Search commands, chains, security..."><button class="search-close" id="docs-search-close" type="button">Esc</button></div><div class="search-results" id="docs-search-results"></div></div></div><script src="
|
|
32
|
+
<div class="search-dialog" id="docs-search-dialog" hidden><div class="search-panel" role="dialog" aria-modal="true" aria-label="Search documentation"><div class="search-field"><input id="docs-search-input" type="search" role="combobox" aria-label="Search documentation" aria-autocomplete="list" aria-controls="docs-search-results" aria-expanded="false" placeholder="Search commands, chains, security..."><button class="search-close" id="docs-search-close" type="button" aria-label="Close search">Esc</button></div><div class="search-status" id="docs-search-status" role="status" aria-live="polite" aria-atomic="true"></div><div class="search-results" id="docs-search-results" role="listbox" aria-label="Documentation search results"></div></div></div><script src="../docs.js"></script></body></html>
|
|
@@ -4,8 +4,8 @@
|
|
|
4
4
|
<meta charset="UTF-8" />
|
|
5
5
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
6
6
|
<title>Download Oracle | ORACLE</title>
|
|
7
|
-
<link rel="icon" href="
|
|
8
|
-
<link rel="shortcut icon" href="
|
|
7
|
+
<link rel="icon" href="../favicon.svg" type="image/svg+xml">
|
|
8
|
+
<link rel="shortcut icon" href="../favicon.ico">
|
|
9
9
|
<meta name="description" content="Install Oracle on macOS, Windows, or Linux, or add it to any MCP client.">
|
|
10
10
|
<meta name="theme-color" content="#0B1018" />
|
|
11
11
|
<meta name="robots" content="index,follow" />
|
|
@@ -20,9 +20,7 @@
|
|
|
20
20
|
<meta name="twitter:title" content="ORACLE | The all-in-one multichain agent">
|
|
21
21
|
<meta name="twitter:description" content="Trade, research, and build across Oracle's working chain surfaces, with extensible EVM support and self-custodial signing.">
|
|
22
22
|
<meta name="twitter:image" content="https://oracle.demi.la/assets/hero/orb-poster.jpg">
|
|
23
|
-
<link
|
|
24
|
-
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
|
|
25
|
-
<link href="https://fonts.googleapis.com/css2?family=Cormorant+Garamond:ital,wght@0,300;0,400;0,500;1,300;1,400;1,500&family=IBM+Plex+Mono:wght@400;500;600&family=Outfit:wght@300;400;500;600;700&family=UnifrakturCook:wght@700&display=swap" rel="stylesheet" />
|
|
23
|
+
<link href="../assets/fonts/oracle-fonts.css" rel="stylesheet" />
|
|
26
24
|
<style>
|
|
27
25
|
:root{
|
|
28
26
|
--bg:#0B1018;
|
|
@@ -1604,7 +1602,7 @@ footer{margin-top:clamp(64px,10vh,100px);border-top:1px solid var(--line);paddin
|
|
|
1604
1602
|
<div class="convert-grid rv">
|
|
1605
1603
|
<div>
|
|
1606
1604
|
<figure class="cli-frame cli-proof">
|
|
1607
|
-
<img id="cli-still" src="
|
|
1605
|
+
<img id="cli-still" src="../assets/oracle-cli-v035-poster.jpg?v=20260830b" alt="Oracle CLI boot: globe wordmark, THE FUTURE IS AGENTIC, local signer ready, gpt-5.6-sol, Hyperliquid, ←/→ sessions" width="1600" height="815" loading="eager" fetchpriority="high" />
|
|
1608
1606
|
</figure>
|
|
1609
1607
|
<p class="cli-cap">what you see when you type oracle</p>
|
|
1610
1608
|
</div>
|
|
@@ -1622,13 +1620,13 @@ footer{margin-top:clamp(64px,10vh,100px);border-top:1px solid var(--line);paddin
|
|
|
1622
1620
|
</div>
|
|
1623
1621
|
<h2 class="section-title app-shot-title">Oracle Desktop App <sup style="font-size:14px;color:var(--blue);font-weight:400">beta</sup></h2>
|
|
1624
1622
|
<figure class="app-shot">
|
|
1625
|
-
<img src="
|
|
1623
|
+
<img src="../assets/desktop-app.jpg?v=20260830" width="1280" height="860" loading="lazy" decoding="async" alt="Oracle desktop 0.4.19 setup: connect Claude, Codex or Grok, local llama.cpp or Ollama, then pick model and chain.">
|
|
1626
1624
|
<figcaption>Native desktop. Connect a provider, then chat.</figcaption>
|
|
1627
1625
|
</figure>
|
|
1628
1626
|
<div class="os-dl">
|
|
1629
|
-
<a class="os-link" href="/downloads/artifacts/Oracle-0.4.
|
|
1630
|
-
<a class="os-link" href="/downloads/artifacts/Oracle-0.4.
|
|
1631
|
-
<a class="os-link" href="/downloads/artifacts/Oracle-Setup-0.4.
|
|
1627
|
+
<a class="os-link" href="/downloads/artifacts/Oracle-0.4.19.AppImage">Linux AppImage</a>
|
|
1628
|
+
<a class="os-link" href="/downloads/artifacts/Oracle-0.4.19-arm64.dmg">macOS DMG</a>
|
|
1629
|
+
<a class="os-link" href="/downloads/artifacts/Oracle-Setup-0.4.19.exe">Windows Setup</a>
|
|
1632
1630
|
</div>
|
|
1633
1631
|
</section>
|
|
1634
1632
|
</main>
|
|
@@ -7,10 +7,8 @@
|
|
|
7
7
|
<meta name="description" content="Public Oracle CLI and desktop beta downloads for Linux, macOS, and Windows." />
|
|
8
8
|
<meta name="robots" content="index,follow" />
|
|
9
9
|
<meta name="theme-color" content="#0B1018" />
|
|
10
|
-
<link rel="icon" href="
|
|
11
|
-
<link
|
|
12
|
-
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
|
|
13
|
-
<link href="https://fonts.googleapis.com/css2?family=Cormorant+Garamond:ital,wght@0,400;0,500;1,400&family=IBM+Plex+Mono:wght@400;500;600&family=Outfit:wght@300;400;500;600&display=swap" rel="stylesheet" />
|
|
10
|
+
<link rel="icon" href="../favicon.svg" type="image/svg+xml" />
|
|
11
|
+
<link href="../assets/fonts/oracle-fonts.css" rel="stylesheet" />
|
|
14
12
|
<style>
|
|
15
13
|
:root{--bg:#0b1018;--panel:#111925;--ice:#f4f9fe;--blue:#7cc4ff;--blue2:#a7d8ff;--muted:#9fb8d2;--line:rgba(124,196,255,.16);--line2:rgba(124,196,255,.3);--display:"Cormorant Garamond",Georgia,serif;--sans:"Outfit",system-ui,sans-serif;--mono:"IBM Plex Mono",ui-monospace,monospace}
|
|
16
14
|
*{box-sizing:border-box;margin:0;padding:0}html{background:var(--bg);color:var(--ice);scroll-behavior:smooth;-webkit-font-smoothing:antialiased}body{min-height:100vh;font-family:var(--sans);background:radial-gradient(70% 45% at 50% 0,rgba(124,196,255,.11),transparent 65%),var(--bg)}a{color:inherit;text-decoration:none}button{font:inherit}
|
|
@@ -29,7 +27,7 @@ section{padding-top:72px;scroll-margin-top:90px}.sub{color:var(--muted);line-hei
|
|
|
29
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>
|
|
30
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>
|
|
31
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>
|
|
32
|
-
<section id="desktop"><p class="eyebrow">Desktop</p><h2>Linux, macOS, Windows</h2><p class="sub">Packaged <b>0.4.
|
|
30
|
+
<section id="desktop"><p class="eyebrow">Desktop</p><h2>Linux, macOS, Windows</h2><p class="sub">Packaged <b>0.4.19</b>. Settings can Check for updates against this feed.</p><div class="artifacts"><div class="artifact"><div><h3>Linux</h3><small>AppImage · x64</small></div><div class="build">Oracle-0.4.19.AppImage</div><div class="hash">sha256 dbf86006df23dd54a09da1628ca1df3e94c2e670e4b52fea258b6a1d18a68a93</div><a class="dl-btn" href="/downloads/artifacts/Oracle-0.4.19.AppImage">Download</a></div><div class="artifact"><div><h3>macOS</h3><small>DMG · arm64</small></div><div class="build">Oracle-0.4.19-arm64.dmg</div><div class="hash">sha256 7471bf35d9486338666c6bac9c1053ac4ba8b4ccef4784f1b031492f751ffed3</div><a class="dl-btn" href="/downloads/artifacts/Oracle-0.4.19-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.19.exe</div><div class="hash">sha256 5d3045b11a0f10e59e5363ce512412855817827fe9197f7c85fffc53a4367925</div><a class="dl-btn" href="/downloads/artifacts/Oracle-Setup-0.4.19.exe">Download</a></div></div><p class="platform-note"><a class="checksum" href="/downloads/SHA256SUMS.txt">SHA256SUMS.txt</a></p></section>
|
|
33
31
|
</main>
|
|
34
32
|
<footer><div class="nav-inner"><span>oracle · locals only labs</span><span>public / self-custody / local signer</span></div></footer>
|
|
35
33
|
<script>
|