@stablechain/agent-wallet-cli 0.1.0 → 0.1.2
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 +11 -3
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -5,30 +5,36 @@ The `agent-wallet` executable manages the local agent signer, grants, payments,
|
|
|
5
5
|
Install with Node.js 22 or newer:
|
|
6
6
|
|
|
7
7
|
```sh
|
|
8
|
-
npm install --global @stablechain/agent-wallet-cli@0.1.
|
|
8
|
+
npm install --global @stablechain/agent-wallet-cli@0.1.2
|
|
9
9
|
agent-wallet --help
|
|
10
10
|
```
|
|
11
11
|
|
|
12
12
|
Or run directly:
|
|
13
13
|
|
|
14
14
|
```sh
|
|
15
|
-
npx --yes --package=@stablechain/agent-wallet-cli@0.1.
|
|
15
|
+
npx --yes --package=@stablechain/agent-wallet-cli@0.1.2 agent-wallet --help
|
|
16
16
|
```
|
|
17
17
|
|
|
18
18
|
Each agent initializes its own signer and imports owner-provided public wallet settings. Set `WALLET_STATE_DIR` to a persistent private directory, especially in containers:
|
|
19
19
|
|
|
20
20
|
```sh
|
|
21
|
+
export WALLET_STATE_DIR="$HOME/.local/share/stable-agent-wallet"
|
|
21
22
|
agent-wallet init --json
|
|
22
23
|
agent-wallet config import --file ./wallet-config.json --json
|
|
23
24
|
agent-wallet whoami --json
|
|
24
25
|
agent-wallet grants link --recipient "$RECIPIENT" --budget 0.01 --expires-in 24h --json
|
|
25
26
|
```
|
|
26
27
|
|
|
27
|
-
|
|
28
|
+
Obtain `wallet-config.json` from the owner or operator after account activation. Import verifies the network, pinned implementation, and account delegation; it does not grant spending permission. The owner reviews the approval link, authorizes the grant, and funds the agent's gas through the approval UI.
|
|
29
|
+
|
|
30
|
+
Payments require a stable payment ID. Use `payments prepare` to save one, then `pay --payment-id ID` to submit it. Recover an uncertain submission with `payments wait ID` or `payments resume ID`, retaining the same ID and journal. State contains a plaintext signer key and signed transactions; use one private, persistent directory per signer. The CLI does not activate the owner's account or read the owner's key.
|
|
31
|
+
|
|
32
|
+
Every command supports `--json` with a versioned result envelope and symbolic errors. Check `data.status` to distinguish submission from confirmation; `doctor` returns diagnostics in `data.checks` and `data.ready`. See the [CLI reference](https://github.com/stablelabs/agentic.stable.xyz/blob/main/docs/cli.md) for commands, exit codes, public configuration, and recovery.
|
|
28
33
|
|
|
29
34
|
For repository development:
|
|
30
35
|
|
|
31
36
|
```sh
|
|
37
|
+
npm ci
|
|
32
38
|
npm run build:sdk
|
|
33
39
|
npm run build --workspace @stablechain/agent-wallet-cli
|
|
34
40
|
npm run wallet -- --help
|
|
@@ -38,3 +44,5 @@ npm run test --workspace @stablechain/agent-wallet-cli
|
|
|
38
44
|
The package compiles its own `src` into `dist`, exposes `dist/main.js` as the executable, and exports Node-only services through `@stablechain/agent-wallet-cli/agent` for the repository's compatibility scripts. It does not copy SDK source or bundle private signing state.
|
|
39
45
|
|
|
40
46
|
The public npm package includes compiled JavaScript, declarations, this README, and its manifest. The prepack hook rebuilds the package before packing or publishing. The SDK is a separate public dependency; React and the repository's build tools are not runtime dependencies.
|
|
47
|
+
|
|
48
|
+
The CLI and SDK are published together from matching version tags, using GitHub Actions trusted publishing. See the [release guide](https://github.com/stablelabs/agentic.stable.xyz/blob/main/docs/releases.md).
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@stablechain/agent-wallet-cli",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"bin": {
|
|
6
6
|
"agent-wallet": "./dist/main.js"
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
"node": ">=22"
|
|
19
19
|
},
|
|
20
20
|
"dependencies": {
|
|
21
|
-
"@stablechain/agent-wallet-sdk": "0.1.
|
|
21
|
+
"@stablechain/agent-wallet-sdk": "0.1.2",
|
|
22
22
|
"viem": "^2.38.0"
|
|
23
23
|
},
|
|
24
24
|
"devDependencies": {
|