creating docs -- dev-tools/wormhole-messaging

[swarnasn29]

---

Title

Docs: Add Wormhole Cross-Chain Messaging Integration Guide

Description

Purpose: Close the documentation gap for developers who want to use Wormhole's arbitrary message passing on Rootstock. The existing Wormhole page only covers the SDK tooling overview (Connect, Queries,
TypeScript SDK). There was no guide explaining how to receive and verify cross-chain messages on-chain.

Context: New builders targeting Rootstock with Wormhole had no clear integration path for Verified Action Approvals (VAAs). This guide solves that cold-start problem end-to-end.

Changes:

• Added docs/05-dev-tools/cross-chain-bridges/wormhole-messaging.md — a full developer guide covering:
  • Architecture overview of the Emitter-Guardian-Receiver model in the Rootstock context, including the Guardian Network's ZK proof validation
  • IWormhole interface and a complete WormholeReceiver Solidity contract with replay protection, trusted emitter validation, and checks-effects-interactions ordering
  • Security best practices section with four subsections: replay protection, trusted emitter validation, checks-effects-interactions order, and consistency level considerations for Rootstock's block time
  • TypeScript integration snippet using @wormhole-foundation/sdk v2 with the UniversalAddress chain-context pattern
  • Accurate contract address for Rootstock Mainnet (0xbebdb6C8ddC678FfA9f8748f85C815C556Dd8ac6) sourced from Wormhole's read-only deployments list, with an explicit note that Rootstock Testnet has no public
    Core Contract deployment
• Updated docs/05-dev-tools/cross-chain-bridges/index.md — added a CardsGridItem for the new guide in the cross-chain bridges landing page grid

Screenshots/GIFs

N/A — text and code documentation only. Verified visually via local Docusaurus dev server at http://localhost:3000/dev-tools/cross-chain-bridges/wormhole-messaging/.

Testing

Verification: Started the local Docusaurus dev server to confirm the page renders correctly and appears in the sidebar.

npm start -- --no-open

Output:
[INFO] Starting the development server...
[SUCCESS] Docusaurus website is running at: http://localhost:3000/

Confirmed:

• New guide appears under Dev Tools → Cross Chain Bridges → Wormhole Messaging in the sidebar
• Wormhole Messaging card appears on the Cross Chain Bridges index page
• No broken internal links

Quality Checklist

• Please confirm the following standards have been met:

• Guidelines: I have read and followed the Contributing Guidelines.

• Vale Linter: I have run vale locally and resolved all Rootstock.Robotics and style warnings using .cursorrules or style guide vale automation.

• Rootstock Engineer Voice: I have removed AI-style "fluff" (e.g., unleash, delve into, testament to, ever-evolving landscape).

• Structural Clarity: I have replaced em dashes (—) with commas or periods and ensured there are no stacked headings.

• Code Quality: Technical comments are placed above the code line, not inline at the end.

• Terminology: I am using rBTC (not Smart Bitcoin) and Rootstock (not RSK).

  Refs

  • Existing Wormhole page: https://dev.rootstock.io/dev-tools/cross-chain-bridges/wormhole/
  • Wormhole supported networks (Rootstock): https://wormhole.com/docs/build/start-building/supported-networks/evm/#rootstock
  • Wormhole contract addresses (Rootstock read-only deployment): https://wormhole.com/docs/build/reference/contract-addresses/
  • Wormhole Solidity SDK: https://github.com/wormhole-foundation/wormhole-solidity-sdk