Skip to content

Commit 94e5692

Browse files
committed
style: apply prettier across new files
1 parent 29880cb commit 94e5692

14 files changed

Lines changed: 139 additions & 71 deletions

docs/brainstorms/2026-05-07-hcloud-multi-service-sdk-requirements.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ broader scope.
5858
When `projectId` is omitted, the SDK uses `selectedProject` from the active session.
5959
- **R7. Service calls authenticate transparently with the persisted API key.**
6060
Once `auth.login` has produced an API key, the SDK persists it and all
61-
`client.atlantic.*` and future-service calls use it automatically — *forever*,
61+
`client.atlantic.*` and future-service calls use it automatically — _forever_,
6262
no re-login required. Bearer access/refresh tokens are only consulted when the
6363
user invokes auth/api-key operations (refreshing the session, listing/creating
6464
keys). A user who only consumes Atlantic never needs to refresh the session
@@ -98,7 +98,7 @@ broader scope.
9898
file under `~/.hcloud/` with restrictive permissions; KMS/hardware support is
9999
enabled via the signer interface but the SDK does not ship integrations.
100100
- **Out of scope: implementing storage-proof / data-processor / DSI / satellite
101-
surfaces.** R1–R3 only require the *shape* that lets them be added later; this
101+
surfaces.** R1–R3 only require the _shape_ that lets them be added later; this
102102
brainstorm does not define their operations.
103103
- **Out of scope: billing UI, invoices, payments, project management beyond
104104
reading `selectedProject` and minting/listing API keys.** Anything else under

docs/brainstorms/atlantic-bun-sdk-requirements.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -63,6 +63,7 @@ The SDK should make Atlantic easier to use from Bun and TypeScript projects with
6363
## Requirements
6464

6565
**API coverage**
66+
6667
- R1. The SDK must expose typed methods for every public Atlantic API capability documented in the current Atlantic OpenAPI contract: health check, submit query, get query by ID, get query by dedup ID, list queries, query stats, query jobs, retry query, list buckets, create bucket, get bucket details, and close bucket.
6768
- R2. Query submission must support the documented Atlantic inputs and options, including program, input, PIE, and proof file inputs; Cairo version and VM options; result selection; layouts; prover selection; declared job size; network selection; deduplication identifiers; external identifiers; and bucket-related fields.
6869
- R3. Query lookup must support direct query ID lookup and deduplication-key lookup as separate explicit capabilities.
@@ -72,24 +73,28 @@ The SDK should make Atlantic easier to use from Bun and TypeScript projects with
7273
- R7. Bucket support must cover listing buckets, creating buckets, fetching bucket details with associated queries, closing buckets, and submitting bucket-linked queries where the API permits them.
7374

7475
**Agent-first workflow helpers**
76+
7577
- R8. The SDK must include higher-level helpers for common workflows: submit-and-return-ID, submit-and-wait, wait-for-query, retry-if-retriable, get-query-with-jobs, and bucket-oriented submission.
7678
- R9. Workflow helpers must preserve caller control over polling intervals, timeout budgets, retry budgets, and terminal-state behavior.
7779
- R10. The SDK must keep Atlantic query IDs, dedup IDs, and bucket IDs visible as first-class outputs rather than hiding them inside opaque workflow results.
7880
- R11. Agent-facing helper descriptions must include what the helper does, when to use it, required inputs, important constraints, expected result, and common failure modes.
7981

8082
**x402 payments**
83+
8184
- R12. The SDK must support Atlantic's documented x402 v2 flow for `submit query`, including challenge parsing, payment-signature retry, and settlement-response parsing.
8285
- R13. The SDK must support both API-key fallback payments and anonymous wallet payments, while making their behavioral differences explicit to the caller.
8386
- R14. The SDK must prevent or clearly warn against unsafe x402 usage: preemptive payment signatures, reused successful payment signatures, hardcoded payment requirements, anonymous `dedupId` usage, anonymous bucket usage, and double-payment after ambiguous settlement.
8487
- R15. x402 signing must be wallet-adapter friendly so applications can provide their own signing implementation rather than coupling the SDK to a single wallet source.
8588

8689
**CLI**
90+
8791
- R16. The CLI must expose commands for the same main capabilities as the SDK: submit query, retry query, get query details, get query by dedup ID, list queries, get query jobs, query stats, list buckets, create bucket, get bucket, close bucket, and health check.
8892
- R17. CLI commands must support file-path inputs for query submission and must print machine-readable JSON by default or through an explicit mode.
8993
- R18. CLI commands must support environment-based configuration for the Atlantic base URL, API key, and payment-related wallet configuration.
9094
- R19. CLI output must preserve important identifiers, status, payment receipt data, and error details so agents can chain commands reliably.
9195

9296
**Developer experience and quality**
97+
9398
- R20. The package must be Bun-first while remaining idiomatic TypeScript for library consumers.
9499
- R21. Public SDK methods must have clear names, strong TypeScript types, and documentation comments that explain behavior rather than merely restating parameter names.
95100
- R22. The SDK must separate low-level API methods from higher-level workflow helpers so advanced users can keep exact control while agents and common integrations get safer defaults.

docs/guides/credentials.md

Lines changed: 21 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -88,13 +88,27 @@ bookkeeping; your store only needs CRUD on `WalletEntry`s.
8888
import type { CredentialStore } from '@herodotus_dev/hcloud';
8989

9090
export class MyKeychainStore implements CredentialStore {
91-
load() { /* ... */ }
92-
save(file) { /* ... */ }
93-
activeWallet() { /* ... */ }
94-
setActive(wallet) { /* ... */ }
95-
upsertWallet(entry) { /* ... */ }
96-
removeWallet(wallet) { /* ... */ }
97-
clear() { /* ... */ }
91+
load() {
92+
/* ... */
93+
}
94+
save(file) {
95+
/* ... */
96+
}
97+
activeWallet() {
98+
/* ... */
99+
}
100+
setActive(wallet) {
101+
/* ... */
102+
}
103+
upsertWallet(entry) {
104+
/* ... */
105+
}
106+
removeWallet(wallet) {
107+
/* ... */
108+
}
109+
clear() {
110+
/* ... */
111+
}
98112
}
99113
```
100114

0 commit comments

Comments
 (0)