@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 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 and default Oracle never accept your
100
- private key. They build unsigned transactions and typed-data intents; your
101
- wallet signs them. An explicit self-host setup may import a key into the
102
- encrypted local vault and sign through `oracle signer`.
103
- 2. **Bound grants.** A grant is a signed, scoped, expiring permission: max
104
- value, chain, venue, destination allowlist, TTL. Oracle canonicalizes it,
105
- renders it for review, and refuses to prepare anything outside it. Runtime
106
- enforcement is the wallet's or smart account's job, or the optional local
107
- signer's sealed policy when that signer is explicitly enabled.
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/default Oracle has no active
155
- signer. The local-signer module ships inert and grants no holder privilege.
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/default Oracle exposes no active signer, key vault, or broadcast path.
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 unsigned artifacts.
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/default Oracle never receives private keys. An explicit self-host
541
- import writes only to the local encrypted vault.
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.9`
101
- ships the optional encrypted local vault + short-lived loopback signer. Hosted/default
102
- Oracle stays prepare-only. Self-host after `oracle sign init|import` is **auto-armed**
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