@attocash/cli 0.2.3 → 0.3.0

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
@@ -0,0 +1,86 @@
1
+ import { normalizeDisputeText, normalizeEvidenceUrls } from './proof-approval.js';
2
+ export function formatMarketplaceApprovalPreview(preview) {
3
+ const action = preview.action;
4
+ const command = action.command && typeof action.command === 'object' ? action.command : {};
5
+ const fields = [
6
+ `Marketplace: ${preview.marketplaceOrigin}`,
7
+ `Transport: ${preview.transport}`,
8
+ `Proof origin: ${preview.proofOrigin ?? '(none; Agent API audience)'}`,
9
+ `Audience: ${preview.audience}`,
10
+ `Purpose: ${preview.purpose}`,
11
+ `Controller: Atto index ${preview.controller.index}, ${preview.controller.address}`,
12
+ ...(preview.accountId ? [`Account: ${preview.accountId}`, `Identity: ${preview.identityId}`] : []),
13
+ `Challenge: ${preview.challengeId}`,
14
+ `Expires: ${preview.expiresAt}`,
15
+ ];
16
+ if (action.kind === 'withdrawal') {
17
+ fields.push(`Action: withdraw ${String(command.atomicAmount)} ${String(command.asset)} on ${String(action.network)}`, `Destination: ${String(action.destinationAddress)} (${String(command.destinationId)})`);
18
+ }
19
+ else if (action.kind === 'productPurchase') {
20
+ fields.push('Action: purchase digital product release', `Client-provided seller (not verified by this proof): ${String(action.sellerAgentId)}`, `Proof-bound release ID: ${String(action.releaseId)}`, `Proof-bound release SHA-256: ${String(action.expectedReleaseHash)}`, `Proof-bound asset: ${String(action.asset)}`, `Proof-bound gross: ${String(action.grossAtomic)} atomic`, `Client-provided fee (not verified by this proof): ${String(action.feeAtomic)} atomic`, `Client-provided net (not verified by this proof): ${String(action.netAtomic)} atomic`, `Proof-bound idempotency key: ${String(action.idempotencyKey)}`);
21
+ }
22
+ else if (action.kind === 'productRefund') {
23
+ const authority = String(action.authority);
24
+ fields.push(`Action: ${authority === 'ADMIN' ? 'administrator refund compensation' : 'seller refund'}`, `Proof-bound authority: ${authority}`, `Client-provided buyer (not verified by this proof): ${String(action.buyerAgentId)}`, `Client-provided seller (not verified by this proof): ${String(action.sellerAgentId)}`, `Proof-bound purchase ID: ${String(action.purchaseId)}`, `Proof-bound original purchase receipt SHA-256: ${String(action.originalPurchaseReceiptHash)}`, `Proof-bound expected purchase version: ${String(action.expectedPurchaseVersion)}`, `Proof-bound asset: ${String(action.asset)}`, `Proof-bound gross: ${String(action.grossAtomic)} atomic`, `Client-provided fee (not verified by this proof): ${String(action.feeAtomic)} atomic`, `Client-provided net (not verified by this proof): ${String(action.netAtomic)} atomic`, `Proof-bound idempotency key: ${String(action.idempotencyKey)}`);
25
+ }
26
+ else if (action.kind === 'payout-address') {
27
+ fields.push(`Action: ${String(command.action)} ${String(command.asset)} payout address on ${String(action.network)}`, `Destination: ${String(action.canonicalTargetAddress)}`);
28
+ }
29
+ else if (action.kind === 'credential') {
30
+ const credential = command.credential && typeof command.credential === 'object' ? command.credential : {};
31
+ fields.push(`Action: ${String(command.operation)} scoped credential`, ...(typeof credential.name === 'string' ? [`Name: ${credential.name.trim()}`] : []), ...(Array.isArray(credential.scopes) ? [`Scopes: ${credential.scopes.join(', ')}`] : []), ...(typeof command.targetApiKeyId === 'string' ? [`Credential ID: ${command.targetApiKeyId}`] : []));
32
+ for (const [name, label] of [['publishAttoLimit', 'ATTO publish ceiling'], ['publishXnoLimit', 'XNO publish ceiling'], ['applyAttoLimit', 'ATTO application ceiling'], ['applyXnoLimit', 'XNO application ceiling']]) {
33
+ if (typeof credential[name] === 'string')
34
+ fields.push(`${label}: ${String(credential[name])} atomic units`);
35
+ }
36
+ if (Array.isArray(credential.scopes) && credential.scopes.includes('products:publish')) {
37
+ for (const [name, label] of [['productPublishAttoLimit', 'ATTO product publication reservation ceiling'],
38
+ ['productPublishXnoLimit', 'XNO product publication reservation ceiling']]) {
39
+ fields.push(`${label}: ${typeof credential[name] === 'string' ? `${String(credential[name])} atomic units` : 'denied'}`);
40
+ }
41
+ }
42
+ if (Array.isArray(credential.scopes) && credential.scopes.includes('products:purchase')) {
43
+ for (const [name, label] of [['purchaseAttoLimit', 'ATTO product purchase ceiling'], ['purchaseXnoLimit', 'XNO product purchase ceiling']]) {
44
+ fields.push(`${label}: ${typeof credential[name] === 'string' ? `${String(credential[name])} atomic units` : 'denied'}`);
45
+ }
46
+ }
47
+ }
48
+ else if (action.kind === 'identity-link') {
49
+ fields.push(`Action: link controller (${String(action.operation)})`, `Link ID: ${String(action.linkId)}`, `Authorizing identity: ${String(action.authorizingIdentityId)}`, `Authorizing address: ${String(action.authorizingAddress)}`, `New controller address: ${String(action.newIdentityAddress)}`);
50
+ }
51
+ else if (action.kind === 'identity-unlink') {
52
+ fields.push('Action: unlink controller', `Controller to remove: ${String(action.targetIdentityId)}`, `Authorizing identity: ${String(action.authorizingIdentityId)}`);
53
+ }
54
+ else if (action.kind === 'adminModeration') {
55
+ fields.push(`Action: ${String(action.action)} ${String(action.targetKind)}`, `Target: ${String(action.targetId)}`, `Target version: ${String(action.expectedTargetVersion)}`, `Moderation version: ${String(action.expectedModerationVersion)}`, `Reason: ${String(action.reason).replace(/^ +| +$/g, '')}`);
56
+ }
57
+ else if (action.kind === 'adminTaskClose') {
58
+ fields.push(`Action: ${String(action.action)} task`, `Task: ${String(action.taskId)}`, `Expected version: ${String(action.expectedVersion)}`, `Reason: ${String(action.reason).replace(/^ +| +$/g, '')}`);
59
+ }
60
+ else if (action.kind === 'adminDisputeOpen') {
61
+ fields.push('Action: administrator opens dispute', `Task: ${String(action.taskId)}`, `Engagement version: ${String(action.expectedEngagementVersion)}`, `Represented agent: ${String(action.representedAgentId)}`, `Reason: ${String(action.reason)}`, `Statement: ${terminalSafeValue(normalizeDisputeText(String(action.statement)))}`, `Evidence URLs: ${(normalizeEvidenceUrls(action.evidenceUrls) ?? []).map(terminalSafeValue).join(', ') || '(none)'}`, `Audit reason: ${terminalSafeValue(normalizeDisputeText(String(action.auditReason)))}`);
62
+ }
63
+ else if (action.kind === 'adminDisputeResolution') {
64
+ fields.push('Action: administrator resolves dispute', `Dispute: ${String(action.disputeId)}`, `Dispute version: ${String(action.expectedDisputeVersion)}`, `Outcome: ${String(action.outcome)}`, `Rationale: ${terminalSafeValue(normalizeDisputeText(String(action.rationale)))}`);
65
+ }
66
+ else if (action.kind === 'login') {
67
+ fields.push(`Action: create a controller session for ${String(action.address)}`);
68
+ }
69
+ const heading = action.kind === 'productPurchase' || action.kind === 'productRefund'
70
+ ? 'Review this Marketplace challenge before signing. Items marked client-provided are not verified by this proof:'
71
+ : 'Review this server-authored Marketplace wallet proof before signing:';
72
+ return `${heading}\n${fields.map(field => ` ${escapeTerminalControls(field)}`).join('\n')}`;
73
+ }
74
+ function terminalSafeValue(value) {
75
+ return JSON.stringify(escapeTerminalControls(value));
76
+ }
77
+ function escapeTerminalControls(value) {
78
+ return [...value].map(character => {
79
+ const point = character.codePointAt(0);
80
+ if (point <= 0x1f || (point >= 0x7f && point <= 0x9f)
81
+ || point === 0x2028 || point === 0x2029 || /\p{Cf}/u.test(character)) {
82
+ return `\\u{${point.toString(16).toUpperCase()}}`;
83
+ }
84
+ return character;
85
+ }).join('');
86
+ }
@@ -0,0 +1,82 @@
1
+ import type { MarketplaceConnection } from './topups.js';
2
+ export interface MarketplaceProofApprovalRequest {
3
+ version: 1;
4
+ type: 'marketplace-controller-approval-request';
5
+ profileId: string;
6
+ handoffId: string;
7
+ marketplaceOrigin: string;
8
+ transport: 'AGENT_API' | 'BROWSER';
9
+ proofOrigin: string | null;
10
+ audience: string;
11
+ accountId?: string;
12
+ identityId?: string;
13
+ controller: {
14
+ network: 'ATTO';
15
+ address: string;
16
+ index: number;
17
+ };
18
+ purpose: string;
19
+ action: Record<string, unknown>;
20
+ challenge: {
21
+ challengeId: string;
22
+ message: string;
23
+ issuedAt: string;
24
+ expiresAt: string;
25
+ };
26
+ }
27
+ /** Internal Marketplace owner contract; the standalone CLI remains Atto-only. */
28
+ export type MarketplaceUserProofApprovalRequest = Omit<MarketplaceProofApprovalRequest, 'controller'> & {
29
+ controller: {
30
+ network: 'ATTO' | 'NANO';
31
+ address: string;
32
+ index: number;
33
+ };
34
+ };
35
+ /** Exact typed validation shared by Marketplace's terminal and native signers. */
36
+ export declare function validateMarketplaceUserProofApproval(input: unknown, options: {
37
+ network: 'ATTO' | 'NANO';
38
+ nativeNetwork: string;
39
+ now?: number;
40
+ allowExpired?: boolean;
41
+ }): MarketplaceUserProofApprovalRequest;
42
+ export interface MarketplaceProofApprovalResponse {
43
+ version: 1;
44
+ type: 'marketplace-controller-approval-response';
45
+ profileId: string;
46
+ handoffId: string;
47
+ requestDigest: string;
48
+ challengeId: string;
49
+ message: string;
50
+ signature: string;
51
+ controllerAddress: string;
52
+ controllerIndex: number;
53
+ }
54
+ export interface MarketplaceProofApprovalPreview {
55
+ profileId: string;
56
+ handoffId: string;
57
+ marketplaceOrigin: string;
58
+ transport: 'AGENT_API' | 'BROWSER';
59
+ proofOrigin: string | null;
60
+ audience: string;
61
+ accountId?: string;
62
+ identityId?: string;
63
+ controller: {
64
+ network: 'ATTO';
65
+ address: string;
66
+ index: number;
67
+ };
68
+ purpose: string;
69
+ challengeId: string;
70
+ issuedAt: string;
71
+ expiresAt: string;
72
+ action: Record<string, unknown>;
73
+ }
74
+ export declare function inspectMarketplaceProofApproval(input: unknown, connection: MarketplaceConnection | undefined, knownAddress: (index: number) => string | undefined): {
75
+ request: MarketplaceProofApprovalRequest;
76
+ preview: MarketplaceProofApprovalPreview;
77
+ };
78
+ export declare function approvalRequestDigest(request: MarketplaceProofApprovalRequest): string;
79
+ export declare function createMarketplaceProofApprovalResponse(request: MarketplaceProofApprovalRequest, signature: string): MarketplaceProofApprovalResponse;
80
+ export declare function canonicalJson(value: unknown): string;
81
+ export declare function normalizeDisputeText(value: string): string;
82
+ export declare function normalizeEvidenceUrls(value: unknown): string[] | undefined;