Skip to content

Upgrade docs to @bsv/sdk 3.2 identity search recovery - #13

Open
sirdeggen wants to merge 1 commit into
mainfrom
cursor/sdk-3-identity-search-82fe
Open

sirdeggen wants to merge 1 commit into
mainfrom
cursor/sdk-3-identity-search-82fe

Conversation

@sirdeggen

Copy link
Copy Markdown
Collaborator

Ready for review by @sirdeggen. Do not merge from this change.

Summary

  • Bump @bsv/sdk from ^2.8.11 to ^3.2.0.
  • Bump @bsv/wallet-toolbox-client to ^2.14.6 and @bsv/message-box-client to ^2.6.0, the current releases whose peers accept SDK 3.
  • Update the Identity snippets, topic copy, README, and public/llm-training-guide.txt to the SDK 3.2.0 identity search recovery API used by identity-react#17.

Identity search recovery

resolveByAttributes and resolveByIdentityKey now opt in with { useContacts: true }. Contacts lookups stay optional. contactErrorMode: 'fallback' and contactTimeoutMs: 2000 bound that wait at 2 seconds; the deadline does not cancel a wallet prompt.

A Contacts failure or timeout still returns public results and surfaces Saved contacts are unavailable. Results may exclude saved contacts. A public lookup failure stays a failure (Identity lookup failed. Check wallet access and try again.) until retryResolveIdentityKey / retryResolveKnownIdentityKey repeats the same query. Only complete results are cached. A newer query ignores a late response from the one it superseded.

React apps can use @bsv/identity-react 2.x (React 18, Node 22) for the same recovery behavior.

Verification

  • npm test (74 tests)
  • npm run typecheck
  • npm run lint (existing warnings only)
  • npm run build
  • npm run build:snippets
  • Browser check of /?topic=identity: SDK v3 subtitle, both identity cards, the warning string, and the recovery options in the shown code.
Open in Web Open in Cursor 

Bump the SDK to 3.2.0 and the wallet and message-box clients to releases that accept SDK 3. Show optional Contacts lookups with a 2s deadline, the partial-result warning, public lookup retry, and complete-result caching.

Co-authored-by: deggen <d.kellenschwiler@bsvassociation.org>
@vercel

vercel Bot commented Oct 7, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
wallet-client-intro Ready Ready Preview Oct 7, 2026 4:27pm UTC

Request Review

This branch was successfully deployed

1 active deployment
Preview — 83d3d5c0 Deployed Oct 7, 2026 by vercel[bot]
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.

2 participants