跳至主要內容
本頁面使用機器翻譯自英語,可能包含錯誤或不清楚的語言。如需最準確的信息,請參閱英文原文。由於更新頻繁,部分內容可能與英文原文有出入。請加入我們在 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 實例解決承諾問題。

參數

名稱類型描述
tokenInfoobject在 kaia 區塊鏈上部署 KIP-17 代幣合約所需的信息。 詳見下表。
deployerstring \object

tokenInfo 對象必須包含以下內容:

名稱類型描述
namestring代筆名稱
symbolstring代筆符號

回報價值

PromiEvent`:一個承諾組合事件發射器,用一個新的 KIP17 實例來解決。 此外,還可能發生以下事件:

名稱類型描述
transactionHashstring在事務發送且事務哈希值可用後立即觸發。
receiptobject當交易收據可用時觸發。 如果您想了解收據對象內部的屬性,請參閱 getTransactionReceipt。 來自 KIP17 實例的收據有一個通過 abi 解析的 "事件 "屬性,而不是 "日誌 "屬性。
errorError發送過程中發生錯誤時觸發。

代幣註冊

  1. 要在區塊資源管理器上註冊代幣,合約創建者必須填寫一份提交申請表。 記下表格上所需的具體信息。

  2. 智能合約環境

    • 編譯器類型固態

    • 編譯器版本:v0.8.4+commit.c7e474f2

    • 開源許可證類型:MIT

  3. 智能合約詳情

  4. 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

參數

名稱類型描述
contractAddressstringKIP-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 實例。

參數

名稱類型描述
tokenAddressstring(可選)部署另一個 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

參數

名稱類型描述
interfaceIdstring要檢查的 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。

參數

名稱類型描述
tokenIdBigNumber \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擁有代幣的賬戶地址。
indexBigNumber \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。 如果索引大於或等於代幣總數,它就會還原。

參數

名稱類型描述
indexBigNumber \string \

注意 index參數接受number類型,但如果輸入值超出了number.MAX_SAFE_INTEGER的範圍,可能會導致意外結果或錯誤。 在這種情況下,建議使用 BigNumber 類型,特別是對於 uint256 大小的數值輸入值。

返回價值

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 所有者的地址。

參數

名稱類型描述
tokenIdBigNumber \string \

注意* "tokenId "參數接受 "數字 "類型,但如果輸入值超出 number.MAX_SAFE_INTEGER 的範圍,可能會導致意外結果或錯誤。 在這種情況下,建議使用 BigNumber 類型,特別是對於 uint256 大小的數值輸入值。

返回價值

Promise 返回 string:擁有給定代幣的賬戶的地址。

示例


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

kip17.getApproved


kip17.getApproved(tokenId)

返回獲准轉讓此代幣的地址,如果沒有地址獲准轉讓,則返回 "0 "地址。 如果給定的代幣 ID 不存在,它將返回。

參數

名稱類型描述
tokenIdBigNumber \string \

注意* "tokenId "參數接受 "數字 "類型,但如果輸入值超出 number.MAX_SAFE_INTEGER 的範圍,可能會導致意外結果或錯誤。 在這種情況下,建議使用 BigNumber 類型,特別是對於 uint256 大小的數值輸入值。

返回價值

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 網絡將向發送方收取交易費。

參數

名稱類型描述
tostring代替所有者使用代幣的賬戶地址。
tokenIdBigNumber \string \
sendParamobject(可選)一個對象,包含用於發送事務的定義參數。

注意* "tokenId "參數接受 "數字 "類型,但如果輸入值超出 number.MAX_SAFE_INTEGER 的範圍,可能會導致意外結果或錯誤。 在這種情況下,建議使用 BigNumber 類型,特別是對於 uint256 大小的數值輸入值。

tokenInfo 對象必須包含以下內容:

名稱類型描述
fromstring(可選) 發送交易的地址。 如果省略,將由 kip17.options.from 設置。 如果未提供 sendParam 對象中的 fromkip17.options.from,則會發生錯誤。
gasnumber \string
gasPricenumber \string
valuenumber \string \
收費授權boolean(可選,默認為 false)是否使用費用委託交易。 如果省略,將使用 `kip17.options.feeDelegation'。 如果兩者都省略,則不使用收費授權。
feePayerstring(可選)支付交易費的繳費人地址。 當 "feeDelegation "為 "true "時,該值將設置為交易中的 "feePayer "字段。 如果省略,將使用 `kip17.options.feePayer'。 如果兩者都省略,則會出錯。
feeRatiostring(可選)繳費人將承擔的交易費比例。 如果 "feeDelegation "為 "true",且 "feeRatio "設置為有效值,則使用部分費用委託交易。 有效範圍為 1 到 99。 不允許比率為 0 或 100 及以上。 如果省略,將使用 `kip17.options.feeRatio'。

注意 feeDelegationfeePayerfeeRatio從 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 網絡將向發送方收取交易費。

參數

名稱類型描述
tostring批准/禁止轉讓所有者所有代幣的賬戶地址。
approvedBoolean如果 "true",該操作符將被批准。 如果為 false,則不允許使用操作符。
sendParamobject(可選)一個對象,包含用於發送事務的定義參數。 有關 sendParam 的更多信息,請參閱 approve 的參數說明。

返回價值

Promise 返回 object - 包含事務執行結果的收據。 如果您想了解收據對象內部的屬性,請參閱 getTransactionReceipt。 來自 KIP17 實例的收據有一個通過 abi 解析的 "事件 "屬性,而不是 "日誌 "屬性。

示例


// 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.fromkip17Instance.options.from 中給出。 除非同時提供 sendParam.fromkip17Instance.options.from,否則會發生錯誤。 建議儘可能使用 safeTransferFrom 代替此方法。

請注意,發送此交易將向交易發送方收取交易費。

參數

名稱類型描述
fromstring指定代幣所有者或經批准的操作者的地址。
tostring接收代幣的賬戶地址。
tokenIdBigNumber \string \
sendParamobject(可選)一個對象,包含用於發送事務的定義參數。 有關 sendParam 的更多信息,請參閱 approve 的參數說明。

注意* "tokenId "參數接受 "數字 "類型,但如果輸入值超出 number.MAX_SAFE_INTEGER 的範圍,可能會導致意外結果或錯誤。 在這種情況下,建議使用 BigNumber 類型,特別是對於 uint256 大小的數值輸入值。

返回價值

Promise 返回 object - 包含事務執行結果的收據。 如果您想了解收據對象內部的屬性,請參閱 getTransactionReceipt。 來自 KIP17 實例的收據有一個通過 abi 解析的 "事件 "屬性,而不是 "日誌 "屬性。

示例


// 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.fromkip17Instance.options.from 中給出。 除非同時提供 sendParam.fromkip17Instance.options.from,否則會發生錯誤。

如果 to 是合約地址,則必須執行 IKIP17Receiver.onKIP17Received. 否則,轉賬將被撤銷。

請注意,發送此交易將向交易發送方收取交易費。

參數

名稱類型描述
fromstring指定代幣所有者或經批准的操作者的地址。
tostring接收代幣的賬戶地址。
tokenIdBigNumber \string \
dataBuffer \string \
sendParamobject(可選)一個對象,包含用於發送事務的定義參數。 有關 sendParam 的更多信息,請參閱 approve 的參數說明。

注意* "tokenId "參數接受 "數字 "類型,但如果輸入值超出 number.MAX_SAFE_INTEGER 的範圍,可能會導致意外結果或錯誤。 在這種情況下,建議使用 BigNumber 類型,特別是對於 uint256 大小的數值輸入值。

返回價值

Promise 返回 object - 包含事務執行結果的收據。 如果您想了解收據對象內部的屬性,請參閱 getTransactionReceipt。 來自 KIP17 實例的收據有一個通過 abi 解析的 "事件 "屬性,而不是 "日誌 "屬性。

示例


// 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 網絡將向發送者收取交易費。

參數

名稱類型描述
accountstring要添加為礦工的賬戶地址。
sendParamobject(可選)一個對象,包含用於發送事務的定義參數。 有關 sendParam 的更多信息,請參閱 approve 的參數說明。

注意* 如果給出了 sendParam.fromkip17.options.from ,則應是礦工。

返回價值

Promise 返回 object - 包含事務執行結果的收據。 如果您想了解收據對象內部的屬性,請參閱 getTransactionReceipt。 來自 KIP17 實例的收據有一個通過 abi 解析的 "事件 "屬性,而不是 "日誌 "屬性。

示例


// 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 網絡將向發送方收取交易費。

參數

名稱類型描述
sendParamobject(可選)一個對象,包含用於發送事務的定義參數。 有關 sendParam 的更多信息,請參閱 approve 的參數說明。

如果給出了 sendParam.fromkip17.options.from ,則應是具有 MinterRole 的礦工。

返回價值

Promise 返回 object - 包含事務執行結果的收據。 如果您想了解收據對象內部的屬性,請參閱 getTransactionReceipt。 來自 KIP17 實例的收據有一個通過 abi 解析的 "事件 "屬性,而不是 "日誌 "屬性。

示例


// 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 網絡將向發送者收取交易費用。

參數

名稱類型描述
tostring將向其發行新幣的賬戶地址。
tokenIdBigNumber \string \
tokenURIstring要鑄幣的代幣的 uri 字符串。
sendParamobject(可選)一個對象,包含用於發送事務的定義參數。 有關 sendParam 的更多信息,請參閱 approve 的參數說明。

注意* "tokenId "參數接受 "數字 "類型,但如果輸入值超出 number.MAX_SAFE_INTEGER 的範圍,可能會導致意外結果或錯誤。 在這種情況下,建議使用 BigNumber 類型,特別是對於 uint256 大小的數值輸入值。

注意* 如果給出了 sendParam.fromkip17.options.from ,則應是具有 MinterRole 的礦工。

返回價值

Promise 返回 object - 包含事務執行結果的收據。 如果您想了解收據對象內部的屬性,請參閱 getTransactionReceipt。 來自 KIP17 實例的收據有一個通過 abi 解析的 "事件 "屬性,而不是 "日誌 "屬性。

示例


// 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.fromkip17.options.from,就會發生錯誤。

請注意,"銷燬 "方法將向 kaia 網絡提交交易,而 kaia 網絡將向發送者收取交易費。

參數

名稱類型描述
tokenIdBigNumber \string \
sendParamobject(可選)一個對象,包含用於發送事務的定義參數。 有關 sendParam 的更多信息,請參閱 approve 的參數說明。

注意* "tokenId "參數接受 "數字 "類型,但如果輸入值超出 number.MAX_SAFE_INTEGER 的範圍,可能會導致意外結果或錯誤。 在這種情況下,建議使用 BigNumber 類型,特別是對於 uint256 大小的數值輸入值。

返回價值

Promise 返回 object - 包含事務執行結果的收據。 如果您想了解收據對象內部的屬性,請參閱 getTransactionReceipt。 來自 KIP17 實例的收據有一個通過 abi 解析的 "事件 "屬性,而不是 "日誌 "屬性。

示例


// 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 網絡將向發送者收取交易費。

參數

名稱類型描述
sendParamobject(可選)一個對象,包含用於發送事務的定義參數。 有關 sendParam 的更多信息,請參閱 approve 的參數說明。

注意* 如果給出了 sendParam.fromkip17.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 網絡將向發送方收取交易費。

參數

名稱類型描述
sendParamobject(可選)一個對象,包含用於發送事務的定義參數。 有關 sendParam 的更多信息,請參閱 approve 的參數說明。

注意* 如果給出了 sendParam.fromkip17.options.from,則應是具有 PauserRole 的暫停器。

返回價值

Promise 返回 object - 包含事務執行結果的收據。 如果您想了解收據對象內部的屬性,請參閱 getTransactionReceipt。 來自 KIP17 實例的收據有一個通過 abi 解析的 "事件 "屬性,而不是 "日誌 "屬性。

示例


// 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 網絡將向發送者收取交易費。

參數

名稱類型描述
accountstring將成為新暫停者的賬戶地址。
sendParamobject(可選)一個對象,包含用於發送事務的定義參數。 有關 sendParam 的更多信息,請參閱 approve 的參數說明。

注意* 如果給出了 sendParam.fromkip17.options.from,則應是具有 PauserRole 的暫停器。

返回價值

Promise 返回 object - 包含事務執行結果的收據。 如果您想了解收據對象內部的屬性,請參閱 getTransactionReceipt。 來自 KIP17 實例的收據有一個通過 abi 解析的 "事件 "屬性,而不是 "日誌 "屬性。

示例


// 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 網絡將向發送者收取交易費。

參數

名稱類型描述
sendParamobject(可選)一個對象,包含用於發送事務的定義參數。 有關 sendParam 的更多信息,請參閱 approve 的參數說明。

注意* 如果給出了 sendParam.fromkip17.options.from,則應是具有 PauserRole 的暫停器。

返回價值

Promise 返回 object - 包含事務執行結果的收據。 如果您想了解收據對象內部的屬性,請參閱 getTransactionReceipt。 來自 KIP17 實例的收據有一個通過 abi 解析的 "事件 "屬性,而不是 "日誌 "屬性。

示例


// 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)

讓這個頁面變得更好