本頁面使用機器翻譯自英語，可能包含錯誤或不清楚的語言。如需最準確的信息，請參閱英文原文。由於更新頻繁，部分內容可能與英文原文有出入。請加入我們在 Crowdin 上的努力，幫助我們改進本頁面的翻譯。 (Crowdin translation page, Contributing guide)

caver-java （1.5.0 或更高版本）

caver-js "是一個 JavaScript API 庫，允許開發人員使用 HTTP 或 Websocket 連接與 kaia 節點進行交互。它可在 npm 上獲取。

特色

通過 HTTP 和 Websocket 完整實現 kaia 的 JSON-RPC 客戶端 API
支持 kaia 交易、賬戶和賬戶密鑰類型
用於在 kaia 網絡上部署和執行智能合約的 JavaScript 智能合約包
用於管理 kaia 賬戶的內存錢包
支持收費授權
支持 kaia 錢包密鑰格式
RLP 中交易對象的編碼/解碼
簽署交易對象
輕鬆將 web3-js 應用程序移植到 caver-js

caver-js 中的軟件包

以下是 caver-js 中提供的軟件包。

Error Code Improvement

以太坊通過 web3.js 發送的錯誤信息很難找出錯誤發生在哪裡。 caver-js 改進了從 kaia 捕捉錯誤信息的接口。

更多詳情可在交易收據的 txError 值中找到，如下所示：


Error: runtime error occurred in interpreter
 {
  "blockHash": "0xe7ec35c9fff1178d52cee1d46d40627d19f828c4b06ad1a5c3807698b99acb20",
  "blockNumber": 7811,
  "contractAddress": null,
  "from": "0xa8a2d37727197cc0eb827f8c5a3a3aceb26cf59e",
  "gasUsed": 9900000000,
  "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
  "status": false,
  "to": "0xf8425b0f65147969621f9390ca06139c7b439497",
  "transactionHash": "0x85ce2b307899c90144442d9b3236827ac57375c522be2435093aebfd920b8c58",
  "transactionIndex": 0,
  "txError": "0x2",
  "events": {}
}

向 kaia 發送交易時的注意事項

自啟用 KIP-71的岩漿硬分叉後，Kaia 制定了新的gas價格政策。

因此，在發送交易時，您需要根據硬分叉是否適用來設置不同的 "gasPrice "邏輯。

在 Magma 硬分叉之前，kaia 上的交易一直採用 "固定gas價格"。因此，以任何其他價格提交給網絡的交易都會被拒絕。如果您在簽署或提交交易時未定義 "gasPrice"，caver-js 將使用 caver.rpc.klay.getGasPrice RPC 調用來設置gas價格。

Magma硬分叉後，kaia 採用了 "動態gas費用定價機制"。交易的gas價格應高於 kaia 網絡的基本費用。如果在簽署或提交交易時未定義 "gasPrice"，caver-js 會使用 caver.rpc.klay.getGasPrice設置交易的 "gasPrice "字段。

如何設置gas價格字段

caver-js 提供了多種設置 gasPrice 的方法。使用 caver-js 時設置 "gasPrice "字段的方法如下。無論硬分叉與否，這裡介紹的方法都可以使用。

不要定義 "gasPrice "字段

如果創建實例時未定義 gasPrice 字段，則在調用 tx.sign 或 tx.signAsFeePayer 簽署交易時會自動設置 gasPrice 字段。


const tx = caver.transaction.valueTransfer.create({ from, to, value, gas })
await tx.sign(from, tx) // Before signing, gasPrice is set inside `tx.sign`.

使用 `tx.fillTransaction` 方法

您可以使用 tx.fillTransaction，該函數會在省略事務的可選字段時，為其填充適當的值。


const tx = caver.transaction.valueTransfer.create({ from, to, value, gas })
await tx.fillTransaction() // Fill the optional tx fields.

使用 `tx.suggestGasPrice` 方法

您可以使用 tx.suggestGasPrice 的結果設置 gasPrice ，該結果會返回推薦的gas價格。


const tx = caver.transaction.valueTransfer.create({ from, to, value, gas })
tx.gasPrice = await tx.suggestGasPrice()

有關gas價格的更多信息，請參閱 Gas and Unit Price Overview 網絡中使用的gas價格可通過 caver.rpc.klay.getGasPrice 獲得。

鏈接

caver-js GitHub repository
caver-js on npm

特色​

caver-js 中的軟件包​

Error Code Improvement ​

向 kaia 發送交易時的注意事項​

如何設置gas價格字段​

不要定義 "gasPrice "字段​

使用 tx.fillTransaction 方法​

使用 tx.suggestGasPrice 方法​

鏈接​

特色