Token History

ํ† ํฐ์€ ๋ธ”๋ก์ฒด์ธ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ๋งŒ๋“ค ๋•Œ ์ž์ฃผ ์“ฐ์ด๋Š” ์š”์†Œ์ž…๋‹ˆ๋‹ค. ์ด๋ฏธ ์—ฌ๋Ÿฌ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์—์„œ ํ† ํฐ์€ ๊ตํ™˜์˜ ๋งค๊ฐœ ํ˜น์€ ๊ณ„์•ฝ์˜ ์ฆ๊ฑฐ๋กœ์จ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค. ์˜ˆ๋ฅผ ๋“ค์–ด, ๋ธ”๋ก์ฒด์ธ ์ƒ์—์„œ ํ•ญ๊ณต ๋งˆ์ผ๋ฆฌ์ง€๋ฅผ ์ทจ๋“ํ•˜๊ณ  ์‚ฌ์šฉํ•˜๊ฑฐ๋‚˜ ์˜ˆ์ˆ  ์ž‘ํ’ˆ ์†Œ์œ ๊ถŒ์„ ํ† ํฐ์œผ๋กœ ๋ฐœํ–‰ํ•ด ๊ฑฐ๋ž˜ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

ํ† ํฐ์œผ๋กœ ๊ตฌํ˜„๋œ ํฌ์ธํŠธ, ๋งˆ์ผ๋ฆฌ์ง€, ์ธ์ฆ์„œ, ์ƒํ’ˆ๊ถŒ ๋ฐ ๊ตํ™˜๊ถŒ ๋“ฑ์€ ๋ธ”๋ก์ฒด์ธ์˜ ํˆฌ๋ช…์„ฑ๊ณผ ๋ถˆ๊ฐ€์—ญ์„ฑ์„ ๋ฐ”ํƒ•์œผ๋กœ ์œ„/๋ณ€์กฐ๋˜์ง€ ์•Š์•˜์Œ์ด ๋ณด์žฅ๋ฉ๋‹ˆ๋‹ค. ํ† ํฐ์€ ๊ธฐ์กด์˜ ์–ด๋Š ํŠน์ • ์ฃผ์ฒด๊ฐ€ ๊ธฐ๋กํ•˜๊ณ  ์ œ์–ดํ•˜๋Š” ์ค‘์•™ํ˜• ์‹œ์Šคํ…œ์œผ๋กœ ๊ตฌํ˜„๋œ ๊ฒƒ๋“ค๊ณผ ๊ทผ๋ณธ์ ์œผ๋กœ ๋‹ค๋ฅด๋ฉฐ ๋ฐœํ–‰, ์‚ฌ์šฉ, ๊ตํ™˜/์œ ํ†ต ์ธก๋ฉด์—์„œ ๊ธฐ์กด ๋น„์ฆˆ๋‹ˆ์Šค์˜ ํ•œ๊ณ„๋ฅผ ๊ทน๋ณตํ•˜๊ณ  ์ƒˆ๋กœ์šด ์‚ฌ์—… ๊ธฐํšŒ๋ฅผ ๊ฐ€์ ธ๋‹ค์ค๋‹ˆ๋‹ค.

ํ•˜์ง€๋งŒ ํ† ํฐ์„ ํšจ๊ณผ์ ์œผ๋กœ ์‚ฌ์šฉํ•˜๋Š” ๊ฒƒ์€ ์ƒ๊ฐ๋ณด๋‹ค ์–ด๋ ค์šด ์ผ์ž…๋‹ˆ๋‹ค. ํ† ํฐ์ด ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์— ๊ฐ€์น˜๋ฅผ ๋ถ€์—ฌํ•˜๋ ค๋ฉด ํ† ํฐ์ด ์–ธ์ œ ๋ˆ„๊ตฌ์—๊ฒŒ ์ „๋‹ฌ๋˜์—ˆ๋Š”์ง€ ์ถ”์ ํ•  ์ˆ˜ ์žˆ์–ด์•ผ ํ•˜๊ธฐ ๋•Œ๋ฌธ์ž…๋‹ˆ๋‹ค. ๋ชจ๋“  ๊ธฐ๋ก์€ ๋ธ”๋ก์ฒด์ธ์— ์•ˆ์ „ํ•˜๊ฒŒ ๋ณด๊ด€๋˜์–ด ์žˆ์ง€๋งŒ, ๊ทธ ๊ธฐ๋ก์„ ๊บผ๋‚ด์–ด ๋‚ด๊ฐ€ ์›ํ•˜๋Š” ํ˜•ํƒœ๋กœ ๋ณผ ์ˆ˜ ์žˆ๋‹ค๋Š” ๊ฒƒ์€ ๋˜ ๋‹ค๋ฅธ ์ด์•ผ๊ธฐ์ž…๋‹ˆ๋‹ค. Token History API๋Š” ๋ธ”๋ก์ฒด์ธ ๋ฐ์ดํ„ฐ๋ฅผ ๊ฐ€๊ณตํ•˜์—ฌ ๊ณ„์ •(Account)์„ ๊ธฐ์ค€์œผ๋กœ, ํ˜น์€ ํ† ํฐ์„ ๊ธฐ์ค€์œผ๋กœ ๊ฑฐ๋ž˜๋‚ด์—ญ์„ ํ™•์ธํ•  ์ˆ˜ ์žˆ๋Š” API๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.

Token History API

Token History API๋Š” ํ† ํฐ ์ „์†ก ๊ธฐ๋ก์„ ์ถ”์ ํ•˜๋Š” ๋„๊ตฌ๊ฐ€ ํ•„์š”ํ•˜๋‹ค๋Š” ์ƒ๊ฐ์—์„œ ์‹œ์ž‘๋˜์—ˆ์Šต๋‹ˆ๋‹ค. Token History API๋Š” KLAY, FT (KIP-7, Labeled ERC-20), NFT (KIP-17, Labeled ERC-721) ํ† ํฐ์˜ ์ •๋ณด์™€ ๊ธฐ๋ก์„ ์กฐํšŒํ•˜๋Š” ๊ธฐ๋Šฅ์„ ์ œ๊ณตํ•˜์—ฌ ์‚ฌ์šฉ์ž๋“ค์ด ํŠน์ • EOA์˜ KLAY ์ „์†ก ๊ธฐ๋ก์„ ํ™•์ธํ•˜๊ฑฐ๋‚˜ EOA๊ฐ€ ์†Œ์œ ํ•˜๊ณ  ์žˆ๋Š” NFT์˜ ์กฐํšŒ ๋“ฑ์„ ์ˆ˜ํ–‰ํ•  ์ˆ˜ ์žˆ๊ฒŒ ํ•ฉ๋‹ˆ๋‹ค.

Purpose

Token History API๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด ๋ธ”๋ก์ฒด์ธ ๊ฐœ๋ฐœ์— ํˆฌ์ž…๋˜๋Š” ์‹œ๊ฐ„๊ณผ ๋น„์šฉ์„ ํฌ๊ฒŒ ์ ˆ๊ฐํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ง€๊ธˆ ์ด ์ˆœ๊ฐ„์—๋„ ๋งŽ์€ ๋ธ”๋ก์ฒด์ธ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์ด ํ† ํฐ ์ „์†ก ๋‚ด์—ญ์„ ๊ธฐ๋กํ•˜๊ณ  ๊ด€๋ฆฌํ•˜๋Š” ๋ฐ ์†Œ์ค‘ํ•œ ์ž์›์„ ์Ÿ์•„๋ถ“๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค.

๋งŒ์•ฝ ์–ด๋–ค EOA๊ฐ€ KLAY๋ฅผ ๋ณด๋‚ด๊ณ  ๋ฐ›์€ ๊ธฐ๋ก ์ค‘ ์ตœ๊ทผ N๊ฐœ๋ฅผ ์กฐํšŒํ•˜๊ณ  ์‹ถ๋‹ค๋ฉด ์กฐํšŒํ•˜๊ณ  ์‹ถ๋‹ค๋ฉด ํฌ๊ฒŒ ๋‹ค์Œ 3๊ฐ€์ง€ ๋ฐฉ๋ฒ•์ด ์žˆ์„ ๊ฒƒ์ž…๋‹ˆ๋‹ค:

Solution 1. ๋ธ”๋ก๋งˆ๋‹ค ์—ฐ๊ด€ ํŠธ๋žœ์žญ์…˜์„ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— ์ €์žฅ, ์š”์ฒญ๋งˆ๋‹ค ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ๊ธฐ๋ก์„ ๋ฐ˜ํ™˜ (๋‚ฎ์€ ๋ณต์žก๋„, ๋‚ฎ์€ ์ธํ”„๋ผ ๋น„์šฉ, ๋น„ํšจ์œจ, ๋‚ฎ์€ ์œ ์—ฐ์„ฑ)

์กฐํšŒํ•˜๊ณ  ์‹ถ์€ EOA๋ฅผ ๋ฏธ๋ฆฌ ์•Œ ์ˆ˜ ์žˆ๋‹ค๋ฉด ์ด ๋ฐฉ๋ฒ•์ด ๊ฐ€์žฅ ์ ํ•ฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ด ๋ฐฉ๋ฒ•์€ ์‰ฝ๊ฒŒ ๊ตฌํ˜„ํ•  ์ˆ˜ ์žˆ์œผ๋ฉฐ ๋ฐ์ดํ„ฐ ๊ธฐ๋ก์— ํ•„์š”ํ•œ ์ธํ”„๋ผ ๋น„์šฉ๋„ ์ ์Šต๋‹ˆ๋‹ค. ํ•˜์ง€๋งŒ ๊ฑฐ๋ž˜ ๋‚ด์—ญ์„ ์ถ”์ ํ•˜๊ณ  ์‹ถ์€ EOA๋ฅผ ๋ฏธ๋ฆฌ ์•Œ์•„์•ผ ํ•˜๋ฏ€๋กœ ์ด EOA๊ฐ€ API์— ๋“ฑ๋ก๋œ ์‹œ์  ์ดํ›„์˜ ํŠธ๋žœ์žญ์…˜๋งŒ ์กฐํšŒํ•œ๋‹ค๋Š” ๋‹จ์ ์ด ์žˆ์Šต๋‹ˆ๋‹ค.

Solution 2. ๋ชจ๋“  ๋ธ”๋ก์„ ๋กœ์ปฌ์— ์ €์žฅ, ์š”์ฒญ๋งˆ๋‹ค ๋ธ”๋ก์„ ์ˆœํ™˜ํ•˜๋ฉฐ ์—ฐ๊ด€ ํŠธ๋žœ์žญ์…˜์„ ๋ฐ˜ํ™˜ (๋‚ฎ์€ ๋ณต์žก๋„, ๋†’์€ ์ธํ”„๋ผ ๋น„์šฉ, ๋น„๊ต์  ํšจ์œจ, ๋น„๊ต์  ์œ ์—ฐ)

Solution 1๊ณผ๋Š” ๋‹ฌ๋ฆฌ Solution 2๋Š” ๋ชจ๋“  ๋ธ”๋ก์„ ์ €์žฅํ•˜๊ธฐ ๋•Œ๋ฌธ์— ๋ชจ๋“  EOA์˜ KLAY ์ „์†ก ๋‚ด์—ญ์„ ์กฐํšŒํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๊ตฌํ˜„์€ ์‰ฌ์šด ํŽธ์ด๋ฉฐ ์บ์‹ฑ์„ ์‚ฌ์šฉํ•˜๋ฉด ํŠธ๋žœ์žญ์…˜ ์กฐํšŒ ์š”์ฒญ์— ๋น ๋ฅด๊ฒŒ ๋Œ€์‘ํ•  ์ˆ˜ ์žˆ์–ด ๋น„๊ต์  ํšจ์œจ์ ์ž…๋‹ˆ๋‹ค. ํ•˜์ง€๋งŒ ์ด ๋ฐฉ๋ฒ•์€ ๋ธ”๋ก ๋‹จ์œ„๋กœ ์ •๋ณด๋ฅผ ์ €์žฅํ•˜๋ฏ€๋กœ ์•Œ๊ณ  ์‹ถ์€ KLAY ์ „์†ก ๋‚ด์—ญ ์™ธ ๋‹ค๋ฅธ ์ •๋ณด๋“ค๊นŒ์ง€ ์ €์žฅํ•ฉ๋‹ˆ๋‹ค. ์ด๋Ÿฌํ•œ ์ €์žฅ ๋ฐฉ์‹์€ ๋น„ํšจ์œจ์ ์ธ ์ธํ”„๋ผ ์‚ฌ์šฉ์œผ๋กœ ์ด์–ด์ ธ ๋ถˆํ•„์š”ํ•œ ๋น„์šฉ์ด ๋ฐœ์ƒํ•ฉ๋‹ˆ๋‹ค.

Solution 3. ๋ชจ๋“  ํŠธ๋žœ์žญ์…˜์„ EOA ๊ธฐ์ค€์œผ๋กœ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— ์ €์žฅ, ์š”์ฒญ๋งˆ๋‹ค ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ๊ธฐ๋ก์„ ๋ฐ˜ํ™˜ (๋†’์€ ๋ณต์žก๋„, ๋†’์€ ์ธํ”„๋ผ ๋น„์šฉ, ๋†’์€ ํšจ์œจ, ๋†’์€ ์œ ์—ฐ์„ฑ)

Solution 3์˜ ๊ฒฝ์šฐ ๋ชจ๋“  EOA์˜ ์ „์†ก ๋‚ด์—ญ์„ ์กฐํšŒ ๊ฐ€๋Šฅํ•˜๊ณ  ํ•„์š”ํ•œ ์ •๋ณด๋งŒ์„ ์ €์žฅ, ์ œ๊ณตํ•˜๋ฉฐ ์ €์žฅ๋œ ์ •๋ณด๋ฅผ ์‚ฌ์šฉํ•ด ๋‹ค๋ฅธ ์š”์ฒญ๋„ ์ฒ˜๋ฆฌํ•  ์ˆ˜ ์žˆ์œผ๋ฏ€๋กœ ๊ฐ€์žฅ ํšจ๊ณผ์ ์ž…๋‹ˆ๋‹ค. ํ•˜์ง€๋งŒ ์‹œ์Šคํ…œ ๋ณต์žก๋„๊ฐ€ ๋‹ค๋ฅธ ๋ฐฉ๋ฒ•๋“ค์— ๋น„ํ•ด ๋†’๊ณ , Solution 2๋งŒํผ ๋น„์šฉ์ด ๋ฐœ์ƒํ•ฉ๋‹ˆ๋‹ค.

Token History API Solution

Token History API๋Š” Solution 3์„ ๊ตฌํ˜„ํ•œ ์‹œ์Šคํ…œ์ž…๋‹ˆ๋‹ค. Soultion 3์€ ์œ„ 3๊ฐ€์ง€ ๋ฐฉ๋ฒ• ์ค‘ ๊ฐ€์žฅ ๋งŒ๋“ค๊ธฐ ์–ด๋ ต์ง€๋งŒ (1) ํŠธ๋žœ์žญ์…˜ ์กฐํšŒ ์š”์ฒญ์„ ์ฒ˜๋ฆฌํ•˜๊ณ  (2) ์ˆ˜์ง‘๋œ ๋ฐ์ดํ„ฐ๋ฅผ ๋ฐ”ํƒ•์œผ๋กœ FT ๊ฑฐ๋ž˜๋‚ด์—ญ ์กฐํšŒ, NFT ์†Œ์œ ๊ถŒ ์กฐํšŒ ๋“ฑ ํŠธ๋žœ์žญ์…˜ ๊ธฐ๋ก์„ ๋ฐ”ํƒ•์œผ๋กœ ๋‹ค์–‘ํ•œ ๊ธฐ๋Šฅ์„ ๊ตฌํ˜„ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. Token History API๋Š” ์ด๋ฅผ ๋ฐ”ํƒ•์œผ๋กœ ๋ธ”๋ก์ฒด์ธ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜๋“ค์ด ์‹œ์žฅ์— ์‰ฝ๊ฒŒ ์ง„์ž…ํ•  ์ˆ˜ ์žˆ๋Š” ๊ฐœ๋ฐœํ™˜๊ฒฝ์„ ๋งŒ๋“ค ๊ฒƒ์ž…๋‹ˆ๋‹ค.

๊ฐ„๋‹จํ•œ REST ์š”์ฒญ์„ Token History API์— ์ „๋‹ฌํ•˜๋ฉด KLAY/FT ์ „์†ก๋‚ด์—ญ์„ ์กฐํšŒํ•˜๊ณ  NFT ์†Œ์œ ๊ถŒ์„ ์กฐํšŒํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๋‹ค์Œ ํŽ˜์ด์ง€์—์„œ Token History API ์‚ฌ์šฉ ๋ฐฉ๋ฒ•์„ ์†Œ๊ฐœํ•ฉ๋‹ˆ๋‹ค.

Token History API์—์„œ ์กฐํšŒํ•  ์ˆ˜ ์žˆ๋Š” FT์™€ NFT๋Š” ๊ฐ๊ฐ KIP-7, KIP-17 ๊ธฐ์ค€์„ ๋งŒ์กฑํ•˜๋Š” ์ปจํŠธ๋ž™ํŠธ๋กœ ์‚ฌ์ „์— Klaytn์— ๋ฐฐํฌ๋˜์–ด ์žˆ์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ERC-20, ERC-721๋กœ ๊ตฌํ˜„๋œ FT์™€ NFT๋Š” ๋ผ๋ฒจ๋ง(Labeling) ์ด๋ผ๋Š” ๋“ฑ๋ก๊ณผ์ •์„ ํ†ตํ•ด Token History API์— ์กฐํšŒ ๊ฐ€๋Šฅํ•œ ์ปจํŠธ๋ž™ํŠธ๋กœ ์ถ”๊ฐ€๋˜์–ด์•ผ ์กฐํšŒ ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค. ๋ผ๋ฒจ๋ง์— ๊ด€ํ•œ ์ž์„ธํ•œ ๋‚ด์šฉ์€ ์ถ”ํ›„ ์•ˆ๋‚ดํ•  ๊ณ„ํš์ž…๋‹ˆ๋‹ค.