Skip to content

Add a Wallet Engine tab - #31

Merged
bitwalt merged 3 commits into
mainfrom
docs/wallet-engine-section
Sep 1, 2026
Merged

bitwalt merged 3 commits into
mainfrom
docs/wallet-engine-section

Conversation

@bitwalt

@bitwalt bitwalt commented Aug 11, 2026

Copy link
Copy Markdown
Member

@kaleidorg/wallet-engine appears on the docs site only as prose in introduction, architecture and glossary — no quickstart, no concepts, no API surface. A developer who hasn't already found the GitHub repo has nowhere to land, even though the package is public, MIT, and powers the extension, rate and the desktop agent.

What's here

Four pages under a new Wallet Engine tab, placed after SDK so the two developer surfaces sit together (21-line docs.json insertion, no other nav change):

Page Covers
introduction the problem, the four cross-protocol primitives, protocol + maturity table
getting-started the offline tour first, then install, optional peer deps, first wallet, platform injection
concepts contract and capability groups, manifest, router, unified receive, disclosure, ports, swaps
adding-a-protocol the three files a new protocol touches — and nothing else

Accuracy

Two things are documented as the code actually behaves rather than as the design intent reads. Both were drafted the other way first and corrected against source:

  • KaleidoswapSwap.executeSwap binds on rfqId + exact amounts + an expiry check. There is no client-side slippage bound in src/swap/ — the only slippageBps in the engine is in lib/orchestra-client.ts, a different path.
  • Missing platform storage is handled two ways, not uniformly fail-loud: the Boltz chain-swap store throws NO_PLATFORM rather than hand out a derivation index it cannot persist, while Spark sent-token records fall back to an in-memory map.

Depends on nothing, but reads best alongside kaleidoswap/wallet-engine#66, which adds the npm run example:tour that getting-started opens with.

🤖 Generated with Claude Code

bitwalt and others added 3 commits August 11, 2026 13:59
`@kaleidorg/wallet-engine` appeared on the docs site only as prose in
introduction/architecture/glossary — no quickstart, no concepts, no API
surface. A developer who hasn't already found the repo has nowhere to land.

Adds four pages under a new tab, placed after SDK so the two developer
surfaces sit together:

- introduction    — the problem, the four primitives, protocol/maturity table
- getting-started — the offline tour first, then install, peer deps, first wallet
- concepts        — contract, manifest, router, unified receive, disclosure,
                    ports, swaps
- adding-a-protocol — the three files a new protocol touches, and nothing else

Two things are documented as the code actually behaves rather than as the
design intent reads: `KaleidoswapSwap.executeSwap` binds on rfqId + exact
amounts + an expiry check (there is no client-side slippage bound), and
platform-storage absence is handled two ways — the Boltz chain-swap store
throws NO_PLATFORM rather than hand out an unpersisted derivation index,
while Spark sent-token records fall back to an in-memory map.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
- drop receiverAddress/receiverAddressFormat from the executeSwap
  example — neither exists on Quote and KaleidoswapSwap never reads
  them; note that payout settles to the bound account
- fix IOnchainOperations and ISparkOperations descriptions and add
  the omitted ISimplicityOperations group
- remove the desktop-agent consumer claim (desktop drives an RLN
  node directly, not wallet-engine)
- note @kaleidorg/swap-sdk as a peer of the /swap subpath's Boltz venue

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…nto the en nav

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@bitwalt
bitwalt merged commit b4aaffe into main Sep 1, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant