@oracle-agent/oracle 0.24.9 → 0.24.10
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/README.md +20 -16
- package/dist/assets/skills/oracle-desk-product/SKILL.md +3 -3
- package/dist/bin/desk-server.mjs +49 -49
- package/dist/bin/oracle-data-mcp.mjs +2 -2
- package/dist/bin/oracle-public-server.mjs +22 -22
- package/dist/bin/oracle-route.mjs +1 -1
- package/dist/bin/oracle-scan.mjs +1 -1
- package/dist/bin/oracle-upgrade.mjs +9 -9
- package/dist/bin/oracle.mjs +6 -6
- package/dist/cli/commands/chat.mjs +84 -84
- package/dist/cli/commands/doctor.mjs +4 -4
- package/dist/cli/commands/model.mjs +89 -89
- package/dist/cli/commands/receipt.mjs +3 -3
- package/dist/cli/commands/sign.mjs +11 -11
- package/dist/cli/commands/signer.mjs +13 -11
- package/dist/cli/commands/swap.mjs +1 -1
- package/dist/cli/commands/venues.mjs +2 -2
- package/dist/data/desk-data.mjs +41 -41
- package/dist/index.mjs +56 -56
- package/dist/local-signer/index.mjs +3 -1
- package/dist/scanner/index.mjs +2 -2
- package/package.json +2 -1
- package/public/oracle-splash/downloads/index.html +3 -3
- package/public/oracle-splash/index.html +3 -3
package/README.md
CHANGED
|
@@ -96,15 +96,16 @@ decides what may even be asked.
|
|
|
96
96
|
|
|
97
97
|
Three properties define it:
|
|
98
98
|
|
|
99
|
-
1. **Self-custody by default.** Hosted
|
|
100
|
-
private key.
|
|
101
|
-
wallet signs them.
|
|
102
|
-
encrypted local vault and
|
|
103
|
-
2. **Bound grants.** A grant is a signed, scoped
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
99
|
+
1. **Self-custody by default.** Hosted/keyless Oracle never accepts your
|
|
100
|
+
private key. Those surfaces build unsigned transactions and typed-data
|
|
101
|
+
intents; your wallet signs them. A self-host install may import a key into
|
|
102
|
+
the encrypted local vault and arm execution through `oracle signer`.
|
|
103
|
+
2. **Bound grants.** A grant is a signed, scoped permission: max value,
|
|
104
|
+
chain, venue, destination allowlist, plus either a TTL or an explicit trigger
|
|
105
|
+
condition such as `mint-opens`. Oracle canonicalizes it, renders it for
|
|
106
|
+
review, and refuses to prepare anything outside it. Runtime enforcement is
|
|
107
|
+
the wallet's or smart account's job, or the optional local signer's sealed
|
|
108
|
+
policy when that signer is explicitly enabled.
|
|
108
109
|
3. **Receipts or it didn't happen.** A claim without a transaction hash, a
|
|
109
110
|
receipt is not a result. If a transport cannot verify a balance delta, the receipt must say `balanceDeltaVerified: false`.
|
|
110
111
|
|
|
@@ -151,8 +152,9 @@ Three planes, and the boundary between them is mechanically enforced:
|
|
|
151
152
|
be asked to do.
|
|
152
153
|
- **Exec plane** (self-hosted, optional) — signing and broadcast live only in an
|
|
153
154
|
explicitly initialized loopback local signer using the user's keys, or in
|
|
154
|
-
separately operated owner infrastructure. Hosted/
|
|
155
|
-
signer. The local-signer module ships
|
|
155
|
+
separately operated owner infrastructure. Hosted/keyless Oracle has no active
|
|
156
|
+
signer. The local-signer module ships policy-bound and grants no holder
|
|
157
|
+
privilege.
|
|
156
158
|
|
|
157
159
|
`test/custody-boundary.test.mjs` walks the import graph and fails if any public
|
|
158
160
|
module reaches wallet key material or a house signer. The split is a test, not a
|
|
@@ -302,8 +304,9 @@ npm test
|
|
|
302
304
|
owner-local source lane.** The short version:
|
|
303
305
|
|
|
304
306
|
- Reads and quotes need **no keys**.
|
|
305
|
-
- Hosted/
|
|
306
|
-
- User wallets authorize prepared actions outside the public data plane
|
|
307
|
+
- Hosted/keyless Oracle exposes no cloud signer, key vault, or broadcast path.
|
|
308
|
+
- User wallets authorize prepared actions outside the public data plane, or the
|
|
309
|
+
self-host local signer executes them under local policy.
|
|
307
310
|
- The npm package includes an optional self-hosted loopback signer for the user's
|
|
308
311
|
own keys. It stays inert until local initialization and sealed policy setup.
|
|
309
312
|
Private Administrator modules remain separate and are not published on npm.
|
|
@@ -316,7 +319,8 @@ owner-local source lane.** The short version:
|
|
|
316
319
|
|
|
317
320
|
Oracle keeps capability and authorization separate:
|
|
318
321
|
|
|
319
|
-
- Public Oracle reads, quotes, simulates, and prepares
|
|
322
|
+
- Public Oracle reads, quotes, simulates, and prepares artifacts. Self-host
|
|
323
|
+
installs can execute supported artifacts through the local signer.
|
|
320
324
|
- **Path A:** owner/main, browser, smart-account, hardware, or protocol-native
|
|
321
325
|
wallets sign the prepared artifact. This is the default self-custody path.
|
|
322
326
|
- **Path B:** the optional public local signer may sign on the same host after
|
|
@@ -537,8 +541,8 @@ oracle-data-mcp
|
|
|
537
541
|
|
|
538
542
|
## Security
|
|
539
543
|
|
|
540
|
-
- Hosted/
|
|
541
|
-
|
|
544
|
+
- Hosted/keyless Oracle cannot hold keys. Self-host imports write only to the
|
|
545
|
+
local encrypted vault.
|
|
542
546
|
- The router can propose, simulate, explain, and draft. It cannot authorize.
|
|
543
547
|
- Public default modules may not import house-signer or executor code
|
|
544
548
|
(enforced by test). The optional `./local-signer` export is the self-host path.
|
|
@@ -97,9 +97,9 @@ does not prove npm users receive it. A locally hosted model/data/policy loop doe
|
|
|
97
97
|
a bundled signer. A merged feature is not public until the npm artifact containing it is
|
|
98
98
|
published and inspected.
|
|
99
99
|
|
|
100
|
-
**Candidate release in this source tree:** public package `@oracle-agent/oracle@0.24.
|
|
101
|
-
ships the
|
|
102
|
-
Oracle
|
|
100
|
+
**Candidate release in this source tree:** public package `@oracle-agent/oracle@0.24.10`
|
|
101
|
+
ships the encrypted local vault + short-lived loopback signer. Hosted/keyless
|
|
102
|
+
Oracle cannot hold keys or move funds. Self-host after `oracle sign init|import` is **auto-armed**
|
|
103
103
|
for user-initiated actions. Public still charges the disclosed fee card; Administrator
|
|
104
104
|
(`@oracle-agent/agent`, never on npm) stays zero-fee with DEMI's keys.
|
|
105
105
|
|