@darwin.finance/cli 1.2.0 → 1.3.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/README.md +25 -0
- package/dist/darwin.js +5144 -659
- package/npm-shrinkwrap.json +2 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -62,6 +62,31 @@ What each command does is documented by Darwin itself: the command list is fetch
|
|
|
62
62
|
logged in to (`darwin help`, `darwin <command> --help`, `darwin help --json`), so new commands appear
|
|
63
63
|
without a new release of this program. The API reference: <https://darwin.finance/agents/docs>.
|
|
64
64
|
|
|
65
|
+
### Read-only (1.3)
|
|
66
|
+
|
|
67
|
+
```sh
|
|
68
|
+
darwin login --read-only # connect your whole Darwin account, read-only (approve on Darwin)
|
|
69
|
+
darwin account portfolio # also: perps, earn, agents, watchlists, alerts
|
|
70
|
+
darwin agents # the agents you can read
|
|
71
|
+
darwin balances --agent <name> # an agent's own reads take --agent (or: darwin profile set-agent)
|
|
72
|
+
darwin search sol · darwin chart sol · darwin market-status
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
A read-only connection holds an **account-level** API key (Darwin's Read-Only API Key) instead of an
|
|
76
|
+
agent's. It reads market data, your whole account and any agent's own account, and it **can never
|
|
77
|
+
trade**: every command that trades (`order`, `instant`, `quote`, `pause`, `perps order`, …) is refused
|
|
78
|
+
by the CLI before anything is sent, and Darwin refuses it too.
|
|
79
|
+
|
|
80
|
+
An account-level key that **trades** — for one of your Agentic Sub-Accounts or all of them — runs the
|
|
81
|
+
trading commands too, naming the sub-account with `--agent` (a key for one sub-account may leave it
|
|
82
|
+
out). Darwin converts, checks and sends them exactly as for an agent's key, and `darwin retry` /
|
|
83
|
+
`darwin cancel` work the same; every order runs under that sub-account's own limits.
|
|
84
|
+
|
|
85
|
+
An account-level key never uses the agent tool runner: its reads go to the same routes Darwin's
|
|
86
|
+
chat-app connections use, and its trades to Darwin's owner CLI door. `darwin login --with-key` /
|
|
87
|
+
`--key-file` (version 2 files) accept an account-level key; add `--read-only` to save it only if Darwin
|
|
88
|
+
says it's read-only. `darwin logout --revoke` revokes an account-level key too.
|
|
89
|
+
|
|
65
90
|
### Trading (1.1)
|
|
66
91
|
|
|
67
92
|
```sh
|