컨트랙트 배포 및 토큰 발행/전송

이 페이지는 KIP-17 API를 사용하여 KIP-17 컨트랙트를 배포하고 KIP-17 토큰을 발급 및 전송하는 방법을 예제로 설명합니다.

KIP-17은 Klaytn에서 정의한 NFT(Non-Fungible Token) 컨트랙트 표준입니다. KAS는 KIP-17 API를 통해 KIP-17 토큰을 쉽고 편리하게 생성/관리할 수 있는 API를 제공합니다. KIP-17 API의 대표적인 기능은 KIP-17 컨트랙트의 배포, 토큰의 발급, 소각, 전송 등입니다.

전체 KIP-17 API에 대한 자세한 사양은 KAS KIP-17 API Reference를 통해 확인하실 수 있습니다.

KIP-17 컨트랙트 배포

KIP-17 API는 KIP-17 표준을 따르는 NFT 컨트랙트를 배포하고 제어합니다.

KIP-17 컨트랙트 표준의 함수들에 관한 더 자세한 정보는 KIP-17을 확인하세요.

KIP-17 컨트랙트를 배포하는 방법은 2가지가 있습니다. KAS Console에서 배포하거나 API를 호출합니다.

KAS Console에서 컨트랙트 배포하기

컨트랙트를 배포하려면 트랜잭션 수수료 이상의 잔고를 보유해야 합니다. 생성한 계정에 KLAY 충전하기를 참고하세요.

KIP-17 API에서는 트랜잭션 전송 시 4가지 수수료 지불 방법을 지원합니다. 튜토리얼에서는 무료 플랜에서 Fee-payer Pool을 이용하여 컨트랙트를 배포하는 방법을 알아보겠습니다.

1. KAS Console에 접속하여 로그인합니다.

2. KAS Console > Service > KIP-17 > Contracts 메뉴를 선택합니다. 이미 생성된 Contracts 목록을 확인할 수 있습니다.

Contracts

3. [Contract 생성]을 클릭합니다. Contract 생성에 필요한 필수 정보(Contract Alias, Token Symbol, Token Name)를 입력합니다.

Contract 생성

4. Wallet 서비스의 Fee-payer Pool을 사용하시겠습니까? 질문에 Y를 선택한 후 Fee-payer Pool KRN과 Fee-payer Account를 입력합니다.

Fee-payer Pool

5. Global Fee-payer의 대납 기능을 사용하시겠습니까? 질문에 N을 선택한 후 [배포]를 클릭합니다. 배포가 완료되면 Contracts 목록 맨 위에서 가장 최근에 생성한 컨트랙트를 확인할 수 있습니다.

Contract 생성

Global Fee Payer 서비스는 유료 플랜에서만 이용할 수 있습니다. 유료 플랜으로 컨트랙트를 배포하려면 Fee-payer Pool을 사용하시겠습니까? 질문에 N을 선택하세요. Global Fee-payer의 대납 기능을 사용하시겠습니까? 질문에 Y를 선택하면 됩니다.

터미널에서 API 요청하기

KIP-17 컨트랙트의 배포는 다음과 같은 curl 명령어를 실행하여 수행할 수 있습니다.

curl

curl --location --request POST "https://kip17-api.klaytnapi.com/v2/contract" \
  --header "x-chain-id: {chain-id}" \
  -u {access-key-id}:{secret-access-key} \
  --data-raw '{
		"alias": "test",
		"symbol": "TEST",
		"name": "kas logo with image only",
		"owner": "0x5b23bba0F4ab751a9ee603e0393ebc63ecBe8a28",
		"options": {
		"enableGlobalFeePayer": false,
		"userFeePayer": {
    			"krn": "krn:1001:wallet:5366c4a0-84cc-420f-80fe-9efc85b50996:feepayer-pool:Test",
    			"address": "0xee9d6ACAD763475685Ee182B3b4cC67bb51583dF"
	        		}
	    		}
  		}'

javascript

const result = await caver.kas.kip17.deploy(
  "My First KIP-17",
  "MFK",
  "my-first-kip17"
);

java

String name = "My First KIP-17";
String symbol = "MFK";
String alias = "my-first-kip17";
Kip17TransactionStatusResponse res = caver.kas.kip17.deploy(name, symbol, alias);

curl 명령어를 부분으로 나누어 하나씩 살펴보겠습니다. 컨트랙트 배포 API는 POST /v2/contract로 실행할 수 있습니다. KIP-17 API가 https://kip17-api.klaytnapi.com에서 서비스 되고 있으니 curl 요청의 URL을 https://kip17-api.klaytnapi.com/v2/contract로, 요청 유형은 POST (—-request POST)로 설정합니다.

컨트랙트 배포 API는 POST 요청을 받아들이며 다음과 같은 JSON 데이터를 요구합니다.

curl

{
"alias": "test",
"symbol": "TEST",
"name": "kas logo with image only",
"owner": "0x5b23bba0F4ab751a9ee603e0393ebc63ecBe8a28",
"options": {
"enableGlobalFeePayer": false,
"userFeePayer": {
    "krn": "krn:1001:wallet:5366c4a0-84cc-420f-80fe-9efc85b50996:feepayer-pool:Test",
    "address": "0xee9d6ACAD763475685Ee182B3b4cC67bb51583dF"
	              }
	        }
}

javascript

// caver-js-ext-kas로 KIP-17 컨트랙트를 배포하는 경우, API request의 body에 필요한 데이터를 함수의 파라미터로 전송합니다.
// caver.kas.kip17.deploy(name, symbol, alias [, callback])
const feePayerOptions = {
        true,
        userFeePayer: {
            krn: userFeePayer.krn,
            address: userFeePayer.address,
        },
    }
const ret = await caver.kas.kip17.deploy('Alice', 'ALI', alias, feePayerOptions)

java

String name = "testKIP-17";
String symbol = "TKIP17";
String alias = "kip-17test";

Kip17FeePayerOptions options = new Kip17FeePayerOptions();
options.setEnableGlobalFeePayer(true);

Kip17TransactionStatusResponse res = caver.kas.kip17.deploy(name, symbol, alias, options);

각각의 필드에 대한 설명은 다음과 같습니다.

• Alias (alias): 컨트랙트의 별명입니다. 이후 API들에서 컨트랙트 주소 대신 사용할 수 있습니다. 허용되는 문자는 알파벳 소문자, 숫자, 하이픈이며 별명의 첫 문자는 알파벳 소문자로 제한됩니다.

• Symbol(symbol): 컨트랙트의 심볼입니다. KIP-17 표준에서 요구하는 symbol로 사용됩니다. 일반적으로 알파벳 대문자 3~4개로 구성되나 이를 제약하지는 않습니다.

• Name (name): 컨트랙트의 이름입니다. KIP-17 표준에서 요구하는 name으로 사용됩니다. 허용되는 문자는 알파벳, 숫자, 하이픈입니다.

• Owner (owner): 컨트랙트를 소유할 계정 주소입니다. 입력하지 않으면 이 컨트랙트를 발행하는 계정이 소유자가 됩니다.

• Option (options):

  • EnableGlobalFeePayer (enableGlobalFeePayer): KAS 글로벌 대납 사용 여부를 나타냅니다. 튜토리얼에서는 무료 플랜을 이용할 때 예시이기 때문에 false입니다.

  • UserFeePayer (userFeePayer):

    • KRN (krn): 수수료 대납 계정의 FeePayer-Pool KRN 값입니다.

    • Address (address): 수수료 대납 Klaytn 계정 주소입니다.

• 필수 헤더

  모든 KIP-17 API는 x-chain-id 헤더값을 요구합니다. 허용되는 값은 1001 (Baobab), 8217 (Cypress) 입니다.

• 인증

  KAS가 제공하는 모든 API는 계정 인증 정보, 즉 access-key-id와 secret-access-key를 제출해야합니다. 인증 정보의 생성 및 획득은 다음 링크를 참조해주세요.

터미널에서 API 응답 확인하기

컨트랙트 배포 curl 명령어를 실행하면 다음과 같은 결과를 받게 됩니다.

curl

{
    "options": {
        "enableGlobalFeePayer": false,
        "userFeePayer": {
            "address": "0xee9d6ACAD763475685Ee182B3b4cC67bb51583dF",
            "krn": "krn:1001:wallet:5366c4a0-84cc-420f-80fe-9efc85b50996:feepayer-pool:Test"
        		}
    		},
    "owner": "0x5b23bba0F4ab751a9ee603e0393ebc63ecBe8a28",
    "status": "Submitted",
    "transactionHash": "0x4183a6bc842bb492a989e15b274e385773a2b15b5fe5a7e3a95c0887aabe609d"
}

javascript

{
	status: 'Submitted',
	transactionHash: '0x...',
}

java

class Kip17TransactionStatusResponse {
    status: Submitted
    transactionHash: 0x....
}

결과로 받게된 transactionHash는 klay_getTransactionReceipt과 같은 RPC 함수를 실행할 때 사용할 수 있습니다.

KIP-17 컨트랙트 목록 조회

KIP-17 컨트랙트 목록을 조회하는 방법은 2가지가 있습니다. KAS Console에서 조회하거나 API를 호출합니다.

KAS Console에서 컨트랙트 목록 조회하기

KIP-17 컨트랙트 배포 API를 호출하여 만든 컨트랙트 또한 KAS Console에서 확인할 수 있습니다.

1. KAS Console에 접속하여 로그인합니다.

2. KAS Console > Service > KIP-17 > Contracts 메뉴를 선택합니다. Contracts 목록 맨 위에 KIP-17 컨트랙트 배포 API를 호출하여 만든 컨트랙트가 새로 생긴 것을 확인할 수 있습니다.

새로 생성한 컨트랙트

3. 컨트랙트를 선택하여 Contract 상세정보로 이동합니다. 컨트랙트 배포 요청을 보낼 때 포함한 값이 반영된 걸 확인할 수 있습니다.

Contract 상세정보

터미널에서 API 호출하기

KIP-17 API의 컨트랙트 목록 조회 API (GET /v2/contract)를 사용하여 배포한 컨트랙트들을 조회할 수 있습니다. 다음 curl 명령어를 실행하여 컨트랙트 목록을 조회합니다.

curl

curl --location --request GET 'https://kip17-api.klaytnapi.com/v2/contract' \
  --header "x-chain-id: {chain-id}" \
  -u {access-key-id}:{secret-access-key}

javascript

const result = await caver.kas.kip17.getContractList();

java

Kip17ContractListResponse response = caver.kas.kip17.getContractList();
System.out.println(response);

터미널에서 API 응답 확인하기

배포한 컨트랙트가 올바르게 조회되었다면 다음과 같은 응답을 받을 수 있습니다.

curl

{
	"cursor": "",
	"items": [
        {
            "address": "0x5ca45b8af596639db92d65b28366df4e7f3bbc18",
            "alias": "test",
            "chainId": "1001",
            "name": "kas logo with image only",
            "options": {
                "enableGlobalFeePayer": false,
                "userFeePayer": {
                    "address": "0xee9d6ACAD763475685Ee182B3b4cC67bb51583dF",
                    "krn": "krn:1001:wallet:5366c4a0-84cc-420f-80fe-9efc85b50996:feepayer-pool:Test"
                }
            },
            "symbol": "TEST"
        }
}

javascript

{
	cursor: '',
	items: [
		{
			address: '0x...',
			alias: 'my-first-kip17',
			name: 'My First KIP-17',
			symbol: 'MFK',
		},
	],
}

java

class Kip17ContractListResponse {
    cursor: "..."
    items: [class Kip17ContractListResponseItem {
        address: 0x...
        alias: my-first-kip17
        name: My First KIP-17
        symbol: MFK
    },
	{...}
	]
}

토큰 발행

KIP-17 컨트랙트를 성공적으로 배포했다면 이제 토큰을 발행할 수 있습니다.

KAS Console에서 토큰 발행하기

1. KAS Console에 접속하여 로그인합니다.

2. KAS Console > Service > KIP-17 > Contracts 메뉴를 선택합니다. 이미 생성된 contract 목록을 확인할 수 있습니다.

contract 목록

3. 컨트랙트 목록에서 토큰을 발행하고 싶은 컨트랙트를 선택합니다. Contract 상세정보로 이동한 걸 확인할 수 있습니다.

Contract 상세정보

4. Token 목록 오른쪽의 [Token 발행]을 클릭합니다.

Token 발행

5. 필수값인 Token ID와 Token 소유자의 주소를 입력합니다. 만약, 메타데이터를 저장한 별도의 Token URI가 있다면 Y를 선택한 후 Token URI를 입력합니다.

Token URI 포함

없다면 N을 선택한 후 토큰에 관한 메타데이터 정보인 Token Name과 Description을 입력합니다. Image에서 토큰으로 발행할 파일을 선택합니다. N을 선택한 경우 Contract Alias와 매칭되는 메타데이터 URI가 자동으로 생성됩니다.

Token URI 포함하지 않음

6. Token 발행에 필요한 정보를 모두 입력한 후 오른쪽 아래에 있는 [발행]을 클릭합니다. Contract 상세정보의 Token 목록에서 발행된 토큰을 확인할 수 있습니다.

Token 목록

터미널에서 API 요청하기

토큰을 발행하는 API는 POST /v2/contract/{alias-or-address}/token 입니다. 여기서 {alias-or-address}는 토큰을 발행하려는 컨트랙트의 별명(alias) 또는 주소(address)로 토큰을 배포할 때 제출하신 alias나 토큰 배포 후 컨트랙트 목록 조회 API에서 확인하신 주소를 사용하시면 됩니다.

다음은 토큰 발행 API를 호출하는 curl 명령어입니다.

curl

curl --location --request POST 'https://kip17-api.klaytnapi.com/v2/contract/my-first-kip17/token' \
  --header "x-chain-id: {chain-id}" \
  -u {access-key-id}:{secret-access-key} \
	--data-raw '{
	  "to": "0x...",
	  "id": "0x1",
	  "uri": "https://link.to.your/token/metadata-0x1.json"
	}'

javascript

const result = await caver.kas.kip17.mint(
  "my-first-kip17",
  "0x...",
  "0x1",
  "https://link.to.your/token/metadata-0x1.json"
);

java

String contractAlias = "my-first-kip17";
String to = "0x{toAddress}";
String id = "0x1";
String uri = "https://link.to.your/token/metadata-0x1.json";

Kip17TransactionStatusResponse response = caver.kas.kip17.mint(contractAlias, to, id, uri);
System.out.println(response);

필수 헤더, 인증 정보 등은 컨트랙트 배포와 동일하며 location, request와 같은 정보는 토큰 발행 API (POST /v2/contract/{alias-or-address}/token)에 맞추어 입력합니다.

토큰 발행 API는 다음과 같은 JSON 데이터를 요구합니다.

curl

{
  "to": "0x...",
  "id": "0x1",
  "uri": "https://link.to.your/token/metadata-0x1.json"
}

javascript

// caver-js-ext-kas로 KIP-17 토큰을 발행하는 경우, API request의 body에 필요한 데이터를 함수의 파라미터로 전송합니다.
// caver.kas.kip17.mint(addressOrAlias, to, tokenId, tokenURI [, callback])
const result = await caver.kas.kip17.mint(
  "my-first-kip17",
  "0x...",
  "0x1",
  "https://link.to.your/token/metadata-0x1.json"
);

java

// caver-java-ext-kas로 KIP-17 토큰을 발행하는 경우, API request의 body에 필요한 데이터를 함수의 파라미터로 전송합니다.
// caver.kas.kip17.mint((addressOrAlias, to, tokenId, tokenURI);
String contractAlias = "my-first-kip17";
String to = "0x{toAddress}";
String id = "0x1"
String uri = "https://link.to.your/token/metadata-0x1.json";

Kip17TransactionStatusResponse response = caver.kas.kip17.mint(contractAlias, to, id, uri);
System.out.println(response);

• Recipient (to): 토큰을 받는 사람의 Klaytn 계정 주소입니다. 토큰 발행 API는 지정된 주소로 새로운 토큰을 발행합니다.

• Token ID (id): 토큰의 고유번호입니다. 16진수로 표현되며 이미 발행되어있는 토큰의 고유번호는 사용할 수 없습니다. 단, 소각된 토큰의 고유번호는 재사용할 수 있습니다.

• Token URI (uri): 토큰 정보를 담은 JSON 파일의 위치를 URI로 표현한 값입니다. 해당 토큰의 정보, 속성 등을 기록하여 사전에 URI로 표현될 수 있는 위치에 배포한 뒤 토큰 발행 시 URI를 포함합니다. URI링크가 존재하는 링크인지는 확인하지 않으니, 주의하여 입력 부탁드립니다.

Klaytn 계정의 주소는 16진수로 표현됩니다. 길이는 20-byte로 접두사인 "0x"를 포함하여 16진수 42자로 표현됩니다.

URI란 Uniform Resource Identifier의 약자로서, 인터넷에 있는 자원을 나타내는 유일한 주소를 의미합니다.

터미널에서 API 응답 확인하기

토큰 발행 curl을 수행하면 다음과 같은 응답을 받을 수 있습니다.

curl

{
  "transactionHash": "0x...",
  "status": "Submitted"
}

javascript

{
	status: 'Submitted',
	transactionHash: '0x...',
}

java

class Kip17TransactionStatusResponse {
    status: Submitted
    transactionHash: 0x....
}

컨트랙트 배포를 실행했을 때와 같은 형식의 응답이 오는 것을 확인할 수 있습니다.

토큰 발행 목록 조회

터미널에서 API 호출하기

토큰이 잘 발행되었는지 확인하려면 토큰 발행 목록 조회 API GET /v2/contract/{alias-or-address}/token을 사용하여 새로 발행한 토큰이 컨트랙트에 추가되었는지 확인합니다.

curl

curl --location --request GET 'https://kip17-api.klaytnapi.com/v2/contract/my-first-kip17/token' \
  --header "x-chain-id: {chain-id}" \
  -u {access-key-id}:{secret-access-key}

javascript

const result = await caver.kas.kip17.getTokenList("my-first-kip17");

java

Kip17TokenListResponse response = caver.kas.kip17.getTokenList("my-first-kip17");
System.out.println(response);

터미널에서 API 응답 확인하기

토큰이 성공적으로 발행되었다면 다음과 같은 응답을 받을 수 있습니다.

curl

{
	"items": [{
			"createdAt": <UNIX timestamp>,
			"owner": "0x...",
			"previousOwner": "0x0000000000000000000000000000000000000000",
			"tokenId": "0x1",
			"tokenUri": "https://link.to.your/token/metadata-0x1.json",
			"transactionHash": "0x...",
			"updatedAt": <UNIX timestamp>
		}],
	"cursor": ""
}

javascript

{
	cursor: '',
	items: [
		{
			createdAt: 1610524249,
			owner: '0x...',
			previousOwner: '0x0000000000000000000000000000000000000000',
			tokenId: '0x1',
			tokenUri: 'https://link.to.your/token/metadata-0x1.json',
			transactionHash: '0x...',
			updatedAt: 1610524249,
		},
	],
}

java

class Kip17TokenListResponse {
    cursor:
    items: [class Kip17TokenListResponseItem {
        createdAt: 1610524249
        owner: 0x...
        previousOwner: 0x0000000000000000000000000000000000000000
        tokenId: 0x1
        tokenUri: https://link.to.your/token/metadata-0x1.json
        transactionHash: 0x...
        updatedAt: 1610524249
    }, class Kip17TokenListResponseItem {
        ...
    }]
}

응답의 status를 눈여겨보셨다면 "Success"나 "Completed"가 아닌 "Submitted"인 것을 확인할 수 있습니다. Klaytn을 비롯한 모든 블록체인은 요청에 대한 응답이 즉시 돌아오지 않는 비동기 형태로 동작합니다. 따라서 요청이 성공했는지 바로 확인할 수 없습니다. 특히 토큰 발행과 같이 요청 값에 따라 요청이 실패할 수 있는 경우(e.g., 이미 존재하는 토큰 고유번호를 사용)가 존재하기 때문에 토큰 목록 조회 실행과 같은 명시적인 확인이 필요합니다.

토큰 전송

터미널에서 API 호출하기

KIP-17 토큰을 전송하는 API는 POST /v2/contract/{alias-or-address}/token/{id}입니다. {alias-or-address}, {id}는 전송하려는 컨트랙트, 토큰 정보를 사용합니다.

이 예제는 KAS 사용자가 KAS Wallet Account Pool에 사전에 등록한 계정이 존재하며 편의상 그 계정의 주소가 0xOWNER라고 가정합니다.

계정 생성과 관리는 여기를 참조해주시기 바랍니다.

KIP-17 API로 토큰을 전송하려면 토큰을 보내는 사람의 계정의 (cryptographic) key가 KAS Wallet Account Pool에 등록되어 있어야 합니다. 또한, Key가 Default Account Pool에 등록되어 있지 않을 경우 해당 Pool의 KRN을 x-krn 헤더에 직접 입력해야합니다.

예제에서는 편의상 0xOWNER라고 표기했으나 실제 주소는 Klaytn 계정 주소로 올바르게 표현되어야 합니다.

다음 curl 명령어는 0xOWNER가 소유한 my-first-kip17 컨트랙트의 0x321 토큰을 0xRECIPIENT에게 전송합니다.

curl

curl --location --request POST 'https://kip17-api.klaytnapi.com/v2/contract/my-first-kip17/token/0x321' \
  --header "x-chain-id: {chain-id}" \
  -u {access-key-id}:{secret-access-key} \
	--data-raw '{
	  "sender": "0xOWNER",
	  "owner": "0xOWNER",
	  "to": "0xRECIPIENT"
	}'

javascript

// caver.kas.kip17.transfer(addressOrAlias, sender, owner, to, tokenId [, callback])
const result = await caver.kas.kip17.transfer(
  "my-first-kip17",
  "0xOWNER",
  "0xOWNER",
  "0xRECIPIENT",
  "0x321"
);

java

String contractAlias = "my-first-kip17";
String ownerAddress = "0x{OwnerAddress}";
String recipientAddress = "0x{RecipientAddress}";
String tokenId = "0x321";
Kip17TransactionStatusResponse response = caver.kas.kip17.transfer(contractAlias, ownerAddress, ownerAddress, recipientAddress, tokenId);
System.out.println(response);

토큰 전송에 필요한 JSON 데이터는 다음과 같습니다.

• Sender (sender): 토큰 전송 API를 실행하는 사람의 주소입니다.

• Owner (owner): 전송하려는 토큰을 소유한 사람의 주소입니다. Sender가 owner와 다를 경우 sender는 사전에 토큰 전송 승인을 받은 받은 주소여야 합니다. 토큰 전송 승인에 대한 자세한 API는 토큰 전송 승인에서 확인하실 수 있습니다.

• Recipient (to): 토큰을 받는 사람의 주소입니다. 블록체인 특성상 소유권이 넘어가면 되돌릴 수 없으니 주의하시기 바랍니다.

Sender, owner 정보가 올바르지 않을 경우 전송 요청은 실패합니다. Sender는 전송 승인을 받은 주소가 아닐 경우 owner와 동일해야 하며 owner는 반드시 전송하려는 토큰을 소유한 사람의 주소여야 합니다.

Sender, owner의 정보가 올바르지 않을 때에도 전송 요청 API는 응답을 반환합니다. KIP-17 API는 요청의 형태, 형식(syntax)이 올바른지에 대해서만 검증합니다. Sender가 사전에 승인을 받았는지, owner가 정말 토큰을 소유하고 있는지와 같은 내용(semantic)에 대해서는 검증하지 않습니다.

전송 요청이 올바르게 블록체인에 적용되었는지 확인하려면 KIP-17 API의 토큰 목록 조회 또는 토큰 정보 조회를 사용하거나 Node API를 통해 klay_getTransactionReceipt을 실행하여 결과를 확인하시기 바랍니다.

터미널에서 API 응답 확인하기

토큰 전송 API를 실행하면 다음과 같은 응답을 받습니다.

curl

{
  "transactionHash": "0x...",
  "status": "Submitted"
}

javascript

{
	status: 'Submitted',
	transactionHash: '0x...',
}

java

class Kip17TransactionStatusResponse {
    status: Submitted
    transactionHash: 0x....
}

토큰 전송이 성공했는지 확인하기 위해 토큰 목록 조회 API GET /v2/contract/{alias-or-address}/token을 사용하여 전송한 토큰의 정보가 올바르게 변경되었는지 확인할 수 있습니다.

curl

curl --location --request GET 'https://kip17-api.klaytnapi.com/v2/contract/my-first-kip17/token'
	--header "x-chain-id: {chain-id}" \
  -u {access-key-id}:{secret-access-key}

javascript

const result = await caver.kas.kip17.getTokenList("my-first-kip17");

java

Kip17TokenListResponse response = caver.kas.kip17.getTokenList("my-first-kip17");
System.out.println(response);

토큰 전송이 올바르게 수행되었을 경우 다음과 같이 전송한 토큰의 정보가 변경된 것을 확인할 수 있습니다. owner와 previousOwner를 확인하시기 바랍니다.

curl

{
	"items": [
		...,
		{
			"createdAt": <UNIX timestamp>,
			"owner": "0xRECIPIENT",
			"previousOwner": "0xOWNER",
			"tokenId": "0x321",
			"tokenUri": "https://link.to.your/token/metadata-0x1.json",
			"transactionHash": "0x...",
			"updatedAt": <UNIX timestamp>
		},
		...],
	"cursor": ""
}

javascript

{
	cursor: '',
	items: [
		...
		{
			createdAt: 1610524249,
			owner: '0xRECIPIENT',
			previousOwner: '0xOWNER',
			tokenId: '0x321',
			tokenUri: 'https://link.to.your/token/metadata-0x1.json',
			transactionHash: '0x...',
			updatedAt: 1610524249,
		},
		...
	],
}

java

class Kip17TokenListResponse {
    cursor:
    items: [class Kip17TokenListResponseItem {
        createdAt: 1610524249
        owner: 0x...
        previousOwner: 0x0000000000000000000000000000000000000000
        tokenId: 0x1
        tokenUri: https://link.to.your/token/metadata-0x1.json
        transactionHash: 0x...
        updatedAt: 1610524249
    }, class Kip17TokenListResponseItem {
        ...
    }]
}