curl
명령어를 실행하여 수행할 수 있습니다.curl
명령어를 부분으로 나누어 하나씩 살펴보겠습니다. 컨트랙트 배포 API는 POST /v1/contract
로 실행할 수 있습니다. KIP-7 API가 https://kip7-api.klaytnapi.com
에서 서비스되고 있으니 curl
요청의 URL을 https://kip7-api.klaytnapi.com/v1/contract
로, 요청 유형은 POST (—-request POST
)로 설정합니다.alias
): 컨트랙트의 별명입니다. 이후 여러 API에서 컨트랙트 주소를 대신해 사용 가능합니다. 허용되는 문자는 알파벳 소문자, 숫자, 하이픈이며 별명의 첫 문자는 알파벳 소문자로 제한됩니다.name
): 컨트랙트의 이름입니다. KIP-7 표준에서 요구하는 name
으로 사용됩니다.symbol
): 컨트랙트의 심볼입니다. KIP-7 표준에서 요구하는 symbol
로 사용됩니다. 일반적으로 알파벳 대문자 3~4개로 구성되나 이를 제약하지는 않습니다.decimals
): 토큰의 소수점 자리 수입니다. KIP-7 표준에서 요구하는 decimals
로 사용됩니다. 일반적으로 18자리를 사용합니다.initialSupply
): 컨트랙트의 초기 발행량입니다. KIP-7 표준에서 요구하는 totalSupply
로 사용됩니다.x-chain-id
헤더값을 요구합니다. 허용되는 값은 1001(Baobab), 8217(Cypress) 입니다.access-key-id
와 secret-access-key
를 제출해야 합니다. 인증 정보의 생성 및 획득은 다음 링크를 참조해주세요.curl
명령어를 실행하면 다음과 같은 결과를 받게 됩니다.GET /v1/contract
)를 사용하여 배포한 컨트랙트를 조회할 수 있습니다. 다음 curl
명령어를 실행하여 컨트랙트 목록을 조회합니다.POST /v1/contract/{contract-address-or-alias}/mint
입니다. 여기서 {contract-address-or-alias}
는 토큰을 발행하려는 컨트랙트의 별명(alias) 또는 주소(address)로, 토큰을 배포할 때 제출한 alias나 토큰 배포 후 컨트랙트 목록 조회 API에서 확인한 address 를 사용합니다.POST /v1/contract/{contract-address-or-alias}/mint
)에 맞추어 입력합니다.to
): 토큰을 받는 사람의 Klaytn 계정 주소입니다. 토큰 발행 API는 지정된 주소로 새로운 토큰을 발행합니다.amount
): 토큰을 발행할 수량입니다. 16진수로 표현되며 토큰 소수점(decimals
)을 포함한 값을 사용합니다. 위의 예제는 0.00000256(0x100 / 10 ^ 8) MFK 토큰을 생성합니다.curl
을 수행하면 다음과 같은 응답을 받습니다.GET /v1/contract/{contract-address-or-alias}/account/{owner}/balance
)를 사용하여 owner
주소의 잔액을 확인합니다. 다음 curl
명령어를 사용하여 my-first-kip7
컨트랙트의 0x72b03ca464609c82be1d490ecfce004e2d3c4cfc
계정 잔액을 조회할 수 있습니다.status
를 눈여겨 보셨다면 "Success"나 "Completed"가 아닌 "Submitted"인 것을 확인할 수 있습니다. Klaytn을 비롯한 모든 블록체인은 요청에 대한 응답이 즉시 돌아오지 않는 비동기 형태로 동작하기 때문에 요청이 성공했는지 바로 확인할 수 없습니다. 특히 토큰 발행과 같이 요청값에 따라 요청이 실패할 수 있는 경우(e.g., 잔액이 부족한 경우)가 존재하기 때문에 토큰 잔액 확인과 같은 명시적인 확인이 필요합니다.POST /v1/contract/{contract-address-or-alias}/transfer
입니다. {contract-address-or-alias}
는 전송하려는 컨트랙트를 사용합니다.0x72b03ca464609c82be1d490ecfce004e2d3c4cfc
)는 사전에 등록한 계정입니다.x-krn
헤더에 직접 입력해야 합니다.0x72b03ca464609c82be1d490ecfce004e2d3c4cfc
가 소유한 my-first-kip7
컨트랙트의 토큰을 0x4d3224314b704be8887551e8c9b9bbb9aa5c48b3
에게 전송하는 curl
명령어입니다.from
): 전송하려는 토큰을 소유한 사람의 주소입니다.to
): 토큰을 받는 사람의 주소입니다. 블록체인 특성상 토큰을 전송하면 되돌릴 수 없으니 주의하시기 바랍니다.amount
): 전송할 토큰 수량입니다. 16진수로 표현하며 토큰 소수점(decimals
)이 포함된 값을 사용합니다.GET /v1/contract/{contract-address-or-alias}/account/{owner}/balance
)를 사용합니다. 전송한 토큰 정보가 올바르게 변경되었다면 성공입니다.