@oracle-agent/oracle 0.22.16 → 0.23.0
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 +4 -30
- package/dist/bin/desk-server.mjs +14 -14
- package/dist/bin/oracle-data-mcp.mjs +1 -1
- package/dist/bin/oracle-route.mjs +1 -1
- package/dist/bin/oracle.mjs +9 -20
- package/dist/cli/commands/doctor.mjs +6 -6
- package/dist/cli/commands/swap.mjs +2 -2
- package/dist/data/desk-data.mjs +13 -13
- package/dist/index.mjs +17 -17
- package/dist/nft/index.mjs +1 -0
- package/dist/router/index.mjs +1 -1
- package/dist/router/prepare-bridge.mjs +1 -1
- package/package.json +3 -3
- package/dist/cli/commands/arm.mjs +0 -17
- package/dist/cli/commands/revoke.mjs +0 -40
- package/dist/cli/commands/snipe.mjs +0 -39
- package/dist/cli/commands/vault.mjs +0 -29
- package/dist/local-vault/index.mjs +0 -6
package/SETUP.md
CHANGED
|
@@ -1,10 +1,8 @@
|
|
|
1
1
|
# Oracle setup
|
|
2
2
|
|
|
3
|
-
Oracle's public CLI is a standalone multichain agent.
|
|
4
|
-
research, quote, simulate, and build unsigned artifacts.
|
|
5
|
-
|
|
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
|
|
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.
|