Skip to content

Conversation

@SpectreMercury
Copy link
Contributor

@SpectreMercury SpectreMercury commented Jan 14, 2026

  • add JS Client SDK Documentation

Summary by CodeRabbit

  • Documentation
    • Added comprehensive JavaScript/TypeScript SDK documentation including installation instructions, quick start guides for Viem and Ethers adapters, detailed API reference, and integration examples across multiple development stacks.

✏️ Tip: You can customize this high-level summary in your review settings.

@SpectreMercury SpectreMercury requested a review from a team as a code owner January 14, 2026 15:01
@SpectreMercury SpectreMercury requested review from tomatoishealthy and removed request for a team January 14, 2026 15:01
@coderabbitai
Copy link

coderabbitai bot commented Jan 14, 2026

📝 Walkthrough

Walkthrough

Introduces comprehensive JavaScript/TypeScript SDK documentation for Morph, covering installation, quick start guides, API reference, and serialization utilities. The documentation is integrated into the site navigation and sidebar structure for discoverability.

Changes

Cohort / File(s) Summary
SDK Documentation
docs/build-on-morph/sdk/js-sdk.md
New comprehensive guide for Morph Client SDK with sections on Alt Fee Transactions, installation, quick starts for Viem/Ethers adapters, token references, architecture, and detailed API documentation for chain definitions, serialization, parsing, address recovery, and MorphSigner capabilities.
Navigation Configuration
docusaurus.config.js
Added "JS SDK" navigation link to navbar with docId pointing to the new SDK documentation page.
Sidebar Configuration
sidebars.js
Added SDK documentation entry to Developer Guides section in MorphChainSidebar.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Suggested reviewers

  • Web3Jumb0
  • drewaz

Poem

🐰 A hop, skip, and SDK so grand,
Documentation helps devs understand,
From chains to transactions we now relate,
With guides so clear, development's first-rate!

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'feat: add js sdk docs' clearly and directly describes the main change—adding JavaScript SDK documentation. It is concise, specific, and accurately reflects the primary purpose of the changeset.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings

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.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@docs/build-on-morph/sdk/js-sdk.md`:
- Around line 43-73: Add a language identifier to the fenced ASCII diagram code
block so markdown linters accept it: change the opening triple backticks from
``` to ```text (or ```plaintext) for the ASCII diagram block (the block that
begins with the box drawing
"┌─────────────────────────────────────────────────────────┐" and the closing
```), leaving the diagram content unchanged.
🧹 Nitpick comments (2)
sidebars.js (1)

104-104: Consider using explicit format for consistency.

The new entry uses the string shorthand format, while most other entries in this section use the explicit { type: 'doc', id: '...', label: '...' } format. Both are valid, but using the explicit format would be more consistent with the surrounding entries and allows control over the sidebar label.

📝 Suggested change for consistency
-      'build-on-morph/sdk/js-sdk',
+      { type: 'doc', id: 'build-on-morph/sdk/js-sdk', label: 'JS SDK' },
docs/build-on-morph/sdk/js-sdk.md (1)

684-698: Consider clarifying "Required" context in the table.

The table marks gasLimit, maxFeePerGas, and maxPriorityFeePerGas as required, but the populateTransaction example below (lines 781-789) omits these fields since they get auto-filled. Consider adding a note that these are required for signTransaction/sendTransaction but can be auto-populated via populateTransaction.

📜 Review details

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between e3e017b and eb82010.

⛔ Files ignored due to path filters (1)
  • pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml
📒 Files selected for processing (3)
  • docs/build-on-morph/sdk/js-sdk.md
  • docusaurus.config.js
  • sidebars.js
🧰 Additional context used
🪛 LanguageTool
docs/build-on-morph/sdk/js-sdk.md

[grammar] ~143-~143: Ensure spelling is correct
Context: ...k/ethers5 ``` --- ## Quick Start ### Viem quick start Send an Alt Fee Transactio...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)

🪛 markdownlint-cli2 (0.18.1)
docs/build-on-morph/sdk/js-sdk.md

43-43: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

🔇 Additional comments (3)
docs/build-on-morph/sdk/js-sdk.md (2)

147-191: LGTM!

The Viem quick start example is well-structured, demonstrating the key workflow of creating clients and sending Alt Fee Transactions with clear comments for each step.


300-628: Well-documented API reference.

The API reference section is comprehensive with clear parameter tables, return types, and practical examples for serialization, parsing, address recovery, and utility functions.

docusaurus.config.js (1)

200-205: LGTM!

The navbar item is correctly configured, following the existing pattern for documentation links. The type: 'doc' with the matching docId will provide direct navigation to the JS SDK documentation.

✏️ Tip: You can disable this entire section by setting review_details to false in your review settings.

Comment on lines +43 to +73
```
┌─────────────────────────────────────────────────────────┐
│ Your Application │
└─────────────────────────────────────────────────────────┘
┌─────────────────────┼─────────────────────┐
│ │ │
▼ ▼ ▼
┌─────────────┐ ┌─────────────┐ ┌──────────────┐
│ @morph- │ │ @morph- │ │ @morph- │
│ network/ │ │ network/ │ │ network/ │
│ viem │ │ ethers │ │ ethers5 │
└─────────────┘ └─────────────┘ └──────────────┘
│ │ │
└─────────────────────┼─────────────────────┘
┌─────────────────┐
│ @morph-network/ │
│ chain │
└─────────────────┘
┌─────────────────────┴─────────────────────┐
▼ ▼
┌─────────────┐ ┌─────────────┐
│ Morph │ │ Morph │
│ Mainnet │ │ Hoodi │
│ (2818) │ │ Testnet │
│ │ │ (2910) │
└─────────────┘ └─────────────┘
```
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Add a language identifier to the fenced code block.

The ASCII architecture diagram should have a language identifier to satisfy markdown linting rules. Use text or plaintext for ASCII diagrams.

📝 Suggested fix
-```
+```text
 ┌─────────────────────────────────────────────────────────┐
 │                    Your Application                      │
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
```
┌─────────────────────────────────────────────────────────┐
│ Your Application │
└─────────────────────────────────────────────────────────┘
┌─────────────────────┼─────────────────────┐
│ │ │
▼ ▼ ▼
┌─────────────┐ ┌─────────────┐ ┌──────────────┐
@morph- │ │ @morph- │ │ @morph-
│ network/ │ │ network/ │ │ network/ │
│ viem │ │ ethers │ │ ethers5 │
└─────────────┘ └─────────────┘ └──────────────┘
│ │ │
└─────────────────────┼─────────────────────┘
┌─────────────────┐
│ @morph-network/ │
│ chain │
└─────────────────┘
┌─────────────────────┴─────────────────────┐
▼ ▼
┌─────────────┐ ┌─────────────┐
│ Morph │ │ Morph │
│ Mainnet │ │ Hoodi │
│ (2818) │ │ Testnet │
│ │ │ (2910) │
└─────────────┘ └─────────────┘
```
🧰 Tools
🪛 markdownlint-cli2 (0.18.1)

43-43: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

🤖 Prompt for AI Agents
In `@docs/build-on-morph/sdk/js-sdk.md` around lines 43 - 73, Add a language
identifier to the fenced ASCII diagram code block so markdown linters accept it:
change the opening triple backticks from ``` to ```text (or ```plaintext) for
the ASCII diagram block (the block that begins with the box drawing
"┌─────────────────────────────────────────────────────────┐" and the closing
```), leaving the diagram content unchanged.

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