zk-agent-cli 0.1.0-beta.4 → 0.1.0-beta.6
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,13 +72,16 @@ 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. Use `wallet signer attach` when approval
|
|
80
|
+
is still present but the local execution signer is missing:
|
|
79
81
|
|
|
80
82
|
```bash
|
|
81
83
|
zk-agent wallet reapprove --name main --await-local
|
|
84
|
+
zk-agent wallet signer attach --name main --private-key <hex>
|
|
82
85
|
zk-agent next
|
|
83
86
|
```
|
|
84
87
|
|
|
@@ -88,16 +91,44 @@ Only fund when the CLI says funding is actually required:
|
|
|
88
91
|
zk-agent workflow fund --wallet main --amount <amount> --execute
|
|
89
92
|
```
|
|
90
93
|
|
|
94
|
+
Current flagship AA native-pay path:
|
|
95
|
+
|
|
96
|
+
```bash
|
|
97
|
+
zk-agent workflow pay --wallet main --to <address> --amount <amount>
|
|
98
|
+
zk-agent workflow pay --wallet main --to <address> --amount <amount> --paymaster-mode sponsored
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
Use a `sed-lite` wallet for the default AA acceptance path. Keep
|
|
102
|
+
`daily-spend-limit` for profile-specific policy experiments, not as the main
|
|
103
|
+
operator baseline.
|
|
104
|
+
|
|
105
|
+
`workflow pay` fixes the workflow intent to `send-native`, persists a
|
|
106
|
+
checkpoint, executes immediately when ready, reopens a missing writable session
|
|
107
|
+
through the intent-scoped approval path, and defaults to the validated
|
|
108
|
+
approval-based paymaster mode unless you override it.
|
|
109
|
+
|
|
91
110
|
## Remote Approval
|
|
92
111
|
|
|
93
|
-
Shortest relay-backed path in one
|
|
112
|
+
Shortest relay-backed path in one terminal process:
|
|
94
113
|
|
|
95
114
|
```bash
|
|
96
115
|
zk-agent relay inspect --relay-url <relay-url>
|
|
97
116
|
zk-agent wallet create --relay-url <relay-url> --wait-relay --prompt-code
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
If the wallet already exists and approval metadata needs to be refreshed, use:
|
|
120
|
+
|
|
121
|
+
```bash
|
|
98
122
|
zk-agent wallet reapprove --name main --relay-url <relay-url> --wait-relay --prompt-code
|
|
99
123
|
```
|
|
100
124
|
|
|
125
|
+
If approval is still present and only the local execution signer is missing,
|
|
126
|
+
repair that locally instead of forcing a new approval round-trip:
|
|
127
|
+
|
|
128
|
+
```bash
|
|
129
|
+
zk-agent wallet signer attach --name main --private-key <hex>
|
|
130
|
+
```
|
|
131
|
+
|
|
101
132
|
Local relay prototype path:
|
|
102
133
|
|
|
103
134
|
```bash
|
|
@@ -128,7 +159,7 @@ Common files created by the default path:
|
|
|
128
159
|
- `config.json`
|
|
129
160
|
- `wallets/*.json`
|
|
130
161
|
- `requests/*.json`
|
|
131
|
-
- `
|
|
162
|
+
- `workflows/*.json`
|
|
132
163
|
|
|
133
164
|
## Smart-Account Profiles
|
|
134
165
|
|
|
@@ -162,7 +193,10 @@ Connector callback never arrives:
|
|
|
162
193
|
|
|
163
194
|
CLI says the wallet is missing a writable session:
|
|
164
195
|
|
|
165
|
-
-
|
|
196
|
+
- inspect `zk-agent wallet status --name <wallet>`
|
|
197
|
+
- if approval is missing, run `zk-agent wallet reapprove --name <wallet> --await-local`
|
|
198
|
+
- if approval is present but the local signer is missing, run
|
|
199
|
+
`zk-agent wallet signer attach --name <wallet> --private-key <hex>`
|
|
166
200
|
- then rerun `zk-agent next` or the blocked workflow command
|
|
167
201
|
|
|
168
202
|
Workflow stops on funding:
|