Base58Check 인코더 및 디코더

Base58Check 인코딩과 디코딩 방법

인코딩하려면 다음과 같이 합니다.

1. 입력 · Hex에 버전 바이트를 먼저, 그다음 페이로드를 hex로 붙여넣으세요. 공백, 콜론, 0x 접두사도 받습니다.
2. 출력 · Base58Check에서 결과를 읽으세요. 도구가 체크섬을 계산해 인코딩 전에 덧붙입니다.
3. 비트코인과 대부분의 포크에는 알파벳을 Bitcoin으로 두세요.

디코딩하려면 방향 전환에서 Base58Check → Hex를 누르고 주소나 키를 붙여넣으세요. 디코더는 변환한 뒤 체크섬을 다시 계산하고, 체크섬 4바이트가 모두 일치할 때만 페이로드(여전히 버전 바이트로 시작)를 돌려줍니다. 문자 하나만 잘못 입력해도 “체크섬이 일치하지 않습니다. 문자열에 오타가 있거나 손상되었습니다.“가 표시됩니다.

Base58Check가 Base58에 더하는 것

일반 Base58에는 오류 감지가 없습니다. 오타가 나면 다르지만 똑같이 올바른 문자열이 됩니다. Base58Check는 두 가지를 더해 이를 해결합니다.

version (1 byte) | payload | first 4 bytes of SHA-256(SHA-256(version | payload))

그런 다음 전체를 Base58로 인코딩하므로 앞쪽 0 바이트는 1이 됩니다. 버전 바이트는 네트워크와 데이터 유형을 정하며, 수의 맨 앞에 있으므로 결과의 첫 문자도 정해 줍니다.

버전 바이트와 접두사

같은 20바이트 해시 62e907b15cbf27d5425399ebf6f0fb50ebb88f18에 다른 버전 바이트를 붙이면 다음과 같습니다.

첫 행은 비트코인 제네시스 블록의 보상을 받은 주소입니다. 나머지 행은 버전 바이트를 보여 주기 위한 것일 뿐입니다. P2SH는 스크립트를 해시하므로, 공개 키 해시를 P2SH 버전 바이트로 감싸도 쓸 수 있는 P2SH 주소가 되지는 않습니다.

WIF 개인 키

Wallet Import Format은 버전 바이트 80과 32바이트 개인 키로 된 Base58Check입니다. 끝에 붙는 01 바이트는 공개 키를 압축 형태로 쓰는 키라는 표시입니다. 비트코인 위키에 실린 잘 알려진 예시 키로 보면 다음과 같습니다.

압축되지 않은 WIF 키는 5로, 압축된 키는 K나 L로 시작합니다. 이 예시 키는 공개되어 있으니 실제 자금에는 절대 쓰지 마세요.

Python에서 Base58Check

체크섬은 표준 라이브러리의 SHA-256 호출 두 번입니다. 작은 Base58 인코더와 함께 쓰면 다음과 같습니다.

import hashlib

ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz"

def b58encode(data: bytes) -> str:
    n = int.from_bytes(data, "big")
    out = ""
    while n:
        n, r = divmod(n, 58)
        out = ALPHABET[r] + out
    zeros = len(data) - len(data.lstrip(b"\0"))
    return "1" * zeros + out

def b58check(payload: bytes) -> str:
    checksum = hashlib.sha256(hashlib.sha256(payload).digest()).digest()[:4]
    return b58encode(payload + checksum)

b58check(bytes.fromhex("0062e907b15cbf27d5425399ebf6f0fb50ebb88f18"))
# '1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa'

코드에서 문자열을 검증하려면 Base58로 디코딩하고, 마지막 4바이트를 떼어 나머지의 이중 해시와 비교하세요. Python의 바이트 처리는 Python 페이지에 더 있습니다.

자주 겪는 문제

• 체크섬이 일치하지 않습니다. 문자열에 오타가 있거나, 잘렸거나, 체크섬이 없는 일반 Base58입니다(솔라나 주소와 IPFS 해시는 일반 Base58이니 Base58 디코더를 쓰세요).
• “4바이트 체크섬을 담기에는 너무 짧습니다”. 디코딩한 값이 4바이트보다 짧으므로 Base58Check일 수 없습니다.
• 예상하지 못한 문자 "0", "O", "I", "l". Base58 알파벳에 없는 문자입니다. 옮겨 적은 내용을 확인하세요.
• 인코딩 후 첫 문자가 다릅니다. 버전 바이트를 확인하세요. 버전 바이트가 없으면 20바이트 해시는 대개 1로 시작하지 않는 문자열로 인코딩됩니다.

자주 묻는 질문