zk-agent-cli 0.1.0-beta.5 → 0.1.0-beta.7
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
CHANGED
|
@@ -72,14 +72,19 @@ zk-agent setup
|
|
|
72
72
|
zk-agent next
|
|
73
73
|
zk-agent wallet create --await-local
|
|
74
74
|
zk-agent next
|
|
75
|
-
zk-agent workflow
|
|
75
|
+
zk-agent workflow pay --wallet main --to <address> --amount <amount>
|
|
76
76
|
```
|
|
77
77
|
|
|
78
|
-
If a wallet already exists
|
|
78
|
+
If a wallet already exists, inspect the blocker first. Use `wallet reapprove`
|
|
79
|
+
when approval is missing or expired, then return to `zk-agent next`. Use
|
|
80
|
+
`wallet signer attach` when approval is still present but the local execution
|
|
81
|
+
signer is missing:
|
|
79
82
|
|
|
80
83
|
```bash
|
|
81
84
|
zk-agent wallet reapprove --name main --await-local
|
|
82
85
|
zk-agent next
|
|
86
|
+
zk-agent wallet signer attach --name main --private-key <hex>
|
|
87
|
+
zk-agent next
|
|
83
88
|
```
|
|
84
89
|
|
|
85
90
|
Only fund when the CLI says funding is actually required:
|
|
@@ -88,6 +93,22 @@ Only fund when the CLI says funding is actually required:
|
|
|
88
93
|
zk-agent workflow fund --wallet main --amount <amount> --execute
|
|
89
94
|
```
|
|
90
95
|
|
|
96
|
+
Current flagship AA native-pay path:
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
zk-agent workflow pay --wallet main --to <address> --amount <amount>
|
|
100
|
+
zk-agent workflow pay --wallet main --to <address> --amount <amount> --paymaster-mode sponsored
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
Use a `sed-lite` wallet for the default AA acceptance path. Keep
|
|
104
|
+
`daily-spend-limit` for profile-specific policy experiments, not as the main
|
|
105
|
+
operator baseline.
|
|
106
|
+
|
|
107
|
+
`workflow pay` fixes the workflow intent to `send-native`, persists a
|
|
108
|
+
checkpoint, executes immediately when ready, reopens a missing writable session
|
|
109
|
+
through the intent-scoped approval path, and defaults to the validated
|
|
110
|
+
approval-based paymaster mode unless you override it.
|
|
111
|
+
|
|
91
112
|
## Remote Approval
|
|
92
113
|
|
|
93
114
|
Shortest relay-backed path in one terminal process:
|
|
@@ -97,12 +118,23 @@ zk-agent relay inspect --relay-url <relay-url>
|
|
|
97
118
|
zk-agent wallet create --relay-url <relay-url> --wait-relay --prompt-code
|
|
98
119
|
```
|
|
99
120
|
|
|
100
|
-
If the wallet already exists and
|
|
121
|
+
If the wallet already exists and approval metadata needs to be refreshed, use:
|
|
101
122
|
|
|
102
123
|
```bash
|
|
103
124
|
zk-agent wallet reapprove --name main --relay-url <relay-url> --wait-relay --prompt-code
|
|
104
125
|
```
|
|
105
126
|
|
|
127
|
+
Treat that hosted path as the fallback when the browser is not colocated with
|
|
128
|
+
the terminal; keep the local `--await-local` path as the default baseline.
|
|
129
|
+
|
|
130
|
+
If approval is still present and only the local execution signer is missing,
|
|
131
|
+
repair that locally instead of forcing a new approval round-trip:
|
|
132
|
+
|
|
133
|
+
```bash
|
|
134
|
+
zk-agent wallet signer attach --name main --private-key <hex>
|
|
135
|
+
zk-agent next
|
|
136
|
+
```
|
|
137
|
+
|
|
106
138
|
Local relay prototype path:
|
|
107
139
|
|
|
108
140
|
```bash
|
|
@@ -167,7 +199,10 @@ Connector callback never arrives:
|
|
|
167
199
|
|
|
168
200
|
CLI says the wallet is missing a writable session:
|
|
169
201
|
|
|
170
|
-
-
|
|
202
|
+
- inspect `zk-agent wallet status --name <wallet>`
|
|
203
|
+
- if approval is missing, run `zk-agent wallet reapprove --name <wallet> --await-local`
|
|
204
|
+
- if approval is present but the local signer is missing, run
|
|
205
|
+
`zk-agent wallet signer attach --name <wallet> --private-key <hex>`
|
|
171
206
|
- then rerun `zk-agent next` or the blocked workflow command
|
|
172
207
|
|
|
173
208
|
Workflow stops on funding:
|