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 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
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:
- 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 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
Once merged, your metadata will protect users from blind signing risks. Every submission helps build a more transparent blockchain ecosystem.