Skip to content

YNU-864: Native TS SDK pages polish + terminology#153

Open
ihsraham wants to merge 1 commit intodocs/reorg-for-v1from
feat/ynu-864-native-ts-sdk-polish
Open

YNU-864: Native TS SDK pages polish + terminology#153
ihsraham wants to merge 1 commit intodocs/reorg-for-v1from
feat/ynu-864-native-ts-sdk-polish

Conversation

@ihsraham
Copy link
Copy Markdown
Collaborator

@ihsraham ihsraham commented May 8, 2026

Summary

Polishes the native v1 SDK docs so builders land on the right package, use Nitronode terminology, and see source-verified TypeScript SDK shapes for channel and app-session flows.

Changes

  • Adds a pinned "Choose your SDK" table to the SDK overview, including native TypeScript, compat, Go, MCP coming soon, codemod coming soon, and contracts entrypoints.
  • Updates native TypeScript setup/config/examples with Nitronode wording, sandbox URL placeholders, setHomeBlockchain() guidance, and common error recovery patterns.
  • Rewrites the browser wallet signer example so StateSigner and TransactionSigner match the SDK interfaces.
  • Rebuilds the multi-party app-session tutorial around native v1 APIs: AppDefinitionV1, registerApp() / apps.v1.submit_app_version, packed participant signatures, deposit, operate, withdraw, and close via AppStateUpdateIntent.Close.
  • Clarifies migration-guide amount semantics and points users to the source codemod workflow until @yellow-org/nitrolite-codemod is published.
  • Cleans remaining Clearnode wording from non-compat Build SDK pages, including the Go SDK pages that the terminology guard covered.

Files to review

  • docs/nitrolite/build/sdk/index.md
  • docs/nitrolite/build/sdk/typescript/getting-started.mdx
  • docs/nitrolite/build/sdk/typescript/configuration.mdx
  • docs/nitrolite/build/sdk/typescript/api-reference.mdx
  • docs/nitrolite/build/sdk/typescript/examples.mdx
  • docs/nitrolite/build/sdk/migration-guide.md
  • docs/nitrolite/build/sdk/multi-party-app-sessions.mdx
  • docs/nitrolite/build/sdk/go/getting-started.mdx
  • docs/nitrolite/build/sdk/go/api-reference.mdx

Related PR

#149 adds the generated v1 API Reference pages. This PR names the backing RPC methods in the TypeScript SDK docs, but keeps them as code references rather than Markdown links so this branch remains build-clean before #149 lands.

Validation

  • Browser signer snippet type-checks against the local @yellow-org/sdk source interfaces.
  • vale --minAlertLevel=error on changed docs: 0 findings.
  • npm run build: succeeds; warning set is the pre-existing 0.5.x / Clearnet warning set, with no changed PR5 source page in the broken-link output.
  • go get github.com/layer-3/nitrolite/sdk/go@latest succeeds in a temporary module.
  • Local preview: http://127.0.0.1:3000/nitrolite/build/sdk/multi-party-app-sessions.

Resolves: F-008 (Build SDK slice), F-009 (typescript page slice), F-013, F-014, F-024, F-025, F-026, F-027, F-028, F-029.

- Add a pinned SDK decision table and align Build SDK terminology on Nitronode.
- Update native TypeScript setup, config, API, and examples with sandbox placeholders, error recovery, source-verified method shapes, and browser signers that compile against SDK interfaces.
- Rewrite multi-party app sessions around native v1 AppDefinitionV1, app registration, signed state updates, withdraw, and close intents.
- Clarify migration-guide amount semantics and codemod source workflow.

Resolves: F-008 (Build SDK slice), F-009 (typescript page slice), F-013, F-014, F-024, F-025, F-026, F-027, F-028, F-029.
@ihsraham ihsraham requested a review from dpatsora as a code owner May 8, 2026 08:57
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 8, 2026

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 4d5fc92d-b047-4f2b-a5a8-fa640e54e870

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/ynu-864-native-ts-sdk-polish

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

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