토큰 전송

정해진 주소로 토큰을 전송합니다. 만약 토큰의 sender와 owner가 다를 경우 sender는 반드시 해당 토큰의 전송 권한을 가지고 있어야 합니다. 전송 권한은 v2/contract/{contract-address-or-alias}/approve/{token-id}을 통해 부여할 수 있습니다.

잘못된 토큰 ID를 입력한 경우에도 트랜잭션이 전송(Submitted)되었다는 결과가 반환됩니다. 하지만 아직 트랜잭션이 성공적으로 실행(Committed)된 것은 아닙니다. 트랜잭션 실행 성공 여부를 확인하기 위해서는 Wallet API의 트랜잭션 조회를 사용할 수 있습니다.

Sender

토큰 전송을 위한 트랜잭션을 전송하는 계정입니다. sender 계정이 KIP-17 또는 Wallet 서비스에서 제공하는 기본 account-pool의 계정인 경우 KRN을 생략할 수 있습니다.
기본 account-pool의 계정이 아닌 경우 헤더에 KRN 정보(x-krn: krn:{chain-id}:wallet:{account-id}:account-pool:{pool name})를 포함해야합니다.

Request
Security:
basic
path Parameters
contract-address-or-alias
required
string

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

token-id
required
string

토큰 ID

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

보내는 사람 주소입니다.

owner
required
string

현재 소유자 주소입니다.

to
required
string

받는 사람 주소입니다.

Responses
200

요청이 성공적입니다.

400

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

401

자격증명 정보가 유효하지 않습니다.

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

요청이 성공적입니다.

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