Data on EIP/ERC Cross-Requirements

joeysantoro · November 2, 2023, 3:49pm

Here is the data on cross requirements for ERCs and EIPs:

5 EIPs that require 4 ERCs:
EIP-712 requires: 191
EIP-747 requires: 20, 1046
EIP-2256 requires: 55
EIP-5283 requires: 20
EIP-6493 requires: 191

Unique required ERCs:
20, 55, 191, 1046

41 ERCs that require 16 EIPs:
ERC-165 requires: 214
ERC-820 requires: 214
ERC-1077 requires: 1344
ERC-1167 requires: 211
ERC-1191 requires: 155
ERC-1710 requires: 155
ERC-1812 requires: 712
ERC-1820 requires: 214
ERC-1922 requires: 196, 197
ERC-1923 requires: 196, 197
ERC-2098 requires: 2
ERC-2193 requires: 155
ERC-2400 requires: 155
ERC-2470 requires: 1014
ERC-2525 requires: 1193
ERC-2612 requires: 712
ERC-2770 requires: 712
ERC-3009 requires: 712
ERC-3440 requires: 712
ERC-4361 requires: 155
ERC-4494 requires: 712
ERC-4973 requires: 712
ERC-5139 requires: 155
ERC-5202 requires: 170
ERC-5267 requires: 155, 712
ERC-5375 requires: 155, 712
ERC-5453 requires: 712
ERC-5539 requires: 712
ERC-5559 requires: 712
ERC-5568 requires: 140
ERC-5727 requires: 712
ERC-5805 requires: 712
ERC-5902 requires: 712
ERC-6120 requires: 1014
ERC-6384 requires: 712
ERC-6734 requires: 155, 3220
ERC-6865 requires: 712
ERC-7015 requires: 155, 712
ERC-7511 requires: 7, 211, 3855
ERC-7512 requires: 712
ERC-7550 requires: 712, 1153

Unique required EIPs:
2, 7, 140, 155, 170, 196, 197, 211, 214, 712, 1014, 1153, 1193, 1344, 3220, 3855

Seems like in general the cross requirements are a small subset of existing eips and ercs, especially the eips have almost no linking to ercs, and the ercs require a common subset of the eips.

I generated this with the following script:

import os
import re

# Paths to the directories containing EIP and ERC markdown files
eip_dir = '/path/to/eips'
erc_dir = '/path/to/ercs'

# Load the EIP and ERC numbers from the text files into sets for easy membership checking
with open('eips.txt') as f:
    eips = set(f.read().splitlines())

with open('ercs.txt') as f:
    ercs = set(f.read().splitlines())

# Function to parse required numbers from markdown files
def parse_requirements(md_file):
    with open(md_file, 'r') as file:
        content = file.read()
    matches = re.findall(r'^requires: ([\d, ]+)', content, re.MULTILINE)
    if matches:
        return set(matches[0].replace(' ', '').split(','))
    return set()

# Check EIPs for required ERCs
eip_requires_erc = {}
for eip_number in eips:
    eip_file = os.path.join(eip_dir, f'eip-{eip_number}.md')
    required = parse_requirements(eip_file)
    required_ercs = required & ercs  # Set intersection to find required ERCs
    if required_ercs:
        eip_requires_erc[eip_number] = required_ercs

# Check ERCs for required EIPs
erc_requires_eip = {}
for erc_number in ercs:
    erc_file = os.path.join(erc_dir, f'erc-{erc_number}.md')
    required = parse_requirements(erc_file)
    required_eips = required & eips  # Set intersection to find required EIPs
    if required_eips:
        erc_requires_eip[erc_number] = required_eips

# Sort the eip_requires_erc dictionary by EIP number
sorted_eip_requires_erc = {eip: sorted(eip_requires_erc[eip], key=int) for eip in sorted(eip_requires_erc, key=int)}

# Sort the erc_requires_eip dictionary by ERC number
sorted_erc_requires_eip = {erc: sorted(erc_requires_eip[erc], key=int) for erc in sorted(erc_requires_eip, key=int)}

# Find unique required EIPs and ERCs
unique_required_eips = set()
unique_required_ercs = set()

for req_ercs in eip_requires_erc.values():
    unique_required_ercs.update(req_ercs)

for req_eips in erc_requires_eip.values():
    unique_required_eips.update(req_eips)

# Output the results
print(f"{len(eip_requires_erc)} EIPs that require {len(unique_required_ercs)} ERCs:")
for eip, req_ercs in sorted_eip_requires_erc.items():
    print(f"EIP-{eip} requires: {', '.join(req_ercs)}")

print("\nUnique required ERCs:")
print(', '.join(sorted(unique_required_ercs, key=int)))

print(f"\n{len(erc_requires_eip)} ERCs that require {len(unique_required_eips)} EIPs:")
for erc, req_eips in sorted_erc_requires_eip.items():
    print(f"ERC-{erc} requires: {', '.join(req_eips)}")

print("\nUnique required EIPs:")
print(', '.join(sorted(unique_required_eips, key=int)))

eips.txt:

ercs.txt

xinbenlv · November 10, 2023, 8:03pm

Thank you for the great efforts @joeysantoro This is very helpful.