Skip to content

docs(readme): lead with End-Cell (recommended) + bump 1.4.0#9

Merged
ValidPay-io merged 2 commits into
mainfrom
docs/end-cell-readme
Jul 2, 2026
Merged

docs(readme): lead with End-Cell (recommended) + bump 1.4.0#9
ValidPay-io merged 2 commits into
mainfrom
docs/end-cell-readme

Conversation

@ValidPay-io

Copy link
Copy Markdown
Owner

The README never mentioned End-Cell even though the SDK has had createEndCellIntent (src/client.ts:186) since 2026-06-21, and the published npm version (1.3.0, 2026-06-19) predates it entirely.

README (mirrors node PR #16's structure)

  • Quick start rewritten around createEndCellIntentverifyIntent (rail share fetched from the independent KeyHalve rail, Ed25519 signature verified against a pinned key, fail-closed).
  • New "Building a verification URL" section — canonical https://verify.keyhalve.com/verify/<id>#key=<base64url ShareA>.
  • New "End-Cell (recommended)" API section; railBaseUrl / railPublicKeySpki documented in the client options table.
  • Stronger warning than node/python: this SDK's createIntent is the legacy FULL-single-key flow — no key split at all (the returned key is the complete AES key). Node/Python createIntent default to 2-share split-key; here the 2-share option is createSplitKeyIntent (not deprecated in this SDK).

Version bump (included here since published 1.3.0 lacks End-Cell)

  • package.json 1.3.0 → 1.4.0 + CHANGELOG entry (End-Cell issuance + rail verify, canonical verify origin, End-Cell-first README).
  • Verified: the v1.3.0 tag's src/client.ts contains no createEndCellIntent, so the npm publish must be a new version.

Checks

  • npm ci + npm test: 100/100 passed locally.
  • No package-lock.json changes.

Publish stays Mike-gated per release — do not merge/tag/publish without explicit go.

🤖 Generated with Claude Code

Mike and others added 2 commits July 2, 2026 15:13
…y warning on createIntent

- Quick start rewritten around createEndCellIntent + verifyIntent rail flow
- 'Building a verification URL' section: verify.keyhalve.com + base64url fragment
- 'End-Cell (recommended)' API section; rail options in the client table
- explicit warning: this SDK's createIntent is the legacy FULL-single-key
  flow (no key split at all, unlike Node/Python)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
… origin

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@ValidPay-io
ValidPay-io merged commit 8327205 into main Jul 2, 2026
2 checks passed
@ValidPay-io
ValidPay-io deleted the docs/end-cell-readme branch July 2, 2026 20:27
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