8000 Metamask OpenRPC Docusaurus Plugin - Deprecated · Issue #660 · ethereum/execution-apis · GitHub
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

Metamask OpenRPC Docusaurus Plugin - Deprecated #660

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
zcs 8000 tarr opened this issue May 22, 2025 · 5 comments
Open

Metamask OpenRPC Docusaurus Plugin - Deprecated #660

zcstarr opened this issue May 22, 2025 · 5 comments

Comments

@zcstarr
Copy link
zcstarr commented May 22, 2025

📝 Summary

The metamask/docusaurus plugin is deprecated from the perspective of the OpenRPC team. Our new OpenRPC ecosystem has received major version updates across all tools. In particular, the generator now uses the latest Gatsby, Material-UI, and React ecosystem. The old Docusaurus plugin cannot be maintained or updated, and the future of OpenRPC relies on features present in these major versions.

🔍 Background

  • Deprecated: metamask/docusaurus plugin
  • Maintained: New OpenRPC ecosystem with major version bumps
  • Relevant Tool: open-rpc/generator now at 2.x.x, built on Gatsby, Material-UI, React

📚 Links

Resource URL
OpenRPC mono-repo https://github.com/open-rpc/tools
OpenRPC generator (2.x.x) https://github.com/open-rpc/generator

🤔 Proposal

  1. Version bump the generator to 2.x.x.
  2. Increase CI Node version to >= v20.x.x.
  3. Rollback the previous Docusaurus change (if already merged).

Alternative Proposal

  1. Version bump the generator to 2.x.x.
  2. (Optional) Increase CI Node version to >= v20.x.x.
  3. ** Fork** and update the docusaurus plugin to support the major version updates.
    @shanejonas for suggestions on what you might add or fix

These steps ensure we’re using the latest ecosystem, unlock new features, and reduce maintenance burden.

🚀 Suggested Resolution

  • Revert the Docusaurus-related commit (if applied).
  • Update package.json (or the CI config) to use:
  • @open-rpc/generator@^2.x.x
  • node >= 20.x.x (optional)

💻 Environment

Key Value
Generator @open-rpc/generator@2.x.x
Node >= 14.x.x (current)
Proposed >= 20.x.x

📄 Additional Context

Any local-docs concerns have been addressed in the 2.x.x release of the generator. If there are further questions or edge cases, please comment below!

@zcstarr
Copy link
Author
zcstarr commented May 22, 2025

@shanejonas Actually there is an alternative which is to fork and update the docusaurus plugin, do you have any suggestions on what someone might want to add/ fix with the plugin?

@shanejonas
Copy link
Contributor

Just some thoughts off the top of my head:

Right now the 'interactive part only supports window.ethereum when clicking the send request button but it should really support http by default and let you put in a url to hit.

The stoplight dep is not ideal, it does render json-schema relatively nicely but its definitely a pain in the butt. swapping it out would be ideal, not sure if theres another similar lib.

@zcstarr
Copy link
Author
zcstarr commented May 22, 2025

The other thing to consider about a fork and update is the rendering of errors and errorGroups

https://github.com/open-rpc/tools/blob/main/packages/docs-react/src/Methods/Methods.tsx#L135

In the methods renderer you'll need to merge the error and errorGroups field to render errors

@acolytec3
Copy link
Contributor

It also has issues with just basic form validation for some inputs. I'll take a look at your v2 generator code and see what that looks like.

@zcstarr
Copy link
Author
zcstarr commented May 22, 2025

some

Would be dope to see how that plays out and if you hit issues we can patch things in that area :D

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

No branches or pull requests

3 participants
0