이번 글의 답과 확인 범위

공식 8주소와 의도적 변환 32행을 로컬 계산했습니다. 체크섬 표기와 주소 바이트의 일치는 별개이며, 실제 지갑·수취인·네트워크·송금의 안전성을 인증하지 않습니다.

대소문자 검사는 주소의 ‘표현’을 확인합니다

Ethereum 주소의 체크섬이 맞더라도 그 주소가 내가 보내려던 상대의 주소라는 뜻은 아닙니다. ERC-55는 20바이트 주소를 40개의 16진수 문자로 표현하면서 일부 알파벳의 대소문자를 정하는 규칙입니다. 같은 20바이트를 잘못된 대소문자로 적은 경우와, 아예 다른 20바이트를 올바른 체크섬으로 적은 경우를 나누어 봐야 합니다.

이 글에서는 공식 문서의 테스트 주소 8개를 PyCryptodome 3.23.0의 Keccak-256으로 계산했습니다. 각 주소에 소문자화·대문자화·글자 한 곳의 대소문자 변경·다른 20바이트로 바꾼 뒤 체크섬 재계산을 적용해 총 40행을 비교했습니다. 공식 테스트 값과 의도적인 문자열 변환이며 실제 지갑·수취인·전송 기록이 아닙니다.

소문자 40자리 ASCII를 Keccak-256으로 해시한 뒤 각 알파벳과 해시 자릿값으로 대소문자를 결정하는 ERC-55 흐름.
이 글의 공개 입력과 계산을 바탕으로 직접 만든 도식입니다. 실제 관측 화면이나 외부 이미지가 아닙니다.

어떤 문자열을 해시하는지부터 맞춥니다

계산 입력은 0x를 뺀 40자리 16진수의 소문자 ASCII 문자열입니다. 그 문자열을 Keccak-256으로 해시하고, 주소의 각 알파벳과 같은 위치의 해시 16진수 한 자리를 대조합니다. 해시 자릿값이 8 이상이면 해당 알파벳을 대문자로 쓰고, 7 이하면 소문자로 씁니다. 숫자 0~9의 표기는 바뀌지 않습니다. 아래 뷰어에서 1번째 문자는 0x 뒤 첫 문자를 뜻합니다.

바이트 20개 자체를 해시하거나 대문자·소문자가 섞인 원문을 그대로 해시하면 이 규칙과 다른 입력을 계산하게 됩니다. 이름이 비슷한 NIST SHA3-256도 이번 ERC-55의 Keccak-256과 같지 않습니다. 공개 결과의 sha3_counterexample에는 같은 테스트 문자열에 두 함수를 적용했을 때 서로 달라진 표기를 남겼습니다. SHA3 결과가 틀린 해시라는 뜻이 아니라 ERC-55에 지정된 함수와 다르다는 뜻입니다.

표준 8개와 변형 32개에서 무엇을 확인했나

변환 상황행 수엄격한 표기 일치원문과 같은 20바이트
official888
lowercase828
uppercase828
one_case_flipped808
changed_hex_rechecksummed880

글자 한 곳의 대소문자만 뒤집은 8행은 모두 엄격한 표기 대조에서 불일치했습니다. 하지만 그 변환은 알파벳의 대소문자만 바꿨으므로 각 테스트 원문과 같은 20바이트입니다. ‘체크섬 표기가 일치하지 않는다’와 ‘다른 주소 바이트다’를 같은 문장으로 표시하면 이 차이를 놓칩니다.

반대 방향의 대조도 중요합니다. 마지막 16진수 한 자리를 의도적으로 바꾸고 변경된 주소에 맞춰 체크섬을 다시 만든 8행은 표기 검사에 통과하면서 원문과는 다른 20바이트가 됐습니다. 체크섬은 올바른 상대의 주소 목록을 알고 있는 인증 기관이 아닙니다. 이 8행은 가능한 모든 오타나 공격의 성공률을 측정한 표본도 아닙니다.

모두 소문자이거나 모두 대문자라는 외형만으로 검사 결과를 미리 정해서도 안 됩니다. 공식 테스트 값에는 규칙을 적용한 결과가 전부 소문자 또는 전부 대문자인 주소도 포함돼 있습니다. 뷰어는 ‘대소문자가 섞였는가’ 대신 이번 코드가 계산한 정확한 표기와 같은지를 표시합니다. 다른 지갑이 소문자 입력을 허용하는 정책과 이 글의 엄격한 표기 대조는 별개입니다.

대소문자만 바꾸면 같은 바이트지만 표기 불일치, 다른 바이트로 바꿔 재계산하면 표기 일치가 가능한 8행 대조.
이 글의 공개 입력과 계산을 바탕으로 직접 만든 도식입니다. 실제 관측 화면이나 외부 이미지가 아닙니다.

40개 공개 입력의 글자·해시 자리를 따라가기

아래 기능은 Python이 계산한 공개 결과를 다시 보여 줍니다. 브라우저에서 새로운 주소의 해시를 계산하거나 지갑에 연결하지 않습니다. 실제 주소·복구 문구·개인키를 입력하는 칸은 없습니다. 어떤 글자를 바꿨고 어느 자리에서 표기가 달라졌는지 확인하는 용도입니다.

공개40사례를 읽는 중입니다.

자리입력해시 자리규칙기대 표기대조

질문 유형과 바이트 조건은 함께 적용합니다. 예를 들어 ‘표준 원문’과 ‘다른 바이트만’은0건이므로 이전 사례 결과를 지웁니다. ‘다른 바이트에 체크섬을 다시 만들면’은8건이며, 표기 일치와 원문 바이트 일치가 별개임을 볼 수 있습니다. 선택 사례 링크는 공개 사례 번호만 담고, 다시 열면 필터를 풀어 해당 사례를 표시합니다. 원래40입력·해시·계산 결과와 자리별 표는 그대로 유지하며 새 주소를 계산하는 기능은 아닙니다.

검사 다음에 남아 있는 질문

체크섬 결과를 얻었으면 수취인을 별도 경로로 확인했는지, 전체 40자리를 올바른 기준 주소와 비교했는지부터 구분해 적습니다. 이 글의 결과에는 네트워크·토큰 계약·상대 소유권·송금 가능 여부가 없습니다. 네트워크를 바꿔도 같은 문자열이 보일 수 있다는 이유로 지원 자산까지 같다고 추론하지 않습니다.

전체 주소 일치와 복사·붙여넣기 경로의 차이는 주소 바꿔치기 비교, 심볼과 네트워크·계약의 구분은 자산 식별 글에서 이어집니다. 여기서 추가한 것은 ERC-55 표기 규칙의 실제 로컬 계산과 한계이며, 기존 글의 문자열 일치 도구를 실제 수취인 인증 기능으로 확장한 것이 아닙니다.

같은 규격 테스트를 새 폴더에서 재현하기

Python 코드 링크는 텍스트로 열리므로 내려받은 reproduce-checksum-address.py.txt에서 마지막 .txt를 제거해 reproduce-checksum-address.py로 저장한 뒤 아래 명령을 실행합니다. 결과 JSON과 입력 자료도 같은 폴더에 둡니다.

python3 -m venv .venv
.venv/bin/python -m pip install -r checksum-requirements.txt
.venv/bin/python reproduce-checksum-address.py > checksum-results.json

의존성은 PyCryptodome 3.23.0으로 고정했습니다. 가상환경 경로는 운영체제에 맞게 바꿉니다. 실행 코드는 포함된 공식 테스트 문자열만 계산하며 RPC·지갑·외부 주소 조회를 하지 않습니다. 40행의 검사 결과와 해시 입력을 함께 확인하고, 실제 수취인 확인이나 송금 성공을 재현한 것으로 해석하지 마세요.

참고 자료와 적용 범위

  1. ERC-55 — Mixed-case checksum address encoding

    소문자 16진수 ASCII의 Keccak-256 규칙과 공식 테스트 8주소를 대조했습니다. 수취인 신원이나 네트워크 지원을 확인하는 규격이 아닙니다.

  2. PyCryptodome — Keccak

    Keccak과 NIST SHA-3의 차이, digest_bits=256 API를 대조했습니다. 실행 의존성은 3.23.0으로 고정했습니다.

출처 대조일 2026-11-02 · AI를 글·코드 작성과 실행·검산 보조에 사용했습니다. 가상 계산과 저장 자료의 범위를 구분하며 독립적인 사람 감수를 받았다는 뜻은 아닙니다. 오류·정정 제보