@agentlayer.tech/wallet 0.1.8 → 0.1.10
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 +5 -5
- package/RELEASING.md +143 -144
- package/agent-wallet/pyproject.toml +1 -1
- package/package.json +2 -5
package/README.md
CHANGED
|
@@ -49,7 +49,7 @@ Or install the CLI globally first:
|
|
|
49
49
|
|
|
50
50
|
```bash
|
|
51
51
|
npm install -g @agentlayer.tech/wallet
|
|
52
|
-
|
|
52
|
+
wallet install --yes
|
|
53
53
|
```
|
|
54
54
|
|
|
55
55
|
The npm CLI runs the same bundled installer, but uses a versioned runtime layout:
|
|
@@ -64,10 +64,10 @@ The npm CLI runs the same bundled installer, but uses a versioned runtime layout
|
|
|
64
64
|
Useful npm CLI commands:
|
|
65
65
|
|
|
66
66
|
```bash
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
67
|
+
wallet status
|
|
68
|
+
wallet doctor
|
|
69
|
+
wallet update --yes
|
|
70
|
+
wallet rollback
|
|
71
71
|
```
|
|
72
72
|
|
|
73
73
|
Install from a local clone:
|
package/RELEASING.md
CHANGED
|
@@ -1,217 +1,216 @@
|
|
|
1
1
|
# Releasing
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
The production installer is published as:
|
|
3
|
+
This repo publishes the npm installer as:
|
|
6
4
|
|
|
7
5
|
```text
|
|
8
6
|
@agentlayer.tech/wallet
|
|
9
7
|
```
|
|
10
8
|
|
|
11
|
-
|
|
9
|
+
The public install command is:
|
|
12
10
|
|
|
13
11
|
```bash
|
|
14
12
|
npx @agentlayer.tech/wallet install --yes
|
|
15
13
|
```
|
|
16
14
|
|
|
17
|
-
|
|
18
|
-
state such as `node_modules/`, `.venv/`, `__pycache__/`, wallet files, or
|
|
19
|
-
OpenClaw secrets.
|
|
15
|
+
## When npm Publishes
|
|
20
16
|
|
|
21
|
-
|
|
17
|
+
Normal commits and pushes do not publish new npm versions. They only run the
|
|
18
|
+
GitHub Actions verification job.
|
|
22
19
|
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
npm run check:release-version
|
|
26
|
-
python3 agent-wallet/tests/smoke_npm_installer.py
|
|
27
|
-
python3 agent-wallet/tests/smoke_install_agent_wallet.py
|
|
28
|
-
npm --cache /tmp/npm-cache pack --dry-run
|
|
29
|
-
```
|
|
20
|
+
An npm publish happens only when you push a git tag that starts with `v`, for
|
|
21
|
+
example `v0.1.10`.
|
|
30
22
|
|
|
31
|
-
The
|
|
32
|
-
|
|
33
|
-
|
|
23
|
+
The same tag workflow also creates a GitHub Release on the repository's
|
|
24
|
+
Releases page after npm publish succeeds.
|
|
25
|
+
|
|
26
|
+
The tag version must match both source version files:
|
|
34
27
|
|
|
35
28
|
```text
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
Repository: Agent-Layer
|
|
39
|
-
Workflow filename: npm-installer.yml
|
|
29
|
+
package.json
|
|
30
|
+
agent-wallet/pyproject.toml
|
|
40
31
|
```
|
|
41
32
|
|
|
42
|
-
|
|
43
|
-
repository URL, for example `https://github.com/lopushok9/Agent-Layer.git`.
|
|
44
|
-
Do not use the `git+https://` npm shorthand for Trusted Publishing releases.
|
|
33
|
+
If those versions do not match the tag, the workflow fails before publishing.
|
|
45
34
|
|
|
46
|
-
|
|
47
|
-
Token-based publishes can fail with `EOTP` when package or account policy
|
|
48
|
-
requires two-factor authentication.
|
|
35
|
+
## Stable Release
|
|
49
36
|
|
|
50
|
-
|
|
51
|
-
`package.json` and `agent-wallet/pyproject.toml`:
|
|
37
|
+
Use a stable release when users should get it from the default install command.
|
|
52
38
|
|
|
53
|
-
|
|
54
|
-
git tag v0.1.6
|
|
55
|
-
git push origin v0.1.6
|
|
56
|
-
```
|
|
39
|
+
Example: publish `0.1.10` as npm `latest`.
|
|
57
40
|
|
|
58
|
-
|
|
41
|
+
1. Update `package.json`:
|
|
59
42
|
|
|
60
|
-
```
|
|
61
|
-
|
|
43
|
+
```json
|
|
44
|
+
"version": "0.1.10"
|
|
62
45
|
```
|
|
63
46
|
|
|
64
|
-
|
|
65
|
-
then push the matching tag. The workflow publishes those with npm tag `beta`:
|
|
47
|
+
2. Update `agent-wallet/pyproject.toml`:
|
|
66
48
|
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
git push origin v0.1.7-beta.1
|
|
49
|
+
```toml
|
|
50
|
+
version = "0.1.10"
|
|
70
51
|
```
|
|
71
52
|
|
|
72
|
-
|
|
53
|
+
3. Run local checks:
|
|
73
54
|
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
|
|
55
|
+
```bash
|
|
56
|
+
npm run check
|
|
57
|
+
GITHUB_REF_NAME=v0.1.10 npm run check:release-version
|
|
58
|
+
python3 agent-wallet/tests/smoke_npm_installer.py
|
|
59
|
+
python3 agent-wallet/tests/smoke_install_agent_wallet.py
|
|
60
|
+
npm --cache /tmp/npm-cache pack --dry-run
|
|
77
61
|
```
|
|
78
62
|
|
|
79
|
-
|
|
80
|
-
switches `current` back to the recorded previous runtime or to a specific
|
|
81
|
-
installed version.
|
|
82
|
-
|
|
83
|
-
This repository's `v0.1.0-beta.2` public release should be framed around six repo-owned deliverables:
|
|
63
|
+
4. Commit the version change:
|
|
84
64
|
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
4. `wdk-btc-wallet/` - the BTC-only wallet service built on Tether WDK
|
|
89
|
-
5. `provider-gateway/` - the shared non-custodial provider access layer
|
|
90
|
-
6. `docs/` - the Starlight-based documentation site
|
|
91
|
-
|
|
92
|
-
### Release title
|
|
93
|
-
|
|
94
|
-
```text
|
|
95
|
-
AgentLayer Beta v0.1.0-beta.2
|
|
65
|
+
```bash
|
|
66
|
+
git add package.json agent-wallet/pyproject.toml
|
|
67
|
+
git commit -m "Release npm installer 0.1.10"
|
|
96
68
|
```
|
|
97
69
|
|
|
98
|
-
|
|
70
|
+
5. Create and push the release tag:
|
|
99
71
|
|
|
100
|
-
```
|
|
101
|
-
|
|
72
|
+
```bash
|
|
73
|
+
git tag -a v0.1.10 -m "v0.1.10"
|
|
74
|
+
git push origin main
|
|
75
|
+
git push origin v0.1.10
|
|
76
|
+
```
|
|
102
77
|
|
|
103
|
-
|
|
78
|
+
6. Check npm after GitHub Actions finishes:
|
|
104
79
|
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
- `provider-gateway/` - shared provider access for hosted Solana RPC defaults, Bags, and Jupiter Earn
|
|
110
|
-
- `docs/` - documentation app for setup, architecture, and capability reference
|
|
80
|
+
```bash
|
|
81
|
+
npm view @agentlayer.tech/wallet dist-tags
|
|
82
|
+
npm view @agentlayer.tech/wallet@latest version
|
|
83
|
+
```
|
|
111
84
|
|
|
112
|
-
|
|
85
|
+
Expected result:
|
|
113
86
|
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
- Keeps the MCP server, wallet backend, and OpenClaw extension bridge as the core beta foundation
|
|
87
|
+
```text
|
|
88
|
+
latest: 0.1.10
|
|
89
|
+
```
|
|
118
90
|
|
|
119
|
-
|
|
91
|
+
The GitHub Releases page should also contain a new release named `v0.1.10`.
|
|
120
92
|
|
|
121
|
-
|
|
93
|
+
## Beta Release
|
|
122
94
|
|
|
123
|
-
|
|
95
|
+
Use a beta release when you want to test npm publishing without changing the
|
|
96
|
+
default user install command.
|
|
124
97
|
|
|
125
|
-
|
|
126
|
-
- Local encrypted wallet vault, localhost-only HTTP surface, and local bearer-token auth
|
|
127
|
-
- Covers Bitcoin network selection, wallet lifecycle, balances, transfers, fees, and spendability
|
|
98
|
+
Example: publish `0.1.11-beta.1` as npm `beta`.
|
|
128
99
|
|
|
129
|
-
|
|
100
|
+
1. Set both version files to the beta version:
|
|
130
101
|
|
|
131
|
-
|
|
132
|
-
-
|
|
133
|
-
|
|
102
|
+
```json
|
|
103
|
+
"version": "0.1.11-beta.1"
|
|
104
|
+
```
|
|
134
105
|
|
|
135
|
-
|
|
106
|
+
```toml
|
|
107
|
+
version = "0.1.11-beta.1"
|
|
108
|
+
```
|
|
136
109
|
|
|
137
|
-
|
|
138
|
-
- Covers getting started, infrastructure boundaries, wallet architecture, and capabilities
|
|
139
|
-
- Gives the beta stack a repo-owned documentation surface for onboarding and review
|
|
110
|
+
2. Run checks:
|
|
140
111
|
|
|
141
|
-
|
|
112
|
+
```bash
|
|
113
|
+
npm run check
|
|
114
|
+
GITHUB_REF_NAME=v0.1.11-beta.1 npm run check:release-version
|
|
115
|
+
npm --cache /tmp/npm-cache pack --dry-run
|
|
116
|
+
```
|
|
142
117
|
|
|
143
|
-
|
|
118
|
+
3. Commit, tag, and push:
|
|
144
119
|
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
120
|
+
```bash
|
|
121
|
+
git add package.json agent-wallet/pyproject.toml
|
|
122
|
+
git commit -m "Release npm installer 0.1.11-beta.1"
|
|
123
|
+
git tag -a v0.1.11-beta.1 -m "v0.1.11-beta.1"
|
|
124
|
+
git push origin main
|
|
125
|
+
git push origin v0.1.11-beta.1
|
|
126
|
+
```
|
|
148
127
|
|
|
149
|
-
|
|
128
|
+
4. Test the beta package:
|
|
150
129
|
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
130
|
+
```bash
|
|
131
|
+
npx @agentlayer.tech/wallet@beta --version
|
|
132
|
+
npx @agentlayer.tech/wallet@beta doctor
|
|
133
|
+
```
|
|
154
134
|
|
|
155
|
-
|
|
135
|
+
The GitHub Releases page should contain a new prerelease named
|
|
136
|
+
`v0.1.11-beta.1`.
|
|
156
137
|
|
|
157
|
-
|
|
158
|
-
- Repo-tracked plugin manifest and config schema
|
|
159
|
-
- Keeps wallet policy and execution logic in Python while exposing a small operational tool surface to OpenClaw
|
|
138
|
+
## What Ships
|
|
160
139
|
|
|
161
|
-
|
|
140
|
+
The npm package is intentionally limited to the wallet installer runtime:
|
|
162
141
|
|
|
163
|
-
|
|
164
|
-
-
|
|
165
|
-
-
|
|
142
|
+
```text
|
|
143
|
+
.openclaw/extensions/agent-wallet
|
|
144
|
+
agent-wallet
|
|
145
|
+
wdk-btc-wallet
|
|
146
|
+
wdk-evm-wallet
|
|
147
|
+
bin
|
|
148
|
+
scripts
|
|
149
|
+
setup.sh
|
|
150
|
+
install-from-github.sh
|
|
151
|
+
README.md
|
|
152
|
+
CHANGELOG.md
|
|
153
|
+
RELEASING.md
|
|
154
|
+
LICENSE
|
|
166
155
|
```
|
|
167
156
|
|
|
168
|
-
|
|
157
|
+
It must not ship unrelated repo projects or generated local state:
|
|
169
158
|
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
-
|
|
173
|
-
-
|
|
174
|
-
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
159
|
+
```text
|
|
160
|
+
landing
|
|
161
|
+
solana-8004
|
|
162
|
+
provider-gateway
|
|
163
|
+
mcp-server
|
|
164
|
+
agent-a2a-gateway
|
|
165
|
+
docs
|
|
166
|
+
node_modules
|
|
167
|
+
.venv
|
|
168
|
+
__pycache__
|
|
169
|
+
.pytest_cache
|
|
170
|
+
.DS_Store
|
|
171
|
+
wallet files
|
|
172
|
+
OpenClaw secrets
|
|
173
|
+
```
|
|
179
174
|
|
|
180
|
-
|
|
181
|
-
- Wallet lifecycle, balances, fee rates, spendability, and transfer support
|
|
182
|
-
- Separate runtime from the existing Solana wallet backend
|
|
175
|
+
The package allowlist lives in `package.json` under `files`.
|
|
183
176
|
|
|
184
|
-
|
|
177
|
+
## Runtime Layout
|
|
185
178
|
|
|
186
|
-
|
|
187
|
-
- Bags launch and fees provider access
|
|
188
|
-
- Jupiter Earn provider access
|
|
179
|
+
Installer releases are copied into the user's OpenClaw home:
|
|
189
180
|
|
|
190
|
-
|
|
181
|
+
```text
|
|
182
|
+
~/.openclaw/agent-wallet-runtime/releases/<version>
|
|
183
|
+
~/.openclaw/agent-wallet-runtime/current
|
|
184
|
+
```
|
|
191
185
|
|
|
192
|
-
|
|
193
|
-
- Covers infrastructure and wallet capability docs
|
|
194
|
-
- Repo-owned docs surface for the public beta
|
|
186
|
+
The CLI switches `current` only after a successful install or update.
|
|
195
187
|
|
|
196
|
-
|
|
188
|
+
Rollback switches `current` back to the previous runtime or to a specific
|
|
189
|
+
installed version:
|
|
197
190
|
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
191
|
+
```bash
|
|
192
|
+
npx @agentlayer.tech/wallet rollback
|
|
193
|
+
```
|
|
201
194
|
|
|
202
|
-
|
|
195
|
+
## GitHub And npm Setup
|
|
203
196
|
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
- Encrypted local secret handling and explicit approval gating for risky actions
|
|
197
|
+
Publishing uses npm Trusted Publishing through GitHub Actions. The npm package
|
|
198
|
+
must have this trusted publisher configured:
|
|
207
199
|
|
|
208
|
-
|
|
200
|
+
```text
|
|
201
|
+
Provider: GitHub Actions
|
|
202
|
+
Organization or user: lopushok9
|
|
203
|
+
Repository: Agent-Layer
|
|
204
|
+
Workflow filename: npm-installer.yml
|
|
205
|
+
Environment name: empty
|
|
206
|
+
```
|
|
209
207
|
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
- Repo-local extension package for OpenClaw integration
|
|
208
|
+
The `repository.url` field in `package.json` must exactly match the GitHub
|
|
209
|
+
repository URL:
|
|
213
210
|
|
|
214
|
-
|
|
211
|
+
```text
|
|
212
|
+
https://github.com/lopushok9/Agent-Layer.git
|
|
213
|
+
```
|
|
215
214
|
|
|
216
|
-
|
|
217
|
-
|
|
215
|
+
Do not use `NPM_TOKEN` unless Trusted Publishing is unavailable. Token-based
|
|
216
|
+
publishes can fail with `EOTP` when npm requires two-factor authentication.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@agentlayer.tech/wallet",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.10",
|
|
4
4
|
"description": "NPM installer for the OpenClaw Agent Wallet local runtime.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"repository": {
|
|
@@ -11,10 +11,7 @@
|
|
|
11
11
|
"url": "https://github.com/lopushok9/Agent-Layer/issues"
|
|
12
12
|
},
|
|
13
13
|
"homepage": "https://github.com/lopushok9/Agent-Layer#readme",
|
|
14
|
-
"bin":
|
|
15
|
-
"wallet": "./bin/openclaw-agent-wallet.mjs",
|
|
16
|
-
"openclaw-agent-wallet": "./bin/openclaw-agent-wallet.mjs"
|
|
17
|
-
},
|
|
14
|
+
"bin": "./bin/openclaw-agent-wallet.mjs",
|
|
18
15
|
"scripts": {
|
|
19
16
|
"check": "node --check bin/openclaw-agent-wallet.mjs",
|
|
20
17
|
"check:release-version": "node scripts/check_release_version.mjs",
|