@mysten-incubation/sui-agent-pass 0.1.9 → 0.1.11

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.
@@ -83,14 +83,22 @@ the allowance back. A supply-and-withdraw or stake-and-unstake cycle costs the a
83
83
  size lending and staking limits for the cycles the agent will run, and tell the owner when they
84
84
  ask for something like "restake with a better validator".
85
85
 
86
- **Term and gas.** `days` is the agent's term, 1 to 30. `gasSui` (default 0.05) is a stipend sent
86
+ **Term and gas.** `days` is the agent's term, from 1 up to the network's `maxTermDays` in
87
+ `list_passes`. `gasSui` (default 0.05) is a stipend sent
87
88
  to the agent key, outside the rules. `gasCapSui` (default 0.1) is a separate allowance the key
88
- draws on to top up its gas, and `gasDailySui` (default a fifth of `gasCapSui`) its daily limit.
89
-
90
- **What the owner needs.** Allowances draw only from the owner's address balance, never from coin
91
- objects. The review page reads both, and the signature converts coin objects into the address
92
- balance as far as each cap (plus `gasCapSui` for SUI) needs; the converted coins stay theirs. The
93
- owner needs that much in total, address balance and coin objects together, plus `gasSui` and fees.
89
+ draws on to top up its gas, and `gasDailySui` (default a fifth of `gasCapSui`) its limit per 24
90
+ hours from the first top-up. Call it that, not a limit per UTC day like the asset limits.
91
+
92
+ **What the owner needs.** Signing moves only the agent's gas stipend and pays the fee, so that is
93
+ all the owner must hold, in SUI. The caps are limits on what the rules may draw later, not money
94
+ needed now. Allowances draw only from the owner's address balance, never from coin objects; the
95
+ signature converts the owner's coin objects into that balance as far as each cap needs and they
96
+ have them, and the converted coins stay theirs. When a cap reaches past what the owner holds,
97
+ signing still works: each action runs while the balance covers it, and swap proceeds landing
98
+ there count right away, which is how a chain like TAKE to SUI to USDC funds its later legs. Pass
99
+ `owner` to `propose_authorization` when you know the address, and tell the owner about any
100
+ `warnings` it returns before they sign. An action refused because the balance was short is not
101
+ one of the owner's rules; say so.
94
102
 
95
103
  Before you call anything, show the owner the rules you intend to propose as one short list and
96
104
  ask for a yes, unless they already stated every rule explicitly.
@@ -130,6 +138,11 @@ Start with `session_info`. It returns:
130
138
  - `directory`, `sdk` and `server`: the session directory, how to install and import the SDK,
131
139
  and this server's version (after an upgrade the client must restart the server).
132
140
 
141
+ **Key alert.** When `list_passes` or `session_info` carries `keyAlert`, the chain shows
142
+ transactions from the agent key that this machine never signed: a copy of the key is in use
143
+ elsewhere. Stop acting, tell the owner at once with the digests, and offer `revoke_pass` so they
144
+ can stop the agent from the pass page.
145
+
133
146
  **Updates.** When `server.update` is present in `list_passes` or `session_info`, a newer release
134
147
  is out. Tell the owner once per conversation, with `server.update.command` and the reminder to
135
148
  restart the agent afterwards, then carry on with the task; never run the command yourself.
@@ -177,7 +190,7 @@ enforcement. `submit` tops up your gas from the gas allowance when it runs low.
177
190
  `@mysten/sui` following the guide, sign it with `sign_transaction` and execute it yourself. Every
178
191
  spend takes the allowance object and a withdrawal input right after the pass. On this path gas is
179
192
  yours: when the key holds under 0.01 SUI, draw on the gas allowance as the guide shows. That
180
- allowance has its own cap and daily limit and never touches the asset caps.
193
+ allowance has its own cap and 24-hour limit and never touches the asset caps.
181
194
 
182
195
  ## 4. Report the state
183
196