Validate & Submit

Test your metadata file and submit it to the official registry to enable Clear Signing for your protocol.

Process Overview

1
Validate
2
Submit
3
Review
4
Deploy

Step 1: Validate Your Metadata

Ensure your file complies with the ERC-7730 standard before submission.

Validation Methods

Install validator

pip install erc7730

Requires Python 3.12 or higher

Validate your file

# Validate a single file
erc7730 lint your-metadata.json
 
# Validate multiple files
erc7730 lint registry/**/eip712-*.json registry/**/calldata-*.json

Auto-format your file

# Format to ensure proper structure
erc7730 format your-metadata.json

Common Validation Issues

Missing Required Fields
Ensure all required fields are present: context, metadata, and display sections
Invalid Format Structure
Check that format arrays match the actual data structure of your contract methods
Incorrect Chain ID
Verify the chain ID matches your deployed contract (1 for mainnet, 137 for Polygon)

Step 2: Submit to Registry

Once validated, submit your metadata to the registry.

Fork the repository

Visit github.com/LedgerHQ/clear-signing-erc7730-registry

git clone https://github.com/YOUR_USERNAME/clear-signing-erc7730-registry.git
cd clear-signing-erc7730-registry

Add your metadata

File structure:

registry/
├── your-dapp-name/
│   └── descriptive-filename.json

Create directory and add file:

mkdir -p registry/your-dapp-name
cp /path/to/your-metadata.json registry/your-dapp-name/descriptive-name.json

Use lowercase with hyphens: uniswap-v3/swap-router.json ✓ not UniswapV3/file1.json

Create pull request

Commit and push:

git add .
git commit -m "Add Clear Signing metadata for [Your dApp Name]"
git push origin main

On GitHub:

  1. Navigate to your fork
  2. Click “New Pull Request”
  3. Provide clear description
  4. Wait for review

Step 3: Review Process

What Reviewers Check
  • Schema compliance with ERC-7730
  • Correct contract addresses and chain IDs
  • Clear and accurate display formats
  • Proper field descriptions
  • No security risks or misleading information
Timeline
Reviews typically complete within 3-5 business days. Complex submissions may take longer.

Step 4: After Submission

Monitor your PR

Check for reviewer comments and address requested changes promptly.

Update if needed

If changes are requested:

git add .
git commit -m "Address review feedback"
git push origin main

Verify deployment

Once merged, your metadata will be available in:

  • Ledger Live (after next update)
  • Wallets supporting Clear Signing
  • Public registry API

Get Help

You’re Making Web3 Safer

Once merged, your metadata will protect users from blind signing risks. Every submission helps build a more transparent blockchain ecosystem.

Ledger
Copyright © Ledger SAS. All rights reserved. Ledger, Ledger Stax, Ledger Nano S, Ledger Vault, Bolos are trademarks owned by Ledger SAS