caver.klay.KIP7
caver.klay.KIP7
은 클레이튼 블록체인에서 KIP-7을 JavaScript 객체로 구현하는 스마트 컨트랙트를 쉽게 처리할 수 있도록 도와줍니다.
caver.klay.KIP7
은 caver.klay.Contract를 상속받아 KIP-7 토큰 컨트랙트를 구현합니다. caver.klay.KIP7
은 caver.klay.Contract
와 동일한 속성을 가지며, 추가 기능을 구현하기 위한 메서드가 추가되었습니다. 여기서는 caver.klay.KIP7
에 새롭게 추가된 바인딩 메서드만 소개합니다.
caver.klay.KIP7에 사용된 abi와 바이트코드는 openzeppelin의 예제를 사용하여 구현했습니다.
KIP-7에 대한 자세한 내용은 클레이튼 개선 제안을 참고하세요.
참고 caver.klay.KIP7
은 caver-js v1.4.0 부터 지원됩니다.
caver.klay.KIP7.deploy
caver.klay.KIP7.deploy(tokenInfo, deployer)
KIP-7 토큰 컨트랙트를 Klaytn 블록체 인에 배포합니다. caver.klay.KIP7.deploy를 사용하여 배포된 컨트랙트는 KIP-7 표준을 따르는 대체 가능한 토큰입니다.
배포가 성공적으로 완료되면 새로운 KIP7 인스턴스로 프로미스가 해결됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
tokenInfo | Object | 클레이튼 블록체인에 KIP-7 토큰 컨트랙트를 배포하는 데 필요한 정보입니다. 자세한 내용은 아래 표를 참조하세요. |
deployer | String | KIP-7 토큰 컨트랙트를 배포할 계정의 주소입니다. 이 계정에는 배포하기에 충분한 KLAY가 있어야 합니다. |
tokenInfo 객체에는 다음이 포함되어야 합니다:
이름 | 유형 | 설명 |
---|---|---|
name | String | 토큰의 이름입니다. |
symbol | String | 토큰의 기호입니다. |
decimals | Number | 토큰이 사용하는 소수점 이하 자릿수입니다. |
initialSupply | BigNumber | string | number | 처음에 공급할 토큰의 총 금액입니다. |
참고 initialSupply
파라미터는 Number
타입을 허용하지만, 입력된 값이 Number.MAX_SAFE_INTEGER로 제한되는 범위를 벗어날 경우 예기치 않은 결과나 오류가 발생할 수 있습니다. 이 경우, 특히 uint256
크기의 숫자 입력 값의 경우 BigNumber
타입을 사용하는 것이 좋습니다.
리턴 값
PromiEvent
: 새로운 KIP7 인스턴스로 해결되는 프로미스 결합 이벤트 이미터입니다. 또한 다음과 같은 이벤트가 발생할 수 있습니다:
이름 | 유형 | 설명 |
---|---|---|
transactionHash | String | 트랜잭션이 전송되고 트랜잭션 해시를 사용할 수 있는 직후에 발생합니다. |
receipt | Object | 트랜잭션 영수증을 사용할 수 있을 때 발생합니다. 영수증 객체 내부의 프로퍼티에 대해 알고 싶으시다면, getTransactionReceipt를 참조하세요. KIP7 인스턴스의 영수증에는 'logs' 속성 대신 abi를 통해 파싱된 'events' 속성이 있습니다. |
error | Error | 전송 중 오류가 발생하면 발생합니다. |
예시
// using the promise> caver.klay.KIP7.deploy({ name: 'Jasmine', symbol: 'JAS', decimals: 18, initialSupply: '100000000000000000000',}, '0x{address in hex}').then(console.log)KIP7 { ... _address: '0x598367e443D8a2b644Fec69a2C12aF44BC283f23', _jsonInterface: [ ... { anonymous: false, inputs: [ { indexed: true, name: 'owner', type: 'address' }, { indexed: true, name: 'spender', type: 'address' }, { indexed: false, name: 'value', type: 'uint256' } ], name: 'Approval', type: 'event', signature: '0x8c5be...' } ] }// using event emitter and promise> caver.klay.KIP7.deploy({ name: 'Jasmine', symbol: 'JAS', decimals: 18, initialSupply: '100000',}, '0x{address in hex}').on('error', function(error) { ... }).on('transactionHash', function(transactionHash) { ... }).on('receipt', function(receipt) { console.log(receipt.contractAddress) // contains the new token contract address}).then(function(newKIP7Instance) { console.log(newKIP7Instance.options.address) // instance with the new token contract address})
new KIP7
new caver.klay.KIP7([tokenAddress])
바인딩된 메서드 및 이벤트가 포함된 새 KIP7 인스턴스를 생성합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
tokenAddress | String | (선택 사항) KIP-7 토큰 컨트랙트의 주소로, 나중에 kip7Instance.options.address = '0x1234..' 를 통해 할당할 수 있습니다. |
리턴 값
유형 | 설명 |
---|---|
Object | 바인딩된 메서드 및 이벤트가 있는 KIP7 인스턴스입니다. |
예시
// Create a KIP7 instance without a parameter> const kip7Instance = new caver.klay.KIP7()// Create a KIP7 instance with a token address> const kip7Instance = new caver.klay.KIP7('0x{address in hex}')
kip7Instance.clone
kip7Instance.clone([tokenAddress])
현재 KIP7 인스턴스를 복제합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
tokenAddress | String | (선택 사항) 다른 KIP7 토큰을 배포한 스마트 컨트랙트의 주소입니다. 생략하면 원래 인스턴스의 컨트랙트 주소로 설정됩니다. |
리턴 값
유형 | 설명 |
---|---|
Object | 원본 KIP7 인스턴스의 복제본입니다. |
예시
> const kip7Instance = new caver.klay.KIP7(address)// Clone without a parameter> const cloned = kip7Instance.clone()// Clone with the address of the new token contract> const cloned = kip7Instance.clone('0x{address in hex}')
kip7Instance.supportsInterface
kip7Instance.supportsInterface(interfaceId)
이 컨트랙트가 interfaceId
로 정의된 인터페이스를 구현하면 true
를 반환합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
interfaceId | String | 검사할 인터페이스아이디입니다. |
리턴 값
이 컨트랙트가 interfaceId
로 정의된 인터페이스를 구현하는 경우 Promise
는 Bool
: true
를 반환합니다.
예시
> kip7Instance.supportsInterface('0x65787371').then(console.log)true> kip7Instance.supportsInterface('0x3a2820fe').then(console.log)false
kip7Instance.name
kip7Instance.name()
토큰의 이름을 반환합니다.
매개변수
None
리턴 값
Promise
는 String
을 반환합니다: 토큰의 이름입니다.
예제
> kip7Instance.name().then(console.log)Jasmine
kip7Instance.symbol
kip7Instance.symbol()
토큰의 심볼을 반환합니다.
매개변수
None
리턴 값
Promise
는 String
을 반환합니다: 토큰의 심볼입니다.
예제
> kip7Instance.symbol().then(console.log)JAS
kip7Instance.decimals
kip7Instance.decimals()
토큰이 사용하는 소수점 이하 자릿수를 반환합니다.
파라미터
None
리턴 값
Promise
는 Number
를 반환합니다: 토큰이 사용하는 소수점 이하 자릿수입니다.
예제
> kip7Instance.decimals().then(console.log)18
kip7Instance.totalSupply
kip7Instance.totalSupply()
총 토큰 공급량을 반환합니다.
매개변수
None
리턴 값
Promise
는 BigNumber
를 반환합니다: 토큰의 총 개수입니다.
예제
> kip7Instance.totalSupply().then(console.log)100000000000000000000
kip7Instance.balanceOf
kip7Instance.balanceOf(address)
지정된 계정 주소의 잔액을 반환합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
address | String | 잔액을 확인할 계정의 주소입니다. |
리턴 값
Promise
는 BigNumber
를 반환합니다: 계정 잔액입니다.
예시
> kip7Instance.balanceOf('0x{address in hex}').then(console.log)100000
kip7Instance.allowance
kip7Instance.allowance(owner, spender)
spender
가 owner
로부터 인출할 수 있는 토큰의 양을 반환합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
owner | String | 토큰 소유자의 계정 주소입니다. |
spender | String | 소유자 대신 토큰을 소비하는 계정의 주소입니다. |
리턴 값
Promise
는 BigNumber
를 반환합니다: spender가 소유자 대신 사용할 수 있는 남은 토큰 수입니다.
예시
> kip7Instance.allowance('0x{address in hex}', '0x{address in hex}').then(console.log)0> kip7Instance.allowance('0x{address in hex}', '0x{address in hex}').then(console.log)10
kip7Instance.isMinter
kip7Instance.isMinter(address)
주어진 계정이 새로운 KIP7 토큰을 발행할 수 있는 발행자인 경우 true
를 반환합니다.
파라미터
이름 | 유형 | 설명 |
---|---|---|
address | String | 발행 권한이 있는지 확인할 계정의 주소입니다. |
리턴 값
Promise
는 계정이 minter인 경우 boolean
: true
를 반환합니다.
예시
> kip7Instance.isMinter('0x{address in hex}').then(console.log)true> kip7Instance.isMinter('0x{address in hex}').then(console.log)false
kip7Instance.isPauser
kip7Instance.isPauser(address)
주어진 계정이 토큰 전송을 일시 중지할 수 있는 일시 중지자인 경우 true
를 반환합니다.
파라미터
이름 | 유형 | 설명 |
---|---|---|
address | String | 토큰 전송을 일시 중단할 권한이 있는지 확인할 계정의 주소입니다. |
리턴 값
Promise
는 계정이 일시 중지 상태인 경우 boolean
: true
를 반환합니다.
예시
> kip7Instance.isPauser('0x{address in hex}').then(console.log)true> kip7Instance.isPauser('0x{address in hex}').then(console.log)false
kip7Instance.paused
kip7Instance.paused()
컨트랙트가 일시 중지된 경우 true
를 반환하고 그렇지 않으면 false
를 반환합니다.
매개변수
None
리턴 값
Promise
는 컨트랙트가 일시 중지되면 boolean
: true
를 반환합니다.
예시
> kip7Instance.paused().then(console.log)true> kip7Instance.paused().then(console.log)false
kip7Instance.approve
kip7Instance.approve(spender, amount [, sendParam])
토큰 소유자의 토큰 중 spender
가 사용할 토큰의 amount
을 설정합니다.
이 메서드는 소유자로부터 트랜잭션을 클레이튼 네트워크에 전송하며, 트랜잭션 수수료는 소유자에게 부과됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
spender | String | 소유자 대신 토큰을 소비하는 계정의 주소입니다. |
amount | BigNumber | string | number | 지출자가 사용할 수 있는 토큰의 양입니다. |
sendParam | Object | (선택 사항) 트랜잭션을 전송하는 데 필요한 매개변수를 포함하는 개체입니다. |
참고 amount
파라미터는 Number
타입을 허용하지만, 입력된 값이 Number.MAX_SAFE_INTEGER로 제한되는 범위를 벗어날 경우 예기치 않은 결과나 오류가 발생할 수 있습니다. 이 경우, 특히 uint256
크기의 숫자 입력 값의 경우 BigNumber
타입을 사용하는 것이 좋습니다.
sendParam
객체에는 다음이 포함됩니다:
이름 | 유형 | 설명 |
---|---|---|
from | String | (선택 사항) 트랜잭션을 전송할 주소입니다. 생략하면 this.options.from 으로 설정됩니다. sendParam 객체의 from 이나 this.options.from 중 어느 것도 제공되지 않으면 오류가 발생합니다. |
gas | number | string | (선택 사항) 이 트랜잭션에 제공되는 최대 가스 수 (가스 제한). 생략할 경우, this.methods.approve(spender, amount).estimateGas({from}) 호출을 통해 caver-js에서 설정합니다. |
gasPrice | number | string | (선택 사항) 이 트랜잭션의 가스 가격(peb 단위)입니다. 생략할 경우, caver.klay.getGasPrice 호출을 통해 caver-js에서 설정합니다. |
value | number | string | BN | Bignumber | (선택 사항) peb 단위로 전송할 값입니다. |
리턴 값
Promise
는 트랜잭션 실행 결과가 포함된 영수증인 Object
를 반환합니다. 영수증 오브젝트 내부의 속성에 대해 알고 싶으시다면, getTransactionReceipt의 설명을 참고하세요. KIP7 인스턴스의 영수증에는 'logs' 속성 대신 ABI를 통해 파싱된 'events' 속성이 있습니다.
예시
// Send via a sendParam object with the from field given > kip7Instance.approve('0x{address in hex}', 10, { from: '0x{address in hex}' }).then(console.log){ blockHash: '0xf010a98f66b6b36943175cd5b249da54e84abed551cfa02846a2900ddab968c7', blockNumber: 2098, contractAddress: null, from: '0x2f7dc98bd93a0544b03d6ff428a6f4ae04b32676', ... status: true, to: '0x8ca777e464a83b939ae131ca037f0d8728c6929e', ... events: { Approval: { address: '0x8CA777e464a83b939AE131CA037F0d8728C6929e', blockNumber: 2098, transactionHash: '0xf7469c0420cb5ebb0fbf64a314bd0c9ee7517ea64dd72eefa59bc8005bbc0f99', transactionIndex: 0, blockHash: '0xf010a98f66b6b36943175cd5b249da54e84abed551cfa02846a2900ddab968c7', logIndex: 0, id: 'log_c6ec61aa', returnValues: { '0': '0x2f7Dc98Bd93A0544B03d6ff428a6f4ae04b32676', '1': '0xe36ffD7bc4D588c480B5925B9622881F9d85ea30', '2': '10', owner: '0x2f7Dc98Bd93A0544B03d6ff428a6f4ae04b32676', spender: '0xe36ffD7bc4D588c480B5925B9622881F9d85ea30', value: '10' }, event: 'Approval', signature: '0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925', raw: { data: '0x000000000000000000000000000000000000000000000000000000000000000a', topics: [ '0x8c5be...', '0x00...676', '0x00...a30' ] }, }, },}// Using kip7Instance.options.from// If the value of kip7Instance.options.from is set, this value is used as the default value // unless you specify `from` in the sendParam object when sending a transaction with a kip7Instance instance.> kip7Instance.options.from = '0x{address in hex}'> kip7Instance.approve('0x{address in hex}', 10).then(console.log)
kip7Instance.transfer
kip7Instance.transfer(recipient, amount [, sendParam])
토큰 소유자의 잔고에서 지정된 amount
의 토큰을 recipient
에게 전송합니다. 토큰 소유자는 이 토큰 전송을 직접 실행해야 합니다. 따라서 토큰 소유자는 이 트랜잭션의 발신자이어야 하며, 주소는 sendParam.from
또는 kip7Instance.options.from
에 제공되어야 합니다. sendParam.from
또는 kip7Instance.options.from
이 제공되지 않으면 오류가 발생합니다.
이 트랜잭션을 보내면 트랜잭션 발신자에게 트랜잭션 수수료가 청구된다는 점에 유의하세요.
매개변수
이름 | 유형 | 설명 |
---|---|---|
recipient | String | 토큰을 받을 계정의 주소입니다. |
amount | BigNumber | string | number | 발행할 토큰의 금액입니다. |
sendParam | Object | (선택사항) 트랜잭션 전송을 위한 파라미터가 정의된 객체입니다. sendParam에 대한 자세한 내용은 approve의 매개변수 설명을 참조하세요. |
참고 amount
파라미터는 Number
타입을 허용하지만, 입력된 값이 Number.MAX_SAFE_INTEGER로 제한되는 범위를 벗어날 경우 예기치 않은 결과나 오류가 발생할 수 있습니다. 이 경우, 특히 uint256
크기의 숫자 입력 값의 경우 BigNumber
타입을 사용하는 것이 좋습니다.
리턴 값
Promise
는 트랜잭션 실행 결과가 포함된 영수증인 Object
를 반환합니다. 영수증 객체 내부의 속성에 대해 알고 싶으시면 getTransactionReceipt의 설명을 참조하세요. KIP7 인스턴스의 영수증에는 'logs' 속성 대신 ABI를 통해 파싱된 'events' 속성이 있습니다.
예시
// Send via a sendParam object with the from field given > kip7Instance.transfer('0x{address in hex}', 10, { from: '0x{address in hex}' }).then(console.log){ blockHash: '0x8a078c3a73d678cdd85d471eb21e9ed7d695f8b96fc7315cfa59c1f68be3d2bf', blockNumber: 1353, contractAddress: null, from: '0x2f7dc98bd93a0544b03d6ff428a6f4ae04b32676', ... status: true, to: '0x05871c21664e18b2906545f8831695650a8f4056', ... events: { Transfer: { address: '0x05871c21664E18b2906545f8831695650a8f4056', blockNumber: 1353, transactionHash: '0x8bd2b21a06241e4cfc0af1ec40e7b15444f730c7529440648aa4ed6b697f08f4', transactionIndex: 0, blockHash: '0x8a078c3a73d678cdd85d471eb21e9ed7d695f8b96fc7315cfa59c1f68be3d2bf', logIndex: 0, id: 'log_82ef7705', returnValues: { '0': '0x2f7Dc98Bd93A0544B03d6ff428a6f4ae04b32676', '1': '0xE411cb0B61FDcC06497794fE3f49F65D5dE41f59', '2': '10', from: '0x2f7Dc98Bd93A0544B03d6ff428a6f4ae04b32676', to: '0xE411cb0B61FDcC06497794fE3f49F65D5dE41f59', value: '10' }, event: 'Transfer', signature: '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef', raw: { data: '0x000000000000000000000000000000000000000000000000000000000000000a', topics: [ '0xddf25...', '0x00...676', '0x00...f59' ] }, }, },}// Using kip7Instance.options.from// If the value of kip7Instance.options.from is set, this value is used as the default value // unless you specify `from` in the sendParam object when sending a transaction with a kip7Instance instance.> kip7Instance.options.from = '0x{address in hex}'> kip7Instance.transfer('0x{address in hex}', 10).then(console.log)
kip7Instance.safeTransfer
kip7Instance.safeTransfer(recipient, amount [, data] [, sendParam])
토큰 소유자의 잔고에서 지정된 amount
의 토큰을 recipient
에게 안전하게 전송합니다. 토큰 소유자는 이 토큰 전송을 직접 실행해야 합니다. 따라서 토큰 소유자는 이 트랜잭션의 발신자이어야 하며, 주소는 sendParam.from
또는 kip7Instance.options.from
에 제공되어야 합니다. sendParam.from
또는 kip7Instance.options.from
이 제공되지 않으면 오류가 발생합니다.
수신자가 컨트랙트 주소인 경우, IKIP7Receiver.onKIP7Received를 구현해야 합니다. 그렇지 않으면 전송이 되 돌려집니다.
이 트랜잭션을 보내면 트랜잭션 발신자에게 트랜잭션 수수료가 청구된다는 점에 유의하세요.
매개변수
이름 | 유형 | 설명 |
---|---|---|
recipient | String | 토큰을 받을 계정의 주소입니다. |
amount | BigNumber | string | number | 송금하려는 토큰의 금액입니다. |
data | Buffer | String | Number | (선택 사항) 호출과 함께 전송할 선택적 데이터입니다. |
sendParam | Object | (선택 사항) 트랜잭션 전송을 위해 정의된 매개변수가 있는 객체입니다. sendParam에 대한 자세한 내용은 approve의 매개변수 설명을 참조하세요. |
참고 amount
파라미터는 Number
타입을 허용하지만, 입력된 값이 Number.MAX_SAFE_INTEGER로 제한되는 범위를 벗어날 경우 예기치 않은 결과나 오류가 발생할 수 있습니다. 이 경우, 특히 uint256
크기의 숫자 입력 값의 경우 BigNumber
타입을 사용하는 것이 좋습니다.
리턴 값
Promise
는 트랜잭션 실행 결과가 포함된 영수증인 Object
를 반환합니다. 영수증 객체 내부의 속성에 대해 알고 싶으시면 getTransactionReceipt의 설명을 참조하세요. KIP17 인스턴스의 영수증에는 'logs' 속성 대신 ABI를 통해 파싱된 'events' 속성이 있습니다.
예시
// Send via a sendParam object with the from field given (without data)> kip7Instance.safeTransfer('0x{address in hex}', 10, { from: '0x{address in hex}' }).then(console.log){ blockHash: '0x208cd64b95bbd91420fc6b1a7b514a8d3051d09333d79244b6b74ff2f7f3eee4', blockNumber: 2384, contractAddress: null, from: '0xc2c84328845a36fe0c4dcef370d24ec80cf85221', ... status: true, to: '0xe4aeba6306b0df023aa4b765960fa59dbe925950', ... events: { Transfer: { address: '0xe4AeBa6306b0Df023AA4b765960fA59dbE925950', blockNumber: 2384, transactionHash: '0x47bb085947c282722c1ceab1f4f0380d911ce464a47a19f1e7bddfe08a13563d', transactionIndex: 0, blockHash: '0x208cd64b95bbd91420fc6b1a7b514a8d3051d09333d79244b6b74ff2f7f3eee4', logIndex: 0, id: 'log_58e5e06d', returnValues: { '0': '0xC2C84328845A36Fe0c4DcEf370d24ec80cF85221', '1': '0x67B092d09B5e94fed58609777cc7Ac9193553B73', '2': '10', from: '0xC2C84328845A36Fe0c4DcEf370d24ec80cF85221', to: '0x67B092d09B5e94fed58609777cc7Ac9193553B73', value: '10', }, event: 'Transfer', signature: '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef', raw: { data: '0x000000000000000000000000000000000000000000000000000000000000000a', topics: [ '0xddf25...', '0x00...221', '0x00...b73' ], }, }, },}// Send via a sendParam object with the from field given (with data)> kip7Instance.safeTransfer('0x{address in hex}', 11, '0x1234', { from: '0x{address in hex}' }).then(console.log)// Using kip7Instance.options.from// If the value of kip7Instance.options.from is set, this value is used as the default value // unless you specify `from` in the sendParam object when sending a transaction with a kip7Instance instance.> kip7Instance.options.from = '0x{address in hex}'> kip7Instance.safeTransfer('0x{address in hex}', 11).then(console.log)
kip7Instance.transferFrom
kip7Instance.transferFrom(sender, recipient, amount [, sendParam])
토큰 소유자의 잔고에서 지정된 amount
의 토큰을 recipient
에게 전송합니다. 토큰 소유자의 토큰을 전송하도록 승인된 주소가 이 토큰 전송 트랜잭션을 실행할 것으로 예상됩니다. 따라서 승인된 주소는 이 트랜잭션의 발신자이어야 하며, 주소는 sendParam.from
또는 kip7Instance.options.from
에 제공되어야 합니다. sendParam.from
또는 kip7Instance.options.from
이 제공되지 않으면 오류가 발생합니다.
이 트랜잭션을 보내면 트랜잭션 발신자에게 트랜잭션 수수료가 청구된다는 점에 유의하세요.
매개변수
이름 | 유형 | 설명 |
---|---|---|
sender | String | 허용 메커니즘으로 전송할 토큰을 소유한 계정의 주소입니다. |
recipient | String | 토큰을 받을 계정의 주소입니다. |
amount | BigNumber | string | number | 송금하려는 토큰의 금액입니다. |
sendParam | Object | (선택 사항) 트랜잭션 전송을 위해 정의된 매개변수가 있는 객체입니다. sendParam에 대한 자세한 내용은 approve의 매개변수 설명을 참조하세요. |
참고 amount
파라미터는 Number
타입을 허용하지만, 입력된 값이 Number.MAX_SAFE_INTEGER로 제한되는 범위를 벗어날 경우 예기치 않은 결과나 오류가 발생할 수 있습니다. 이 경우, 특히 uint256
크기의 숫자 입력 값의 경우 BigNumber
타입을 사용하는 것이 좋습니다.
리턴 값
Promise
는 트랜잭션 실행 결과가 포함된 영수증인 Object
를 반환합니다. 영수증 객체 내부의 속성에 대해 알고 싶으시면 getTransactionReceipt의 설명을 참조하세요. KIP7 인스턴스의 영수증에는 'logs' 속성 대신 ABI를 통해 파싱된 'events' 속성이 있습니다.
예시
// Send via a sendParam object with the from field given> kip7Instance.transferFrom('0x{address in hex}', '0x{address in hex}', 10000, { from: '0x{address in hex}' }).then(console.log){ blockHash: '0x3adec238e06a9e8d5fa09fc1e1d7c8748b64d07e89678d27e8a379a12a34974f', blockNumber: 2331, contractAddress: null, from: '0x01958c62ab4aec7fc282bec9491da0ef7f830ac2', ... status: true, to: '0x3d5eb40665d25aaa4160023c4278fa6a94ba4acb', ... events: { Transfer: { address: '0x3D5EB40665D25aAa4160023C4278FA6A94BA4aCb', blockNumber: 2331, transactionHash: '0x5b2232b68681f19d9b6fcd6fb03964ef105912fecb772c11c8ec9fc906be4cbf', transactionIndex: 0, blockHash: '0x3adec238e06a9e8d5fa09fc1e1d7c8748b64d07e89678d27e8a379a12a34974f', logIndex: 0, id: 'log_ae57b7a0', returnValues: { '0': '0x2f7Dc98Bd93A0544B03d6ff428a6f4ae04b32676', '1': '0x49ff9cb8BB8CA10D7f6E1094b2Ba56c3C2DBA231', '2': '10000', from: '0x2f7Dc98Bd93A0544B03d6ff428a6f4ae04b32676', to: '0x49ff9cb8BB8CA10D7f6E1094b2Ba56c3C2DBA231', value: '10000' }, event: 'Transfer', signature: '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef', raw: { data: '0x0000000000000000000000000000000000000000000000000000000000002710', topics: [ '0xddf25...', '0x00...676', '0x00...231' ] }, }, Approval: { address: '0x3D5EB40665D25aAa4160023C4278FA6A94BA4aCb', blockNumber: 2331, transactionHash: '0x5b2232b68681f19d9b6fcd6fb03964ef105912fecb772c11c8ec9fc906be4cbf', transactionIndex: 0, blockHash: '0x3adec238e06a9e8d5fa09fc1e1d7c8748b64d07e89678d27e8a379a12a34974f', logIndex: 1, id: 'log_cee37d26', returnValues: { '0': '0x2f7Dc98Bd93A0544B03d6ff428a6f4ae04b32676', '1': '0x01958c62aB4aEC7fC282bEc9491dA0EF7F830AC2', '2': '0', owner: '0x2f7Dc98Bd93A0544B03d6ff428a6f4ae04b32676', spender: '0x01958c62aB4aEC7fC282bEc9491dA0EF7F830AC2', value: '0' }, event: 'Approval', signature: '0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925', raw: { data: '0x0000000000000000000000000000000000000000000000000000000000000000', topics: [ '0x8c5be...', '0x00...676', '0x00...ac2' ] }, }, },}// Using kip7Instance.options.from// If the value of kip7Instance.options.from is set, this value is used as the default value // unless you specify `from` in the sendParam object when sending a transaction with a kip7Instance instance.> kip7Instance.options.from = '0x{address in hex}'> kip7Instance.transferFrom('0x{address in hex}', '0x{address in hex}', 10000).then(console.log)
kip7Instance.safeTransferFrom
kip7Instance.safeTransferFrom(sender, recipient, amount [, data] [, sendParam])
토큰 소유자의 잔고에서 지정된 amount
의 토큰을 recipient
에게 안전하게 전송합니다. 토큰 소유자의 토큰을 전송하도록 승인된 주소가 이 토큰 전송 트랜잭션을 실행할 것으로 예상됩니다. 따라서 승인된 주소는 이 트랜잭션의 발신자이어야 하며, 주소는 sendParam.from
또는 kip7Instance.options.from
에 제공되어야 합니다. sendParam.from
또는 kip7Instance.options.from
이 제공되지 않으면 오류가 발생합니다.
수신자가 컨트랙트 주소인 경우, IKIP7Receiver.onKIP7Received를 구현해야 합니다. 그렇지 않으면 전송이 되돌려집니다.
이 트랜잭션을 보내면 트랜잭션 발신자에게 트랜잭션 수수료가 청구된다는 점에 유의하세요.
매개변수
이름 | 유형 | 설명 |
---|---|---|
sender | String | 허용 메커니즘으로 전송할 토큰을 소유한 계정의 주소입니다. |
recipient | String | 토큰을 받을 계정의 주소입니다. |
amount | BigNumber | string | number | 송금하려는 토큰의 금액입니다. |
data | Buffer | String | Number | (선택 사항) 호출과 함께 전송할 선택적 데이터입니다. |
sendParam | Object | (선택사항) 트랜잭션 전송을 위한 파라미터가 정의된 객체입니다. sendParam에 대한 자세한 내용은 approve의 매개변수 설명을 참조하세요. |
참고 amount
파라미터는 Number
타입을 허용하지만, 입력된 값이 Number.MAX_SAFE_INTEGER로 제한되는 범위를 벗어날 경우 예기치 않은 결과나 오류가 발생할 수 있습니다. 이 경우, 특히 uint256
크기의 숫자 입력 값의 경우 BigNumber
타입을 사용하는 것이 좋습니다.
리턴 값
Promise
는 트랜잭션 실행 결과가 포함된 영수증인 Object
를 반환합니다. 영수증 객체 내부의 속성에 대해 알고 싶으시면 getTransactionReceipt의 설명을 참조하세요. KIP17 인스턴스의 영수증에는 'logs' 속성 대신 ABI를 통해 파싱된 'events' 속성이 있습니다.
예시
// Send via a sendParam object with the from field given (without data)> kip7Instance.safeTransferFrom('0x{address in hex}', '0x{address in hex}', 10000, { from: '0x{address in hex}' }).then(console.log){ blockHash: '0x0d641b9cebb032f10348288623898f8aa319faa0845c5b3b7a59ac397a6a218b', blockNumber: 2404, contractAddress: null, from: '0x090937f5c9b83d961da29149a3c37104bc5e71b3', ... status: true, to: '0xe4aeba6306b0df023aa4b765960fa59dbe925950', ... events: { Transfer: { address: '0xe4AeBa6306b0Df023AA4b765960fA59dbE925950', blockNumber: 2404, transactionHash: '0xed8c33facaea963f57c268134aaab48fa765e7298fd70d4bc796b1e93c12ad45', transactionIndex: 0, blockHash: '0x0d641b9cebb032f10348288623898f8aa319faa0845c5b3b7a59ac397a6a218b', logIndex: 0, id: 'log_5eaef2c3', returnValues: { '0': '0xC2C84328845A36Fe0c4DcEf370d24ec80cF85221', '1': '0x67B092d09B5e94fed58609777cc7Ac9193553B73', '2': '10000', from: '0xC2C84328845A36Fe0c4DcEf370d24ec80cF85221', to: '0x67B092d09B5e94fed58609777cc7Ac9193553B73', value: '10000', }, event: 'Transfer', signature: '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef', raw: { data: '0x0000000000000000000000000000000000000000000000000000000000002710', topics: [ '0xddf25...', '0x00...221', '0x00...b73' ], }, }, Approval: { address: '0xe4AeBa6306b0Df023AA4b765960fA59dbE925950', blockNumber: 2404, transactionHash: '0xed8c33facaea963f57c268134aaab48fa765e7298fd70d4bc796b1e93c12ad45', transactionIndex: 0, blockHash: '0x0d641b9cebb032f10348288623898f8aa319faa0845c5b3b7a59ac397a6a218b', logIndex: 1, id: 'log_3f3aedf8', returnValues: { '0': '0xC2C84328845A36Fe0c4DcEf370d24ec80cF85221', '1': '0x090937f5C9B83d961da29149a3C37104Bc5e71B3', '2': '0', owner: '0xC2C84328845A36Fe0c4DcEf370d24ec80cF85221', spender: '0x090937f5C9B83d961da29149a3C37104Bc5e71B3', value: '0', }, event: 'Approval', signature: '0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925', raw: { data: '0x0000000000000000000000000000000000000000000000000000000000000000', topics: [ '0x8c5be...', '0x00...221', '0x00...1b3' ], }, }, },}// Send via a sendParam object with the from field given (with data)> kip7Instance.safeTransferFrom('0x{address in hex}', '0x{address in hex}', 11, '0x1234', { from: '0x{address in hex}' }).then(console.log)// Using kip7Instance.options.from// If the value of kip7Instance.options.from is set, this value is used as the default value // unless you specify `from` in the sendParam object when sending a transaction with a kip7Instance instance.> kip7Instance.options.from = '0x{address in hex}'> kip7Instance.safeTransferFrom('0x{address in hex}', '0x{address in hex}', 11).then(console.log)
kip7Instance.mint
kip7Instance.mint(account, amount [, sendParam])
토큰의 amount
을 생성하고 account
에 발행하여 토큰의 총 공급량을 늘립니다.
이 메서드를 사용하면 트랜잭션이 클레이튼 네트워크에 전송되며, 트랜잭션 수수료가 발신자에게 부과된다는 점에 유의하세요.
매개변수
이름 | 유형 | 설명 |
---|---|---|
account | String | 발행된 토큰이 발급될 계정의 주소입니다. |
amount | BigNumber | string | number | 이체할 토큰의 금액입니다. |
sendParam | Object | (선택사항) 트랜잭션 전송을 위해 정의된 파라미터가 있는 객체입니다. sendParam에 대한 자세한 내용은 approve의 매개변수 설명을 참조하세요. |
참고 amount
파라미터는 Number
타입을 허용하지만, 입력된 값이 Number.MAX_SAFE_INTEGER로 제한되는 범위를 벗어날 경우 예기치 않은 결과나 오류가 발생할 수 있습니다. 이 경우, 특히 uint256
크기의 숫자 입력 값의 경우 BigNumber
타입을 사용하는 것이 좋습니다.
참고 sendParam.from
또는 kip7Instance.options.from
이 주어진 경우, MinterRole이 있는 minter이어야 합니다.
리턴 값
Promise
는 트랜잭션 실행 결과가 포함된 영수증인 Object
를 반환합니다. 영수증 객체 내부의 속성에 대해 알고 싶으시면 getTransactionReceipt의 설명을 참조하세요. KIP7 인스턴스의 영수증에는 'logs' 속성 대신 ABI를 통해 파싱된 'events' 속성이 있습니다.
예시
// Send via a sendParam object with the from field given > kip7Instance.mint('0x{address in hex}', 10000, { from: '0x{address in hex}' }).then(console.log){ blockHash: '0x71e1c7c9de471ed9eb9ec2aca09beb63a654e21514b2b8d25ec93f34b810a709', blockNumber: 8466, contractAddress: null, from: '0x2f7dc98bd93a0544b03d6ff428a6f4ae04b32676', ... status: true, to: '0x54e9ad10ffcbcc2384863157c851a75a31c1e925', ... events: { Transfer: { address: '0x54e9Ad10FFcBCc2384863157c851A75a31C1E925', blockNumber: 8466, transactionHash: '0xef1db1544d0ba70aa06b77599a8421cee2270703cff7d0233bd09ab3561ab49a', transactionIndex: 0, blockHash: '0x71e1c7c9de471ed9eb9ec2aca09beb63a654e21514b2b8d25ec93f34b810a709', logIndex: 0, id: 'log_151f8e90', returnValues: { '0': '0x0000000000000000000000000000000000000000', '1': '0x4756D3c2A3DC61450D949BD9bF702b4209Fc15a0', '2': '10000', from: '0x0000000000000000000000000000000000000000', to: '0x4756D3c2A3DC61450D949BD9bF702b4209Fc15a0', value: '10000', }, event: 'Transfer', signature: '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef', raw: { data: '0x0000000000000000000000000000000000000000000000000000000000002710', topics: [ '0xddf25...', '0x00...000', '0x00...5a0' ], }, }, },}// Using kip7Instance.options.from// If the value of kip7Instance.options.from is set, this value is used as the default value // unless you specify `from` in the sendParam object when sending a transaction with a kip7Instance instance.> kip7Instance.options.from = '0x{address in hex}'> kip7Instance.mint('0x{address in hex}', 10000).then(console.log)
kip7Instance.addMinter
kip7Instance.addMinter(account [, sendParam])
토큰을 발행할 수 있는 발행자로 계정을 추가합니다.
이 메서드를 사용하면 트랜잭션이 클레이튼 네트워크에 전송되며, 트랜잭션 수수료가 발신자에게 부과됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
account | String | 발행자로 추가할 계정의 주소입니다. |
sendParam | Object | (선택 사항) 트랜잭션 전송을 위해 정의된 매개변수가 있는 객체입니다. sendParam에 대한 자세한 내용은 approve의 매개변수 설명을 참조하세요. |
참고 sendParam.from
또는 kip7Instance.options.from
이 주어진 경우, minter이어야 합니다.
리턴 값
Promise
는 트랜잭션 실행 결과가 포함된 영수증인 Object
를 반환합니다. 영수증 오브젝트 내부의 속성에 대해 알고 싶으시다면, getTransactionReceipt의 설명을 참고하세요. KIP7 인스턴스의 영수증에는 '로그' 속성 대신 ABI를 통해 파싱된 '이벤트' 속성이 있습니다.
예시
// Send via a sendParam object with the from field given > kip7Instance.addMinter('0x{address in hex}', { from: '0x{address in hex}' }).then(console.log){ blockHash: '0x169db7e80c954f7d95bbb6a5ef3065190e842d515485e1679f8f3027d1b2975f', blockNumber: 9593, contractAddress: null, from: '0x2f7dc98bd93a0544b03d6ff428a6f4ae04b32676', ... status: true, to: '0x9e2851aff794e69c58e112a3beacbf0de6587f6b', ... events: { MinterAdded: { address: '0x9E2851Aff794E69C58E112a3beacbF0De6587f6b', blockNumber: 9593, transactionHash: '0x11c86fe739ce3f8e6f93f5de87c9626c7cd032dd5e119171f9ec821292cd68e9', transactionIndex: 0, blockHash: '0x169db7e80c954f7d95bbb6a5ef3065190e842d515485e1679f8f3027d1b2975f', logIndex: 0, id: 'log_d93efbcd', returnValues: { '0': '0x823EA6Eb41985218D478C07E77cFBdAd233569C5', account: '0x823EA6Eb41985218D478C07E77cFBdAd233569C5', }, event: 'MinterAdded', signature: '0x6ae172837ea30b801fbfcdd4108aa1d5bf8ff775444fd70256b44e6bf3dfc3f6', raw: { data: '0x', topics: [ '0x6ae17...', '0x00...9c5' ], }, }, },}// Using kip7Instance.options.from// If the value of kip7Instance.options.from is set, this value is used as the default value // unless you specify `from` in the sendParam object when sending a transaction with a kip7Instance instance.> kip7Instance.options.from = '0x{address in hex}'> kip7Instance.addMinter('0x{address in hex}').then(console.log)
kip7Instance.renounceMinter
kip7Instance.renounceMinter([sendParam])
토큰을 발행할 권리를 포기합니다. 발행자 주소만 발행 권한을 포기할 수 있습니다.
이 메서드를 사용하면 트랜잭션이 클레이튼 네트워크에 전송되며, 트랜잭션 수수료가 발신자에게 부과됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
sendParam | Object | (선택 사항) 트랜잭션 전송을 위해 정의된 매개변수가 있는 객체입니다. sendParam에 대한 자세한 내용은 approve의 매개변수 설명을 참조하세요. |
참고 sendParam.from
또는 kip7Instance.options.from
이 주어진 경우, MinterRole이 있는 minter이어야 합니다.
리턴 값
Promise
는 트랜잭션 실행 결과가 포함된 영수증인 Object
를 반환합니다. 영수증 객체 내부의 속성에 대해 알고 싶으시면 getTransactionReceipt의 설명을 참조하세요. KIP7 인스턴스의 영수증에는 'logs' 속성 대신 ABI를 통해 파싱된 'events' 속성이 있습니다.
예시
// Send via a sendParam object with the from field given > kip7Instance.renounceMinter({ from: '0x{address in hex}' }).then(console.log){ blockHash: '0xc1d96a519d9a31a1dab77111af0de73241aa212722859062a96dc3115a2eca23', blockNumber: 9996, contractAddress: null, from: '0x34b91db0f4c7d1381fdf054cc3d0c433b19fca16', ... status: true, to: '0xeba808dcd0fdbfc21a99961be42665f351487f52', ... events: { MinterRemoved: { address: '0xebA808dCD0Fdbfc21a99961BE42665f351487F52', blockNumber: 9996, transactionHash: '0x52328e3cfb8061915d000dc308ffd67650fa36cf4560f1fb12fdb28a7c903ac9', transactionIndex: 0, blockHash: '0xc1d96a519d9a31a1dab77111af0de73241aa212722859062a96dc3115a2eca23', logIndex: 0, id: 'log_bd3a8e46', returnValues: { '0': '0x34b91Db0F4c7D1381FdF054cc3D0c433B19fCa16', account: '0x34b91Db0F4c7D1381FdF054cc3D0c433B19fCa16', }, event: 'MinterRemoved', signature: '0xe94479a9f7e1952cc78f2d6baab678adc1b772d936c6583def489e524cb66692', raw: { data: '0x', topics: [ '0xe9447...', '0x00...a16' ], }, }, },}// Using kip7Instance.options.from// If the value of kip7Instance.options.from is set, this value is used as the default value // unless you specify `from` in the sendParam object when sending a transaction with a kip7Instance instance.> kip7Instance.options.from = '0x{address in hex}'> kip7Instance.renounceMinter().then(console.log)
kip7Instance.burn
kip7Instance.burn(amount [, sendParam])
발신자 잔고에 있는 토큰의 amount
을 소멸합니다. sendParam.from
또는 kip7Instance.options.from
이 제공되지 않으면 오류가 발생합니다.
이 메서드를 사용하면 트랜잭션이 클레이튼 네트워크에 전송되며, 트랜잭션 수수료가 발신자에게 부과됩니다.
파라미터
이름 | 유형 | 설명 |
---|---|---|
amount | BigNumber | string | number | 소멸할 토큰의 양입니다. |
sendParam | Object | (선택 사항) 트랜잭션 전송을 위해 정의된 매개변수가 있는 객체입니다. sendParam에 대한 자세한 내용은 approve의 매개변수 설명을 참조하세요. |
참고 amount
파라미터는 Number
타입을 허용하지만, 입력된 값이 Number.MAX_SAFE_INTEGER로 제한되는 범위를 벗어날 경우 예기치 않은 결과나 오류가 발생할 수 있습니다. 이 경우, 특히 uint256
크기의 숫자 입력 값의 경우 BigNumber
타입을 사용하는 것이 좋습니다.
리턴 값
Promise
는 트랜잭션 실행 결과가 포함된 영수증인 Object
를 반환합니다. 영수증 객체 내부 의 속성에 대해 알고 싶으시면 getTransactionReceipt의 설명을 참조하세요. KIP7 인스턴스의 영수증에는 'logs' 속성 대신 ABI를 통해 파싱된 'events' 속성이 있습니다.
예시
// Send via a sendParam object with the from field given > kip7Instance.burn(1000, { from: '0x{address in hex}' }).then(console.log){ blockHash: '0x7cf9e982510d17a2fd5fca3e7a6f9ce5a25a9da6ba81d51b33129fb7fb93e0ae', blockNumber: 10495, contractAddress: null, from: '0x2f7dc98bd93a0544b03d6ff428a6f4ae04b32676', ... status: true, to: '0x0f681dbc120d9d3be997565626cd87f049f5c405', ... events: { Transfer: { address: '0x0f681Dbc120D9d3BE997565626CD87F049f5C405', blockNumber: 10495, transactionHash: '0x4f2de0b4310c40eeef20ae8e8d129d209195975792de86e1cd00f2345789c9f7', transactionIndex: 0, blockHash: '0x7cf9e982510d17a2fd5fca3e7a6f9ce5a25a9da6ba81d51b33129fb7fb93e0ae', logIndex: 0, id: 'log_20f6c253', returnValues: { '0': '0x2f7Dc98Bd93A0544B03d6ff428a6f4ae04b32676', '1': '0x0000000000000000000000000000000000000000', '2': '1000', from: '0x2f7Dc98Bd93A0544B03d6ff428a6f4ae04b32676', to: '0x0000000000000000000000000000000000000000', value: '1000', }, event: 'Transfer', signature: '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef', raw: { data: '0x00000000000000000000000000000000000000000000000000000000000003e8', topics: [ '0xddf25...', '0x00...676', '0x00...000' ], }, }, },}// Using kip7Instance.options.from// If the value of kip7Instance.options.from is set, this value is used as the default value // unless you specify `from` in the sendParam object when sending a transaction with a kip7Instance instance.> kip7Instance.options.from = '0x{address in hex}'> kip7Instance.burn(1000).then(console.log)
kip7Instance.burnFrom
kip7Instance.burnFrom(account, amount [, sendParam])
account
에서 주어진 토큰 개수를 소멸합니다. sendParam.from
또는 kip7Instance.options.from
에 지정된 발신자의 허용량은 account
의 잔액과 함께 감소합니다.
이 메서드를 사용하면 트랜잭션이 클레이튼 네트워크에 전송되며, 트랜잭션 수수료가 발신자에게 청구된다는 점에 유의하세요.
매개변수
이름 | 유형 | 설명 |
---|---|---|
account | String | 허용 메커니즘으로 소각할 토큰을 소유한 계정의 주소입니다. |
amount | BigNumber | string | number | 소각할 토큰의 양입니다. |
sendParam | Object | (선택 사항) 트랜잭션 전송을 위해 정의된 파라미터가 있는 객체입니다. sendParam에 대한 자세한 내용은 approve의 매개변수 설명을 참조하세요. |
참고 amount
파라미터는 Number
타입을 허용하지만, 입력된 값이 Number.MAX_SAFE_INTEGER로 제한되는 범위를 벗어날 경우 예기치 않은 결과나 오류가 발생할 수 있습니다. 이 경우, 특히 uint256
크기의 숫자 입력 값의 경우 BigNumber
타입을 사용하는 것이 좋습니다.
리턴 값
Promise
는 트랜잭션 실행 결과가 포함된 영수증인 Object
를 반환합니다. 영수증 객체 내부의 속성에 대해 알고 싶으시면 getTransactionReceipt의 설명을 참조하세요. KIP7 인스턴스의 영수증에는 'logs' 속성 대신 ABI를 통해 파싱된 'events' 속성이 있습니다.
예시
// Send via a sendParam object with the from field given > kip7Instance.burnFrom('0x{address in hex}', 1000, { from: '0x{address in hex}' }).then(console.log){ blockHash: '0xcd9f3d00856a056e54697cde2621d8af779c11378c422700510d6ebf65bea0a8', blockNumber: 11371, contractAddress: null, from: '0x1b7bdfcfb0008d0c958da13f2dc30388271e9ef0', ... status: true, to: '0x50fafa2b059d26c47d26c35ccb3cd3b856ecc852', ... events: { Transfer: { address: '0x50fAFa2B059d26C47D26c35Ccb3Cd3b856Ecc852', blockNumber: 11371, transactionHash: '0xed37eafc35272bd7c45695b4b94c578c681a1800b1612ca82d0e4e595e947f27', transactionIndex: 0, blockHash: '0xcd9f3d00856a056e54697cde2621d8af779c11378c422700510d6ebf65bea0a8', logIndex: 0, id: 'log_a7263788', returnValues: { '0': '0x2f7Dc98Bd93A0544B03d6ff428a6f4ae04b32676', '1': '0x0000000000000000000000000000000000000000', '2': '10000', from: '0x2f7Dc98Bd93A0544B03d6ff428a6f4ae04b32676', to: '0x0000000000000000000000000000000000000000', value: '10000', }, event: 'Transfer', signature: '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef', raw: { data: '0x0000000000000000000000000000000000000000000000000000000000002710', topics: [ '0xddf25...', '0x00...676', '0x00...000' ], }, }, Approval: { address: '0x50fAFa2B059d26C47D26c35Ccb3Cd3b856Ecc852', blockNumber: 11371, transactionHash: '0xed37eafc35272bd7c45695b4b94c578c681a1800b1612ca82d0e4e595e947f27', transactionIndex: 0, blockHash: '0xcd9f3d00856a056e54697cde2621d8af779c11378c422700510d6ebf65bea0a8', logIndex: 1, id: 'log_4ca1aac4', returnValues: { '0': '0x2f7Dc98Bd93A0544B03d6ff428a6f4ae04b32676', '1': '0x1B7BdfCFb0008D0C958dA13F2dc30388271E9eF0', '2': '0', owner: '0x2f7Dc98Bd93A0544B03d6ff428a6f4ae04b32676', spender: '0x1B7BdfCFb0008D0C958dA13F2dc30388271E9eF0', value: '0', }, event: 'Approval', signature: '0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925', raw: { data: '0x0000000000000000000000000000000000000000000000000000000000000000', topics: [ '0x8c5be...', '0x00...676', '0x00...ef0' ], }, }, },}// Using kip7Instance.options.from// If the value of kip7Instance.options.from is set, this value is used as the default value // unless you specify `from` in the sendParam object when sending a transaction with a kip7Instance instance.> kip7Instance.options.from = '0x{address in hex}'> kip7Instance.burnFrom('0x{address in hex}', 1000).then(console.log)
kip7Instance.addPauser
kip7Instance.addPauser(account [, sendParam])
컨트랙트를 일시 중단할 수 있는 권한이 있는 계정을 일시 중단자로 추가합니다.
이 메서드를 사용하면 트랜잭션이 클레이튼 네트워크에 전송되며, 트랜잭션 수수료가 발신자에게 부과된다는 점에 유의하세요.
매개변수
이름 | 유형 | 설명 |
---|---|---|
account | String | 새로운 일시정지자가 될 계정의 주소입니다. |
sendParam | Object | (선택 사항) 트랜잭션 전송을 위해 정의된 매개변수가 있는 객체입니다. sendParam에 대한 자세한 내용은 approve의 매개변수 설명을 참조하세요. |
참고 sendParam.from
또는 kip7Instance.options.from
이 전달된 경우, PauserRole이 있는 일시정지자이어야 합니다.
리턴 값
Promise
는 트랜잭션 실행 결과가 포함된 영수증인 Object
를 반환합니다. 영수증 객체 내부의 속성에 대해 알고 싶으시면 getTransactionReceipt의 설명을 참조하세요. KIP7 인스턴스의 영수증에는 'logs' 속성 대신 ABI를 통해 파싱된 'events' 속성이 있습니다.
예시
// Send via a sendParam object with the from field given > kip7Instance.addPauser('0x{address in hex}', { from: '0x{address in hex}' }).then(console.log){ blockHash: '0x14bcefa90f95f5db03ed9c43a77ae910b57960f4f44c786e3a650a8ad163f67a', blockNumber: 16524, contractAddress: null, from: '0x2f7dc98bd93a0544b03d6ff428a6f4ae04b32676', ... status: true, to: '0x31fee792a85ff4d714f47a151975b4979cb47308', ... events: { PauserAdded: { address: '0x31fee792A85ff4D714F47A151975b4979CB47308', blockNumber: 16524, transactionHash: '0x9bd0cba9f5fdc3fdae4b9f40f46f11bf42314ca2518724e78be266d46a8a9f96', transactionIndex: 0, blockHash: '0x14bcefa90f95f5db03ed9c43a77ae910b57960f4f44c786e3a650a8ad163f67a', logIndex: 0, id: 'log_d847b043', returnValues: { '0': '0x6610B93bAE66F89716C3b010ad39DF476Da9234b', account: '0x6610B93bAE66F89716C3b010ad39DF476Da9234b', }, event: 'PauserAdded', signature: '0x6719d08c1888103bea251a4ed56406bd0c3e69723c8a1686e017e7bbe159b6f8', raw: { data: '0x', topics: [ '0x6719d...', '0x00...34b' ], }, }, },}// Using kip7Instance.options.from// If the value of kip7Instance.options.from is set, this value is used as the default value // unless you specify `from` in the sendParam object when sending a transaction with a kip7Instance instance.> kip7Instance.options.from = '0x{address in hex}'> kip7Instance.addPauser('0x{address in hex}').then(console.log)
kip7Instance.renouncePauser
kip7Instance.renouncePauser([sendParam])
계약을 일시 중지할 권리를 포기합니다. 일시 중지 주소만 일시 중지 권한을 포기할 수 있습니다.
이 메서드를 사용하면 트랜잭션이 클레이튼 네트워크에 전송되며, 트랜잭션 수수료가 발신자에게 부과됩니다.
파라미터
이름 | 유형 | 설명 |
---|---|---|
sendParam | Object | (선택 사항) 트랜잭션 전송을 위해 정의된 매개변수가 있는 객체입니다. sendParam에 대한 자세한 내용은 approve의 매개변수 설명을 참조하세요. |
참고 sendParam.from
또는 kip7Instance.options.from
이 전달된 경우, PauserRole이 있는 일시정지자이어야 합니다.
리턴 값
Promise
는 트랜잭션 실행 결과가 포함된 영수증인 Object
를 반환합니다. 영수증 오브젝트 내부의 속성에 대해 알고 싶으시다면, getTransactionReceipt의 설명을 참고하세요. KIP7 인스턴스의 영수증에는 '로그' 속성 대신 ABI를 통해 파싱된 '이벤트' 속성이 있습니다.
예시
// Send via a sendParam object with the from field given > kip7Instance.renouncePauser({ from: '0x{address in hex}' }).then(console.log){ blockHash: '0xc0b1b4914ddc8d74e8034fe86ede1b5b88a2c16ee4d678e58fac325c589713f6', blockNumber: 16567, contractAddress: null, from: '0x5934a0c01baa98f3457981b8f5ce6e52ac585578', ... status: true, to: '0x31fee792a85ff4d714f47a151975b4979cb47308', ... events: { PauserRemoved: { address: '0x31fee792A85ff4D714F47A151975b4979CB47308', blockNumber: 16567, transactionHash: '0xefc93382f5609531dd16f644cf6a3b8e086c623a9fb8038984662f7260482df6', transactionIndex: 0, blockHash: '0xc0b1b4914ddc8d74e8034fe86ede1b5b88a2c16ee4d678e58fac325c589713f6', logIndex: 0, id: 'log_e9518d2f', returnValues: { '0': '0x5934a0c01baA98F3457981b8f5ce6E52ac585578', account: '0x5934a0c01baA98F3457981b8f5ce6E52ac585578', }, event: 'PauserRemoved', signature: '0xcd265ebaf09df2871cc7bd4133404a235ba12eff2041bb89d9c714a2621c7c7e', raw: { data: '0x', topics: [ '0xcd265...', '0x00...578' ], }, }, },}// Using kip7Instance.options.from// If the value of kip7Instance.options.from is set, this value is used as the default value // unless you specify `from` in the sendParam object when sending a transaction with a kip7Instance instance.> kip7Instance.options.from = '0x{address in hex}'> kip7Instance.renouncePauser().then(console.log)
kip7Instance.pause
kip7Instance.pause([sendParam])
토큰 전송과 관련된 기능을 일시 중단합니다.
이 메서드를 사용하면 트랜잭션이 클레이튼 네트워크에 전송되며, 트랜잭션 수수료가 발신자에게 부과됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
sendParam | Object | (선택 사항) 트랜잭션 전송을 위해 정의된 매개변수가 있는 객체입니다. sendParam에 대한 자세한 내용은 approve의 매개변수 설명을 참조하세요. |
참고 sendParam.from
또는 kip7Instance.options.from
이 전달된 경우, PauserRole이 있는 일시정지자이어야 합니다.
리턴 값
Promise
는 트랜잭션 실행 결과가 포함된 영수증인 Object
를 반환합니다. 영수증 오브젝트 내부의 속성에 대해 알고 싶으시다면, getTransactionReceipt의 설명을 참고하세요. KIP7 인스턴스의 영수증에는 'logs' 속성 대신 ABI를 통해 파싱된 'events' 속성이 있습니다.
예시
// Send via a sendParam object with the from field given > kip7Instance.pause({ from: '0x{address in hex}' }).then(console.log){ blockHash: '0xcd5e787e738a6197df871f0d651f2a9149d5ed03fdf62e918c4eed03003ea539', blockNumber: 18218, contractAddress: null, from: '0x2f7dc98bd93a0544b03d6ff428a6f4ae04b32676', ... status: true, to: '0xfc83abf47d232739dab9610c46b3f10c8022b3ef', ... events: { Paused: { address: '0xFc83ABF47d232739dAb9610C46B3F10C8022b3eF', blockNumber: 18218, transactionHash: '0x0e660b8c49e8212a69f2d68324e105b4295b534d22ac0b70263d3e54d429d1bb', transactionIndex: 0, blockHash: '0xcd5e787e738a6197df871f0d651f2a9149d5ed03fdf62e918c4eed03003ea539', logIndex: 0, id: 'log_2ab0db96', returnValues: { '0': '0x2f7Dc98Bd93A0544B03d6ff428a6f4ae04b32676', account: '0x2f7Dc98Bd93A0544B03d6ff428a6f4ae04b32676', }, event: 'Paused', signature: '0x62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258', raw: { data: '0x0000000000000000000000002f7dc98bd93a0544b03d6ff428a6f4ae04b32676', topics: ['0x62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258'], }, }, },}// Using kip7Instance.options.from// If the value of kip7Instance.options.from is set, this value is used as the default value // unless you specify `from` in the sendParam object when sending a transaction with a kip7Instance instance.> kip7Instance.options.from = '0x{address in hex}'> kip7Instance.pause().then(console.log)
kip7Instance.unpause
kip7Instance.unpause([sendParam])
일시 중지된 컨트랙트를 재개합니다.
이 메서드를 사용하면 트랜잭션이 클레이튼 네트워크에 제출되며, 트랜잭션 수수료가 발신자에게 부과됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
sendParam | Object | (선택 사항) 트랜잭션 전송을 위해 정의된 매개변수가 있는 객체입니다. sendParam에 대한 자세한 내용은 approve의 매개변수 설명을 참조하세요. |
참고 sendParam.from
또는 kip7Instance.options.from
이 전달된 경우, PauserRole이 있는 일시정지자이어야 합니다.
리턴 값
Promise
는 트랜잭션 실행 결과가 포함된 영수증인 Object
를 반환합니다. 영수증 객체 내부의 속성에 대해 알고 싶으시면 getTransactionReceipt의 설명을 참조하세요. KIP7 인스턴스의 영수증에는 '로그' 속성 대신 ABI를 통해 파싱된 '이벤트' 속성이 있습니다.
예시
// Send via a sendParam object with the from field given > kip7Instance.unpause({ from: '0x{address in hex}' }).then(console.log){ blockHash: '0xa45194ba608a0a00152f974fb1388ced326522979f4b8f19c3fab3083f1339ac', blockNumber: 18239, contractAddress: null, from: '0x2f7dc98bd93a0544b03d6ff428a6f4ae04b32676', ... status: true, to: '0xfc83abf47d232739dab9610c46b3f10c8022b3ef', ... events: { Unpaused: { address: '0xFc83ABF47d232739dAb9610C46B3F10C8022b3eF', blockNumber: 18239, transactionHash: '0x449dff9d7970bfe326091516ebb22aeaefb0bda59bc4e2577467618863e36c99', transactionIndex: 0, blockHash: '0xa45194ba608a0a00152f974fb1388ced326522979f4b8f19c3fab3083f1339ac', logIndex: 0, id: 'log_9c5a3823', returnValues: { '0': '0x2f7Dc98Bd93A0544B03d6ff428a6f4ae04b32676', account: '0x2f7Dc98Bd93A0544B03d6ff428a6f4ae04b32676', }, event: 'Unpaused', signature: '0x5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa', raw: { data: '0x0000000000000000000000002f7dc98bd93a0544b03d6ff428a6f4ae04b32676', topics: ['0x5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa'], }, }, },}// Using kip7Instance.options.from// If the value of kip7Instance.options.from is set, this value is used as the default value // unless you specify `from` in the sendParam object when sending a transaction with a kip7Instance instance.> kip7Instance.options.from = '0x{address in hex}'> kip7Instance.unpause().then(console.log)