다음 탈중앙화 생태계가 자라는 것을 지켜보기만 하지 마세요. 함께 만들어 가세요.
ZooBC는 게이트웨이와 API를 통해 체인을 공개하며, 지갑은 그 위에 이미 구축된 거래소, 결제, 애플리케이션, 커뮤니케이션, 스토리지, 비즈니스 도구, 인프라 제어 기능을 보여 줍니다.
왜 이 상징일까요?
비버는 날것의 재료를 실제로 작동하는 환경으로 바꿉니다. 비버는 프로토콜을 사람들이 사용할 수 있는 도구, 브리지, 애플리케이션, 공간으로 바꾸는 개발자와 제품 팀을 상징합니다.
날카로운 모서리까지 포함해, 실제로 존재하는 프로토콜을 기준으로 구축하세요.
ZooBC는 폭넓은 트랜잭션 및 애플리케이션 영역을 제공하지만, 통합은 정확한 와이어 동작에서 시작합니다: 어떤 서비스가 요청을 받는지, 어떤 필드가 서명된 엔벨로프에 들어가는지, 어떤 금액이 아토믹 단위인지, 수수료가 어떻게 계산되는지, 어떤 결과가 성공을 증명하는지.
올바른 서비스 선택
/api/v1/ 아래의 체인 읽기는 아카이브 이력에서 제공될 수 있습니다. 트랜잭션 POST는 멤풀이 필요하므로 반드시 풀 노드에 도달해야 합니다. 일부 애플리케이션 상태 경로는 아카이브 엔드포인트가 아니라 노드 엔드포인트입니다.
서명된 엔벨로프 모델링
모든 트랜잭션은 유형별 바디를 공통 엔벨로프로 감쌉니다. 수신자와 메모는 유형 바디가 아니라 엔벨로프에 들어갈 수 있습니다. 서명되지 않은 전체 엔벨로프에 계정 유형이 요구하는 방식으로 서명하세요.
값을 정확하게 유지
API 금액은 아토믹 단위를 사용합니다: 1 ZBC는 100,000,000 아토믹 단위입니다. 예전 인터페이스의 수수료 계산을 그대로 재현하지 말고, 현재 수수료 파라미터를 읽거나 해당 트랜잭션의 정확한 수수료를 추정하세요.
결과 검증
제출에 성공했다고 워크플로가 끝나는 것은 아닙니다. 트랜잭션 식별자를 보관하고, 블록 포함 여부를 찾고, 그 결과로 생긴 잔액 변동이나 상태를 확인하고, 노드의 수락 응답과 확정된 체인 상태를 구분하세요.
이것들을 기술 규약으로 다루세요.
대부분의 통합 실패는 사용자 인터페이스가 가리고 있는 경계를 위반하는 데서 비롯됩니다.
| 규약 | 필수 동작 | 흔한 실패 |
|---|---|---|
| 읽기 대 쓰기 라우팅 | GET에는 읽을 수 있는 체인 엔드포인트를, 트랜잭션 POST에는 풀 노드의 멤풀 경로를 사용합니다. | 아카이브 이력으로 브로드캐스트하고, 그 거부를 잘못된 트랜잭션으로 해석함. |
| 아토믹 금액 | ZBC와 토큰 값을 정수 아토믹 단위로 표현하고, 토큰 소수 자릿수는 표시할 때만 적용합니다. | 소수로 된 표시 값을 와이어 금액인 것처럼 전송함. |
| 수수료 계산 | 공개 TestNet 게이트웨이에서 https://zoobc.network/api/v1/blockchain/fee-params를 읽거나, 직렬화된 트랜잭션에 대해 정확한 수수료 추정기를 사용합니다. | 크기, 스토리지, 기간 또는 네트워크 수수료 규모와 더 이상 맞지 않는 수수료를 하드코딩함. |
| 엔벨로프와 바디 | 공통 엔벨로프와 정확한 리틀 엔디언 유형별 바디, 선택적 수정자를 직렬화합니다. | 수신자, 메모, 토큰 ID 또는 시간 데이터를 잘못된 계층에 넣음. |
| 키 처리 | 로컬에서 서명하고, 비공개 정보는 URL, 로그, 프로세스 목록, 분석 도구, 서버에 남기지 않습니다. | 개인 키를 눈에 보이는 명령줄 인수나 원격 양식 필드로 전달함. |
| 상태 해석 | 서명된 행동에는 트랜잭션을, 그로 인한 프로토콜 효과에는 잔액 변동이나 애플리케이션 상태를 사용합니다. | 모든 보상, 환불, 베스팅 해제 또는 앱 결과를 새로운 사용자 트랜잭션이라고 가정함. |
검증 가능한 수직 슬라이스 하나를 먼저 구축하세요.
큰 인터페이스를 설계하기 전에 읽기 하나, 서명된 TestNet 행동 하나, 확정된 결과 하나가 처음부터 끝까지 작동하게 만드세요.
- 01
연결 입증
블록체인 상태를 조회하고 반환된 높이를 보관하세요. 계정을 만들거나 테스트 코인을 요청하기 전에 대상 네트워크와 게이트웨이 동작을 확인하세요.
- 02
정확한 트랜잭션 유형 하나 선택
그 유형의 엔벨로프, 바디 레이아웃, 계정 유형, 수수료 동작, 수정자, 결과를 읽으세요. 인터페이스가 비슷해 보인다는 이유만으로 한 트랜잭션 형식에서 다른 형식을 추론하지 마세요.
- 03
로컬에서 빌드하고 서명
정수 아토믹 금액을 직렬화하고, 정확한 수수료를 추정하고, 개인 키를 서버, 로그, URL, 분석 이벤트, 셸 기록에 노출하지 않고 서명하세요.
- 04
제출, 확인, 대조
풀 노드에 제출하고, 반환된 식별자를 보관하고, 익스플로러나 API로 블록 포함 여부를 찾고, 성공을 보고하기 전에 그 결과로 생긴 잔액 변동이나 애플리케이션 상태를 확인하세요.
통합 과정에서 키가 유출될 수 있거나, 표시 단위와 아토믹 단위를 혼동하거나, 오래된 수수료 가정을 하드코딩하거나, 잘못된 서비스에 제출하거나, 노드 수락을 최종 확정으로 보고하는 동안에는 TestNet에서 실제 가치가 오가는 환경으로 넘어가지 마세요.
동작에 가장 가까운 참조 자료를 사용하세요.
개발자 가이드는 토폴로지를 설명하고, API 문서는 경로를 기술하며, 매뉴얼은 직렬화와 애플리케이션 규칙을 문서화하고, 실시간 도구로는 전체 경로를 테스트할 수 있습니다.
게이트웨이 동작, 첫 경로, 트랜잭션 제출, 노드 지정, 운영, 다운로드.
↗경로 참조API 문서메서드, 경로, 파라미터, 인증, 요청 본문, 응답 예시.
↗와이어 형식트랜잭션 매뉴얼엔벨로프 구조, 서명, 아토믹 단위, 수수료 추정, 수정자, 모든 트랜잭션 유형.
↗명령CLI 매뉴얼TestNet 작업을 위한 명령 동작과 지원되는 트랜잭션 빌드 경로.
↗애플리케이션 규칙앱 매뉴얼앱 트랜잭션 바디, 레지스트리, 지급, 난수, 상태 채널, 상태 경로, 검증.
↗테스트 자금포셋지원되는 개발 및 트랜잭션 테스트를 위해 가치 없는 TestNet ZBC를 받으세요.
↗실패는 명확하게, 키는 지루하게 만드세요.
유용한 통합은 상태에 대해서는 정확하고, 공격자에게는 흥미롭지 않습니다.
- 비공개 서명 정보는 로컬에 두고 원격 측정 데이터에서 제외하세요.
- 데이터 계층 전체에서 정수 아토믹 단위를 사용하세요.
- 실시간 프로토콜에서 수수료를 추정하세요.
- 트랜잭션 ID를 보관하고 그 결과로 생긴 잔액 변동을 대조하세요.
- 이용 불가, 대기 중, 거부됨, 포함됨, 확정됨 상태를 명확히 구분해 표시하세요.
- 오래된 수수료, 높이, 노드 목록, 릴리스 해시를 하드코딩하지 마세요.
- 아카이브 전용 경로로 쓰기를 보내지 마세요.
- 응답 본문을 읽고 트랜잭션을 추적하지 않은 채 200 응답을 확정된 상태의 증거로 취급하지 마세요.
- 문서화되지 않은 트랜잭션 필드나 애플리케이션 동작을 지어내지 마세요.
- 개인 키를 쿼리 문자열, 로그, 스크린샷, 지원 문의 메시지에 넣지 마세요.
혹시 당신의 이야기인가요?
개발자, 애플리케이션 팀, 프로토콜 엔지니어, 테스터, 기술 기여자를 위해.
애플리케이션, 프로토콜, 통합, 인프라 또는 개발자 도구를 만듭니다.
새로운 기능을 테스트하거나, 버그를 찾거나, 문서를 개선하고 싶습니다.
개방형 시스템, 로컬 서명, 검증 가능한 동작, 사용자 소유권을 중요하게 생각합니다.
기술 역량을 다른 사람들이 실제로 사용할 수 있는 무언가로 바꿀 수 있습니다.
진짜 문으로 들어오세요.
아래의 각 경로는 실제로 존재하는 ZooBC 페이지, 도구 또는 현재 커뮤니티 공간으로 이어집니다.
근거를 따라가세요.
하나의 마케팅 페이지에 의존하지 말고, 질문에 맞는 출처를 활용하세요.
관심에서 참여로.
- 01기술 모델 읽기
- 02API와 TestNet 도구 사용하기
- 03빌드, 버그 리포트, 테스트 또는 기술 제안 가져오기
다음 탈중앙화 생태계가 자라는 것을 지켜보기만 하지 마세요. 함께 만들어 가세요.
ZooBC는 게이트웨이와 API를 통해 체인을 공개하며, 지갑은 그 위에 이미 구축된 거래소, 결제, 애플리케이션, 커뮤니케이션, 스토리지, 비즈니스 도구, 인프라 제어 기능을 보여 줍니다.