Base58 인코딩/디코딩 (바이너리)

100% 클라이언트 측 처리 (서버 업로드 없음). 바이너리 파일을 Base58 텍스트로 인코딩하거나 Base58을 다시 원시 바이트로 디코딩합니다. 알파벳 선택 (비트코인/플리커/리플), 인코딩 시 선택적 줄 바꿈, 디코딩 시 엄격한 검증 및 구분자 처리 기능을 포함합니다.

Loading…

소개 Base58 인코딩/디코딩 (바이너리)

이 도구는 Base58 및 바이너리 데이터 작업을 위한 여러 작업을 지원합니다: 파일(바이트)을 Base58 텍스트로 인코딩하거나 Base58 텍스트를 다시 파일(바이트)로 디코딩합니다. 작업을 선택하고 알파벳 변형(비트코인, 플리커 또는 리플/XRP)을 선택한 후 실행하여 유효하지 않은 경우 명확한 오류와 함께 예측 가능한 출력을 얻으세요.

기능

바이너리 파일(바이트)을 Base58 텍스트로 인코딩
Base58 텍스트를 원시 바이트로 디코딩 (다운로드 가능한 파일 출력)
알파벳 선택: 비트코인 (기본값), 플리커, 리플 / XRP
인코딩 서식: 선택적 줄 바꿈 (0–120) 및 선택적 최종 줄 바꿈
출력 줄 구분자 선택: LF ( ) 또는 CRLF ( )
디코딩 도우미: data:*;base58, 접두사 및 구분자/공백 무시 (선택적) 허용
선택한 알파벳 외부 문자를 거부하는 엄격한 검증 옵션
빠른 변환을 위한 배치 패널이 있는 다중 파일 드롭존
100% 클라이언트 측 처리 (서버 업로드 없음).

사용 방법 for base58-binary-encoder

내용 붙여넣기 또는 드롭

인코딩: 드롭존에 바이너리 파일을 드롭/업로드합니다. 디코딩: 입력 영역에 Base58 텍스트를 붙여넣습니다 (또는 Base58이 포함된 텍스트 파일을 엽니다).

작업 선택 및 실행

작업 선택: "파일 → Base58 인코딩" 또는 "Base58 → 파일 디코딩". 알파벳(비트코인/플리커/리플)을 선택합니다. 그런 다음 "인코딩" 또는 "디코딩"을 클릭하여 실행합니다.

복사 또는 다운로드

인코딩한 경우: Base58 출력 텍스트를 복사합니다. 디코딩한 경우: 생성된 바이트를 파일로 다운로드합니다 (파일 이름 지정은 도구 규칙을 따릅니다, 예: .b58 제거 및 .bin으로 대체).

기술 사양

실행 모델

두 작업(인코딩 + 디코딩)에 대한 런타임 공개 및 제약 조건.

측면	상세 내용
런타임	100% 클라이언트 측 처리 (서버 업로드 없음).
작업 범위	인코딩 + 디코딩 (이 페이지)
인코딩 입력	바이너리 (파일/Blob/Uint8Array/ArrayBuffer/TypedArray)
인코딩 출력	Base58 텍스트 (선택적 래핑, 구성 가능한 줄바꿈 동작 포함)
디코딩 입력	Base58 텍스트 문자열 (선택적으로 data:*;base58, 접두사 허용)
디코딩 출력	원시 바이트 (기본적으로 .bin 파일로 다운로드)
알파벳	비트코인 (기본값), 플리커, 리플 / XRP
제한 사항	~1–2MB 문자; ~25000ms 타임아웃
데이터 보존	모든 처리는 로컬 브라우저에서 이루어집니다 (업로드 없음)

로컬 처리 환경에서도, 공유되거나 신뢰할 수 없는 장치에서는 매우 민감한 데이터를 다루는 것을 피하세요. 비밀 정보의 경우 오프라인 도구를 사용하는 것이 좋습니다.

간단한 예시

두 작업이 수행하는 기능의 최소한의 예시입니다 (출력은 옵션과 알파벳에 따라 다릅니다).

작업	예시 입력	예시 출력
인코딩	바이너리 바이트 (업로드된 파일)	Base58 텍스트 (알파벳에 따라 다름)
디코딩	Base58 텍스트	바이너리 바이트 (다운로드 가능한 파일)

이 도구는 바이너리 중심입니다: 인코드 모드에서는 바이트를 기대합니다 (일반 텍스트 문자열이 아님). 디코드 모드에서는 Base58 문자열을 기대합니다.

오류 및 예외 상황

일반적인 실패 모드와 해결 방법입니다.

증상	가능한 원인	확인할 사항
이 도구는 바이너리 데이터를 인코딩합니다... 텍스트 문자열이 아닙니다	바이트를 업로드하는 대신 문자열을 인코딩하려고 시도했습니다	드롭존을 사용하거나 파일을 업로드하거나, 통합 환경에서 바이트(Uint8Array/ArrayBuffer)를 전달하세요
지원되지 않는 바이너리 입력 유형	입력이 File/Blob/Uint8Array/ArrayBuffer/TypedArray가 아닙니다	Uint8Array로 변환하거나 파일을 업로드하세요
입력이 너무 큽니다 (최대 2MB)	입력이 크기 제한을 초과했습니다 (인코딩 바이트 또는 디코딩 텍스트)	파일/문자열을 분할하거나 청크 단위로 처리하세요
어댑터 호출 시간 초과	작업이 ~25000ms를 초과함	크기 축소; 대용량 파일의 일괄 처리 피함; 대용량 입력 시 실시간 미리보기 끄기 유지
잘못된 문자 / 유효성 검사 오류	Base58 문자열에 선택된 알파벳에 없는 문자가 포함됨	알파벳 선택 확인; 필요에 따라 엄격한 유효성 검사 활성화/비활성화
붙여넣은 형식화된 문자열에서 디코딩 실패	구분자/공백 또는 데이터 URI 접두사가 존재함	구분자/공백 허용 및 data:*;base58, 접두사 수용 활성화

명령줄 대안

자동화, CI 또는 민감한 데이터의 경우 로컬 도구를 사용하세요. Base58은 일반적인 OS 핵심 유틸리티에서 표준화되지 않았으므로, 필요한 정확한 알파벳(비트코인/플리커/리플)에 대해 잘 알려진 라이브러리를 사용하세요.

모든 플랫폼 (Python)

바이너리 파일을 Base58로 인코딩 (라이브러리 기반)

python -c "import sys; print('신뢰할 수 있는 Base58 Python 라이브러리를 사용하고 올바른 알파벳(비트코인/플리커/리플)을 선택하세요.')"

Python의 표준 라이브러리에는 Base58이 포함되어 있지 않습니다. 유지 관리되는 라이브러리를 사용하고 재현 가능한 출력을 위해 버전을 고정하세요.

Node.js

유지 관리되는 라이브러리를 사용하여 Base58 인코딩/디코딩

node -e "console.error('잘 알려진 Base58 라이브러리를 사용하고 올바른 알파벳(비트코인/플리커/리플)을 선택하세요.')"

Node는 코어에 Base58 코덱을 포함하지 않습니다. 신뢰할 수 있는 라이브러리를 선호하고 불일치를 피하기 위해 알파벳 선택을 문서화하세요.

사용 사례

전송을 위한 빠른 바이너리-텍스트 변환

모호한 문자를 싫어하는 시스템을 위해 작은 바이너리 블롭을 Base58로 인코딩
복사/붙여넣기 워크플로우를 위해 파일을 Base58 문자열로 변환

Base58 알파벳 간 상호 운용성 검사

파트너 시스템이 기대하는 알파벳(비트코인/플리커/리플) 검증
문서 및 테스트 벡터에서 알파벳 선택 표준화

Base58 입력에 대한 CI 정상성 검사

재현 가능한 파이프라인에서 엄격한 유효성 검사를 사용하여 비준수 Base58 문자열 거부
픽스처가 예상 바이트로 다시 디코딩되는지 확인

붙여넣은 Base58 문자열의 안전한 처리 및 검증

엄격한 유효성 검사를 활성화하여 우발적인 문자 혼동 방지
이메일 또는 로그에서 Base58을 수신할 때 데이터 URI 접두사 제거 및 구분자 무시

❓ Frequently Asked Questions

이 도구에 대한 공개 API가 있나요?

아니요. 이 도구는 대화형 브라우저 사용을 목적으로 하며 공개 API 엔드포인트를 노출하지 않습니다.

처리는 로컬인가요 원격인가요?

100% 클라이언트 측 처리 (서버 업로드 없음). 인코딩/디코딩은 귀하의 브라우저에서 실행되며, 파일과 문자열은 업로드되지 않습니다.

여기서 비밀 정보를 처리해야 할까요?

디바이스와 환경을 완전히 신뢰하지 않는 한, 브라우저에서 매우 민감한 비밀 정보를 처리하는 것은 피하세요. 민감한 데이터의 경우 로컬 스크립트나 CLI 도구를 사용하는 것이 좋습니다.

왜 "잘못된 문자" 오류로 디코딩이 실패하나요?

Base58은 알파벳에 의존합니다. 입력값이 선택된 알파벳(Bitcoin/Flickr/Ripple) 범위를 벗어나는 문자를 포함하면, 특히 엄격한 검증(Strict validation)이 활성화된 경우 디코딩이 실패할 수 있습니다. 올바른 알파벳을 선택하고, 문자열에 서식 문자가 포함된 경우 구분자/공백 허용(Allow separators/whitespace)을 활성화하는 것을 고려하세요.

왜 "디코딩을 위한 입력값은 문자열이어야 합니다" 또는 "파일을 업로드하세요" 오류가 발생하나요?

이 도구는 모드에 민감합니다: 인코딩(encode)은 바이트(파일 업로드 또는 바이트 배열 제공)를 기대하고, 디코딩(decode)은 Base58 텍스트 문자열을 기대합니다. 작업(Action)을 전환하거나 입력 유형을 그에 맞게 변경하세요.

Pro Tips

Best Practice

사용한 알파벳(Bitcoin vs Flickr vs Ripple)을 항상 문서화하고 공유하세요; Base58 출력은 알파벳 간에 호환되지 않습니다.

Best Practice

이메일이나 로그에서 복사한 문자열을 디코딩할 때는 "구분자/공백 허용(Allow separators/whitespace)"과 "data:*;base58, 접두사 허용(Accept data:*;base58, prefix)"을 활성화하여 복사/붙여넣기 실패를 줄이세요.

Security Tip

잘못된 알파벳이나 손상된 Base58을 조기에 감지하려면 "엄격한 검증(Strict validation)"을 활성화하세요.

Performance Tip

대용량 파일의 경우, 많은 항목을 한 번에 일괄 처리하지 말고 실시간 미리보기를 끄세요; 이 도구는 크기(~2MB)와 시간(~25000 ms) 제한을 적용합니다.

CI Tip

CI 환경에서는 고정된 라이브러리 구현을 사용하고, 지원하는 각 알파벳에 대한 테스트 벡터(입력 바이트 + 예상 Base58)를 커밋하세요.

Additional Resources

Bitcoin Core: Base58 인코딩 (개발자 참조)

Documentation