Skip to content

docs(ecosystem-adapters): add comprehensive documentation for OpenZeppelin Ecosystem Adapters#142

Open
pasevin wants to merge 9 commits intoOpenZeppelin:mainfrom
pasevin:cursor/ecosystem-adapters-documentation-000c
Open

docs(ecosystem-adapters): add comprehensive documentation for OpenZeppelin Ecosystem Adapters#142
pasevin wants to merge 9 commits intoOpenZeppelin:mainfrom
pasevin:cursor/ecosystem-adapters-documentation-000c

Conversation

@pasevin
Copy link
Copy Markdown

@pasevin pasevin commented Apr 7, 2026

Documentation Pull Request

Summary

Adds a new 5-page documentation section for OpenZeppelin Ecosystem Adapters — the modular, chain-specific integration packages that bridge blockchain ecosystems and developer tooling.

Pages added:

Page Content
Overview (/ecosystem-adapters) Introduction, package listing, key design principles, consumer applications
Architecture (/ecosystem-adapters/architecture) Capability tiers, profiles, runtime lifecycle, execution strategies, sub-path exports
Getting Started (/ecosystem-adapters/getting-started) Installation, quick start, individual capability consumption, Vite integration, error handling
Supported Ecosystems (/ecosystem-adapters/supported-ecosystems) Per-adapter details (EVM, Stellar, Polkadot, Midnight, Solana) with capability support matrix
Building an Adapter (/ecosystem-adapters/building-an-adapter) Step-by-step guide with code examples, package structure, contribution checklist

Diagrams included (rendered via Mermaid):

  • Package topology flowchart
  • Compact 3-tier capability overview
  • Runtime lifecycle sequence diagram
  • Execution strategy decision flowchart
  • Incremental adoption path for new adapter authors

Tables used for matrix data (cleaner than flowcharts for cross-references):

  • Profile-Capability checkmark matrix (13 capabilities x 5 profiles)
  • Capability tier summary table
  • Capability support matrix across ecosystems

Type of Change

  • New documentation
  • Add examples or tutorials

Related Issues

Relates to https://github.com/OpenZeppelin/openzeppelin-adapters

Checklist

Additional Notes

  • Navigation is wired into both a standalone ecosystemAdaptersTree (for /ecosystem-adapters/* paths) and every ecosystem sidebar (ethereum-evm.json, stellar.json, polkadot.json, midnight.json, and arbitrum-stylus.json) under Open Source Tools for discoverability.
  • All MDX content uses only globally-available fumadocs components (Callout, Card, Cards) and Mermaid diagrams — no custom imports needed.
  • Diagrams use Mermaid flowchart and sequenceDiagram types only (avoiding unsupported types like block-beta).

cursoragent and others added 9 commits April 7, 2026 11:56
…pelin Ecosystem Adapters

- Add 5 documentation pages: overview, architecture, getting started, supported ecosystems, building an adapter
- Include Mermaid diagrams for package topology, capability tiers, profiles, runtime lifecycle, and execution strategies
- Add navigation config (ecosystem-adapters.json) and wire into sidebar
- Add Ecosystem Adapters section to ethereum-evm.json navigation under Open Source Tools
- Register ecosystemAdaptersTree in navigation index and use-navigation-tree hook

Co-authored-by: Aleksandr Pasevin <aleksandr.pasevin@openzeppelin.com>
…x with flowchart subgraphs

The block-beta diagram type causes a circular JSON serialization error in
the Mermaid component. Replace with flowchart subgraphs which render
correctly with colored tier groupings.

Co-authored-by: Aleksandr Pasevin <aleksandr.pasevin@openzeppelin.com>
…rint

- Overview: replace expanded 13-node tier tree with compact 3-node summary
- Architecture: replace oversized Mermaid tier diagram with a single clean table
- Removes redundant duplicate tier table

Co-authored-by: Aleksandr Pasevin <aleksandr.pasevin@openzeppelin.com>
…capability matrix

The Mermaid flowchart with cross-links between profiles and capabilities
created a cluttered spider-web visual. Replaced with a single clear
checkmark matrix table that shows exactly which capabilities each profile
includes at a glance.

Co-authored-by: Aleksandr Pasevin <aleksandr.pasevin@openzeppelin.com>
…mary table

The Mermaid subgraph cards took excessive vertical space for minimal info.
Replaced with a single 5-row table showing adapter, networks, capability
count, and status.

Co-authored-by: Aleksandr Pasevin <aleksandr.pasevin@openzeppelin.com>
- Add 'Using with React' section covering wallet context providers,
  configureUiKit, connectWallet/disconnectWallet, and hook facade pattern
  (useAccount, useSwitchChain, etc.)
- Add 'Multi-Ecosystem Apps' section showing how to instantiate runtimes
  from EVM + Stellar adapters in the same application
- Add prominent link to the adapters GitHub repo on the overview page
- All API details referenced from adapter source code

Co-authored-by: Aleksandr Pasevin <aleksandr.pasevin@openzeppelin.com>
…ation-27d3

feat(ecosystem-adapters): add React integration and multi-ecosystem documentation
Add the Ecosystem Adapters folder to Stellar, Polkadot, Midnight, and
Arbitrum Stylus navigation trees so the section is discoverable from
every supported ecosystem, not just EVM.

Co-authored-by: Aleksandr Pasevin <aleksandr.pasevin@openzeppelin.com>
…ation-27d3

feat(navigation): add Ecosystem Adapters to all ecosystem sidebars
@netlify
Copy link
Copy Markdown

netlify bot commented Apr 7, 2026

👷 Deploy request for openzeppelin-docs-v2 pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit aa64693

@pasevin pasevin changed the title feat(ecosystem-adapters): add comprehensive documentation for OpenZeppelin Ecosystem Adapters docs(ecosystem-adapters): add comprehensive documentation for OpenZeppelin Ecosystem Adapters Apr 9, 2026
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.

2 participants