입금 주소 발급

입금 주소는 계정, 자산 유형, 네트워크 조합으로 생성됩니다. 다른 배포 환경의 ID를 하드코딩하지 않고 현재 환경에서 조회합니다.

입금 주소의 역할, 같은 주소 문자열의 재사용, memo와 입금 거래의 관계는 입금 주소 개념을 먼저 확인합니다.

Sepolia USDT 조회

usdt_response="$(wallet_request GET '/asset-types?code=USDT&page=1&page_size=20')"
sepolia_response="$(wallet_request GET '/networks?is_active=true&page=1&page_size=100')"

export ASSET_TYPE_ID="$(printf '%s' "$usdt_response" | jq -er '.data.items[0].id // empty')"
export NETWORK_ID="$(printf '%s' "$sepolia_response" | jq -er '.data.items[] | select(.chain_id == 11155111) | .network_id')"
export ASSET_DECIMALS="$(printf '%s' "$usdt_response" | jq -er '.data.items[0].decimals // empty')"

응답의 success와 USDT 조회 결과를 먼저 확인합니다. Sepolia는 환경별 코드 대신 chain_id: 11155111로 선택합니다. 결과가 없으면 다음 페이지와 대상 환경의 지원 여부를 확인하고 진행을 중단합니다.

선택한 자산과 네트워크의 조합이 실제로 배포되어 있고 활성 상태인지 확인합니다.

wallet_request GET "/assets/by-type-network?asset_type_id=$ASSET_TYPE_ID&network_id=$NETWORK_ID" | jq

success와 data.is_active가 true이고 응답이 Ethereum Sepolia의 USDT를 나타낼 때만 진행합니다.

주소 생성

ID는 JSON 숫자로 전송합니다.

address_body="{\"asset_type_id\":$ASSET_TYPE_ID,\"network_id\":$NETWORK_ID}"

address_response="$(
  wallet_request POST "/accounts/$ACCOUNT_ID/deposit-addresses" "$address_body"
)"
printf '%s\n' "$address_response" | jq

export DEPOSIT_ADDRESS="$(printf '%s' "$address_response" | jq -r '.data.address')"

반환된 주소를 ACCOUNT_ID, ASSET_TYPE_ID, NETWORK_ID와 함께 저장합니다. EVM 네트워크에서는 일반적으로 tag_or_memo가 null이지만 다른 네트워크에서는 필요할 수 있으므로 고객 화면에 주소와 함께 표시합니다.

발급된 주소 다시 조회

wallet_request GET "/accounts/$ACCOUNT_ID/deposit-addresses?page=1&page_size=20" | jq

고객 화면에는 네트워크 이름을 명확하게 표시합니다. 잘못된 네트워크로 전송한 자산은 복구하지 못할 수 있습니다.

다음: 입금 내역 확인