@0gfoundation/0g-agentdna 0.4.0 → 0.5.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 (255) hide show
  1. package/GUIDE.md +190 -40
  2. package/OPERATORS.md +164 -0
  3. package/OPERATORS.zh.md +141 -0
  4. package/PROVIDERS.md +6 -0
  5. package/PROVIDERS.zh.md +3 -1
  6. package/README.md +84 -11
  7. package/dist/AgentClient.d.ts +374 -26
  8. package/dist/AgentClient.d.ts.map +1 -1
  9. package/dist/AgentClient.js +323 -40
  10. package/dist/AgentClient.js.map +1 -1
  11. package/dist/AgenticID.d.ts +170 -80
  12. package/dist/AgenticID.d.ts.map +1 -1
  13. package/dist/AgenticID.js +300 -42
  14. package/dist/AgenticID.js.map +1 -1
  15. package/dist/AttestorClient.d.ts +115 -31
  16. package/dist/AttestorClient.d.ts.map +1 -1
  17. package/dist/AttestorClient.js +276 -56
  18. package/dist/AttestorClient.js.map +1 -1
  19. package/dist/Credentials.d.ts +574 -0
  20. package/dist/Credentials.d.ts.map +1 -0
  21. package/dist/Credentials.js +838 -0
  22. package/dist/Credentials.js.map +1 -0
  23. package/dist/Operators.d.ts +60 -0
  24. package/dist/Operators.d.ts.map +1 -0
  25. package/dist/Operators.js +38 -0
  26. package/dist/Operators.js.map +1 -0
  27. package/dist/Providers.d.ts +13 -0
  28. package/dist/Providers.d.ts.map +1 -1
  29. package/dist/Providers.js +20 -1
  30. package/dist/Providers.js.map +1 -1
  31. package/dist/Releases.d.ts +51 -0
  32. package/dist/Releases.d.ts.map +1 -0
  33. package/dist/Releases.js +72 -0
  34. package/dist/Releases.js.map +1 -0
  35. package/dist/ReputationClient.d.ts +47 -3
  36. package/dist/ReputationClient.d.ts.map +1 -1
  37. package/dist/ReputationClient.js +204 -78
  38. package/dist/ReputationClient.js.map +1 -1
  39. package/dist/ServeProof.d.ts +70 -23
  40. package/dist/ServeProof.d.ts.map +1 -1
  41. package/dist/ServeProof.js +94 -35
  42. package/dist/ServeProof.js.map +1 -1
  43. package/dist/ServeSession.d.ts +17 -2
  44. package/dist/ServeSession.d.ts.map +1 -1
  45. package/dist/ServeSession.js +77 -9
  46. package/dist/ServeSession.js.map +1 -1
  47. package/dist/Settings.d.ts +25 -1
  48. package/dist/Settings.d.ts.map +1 -1
  49. package/dist/Settings.js +53 -1
  50. package/dist/Settings.js.map +1 -1
  51. package/dist/TrustRegistry.d.ts +28 -0
  52. package/dist/TrustRegistry.d.ts.map +1 -0
  53. package/dist/TrustRegistry.js +67 -0
  54. package/dist/TrustRegistry.js.map +1 -0
  55. package/dist/abi.d.ts +346 -34
  56. package/dist/abi.d.ts.map +1 -1
  57. package/dist/abi.js +150 -30
  58. package/dist/abi.js.map +1 -1
  59. package/dist/cli/attach.d.ts +79 -0
  60. package/dist/cli/attach.d.ts.map +1 -0
  61. package/dist/cli/attach.js +253 -0
  62. package/dist/cli/attach.js.map +1 -0
  63. package/dist/cli/commands/cells.d.ts +45 -0
  64. package/dist/cli/commands/cells.d.ts.map +1 -1
  65. package/dist/cli/commands/cells.js +77 -0
  66. package/dist/cli/commands/cells.js.map +1 -1
  67. package/dist/cli/commands/cred.d.ts +12 -0
  68. package/dist/cli/commands/cred.d.ts.map +1 -0
  69. package/dist/cli/commands/cred.js +43 -0
  70. package/dist/cli/commands/cred.js.map +1 -0
  71. package/dist/cli/commands/doctor.d.ts.map +1 -1
  72. package/dist/cli/commands/doctor.js +44 -35
  73. package/dist/cli/commands/doctor.js.map +1 -1
  74. package/dist/cli/commands/interactive.d.ts +597 -21
  75. package/dist/cli/commands/interactive.d.ts.map +1 -1
  76. package/dist/cli/commands/interactive.js +5082 -1323
  77. package/dist/cli/commands/interactive.js.map +1 -1
  78. package/dist/cli/commands/list.d.ts +5 -5
  79. package/dist/cli/commands/list.d.ts.map +1 -1
  80. package/dist/cli/commands/list.js +21 -26
  81. package/dist/cli/commands/list.js.map +1 -1
  82. package/dist/cli/commands/providers.d.ts +4 -0
  83. package/dist/cli/commands/providers.d.ts.map +1 -1
  84. package/dist/cli/commands/providers.js +19 -5
  85. package/dist/cli/commands/providers.js.map +1 -1
  86. package/dist/cli/commands/releases.d.ts +13 -0
  87. package/dist/cli/commands/releases.d.ts.map +1 -0
  88. package/dist/cli/commands/releases.js +65 -0
  89. package/dist/cli/commands/releases.js.map +1 -0
  90. package/dist/cli/commands/settings.d.ts +5 -0
  91. package/dist/cli/commands/settings.d.ts.map +1 -1
  92. package/dist/cli/commands/settings.js +70 -24
  93. package/dist/cli/commands/settings.js.map +1 -1
  94. package/dist/cli/commands/status.d.ts +2 -1
  95. package/dist/cli/commands/status.d.ts.map +1 -1
  96. package/dist/cli/commands/status.js +22 -19
  97. package/dist/cli/commands/status.js.map +1 -1
  98. package/dist/cli/config.d.ts +48 -1
  99. package/dist/cli/config.d.ts.map +1 -1
  100. package/dist/cli/config.js +114 -5
  101. package/dist/cli/config.js.map +1 -1
  102. package/dist/cli/credentials.d.ts +179 -0
  103. package/dist/cli/credentials.d.ts.map +1 -0
  104. package/dist/cli/credentials.js +1443 -0
  105. package/dist/cli/credentials.js.map +1 -0
  106. package/dist/cli/download.d.ts +21 -0
  107. package/dist/cli/download.d.ts.map +1 -0
  108. package/dist/cli/download.js +89 -0
  109. package/dist/cli/download.js.map +1 -0
  110. package/dist/cli/env.d.ts +6 -0
  111. package/dist/cli/env.d.ts.map +1 -1
  112. package/dist/cli/env.js +18 -6
  113. package/dist/cli/env.js.map +1 -1
  114. package/dist/cli/envelope.d.ts +4 -2
  115. package/dist/cli/envelope.d.ts.map +1 -1
  116. package/dist/cli/envelope.js +10 -6
  117. package/dist/cli/envelope.js.map +1 -1
  118. package/dist/cli/errors.d.ts +45 -1
  119. package/dist/cli/errors.d.ts.map +1 -1
  120. package/dist/cli/errors.js +77 -0
  121. package/dist/cli/errors.js.map +1 -1
  122. package/dist/cli/inference.d.ts.map +1 -1
  123. package/dist/cli/inference.js +7 -0
  124. package/dist/cli/inference.js.map +1 -1
  125. package/dist/cli/inkView.d.ts +341 -0
  126. package/dist/cli/inkView.d.ts.map +1 -0
  127. package/dist/cli/inkView.js +1019 -0
  128. package/dist/cli/inkView.js.map +1 -0
  129. package/dist/cli/legacy/modelKey.d.ts +24 -0
  130. package/dist/cli/legacy/modelKey.d.ts.map +1 -0
  131. package/dist/cli/legacy/modelKey.js +32 -0
  132. package/dist/cli/legacy/modelKey.js.map +1 -0
  133. package/dist/cli/livePrompt.d.ts +212 -0
  134. package/dist/cli/livePrompt.d.ts.map +1 -0
  135. package/dist/cli/livePrompt.js +576 -0
  136. package/dist/cli/livePrompt.js.map +1 -0
  137. package/dist/cli/main.js +206 -72
  138. package/dist/cli/main.js.map +1 -1
  139. package/dist/cli/modelkey.d.ts +64 -0
  140. package/dist/cli/modelkey.d.ts.map +1 -0
  141. package/dist/cli/modelkey.js +113 -0
  142. package/dist/cli/modelkey.js.map +1 -0
  143. package/dist/cli/outboxSync.d.ts +51 -0
  144. package/dist/cli/outboxSync.d.ts.map +1 -0
  145. package/dist/cli/outboxSync.js +210 -0
  146. package/dist/cli/outboxSync.js.map +1 -0
  147. package/dist/cli/plain.d.ts +46 -0
  148. package/dist/cli/plain.d.ts.map +1 -0
  149. package/dist/cli/plain.js +260 -0
  150. package/dist/cli/plain.js.map +1 -0
  151. package/dist/cli/proofs.d.ts +5 -0
  152. package/dist/cli/proofs.d.ts.map +1 -1
  153. package/dist/cli/proofs.js +20 -0
  154. package/dist/cli/proofs.js.map +1 -1
  155. package/dist/cli/ref.d.ts.map +1 -1
  156. package/dist/cli/ref.js +3 -2
  157. package/dist/cli/ref.js.map +1 -1
  158. package/dist/cli/releaseNotice.d.ts +64 -0
  159. package/dist/cli/releaseNotice.d.ts.map +1 -0
  160. package/dist/cli/releaseNotice.js +194 -0
  161. package/dist/cli/releaseNotice.js.map +1 -0
  162. package/dist/cli/sdk.d.ts +18 -0
  163. package/dist/cli/sdk.d.ts.map +1 -1
  164. package/dist/cli/sdk.js +99 -1
  165. package/dist/cli/sdk.js.map +1 -1
  166. package/dist/cli/settings.d.ts +87 -6
  167. package/dist/cli/settings.d.ts.map +1 -1
  168. package/dist/cli/settings.js +270 -18
  169. package/dist/cli/settings.js.map +1 -1
  170. package/dist/cli/textfit.d.ts +28 -0
  171. package/dist/cli/textfit.d.ts.map +1 -0
  172. package/dist/cli/textfit.js +111 -0
  173. package/dist/cli/textfit.js.map +1 -0
  174. package/dist/constants.d.ts +1 -1
  175. package/dist/constants.js +1 -1
  176. package/dist/context.d.ts +26 -0
  177. package/dist/context.d.ts.map +1 -1
  178. package/dist/context.js +1 -0
  179. package/dist/context.js.map +1 -1
  180. package/dist/index.d.ts +19 -11
  181. package/dist/index.d.ts.map +1 -1
  182. package/dist/index.js +35 -2
  183. package/dist/index.js.map +1 -1
  184. package/dist/legacy/modelKey.d.ts +67 -0
  185. package/dist/legacy/modelKey.d.ts.map +1 -0
  186. package/dist/legacy/modelKey.js +80 -0
  187. package/dist/legacy/modelKey.js.map +1 -0
  188. package/dist/legacy/serveProofV1.d.ts +56 -0
  189. package/dist/legacy/serveProofV1.d.ts.map +1 -0
  190. package/dist/legacy/serveProofV1.js +91 -0
  191. package/dist/legacy/serveProofV1.js.map +1 -0
  192. package/dist/provider-catalog.json +3 -2
  193. package/dist/secretEnv.d.ts +18 -3
  194. package/dist/secretEnv.d.ts.map +1 -1
  195. package/dist/secretEnv.js +16 -2
  196. package/dist/secretEnv.js.map +1 -1
  197. package/dist/types.d.ts +63 -1
  198. package/dist/types.d.ts.map +1 -1
  199. package/dist/viemErrors.d.ts +30 -0
  200. package/dist/viemErrors.d.ts.map +1 -0
  201. package/dist/viemErrors.js +36 -0
  202. package/dist/viemErrors.js.map +1 -0
  203. package/package.json +5 -1
  204. package/src/AgentClient.ts +622 -68
  205. package/src/AgenticID.ts +345 -56
  206. package/src/AttestorClient.ts +330 -83
  207. package/src/Credentials.ts +1027 -0
  208. package/src/Operators.ts +71 -0
  209. package/src/Providers.ts +20 -0
  210. package/src/Releases.ts +95 -0
  211. package/src/ReputationClient.ts +231 -79
  212. package/src/ServeProof.ts +123 -39
  213. package/src/ServeSession.ts +91 -9
  214. package/src/Settings.ts +61 -1
  215. package/src/TrustRegistry.ts +75 -0
  216. package/src/abi.ts +153 -30
  217. package/src/cli/attach.ts +257 -0
  218. package/src/cli/commands/cells.ts +104 -0
  219. package/src/cli/commands/cred.ts +44 -0
  220. package/src/cli/commands/doctor.ts +45 -37
  221. package/src/cli/commands/interactive.ts +4120 -664
  222. package/src/cli/commands/list.ts +21 -30
  223. package/src/cli/commands/providers.ts +17 -4
  224. package/src/cli/commands/releases.ts +60 -0
  225. package/src/cli/commands/settings.ts +75 -28
  226. package/src/cli/commands/status.ts +24 -21
  227. package/src/cli/config.ts +119 -4
  228. package/src/cli/credentials.ts +1379 -0
  229. package/src/cli/download.ts +80 -0
  230. package/src/cli/env.ts +22 -7
  231. package/src/cli/envelope.ts +10 -6
  232. package/src/cli/errors.ts +92 -0
  233. package/src/cli/inference.ts +8 -1
  234. package/src/cli/inkView.ts +969 -0
  235. package/src/cli/legacy/modelKey.ts +35 -0
  236. package/src/cli/livePrompt.ts +615 -0
  237. package/src/cli/main.ts +206 -76
  238. package/src/cli/modelkey.ts +124 -0
  239. package/src/cli/outboxSync.ts +231 -0
  240. package/src/cli/plain.ts +260 -0
  241. package/src/cli/proofs.ts +27 -0
  242. package/src/cli/ref.ts +5 -4
  243. package/src/cli/releaseNotice.ts +200 -0
  244. package/src/cli/sdk.ts +87 -7
  245. package/src/cli/settings.ts +272 -22
  246. package/src/cli/textfit.ts +95 -0
  247. package/src/constants.ts +1 -1
  248. package/src/context.ts +28 -0
  249. package/src/index.ts +50 -7
  250. package/src/legacy/modelKey.ts +80 -0
  251. package/src/legacy/serveProofV1.ts +124 -0
  252. package/src/provider-catalog.json +3 -2
  253. package/src/secretEnv.ts +18 -3
  254. package/src/types.ts +60 -1
  255. package/src/viemErrors.ts +39 -0
@@ -15,9 +15,11 @@ import { createPublicClient, http, formatEther, type PublicClient } from 'viem';
15
15
  import { privateKeyToAccount } from 'viem/accounts';
16
16
  import { MIN_SANDBOX_BALANCE_WEI, type AgenticID } from '../../AgenticID';
17
17
  import { RPC_URL } from '../../constants';
18
- import { buildClient } from '../sdk';
18
+ import { attestorUnreachable, buildClient } from '../sdk';
19
19
  import { renamedAttestor } from '../config';
20
- import { CliError, type ErrorCode } from '../errors';
20
+ import { attestorUrlRemedy } from '../env';
21
+ import { CliError, currentSurface, shellStep, shellTo, type ErrorCode } from '../errors';
22
+ import { explainError, ogShown } from '../plain';
21
23
  import { emitOk, print } from '../envelope';
22
24
  import type { CommandContext } from '../types';
23
25
 
@@ -63,8 +65,8 @@ export async function run(ctx: CommandContext): Promise<void> {
63
65
  if (!env.attestorUrl) {
64
66
  checks.push({
65
67
  name: 'attestor', status: 'fail', code: 'MISSING_ATTESTOR_URL',
66
- detail: 'AGENTIC_ATTESTOR_URL is not set',
67
- remedy: 'export AGENTIC_ATTESTOR_URL=https://agentdna.0g.ai # or your own attestor',
68
+ detail: 'no attestor URL is set',
69
+ remedy: attestorUrlRemedy(),
68
70
  });
69
71
  } else {
70
72
  try {
@@ -76,28 +78,34 @@ export async function run(ctx: CommandContext): Promise<void> {
76
78
  detail: current ? `${env.attestorUrl} (now ${current}; the earlier name still answers — update AGENTIC_ATTESTOR_URL)` : env.attestorUrl,
77
79
  });
78
80
  } catch (e) {
79
- checks.push({
80
- name: 'attestor', status: 'fail', code: 'ATTESTOR_UNREACHABLE',
81
- detail: `GET ${env.attestorUrl}/config failed: ${(e as Error).message}`,
82
- remedy: 'verify AGENTIC_ATTESTOR_URL and your network, then retry',
83
- });
81
+ // As every other command says it: a garbage address is not "did not answer".
82
+ const why = attestorUnreachable(env, e);
83
+ checks.push({ name: 'attestor', status: 'fail', code: 'ATTESTOR_UNREACHABLE', detail: why.message, remedy: why.remedy });
84
84
  }
85
85
  }
86
86
 
87
- // 2 — RPC connectivity (explicit-wins: env override > attestor /config > SDK default)
88
- const rpcUrl = env.rpcUrl ?? cfg?.chain_rpc ?? RPC_URL;
89
- const publicClient: PublicClient = createPublicClient({ transport: http(rpcUrl) });
87
+ // 2 — RPC connectivity (explicit-wins: env override > attestor /config > SDK
88
+ // default). Without an override the chain is the attestor's: with no
89
+ // attestor to name it, there is no chain to probe (never a default one the
90
+ // owner did not pick).
91
+ const rpcUrl = env.rpcUrl ?? (cfg ? cfg.chain_rpc ?? RPC_URL : undefined);
92
+ const publicClient: PublicClient | null = rpcUrl ? createPublicClient({ transport: http(rpcUrl) }) : null;
90
93
  let rpcOk = false;
91
- try {
92
- const chainId = await publicClient.getChainId();
93
- rpcOk = true;
94
- checks.push({ name: 'rpc', status: 'pass', detail: `${rpcUrl} (chainId ${chainId})` });
95
- } catch (e) {
96
- checks.push({
97
- name: 'rpc', status: 'fail', code: 'RPC_UNREACHABLE',
98
- detail: `${rpcUrl}: ${(e as Error).message}`,
99
- remedy: 'set AGENTIC_RPC_URL to a reachable 0G RPC (an attestor /config may advertise an internal-only one)',
100
- });
94
+ if (!publicClient) {
95
+ skip('rpc', "needs the attestor's /config, or AGENTIC_RPC_URL");
96
+ } else {
97
+ try {
98
+ const chainId = await publicClient.getChainId();
99
+ rpcOk = true;
100
+ checks.push({ name: 'rpc', status: 'pass', detail: `${rpcUrl} (chainId ${chainId})` });
101
+ } catch (e) {
102
+ const p = explainError(e);
103
+ checks.push({
104
+ name: 'rpc', status: 'fail', code: 'RPC_UNREACHABLE',
105
+ detail: p.code === 'RPC_UNREACHABLE' ? p.message : `${rpcUrl}: ${p.message}`,
106
+ remedy: 'set AGENTIC_RPC_URL to a reachable 0G RPC (an attestor /config may advertise an internal-only one)',
107
+ });
108
+ }
101
109
  }
102
110
 
103
111
  // 3 — wallet configured. Absent = skip (matching gas/ack/sandboxBalance,
@@ -107,27 +115,29 @@ export async function run(ctx: CommandContext): Promise<void> {
107
115
  checks.push({
108
116
  name: 'wallet', status: 'skip', code: 'WALLET_REQUIRED',
109
117
  detail: 'no owner key configured (owner checks skipped)',
110
- remedy: 'run `login`, or export AGENTIC_PRIVATE_KEY=0x… # env only — no flag, by design',
118
+ remedy: currentSurface() === 'shell'
119
+ ? `${shellStep('login')} saves it`
120
+ : `${shellStep('login')}, or export AGENTIC_PRIVATE_KEY=0x… # env only — no flag, by design`,
111
121
  });
112
122
  } else if (!/^0x[0-9a-fA-F]{64}$/.test(env.privateKey)) {
113
123
  checks.push({
114
124
  name: 'wallet', status: 'fail', code: 'WALLET_REQUIRED',
115
- detail: 'the configured owner key is malformed (expected 64 hex chars, 0x prefix optional)',
116
- remedy: 'export AGENTIC_PRIVATE_KEY=0x<64 hex chars>',
125
+ detail: `${env.privateKeySource === 'file' ? 'the owner key saved by login' : 'AGENTIC_PRIVATE_KEY'} is malformed (expected 64 hex chars, 0x prefix optional)`,
126
+ remedy: env.privateKeySource === 'file' ? shellTo('login', 'enter the key again') : 'export AGENTIC_PRIVATE_KEY=0x<64 hex chars>',
117
127
  });
118
128
  } else {
119
129
  owner = privateKeyToAccount(env.privateKey).address;
120
- checks.push({ name: 'wallet', status: 'pass', detail: `${owner} (from AGENTIC_PRIVATE_KEY)` });
130
+ checks.push({ name: 'wallet', status: 'pass', detail: `${owner} (${env.privateKeySource === 'file' ? 'saved by login' : 'from AGENTIC_PRIVATE_KEY'})` });
121
131
  }
122
132
 
123
133
  // 4 — gas: the owner must be able to pay for ack/deposit txs at all
124
134
  if (!owner) skip('gas', 'needs wallet');
125
- else if (!rpcOk) skip('gas', 'needs rpc');
135
+ else if (!rpcOk || !publicClient) skip('gas', 'needs rpc');
126
136
  else {
127
137
  try {
128
138
  const bal = await publicClient.getBalance({ address: owner });
129
139
  if (bal > 0n) {
130
- checks.push({ name: 'gas', status: 'pass', detail: `${formatEther(bal)} OG` });
140
+ checks.push({ name: 'gas', status: 'pass', detail: ogShown(bal) });
131
141
  } else {
132
142
  checks.push({
133
143
  name: 'gas', status: 'fail', code: 'PREFLIGHT_GAS',
@@ -138,7 +148,7 @@ export async function run(ctx: CommandContext): Promise<void> {
138
148
  } catch (e) {
139
149
  checks.push({
140
150
  name: 'gas', status: 'fail', code: 'PREFLIGHT_GAS',
141
- detail: `could not read balance: ${(e as Error).message}`,
151
+ detail: `could not read balance: ${explainError(e).message}`,
142
152
  remedy: 'check RPC connectivity, then retry',
143
153
  });
144
154
  }
@@ -171,15 +181,13 @@ export async function run(ctx: CommandContext): Promise<void> {
171
181
  checks.push({
172
182
  name: 'ack', status: 'fail', code: 'PREFLIGHT_ACK',
173
183
  detail: `not acknowledged: ${missing.join(', ')}`,
174
- // Stage-0 exception (spec §2.2): no `ack` CLI command yet — the
175
- // remedy is guidance text until stage 1 promotes it to a command.
176
- remedy: 'run `ack` in the interactive shell (or SDK: await ag.ack())',
184
+ remedy: shellStep('ack'),
177
185
  });
178
186
  }
179
187
  } catch (e) {
180
188
  checks.push({
181
189
  name: 'ack', status: 'fail', code: 'PREFLIGHT_ACK',
182
- detail: `could not read ack status: ${(e as Error).message}`,
190
+ detail: `could not read ack status: ${explainError(e).message}`,
183
191
  remedy: 'verify the attestor environment, then retry',
184
192
  });
185
193
  }
@@ -192,18 +200,18 @@ export async function run(ctx: CommandContext): Promise<void> {
192
200
  try {
193
201
  const bal = await ag.getBalance({ user: owner });
194
202
  if (bal >= MIN_SANDBOX_BALANCE_WEI) {
195
- checks.push({ name: 'sandboxBalance', status: 'pass', detail: `${formatEther(bal)} OG (≥ 0.1 floor)` });
203
+ checks.push({ name: 'sandboxBalance', status: 'pass', detail: `${ogShown(bal)} (≥ 0.1 floor)` });
196
204
  } else {
197
205
  checks.push({
198
206
  name: 'sandboxBalance', status: 'fail', code: 'PREFLIGHT_BALANCE',
199
- detail: `${formatEther(bal)} OG — below the 0.1 OG deploy floor`,
200
- remedy: "run `deposit` in the interactive shell (or SDK: await ag.deposit({ amountWei: parseEther('0.1') }))",
207
+ detail: `${ogShown(bal)} — below the 0.1 OG deploy floor`,
208
+ remedy: shellStep(`deposit ${formatEther(MIN_SANDBOX_BALANCE_WEI - bal)}`),
201
209
  });
202
210
  }
203
211
  } catch (e) {
204
212
  checks.push({
205
213
  name: 'sandboxBalance', status: 'fail', code: 'PREFLIGHT_BALANCE',
206
- detail: `could not read sandbox balance: ${(e as Error).message}`,
214
+ detail: `could not read sandbox balance: ${explainError(e).message}`,
207
215
  remedy: 'verify the attestor environment, then retry',
208
216
  });
209
217
  }