caver.kct.kip7
caver.kct.kip7 "可帮助您在 kaia 区块链上轻松处理以 JavaScript 对象形式实现 KIP-7 的智能合约。
caver.kct.kip7 "继承了caver.contract,以实现 KIP-7 代币合约。 caver.kct.kip7 "拥有与 "caver.contract "相同的属性,但还有其他方法来实现额外的功能。 本节仅介绍 "caver.kct.kip7 "新增的绑定方法。
caver.kct.kip7 中使用的 abi 和字节码是通过 openzeppelin 示例实现的。
为 caver-js 实现 KIP-7 的代码可在 Kaia Contracts Github Repo 上获取。
有关 KIP-7 的更多信息,请参阅 Kaia 改进提案。
caver.kct.kip7.deploy
caver.kct.kip7.deploy(tokenInfo, deployer)
将 KIP-7 代币合约部署到 kaia 区块链上。 使用 caver.kct.kip7.deploy 部署的合约是一种遵循 KIP-7 标准的不可篡改令牌。
成功部署后,将使用新的 KIP17 实例解决承诺问题。
参数
名称 | 类型 | 描述 |
---|---|---|
tokenInfo | object | 在 kaia 区块链上部署 KIP-7 代币合约所需的信息。 详见下表。 |
deployer | string \ | object |
tokenInfo 对象必须包含以下内容:
名称 | 类型 | 描述 |
---|---|---|
name | string | 代币名称 |
symbol | string | 代币符号 |
decimals | number | 标记使用的小数位数。 |
initialSupply | Buffer \ | string \ |
注意 index
参数接受number
类型,但如果输入值超出了number.MAX_SAFE_INTEGER的范围,可能会导致意外结果或错误。 在这种情况下,建议使用 BigNumber
类型,特别是对于 uint256
大小的数值输入值。
返回价值
PromiEvent`:一个承诺组合事件发射器,用一个新的 KIP17 实例来解决。 此外,还可能发生以下事件:
名称 | 类型 | 描述 |
---|---|---|
transactionHash | string | 在事务发送且事务哈希值可用后立即触发。 |
receipt | object | 当交易收据可用时触发。 如果您想了解收据对象内部的属性,请参阅 getTransactionReceipt。 来自 KIP17 实例的收据有一个通过 abi 解析的 "事件 "属性,而不是 "日志 "属性。 |
error | Error | 发送过程中发生错误时触发。 |
示例
// using the promise> caver.kct.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...' } ] }// Send object as second parameter> caver.kct.kip7.deploy({ name: 'Jasmine', symbol: 'JAS', decimals: 18, initialSupply: '100000000000000000000', }, { from: '0x{address in hex}', feeDelegation: true, feePayer: '0x{address in hex}', }).then(console.log)// using event emitter and promise> caver.kct.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})
caver.kct.kip7.detectInterface
caver.kct.kip7.detectInterface(contractAddress
返回代币合约实现的接口信息。 此静态函数将使用 kip17.detectInterface。
参数
名称 | 类型 | 描述 |
---|---|---|
contractAddress | string | KIP-7 代币合约的地址 |
返回价值
Promise "会返回一个 "对象",其中包含每个KIP-7 接口是否已实现的布尔值结果。
示例
> caver.kct.kip7.detectInterface('0x{address in hex}').then(console.log){ IKIP7: true, IKIP7Metadata: true, IKIP7Mintable: true, IKIP7Burnable: true, IKIP7Pausable: true,}
caver.kct.kip7.create
caver.kct.kip7.create([tokenAddress
创建新的 KIP17 实例及其绑定的方法和事件。 该功能与 [new KIP17](#new-kip17)相同。
注意 caver.kct.kip7.create
从 caver-js v1.6.1 开始支持。
参数
请参见 [new KIP17](#new-kip17)。
返回价值
请参见 [new KIP17](#new-kip17)。
示例
// Create a KIP7 instance without a parameter> const kip7 = caver.kct.kip7.create()// Create a KIP7 instance with a token address> const kip7 = caver.kct.kip7.create('0x{address in hex}')
新 KIP17
new caver.kct.kip7([tokenAddress])
创建新的 KIP17 实例及其绑定的方法和事件。
参数
名称 | 类型 | 描述 |
---|---|---|
tokenAddress | string | (可选)KIP-7 代币合约的地址,可稍后通过 kip17.options.address = '0x1234...' 指定。 |
返回价值
类型 | 描述 |
---|---|
object | KIP17 实例及其绑定的方法和事件。 |
示例
// Create a KIP7 instance without a parameter> const kip7 = new caver.kct.kip7()// Create a KIP7 instance with a token address> const kip7 = new caver.kct.kip7('0x{address in hex}')
kip17.clone
kip17.clone([tokenAddress])
克隆当前 KIP17 实例。
参数
名称 | 类型 | 描述 |
---|---|---|
tokenAddress | string | (可选)部署另一个 KIP-17 代币的智能合约地址。 如果省略,则将设置为原始实例中的合约地址。 |
返回价值
类型 | 描述 |
---|---|
object | 原始 KIP17 实例的克隆。 |
示例
> const kip7 = new caver.kct.kip7(address)// Clone without a parameter> const cloned = kip7.clone()// Clone with the address of the new token contract> const cloned = kip7.clone('0x{address in hex}')
kip17.detectInterface
kip17.detectInterface()
返回代币合约实现的接口信息。
参数
无
返回价值
Promise "会返回一个 "对象",其中包含每个KIP-7 接口是否已实现的布尔值结果。
示例
> kip37.detectInterface().then(console.log){ IKIP37: true, IKIP37Metadata: true, IKIP37Mintable: true, IKIP37Burnable: true, IKIP37Pausable: true,}
kip7.supportsInterface
kip17.supportsInterface(interfaceId)
如果此合约实现了由 interfaceId
定义的接口,则返回 true
。
参数
名称 | 类型 | 描述 |
---|---|---|
interfaceId | string | 要检查的 interfaceId。 |
返回价值
Promise
返回 boolean
:如果此合约实现了由 "interfaceId
定义的接口,则返回 "true"。
示例
> kip7.supportsInterface('0x65787371').then(console.log)true> kip7.supportsInterface('0x3a2820fe').then(console.log)false
kip17.name
kip17.name()
返回代币的名称。
参数
无
返回价值
Promise
返回 string
:代币的名称。
示例
> kip17.name().then(console.log)Jasmine
kip7.symbol
kip7.symbol()
返回代币的符号。
参数
无
返回价值
Promise
返回 string
:标记的符号。
示例
> kip7.symbol().then(console.log)JAS
kip7.decimals
kip7.decimals()
返回标记使用的小数位数。
参数
无
返回价值
Promise
返回 number
:代币使用的小数位数。
示例
> kip7.decimals().then(console.log)18
kip7.totalSupply
kip7.totalSupply()
返回全部代币供应。
参数
无
返回价值
Promise
返回 BigNumber
:代币总数。
示例
> kip7.totalSupply().then(console.log)1000000000000000000000000
kip7.balanceOf
kip17.balanceOf(address)
返回给定账户地址的余额。
参数
名称 | 类型 | 描述 |
---|---|---|
address | string | 要查询余额的账户地址。 |
返回价值
Promise
返回 BigNumber
:账户余额。
示例
> kip7.balanceOf('0x{address in hex}').then(console.log)100000
kip7.allowance
kip7.allowance(owner, spender)
返回允许 spender
从 owner
提取的代币数量。
参数
名称 | 类型 | 描述 |
---|---|---|
owner | string | 代币所有者账户的地址。 |
spender | string | 代替所有者使用代币的账户地址。 |
返回价值
承诺 "返回 "大数":允许花费者代替所有者花费的剩余代币数量。
示例
> kip7.allowance('0x{address in hex}', '0x{address in hex}').then(console.log)0> kip7.allowance('0x{address in hex}', '0x{address in hex}').then(console.log)10
kip7.isMinter
kip7.isMinter(address)
如果给定账户是可以发行新 KIP7 代币的矿工,则返回 true
。
参数
名称 | 类型 | 描述 |
---|---|---|
address | string | 检查是否拥有铸币权的账户地址。 |
返回价值
Promise
返回 `boolean:如果账户是矿工,则返回 "true"。
示例
> kip7.isMinter('0x{address in hex}').then(console.log)true> kip7.isMinter('0x{address in hex}').then(console.log)false
kip7.isPauser
kip7.isPauser(address)
如果给定账户是可以暂停转让代币的暂停者,则返回 true
。
参数
名称 | 类型 | 描述 |
---|---|---|
address | string | 要检查的账户地址,以确定该账户是否有权暂停代币转账。 |
返回价值
Promise
返回 `boolean:如果账户是 pauser,则返回 "true"。
示例
> kip7.isPauser('0x{address in hex}').then(console.log)true> kip7.isPauser('0x{address in hex}').then(console.log)false
kip7.paused
kip7.paused()
如果合约暂停,则返回 true
,否则返回 false
。
参数
无
返回价值
Promise
返回 boolean
:如果合约暂停,则返回 true
。
示例
> kip7.paused().then(console.log)true> kip7.paused().then(console.log)false
kip7.approve
kip7.approve(spender, amount [, sendParam])
设置 "支出者 "要支出的代币所有者代币的 "金额"。
请注意,此方法将向 kaia 网络提交所有者的交易,而 kaia 网络将向所有者收取交易费。
参数
名称 | 类型 | 描述 |
---|---|---|
spender | string | 代替所有者使用代币的账户地址。 |
数量 | Buffer \ | string \ |
sendParam | object | (可选)保存发送事务所需参数的对象。 |
注意* amount
参数接受 number
类型,但如果输入值超出 number.MAX_SAFE_INTEGER 的范围,可能会导致意外结果或错误。 在这种情况下,建议使用 BigNumber
类型,特别是对于 uint256
大小的数值输入值。
sendParam
对象包含以下内容:
名称 | 类型 | 描述 |
---|---|---|
from | string | (可选) 发送交易的地址。 如果省略,将由 kip17.options.from 设置。 如果未提供 sendParam 对象中的 from 或 kip17.options.from ,则会发生错误。 |
gas | number \ | string |
gasPrice | number \ | string |
value | number \ | string \ |
feeDelegation | boolean | (可选,默认为 false )是否使用费用委托交易。 如果省略,将使用 `kip17.options.feeDelegation'。 如果两者都省略,则不使用收费授权。 |
feePayer | string | (可选)支付交易费的缴费人地址。 当 "feeDelegation "为 "true "时,该值将设置为交易中的 "feePayer "字段。 如果省略,将使用 `kip17.options.feePayer'。 如果两者都省略,则会出错。 |
feeRatio | string | (可选)缴费人将承担的交易费比例。 如果 "feeDelegation "为 "true",且 "feeRatio "设置为有效值,则使用部分费用委托交易。 有效范围为 1 到 99。 不允许比率为 0 或 100 及以上。 如果省略,将使用 `kip17.options.feeRatio'。 |
注意 feeDelegation
、feePayer
和 feeRatio
从 caver-js v1.6.1 开始支持。
返回价值
Promise
返回 object
- 包含事务执行结果的收据。 如果您想了解收据对象内部的属性,请参阅 getTransactionReceipt 的说明。 来自 KIP37 实例的收件具有通过 ABI 解析的 "事件 "属性,而不是 "日志 "属性。
示例
// Send via a sendParam object with the from field given > kip7.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 FD transaction to execute the smart contract> kip7.approve('0x{address in hex}', 10, { from: '0x{address in hex}' feeDelegation: true, feePayer: '0x{address in hex}'}).then(console.log)// Using kip7.options.from// If the value of kip7.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 kip7 instance.> kip7.options.from = '0x{address in hex}'> kip7.approve('0x{address in hex}', 10).then(console.log)
kip7.transfer
kip7.transfer(recipient, amount [, sendParam])
将给定 "金额 "的代币从代币所有者的余额转给 "接收者"。 代币所有者应亲自执行令牌转让。 因此,授权地址或令牌所有者应是该交易的发送方,其地址必须在 sendParam.from
或 kip17Instance.options.from
中给出。 如果不提供 sendParam.from
或 kip17.options.from
,就会发生错误。
请注意,发送此交易将向交易发送方收取交易费。
参数
名称 | 类型 | 描述 |
---|---|---|
recipient | string | 接收代币的账户地址。 |
amounts | BigNumber \ | string \ |
sendParam | object | (可选)一个对象,包含用于发送事务的定义参数。 有关 sendParam 的更多信息,请参阅 approve 的参数说明。 |
注意 index
参数接受number
类型,但如果输入值超出了number.MAX_SAFE_INTEGER的范围,可能会导致意外结果或错误。 在这种情况下,建议使用 BigNumber
类型,特别是对于 uint256
大小的数值输入值。
返回价值
Promise
返回 object
- 包含事务执行结果的收据。 如果您想了解收据对象内部的属性,请参阅 getTransactionReceipt 的说明。 来自 KIP37 实例的收件具有通过 ABI 解析的 "事件 "属性,而不是 "日志 "属性。
示例
// Send via a sendParam object with the from field given > kip7.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 FD transaction to execute the smart contract> kip7.approve('0x{address in hex}', 10, { from: '0x{address in hex}' feeDelegation: true, feePayer: '0x{address in hex}'}).then(console.log)// Using kip7.options.from// If the value of kip7.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 kip7 instance.> kip7.options.from = '0x{address in hex}'> kip7.approve('0x{address in hex}', 10).then(console.log)
kip7.safeTransfer
kip7.safeTransfer(recipient, amount [, data] [, sendParam])
从代币所有者的余额中安全地将给定的代币 "金额 "转给 "接收者"。 代币所有者应亲自执行代币转让。 因此,授权地址或令牌所有者应是该交易的发送方,其地址必须在 sendParam.from
或 kip17Instance.options.from
中给出。 如果不提供 sendParam.from
或 kip17.options.from
,就会发生错误。
如果 to
是合约地址,则必须执行 IKIP17Receiver.onKIP17Received. 否则,转账将被撤销。
请注意,发送此交易将向交易发送方收取交易费。
参数
名称 | 类型 | 描述 |
---|---|---|
recipient | string | 接收代币的账户地址。 |
amounts | BigNumber \ | string \ |
data | Buffer \ | string \ |
sendParam | object | (可选)一个对象,包含用于发送事务的定义参数。 有关 sendParam 的更多信息,请参阅 approve 的参数说明。 |
注意* "金额 "参数接受 "数字 "类型,但如果输入值超出 number.MAX_SAFE_INTEGER 的范围,可能会导致意外结果或错误。 在这种情况下,建议使用 BigNumber
类型,特别是对于 uint256
大小的数值输入值。
返回价值
Promise
返回 object
- 包含事务执行结果的收据。 如果您想了解收据对象内部的属性,请参阅 getTransactionReceipt 的说明。 来自 KIP37 实例的收件具有通过 ABI 解析的 "事件 "属性,而不是 "日志 "属性。
示例
// Send via a sendParam object with the from field given (without data)> kip7.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' ], }, }, },}// Using FD transaction to execute the smart contract> kip7.safeTransfer('0x{address in hex}', 10, { from: '0x{address in hex}' feeDelegation: true, feePayer: '0x{address in hex}'}).then(console.log)// Send via a sendParam object with the from field given (with data)> kip7.safeTransfer('0x{address in hex}', 11, '0x1234', { from: '0x{address in hex}' }).then(console.log)// Using kip7.options.from// If the value of kip7.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 kip7 instance.> kip7.options.from = '0x{address in hex}'> kip7.safeTransfer('0x{address in hex}', 11).then(console.log)
kip7.transferFrom
kip7.transferFrom(sender, recipient, amount [, sendParam])
将给定 "金额 "的代币从代币所有者的余额转给 "接收者"。 获准发送代币所有者代币的地址将执行该代币转移交易。 因此,获得批准的应该是该事务的发件人,其地址必须在sendParam.from
或kip7.options.from
中给出。 如果不提供 sendParam.from
或 kip7.options.from
,就会发生错误。
请注意,发送此交易将向交易发送方收取交易费。
参数
名称 | 类型 | 描述 |
---|---|---|
sender | string | 拥有要与津 贴机制一起发送的代币的账户地址。 |
recipient | string | 接收代币的账户地址。 |
amount | BigNumber \ | string \ |
sendParam | object | (可选)一个对象,包含用于发送事务的定义参数。 有关 sendParam 的更多信息,请参阅 approve 的参数说明。 |
注意* "金额 "参数接受 "数字 "类型,但如果输入值超出 number.MAX_SAFE_INTEGER 的范围,可能会导致意外结果或错误。 在这种情况下,建议使用 BigNumber
类型,特别是对于 uint256
大小的数值输入值。
返回价值
Promise
返回 object
- 包含事务执行结果的收据。 如果您想了解收据对象内部的属性,请参阅 getTransactionReceipt 的说明。 来自 KIP7 实例的收件具有通过 ABI 解析的 "事件 "属性,而不是 "日志 "属性。
示例
// Send via a sendParam object with the from field given> kip7.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 FD transaction to execute the smart contract> kip7.transferFrom('0x{address in hex}', '0x{address in hex}', 10000, { from: '0x{address in hex}' feeDelegation: true, feePayer: '0x{address in hex}'}).then(console.log)// Using kip7.options.from// If the value of kip7.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 kip7 instance.> kip7.options.from = '0x{address in hex}'> kip7.transferFrom('0x{address in hex}', '0x{address in hex}', 10000).then(console.log)
kip7.safeTransferFrom
kip7.safeTransferFrom(sender, recipient, amount [, data] [, sendParam])
从代币所有者的余额中安全地将给定的代币 "金额 "转给 "接收者"。 获准发送代币所有者代币的地址将执行该代币转移交易。 因此,获得批准的应该是该事务的发件人,其地址必须在sendParam.from
或kip7.options.from
中给出。 如果不提供 sendParam.from
或 kip7.options.from
,就会发生错误。
如果收件人是合同地址,则应执行 IKIP7Receiver.onKIP7Received。 否则,将恢复转账。
请注意,发送此交易将向交易发送方收取交易费。
参数
Name | Type | Description |
---|---|---|
sender | string | 拥有要与津贴机制一起发送的代币的账户地址。 |
recipient | string | 接收代币的账户地址。 |
amount | BigNumber \ | string \ |
data | Buffer \ | string \ |
sendParam | object | (可选)一个对象,包含用于发送事务的定义参数。 有关 sendParam 的更多信息,请参阅 approve 的参数说明。 |
注意* "金额 "参数接受 "数字 "类型,但如果输入值超出 number.MAX_SAFE_INTEGER 的范围,可能会导致意外结果或错误。 在这种情况下,建议使用 BigNumber
类型,特别是对于 uint256
大小的数值输入值。
返回价值
Promise
返回 object
- 包含事务执行结果的收据。 如果您想了解收据对象内部的属性,请参阅 getTransactionReceipt 的说明。 来自 KIP17 实例的收件具有通过 ABI 解析的 "事件 "属性,而不是 "日志 "属性。
示例
// Send via a sendParam object with the from field given (without data)> kip7.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' ], }, }, },}// Using FD transaction to execute the smart contract> kip7.safeTransferFrom('0x{address in hex}', '0x{address in hex}', 10000, { from: '0x{address in hex}' feeDelegation: true, feePayer: '0x{address in hex}'}).then(console.log)// Send via a sendParam object with the from field given (with data)> kip7.safeTransferFrom('0x{address in hex}', '0x{address in hex}', 11, '0x1234', { from: '0x{address in hex}' }).then(console.log)// Using kip7.options.from// If the value of kip7.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 kip7 instance.> kip7.options.from = '0x{address in hex}'> kip7.safeTransferFrom('0x{address in hex}', '0x{address in hex}', 11).then(console.log)
kip7.mint
kip7.mint(account, amount [, sendParam])
创建 "数量 "代币并将其发送到 "账户",增加代币的总供应量。
请注意,此方法将向 kaia 网络提交交易,而 kaia 网络将向发送方收取交易费。
参数
Name | 类型 | 描述 |
---|---|---|
account | string | 将向其发行新币的账户地址。 |
amount | BigNumber \ | string \ |
sendParam | object | (可选)一个对象,包含用于发送事务的定义参数。 有关 sendParam 的更多信息,请参阅 approve 的参数说明。 |
注意* "金额 "参数接受 "数字 "类型,但如果输入值超出 number.MAX_SAFE_INTEGER 的范围,可能会导致意外结果或错误。 在这种情况下,建议使用 BigNumber
类型,特别是对于 uint256
大小的数值输入值。
注意* 如果给出了 sendParam.from
或 kip7.options.from
,则应是具有 MinterRole 的矿工。
返回价值
Promise
返回 object
- 包含事务执行结果的收据。 如果您想了解收据对象内部的属性,请参阅 getTransactionReceipt 的说明。 来自 KIP7 实例的收件具有通过 ABI 解析的 "事件 "属性,而不是 "日志 "属性。
示例
// Send via a sendParam object with the from field given > kip7.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 FD transaction to execute the smart contract> kip7.mint('0x{address in hex}', 10000, { from: '0x{address in hex}' feeDelegation: true, feePayer: '0x{address in hex}'}).then(console.log)// Using kip7.options.from// If the value of kip7.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 kip7 instance.> kip7.options.from = '0x{address in hex}'> kip7.mint('0x{address in hex}', 10000).then(console.log)
kip7.addMinter
kip7.addMinter(account [, sendParam])
添加一个允许制造代币的矿工账户。
请注意,此方法将向 kaia 网络提交交易,而 kaia 网络将向发送方收取交易费。
参数
Name | 类型 | 描述 |
---|---|---|
account | string | 要添加为矿工的账户地址。 |
sendParam | object | (可选)一个对象,包含用于发送事务的定义参数。 有关 sendParam 的更多信息,请参阅 approve 的参数说明。 |
注意* 如果给出了 sendParam.from
或 kip17.options.from
,则应是矿工。
返回价值
Promise
返回 object
- 包含事务执行结果的收据。 如果您 想了解收据对象内部的属性,请参阅 getTransactionReceipt 的说明。 来自 KIP7 实例的收件具有通过 ABI 解析的 "事件 "属性,而不是 "日志 "属性。
示例
// Send via a sendParam object with the from field given > kip7.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 FD transaction to execute the smart contract> kip7.addMinter('0x{address in hex}', { from: '0x{address in hex}' feeDelegation: true, feePayer: '0x{address in hex}'}).then(console.log)// Using kip7.options.from// If the value of kip7.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 kip7 instance.> kip7.options.from = '0x{address in hex}'> kip7.addMinter('0x{address in hex}').then(console.log)
kip7.renounceMinter
kip7.renounceMinter([sendParam])
放弃铸造代币的权利。 只有铸币厂地址可以放弃铸币权。
请注意,此方法将向 kaia 网络提交交易,而 kaia 网络将向发送方收取交易费。
参数
名称 | 类型 | 描述 |
---|---|---|
sendParam | object | (可选)一个对象,包含用于发送事务的定义参数。 有关 sendParam 的更多信息,请参阅 approve 的参数说明。 |
注意* 如果给出了 sendParam.from
或 kip7.options.from
,则应是具有 MinterRole 的矿工。
返回价值
Promise
返回 object
- 包含事务执行结果的收据。 如果您想了解收据对象内部的属性,请参阅 getTransactionReceipt 的说明。 来自 KIP37 实例的收件具有通过 ABI 解析的 "事件 "属性,而不是 "日志 "属性。
示例
// Send via a sendParam object with the from field given > kip7.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 FD transaction to execute the smart contract> kip7.renounceMinter({ from: '0x{address in hex}' feeDelegation: true, feePayer: '0x{address in hex}'}).then(console.log)// Using kip7.options.from// If the value of kip7.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 kip7 instance.> kip7.options.from = '0x{address in hex}'> kip7.renounceMinter().then(console.log)
kip7.burn
kip7.burn(amount [, sendParam])
销毁发送方余额中的代币 "数量"。 如果不提供 sendParam.from
或 kip7.options.from
,就会发生错误。
请注意,此方法将向 kaia 网络提交交易,而 kaia 网络将向发送方收取交易费。
参数
名称 | 类型 | 描述 |
---|---|---|
amounts | BigNumber \ | string \ |
sendParam | object | (可选)一个对象,包含用于发送事务的定义参数。 有关 sendParam 的更多信息,请参阅 approve 的参数说明。 |
注意 index
参数接受number
类型,但如果输入值超出了number.MAX_SAFE_INTEGER的范围,可能会导致意外结果或错误。 在这种情况下,建议使用 BigNumber
类型,特别是对于 uint256
大小的数值输入值。
返回价值
Promise
返回 object
- 包含事务执行结果的收据。 如果您想了解收据对象内部的属性,请参阅 getTransactionReceipt 的说明。 来自 KIP37 实例的收件具有通过 ABI 解析的 "事件 "属性,而不是 "日志 "属性。
示例
// Send via a sendParam object with the from field given > kip7.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 FD transaction to execute the smart contract> kip7.burn(1000, { from: '0x{address in hex}' feeDelegation: true, feePayer: '0x{address in hex}'}).then(console.log)// Using kip7.options.from// If the value of kip7.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 kip7 instance.> kip7.options.from = '0x{address in hex}'> kip7.burn(1000).then(console.log)
kip7.burnFrom
kip7.burnFrom(account, amount [, sendParam])
从 account
中销毁给定数量的代币。 sendParam.from "或 "kip7.options.from "中指定的发件人的津贴将与 "账户 "余额一起减少。
请注意,此方法将向 kaia 网络提交交易,而 kaia 网络将向发送方收取交易费。
参数
名称 | 类型 | 描述 |
---|---|---|
account | string | 拥有代币的账户地址,该代币将通过津贴机制烧毁。 |
amount | Buffer \ | string \ |
sendParam | object | (可选)一个对象,包含用于发送事务的定义参数。 有关 sendParam 的更多信息,请参阅 approve 的参数说明。 |
注意 index
参数接受number
类型,但如果输入值超出了number.MAX_SAFE_INTEGER的范围,可能会导致意外结果或错误。 在这种情况下,建议使用 BigNumber
类型,特别是对于 uint256
大小的数值输入值。
返回价值
Promise
返回 object
- 包含事务执行结果的收据。 如果您想了解收据对象内部的属性,请参阅 getTransactionReceipt 的说明。 来自 KIP37 实例的收件具有通过 ABI 解析的 "事件 "属性,而不是 "日志 "属性。
示例
// Send via a sendParam object with the from field given > kip7.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 FD transaction to execute the smart contract> kip7.burnFrom('0x{address in hex}', 1000, { from: '0x{address in hex}' feeDelegation: true, feePayer: '0x{address in hex}'}).then(console.log)// Using kip7.options.from// If the value of kip7.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 kip7 instance.> kip7.options.from = '0x{address in hex}'> kip7.burnFrom('0x{address in hex}', 1000).then(console.log)
kip7.addPauser
kip7.addPauser(account [, sendParam])
添加一个有权中止合约的暂停账户。
请注意,此方法将向 kaia 网络提交交易,而 kaia 网络将向发送方收取交易费。
参数
名称 | 类型 | 描述 |
---|---|---|
account | string | 将成为新暂停者的账户地址。 |
sendParam | object | (可选)一个对象,包含用于发送事务的定义参数。 有关 sendParam 的更多信息,请参阅 approve 的参数说明。 |
注意* 如果给出了 sendParam.from
或 kip7.options.from
,则应是具有 PauserRole 的暂停器。
返回价值
Promise
返回 object
- 包含事务执行结果的收据。 如果您想了解收据对象内部的属性,请参阅 getTransactionReceipt 的说明。 来自 KIP7 实例的收件具有通过 ABI 解析的 "事件 "属性,而不是 "日志 "属性。
示例
// Send via a sendParam object with the from field given > kip7.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 FD transaction to execute the smart contract> kip7.addPauser('0x{address in hex}', { from: '0x{address in hex}' feeDelegation: true, feePayer: '0x{address in hex}'}).then(console.log)// Using kip7.options.from// If the value of kip7.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 kip7 instance.> kip7.options.from = '0x{address in hex}'> kip7.addPauser('0x{address in hex}').then(console.log)
kip7.renouncePauser
kip7.renouncePauser([sendParam])
放弃暂停合约的权利。 只有暂停地址可以放弃自己的暂停权。
请注意,此方法将向 kaia 网络提交交易,而 kaia 网络将向发送方收取交易费。
参数
名称 | 类型 | 描述 |
---|---|---|
sendParam | object | (可选)一个对象,包含用于发送事务的定义参数。 有关 sendParam 的更多信息,请参阅 approve 的参数说 明。 |
注意* 如果给出了 sendParam.from
或 kip17.options.from
,则应是具有 PauserRole 的暂停器。
返回价值
Promise
返回 object
- 包含事务执行结果的收据。 如果您想了解收据对象内部的属性,请参阅 getTransactionReceipt 的说明。 来自 KIP37 实例的收件具有通过 ABI 解析的 "事件 "属性,而不是 "日志 "属性。
示例
// Send via a sendParam object with the from field given > kip7.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 FD transaction to execute the smart contract> kip7.renouncePauser({ from: '0x{address in hex}' feeDelegation: true, feePayer: '0x{address in hex}'}).then(console.log)// Using kip7.options.from// If the value of kip7.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 kip7 instance.> kip7.options.from = '0x{address in hex}'> kip7.renouncePauser().then(console.log)
kip7.pause
kip7.pause([sendParam])
暂停与发送代币相关的功能。
请注意,此方法将向 kaia 网络提交交易,而 kaia 网络将向发送方收取交易费。
参数
名称 | 类型 | 描述 |
---|---|---|
sendParam | object | (可选)一个对象,包含用于发送事务的定义参数。 有关 sendParam 的更多信息,请参阅 approve 的参数说明。 |
注意* 如果给出了 sendParam.from
或 kip7.options.from
,则应是具有 PauserRole 的暂停器。
返回价值
Promise
返回 object
- 包含事务执行结果的收据。 如果您想了解收据对象内部的属性,请参阅 getTransactionReceipt 的说明。 来自 KIP37 实例的收件具有通过 ABI 解析的 "事件 "属性,而不是 "日志 "属性。
示例
// Send via a sendParam object with the from field given > kip7.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 FD transaction to execute the smart contract> kip7.pause({ from: '0x{address in hex}' feeDelegation: true, feePayer: '0x{address in hex}'}).then(console.log)// Using kip7.options.from// If the value of kip7.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 kip7 instance.> kip7.options.from = '0x{address in hex}'> kip7.pause().then(console.log)
kip7.unpause
kip7.unpause([sendParam])
恢复已暂停的合约。
请注意,此方法将向 kaia 网络提交交易,而 kaia 网络将向发送方收取交易费。
参数
名称 | 类型 | 描述 |
---|---|---|
sendParam | object | (可选)一个对象,包含用于发送事务的定义参数。 有关 sendParam 的更多信息,请参阅 approve 的参数说明。 |
注意* 如果给出了 sendParam.from
或 kip7.options.from
,则应是具有 PauserRole 的暂停器。
返回价值
Promise
返回 object
- 包含事务执行结果的收据。 如果您想了解收据对象内部的属性,请参阅 getTransactionReceipt 的说明。 来自 KIP37 实例的收件具有通过 ABI 解析的 "事件 "属性,而不是 "日志 "属性。
示例
// Send via a sendParam object with the from field given > kip7.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 FD transaction to execute the smart contract> kip7.unpause({ from: '0x{address in hex}' feeDelegation: true, feePayer: '0x{address in hex}'}).then(console.log)// Using kip7.options.from// If the value of kip7.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 kip7 instance.> kip7.options.from = '0x{address in hex}'> kip7.unpause().then(console.log)