@oracle-agent/oracle 0.22.16 → 0.23.1

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/SETUP.md CHANGED
@@ -1,10 +1,8 @@
1
1
  # Oracle setup
2
2
 
3
- Oracle's public CLI is a standalone multichain agent. By default it can read,
4
- research, quote, simulate, and build unsigned artifacts. Anyone can also self-host
5
- Oracle on their own machine, import their own key into an encrypted local vault,
6
- arm capped policy, and sign locally. It does not need Hermes and Oracle's hosted
7
- public HTTP plane never receives private keys or broadcasts transactions.
3
+ Oracle's public CLI is a standalone, prepare-only multichain agent. It can read,
4
+ research, quote, simulate, and build unsigned artifacts. It does not need Hermes,
5
+ it does not accept wallet private keys, and it does not broadcast transactions.
8
6
 
9
7
  The owner-operated signer/executor is private infrastructure. It is not published
10
8
  on npm and is not part of public onboarding.
@@ -14,8 +12,7 @@ on npm and is not part of public onboarding.
14
12
  - Node.js `20.19.0` or newer
15
13
  - npm
16
14
  - A supported model login or API key for chat
17
- - A user-controlled wallet for manual signing, or an optional local encrypted
18
- vault when self-hosting local execution
15
+ - A user-controlled wallet only when reviewing and signing a prepared artifact
19
16
 
20
17
  Linux, Windows, and macOS apps are in beta.
21
18
 
@@ -324,26 +321,3 @@ as a workaround.
324
321
  - [Buzz integration](docs/buzz-integration.md)
325
322
  - [Architecture](docs/architecture.md)
326
323
  - [Security policy](SECURITY.md)
327
-
328
- ## Local self-custody vault
329
-
330
- Anyone can host Oracle on their own machine and sign locally:
331
-
332
- ```bash
333
- oracle vault import --key-file ./oracle-key.txt --pass-env ORACLE_LOCAL_VAULT_PASS
334
- oracle vault unlock --pass-env ORACLE_LOCAL_VAULT_PASS
335
- oracle arm --max 0.05 --chain base --ttl-min 30 --destination 0x2626664c2603336e57b271c5c0b26f421741e481 --spender 0x000000000022d473030f116ddee9f6b43ac78ba3 --selector 0x095ea7b3
336
- oracle snipe 0x1111111111111111111111111111111111111111 --chain base --execute --pass-env ORACLE_LOCAL_VAULT_PASS
337
- oracle revoke emergency --type nft --collection 0x3333333333333333333333333333333333333333 --operator 0x9999999999999999999999999999999999999999 --chain base
338
- oracle arm --off
339
- oracle vault lock
340
- ```
341
-
342
- Keys stay encrypted under `~/.config/oracle/keys/`. Unlock writes only non-secret
343
- session metadata; signing decrypts from the passphrase-protected vault in the
344
- local process. `oracle arm` stores local chain, destination, spender/operator,
345
- selector, and spend caps; the signer checks them before any transaction is sent.
346
- Emergency revoke/cancel can prepare same-nonce cancel transactions and approval
347
- revokes, but it is a race tool, not a guarantee against mined atomic drains. The
348
- public HTTP plane never receives key material. Default CLI remains prepare-only
349
- until you unlock + arm.