token.iost
Token 컨트랙트는 토큰의 생성, 분배, 전송, 소각에 사용되며, 토큰을 일정 기간 동결할 수 있고 토큰의 전체 이름, 소수점 자릿수, 전송 속성 등의 설정도 지원합니다.
| contract_id | token.iost |
|---|
| language | native |
| version | 1.0.3 |
API
create(tokenSym, issuer, totalSupply, config)
토큰을 생성합니다.
| 파라미터 이름 | 타입 | 비고 |
|---|
| tokenSym | string | 토큰 심볼. 컨트랙트 내에서 유일해야 하며, 길이는 2~16자, 문자는 [a-z0-9_]만 사용 가능 |
| issuer | string | 토큰 발행 권한을 가진 발행자. 이 인터페이스 호출에는 해당 계정의 "token" 권한이 필요합니다. |
| totalSupply | number | 총 공급량 |
| config | json | 토큰 설정. 네 개의 키를 포함합니다. fullName —— string, 토큰의 전체 이름. canTransfer —— bool, 토큰의 전송 허용 여부. decimal —— number, 토큰의 소수점 자릿수. onlyIssuerCanTransfer —— bool, 토큰 발행자만 전송할 수 있는지 여부. |
issue(tokenSym, to, amount)
토큰을 발행합니다.
이 인터페이스 호출에는 발행자 계정의 "token" 권한이 필요합니다.
| 파라미터 이름 | 타입 | 비고 |
|---|
| tokenSym | string | 토큰 심볼 |
| to | string | 토큰을 수령하는 계정 |
| amount | string | 정수 또는 소수 모두 가능. 예: "100", "1.22" |
transfer(tokenSym, from, to, amount, memo)
토큰을 전송합니다.
| 파라미터 이름 | 타입 | 비고 |
|---|
| tokenSym | string | 토큰 심볼 |
| from | string | 토큰을 보내는 계정. 이 인터페이스 호출에는 해당 계정의 "transfer" 권한이 필요합니다. |
| to | string | 토큰을 수령하는 계정 |
| amount | string | 전송 토큰 수량 |
| memo | string | 추가 정보 |
transferFreeze(tokenSym, from, to, amount, ftime, memo)
토큰을 전송하고 동결합니다.
| 파라미터 이름 | 타입 | 비고 |
|---|
| tokenSym | string | 토큰 심볼 |
| from | string | 토큰을 보내는 계정. 이 인터페이스 호출에는 해당 계정의 "transfer" 권한이 필요합니다. |
| to | string | 토큰을 수령하는 계정 |
| amount | string | 전송 토큰 수량 |
| memo | string | 추가 정보 |
destroy(tokenSym, from, amount)
토큰을 소각합니다.
| 파라미터 이름 | 타입 | 비고 |
|---|
| tokenSym | string | 토큰 심볼 |
| from | string | 토큰을 소각하는 계정. 이 인터페이스 호출에는 해당 계정의 "transfer" 권한이 필요합니다. |
| amount | string | 소각할 토큰 수량 |
balanceOf(tokenSym, from)
토큰 잔액을 조회합니다.
| 파라미터 이름 | 타입 | 비고 |
|---|
| tokenSym | string | 토큰 심볼 |
| from | string | 조회 대상 계정명 |
| 반환값 | 타입 | 비고 |
|---|
| balance | string | 계정 잔액 |
supply(tokenSym)
유통 중인 토큰 수량(발행되었으나 아직 소각되지 않은 토큰 총량)을 조회합니다.
| 파라미터 이름 | 타입 | 비고 |
|---|
| tokenSym | string | 토큰 심볼 |
totalSupply(tokenSym)
토큰의 총 발행량을 조회합니다.
| 파라미터 이름 | 타입 | 비고 |
|---|
| tokenSym | string | 토큰 심볼 |
token721.iost (depreciated)
Token721 컨트랙트는 대체 불가능 토큰(NFT)의 생성, 분배, 전송, 소각에 사용됩니다.
| contract_id | token721.iost |
|---|
| language | native |
| version | 1.0.0 |
API
create(tokenSym, issuer, totalSupply)
토큰을 생성합니다.
| 파라미터 이름 | 타입 | 비고 |
|---|
| tokenSym | string | 토큰 심볼. 컨트랙트 내에서 유일해야 하며, 길이는 2~16자, 문자는 [a-z0-9_]만 사용 가능 |
| issuer | string | 토큰 발행 권한을 가진 발행자. 이 인터페이스 호출에는 해당 계정의 "token" 권한이 필요합니다. |
| totalSupply | number | 총 공급량 |
토큰을 발행합니다.
이 인터페이스 호출에는 발행자 계정의 "token" 권한이 필요합니다.
| 파라미터 이름 | 타입 | 비고 |
|---|
| tokenSym | string | 토큰 심볼 |
| to | string | 토큰을 수령하는 계정 |
| metaData | string | 토큰의 메타데이터 |
| 반환값 | 타입 | 비고 |
|---|
| tokenID | string | tokenID는 토큰의 식별자입니다. 동일한 토큰 종류 내에서 시스템이 매 발행마다 중복되지 않는 tokenID를 생성합니다. |
transfer(tokenSym, from, to, tokenID)
토큰을 전송합니다.
| 파라미터 이름 | 타입 | 비고 |
|---|
| tokenSym | string | 토큰 심볼 |
| from | string | 토큰을 보내는 계정. 이 인터페이스 호출에는 해당 계정의 "transfer" 권한이 필요합니다. |
| to | string | 토큰을 수령하는 계정 |
| tokenID | string | 토큰 ID |
balanceOf(tokenSym, from)
토큰 잔액을 조회합니다.
| 파라미터 이름 | 타입 | 비고 |
|---|
| tokenSym | string | 토큰 심볼 |
| from | string | 계정명 |
| 반환값 | 타입 | 비고 |
|---|
| balance | number | 계정 잔액 |
ownerOf(tokenSym, tokenID)
특정 토큰의 소유자를 조회합니다.
| 파라미터 이름 | 타입 | 비고 |
|---|
| tokenSym | string | 토큰 심볼 |
| tokenID | string | 토큰 ID |
| 반환값 | 타입 | 비고 |
|---|
| account | string | 소유자 계정명 |
tokenOfOwnerByIndex(tokenSym, owner, index)
지정 계정이 소유한 인덱스 토큰을 조회합니다.
| 파라미터 이름 | 타입 | 비고 |
|---|
| tokenSym | string | 토큰 심볼 |
| owner | string | 계정명 |
| index | number | 토큰 인덱스(정수) |
토큰의 메타데이터를 조회합니다.
| 파라미터 이름 | 타입 | 비고 |
|---|
| tokenSym | string | 토큰 심볼 |
| tokenID | string | 토큰 ID |