zk-agent-cli 0.1.0-beta.5 → 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 auto --wallet main --intent <intent> [goal flags] --create-checkpoint --execute-when-ready
75
+ zk-agent workflow pay --wallet main --to <address> --amount <amount>
76
76
  ```
77
77
 
78
- If a wallet already exists and only the writable session is stale, use:
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,6 +91,22 @@ 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
112
  Shortest relay-backed path in one terminal process:
@@ -97,12 +116,19 @@ zk-agent relay inspect --relay-url <relay-url>
97
116
  zk-agent wallet create --relay-url <relay-url> --wait-relay --prompt-code
98
117
  ```
99
118
 
100
- If the wallet already exists and only the writable session is stale, use:
119
+ If the wallet already exists and approval metadata needs to be refreshed, use:
101
120
 
102
121
  ```bash
103
122
  zk-agent wallet reapprove --name main --relay-url <relay-url> --wait-relay --prompt-code
104
123
  ```
105
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
+
106
132
  Local relay prototype path:
107
133
 
108
134
  ```bash
@@ -167,7 +193,10 @@ Connector callback never arrives:
167
193
 
168
194
  CLI says the wallet is missing a writable session:
169
195
 
170
- - run `zk-agent wallet reapprove --name <wallet> --await-local`
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>`
171
200
  - then rerun `zk-agent next` or the blocked workflow command
172
201
 
173
202
  Workflow stops on funding: