@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.
Files changed (137) hide show
  1. package/README.md +148 -7
  2. package/dist/application/app.d.ts +34 -3
  3. package/dist/application/app.js +138 -126
  4. package/dist/application/operations.d.ts +3 -0
  5. package/dist/application/operations.js +30 -8
  6. package/dist/cli/cli.d.ts +1 -0
  7. package/dist/cli/cli.js +101 -13
  8. package/dist/cli/onboarding.d.ts +13 -0
  9. package/dist/cli/onboarding.js +99 -2
  10. package/dist/cli/output.js +18 -2
  11. package/dist/doctor/profile.js +2 -1
  12. package/dist/internal-marketplace.d.ts +25 -0
  13. package/dist/internal-marketplace.js +50 -0
  14. package/dist/marketplace/approval-files.d.ts +3 -0
  15. package/dist/marketplace/approval-files.js +97 -0
  16. package/dist/marketplace/approval-preview.d.ts +2 -0
  17. package/dist/marketplace/approval-preview.js +86 -0
  18. package/dist/marketplace/proof-approval.d.ts +82 -0
  19. package/dist/marketplace/proof-approval.js +671 -0
  20. package/dist/marketplace/topups.d.ts +82 -0
  21. package/dist/marketplace/topups.js +485 -0
  22. package/dist/network/batching.d.ts +2 -0
  23. package/dist/network/batching.js +23 -0
  24. package/dist/network/entry.d.ts +2 -0
  25. package/dist/network/entry.js +35 -0
  26. package/dist/network/reader.d.ts +2 -0
  27. package/dist/network/reader.js +125 -37
  28. package/dist/spending/approval.d.ts +5 -0
  29. package/dist/spending/approval.js +2 -0
  30. package/dist/spending/atto-x402.d.ts +31 -0
  31. package/dist/spending/atto-x402.js +174 -0
  32. package/dist/spending/ledger.d.ts +74 -2
  33. package/dist/spending/ledger.js +298 -7
  34. package/dist/spending/payments.d.ts +105 -5
  35. package/dist/spending/payments.js +795 -11
  36. package/dist/storage/recovery-seed.d.ts +13 -0
  37. package/dist/storage/recovery-seed.js +93 -0
  38. package/dist/storage/state.d.ts +4 -0
  39. package/dist/storage/state.js +32 -2
  40. package/dist/wallet/receive.d.ts +39 -0
  41. package/dist/wallet/receive.js +264 -0
  42. package/dist/wallet/signing.d.ts +1 -0
  43. package/dist/wallet/signing.js +37 -21
  44. package/dist/wallet/types.d.ts +1 -0
  45. package/node_modules/@attocash/commons-core/Kotlin-DateTime-library-kotlinx-datetime.mjs +1922 -1918
  46. package/node_modules/@attocash/commons-core/Kotlin-DateTime-library-kotlinx-datetime.mjs.map +1 -1
  47. package/node_modules/@attocash/commons-core/README.md +9 -0
  48. package/node_modules/@attocash/commons-core/commons-commons-core.d.mts +10 -0
  49. package/node_modules/@attocash/commons-core/commons-commons-core.mjs +2543 -2434
  50. package/node_modules/@attocash/commons-core/commons-commons-core.mjs.map +1 -1
  51. package/node_modules/@attocash/commons-core/kotlin-kotlin-stdlib.mjs +4695 -4227
  52. package/node_modules/@attocash/commons-core/kotlin-kotlin-stdlib.mjs.map +1 -1
  53. package/node_modules/@attocash/commons-core/kotlin_org_jetbrains_kotlin_kotlin_dom_api_compat.mjs.map +1 -1
  54. package/node_modules/@attocash/commons-core/kotlinx-io-kotlinx-io-bytestring.mjs +60 -60
  55. package/node_modules/@attocash/commons-core/kotlinx-io-kotlinx-io-bytestring.mjs.map +1 -1
  56. package/node_modules/@attocash/commons-core/kotlinx-io-kotlinx-io-core.mjs +651 -631
  57. package/node_modules/@attocash/commons-core/kotlinx-io-kotlinx-io-core.mjs.map +1 -1
  58. package/node_modules/@attocash/commons-core/kotlinx-serialization-kotlinx-serialization-core.mjs +2294 -2295
  59. package/node_modules/@attocash/commons-core/kotlinx-serialization-kotlinx-serialization-core.mjs.map +1 -1
  60. package/node_modules/@attocash/commons-core/kotlinx-serialization-kotlinx-serialization-json.mjs +1732 -1701
  61. package/node_modules/@attocash/commons-core/kotlinx-serialization-kotlinx-serialization-json.mjs.map +1 -1
  62. package/node_modules/@attocash/commons-core/package.json +1 -1
  63. package/node_modules/@attocash/commons-node/commons-commons-node.d.mts +1 -0
  64. package/node_modules/@attocash/commons-node/commons-commons-node.mjs +873 -847
  65. package/node_modules/@attocash/commons-node/commons-commons-node.mjs.map +1 -1
  66. package/node_modules/@attocash/commons-node/kotlin-logging.mjs +109 -109
  67. package/node_modules/@attocash/commons-node/kotlin-logging.mjs.map +1 -1
  68. package/node_modules/@attocash/commons-node/kotlinx-serialization-kotlinx-serialization-json.mjs +1732 -1701
  69. package/node_modules/@attocash/commons-node/kotlinx-serialization-kotlinx-serialization-json.mjs.map +1 -1
  70. package/node_modules/@attocash/commons-node/package.json +3 -3
  71. package/node_modules/@attocash/commons-node-remote/commons-commons-node-remote.d.mts +1 -0
  72. package/node_modules/@attocash/commons-node-remote/commons-commons-node-remote.mjs +674 -640
  73. package/node_modules/@attocash/commons-node-remote/commons-commons-node-remote.mjs.map +1 -1
  74. package/node_modules/@attocash/commons-node-remote/kotlin-logging.mjs +109 -109
  75. package/node_modules/@attocash/commons-node-remote/kotlin-logging.mjs.map +1 -1
  76. package/node_modules/@attocash/commons-node-remote/kotlinx-browser.mjs.map +1 -1
  77. package/node_modules/@attocash/commons-node-remote/kotlinx-serialization-kotlinx-serialization-json-io.mjs.map +1 -1
  78. package/node_modules/@attocash/commons-node-remote/kotlinx-serialization-kotlinx-serialization-json.mjs +1732 -1701
  79. package/node_modules/@attocash/commons-node-remote/kotlinx-serialization-kotlinx-serialization-json.mjs.map +1 -1
  80. package/node_modules/@attocash/commons-node-remote/package.json +4 -4
  81. package/node_modules/@attocash/commons-transport/commons-commons-transport.d.mts +1 -0
  82. package/node_modules/@attocash/commons-transport/commons-commons-transport.mjs +52 -51
  83. package/node_modules/@attocash/commons-transport/commons-commons-transport.mjs.map +1 -1
  84. package/node_modules/@attocash/commons-transport/kotlinx-atomicfu.mjs +13 -13
  85. package/node_modules/@attocash/commons-transport/kotlinx-atomicfu.mjs.map +1 -1
  86. package/node_modules/@attocash/commons-transport/kotlinx-browser.mjs.map +1 -1
  87. package/node_modules/@attocash/commons-transport/kotlinx-coroutines-core.mjs +2639 -2608
  88. package/node_modules/@attocash/commons-transport/kotlinx-coroutines-core.mjs.map +1 -1
  89. package/node_modules/@attocash/commons-transport/kotlinx-serialization-kotlinx-serialization-json-io.mjs.map +1 -1
  90. package/node_modules/@attocash/commons-transport/kotlinx-serialization-kotlinx-serialization-json.mjs +1732 -1701
  91. package/node_modules/@attocash/commons-transport/kotlinx-serialization-kotlinx-serialization-json.mjs.map +1 -1
  92. package/node_modules/@attocash/commons-transport/ktor-ktor-client-content-negotiation.mjs +411 -196
  93. package/node_modules/@attocash/commons-transport/ktor-ktor-client-content-negotiation.mjs.map +1 -1
  94. package/node_modules/@attocash/commons-transport/ktor-ktor-client-core.mjs +2115 -1976
  95. package/node_modules/@attocash/commons-transport/ktor-ktor-client-core.mjs.map +1 -1
  96. package/node_modules/@attocash/commons-transport/ktor-ktor-events.mjs +7 -7
  97. package/node_modules/@attocash/commons-transport/ktor-ktor-events.mjs.map +1 -1
  98. package/node_modules/@attocash/commons-transport/ktor-ktor-http-cio.mjs +385 -384
  99. package/node_modules/@attocash/commons-transport/ktor-ktor-http-cio.mjs.map +1 -1
  100. package/node_modules/@attocash/commons-transport/ktor-ktor-http.mjs +1261 -1185
  101. package/node_modules/@attocash/commons-transport/ktor-ktor-http.mjs.map +1 -1
  102. package/node_modules/@attocash/commons-transport/ktor-ktor-io.mjs +668 -656
  103. package/node_modules/@attocash/commons-transport/ktor-ktor-io.mjs.map +1 -1
  104. package/node_modules/@attocash/commons-transport/ktor-ktor-openapi-schema.mjs +89 -0
  105. package/node_modules/@attocash/commons-transport/ktor-ktor-openapi-schema.mjs.map +1 -0
  106. package/node_modules/@attocash/commons-transport/ktor-ktor-serialization-kotlinx-json.mjs +9 -9
  107. package/node_modules/@attocash/commons-transport/ktor-ktor-serialization-kotlinx-json.mjs.map +1 -1
  108. package/node_modules/@attocash/commons-transport/ktor-ktor-serialization-kotlinx.mjs +120 -128
  109. package/node_modules/@attocash/commons-transport/ktor-ktor-serialization-kotlinx.mjs.map +1 -1
  110. package/node_modules/@attocash/commons-transport/ktor-ktor-serialization.mjs +46 -49
  111. package/node_modules/@attocash/commons-transport/ktor-ktor-serialization.mjs.map +1 -1
  112. package/node_modules/@attocash/commons-transport/ktor-ktor-sse.mjs.map +1 -1
  113. package/node_modules/@attocash/commons-transport/ktor-ktor-utils.mjs +1041 -985
  114. package/node_modules/@attocash/commons-transport/ktor-ktor-utils.mjs.map +1 -1
  115. package/node_modules/@attocash/commons-transport/ktor-ktor-websocket-serialization.mjs.map +1 -1
  116. package/node_modules/@attocash/commons-transport/ktor-ktor-websockets.mjs +530 -455
  117. package/node_modules/@attocash/commons-transport/ktor-ktor-websockets.mjs.map +1 -1
  118. package/node_modules/@attocash/commons-transport/package.json +4 -4
  119. package/node_modules/@attocash/commons-worker/commons-commons-worker.d.mts +1 -0
  120. package/node_modules/@attocash/commons-worker/commons-commons-worker.mjs +230 -226
  121. package/node_modules/@attocash/commons-worker/commons-commons-worker.mjs.map +1 -1
  122. package/node_modules/@attocash/commons-worker/kotlin-logging.mjs +109 -109
  123. package/node_modules/@attocash/commons-worker/kotlin-logging.mjs.map +1 -1
  124. package/node_modules/@attocash/commons-worker/kotlinx-serialization-kotlinx-serialization-json.mjs +1732 -1701
  125. package/node_modules/@attocash/commons-worker/kotlinx-serialization-kotlinx-serialization-json.mjs.map +1 -1
  126. package/node_modules/@attocash/commons-worker/package.json +3 -3
  127. package/node_modules/@attocash/commons-worker-remote/commons-commons-worker-remote.d.mts +1 -0
  128. package/node_modules/@attocash/commons-worker-remote/commons-commons-worker-remote.mjs +91 -86
  129. package/node_modules/@attocash/commons-worker-remote/commons-commons-worker-remote.mjs.map +1 -1
  130. package/node_modules/@attocash/commons-worker-remote/kotlin-logging.mjs +109 -109
  131. package/node_modules/@attocash/commons-worker-remote/kotlin-logging.mjs.map +1 -1
  132. package/node_modules/@attocash/commons-worker-remote/kotlinx-browser.mjs.map +1 -1
  133. package/node_modules/@attocash/commons-worker-remote/kotlinx-serialization-kotlinx-serialization-json-io.mjs.map +1 -1
  134. package/node_modules/@attocash/commons-worker-remote/kotlinx-serialization-kotlinx-serialization-json.mjs +1732 -1701
  135. package/node_modules/@attocash/commons-worker-remote/kotlinx-serialization-kotlinx-serialization-json.mjs.map +1 -1
  136. package/node_modules/@attocash/commons-worker-remote/package.json +4 -4
  137. 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` for transactions.
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 it preserves the current pool. `limits_get` returns the
436
- active policy, usage, `mcpAccess`, pool, and current proposal.
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 `pool` settings with `from` and `to` values. Source-pool approval is separate
440
- from spending access and amount limits; adding another sending account does not
441
- necessarily change either. An unlimited policy means no amount cap.
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>;