@towns-labs/wallet 7.0.0 → 7.1.0

package/README.md

@@ -172,6 +172,12 @@ Send USDC on Polygon with JSON output:
 tw account send 10 0x1111111111111111111111111111111111111111 --chain polygon --env prod --json
 ```
 
+Send using a specific local session by name (without changing active session):
+
+```bash
+tw account send 1 0x1111111111111111111111111111111111111111 --profile agent --session worker-2
+```
+
 Local dev defaults to Anvil:
 
 ```bash
@@ -241,6 +247,8 @@ tw account send 1 0x1111111111111111111111111111111111111111 \
   --env prod --chain base --session-file ./worker-1.session.json
 ```
 
+`--session` and `--session-file` are mutually exclusive.
+
 ## Account Status
 
 Show compact readiness status:
@@ -295,6 +303,10 @@ Grant full wildcard access (explicit opt-in):
 echo "my-password" | tw session create worker-admin --profile agent --full-access --password-stdin
 ```
 
+`--full-access` is mutually exclusive with `--target`, `--selector`, `--spend-limit`, `--spend-limit-raw`, and `--spend-period`.
+Omitting both `--target` and `--selector` uses wildcard call permissions by default; you do not need to pass magic wildcard values.
+`--spend-limit` accepts human USDC amounts (for example `10` = `10 USDC`). Use `--spend-limit-raw` for base units.
+
 ## Session List
 
 List local sessions:
@@ -355,6 +367,10 @@ Rotate to an explicit new session name:
 echo "my-password" | tw session rotate --profile agent --new-name worker-3 --password-stdin
 ```
 
+`--full-access` is mutually exclusive with `--target`, `--selector`, `--spend-limit`, `--spend-limit-raw`, and `--spend-period`.
+Omitting both `--target` and `--selector` uses wildcard call permissions by default; you do not need to pass magic wildcard values.
+`--spend-limit` accepts human USDC amounts (for example `10` = `10 USDC`). Use `--spend-limit-raw` for base units.
+
 Resume interrupted rotation:
 
 ```bash
@@ -417,6 +433,12 @@ Grant spend permission for daily USDC limit:
 echo "my-password" | tw permissions grant agent-key --type spend --token USDC --spend-limit 100 --period day --profile agent --password-stdin --json
 ```
 
+For raw base units instead of human USDC amounts, use:
+
+```bash
+echo "my-password" | tw permissions grant agent-key --type spend --token USDC --spend-limit-raw 100000000 --period day --profile agent --password-stdin --json
+```
+
 ## Permissions Revoke
 
 Revoke one rule by stable rule id: