feat(sdk): wasm sdk core and test suite

[QuantumExplorer]

Summary by CodeRabbit

Summary by CodeRabbit

• New Features

  • Introduced comprehensive wallet functionality, including key generation, key derivation (BIP44, DIP9, DIP13, DIP14, DIP15), address validation, mnemonic generation/validation, and message signing.
  • Added support for advanced token management: claiming tokens, setting direct purchase prices, direct purchases, and configuration updates.
  • Expanded SDK UI to support wallet operations and new token transitions.
  • Implemented new query and transition parameters for voting, contested resources, and token operations.
  • Provided interactive documentation with test runner UI and improved input definitions.
  • Added a new GitHub Actions workflow for WASM SDK tests.
  • Introduced a SharedWorker-based SDK client for shared SDK usage.
  • Added new query functions for token pricing and epoch block data.

• Bug Fixes

  • Improved serialization and parameter handling for voting and contested resource queries.
  • Enhanced error handling and validation throughout wallet and token operations.
  • Fixed visibility and parameter issues in token state transitions.

• Documentation

  • Updated and expanded documentation for all new wallet and token features, including examples and parameter details.
  • Added comprehensive test documentation, coverage summaries, and usage instructions.

• Tests

  • Added extensive automated and manual tests for wallet, token, voting, group, epoch, protocol, and system queries and transitions.
  • Introduced test runners, HTML reports, and test coverage analysis for all SDK features.
  • Added numerous standalone and integrated test scripts covering key derivation, DPNS, identity, documents, tokens, voting, and more.

• Chores

  • Added scripts for build automation, input extraction, and documentation generation.
  • Updated dependencies and package metadata for new features and test infrastructure.
  • Added Python scripts to update input definitions and state transition parameters.
  • Introduced new WASM SDK package configuration and build scripts.

Checklist:

• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have added or updated relevant unit/integration/functional/e2e tests
• I have added "!" to the title and described breaking changes in the corresponding section if my code contains any
• I have made corresponding changes to the documentation if needed

For repository code-owners and collaborators only

• I have assigned this pull request to a milestone

[coderabbitai]

Caution

Review failed

Failed to post review comments.

Walkthrough

This change introduces a comprehensive wallet and key derivation module to the WASM SDK, supporting BIP44, DIP9, DIP13, DIP14, and DIP15 standards, and exposes wallet operations in the web interface. It adds new token state transitions, extensive test coverage, documentation updates, new build and CI scripts, and a shared worker SDK client for browser environments.

Changes

Cohort / Files	Change Summary
Wallet & Key Derivation Modules packages/wasm-sdk/src/wallet/key_generation.rs packages/wasm-sdk/src/wallet/key_derivation.rs packages/wasm-sdk/src/wallet/extended_derivation.rs packages/wasm-sdk/src/wallet/dip14.rs packages/wasm-sdk/src/wallet/mod.rs packages/wasm-sdk/src/lib.rs	Introduces wallet functionality with key generation, BIP44/DIP9/DIP13/DIP14/DIP15 derivation, address validation, message signing, and extended path support; exposes all wallet methods via WASM.
Web Interface & Wallet Integration packages/wasm-sdk/index.html packages/wasm-sdk/AI_REFERENCE.md	Adds wallet operation UI, imports wallet functions, defines wallet operation schemas, integrates wallet execution logic, and updates documentation with new wallet and token operations.
Token State Transitions packages/wasm-sdk/src/state_transitions/tokens/mod.rs packages/wasm-sdk/fixed_definitions.json packages/wasm-sdk/docs_manifest.json	Adds token claim, price setting, direct purchase, and config update transitions; updates input schemas and documentation for new and existing token transitions.
Token & Voting Queries packages/wasm-sdk/src/queries/token.rs packages/wasm-sdk/src/queries/voting.rs packages/wasm-sdk/src/queries/epoch.rs packages/rs-sdk/src/platform/query.rs packages/rs-sdk/src/platform.rs	Adds token price and ID queries, improves voting query parameter handling, implements epoch block queries, and extends public API surface for new query types.
Test Suite & Test Utilities packages/wasm-sdk/test/* (multiple files) packages/wasm-sdk/test-base58.html packages/wasm-sdk/test_custom_paths.html packages/wasm-sdk/test_wallet_fixes.html packages/wasm-sdk/test_dip13.html packages/wasm-sdk/test_dip14_implementation.mjs packages/wasm-sdk/test_dip14_vector.mjs packages/wasm-sdk/test_correct_path.mjs packages/wasm-sdk/test_matching_ids.mjs packages/wasm-sdk/test_languages.html packages/wasm-sdk/test-token-pricing-complete.html packages/wasm-sdk/test_bip39_entropy.rs packages/wasm-sdk/test/README.md packages/wasm-sdk/test/COMPREHENSIVE_TEST_SUMMARY.md packages/wasm-sdk/test/DIP_DERIVATION_SUMMARY.md packages/wasm-sdk/test/EXPECTED_FAILURES.md packages/wasm-sdk/test/test-plan.md packages/wasm-sdk/test/test-summary.md packages/wasm-sdk/test/query-coverage-analysis.md packages/wasm-sdk/test/test-report.html packages/wasm-sdk/test/test-setup.js packages/wasm-sdk/test/run-all-tests.mjs packages/wasm-sdk/test/run-tests.mjs	Adds extensive test coverage for wallet, key derivation, token, voting, DPNS, epoch, group, system, and utility functions; introduces test runners, HTML reports, and test documentation.
Build & CI Infrastructure packages/wasm-sdk/build-optimized.sh .github/workflows/wasm-sdk-tests.yml packages/wasm-sdk/package.json packages/wasm-sdk/test/package.json packages/wasm-sdk/Cargo.toml	Adds optimized build script, GitHub Actions CI workflow for WASM SDK, npm package definitions, and new Rust dependencies for cryptography and encoding.
Shared Worker SDK Client packages/wasm-sdk/shared-sdk-client.js packages/wasm-sdk/shared-sdk-worker.js	Introduces a shared worker-based SDK client for browser environments, supporting concurrent connections and asynchronous SDK method execution.
Documentation Generation & Input Extraction packages/wasm-sdk/generate_docs.py packages/wasm-sdk/extract_inputs.py packages/wasm-sdk/update_inputs.py packages/wasm-sdk/update_state_transitions.py packages/wasm-sdk/save_fixed_definitions.py	Adds or updates scripts for generating docs, extracting and updating input definitions, and maintaining fixed schemas for queries and transitions.

Sequence Diagram(s)

sequenceDiagram
    participant User
    participant WebUI
    participant WASM_SDK
    participant WalletModule

    User->>WebUI: Selects Wallet Operation & Inputs
    WebUI->>WASM_SDK: Calls wallet function (e.g., generate_key_pair, derive_key_from_seed_with_path)
    WASM_SDK->>WalletModule: Executes requested wallet logic
    WalletModule-->>WASM_SDK: Returns key/address/result
    WASM_SDK-->>WebUI: Returns result
    WebUI-->>User: Displays result

Loading

sequenceDiagram
    participant User
    participant WebUI
    participant WASM_SDK
    participant SharedWorker
    participant RustBackend

    User->>WebUI: Initiates SDK operation (e.g., query, state transition)
    WebUI->>SharedWorker: Sends request (via SharedSdkClient)
    SharedWorker->>RustBackend: Executes SDK method
    RustBackend-->>SharedWorker: Returns result/error
    SharedWorker-->>WebUI: Delivers result/error
    WebUI-->>User: Displays outcome

Loading

Estimated code review effort

🎯 5 (Critical) | ⏱️ ~90+ minutes

• Complexity: High — introduces new wallet/key derivation modules, new token transitions, extensive test coverage, new build/CI scripts, and browser worker integration.
• Volume: Dozens of new/modified files across Rust, JS, Python, HTML, and documentation.
• Scope: Core SDK logic, public APIs, test infrastructure, and developer tooling.

Possibly related PRs

• feat(sdk): token and group queries #2449: Adds new token and group query types and implementations in the RS SDK, directly related to the wallet and token query/transition additions here.
• feat(sdk): token claim state transition #2522: Implements the token claim state transition builder and related fixes in the Rust SDK, matching the new token claim transitions in this PR.
• feat(sdk): make wasm sdk complete for all state transitions and most queries #2690: Extends wasm SDK with many query and state transition implementations, overlapping with new query types and WASM SDK expansions here.

Suggested labels

js-sdk

Poem

In burrows deep, with code so neat,
The rabbit crafts a wallet suite—
Keys and paths, both long and wide,
With tokens, tests, and docs beside.
CI hops in, builds with pride,
Now Dash can leap with wallet stride!

🐇✨

Note

⚡️ Unit Test Generation is now available in beta!

Learn more here, or try it out under "Finishing Touches" below.

✨ Finishing Touches

• 📝 Generate Docstrings

🧪 Generate unit tests

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feat/wasm-sdk-core-and-test-suite

---

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

• X
• Mastodon
• Reddit
• LinkedIn

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

• Review comments: Directly reply to a review comment made by CodeRabbit. Example:
  • I pushed a fix in commit <commit_id>, please review it.
  • Explain this complex logic.
  • Open a follow-up GitHub issue for this discussion.
• Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
  • @coderabbitai explain this code block.
  • @coderabbitai modularize this function.
• PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
  • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
  • @coderabbitai read src/utils.ts and explain its main purpose.
  • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
  • @coderabbitai help me debug CodeRabbit configuration file.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

• @coderabbitai pause to pause the reviews on a PR.
• @coderabbitai resume to resume the paused reviews.
• @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
• @coderabbitai full review to do a full review from scratch and review all the files again.
• @coderabbitai summary to regenerate the summary of the PR.
• @coderabbitai generate docstrings to generate docstrings for this PR.
• @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
• @coderabbitai generate unit tests to generate unit tests for this PR.
• @coderabbitai resolve resolve all the CodeRabbit review comments.
• @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
• @coderabbitai help to get help.

Other keywords and placeholders

• Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
• Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
• Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

• You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
• Please see the configuration documentation for more information.
• If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

• Visit our Documentation for detailed information on how to use CodeRabbit.
• Join our Discord Community to get help, request features, and share feedback.
• Follow us on X/Twitter for updates and announcements.

[github-actions]

✅ gRPC Query Coverage Report

================================================================================
gRPC Query Coverage Report - NEW QUERIES ONLY
================================================================================

Total queries in proto: 47
Previously known queries: 47
New queries found: 0


================================================================================
Summary:
--------------------------------------------------------------------------------
No new queries found

Total known queries: 47
  - Implemented: 44
  - Not implemented: 2
  - Excluded: 1

Not implemented queries:
  - getConsensusParams
  - getTokenPreProgrammedDistributions

[QuantumExplorer]

@CodeRabbit review

[coderabbitai]

✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.