01
가입
콘솔 계정을 만들면 테스트넷을 바로 쓸 수 있습니다.결과물API 토큰, 테스트넷 지갑담당고객사소요 시간몇 분
02
연동
테스트넷에서 입금부터 출금까지 전체 흐름을 구현하세요.결과물입금과 출금 흐름 완성담당고객사 개발팀소요 시간개발 일정에 따름
03
계약과 검토
계약을 맺고, 트래블룰 설정을 Octet과 함께 정합니다.결과물메인넷 접근 권한담당고객사와 Octet소요 시간함께 협의
04
메인넷 전환
호스트와 토큰만 바꾸면 되고, 코드는 그대로 씁니다.결과물운영 지갑담당고객사소요 시간설정 변경만
자금 보관
커스터디 지갑
자산과 키를 보관하며, 모든 출금이 이 지갑에서 출발합니다.
입금 받기
차일드 주소
이용자마다 메인 지갑 아래 입금 주소를 발급하고, 모인 자금은 원하는 때 메인 지갑으로 집금할 수 있습니다.
출금
출금 지갑
출금 전담 지갑으로, 모든 요청은 서명 전에 승인을 거칩니다.
발행
NFT 컨트랙트
NFT 컨트랙트 배포와 발행도 같은 API로 합니다.
고객사 서버
POST 차일드 주소 생성→이용자에게 안내이용자
주소로 입금
Octet
입금 웹훅→고객사 웹훅 주소
고객사 서버
이용자 잔고 반영→
POST 집금 (차일드 → 메인)고객사 서버
POST 출금 요청→상태: 승인 대기콘솔
승인자 확인또는 취소 / 정지
Octet
서명 요청→전송→출금 웹훅
고객사 서버
완료 처리→
GET 거래 내역으로 대조인증
모든 API 호출은 등록한 IP에서 Bearer 토큰을 붙여 보내 주세요.
API 토큰
콘솔에서 발급받아 Bearer 헤더에 넣어 보내세요. 필요하면 언제든 재발급할 수 있습니다.
API IP 등록
API를 호출하는 서버를 모두 등록하세요. 등록하지 않은 서버의 호출은 거부됩니다.
콘솔 IP 제한
콘솔 로그인은 사무실이나 VPN으로 제한하세요.
출금 승인
지갑마다 설정하세요. 승인자가 확인할 때까지 요청은 대기합니다.
// 예시입니다. 정확한 필드는 API 레퍼런스를 확인하세요. // POST https://your-app.example/octet/webhook { "event": "deposit | withdrawal", "walletIdx": "…", "txHash": "0x…" } // 먼저 200으로 응답하고 그다음에 처리하세요.
테스트넷과 메인넷
메인넷에서는 호스트와 토큰만 바뀝니다. 테스트 자산은 네트워크별 파우셋에서 받으세요.
| 테스트넷 | 메인넷 | |
|---|---|---|
| 이용 조건 | 직접 가입, 승인 없음 | Octet 검토 후 |
| 비용 | 무료 | 요금제에 따라 다릅니다. 요금 보기 |
| 호스트 | api.testnet.octet.im | 메인넷 전환 시 안내 |
| API 토큰 | 테스트넷 토큰 | 별도의 메인넷 토큰 |
| IP 등록 | 권장 | 필수 |
| 출금 승인 | 선택(테스트넷에서 미리 시험 가능) | 전환 전 설정 |
| 네트워크 | 지원 테스트넷 | 메인넷 23개 |
| 테스트 자산 | 공개 파우셋 | 실제 자산 |
| 트래블룰 | 흐름 테스트 | 프로젝트별로 설정 |
| 호출 제한 | 레퍼런스 참조 | 레퍼런스 참조 |
- 4xx는 재시도 전에 인증, IP 등록, 파라미터를 확인하세요.
- 5xx와 타임아웃은 간격을 두고 재시도하세요. 출금을 다시 보내기 전에는 거래 내역을 확인해 주세요.
- 승인 대기 중인 출금은 에러가 아닙니다.
- 문의 시 요청 ID, 지갑 번호, 시각을 함께 보내 주세요.
오픈 시 제공
AI 도구
AI 코딩 도구를 MCP로 Octet 문서에 연결하세요. 텍스트 색인은 /llms.txt에 있습니다.
이렇게 물어보세요
- 차일드 주소는 어떤 호출로 만드나요?
- 출금은 어떤 상태를 거치나요?
- 웹훅 주소는 어떻게 등록하나요?
- 토큰 조회에 컨트랙트 주소가 필요한 네트워크는 무엇인가요?
메인넷 전환 점검
메인넷 첫 출금 전에 아래 항목을 확인하세요.
- API를 호출하는 서버 IP 등록
- 지갑마다 출금 승인 설정
- 보안 알림 켜기
- API 토큰은 코드가 아닌 시크릿 매니저에 보관
- 트래블룰 설정은 검토 단계에서 확정
- 01미등록 IP호출이 모두 거부되니, 스테이징 서버와 운영 서버를 각각 등록해 두세요.
- 02승인자 미지정출금이 승인 대기에서 넘어가지 않으니, 첫 요청 전에 승인자를 지정하세요.
- 03웹훅 중복 수신이벤트 ID로 중복을 거르고, 먼저 200으로 응답하세요.
- 04저장소에 올라간 토큰바로 재발급하고, 시크릿 매니저에 보관하세요.
- 05트래블룰 설정을 마지막까지 미룸메인넷 전환이 아니라 검토 단계에서 설정을 확정하세요.