本页面使用机器翻译自英语，可能包含错误或不清楚的语言。如需最准确的信息，请参阅英文原文。由于更新频繁，部分内容可能与英文原文有出入。请加入我们在 Crowdin 上的努力，帮助我们改进本页面的翻译。 (Crowdin translation page, Contributing guide)

caver.kct.kip17

caver.kct.kip17 "可帮助您在 kaia 区块链上轻松处理以 JavaScript 对象形式实现 KIP-17 的智能合约。

caver.kct.kip17 "继承了caver.contract，以实现 KIP-17 令牌合约。 caver.kct.kip17 "拥有与 "caver.contract "相同的属性，但还有其他方法来实现额外的功能。本节仅介绍 "caver.kct.kip17 "新增的绑定方法。

为 caver-js 实现 KIP-17 的代码可在 Kaia Contracts Github Repo 上获取。用于 caver-js 的 KIP-17 支持 Ownable 接口。使用此功能，您可以在部署合约时指定合约所有者

有关 KIP-17 的更多信息，请参阅 Kaia 改进提案。

caver.kct.kip17.deploy


caver.kct.kip17.deploy(tokenInfo, deployer)

将 KIP-17 代币合约部署到 kaia 区块链上。使用 caver.kct.kip17.deploy 部署的合约是一种遵循 KIP-17 标准的不可篡改令牌。

成功部署后，将使用新的 KIP17 实例解决承诺问题。

参数

名称	类型	描述
tokenInfo	object	在 kaia 区块链上部署 KIP-17 代币合约所需的信息。详见下表。
deployer	string \	object

tokenInfo 对象必须包含以下内容：

名称	类型	描述
name	string	代笔名称
symbol	string	代笔符号

回报价值

PromiEvent`：一个承诺组合事件发射器，用一个新的 KIP17 实例来解决。此外，还可能发生以下事件：

名称	类型	描述
transactionHash	string	在事务发送且事务哈希值可用后立即触发。
receipt	object	当交易收据可用时触发。如果您想了解收据对象内部的属性，请参阅 getTransactionReceipt。来自 KIP17 实例的收据有一个通过 abi 解析的 "事件 "属性，而不是 "日志 "属性。
error	Error	发送过程中发生错误时触发。

代币注册

要在区块资源管理器上注册代币，合约创建者必须填写一份提交申请表。记下表格上所需的具体信息。
智能合约环境
- 编译器类型固态
- 编译器版本：v0.8.4+commit.c7e474f2
- 开源许可证类型：MIT
智能合约详情
- 优化： --optimize-run 200
- 源代码：KIP17 合同 Github 链接。
ABI 编码值：kip17JsonInterface at dev - kaiachain/caver-js - GitHub

示例


// using the promise
> caver.kct.kip17.deploy({
    name: 'Jasmine',
    symbol: 'JAS',
}, '0x{address in hex}').then(console.log)
KIP17 {
	...
	_address: '0xfA7D967f414468083aDAd85257a2cBD6019693C2',
	_jsonInterface: [
		...
		{
			anonymous: false,
			inputs: [
				{ indexed: true, name: 'owner', type: 'address' },
     			{ indexed: true, name: 'operator', type: 'address' },
     			{ indexed: false, name: 'approved', type: 'bool' }
			],
			name: 'ApprovalForAll',
			type: 'event',
			signature: '0x17307...'
		}
	] 
}
// Send object as second parameter
> caver.kct.kip17.deploy({
        name: 'Jasmine',
        symbol: 'JAS',
    },
    {
        from: '0x{address in hex}',
        feeDelegation: true,
        feePayer: '0x{address in hex}',
    }).then(console.log)
// using event emitter and promise
> caver.kct.kip17.deploy({
    name: 'Jasmine',
    symbol: 'JAS',
}, '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(newKIP17Instance) {
	console.log(newKIP17Instance.options.address) // instance with the new token contract address
})

caver.kct.kip17.detectInterface


caver.kct.kip17.detectInterface(contractAddress

返回代币合约实现的接口信息。此静态函数将使用 kip17.detectInterface。

参数

名称	类型	描述
contractAddress	string	KIP-7 代币合约的地址

返回价值

Promise "会返回一个 "对象"，其中包含每个KIP-17 接口是否已实现的布尔值结果。

示例


> caver.kct.kip17.detectInterface('0x{address in hex}').then(console.log)
{
	IKIP17: true,
	IKIP17Metadata: true,
	IKIP17Enumerable: true,
	IKIP17Mintable: true,
	IKIP17MetadataMintable: true,
	IKIP17Burnable: true,
	IKIP17Pausable: true,
}

caver.kct.kip17.create


caver.kct.kip17.create([tokenAddress

创建新的 KIP17 实例及其绑定的方法和事件。该功能与 [new KIP17]（#new-kip17）相同。

注意 caver.kct.kip17.create从 caver-js v1.6.1 开始支持。

参数

请参见 [new KIP17]（#new-kip17）。

返回价值

请参见 [new KIP17]（#new-kip17）。

示例


// Create a KIP17 instance without a parameter
> const kip17 = caver.kct.kip17.create()
// Create a KIP17 instance with a token address
> const kip17 = caver.kct.kip17.create('0x{address in hex}')

新 KIP17


new caver.kct.kip17([tokenAddress])

创建新的 KIP17 实例及其绑定的方法和事件。

参数

名称	类型	描述
代币地址	string	(可选）KIP-17 代币合约的地址，可稍后通过 `kip17.options.address = '0x1234...'` 指定。

返回价值

类型	描述
对象	KIP17 实例及其绑定的方法和事件。

示例


// Create a KIP17 instance without a parameter
> const kip17 = new caver.kct.kip17()
// Create a KIP17 instance with a token address
> const kip17 = new caver.kct.kip17('0x{address in hex}')

kip17.clone


kip17.clone([tokenAddress])

克隆当前 KIP17 实例。

参数

名称	类型	描述
tokenAddress	string	(可选）部署另一个 KIP-17 令牌的智能合约地址。如果省略，则将设置为原始实例中的合同地址。

返回价值

类型	描述
object	原始 KIP17 实例的克隆。

Example


> const kip17 = new caver.kct.kip17(address)
// Clone without a parameter
> const cloned = kip17.clone()
// Clone with the address of the new token contract
> const cloned = kip17.clone('0x{address in hex}')

kip17.detectInterface


kip17.detectInterface()

返回代币合约实现的接口信息。

参数

空

返回价值

Promise "会返回一个 "对象"，其中包含每个KIP-17 接口是否已实现的布尔值结果。

示例


> kip17.detectInterface().then(console.log)
{
	IKIP17: true,
	IKIP17Metadata: true,
	IKIP17Enumerable: true,
	IKIP17Mintable: true,
	IKIP17MetadataMintable: true,
	IKIP17Burnable: true,
	IKIP17Pausable: true,
}

kip17.supportsInterface


kip17.supportsInterface(interfaceId)

如果此合约实现了由 interfaceId 定义的接口，则返回 true。

参数

名称	类型	描述
interfaceId	string	要检查的 interfaceId。

返回价值

Promise 返回 boolean：如果此合约实现了由 "interfaceId 定义的接口，则返回 "true"。

示例


> kip17.supportsInterface('0x80ac58cd').then(console.log)
true
> kip17.supportsInterface('0xa22cb465').then(console.log)
false

kip17.name


kip17.name()

返回代币的名称。

参数

空

返回价值

Promise 返回 string：代币的名称。

示例


> kip17.name().then(console.log)
Jasmine

kip17.symbol


kip17.symbol()

返回代币的符号。

参数

空

回报价值

Promise 返回 string：标记的符号。

示例


> kip17.symbol().then(console.log)
JAS

kip17.totalSupply


kip17.totalSupply()

返回合约铸造的代币总数。

参数

空

返回价值

Promise 返回 BigNumber：代币总数。

示例


> kip17.totalSupply().then(console.log)
10

kip17.tokenURI


kip17.tokenURI(tokenId)

返回给定标记 ID 的 URI。

参数

名称	类型	描述
tokenId	BigNumber \	string \

注意* "tokenId "参数接受 "数字 "类型，但如果输入值超出 number.MAX_SAFE_INTEGER 的范围，可能会导致意外结果或错误。在这种情况下，建议使用 BigNumber 类型，特别是对于 uint256 大小的数值输入值。

返回价值

Promise 返回 string：给定标记的 URI。

示例


> kip17.tokenURI(0).then(console.log)
https://kip17.example/uri-ex-caver.json

kip17.tokenOfOwnerByIndex


kip17.tokenOfOwnerByIndex(owner, index)

搜索 "所有者 "的代币列表中的给定索引，如果匹配，则返回位于列表中匹配索引处的代币的代币 ID。

参数

名称	类型	描述
所有者	string	拥有代币的账户地址。
index	BigNumber \	string \

注意 index参数接受number类型，但如果输入值超出了number.MAX_SAFE_INTEGER的范围，可能会导致意外结果或错误。在这种情况下，建议使用 BigNumber 类型，特别是对于 uint256 大小的数值输入值。

返回价值

Promise返回BigNumber`：代币的 id。

示例


> kip17.tokenOfOwnerByIndex('0x{address in hex}', 5).then(console.log)
5

kip17.tokenByIndex


kip17.tokenByIndex(index)

根据给定的索引搜索此合约中所有代币的列表，如果匹配，则返回列表中匹配索引处的代币 id。如果索引大于或等于代币总数，它就会还原。

参数

名称	类型	描述
index	BigNumber \	string \

返回价值

Promise返回BigNumber`：代币的 id。

示例


> kip17.tokenByIndex(1).then(console.log)
1

kip17.balanceOf


kip17.balanceOf(address)

返回给定账户地址的余额。 KIP-17 中账户的余额是该账户拥有的 NFT（Non-Fungible Tokens）总数。

参数

名称	类型	描述
地址	string	要查询余额的账户地址。

返回价值

Promise 返回 BigNumber：账户余额。

示例


> kip17.balanceOf('0x{address in hex}').then(console.log)
9

kip17.ownerOf


kip17.ownerOf(tokenId)

返回指定代币id 所有者的地址。

参数

名称	类型	描述
tokenId	BigNumber \	string \

返回价值

Promise 返回 string：拥有给定代币的账户的地址。

示例


> kip17.ownerOf(8).then(console.log)
0x0e0E95426343d97CC7BB913C7D7DBea065A31814

kip17.getApproved


kip17.getApproved(tokenId)

返回获准转让此代币的地址，如果没有地址获准转让，则返回 "0 "地址。如果给定的代币 ID 不存在，它将返回。

参数

名称	类型	描述
tokenId	BigNumber \	string \

返回价值

Promise 返回 string：有权转移给定代币的账户地址。

示例


// If an approved address exists
> kip17.getApproved(10).then(console.log)
0x23D8E9cae17b22d3DAC65b4F7D2C737C6A7b865d
// If no approved address exists
> kip17.getApproved(3).then(console.log)
0x000000000000000000000000000000000000000000000000

kip17.isApprovedForAll


kip17.isApprovedForAll(owner, operator)

如果某个 "操作员 "获准转移属于 "所有者 "的所有代币，则返回 "true"。

参数

名称	类型	描述
所有者	string	拥有代币并允许操作员发送其所有代币的账户地址。
操作员	string	获准代替所有者发送所有代币的账户地址。

返回价值

Promise 返回 boolean:：如果 operator 获准发送属于 owner 的所有代币，则返回 "true"。

示例


> kip17.isApprovedForAll('0x{address in hex}', '0x{address in hex}').then(console.log)
false
> kip17.isApprovedForAll('0x{address in hex}', '0x{address in hex}').then(console.log)
true

kip17.isMinter


kip17.isMinter(address)

如果给定账户是矿工，可以在当前合约中发行符合 KIP-17 标准的新代币，则返回 true。

参数

名称	类型	描述
地址	string	检查是否拥有铸币权的账户地址。

返回价值

Promise 返回 `boolean：如果账户是矿工，则返回 "true"。

示例


> kip17.isMinter('0x{address in hex}').then(console.log)
true
> kip17.isMinter('0x{address in hex}').then(console.log)
false

kip17.paused


kip17.paused()

如果合约暂停，则返回 true，否则返回 false。

参数

无

返回价值

Promise 返回 boolean：如果合约暂停，则返回 true。

示例


> kip17.paused().then(console.log)
true
> kip17.paused().then(console.log)
false

kip17.isPauser


kip17.isPauser(address)

如果给定账户是可以暂停转让代币的暂停者，则返回 true。

参数

名称	类型	描述
地址	string	要检查的账户地址，以确定该账户是否有权暂停代币转账。

返回价值

Promise 返回 `boolean：如果账户是 pauser，则返回 "true"。

示例


> kip17.isPauser('0x{address in hex}').then(console.log)
true
> kip17.isPauser('0x{address in hex}').then(console.log)
false

kip17.approve


kip17.approve(to, tokenId [, sendParam])

批准另一个地址传输给定代币 ID 的代币。零地址表示没有批准的地址。每个令牌只能有一个核准地址。此方法只允许代币所有者或经批准的操作员调用。

请注意，此方法将向 kaia 网络提交交易，而 kaia 网络将向发送方收取交易费。

参数

名称	类型	描述
to	string	代替所有者使用代币的账户地址。
tokenId	BigNumber \	string \
sendParam	object	(可选）一个对象，包含用于发送事务的定义参数。

tokenInfo 对象必须包含以下内容：

名称	类型	描述
from	string	(可选）发送交易的地址。如果省略，将由 `kip17.options.from` 设置。如果未提供 `sendParam` 对象中的 `from` 或 `kip17.options.from`，则会发生错误。
gas	number \	string
gasPrice	number \	string
value	number \	string \
收费授权	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。来自 KIP17 实例的收据有一个通过 abi 解析的 "事件 "属性，而不是 "日志 "属性。

示例


// Send via a sendParam object with the from field given 
> kip17.approve('0x{address in hex}', 10, { from: '0x{address in hex}' }).then(console.log)
{
	blockHash: '0x3875c3f3120c1773c3adeb97260808c8a385bf8427bc203d10cbc5d262f67dbc',
	blockNumber: 2650,
	contractAddress: null,
	from: '0x1147c04b90d1546d76983e19937ad2cdae8b8afd',
	...
	status: true,
	to: '0x5e0e6f1f0bdf9a263e1b1bb6e9759ba182982377',
	...
	events: {
		Approval: {
			address: '0x5E0e6F1F0bDf9A263e1B1bB6e9759Ba182982377',
			blockNumber: 2650,
			transactionHash: '0x0ae92570560d64fa103c8be1861c8625d34ac560066398d9ad0d389ad5f7e441',
			transactionIndex: 0,
			blockHash: '0x3875c3f3120c1773c3adeb97260808c8a385bf8427bc203d10cbc5d262f67dbc',
			logIndex: 0,
			id: 'log_55296c9d',
			returnValues: {
				'0': '0x1147c04b90D1546d76983e19937aD2cDAE8b8afD',
				'1': '0x58746F9D739bC81713E5F5512529876F508a6166',
				'2': '2',
				owner: '0x1147c04b90D1546d76983e19937aD2cDAE8b8afD',
				approved: '0x58746F9D739bC81713E5F5512529876F508a6166',
				tokenId: '2',
			},
			event: 'Approval',
			signature: '0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925',
			raw: {
				data: '0x',
				topics: [ '0x8c5be...', '0x00...afd', '0x00...166', '0x00...002' ],
			},
		},
	},
}
// Using FD transaction to execute the smart contract
> kip17.approve('0x{address in hex}', 10, {
    from: '0x{address in hex}'
    feeDelegation: true,
    feePayer: '0x{address in hex}'
}).then(console.log)
// Using kip17.options.from
// If the value of kip17.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 kip17 instance.
> kip17.options.from = '0x{address in hex}'
> kip17.approve('0x{address in hex}', 10).then(console.log)

kip17.setApprovalForAll


kip17.setApprovalForAll(to, approved [, sendParam])

批准给定操作符 "转 "或禁止给定操作符转移所有者的所有代币。

请注意，setApprovalForAll 方法将向 kaia 网络提交交易，而 kaia 网络将向发送方收取交易费。

参数

名称	类型	描述
to	string	批准/禁止转让所有者所有代币的账户地址。
approved	Boolean	如果 "true"，该操作符将被批准。如果为 `false`，则不允许使用操作符。
sendParam	object	(可选）一个对象，包含用于发送事务的定义参数。有关 sendParam 的更多信息，请参阅 approve 的参数说明。

返回价值

示例


// Send via a sendParam object with the from field given 
> kip17.setApprovalForAll('0x{address in hex}', false, { from: '0x{address in hex}' }).then(console.log)
{
	blockHash: '0x34379ac5b71f16f41d5171d021ca2945e02c60d9fb7f85fc0127262c2ce72b47',
	blockNumber: 3340,
	contractAddress: null,
	from: '0x1147c04b90d1546d76983e19937ad2cdae8b8afd',
	...
	status: true,
	to: '0x1f15b1a4da5437b29bfb7f248b5e344e6b16b654',
	...
	events: {
		ApprovalForAll: {
			address: '0x1f15B1A4DA5437b29BfB7f248B5e344E6b16b654',
			blockNumber: 3340,
			transactionHash: '0x72fdf23482b9cf164638e6cbdfdf56541a6189c88639e21f076a8a50ef749a50',
			transactionIndex: 0,
			blockHash: '0x34379ac5b71f16f41d5171d021ca2945e02c60d9fb7f85fc0127262c2ce72b47',
			logIndex: 0,
			id: 'log_1069ad22',
			returnValues: {
				'0': '0x1147c04b90D1546d76983e19937aD2cDAE8b8afD',
				'1': '0x399bE7034F26feFB5AE683e488903B8bE5ad38b8',
				'2': false,
				owner: '0x1147c04b90D1546d76983e19937aD2cDAE8b8afD',
				operator: '0x399bE7034F26feFB5AE683e488903B8bE5ad38b8',
				approved: false,
			},
			event: 'ApprovalForAll',
			signature: '0x17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31',
			raw: {
				data: '0x0000000000000000000000000000000000000000000000000000000000000000',
				topics: [ '0x17307...', '0x00...afd', '0x00...8b8' ],
			},
		},
	},
}
// Using FD transaction to execute the smart contract
> kip17.setApprovalForAll('0x{address in hex}', false, {
    from: '0x{address in hex}'
    feeDelegation: true,
    feePayer: '0x{address in hex}'
}).then(console.log)
// Using kip17.options.from
// If the value of kip17.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 kip17 instance.
> kip17.options.from = '0x{address in hex}'
> kip17.setApprovalForAll('0x{address in hex}', true).then(console.log)

kip17.transferFrom


kip17.transferFrom(from, to, tokenId [, sendParam])

将给定代币 ID "tokenId "的代币从代币所有者的余额转移到另一个地址。授权发送代币所有者代币的地址（操作员）或令牌所有者本人将执行该令牌转移交易。因此，授权账户或代币所有者应是该交易的发送方，其地址必须在 sendParam.from 或 kip17Instance.options.from 中给出。除非同时提供 sendParam.from 和 kip17Instance.options.from，否则会发生错误。建议尽可能使用 safeTransferFrom 代替此方法。

请注意，发送此交易将向交易发送方收取交易费。

参数

名称	类型	描述
from	string	指定代币所有者或经批准的操作者的地址。
to	string	接收代币的账户地址。
tokenId	BigNumber \	string \
sendParam	object	(可选）一个对象，包含用于发送事务的定义参数。有关 sendParam 的更多信息，请参阅 approve 的参数说明。

返回价值

示例


// Send via a sendParam object with the from field given 
> kip17.transferFrom('0x{address in hex}', '0x{address in hex}', 2, { from: '0x{address in hex}' }).then(console.log)
{
	blockHash: '0x9cae3aa93d327804f333674a77d5d01d8c7908c49749b0d747b6391faa232b58',
	blockNumber: 3592,
	contractAddress: null,
	from: '0x9c4fc0ab840914a29c7deb5cc5c625a4cec3a9cd',
	...
	status: true,
	to: '0x6e611498570bbc8cb127899c4d24e156ec72473a',
	...
	events: {
		Transfer: {
			address: '0x6e611498570bBc8cb127899C4D24e156ec72473a',
			blockNumber: 3592,
			transactionHash: '0x386af961e5acda2c5bd58ec71ee52f579dc2b07a2e5ec97678453f04cc1b709a',
			transactionIndex: 0,
			blockHash: '0x9cae3aa93d327804f333674a77d5d01d8c7908c49749b0d747b6391faa232b58',
			logIndex: 0,
			id: 'log_c2ba5874',
			returnValues: {
				'0': '0x1147c04b90D1546d76983e19937aD2cDAE8b8afD',
				'1': '0x045796ABC035001CF50274FcA8A2614Abf5dd6bf',
				'2': '2',
				from: '0x1147c04b90D1546d76983e19937aD2cDAE8b8afD',
				to: '0x045796ABC035001CF50274FcA8A2614Abf5dd6bf',
				tokenId: '2',
			},
			event: 'Transfer',
			signature: '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
			raw: {
				data: '0x',
				topics: [ '0xddf25...', '0x00...afd', '0x00...6bf', '0x00...002' ],
			},
		},
	},
}
// Using FD transaction to execute the smart contract
> kip17.transferFrom('0x{address in hex}', '0x{address in hex}', 2, {
    from: '0x{address in hex}'
    feeDelegation: true,
    feePayer: '0x{address in hex}'
}).then(console.log)
// Using kip17.options.from
// If the value of kip17.options.from is set, this value is used as the default value 
// unless you specify `from` in sendParam object when sending a transaction with a kip17 instance.
> kip17.options.from = '0x{address in hex}'
> kip17.transferFrom('0x{address in hex}', '0x{address in hex}', 2).then(console.log)

kip17.safeTransferFrom


kip17.safeTransferFrom(from, to, tokenId [, data] [, sendParam])

将给定代币 id tokenId 的令牌从代币所有者的余额安全转移到另一个地址。授权发送代币所有者代币的地址（操作员）或代币所有者本人将执行该代币转移交易。因此，授权地址或代币所有者应是该交易的发送方，其地址必须在 sendParam.from 或 kip17Instance.options.from 中给出。除非同时提供 sendParam.from 和 kip17Instance.options.from，否则会发生错误。

如果 to 是合约地址，则必须执行 IKIP17Receiver.onKIP17Received. 否则，转账将被撤销。

请注意，发送此交易将向交易发送方收取交易费。

参数

名称	类型	描述
from	string	指定代币所有者或经批准的操作者的地址。
to	string	接收代币的账户地址。
tokenId	BigNumber \	string \
data	Buffer \	string \
sendParam	object	(可选）一个对象，包含用于发送事务的定义参数。有关 sendParam 的更多信息，请参阅 approve 的参数说明。

返回价值

示例


// Send via a sendParam object with the from field given (without data)
> kip17.safeTransferFrom('0x{address in hex}', '0x{address in hex}', 9, { from: '0x{address in hex}' }).then(console.log)
{
	blockHash: '0x14c5bebc2be86081d8375ba11edba0e541be1df24c1beced1a9e82e3083a8035',
	blockNumber: 6260,
	contractAddress: null,
	from: '0x80b88b47361cec0baee1947868fc872b784cf91e',
	...
	status: true,
	to: '0xa9066e2b62483bcdf6358874cb87f9e0046e8ad3',
	...
	events: {
		Transfer: {
			address: '0xA9066e2B62483bcdf6358874CB87f9e0046E8ad3',
			blockNumber: 6260,
			transactionHash: '0x0a92436289e70018f9ebef0df5d3ce87874afd8e5058fcc08fefc6de3e0e9b36',
			transactionIndex: 0,
			blockHash: '0x14c5bebc2be86081d8375ba11edba0e541be1df24c1beced1a9e82e3083a8035',
			logIndex: 0,
			id: 'log_c9c17595',
			returnValues: {
				'0': '0x1147c04b90D1546d76983e19937aD2cDAE8b8afD',
				'1': '0x0F47Ea1A10B8F7D61c894E392EfaC990A314d313',
				'2': '9',
				from: '0x1147c04b90D1546d76983e19937aD2cDAE8b8afD',
				to: '0x0F47Ea1A10B8F7D61c894E392EfaC990A314d313',
				tokenId: '9',
			},
			event: 'Transfer',
			signature: '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
			raw: {
				data: '0x',
				topics: [ '0xddf25...', '0x00...afd', '0x00...313', '0x00...009' ],
			},
		},
	},
}
// Using FD transaction to execute the smart contract
> kip17.safeTransferFrom('0x{address in hex}', '0x{address in hex}', 9, {
    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)
> kip17.safeTransferFrom('0x{address in hex}', '0x{address in hex}', 11, '0x1234', { from: '0x{address in hex}' }).then(console.log)
// Using kip17.options.from
// If the value of kip17.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 kip17 instance.
> kip17.options.from = '0x{address in hex}'
> kip17.safeTransferFrom('0x{address in hex}', '0x{address in hex}', 11).then(console.log)

kip17.addMinter


kip17.addMinter(account [, sendParam])

添加一个允许铸造代币的矿工账户。

请注意，addMinter 方法将向 kaia 网络提交交易，而 kaia 网络将向发送者收取交易费。

参数

名称	类型	描述
account	string	要添加为矿工的账户地址。
sendParam	object	(可选）一个对象，包含用于发送事务的定义参数。有关 sendParam 的更多信息，请参阅 approve 的参数说明。

注意* 如果给出了 sendParam.from 或 kip17.options.from ，则应是矿工。

返回价值

示例


// Send via a sendParam object with the from field given 
> kip17.addMinter('0x{address in hex}', { from: '0x{address in hex}' }).then(console.log)
{
	blockHash: '0xecd0fb45a32323d5cb14558d1d9299393022d5e7284519598dbd8b14c4c55930',
	blockNumber: 8307,
	contractAddress: null,
	from: '0x1147c04b90d1546d76983e19937ad2cdae8b8afd',
	...
	status: true,
	to: '0x1595b5c1027ed36dcb32e4d39766b896d5b97ecb',
	...
	events: {
		MinterAdded: {
			address: '0x1595b5c1027ed36dCB32e4D39766b896d5B97ecb',
			blockNumber: 8307,
			transactionHash: '0xf8da21958c84aa3ed8bfa5eea0649c5b9a895efa8c7a715196e000bef4f0b8bd',
			transactionIndex: 0,
			blockHash: '0xecd0fb45a32323d5cb14558d1d9299393022d5e7284519598dbd8b14c4c55930',
			logIndex: 0,
			id: 'log_f40a92bf',
			returnValues: {
				'0': '0x90170C1E7E8C14BBf1124f52980372088BA540Dc',
				account: '0x90170C1E7E8C14BBf1124f52980372088BA540Dc',
			},
			event: 'MinterAdded',
			signature: '0x6ae172837ea30b801fbfcdd4108aa1d5bf8ff775444fd70256b44e6bf3dfc3f6',
			raw: {
				data: '0x',
				topics: [ '0x6ae17...', '0x00...0dc' ],
			},
		},
	},
}
// Using FD transaction to execute the smart contract
> kip17.addMinter('0x{address in hex}', {
    from: '0x{address in hex}'
    feeDelegation: true,
    feePayer: '0x{address in hex}'
}).then(console.log)
// Using kip17.options.from
// If the value of kip17.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 kip17 instance.
> kip17.options.from = '0x{address in hex}'
> kip17.addMinter('0x{address in hex}').then(console.log)

kip17.renounceMinter


kip17.renounceMinter([sendParam])

放弃铸造代币的权利。只有铸币厂地址可以放弃铸币权。

请注意，renounceMinter 方法将向 kaia 网络提交交易，而 kaia 网络将向发送方收取交易费。

参数

名称	类型	描述
sendParam	object	(可选）一个对象，包含用于发送事务的定义参数。有关 sendParam 的更多信息，请参阅 approve 的参数说明。

如果给出了 sendParam.from 或 kip17.options.from ，则应是具有 MinterRole 的矿工。

返回价值

示例


// Send via a sendParam object with the from field given 
> kip17.renounceMinter({ from: '0x{address in hex}' }).then(console.log)
{
	blockHash: '0xe130d7ee71a2c55b3cf4e2bce9ea26e7c2cde556c7f8288abac60121b27c26c8',
	blockNumber: 8542,
	contractAddress: null,
	from: '0xb72f5cf2627e6614984d8a9f27ee426b29191831',
	...
	status: true,
	to: '0xf9d0663fc29c48495f42c0b061cb06df6df76c34',
	...
	events: {
		MinterRemoved: {
			address: '0xF9D0663fC29c48495F42c0b061cB06Df6DF76c34',
			blockNumber: 8542,
			transactionHash: '0x557a4e7b9fd6577ffdb14c2e1f00c0009a7bbda2294502fa765250632b5b0f99',
			transactionIndex: 0,
			blockHash: '0xe130d7ee71a2c55b3cf4e2bce9ea26e7c2cde556c7f8288abac60121b27c26c8',
			logIndex: 0,
			id: 'log_04b47645',
			returnValues: {
				'0': '0xB72F5cF2627e6614984D8A9F27eE426b29191831',
				account: '0xB72F5cF2627e6614984D8A9F27eE426b29191831',
			},
			event: 'MinterRemoved',
			signature: '0xe94479a9f7e1952cc78f2d6baab678adc1b772d936c6583def489e524cb66692',
			raw: {
				data: '0x',
				topics: [ '0xe9447...', '0x00...831' ],
			},
		},
	},
}
// Using FD transaction to execute the smart contract
> kip17.renounceMinter({
    from: '0x{address in hex}'
    feeDelegation: true,
    feePayer: '0x{address in hex}'
}).then(console.log)
// Using kip17.options.from
// If the value of kip17.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 kip17 instance.
> kip17.options.from = '0x{address in hex}'
> kip17.renounceMinter().then(console.log)

kip17.mintWithTokenURI


kip17.mintWithTokenURI(to, tokenId, tokenURI [, sendParam])

使用给定的 uri 创建代币，并将其分配给给定的账户。这种方法可以增加该代币的总供应量。

请注意，mintWithTokenURI 方法将向 kaia 网络提交交易，而 kaia 网络将向发送者收取交易费用。

参数

名称	类型	描述
to	string	将向其发行新币的账户地址。
tokenId	BigNumber \	string \
tokenURI	string	要铸币的代币的 uri 字符串。
sendParam	object	(可选）一个对象，包含用于发送事务的定义参数。有关 sendParam 的更多信息，请参阅 approve 的参数说明。

注意* 如果给出了 sendParam.from 或 kip17.options.from ，则应是具有 MinterRole 的矿工。

返回价值

示例


// Send via a sendParam object with the from field given 
> kip17.mintWithTokenURI('0x{address in hex}', 18, tokenURI, { from: '0x{address in hex}' }).then(console.log)
{
	blockHash: '0xd2473b9853ad33c5fa0a75187e65733614ed4f8c937d06e239768a5ca32d7c7f',
	blockNumber: 9313,
	contractAddress: null,
	from: '0x1147c04b90d1546d76983e19937ad2cdae8b8afd',
	...
	status: true,
	to: '0x7fbf73709054007f5262692f8faf27dee75ab3a6',
	...
	events: {
		Transfer: {
			address: '0x7FBf73709054007f5262692f8FaF27dEE75Ab3A6',
			blockNumber: 9313,
			transactionHash: '0x17c2eda25c8a817915e3dd77b4fb4838259e8b49ae1c0d8e369167f715a08e7f',
			transactionIndex: 0,
			blockHash: '0xd2473b9853ad33c5fa0a75187e65733614ed4f8c937d06e239768a5ca32d7c7f',
			logIndex: 0,
			id: 'log_d060e77e',
			returnValues: {
				'0': '0x0000000000000000000000000000000000000000',
				'1': '0x203ad91221290901CFDAC9399aCf664499924744',
				'2': '18',
				from: '0x0000000000000000000000000000000000000000',
				to: '0x203ad91221290901CFDAC9399aCf664499924744',
				tokenId: '18',
			},
			event: 'Transfer',
			signature: '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
			raw: {
				data: '0x',
				topics: [ '0xddf25...', '0x00...000', '0x00...744', '0x00...012' ],
			},
		},
	},
}
// Using FD transaction to execute the smart contract
> kip17.mintWithTokenURI('0x{address in hex}', 18, tokenURI, {
    from: '0x{address in hex}'
    feeDelegation: true,
    feePayer: '0x{address in hex}'
}).then(console.log)
// Using kip17.options.from
// If the value of kip17.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 kip17 instance.
> kip17.options.from = '0x{address in hex}'
> kip17.mintWithTokenURI('0x{address in hex}', 18, tokenURI).then(console.log)

kip17.burn


kip17.burn(tokenId [, sendParam])

销毁给定代币 id 的代币。如果不提供 sendParam.from 或 kip17.options.from，就会发生错误。

请注意，"销毁 "方法将向 kaia 网络提交交易，而 kaia 网络将向发送者收取交易费。

参数

名称	类型	描述
tokenId	BigNumber \	string \
sendParam	object	(可选）一个对象，包含用于发送事务的定义参数。有关 sendParam 的更多信息，请参阅 approve 的参数说明。

返回价值

示例


// Send via a sendParam object with the from field given 
> kip17.burn(14, { from: '0x{address in hex}' }).then(console.log)
{
	blockHash: '0x09d8ed5582fdd1c39b0f19f14f065659fe275a60856d86a1840535f6df1a2d51',
	blockNumber: 18237,
	contractAddress: null,
	from: '0x1147c04b90d1546d76983e19937ad2cdae8b8afd',
	...
	status: true,
	to: '0x2032e61c79a951aacef8033adca96fc3b9b747b4',
	...
	events: {
		Transfer: {
			address: '0x2032e61C79A951AACEf8033AdCa96fC3b9b747b4',
			blockNumber: 18237,
			transactionHash: '0x4e377d8d65c8565c7bc91568bcdcc0fddeb46a02a778725e437f368a8d9c6165',
			transactionIndex: 0,
			blockHash: '0x09d8ed5582fdd1c39b0f19f14f065659fe275a60856d86a1840535f6df1a2d51',
			logIndex: 0,
			id: 'log_5af49695',
			returnValues: {
				'0': '0x1147c04b90D1546d76983e19937aD2cDAE8b8afD',
				'1': '0x0000000000000000000000000000000000000000',
				'2': '14',
				from: '0x1147c04b90D1546d76983e19937aD2cDAE8b8afD',
				to: '0x0000000000000000000000000000000000000000',
				tokenId: '14',
			},
			event: 'Transfer',
			signature: '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
			raw: {
				data: '0x',
				topics: [ '0xddf25...', '0x00...afd', '0x00...000', '0x00...00e' ],
			},
		},
	},
}
// Using FD transaction to execute the smart contract
> kip17.burn(14, {
    from: '0x{address in hex}'
    feeDelegation: true,
    feePayer: '0x{address in hex}'
}).then(console.log)
// Using kip17.options.from
// If the value of kip17.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 kip17 instance.
> kip17.options.from = '0x{address in hex}'
> kip17.burn(14).then(console.log)

kip17.pause


kip17.pause([sendParam])

暂停与发送代币相关的功能。

请注意，暂停方法将向 kaia 网络提交交易，而 kaia 网络将向发送者收取交易费。

参数

名称	类型	描述
sendParam	object	(可选）一个对象，包含用于发送事务的定义参数。有关 sendParam 的更多信息，请参阅 approve 的参数说明。

注意* 如果给出了 sendParam.from 或 kip17.options.from，则应是具有 PauserRole 的暂停器。

返回价值

Promise 返回 object - 包含事务执行结果的收据。如果您想了解收据对象内部的属性，请参阅 getTransactionReceipt 的说明。来自 KIP17 实例的收据有一个通过 abi 解析的 "事件 "属性，而不是 "日志 "属性。

示例


// Send via a sendParam object with the from field given 
> kip17.pause({ from: '0x{address in hex}' }).then(console.log)
{
	blockHash: '0xd73c026474b2077a04808ed0ce6713821eaa8afaed476b19d22b28e483747e04',
	blockNumber: 19826,
	contractAddress: null,
	from: '0x1147c04b90d1546d76983e19937ad2cdae8b8afd',
	...
	status: true,
	to: '0x601c11f396e92436df8d9bbaff3fbfec906b7f67',
	...
	events: {
		Paused: {
			address: '0x601C11F396E92436Df8d9bBAFf3fbfEc906B7f67',
			blockNumber: 19826,
			transactionHash: '0x549f7786ca5d2c1877be20126fc51c2418194ecaa8cea536d08f72c2f01919d0',
			transactionIndex: 0,
			blockHash: '0xd73c026474b2077a04808ed0ce6713821eaa8afaed476b19d22b28e483747e04',
			logIndex: 0,
			id: 'log_93d26310',
			returnValues: {
				'0': '0x1147c04b90D1546d76983e19937aD2cDAE8b8afD',
				account: '0x1147c04b90D1546d76983e19937aD2cDAE8b8afD',
			},
			event: 'Paused',
			signature: '0x62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258',
			raw: {
				data: '0x0000000000000000000000001147c04b90d1546d76983e19937ad2cdae8b8afd',
				topics: ['0x62e78...'],
			},
		},
	},
}
// Using FD transaction to execute the smart contract
> kip17.pause({
    from: '0x{address in hex}'
    feeDelegation: true,
    feePayer: '0x{address in hex}'
}).then(console.log)
// Using kip17.options.from
// If the value of kip17.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 kip17 instance.
> kip17.options.from = '0x{address in hex}'
> kip17.pause().then(console.log)

kip17.unpause


kip17.unpause([sendParam])

恢复已暂停的合同。

请注意，取消暂停方法将向 kaia 网络提交交易，而 kaia 网络将向发送方收取交易费。

参数

名称	类型	描述
sendParam	object	(可选）一个对象，包含用于发送事务的定义参数。有关 sendParam 的更多信息，请参阅 approve 的参数说明。

注意* 如果给出了 sendParam.from 或 kip17.options.from，则应是具有 PauserRole 的暂停器。

返回价值

示例


// Send via a sendParam object with the from field given 
> kip17.unpause({ from: '0x{address in hex}' }).then(console.log)
{
	blockHash: '0x6a9fc0c70853e696e687b119ba95971a42d91616a040ec17afe1fd4803f5a6cb',
	blockNumber: 19845,
	contractAddress: null,
	from: '0x1147c04b90d1546d76983e19937ad2cdae8b8afd',
	...
	status: true,
	to: '0x601c11f396e92436df8d9bbaff3fbfec906b7f67',
	...
	events: {
		Unpaused: {
			address: '0x601C11F396E92436Df8d9bBAFf3fbfEc906B7f67',
			blockNumber: 19845,
			transactionHash: '0x4f0d2767fc36e5062a34753bc447a2c15b476c304f8e9e013ddf06124db33229',
			transactionIndex: 0,
			blockHash: '0x6a9fc0c70853e696e687b119ba95971a42d91616a040ec17afe1fd4803f5a6cb',
			logIndex: 0,
			id: 'log_364c25d2',
			returnValues: {
				'0': '0x1147c04b90D1546d76983e19937aD2cDAE8b8afD',
				account: '0x1147c04b90D1546d76983e19937aD2cDAE8b8afD',
			},
			event: 'Unpaused',
			signature: '0x5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa',
			raw: {
				data: '0x0000000000000000000000001147c04b90d1546d76983e19937ad2cdae8b8afd',
				topics: ['0x5db9e...'],
			},
		},
	},
}
// Using FD transaction to execute the smart contract
> kip17.unpause({
    from: '0x{address in hex}'
    feeDelegation: true,
    feePayer: '0x{address in hex}'
}).then(console.log)
// Using kip17.options.from
// If the value of kip17.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 kip17 instance.
> kip17.options.from = '0x{address in hex}'
> kip17.unpause().then(console.log)

kip17.addPauser


kip17.addPauser(account [, sendParam])

添加一个有权中止合同的暂停账户。

请注意，addPauser 方法将向 kaia 网络提交交易，而 kaia 网络将向发送者收取交易费。

参数

名称	类型	描述
account	string	将成为新暂停者的账户地址。
sendParam	object	(可选）一个对象，包含用于发送事务的定义参数。有关 sendParam 的更多信息，请参阅 approve 的参数说明。

注意* 如果给出了 sendParam.from 或 kip17.options.from，则应是具有 PauserRole 的暂停器。

返回价值

示例


// Send via a sendParam object with the from field given 
> kip17.addPauser('0x{address in hex}', { from: '0x{address in hex}' }).then(console.log)
{
	blockHash: '0xd9f18912c9666a67a2e7445af0abe5140212955b3d35c491e5475d512fdee7d5',
	blockNumber: 20502,
	contractAddress: null,
	from: '0x1147c04b90d1546d76983e19937ad2cdae8b8afd',
	...
	status: true,
	to: '0x4010afbfbf8d94830b226fc5ff311859af806b90',
	...
	events: {
		PauserAdded: {
			address: '0x4010afbfbF8d94830b226Fc5ff311859AF806B90',
			blockNumber: 20502,
			transactionHash: '0x5f6fef2df70dcbe67e6d74e201005b618da5d53ac2f85ad31fce39226fd1b70b',
			transactionIndex: 0,
			blockHash: '0xd9f18912c9666a67a2e7445af0abe5140212955b3d35c491e5475d512fdee7d5',
			logIndex: 0,
			id: 'log_bf9f8982',
			returnValues: {
				'0': '0xD050b56bB04Da257D144e6b382318A2B8c58b0B2',
				account: '0xD050b56bB04Da257D144e6b382318A2B8c58b0B2',
			},
			event: 'PauserAdded',
			signature: '0x6719d08c1888103bea251a4ed56406bd0c3e69723c8a1686e017e7bbe159b6f8',
			raw: {
				data: '0x',
				topics: [ '0x6719d...', '0x00...0b2' ],
			},
		},
	},
}
// Using FD transaction to execute the smart contract
> kip17.addPauser('0x{address in hex}', {
    from: '0x{address in hex}'
    feeDelegation: true,
    feePayer: '0x{address in hex}'
}).then(console.log)
// Using kip17.options.from
// If the value of kip17.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 kip17 instance.
> kip17.options.from = '0x{address in hex}'
> kip17.addPauser('0x{address in hex}').then(console.log)

kip17.renouncePauser


kip17.renouncePauser([sendParam])

放弃暂停合约的权利。只有暂停地址可以放弃自己的暂停权。

请注意，renouncePauser 方法将向 kaia 网络提交交易，而 kaia 网络将向发送者收取交易费。

参数

名称	类型	描述
sendParam	object	(可选）一个对象，包含用于发送事务的定义参数。有关 sendParam 的更多信息，请参阅 approve 的参数说明。

注意* 如果给出了 sendParam.from 或 kip17.options.from，则应是具有 PauserRole 的暂停器。

返回价值

示例


// Send via a sendParam object with the from field given 
> kip17.renouncePauser({ from: '0x{address in hex}' }).then(console.log)
{
	blockHash: '0x32bb338ca23846478934416d1b1f4152b69a49411d61b316cff8b3a7d62ca91e',
	blockNumber: 20512,
	contractAddress: null,
	from: '0xe04cb220e94e6595427568c954b5d819392813bc',
	...
	status: true,
	to: '0x4010afbfbf8d94830b226fc5ff311859af806b90',
	...
	events: {
		PauserRemoved: {
			address: '0x4010afbfbF8d94830b226Fc5ff311859AF806B90',
			blockNumber: 20512,
			transactionHash: '0x72982fa8a8de25c961cd19bd91aa7acf0111feb8e9026e607d89843bcd8f783a',
			transactionIndex: 0,
			blockHash: '0x32bb338ca23846478934416d1b1f4152b69a49411d61b316cff8b3a7d62ca91e',
			logIndex: 0,
			id: 'log_0a9d1350',
			returnValues: {
				'0': '0xE04cB220e94E6595427568c954b5D819392813bC',
				account: '0xE04cB220e94E6595427568c954b5D819392813bC',
			},
			event: 'PauserRemoved',
			signature: '0xcd265ebaf09df2871cc7bd4133404a235ba12eff2041bb89d9c714a2621c7c7e',
			raw: {
				data: '0x',
				topics: [ '0xcd265...', '0x00...3bc' ],
			},
		},
	},
}
// Using FD transaction to execute the smart contract
> kip17.renouncePauser({
    from: '0x{address in hex}'
    feeDelegation: true,
    feePayer: '0x{address in hex}'
}).then(console.log)
// Using kip17.options.from
// If the value of kip17.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 kip17 instance.
> kip17.options.from = '0x{address in hex}'
> kip17.renouncePauser().then(console.log)

caver.kct.kip17.deploy​

caver.kct.kip17.detectInterface​

caver.kct.kip17.create​

新 KIP17​

kip17.clone​

kip17.detectInterface​

kip17.supportsInterface​

kip17.name​

kip17.symbol​

kip17.totalSupply​

kip17.tokenURI​

kip17.tokenOfOwnerByIndex​

kip17.tokenByIndex​

kip17.balanceOf​

kip17.ownerOf​

kip17.getApproved​

kip17.isApprovedForAll​

kip17.isMinter​

kip17.paused​

kip17.isPauser​

kip17.approve​

kip17.setApprovalForAll​

kip17.transferFrom​

kip17.safeTransferFrom​

kip17.addMinter​

kip17.renounceMinter​

kip17.mintWithTokenURI​

kip17.burn​

kip17.pause​

kip17.unpause​

kip17.addPauser​

kip17.renouncePauser​

caver.kct.kip17.deploy

caver.kct.kip17.detectInterface

caver.kct.kip17.create

新 KIP17

kip17.clone

kip17.detectInterface

kip17.supportsInterface

kip17.name

kip17.symbol

kip17.totalSupply

kip17.tokenURI

kip17.tokenOfOwnerByIndex

kip17.tokenByIndex

kip17.balanceOf

kip17.ownerOf

kip17.getApproved

kip17.isApprovedForAll

kip17.isMinter

kip17.paused

kip17.isPauser

kip17.approve

kip17.setApprovalForAll

kip17.transferFrom

kip17.safeTransferFrom

kip17.addMinter

kip17.renounceMinter

kip17.mintWithTokenURI

kip17.burn

kip17.pause

kip17.unpause

kip17.addPauser

kip17.renouncePauser