Multibase to Bytes
접두사를 자동 감지하여 Multibase 문자열을 디코딩한다
개요
자기 기술형 Multibase 문자열의 첫 글자 접두사(z, f, F, m, u)를 자동으로 판별하여 나머지 페이로드를 원시 바이트 배열(Uint8Array)로 디코딩한다.
사용 시점
- IPFS/libp2p/DID 생태계에서 전달된 Multibase 문자열을 별도의 인코딩 설정 없이 자동으로 바이트로 복원할 때 사용한다.
파라미터 설정
이 노드는 속성창에서 설정할 수 있는 별도의 정적 파라미터가 없으며, 알고리즘 규격과 연결된 포트 값에 의해서만 동작이 결정된다.
포트 입출력 명세
포트 연결 규칙, 데이터 타입별 색상, 가변 포트 생성 방식은 포트 및 연결 문서를 참고한다.
입력 포트
포트 성격: 고정 입력 포트 (총 1개).
| 포트 이름 | 포트 ID | 데이터 타입 | 필수 여부 | 노출 조건 | 설명 |
|---|---|---|---|---|---|
Multibase In |
string |
String |
필수 | 항상 노출 | Multibase 문자열 |
출력 포트
포트 성격: 고정 출력 포트 (총 1개).
| 포트 이름 | 포트 ID | 데이터 타입 | 노출 조건 | 설명 |
|---|---|---|---|---|
Bytes Out |
bytes |
Bytes |
항상 노출 | 디코딩된 원시 바이트 배열(Uint8Array)이다. |
오류 케이스
실행 중 아래 조건이 발생하면 이 노드는 ERROR 상태가 되며, 출력 포트에 연결된 하위 노드는 실행되지 않는다.
| 오류 코드 | 기본 엔진 메시지 | 발생 조건 |
|---|---|---|
INVALID_MULTIBASE_STRING |
Multibase 문자열이 너무 짧다 | 입력 문자열이 2글자 미만이어서 접두사나 본문이 없을 때 발생한다. |
UNSUPPORTED_MULTIBASE_PREFIX |
인식할 수 없는 Multibase 접두사이다 | 첫 글자가 지원되는 접두사(z, f, F, m, u)가 아닐 때 발생한다. |
INVALID_HEX_LENGTH |
Hex 문자열의 길이가 짝수가 아니다 | f/F(Hex) 본문의 글자 수가 홀수일 때 발생한다. |
INVALID_HEX_CHAR |
Hex 문자열에 올바르지 않은 문자가 포함되어 있다 | f/F(Hex) 본문에 16진수가 아닌 문자가 있을 때 발생한다. |
INVALID_BASE58_CHAR |
Base58 문자열에 올바르지 않은 문자가 포함되어 있다 | z(Base58BTC) 본문에 허용되지 않는 문자가 있을 때 발생한다. |
INVALID_BASE64_INPUT |
Base64 문자열이 올바르지 않는다 | m/u(Base64/Base64URL) 본문이 올바르지 않을 때 발생한다. |
활용 예시
Multibase 문자열 자동 디코딩하기
접두사를 자동 인식해 바이트와 인코딩 이름을 동시에 얻는다.
- Multibase 문자열을 Multibase to Bytes의
Multibase String에 연결하면Bytes와Detected Format이 함께 출력된다.