dApps Clear Signing implementation with ERC-7730
Overview
Currently, this implementation is supported for EVM chains only. Stay tuned for updates on other protocols!
Some special cases may require the development of an Ethereum plugin. The Ledger team will guide you through this process if required.
How to Add Your Metadata to the Registry
This guide will walk you through the process of implementing clear signing for ERC-7730 on EVM chains. This implementation uses a registry of smart contract and EIP-712 metadata files.
Step 1: Create a Metadata File
Smart contracts
The Metadata file contains the description of your smart contract data according to the ERC-7730 standard.
- Generate this file with the ERC7730 JSON builder. The JSON builder also provide screenshots of your clear signing operation on device.
To manually write the JSON:
- Refer to example files available in the registry directory.
- Follow the JSON schema and specification.
EIP-712 messages
For EIP-712 follow this documentation to create the JSON file.
Step 2: Fork the Official Registry and open a Pull Request
The official registry is hosted on GitHub: ERC-7730 Registry.
- Review the PR requirements detailed in the README.
- Automated checks will run to provide feedback on your files.
- Repo approvers will review your submission and provide comments to assist the process.
- Once approved, your metadata will be merged into the registry.
Success! You have added your metadata to the registry 🎉
This preview example shows how clear signing operations will be displayed:
Generic Parser Status
The generic parser integrate the changes made to the repository, making them available on Ledger devices such as Ledger Flex and Ledger Stax. The “generic parser” serves as the middle-layer deployed on the Ledger infrastructure to read and parse your JSON files.
It’s used for smart contract metadata parsing only. EIP-712 JSON are interpreted directly by the Ethereum device application.
Generic Parser Not Yet Ready: Please be aware that the Ledger generic parser is currently undergoing development and is not yet operational. This means that even after your smart contract metadata is merged, it won’t immediately be available on Ledger devices. We appreciate your patience and will notify you once the parser is fully functional and capable of integrating metadata with Ledger devices.
