@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.
Files changed (2) hide show
  1. package/README.md +11 -3
  2. 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.0
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.0 agent-wallet --help
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
- The owner reviews the approval link, authorizes the grant, and funds the agent's gas through the approval UI. The CLI does not activate the owner's account or read the owner's key. Payments require a stable payment ID; recover an uncertain submission by reusing that ID and its saved journal. See the [CLI reference](https://github.com/stablelabs/agentic.stable.xyz/blob/main/docs/cli.md) for the command surface, JSON output, permissions, and recovery workflow.
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.0",
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.0",
21
+ "@stablechain/agent-wallet-sdk": "0.1.2",
22
22
  "viem": "^2.38.0"
23
23
  },
24
24
  "devDependencies": {