자식주소 시스템 구축하기

자식주소 생성하기

엔드 유저에게 발급할 주소를 생성합니다. 일반적으로 자식주소는 엔드 유저 당 1개씩 발급합니다. 자식주소는 API를 호출하여 생성하며, 콘솔에서 발급된 자식주소 목록을 확인할 수 있습니다.

자식주소 잔액 관리하기

자식주소 별 잔액은 주소 잔액 조회 API를 호출하여 조회할 수 있습니다.

👀
대부분의 플랫폼은 동일한 자식주소 구조를 가지지만, 플랫폼에 따라 자식주소 구조가 다를 수 있으니 플랫폼 별 상세 가이드를 참고해 주시기 바랍니다.

입금 시스템 구축하기

토큰 추가하기

옥텟에서는 등록된 토큰만 입금 처리합니다. 따라서 토큰을 입금하기 전 해당 토큰을 지갑에 추가해야 합니다.

[지갑 설정] - [토큰 관리]에서 토큰을 추가할 수 있습니다.
원하는 토큰이 목록에 없다면, 우측 상단의 [신규 토큰 등록 신청] 페이지에서 신규 토큰을 신청할 수 있습니다.

입금 발생 확인하기

1. 콘솔에서 확인하기

콘솔의 [입출금 내역]에서 입금 내역을 확인할 수 있습니다. UNFINALIZED 상태인 입금은 '진행'으로 표시되며, FINALIZED 상태인 입금은 '완료'로 표시됩니다.

2. 웹훅으로 확인하기

대표주소나 자식주소에 입금이 완료되면 입금 웹훅이 전송됩니다. 전송된 웹훅으로 입금 여부를 확인할 수 있습니다. 웹훅 이용 방법과 전송되는 데이터 형태는 웹훅 페이지를 참고하세요.

출금 시스템 구축하기

자식주소에서 출금하기

자식주소에 보관된 자산을 외부로 출금합니다. 자식주소 출금 신청 API를 호출하여 출금을 신청할 수 있습니다.

대표주소에서 출금하기

대표주소에 보관된 자산을 외부로 출금합니다. 출금 신청 API를 호출하거나, 콘솔에서 출금을 신청할 수 있습니다.

출금 승인 설정하기

기본적으로 모든 출금은 관리자의 승인을 받은 뒤 진행됩니다. 단, API 출금 시 해당 설정을 비활성화 할 수 있으며, 이 경우 출금 신청 즉시 출금이 진행됩니다.

API 출금 - 관리자 승인을 비활성화 할 수 있습니다.
콘솔 출금 - 관리자 승인이 필수입니다.

출금하기

출금 신청 API를 호출하면 대표주소에서 외부로 출금을 요청할 수 있습니다. 출금 요청에 성공하면 uuid 값이 반환됩니다. 해당 값으로 출금 진행 상태를 조회할 수 있습니다.

Response 예시

{
  "uuid": "18012e3f-07f3-45ec-862b-f020c0ca935a"
}

출금 완료 확인하기

1. 콘솔에서 확인하기

콘솔의 [입출금 내역]에서 출금 내역을 확인할 수 있습니다. AWAITING_WITHDRAWAL와 PENDING 상태인 출금은 '진행'으로 표시되며, FINALIZED 상태인 출금은 '완료'로 표시됩니다.

2. API로 확인하기

출금 트랜잭션 정보 조회 API를 호출하면 특정 출금 트랜잭션의 진행 상태를 확인할 수 있습니다.

Response 예시

{
  "idx": 490,
  "uuid": "07efdcb2-b3fd-4fe7-bf47-c0b460b289e3",
  "fromAddress": "0x71b5De2970A32eEf6362AE7Bc3B73103b4392bB0",
  "toAddress": "0x295909dC67B76f936BD4119aDd877088602cCaD3",
  "amount": "2.00000000000000000000",
  "memo": null,
  "requestId": "25",
  "type": "API",
  "description": "",
  "requiredApprovalCount": 1,
  "useApiAutoApproval": true,
  "status": "SENT",
  "createdDate": "2022-01-25T09:25:02.383Z",
  "modifiedDate": "2022-01-25T09:25:10.000Z",
  "rejectedDate": null
}

3. 웹훅으로 확인하기

대표주소에서 외부로 출금이 완료되면 출금 웹훅이 전송됩니다. 전송된 웹훅으로 출금 여부를 확인할 수 있습니다. 웹훅 이용 방법과 전송되는 데이터 형태는 웹훅 페이지를 참고하세요.