토큰 전송

특정 KIP-37 컨트랙트를 통해 발행된 토큰을 전송합니다. 한번에 여러 토큰을 원하는 만큼 전송할 수 있습니다.

Sender

토큰 전송을 위한 트랜잭션을 전송하는 계정입니다. 만약 sender와 owner가 다를 경우 sender는 반드시 해당 토큰의 전송 권한을 가지고 있어야 합니다.

sender 계정이 KIP-37 또는 Wallet 서비스에서 제공하는 기본 account-pool인 경우 생략이 가능합니다.
기본 account-pool이 아닌 경우 헤더에 KRN 정보(x-krn: krn:{chain-id}:wallet:{account-id}:account-pool:{pool name})를 포함해야 합니다.

Batch Items

여러 종류의 토큰을 각각 다른 수량으로 전송할 수 있습니다. 요청에 포함된 Batch Items(ids, amounts)에 따라 다른 컨트랙트 함수가 호출됩니다.

  • 원소가 1개인 경우 safeTransferFrom 함수가 호출됩니다.
  • 원소가 여러 개인 경우 safeBatchTransferFrom 함수가 호출됩니다.
Request
Security:
basic
path Parameters
contract-address-or-alias
required
string

컨트랙트 주소(0x로 시작하는 16진수) 또는 별칭입니다.

header Parameters
x-chain-id
required
string

Kaia 네트워크 체인 ID (1001 또는 8217)

x-krn
string

계정 저장소(Account Pool)에 고유한 KRN(KAS Resource Name)값입니다.

Request Body schema: application/json
sender
required
string

토큰을 전송할 Kaia 계정 주소입니다.

owner
required
string

토큰을 소유한 Kaia 계정 주소입니다.

to
required
string

토큰을 전송 받을 Kaia 계정 주소입니다.

ids
required
Array of strings

전송할 토큰 ID의 배열입니다.

amounts
required
Array of strings

전송할 토큰 수량(16진수)의 배열입니다.

Responses
200

요청이 성공적입니다.

400

요청이 유효하지 않습니다.

404

요청한 자원이 존재하지 않습니다.

post/v2/contract/{contract-address-or-alias}/token/transfer
Request samples
application/json
{
  • "sender": "0x9eaf20b40e0f1ced5dbba6f5cfb0d3e12b0534f4",
  • "owner": "0x9eaf20b40e0f1ced5dbba6f5cfb0d3e12b0534f4",
  • "to": "0xDc277E2D89b92336A4ee80be3c7142443FDaDE47",
  • "ids": [
    ],
  • "amounts": [
    ]
}
Response samples
application/json

요청이 성공적입니다.

{
  • "status": "Submitted",
  • "transactionHash": "0xb5a0618be3508b3fe22e35aa96063005dd4c557cf040348cc542b0726cc30f7b"
}