Skip to content

docs: add create-wdk-module docs + release + fixes (WDKDOCS-222)

Viet Tan Tran requested to merge github/fork/ihsraham/docs/WDKDOCS-222-create-wdk-module into develop

Created by: ihsraham

Summary

  • Added new docs page (tools/create-wdk-module.md) for the create-wdk-module CLI scaffolding tool, covering Quick Start (stepper), Module Types, CLI Options, Interactive Mode, and Generated Project Structure.
  • Replaced the "Coming Soon: Custom Module Guide" placeholder in sdk/community-modules/README.md with a working quick-start and link to the new page.
  • Updated sdk/get-started.md "Creating Custom Modules" section with a recommendation hint for create-wdk-module and replaced the commented-out "Extender Guide" link with a live link to the new page.
  • Added Create WDK Module entry to SUMMARY.md under the Tools section.
  • Added March 5, 2026 changelog entry in overview/changelog.md.

ERC-4337 Supported Networks Audit

Ran end-to-end tests against every chain listed in the ERC-4337 configuration docs. Checked the Safe4337Module v0.3.0 deployment registry, bundler/paymaster availability, account creation, and actual UserOperation submission on Sepolia with both Pimlico and Candide.

Findings:

  • Avalanche C-Chain (43114) fails because Safe4337Module v0.3.0 is not in @safe-global/safe-modules-deployments for that chain. Bundler and paymaster services exist, but the SDK throws before reaching them.
  • All other documented chains (Ethereum, Polygon, Arbitrum, Plasma, Sepolia) pass all layers.
  • Polygon RPC URL polygon-rpc.com was returning 401 errors.

Changes:

  • configuration.md: Removed Avalanche config section, added a verified supported networks table with the three-layer requirement explained, added a danger hint about Avalanche, fixed Polygon RPC to polygon-bor-rpc.publicnode.com, cleaned up Plasma config comments.
  • README.md (ERC-4337 overview): Replaced "any EVM-compatible blockchain" with the actual verified list of 5 networks.
  • skills/wdk/references/chains.md: Updated the ERC-4337 support line with all verified chains and the Avalanche exclusion.

Release Notes (March 6, 2026)

Changelog entries for 3 releases. No public API changes detected; all entries are changelog-only.

  • wdk-wallet-tron v1.0.0-beta.5 (PR #30): Fixed case-sensitive address check in verify, upgraded TonWeb to v6.2.0, security dependency updates. Audited .d.ts from beta.4; verify(message, signature) signature unchanged, verifyMessageV2 change is internal only.
  • wdk-protocol-lending-aave-evm v1.0.0-beta.4 (PR #11): Added AGENTS.md, security dependency updates. No public API changes.
  • wdk v1.0.0-beta.6 (PR #39): Added AGENTS.md, security dependency updates. No public API changes.

Verification

  • GitBook render safety: all tags balanced (hint, stepper, step, code, details/summary)
  • Token naming: no branded symbols in code blocks
  • Link validation: all relative links resolve to existing pages
  • Content accuracy: CLI options, module types, and project structures match the GitHub repo README
  • Ripple effect: no stale "Coming Soon" or "Extender Guide" references remain
  • ERC-4337 chain audit: tested registry, bundler, paymaster, and account creation for all 6 documented chains
  • Sepolia E2E: real UserOp transfers verified with both Pimlico and Candide

Test plan

  • Verify the new tools/create-wdk-module.md page renders correctly in GitBook preview
  • Confirm stepper, collapsible sections, tables, and cards display properly
  • Check all relative links navigate to the correct pages
  • Verify sdk/community-modules/README.md and sdk/get-started.md updates render correctly
  • Verify ERC-4337 configuration page renders the supported networks table and Avalanche warning correctly

Merge request reports