DocumentationClear signingdApps implementation with ERC-7730

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.

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 metadata files.

After your changes are merged, the Ledger generic parser will integrate them, 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.

This preview example shows how clear signing operations will be displayed:

Preview example with POAP operation

How to Add Your Metadata to the Registry

To add your metadata to the registry, follow these steps:

  1. Fork the official registry repository.
  2. Add a metadata file describing your smart contract.
  3. Preview your changes locally.
  4. Submit a pull request (PR).
  5. Await approval and merge your changes.

Step 1: Fork the Official Registry

Step 2: Add a Metadata File

Step 3: Preview Your Changes

  • Consult the developer preview README for instructions on setting up the preview environment.
  • Run the web application locally to preview your changes.

Step 4: Submit a Pull Request

  • 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 🎉

Generic Parser Status

⚠️

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 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.

Ledger
Copyright © Ledger SAS. All rights reserved. Ledger, Ledger Nano S, Ledger Vault, Ledger OS are registered trademarks of Ledger SAS