@attocash/cli 0.2.3 → 0.3.1
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 +148 -7
- package/dist/application/app.d.ts +34 -3
- package/dist/application/app.js +138 -126
- package/dist/application/operations.d.ts +3 -0
- package/dist/application/operations.js +30 -8
- package/dist/cli/cli.d.ts +1 -0
- package/dist/cli/cli.js +101 -13
- package/dist/cli/onboarding.d.ts +13 -0
- package/dist/cli/onboarding.js +99 -2
- package/dist/cli/output.js +18 -2
- package/dist/doctor/profile.js +2 -1
- package/dist/internal-marketplace.d.ts +25 -0
- package/dist/internal-marketplace.js +50 -0
- package/dist/marketplace/approval-files.d.ts +3 -0
- package/dist/marketplace/approval-files.js +97 -0
- package/dist/marketplace/approval-preview.d.ts +2 -0
- package/dist/marketplace/approval-preview.js +86 -0
- package/dist/marketplace/proof-approval.d.ts +82 -0
- package/dist/marketplace/proof-approval.js +671 -0
- package/dist/marketplace/topups.d.ts +82 -0
- package/dist/marketplace/topups.js +485 -0
- package/dist/network/batching.d.ts +2 -0
- package/dist/network/batching.js +23 -0
- package/dist/network/entry.d.ts +2 -0
- package/dist/network/entry.js +35 -0
- package/dist/network/reader.d.ts +2 -0
- package/dist/network/reader.js +125 -37
- package/dist/spending/approval.d.ts +5 -0
- package/dist/spending/approval.js +2 -0
- package/dist/spending/atto-x402.d.ts +31 -0
- package/dist/spending/atto-x402.js +174 -0
- package/dist/spending/ledger.d.ts +74 -2
- package/dist/spending/ledger.js +298 -7
- package/dist/spending/payments.d.ts +105 -5
- package/dist/spending/payments.js +795 -11
- package/dist/storage/recovery-seed.d.ts +13 -0
- package/dist/storage/recovery-seed.js +93 -0
- package/dist/storage/state.d.ts +4 -0
- package/dist/storage/state.js +32 -2
- package/dist/wallet/receive.d.ts +39 -0
- package/dist/wallet/receive.js +264 -0
- package/dist/wallet/signing.d.ts +1 -0
- package/dist/wallet/signing.js +37 -21
- package/dist/wallet/types.d.ts +1 -0
- package/node_modules/@attocash/commons-core/Kotlin-DateTime-library-kotlinx-datetime.mjs +1922 -1918
- package/node_modules/@attocash/commons-core/Kotlin-DateTime-library-kotlinx-datetime.mjs.map +1 -1
- package/node_modules/@attocash/commons-core/README.md +9 -0
- package/node_modules/@attocash/commons-core/commons-commons-core.d.mts +10 -0
- package/node_modules/@attocash/commons-core/commons-commons-core.mjs +2543 -2434
- package/node_modules/@attocash/commons-core/commons-commons-core.mjs.map +1 -1
- package/node_modules/@attocash/commons-core/kotlin-kotlin-stdlib.mjs +4695 -4227
- package/node_modules/@attocash/commons-core/kotlin-kotlin-stdlib.mjs.map +1 -1
- package/node_modules/@attocash/commons-core/kotlin_org_jetbrains_kotlin_kotlin_dom_api_compat.mjs.map +1 -1
- package/node_modules/@attocash/commons-core/kotlinx-io-kotlinx-io-bytestring.mjs +60 -60
- package/node_modules/@attocash/commons-core/kotlinx-io-kotlinx-io-bytestring.mjs.map +1 -1
- package/node_modules/@attocash/commons-core/kotlinx-io-kotlinx-io-core.mjs +651 -631
- package/node_modules/@attocash/commons-core/kotlinx-io-kotlinx-io-core.mjs.map +1 -1
- package/node_modules/@attocash/commons-core/kotlinx-serialization-kotlinx-serialization-core.mjs +2294 -2295
- package/node_modules/@attocash/commons-core/kotlinx-serialization-kotlinx-serialization-core.mjs.map +1 -1
- package/node_modules/@attocash/commons-core/kotlinx-serialization-kotlinx-serialization-json.mjs +1732 -1701
- package/node_modules/@attocash/commons-core/kotlinx-serialization-kotlinx-serialization-json.mjs.map +1 -1
- package/node_modules/@attocash/commons-core/package.json +1 -1
- package/node_modules/@attocash/commons-node/commons-commons-node.d.mts +1 -0
- package/node_modules/@attocash/commons-node/commons-commons-node.mjs +873 -847
- package/node_modules/@attocash/commons-node/commons-commons-node.mjs.map +1 -1
- package/node_modules/@attocash/commons-node/kotlin-logging.mjs +109 -109
- package/node_modules/@attocash/commons-node/kotlin-logging.mjs.map +1 -1
- package/node_modules/@attocash/commons-node/kotlinx-serialization-kotlinx-serialization-json.mjs +1732 -1701
- package/node_modules/@attocash/commons-node/kotlinx-serialization-kotlinx-serialization-json.mjs.map +1 -1
- package/node_modules/@attocash/commons-node/package.json +3 -3
- package/node_modules/@attocash/commons-node-remote/commons-commons-node-remote.d.mts +1 -0
- package/node_modules/@attocash/commons-node-remote/commons-commons-node-remote.mjs +674 -640
- package/node_modules/@attocash/commons-node-remote/commons-commons-node-remote.mjs.map +1 -1
- package/node_modules/@attocash/commons-node-remote/kotlin-logging.mjs +109 -109
- package/node_modules/@attocash/commons-node-remote/kotlin-logging.mjs.map +1 -1
- package/node_modules/@attocash/commons-node-remote/kotlinx-browser.mjs.map +1 -1
- package/node_modules/@attocash/commons-node-remote/kotlinx-serialization-kotlinx-serialization-json-io.mjs.map +1 -1
- package/node_modules/@attocash/commons-node-remote/kotlinx-serialization-kotlinx-serialization-json.mjs +1732 -1701
- package/node_modules/@attocash/commons-node-remote/kotlinx-serialization-kotlinx-serialization-json.mjs.map +1 -1
- package/node_modules/@attocash/commons-node-remote/package.json +4 -4
- package/node_modules/@attocash/commons-transport/commons-commons-transport.d.mts +1 -0
- package/node_modules/@attocash/commons-transport/commons-commons-transport.mjs +52 -51
- package/node_modules/@attocash/commons-transport/commons-commons-transport.mjs.map +1 -1
- package/node_modules/@attocash/commons-transport/kotlinx-atomicfu.mjs +13 -13
- package/node_modules/@attocash/commons-transport/kotlinx-atomicfu.mjs.map +1 -1
- package/node_modules/@attocash/commons-transport/kotlinx-browser.mjs.map +1 -1
- package/node_modules/@attocash/commons-transport/kotlinx-coroutines-core.mjs +2639 -2608
- package/node_modules/@attocash/commons-transport/kotlinx-coroutines-core.mjs.map +1 -1
- package/node_modules/@attocash/commons-transport/kotlinx-serialization-kotlinx-serialization-json-io.mjs.map +1 -1
- package/node_modules/@attocash/commons-transport/kotlinx-serialization-kotlinx-serialization-json.mjs +1732 -1701
- package/node_modules/@attocash/commons-transport/kotlinx-serialization-kotlinx-serialization-json.mjs.map +1 -1
- package/node_modules/@attocash/commons-transport/ktor-ktor-client-content-negotiation.mjs +411 -196
- package/node_modules/@attocash/commons-transport/ktor-ktor-client-content-negotiation.mjs.map +1 -1
- package/node_modules/@attocash/commons-transport/ktor-ktor-client-core.mjs +2115 -1976
- package/node_modules/@attocash/commons-transport/ktor-ktor-client-core.mjs.map +1 -1
- package/node_modules/@attocash/commons-transport/ktor-ktor-events.mjs +7 -7
- package/node_modules/@attocash/commons-transport/ktor-ktor-events.mjs.map +1 -1
- package/node_modules/@attocash/commons-transport/ktor-ktor-http-cio.mjs +385 -384
- package/node_modules/@attocash/commons-transport/ktor-ktor-http-cio.mjs.map +1 -1
- package/node_modules/@attocash/commons-transport/ktor-ktor-http.mjs +1261 -1185
- package/node_modules/@attocash/commons-transport/ktor-ktor-http.mjs.map +1 -1
- package/node_modules/@attocash/commons-transport/ktor-ktor-io.mjs +668 -656
- package/node_modules/@attocash/commons-transport/ktor-ktor-io.mjs.map +1 -1
- package/node_modules/@attocash/commons-transport/ktor-ktor-openapi-schema.mjs +89 -0
- package/node_modules/@attocash/commons-transport/ktor-ktor-openapi-schema.mjs.map +1 -0
- package/node_modules/@attocash/commons-transport/ktor-ktor-serialization-kotlinx-json.mjs +9 -9
- package/node_modules/@attocash/commons-transport/ktor-ktor-serialization-kotlinx-json.mjs.map +1 -1
- package/node_modules/@attocash/commons-transport/ktor-ktor-serialization-kotlinx.mjs +120 -128
- package/node_modules/@attocash/commons-transport/ktor-ktor-serialization-kotlinx.mjs.map +1 -1
- package/node_modules/@attocash/commons-transport/ktor-ktor-serialization.mjs +46 -49
- package/node_modules/@attocash/commons-transport/ktor-ktor-serialization.mjs.map +1 -1
- package/node_modules/@attocash/commons-transport/ktor-ktor-sse.mjs.map +1 -1
- package/node_modules/@attocash/commons-transport/ktor-ktor-utils.mjs +1041 -985
- package/node_modules/@attocash/commons-transport/ktor-ktor-utils.mjs.map +1 -1
- package/node_modules/@attocash/commons-transport/ktor-ktor-websocket-serialization.mjs.map +1 -1
- package/node_modules/@attocash/commons-transport/ktor-ktor-websockets.mjs +530 -455
- package/node_modules/@attocash/commons-transport/ktor-ktor-websockets.mjs.map +1 -1
- package/node_modules/@attocash/commons-transport/package.json +4 -4
- package/node_modules/@attocash/commons-worker/commons-commons-worker.d.mts +1 -0
- package/node_modules/@attocash/commons-worker/commons-commons-worker.mjs +230 -226
- package/node_modules/@attocash/commons-worker/commons-commons-worker.mjs.map +1 -1
- package/node_modules/@attocash/commons-worker/kotlin-logging.mjs +109 -109
- package/node_modules/@attocash/commons-worker/kotlin-logging.mjs.map +1 -1
- package/node_modules/@attocash/commons-worker/kotlinx-serialization-kotlinx-serialization-json.mjs +1732 -1701
- package/node_modules/@attocash/commons-worker/kotlinx-serialization-kotlinx-serialization-json.mjs.map +1 -1
- package/node_modules/@attocash/commons-worker/package.json +3 -3
- package/node_modules/@attocash/commons-worker-remote/commons-commons-worker-remote.d.mts +1 -0
- package/node_modules/@attocash/commons-worker-remote/commons-commons-worker-remote.mjs +91 -86
- package/node_modules/@attocash/commons-worker-remote/commons-commons-worker-remote.mjs.map +1 -1
- package/node_modules/@attocash/commons-worker-remote/kotlin-logging.mjs +109 -109
- package/node_modules/@attocash/commons-worker-remote/kotlin-logging.mjs.map +1 -1
- package/node_modules/@attocash/commons-worker-remote/kotlinx-browser.mjs.map +1 -1
- package/node_modules/@attocash/commons-worker-remote/kotlinx-serialization-kotlinx-serialization-json-io.mjs.map +1 -1
- package/node_modules/@attocash/commons-worker-remote/kotlinx-serialization-kotlinx-serialization-json.mjs +1732 -1701
- package/node_modules/@attocash/commons-worker-remote/kotlinx-serialization-kotlinx-serialization-json.mjs.map +1 -1
- package/node_modules/@attocash/commons-worker-remote/package.json +4 -4
- package/package.json +9 -5
package/README.md
CHANGED
|
@@ -8,6 +8,11 @@ Create a wallet, name your addresses, and send payments from the command line.
|
|
|
8
8
|
Check what arrived, follow activity live, or use JSON output in your own scripts.
|
|
9
9
|
Available as an initial beta for macOS, Linux, and Windows.
|
|
10
10
|
|
|
11
|
+
This guide follows the current source checkout. Published npm releases may lag
|
|
12
|
+
behind it, including Marketplace commands. Check your installed `atto --help`
|
|
13
|
+
and command-specific help, or [build from source](#install-from-source) to use
|
|
14
|
+
the checkout's features. See the [repository release status](https://github.com/attocash/integrations#release-status).
|
|
15
|
+
|
|
11
16
|
[Install](#install) · [Set up a wallet](#set-up-the-wallet) ·
|
|
12
17
|
[Everyday examples](#everyday-examples) · [Command reference](#use-the-cli) ·
|
|
13
18
|
[Recovery](#profiles-and-recovery)
|
|
@@ -20,7 +25,7 @@ Available as an initial beta for macOS, Linux, and Windows.
|
|
|
20
25
|
|
|
21
26
|
## Install
|
|
22
27
|
|
|
23
|
-
Requires **Node.js 24**. Use the latest 24.x release. Install from npm:
|
|
28
|
+
Requires **Node.js 24.15.0 or newer**. Use the latest 24.x release. Install from npm:
|
|
24
29
|
|
|
25
30
|
```sh
|
|
26
31
|
npm install --global @attocash/cli
|
|
@@ -117,6 +122,67 @@ is interrupted; it identifies the same payment when you retry.
|
|
|
117
122
|
Watching incoming payments only observes them. Run `atto wallet receive` when
|
|
118
123
|
you want the wallet to receive them automatically.
|
|
119
124
|
|
|
125
|
+
### Fund a Marketplace account
|
|
126
|
+
|
|
127
|
+
Connect the wallet from an interactive local terminal using the Marketplace
|
|
128
|
+
`/v1/agent/topups` URL, its exact controller-proof audience, and a saved wallet
|
|
129
|
+
account. The connection uses the existing wallet key for authentication; session
|
|
130
|
+
tokens stay in memory. HTTPS is required except for loopback HTTP on an isolated
|
|
131
|
+
LOCAL wallet.
|
|
132
|
+
|
|
133
|
+
```sh
|
|
134
|
+
atto address derive 1
|
|
135
|
+
atto marketplace connect --api-url https://<marketplace-host>/v1/agent/topups --audience <agent-api-audience> --controller-index 1 --browser-origin https://<site-host>
|
|
136
|
+
atto marketplace topup 1 --unit ATTO --request-id marketplace-funding-2026-001
|
|
137
|
+
atto marketplace status marketplace-funding-2026-001
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
`--browser-origin` may be repeated for up to eight exact origins. The CLI binds
|
|
141
|
+
browser proof approvals to that provisioned list; it does not accept an origin
|
|
142
|
+
from an approval file as configuration. Without this option, only the Marketplace
|
|
143
|
+
API origin is allowed. Cross-origin browser login and protected actions require
|
|
144
|
+
an existing local Marketplace connection. For an isolated LOCAL stack, use its exact
|
|
145
|
+
loopback API and site origins, for example `http://localhost:8080` and
|
|
146
|
+
`http://localhost:5173`; loopback HTTP is rejected for non-LOCAL wallets.
|
|
147
|
+
|
|
148
|
+
```sh
|
|
149
|
+
atto marketplace connect --api-url http://localhost:8080/v1/agent/topups --audience <agent-api-audience> --controller-index 1 --browser-origin http://localhost:5173
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
Marketplace top-ups use the existing shared spending limits, approved account pool,
|
|
153
|
+
and wallet journal. Keep the printed request ID and reuse it after an uncertain
|
|
154
|
+
result; status and recovery use the same intent and exact signed native payment.
|
|
155
|
+
An unresolved top-up keeps its account frontier and allowance reserved. This
|
|
156
|
+
flow funds the configured Marketplace account only. It does not create tasks, hire
|
|
157
|
+
agents, or submit work. The MCP `marketplace_topup` and `marketplace_topup_status` tools
|
|
158
|
+
become available after a local terminal connection; spending still requires
|
|
159
|
+
approved MCP access.
|
|
160
|
+
|
|
161
|
+
### Review a Marketplace wallet approval
|
|
162
|
+
|
|
163
|
+
When Marketplace provides a local wallet approval command, run it in your own
|
|
164
|
+
interactive terminal with the selected wallet's `--data-dir` and the exact
|
|
165
|
+
request-file path it supplies:
|
|
166
|
+
|
|
167
|
+
```sh
|
|
168
|
+
atto --data-dir /absolute/path/to/profile marketplace approve /path/to/handoff/0123456789abcdef0123456789abcdef.request.json
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
Review the Marketplace origin, controller, purpose, expiry, and action details,
|
|
172
|
+
then type `approve` only if they match your intended action. The CLI validates
|
|
173
|
+
the typed challenge and signs its exact message, then writes a private sibling
|
|
174
|
+
`<handoff-id>.response.json` file for Marketplace to consume. Keep the original
|
|
175
|
+
file paths; an existing response is never overwritten. Expired challenges
|
|
176
|
+
require a new request.
|
|
177
|
+
|
|
178
|
+
File-based approval requires POSIX file-ownership support and is unavailable on
|
|
179
|
+
native Windows.
|
|
180
|
+
|
|
181
|
+
This local review does not require or grant unattended message-signing access.
|
|
182
|
+
For product purchase and refund approvals, the preview distinguishes proof-bound
|
|
183
|
+
terms from client-provided seller, buyer, fee, and net details that the proof does
|
|
184
|
+
not verify.
|
|
185
|
+
|
|
120
186
|
## Use the CLI
|
|
121
187
|
|
|
122
188
|
Run `atto` to see the available commands. Incomplete command groups such as
|
|
@@ -256,7 +322,49 @@ A USD send fixes its Atto amount for that request ID, so retries do not reprice
|
|
|
256
322
|
the payment. Budget consumption always uses the resulting Atto amount. Reading
|
|
257
323
|
metrics and previewing a quote do not require accepting terms.
|
|
258
324
|
|
|
259
|
-
`history` defaults to account entries; use `history transaction`
|
|
325
|
+
`history` defaults to action-oriented account entries; use `history transaction`
|
|
326
|
+
when you need raw signed protocol records, including receive-block `sendHash`
|
|
327
|
+
linkage. Entries include the account owner's `address`, `subjectAddress`, and
|
|
328
|
+
`subjectRole`:
|
|
329
|
+
|
|
330
|
+
| Entry action | Subject role | Subject address |
|
|
331
|
+
|---|---|---|
|
|
332
|
+
| `SEND` | `receiver` | Payment destination |
|
|
333
|
+
| `OPEN`, `RECEIVE` | `sender` | Account that sent the payment |
|
|
334
|
+
| `CHANGE` | `representative` | Newly selected voter |
|
|
335
|
+
|
|
336
|
+
Transfers also include an exact `amount` with `raw` and `atto` decimal strings,
|
|
337
|
+
calculated from the entry's balance change. Representative changes have no
|
|
338
|
+
transfer amount. Existing protocol fields remain available.
|
|
339
|
+
|
|
340
|
+
Use `atto account --addresses <address-a>,<address-b>` for full account snapshots
|
|
341
|
+
including height, balance, and representative. JSON results contain
|
|
342
|
+
`accounts: [{address, account}]`, with `account: null` for an unopened address.
|
|
343
|
+
The existing `atto account <address>` and `atto account --index 0` forms retain
|
|
344
|
+
their single `account` result.
|
|
345
|
+
|
|
346
|
+
Node requests automatically use batches of **5** for the official
|
|
347
|
+
`gatekeeper.<network>.application.atto.cash` URLs (`live`, `beta`, or `dev`),
|
|
348
|
+
and **1,000** for other node URLs. A smaller selection is sent in one
|
|
349
|
+
request. This is a client query setting; direct nodes do not impose the
|
|
350
|
+
gateway's five-account limit.
|
|
351
|
+
|
|
352
|
+
Override it for a custom gateway or node, or restore automatic selection:
|
|
353
|
+
|
|
354
|
+
```sh
|
|
355
|
+
atto wallet configure --node-batch-size 5
|
|
356
|
+
atto wallet configure --node-batch-size 1000
|
|
357
|
+
atto wallet configure --node-batch-size auto
|
|
358
|
+
```
|
|
359
|
+
|
|
360
|
+
The override is saved in this profile and applies to account snapshots, balances,
|
|
361
|
+
history, and account/receivable watches. Entry/transaction watches retain
|
|
362
|
+
per-account subscriptions for their replay checkpoints. Custom gateways and
|
|
363
|
+
proxies require an explicit override when their limit differs from the
|
|
364
|
+
custom-node default.
|
|
365
|
+
`wallet status` shows the override and effective size. The tool's existing
|
|
366
|
+
100-address selection limit and 1,000-record history page limit still apply.
|
|
367
|
+
|
|
260
368
|
History, receivables, balances, and watches default to active wallet addresses.
|
|
261
369
|
Use `--index N` or `--addresses <address,...>` to select saved or external accounts;
|
|
262
370
|
these selectors cannot be combined. Watches also accept `--network-wide` for
|
|
@@ -414,6 +522,31 @@ atto limits status
|
|
|
414
522
|
atto limits clear
|
|
415
523
|
```
|
|
416
524
|
|
|
525
|
+
ATTO message signing is a separate profile-specific capability. It starts with no
|
|
526
|
+
approved indexes. Grant only the wallet indexes that need unattended signatures
|
|
527
|
+
from a local terminal; MCP signing also requires the usual `spend` access:
|
|
528
|
+
|
|
529
|
+
```sh
|
|
530
|
+
atto limits set --message-signing-indexes 0,1
|
|
531
|
+
atto limits status
|
|
532
|
+
atto limits set --message-signing-indexes none
|
|
533
|
+
```
|
|
534
|
+
|
|
535
|
+
`atto message sign --index 0 --text 'exact challenge'` signs the exact UTF-8
|
|
536
|
+
bytes; use `--hex` for arbitrary bytes, including the empty byte sequence. The
|
|
537
|
+
input is capped at 64 KiB, and no trimming or Unicode normalization is applied.
|
|
538
|
+
Quote whitespace and line breaks as part of the argument when they are part of
|
|
539
|
+
the challenge. Shell command substitution strips trailing newlines, so use
|
|
540
|
+
`--hex` when a trailing newline or other exact byte sequence must be preserved.
|
|
541
|
+
The result includes the selected index, address, public key, and 128-character
|
|
542
|
+
hex signature.
|
|
543
|
+
`atto message verify --address <address> --signature <hex> --text 'exact challenge'`
|
|
544
|
+
checks a signature without reading wallet credentials. Use `--public-key <hex>`
|
|
545
|
+
instead when only the public key is available. Message signatures use the
|
|
546
|
+
Commons `ATTO Signed Message v1` framing. Approving an index permits generic
|
|
547
|
+
authentication and controller-approval signatures for that key. Grant only
|
|
548
|
+
keys approved for those purposes, and sign only challenges you trust.
|
|
549
|
+
|
|
417
550
|
Amount flags default to ATTO; use `--unit RAW` for raw amounts. Omitted limits
|
|
418
551
|
are preserved, and `--daily` replaces only the rolling 24-hour rule. Advanced
|
|
419
552
|
`--input` replaces the entire policy and cannot be combined with amount flags.
|
|
@@ -423,6 +556,8 @@ disable consolidation explicitly.
|
|
|
423
556
|
`limits set` preserves the existing MCP access mode unless you supply
|
|
424
557
|
`--access read-only` or `--access spend`. `limits clear` also preserves that mode;
|
|
425
558
|
if MCP already has spending access, clearing its limits permits unlimited sends.
|
|
559
|
+
It also preserves message-signing grants; revoke those with
|
|
560
|
+
`atto limits set --message-signing-indexes none`.
|
|
426
561
|
To enable MCP with a bounded policy explicitly:
|
|
427
562
|
|
|
428
563
|
```sh
|
|
@@ -432,13 +567,15 @@ atto --data-dir /absolute/path/to/profile limits set --access spend \
|
|
|
432
567
|
|
|
433
568
|
MCP `limits_propose` and generic `atto call limits_propose` **only propose** a change.
|
|
434
569
|
They cannot apply it. `limits_propose` also accepts `pool` with `indexes` and
|
|
435
|
-
`consolidate`; omitting
|
|
436
|
-
active policy, usage, `mcpAccess`, pool,
|
|
570
|
+
`consolidate`, and `messageSigningIndexes`; omitting either preserves its current
|
|
571
|
+
setting. `limits_get` returns the active policy, usage, `mcpAccess`, pool,
|
|
572
|
+
message-signing indexes, and current proposal.
|
|
437
573
|
|
|
438
574
|
The proposal response also includes `approval.changes`: changed `access`, `policy`,
|
|
439
|
-
and `
|
|
440
|
-
from spending access and amount limits; adding
|
|
441
|
-
necessarily change either. An unlimited policy
|
|
575
|
+
`pool`, and `messageSigningIndexes` settings with `from` and `to` values.
|
|
576
|
+
Source-pool approval is separate from spending access and amount limits; adding
|
|
577
|
+
another sending account does not necessarily change either. An unlimited policy
|
|
578
|
+
means no amount cap.
|
|
442
579
|
`approval.commands.atto` and `approval.commands.npx` provide approval alternatives
|
|
443
580
|
with the exact profile directory and proposal ID. Preserve their quoting and use
|
|
444
581
|
the indicated `approval.shell` (`posix` on Linux/macOS, `powershell` on Windows).
|
|
@@ -696,6 +833,10 @@ an existing legacy wallet preserves the legacy default. An older wallet already
|
|
|
696
833
|
at that path without the marker retains **Atto MCP**. Custom and
|
|
697
834
|
dedicated MCP profiles retain **Atto MCP** as well. Selecting the same absolute
|
|
698
835
|
directory from either interface selects the same credential and spending state.
|
|
836
|
+
Using the same recovery phrase in separate profile directories does not share
|
|
837
|
+
locks, limits, journals, or request IDs. Those profiles still control the same
|
|
838
|
+
on-chain accounts, so concurrent mutations can compete for an account head.
|
|
839
|
+
Use one shared profile to coordinate CLI and MCP operations on the same wallet.
|
|
699
840
|
|
|
700
841
|
Keep the same absolute directory when restoring whenever possible. A different
|
|
701
842
|
path selects its own credential account and may select a different service;
|
|
@@ -4,6 +4,7 @@ import type { SendRetry } from '../network/retry.js';
|
|
|
4
4
|
import { type SecretStore } from '../storage/secrets.js';
|
|
5
5
|
import { StateStore } from '../storage/state.js';
|
|
6
6
|
import { SpendLedger, type McpAccess } from '../spending/ledger.js';
|
|
7
|
+
import { type InternalMarketplacePaymentConfig } from '../spending/payments.js';
|
|
7
8
|
import { type WorkExecution } from '../wallet/work.js';
|
|
8
9
|
import { type ReceiveProgress } from '../wallet/auto-receive.js';
|
|
9
10
|
import type { AccountPool, SpendingPolicy, WalletIdentity } from '../wallet/types.js';
|
|
@@ -16,12 +17,14 @@ export declare class AttoApplication {
|
|
|
16
17
|
private readonly personal;
|
|
17
18
|
private readonly labels;
|
|
18
19
|
private readonly auto;
|
|
20
|
+
private readonly receiver;
|
|
19
21
|
private readonly work;
|
|
20
22
|
private readonly background;
|
|
21
23
|
private readonly receivingAllowed;
|
|
22
24
|
private preparation?;
|
|
23
25
|
private readonly preparationAbort;
|
|
24
26
|
private readonly payments;
|
|
27
|
+
private readonly topUps;
|
|
25
28
|
private watchManager?;
|
|
26
29
|
private watchConfiguration;
|
|
27
30
|
private watchQueue;
|
|
@@ -31,12 +34,18 @@ export declare class AttoApplication {
|
|
|
31
34
|
private recoveryReads;
|
|
32
35
|
private readonly calls;
|
|
33
36
|
private readonly mcp;
|
|
37
|
+
private readonly internalMarketplacePayment?;
|
|
38
|
+
private readonly internalMarketplaceAuthorizeWrite?;
|
|
39
|
+
private readonly internalMarketplaceReceiveSafety;
|
|
34
40
|
private readonly doctorAbort;
|
|
35
41
|
constructor(options?: {
|
|
36
42
|
directory?: string;
|
|
37
43
|
secrets?: SecretStore;
|
|
38
44
|
market?: MarketData;
|
|
39
45
|
access?: 'mcp';
|
|
46
|
+
internalMarketplaceReceiveSafety?: boolean;
|
|
47
|
+
internalMarketplaceAuthorizeWrite?: (status: unknown) => void;
|
|
48
|
+
internalMarketplacePayment?: InternalMarketplacePaymentConfig;
|
|
40
49
|
onReceiveProgress?: (event: ReceiveProgress) => void;
|
|
41
50
|
sendRetry?: SendRetry;
|
|
42
51
|
globalDirectory?: GlobalDirectory;
|
|
@@ -63,11 +72,13 @@ export declare class AttoApplication {
|
|
|
63
72
|
policy: SpendingPolicy;
|
|
64
73
|
mcpAccess: McpAccess;
|
|
65
74
|
pool: AccountPool;
|
|
75
|
+
messageSigningIndexes: number[];
|
|
66
76
|
}>;
|
|
67
77
|
approveLimitsProposal(id: string): Promise<{
|
|
68
78
|
policy: SpendingPolicy;
|
|
69
79
|
mcpAccess: McpAccess;
|
|
70
80
|
pool: AccountPool;
|
|
81
|
+
messageSigningIndexes: number[];
|
|
71
82
|
proposal: import("../spending/ledger.js").LimitsProposal | null;
|
|
72
83
|
pendingRaw: string;
|
|
73
84
|
perRequest: {
|
|
@@ -92,6 +103,7 @@ export declare class AttoApplication {
|
|
|
92
103
|
policy: SpendingPolicy;
|
|
93
104
|
mcpAccess: McpAccess;
|
|
94
105
|
pool: AccountPool;
|
|
106
|
+
messageSigningIndexes: number[];
|
|
95
107
|
proposal: import("../spending/ledger.js").LimitsProposal | null;
|
|
96
108
|
pendingRaw: string;
|
|
97
109
|
perRequest: {
|
|
@@ -131,14 +143,33 @@ export declare class AttoApplication {
|
|
|
131
143
|
private deriveAddress;
|
|
132
144
|
private configure;
|
|
133
145
|
private result;
|
|
134
|
-
private pendingReceivable;
|
|
135
|
-
private receive;
|
|
136
|
-
private receiveAll;
|
|
137
146
|
private changeRepresentative;
|
|
138
147
|
private serializeWatches;
|
|
139
148
|
private withWatches;
|
|
140
149
|
private invoke;
|
|
141
150
|
call(name: string, input?: Record<string, unknown>): Promise<unknown>;
|
|
151
|
+
/** Terminal-only Marketplace controller connection; session tokens remain in memory. */
|
|
152
|
+
connectMarketplace(input: {
|
|
153
|
+
apiUrl: string;
|
|
154
|
+
audience: string;
|
|
155
|
+
controllerIndex: number;
|
|
156
|
+
browserOrigins?: string[];
|
|
157
|
+
}): Promise<{
|
|
158
|
+
browserOrigins?: string[] | undefined;
|
|
159
|
+
connected: boolean;
|
|
160
|
+
apiUrl: string;
|
|
161
|
+
audience: string;
|
|
162
|
+
controllerIndex: number;
|
|
163
|
+
accountId: string;
|
|
164
|
+
identityId: string;
|
|
165
|
+
}>;
|
|
166
|
+
inspectMarketplaceProofApproval(input: unknown): {
|
|
167
|
+
request: import("../marketplace/proof-approval.js").MarketplaceProofApprovalRequest;
|
|
168
|
+
preview: import("../marketplace/proof-approval.js").MarketplaceProofApprovalPreview;
|
|
169
|
+
};
|
|
170
|
+
approveMarketplaceProof(input: unknown): Promise<import("../marketplace/proof-approval.js").MarketplaceProofApprovalResponse>;
|
|
171
|
+
/** Private Marketplace terminal signing: no standalone connection is read or changed. */
|
|
172
|
+
approveMarketplaceOwnedProof(input: unknown): Promise<import("../marketplace/proof-approval.js").MarketplaceProofApprovalResponse>;
|
|
142
173
|
start(): Promise<void>;
|
|
143
174
|
/** Terminal-only detached receiver control; it never changes MCP approval. */
|
|
144
175
|
startBackgroundReceiver(): Promise<import("../wallet/background-receive.js").BackgroundReceiveStatus>;
|