Validate & Submit
Test your metadata file and submit it to the official registry to enable Clear Signing for your protocol.
Process Overview
Step 1: Validate Your Metadata
Ensure your file complies with the ERC-7730 standard before submission.
Validation Methods
Install validator
pip install erc7730Requires 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-*.jsonAuto-format your file
# Format to ensure proper structure
erc7730 format your-metadata.jsonCommon Validation Issues
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-registryAdd your metadata
File structure:
registry/
├── your-dapp-name/
│   └── descriptive-filename.jsonCreate directory and add file:
mkdir -p registry/your-dapp-name
cp /path/to/your-metadata.json registry/your-dapp-name/descriptive-name.jsonUse 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 mainOn GitHub:
- Navigate to your fork
- Click “New Pull Request”
- Provide clear description
- Wait for review
Step 3: Review Process
- 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
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 mainVerify deployment
Once merged, your metadata will be available in:
- Ledger Wallet (after next update)
- Wallets supporting Clear Signing
- Public registry API
Get Help
Once merged, your metadata will protect users from blind signing risks. Every submission helps build a more transparent blockchain ecosystem.