API caver-js API liên quan đến việc quản lý tài khoản.
caver.klay.tài khoảns chứa các hàm để tạo tài khoản Klaytn và ký các giao dịch cũng như dữ liệu.
tạo
caver.klay.tài khoảns.create([entropy])
Tạo một đối tượng tài khoản với khóa riêng tư và khóa công khai.
Tham số
Tên
type
Mô tả
độ nhiễu loạn
Chuỗi
(tùy chọn) Một chuỗi ngẫu nhiên để tăng độ nhiễu loạn. Nếu không có chuỗi nào được cung cấp, một chuỗi ngẫu nhiên sẽ được tạo bằng cách sử dụng randomHex.
Giá trị trả về
Đối tượng - Đối tượng tài khoản có cấu trúc như sau:
Tên
Loại
Mô tả
address
Chuỗi
Địa chỉ tài khoản.
privateKey
Chuỗi
Khóa riêng tư của tài khoản. Khóa này tuyệt đối không được chia sẻ hoặc lưu trữ không được mã hóa trong bộ nhớ cục bộ! Ngoài ra, hãy đảm bảo vô hiệu hóa bộ nhớ sau khi sử dụng.
Tạo một phiên bản Tài khoản với AccountKey đã cho. Tài khoản dùng để quản lý địa chỉ và AccountKey của tài khoản.
LƯU Ý Đây chỉ là một cấu trúc dữ liệu được sử dụng trong caver-js. Phương thức này không tạo hoặc cập nhật tài khoản trong mạng lưới Klaytn. LƯU Ýcaver.klay.tài khoảns.createWithAccountKey được hỗ trợ kể từ caver-js phiên bản v1.2.0.
Tham số
Tên
type
Mô tả
address
Chuỗi
Địa chỉ của tài khoản.
tài khoảnKey
Chuỗi | Mảng | Đối tượng
Phiên bản AccountKey (AccountKeyPublic, AccountKeyMultiSig hoặc AccountKeyRoleBased) hoặc cấu trúc dữ liệu chứa thông tin khóa (chuỗi khóa riêng tư, mảng chuỗi khóa riêng tư hoặc một đối tượng xác định khóa cho từng vai trò).
Giá trị trả về
Đối tượng - Một phiên bản Tài khoản được trả về với các thuộc tính sau:
Tên
Loại
Mô tả
address
Chuỗi
Địa chỉ của tài khoản.
privateKey
Chuỗi
Chuỗi khóa mặc định của tài khoảnKey mà tài khoản có. Thuộc tính này được để lại cho khả năng tương thích ngược. privateKey chỉ đại diện cho khóa mặc định của tài khoảnKey, do đó, bạn không nên sử dụng privateKey để ký hoặc gửi giao dịch. Bạn nên sử dụng transactionKey, updateKey hoặc feePayerKey trong ngữ cảnh.
tài khoảnKeyType
Chuỗi
Loại tài tài khoảnKey tài khoản có. Đây có thể là AccountKeyPublic, AccountKeyMultiSig hoặc AccountKeyRoleBased
tài khoảnKey
Đối tượng
Khóa của tài khoản. Đây có thể là AccountKeyPublic, AccountKeyMultiSig hoặc AccountKeyRoleBased.
khóa
Chuỗi | Mảng | Đối tượng
Tất cả các khóa bên trong tài khoảnKey mà tài khoản có. Đối với AccountKeyPublic, đây là một chuỗi khóa riêng tư; đối với AccountKeyMultiSig, điều này trả về một mảng chứa tất cả các chuỗi khóa riêng tư. Trong trường hợp AccountKeyRoleBased, một đối tượng có các khóa được liên kết với từng vai trò sẽ được trả về.
transactionKey
Chuỗi | Mảng
Khóa được sử dụng cho [RoleTransaction](../../../../../klaytn/design/tài khoảns.md#roles). AccountKeyPublic hoặc AccountKeyMultiSig không bị ràng buộc với bất kỳ vai trò nào, do đó, transactionKey giữ giá trị giống như các khóa. các khóa.
updateKey
Chuỗi | Mảng
Khóa được sử dụng cho [RoleAccountUpdate](../../../../../klaytn/design/tài khoảns.md#roles). AccountKeyPublic hoặc AccountKeyMultiSig không bị ràng buộc với bất kỳ vai trò nào, vì vậy updateKey giữ giá trị giống như các khóa.khóa.
feePayerKey
Chuỗi | Mảng
Khóa được sử dụng cho [RoleFeePayer](../../../../../klaytn/design/tài khoảns.md#roles). AccountKeyPublic hoặc AccountKeyMultiSig không bị ràng buộc với bất kỳ vai trò nào, do đó, feePayerKey giữ cùng một giá trị như các khóa.
Tạo phiên bản của AccountKeyPublic, AccountKeyMultiSig hoặc AccountKeyRoleBased tùy thuộc vào loại tham số.
AccountKey là cấu trúc dữ liệu dùng để quản lý khóa trong caver-js. Sử dụng AccountKeyPublic nếu bạn muốn sử dụng một khóa riêng tư, AccountKeyMultiSig nếu bạn muốn sử dụng nhiều khóa riêng tư hoặc AccountKeyRoleBased nếu bạn muốn sử dụng một khóa khác cho từng vai trò.
LƯU Ýcaver.klay.tài khoảns.createAccountKey được hỗ trợ kể từ caver-js v1.2.0.
Tham số
Tên
Loại
Mô tả
khóa
Chuỗi | Mảng | Đối tượng
Khóa để tạo AccountKey. Nếu key là một chuỗi khóa riêng tư, thì một phiên bản AccountKeyPublic sẽ được tạo. Nếu key là một mảng chứa nhiều chuỗi khóa riêng tư, thì một phiên bản AccountKeyMultiSig sẽ được tạo. Nếu key là một đối tượng xác định khóa (chuỗi khóa riêng tư hoặc một mảng các chuỗi khóa riêng tư) cho mỗi vai trò, thì một phiên bản AccountKeyRoleBased sẽ được tạo. Phiên bản AccountKeyRoleBased có thể có AccountKeyPublic hoặc AccountKeyMultiSig cho mỗi vai trò.
Giá trị trả về
Đối tượng - Một phiên bản AccountKeyPublic, AccountKeyMultiSig hoặc AccountKeyRoleBased được trả về với các thuộc tính sau:
Tên
Loại
Mô tả
loại
Chuỗi
Loại phiên bản AccountKey.
defaultKey
Chuỗi
Khóa riêng tư mặc định của AccountKey. Khóa riêng tư mặc định đại diện cho một chuỗi khóa riêng tư được xác định cho AccountKeyPublic và một chuỗi khóa riêng tư trong chỉ mục thứ 0 của mảng nếu là AccountKeyMultiSig. Đối với AccountKeyRoleBased, khóa này đại diện cho khóa mặc định của AccountKey được tìm thấy đầu tiên, trong đó AccountKey được tìm kiếm theo thứ tự sau: transactionkey, updateKey, feePayerKey.
khóa
Chuỗi | Mảng | Đối tượng
Tất cả các khóa riêng tư được xác định bên trong phiên bản AccountKey. Đối với AccountKeyPublic, đây là một chuỗi khóa riêng tư; đối với AccountKeyMultiSig, điều này trả về một mảng chứa tất cả các chuỗi khóa riêng tư. Trong trường hợp AccountKeyRoleBased, một đối tượng có các khóa được liên kết với từng vai trò sẽ được trả về.
transactionKey
Chuỗi | Mảng
Khóa được sử dụng cho [RoleTransaction](../../../../../klaytn/design/tài khoảns.md#roles). AccountKeyPublic hoặc AccountKeyMultiSig không bị ràng buộc với bất kỳ vai trò nào, do đó, transactionKey giữ giá trị giống như các khóa. các khóa.
updateKey
Chuỗi | Mảng
Khóa được sử dụng cho [RoleAccountUpdate](../../../../../klaytn/design/tài khoảns.md#roles). AccountKeyPublic hoặc AccountKeyMultiSig không bị ràng buộc với bất kỳ vai trò nào, vì vậy updateKey giữ giá trị giống như các khóa.khóa.
feePayerKey
Chuỗi | Mảng
Khóa được sử dụng cho [RoleFeePayer](../../../../../klaytn/design/tài khoảns.md#roles). AccountKeyPublic hoặc AccountKeyMultiSig không bị ràng buộc với bất kỳ vai trò nào, do đó, feePayerKey giữ cùng một giá trị như các khóa.
Ví dụ
// Tạo một AccountKeyPublic>caver.klay.tài khoảns.createAccountKey('0x{private key}')AccountKeyPublic { _key:'0x{private key}'}// Tạo một AccountKeyMultiSig>caver.klay.tài khoảns.createAccountKey(['0x{private key}','0x{private key}'])AccountKeyMultiSig { _keys: [ '0x{private key}','0x{private key}' ]}// Tạo một AccountKeyRoleBased>caver.klay.tài khoảns.createAccountKey({ transactionKey:'0x{private key}', updateKey: ['0x{private key}','0x{private key}'], feePayerKey:'0x{private key}'})AccountKeyRoleBased { _transactionKey: AccountKeyPublic { _key:'0x{private key}' }, _updateKey: AccountKeyMultiSig { _keys: ['0x{private key}','0x{private key}' ] }, _feePayerKey: AccountKeyPublic { _key:'0x{private key}' }}
createAccountKeyPublic
caver.klay.tài khoảns.createAccountKeyPublic(key)
Tạo phiên bản của AccountKeyPublic với chuỗi khóa riêng tư đã cho.
LƯU Ýcaver.klay.tài khoảns.createAccountKeyPublic được hỗ trợ kể từ caver-js phiên bản v1.2.0.
Tham số
Tên
type
Mô tả
khóa
Chuỗi
Một chuỗi khóa riêng tư dùng để tạo AccountKeyPublic.
Giá trị trả về
Đối tượng - Phiên bản AccountKeyPublic, xem [caver.klay.tài khoảns.createAccountKey](#createtài khoảnkey).
Hàm này chuyển đổi khóa riêng tư của AccountKey thành khóa công khai.
NOTEcaver.klay.tài khoảns.tài khoảnKeyToPublicKey được hỗ trợ kể từ caver-js v1.2.0.
Tham số
Tên
Loại
Mô tả
tài khoảnKey
Chuỗi | Mảng | Đối tượng
Phiên bản AccountKey (AccountKeyPublic, AccountKeyMultiSig hoặc AccountKeyRoleBased) hoặc cấu trúc dữ liệu chứa thông tin khóa (chuỗi khóa riêng tư, mảng chuỗi khóa riêng tư hoặc một đối tượng xác định khóa cho từng vai trò).
Giá trị trả về
Loại
Mô tả
Chuỗi | Mảng | Đối tượng
Nếu tham số là một phiên bản AccountKeyPublic hoặc một chuỗi khóa riêng tư, thì một chuỗi khóa công khai sẽ được trả về. Nếu tham số là một phiên bản AccountKeyMultiSig hoặc một mảng các chuỗi khóa riêng tư, thì một mảng các chuỗi khóa công khai sẽ được trả về. Nếu tham số là một phiên bản AccountKeyRoleBased hoặc một đối tượng xác định khóa (chuỗi khóa riêng tư hoặc một mảng các chuỗi khóa riêng tư) đối với mỗi vai trò, thì một đối tượng có vai trò và khóa công khai (chuỗi khóa công khai hoặc một mảng các chuỗi khóa công khai) được trả về.
Ví dụ
// Chuyển đổi chuỗi khóa riêng tư>caver.klay.tài khoảns.tài khoảnKeyToPublicKey('0x{private key}')'0x67f20d1198abcdc036a4d8f3ea0cf837527716c90f71d0b0410dfe3e1b405eded9ea818eedd5e8ad79658b2cdf4862ab0956a6f7fd0a4886afe6110b2e9803a4'
// Chuyển đổi một mảng các chuỗi khóa riêng tư>caver.klay.tài khoảns.tài khoảnKeyToPublicKey(['0x{private key}','0x{private key}'])[ '0x67f20d1198abcdc036a4d8f3ea0cf837527716c90f71d0b0410dfe3e1b405eded9ea818eedd5e8ad79658b2cdf4862ab0956a6f7fd0a4886afe6110b2e9803a4',
'0x7c5415f99628618b3fe78e14606c83a22488769b3361e3758c7c98a204a23b615cf07af65490895d70a7b7e7e885fc2f597d65ea69ed586c7ae7cb0241656036'
]// Chuyển đổi khóa theo vai trò> caver.klay.tài khoảns.tài khoảnKeyToPublicKey({transactionKey: ['0x{private key}', '0x{private key}'], updateKey: '0x{private key}', feePayerKey: ['0x{private key}', '0x{private key}']})
{ transactionKey: [ '0x67f20d1198abcdc036a4d8f3ea0cf837527716c90f71d0b0410dfe3e1b405eded9ea818eedd5e8ad79658b2cdf4862ab0956a6f7fd0a4886afe6110b2e9803a4',
'0x7c5415f99628618b3fe78e14606c83a22488769b3361e3758c7c98a204a23b615cf07af65490895d70a7b7e7e885fc2f597d65ea69ed586c7ae7cb0241656036'
], updateKey: '0x21aa42e0232e6c7607a0028bcbd690400b92574c44b17af8b036f3f4f01b0586f90578976a040debf6aecef4a5d00b5315b8c82e999ed8e5fbacd5fcbee82080',
feePayerKey: [ '0xb82bb74e902b1fa3594c7cc8bd33a727eb1c85a9bfc991327a0215fc413eafe0b3723cc7f3c6e79981b409e82b8bf7033fed2d2878c26502bea64f84d592b167',
'0x39acd887f32ccecd1b13c890854d2dfd0016f0be477155d81a848e971ff59412b0e4c0b5bfc1fd548b971f98cd9ef19367309d0475033fda3c8028ba9df27734'
]}
Tạo phiên bản của AccountForUpdate. AccountForUpdate chứa địa chỉ của tài khoản và khóa công khai mới để cập nhật.
AccountForUpdate có thể được sử dụng trong đối tượng giao dịch cập nhật tài khoản (ACCOUNT_UPDATE, FEE_DELEGATED_ACCOUNT_UPDATE hoặc FEE_DELEGATED_ACCOUNT_UPDATE_WITH_RATIO) dưới dạng khóa. Nếu bạn muốn biết cách sử dụng AccountForUpdate trong giao dịch, hãy xem [Cập nhật tài khoản với AccountForUpdate ](../getting-started_1.4.1.md#tài khoản-update-with-tài khoảnforupdate).
Tham số tài khoảnKey của caver.klay.tài khoảns.createAccountForUpdate phải là khóa riêng tư.
Bạn có thể tạo phiên bản AccountForUpdate bằng khóa công khai với [caver.klay.tài khoảns.createAccountForUpdateWithPublicKey](#createtài khoảnforupdatewithpublickey).
Bạn cũng có thể dùng [caver.klay.tài khoảns.createAccountForUpdateWithLegacyKey](#createtài khoảnforupdatewithlegacykey) để tạo phiên bản AccountForUpdate dùng để cập nhật lên [AccountKeyLegacy](../../../../../klaytn/design/tài khoảns.md#tài khoảnkeylegacy) và [caver.klay.tài khoảns.createAccountForUpdateWithFailKey](#createtài khoảnforupdatewithfailkey) để tạo phiên bản AccountForUpdate dùng để cập nhật lên [AccountKeyFail](../../../../../klaytn/design/tài khoảns.md#tài khoảnkeyfail).
LƯU Ýcaver.klay.tài khoảns.createAccountForUpdate được hỗ trợ kể từ caver-js phiên bản v1.2.0.
Tham số
Tên
type
Mô tả
address
Chuỗi
Địa chỉ của tài khoản.
tài khoảnKey
Chuỗi | Mảng | Đối tượng
Phiên bản AccountKey (AccountKeyPublic, AccountKeyMultiSig hoặc AccountKeyRoleBased) hoặc thông tin khóa tương đương (chuỗi khóa riêng tư, mảng các chuỗi khóa riêng tư hoặc đối tượng xác định (các) khóa với (các) vai trò). Nếu tài khoảnKey không phải là một phiên bản AccountKey, thì phương pháp này sẽ gọi nội bộ [caver.klay.tài khoảns.createAccountKey](#createtài khoảnkey) để tạo một phiên bản AccountKey từ thông tin khóa đã cho.
tùy chọn
Đối tượng
Một đối tượng tùy chọn chứa ngưỡng và trọng số. Điều này là bắt buộc khi sử dụng AccountKeyMultiSig. Cách sử dụng được minh họa trong ví dụ dưới đây.
Giá trị trả về
Đối tượng - Một phiên bản AccountForUpdate được trả về với các thuộc tính sau:
Tên
type
Mô tả
address
Chuỗi
Địa chỉ của tài khoản sẽ được cập nhật.
keyForUpdate
Đối tượng
Một đối tượng chứa khóa công khai mới được lấy từ tài khoảnKey đã cho.
Ví dụ
// Tạo AccountForUpdate cho AccountKeyPublic>caver.klay.tài khoảns.createAccountForUpdate('0x5B4EF8e2417DdE1b9B80BcfC35d1bfeF3D7234ef','0x{private key}')AccountForUpdate { address:'0x5B4EF8e2417DdE1b9B80BcfC35d1bfeF3D7234ef', keyForUpdate: { publicKey: '0x24c32ee4f908ceed89e7501de2980fcb1d2add69080d3921f86c49de863eb2d507e24d9aaf91328b7f7cef2a94b538cb33b3f8cdd64925855ce0a4bf6e11f3db'
}}// Tạo AccountForUpdate cho AccountKeyMultiSig với đối tượng tùy chọn> caver.klay.tài khoảns.createAccountForUpdate('0x5B4EF8e2417DdE1b9B80BcfC35d1bfeF3D7234ef', ['0x{private key}', '0x{private key}'], { threshold: 2, weight: [1,1] })
AccountForUpdate { address:'0x5B4EF8e2417DdE1b9B80BcfC35d1bfeF3D7234ef', keyForUpdate: { multisig: { threshold:2, keys: [ { weight:1, publicKey: '0xc89f551ce9c569cf978f4f64833e447f177a83eda4f1883d770360ab35002dbdeb2d502cd33217238add013ea1c4ff5055ceda46473569824e336d0d64e9eeb2'
}, { weight:1, publicKey: '0xab0837fa3d61cf33dc4f3af4aca692d8c939566e1abbca0036fa3b29cd55b38a387f73baf59510d96680062bd129dd2bb8dcbb5ea5ed16c881f83a3251f73600'
} ] } }}// Tạo AccountForUpdate cho AccountKeyRoleBased với đối tượng tùy chọn> caver.klay.tài khoảns.createAccountForUpdate('0x5B4EF8e2417DdE1b9B80BcfC35d1bfeF3D7234ef', { transactionKey: '0x{private key}', updateKey: ['0x{private key}', '0x{private key}'], feePayerKey: '0x{private key}' }, { updateKey: { threshold: 2, weight: [1,1] } })
AccountForUpdate { address:'0x5B4EF8e2417DdE1b9B80BcfC35d1bfeF3D7234ef', keyForUpdate: { roleTransactionKey: { publicKey: '0x2b4a1d4ca1ee828f17e8c4c0ac0c0c46cf08f4b27fafc01e4b3481a4fe0891cacf315ed10b1df85bfd6797ea6c5ebafac437a7564eff355b11ad1e3d6e6c43a7'
}, roleAccountUpdateKey: { multisig: { threshold:2, keys: [ { weight:1, publicKey: '0x26156615c8e503d96cd332a2fba6aab88b6156b983c89f586bcfc0443c0a7f2372d892d73c66d30f726f8269c75920a082eb2e57f6662d855389bb922ee263f3'
}, { weight:1, publicKey: '0xafc139d2bcace02fa3d4b12926f976cf672f35a6ea2bc0f7e2e6d2ada0dd28f672acb8dcaedc694d6134a2f6c4aae472c9d67d30f760e16e742e01758c4daf83'
} ] } }, roleFeePayerKey: { publicKey: '0xe55d39e147a0d5542d4bb965aeaa01e918c81a332ce47e0d3173179fe5b68c8c9264bec516d50bea0a7da7c3d8f98e124761a9b27434221d138ff8e22d932a0a'
} }}// Tạo AccountForUpdate cho AccountKeyRoleBased với khóa kế thừa hoặc khóa lỗi// Khi cập nhật khóa được sử dụng cho một vai trò cụ thể trong AccountKeyRoleBased thành AccountKeyLegacy hoặc AccountKeyFailKey, hãy xác định vai trò cần cập nhật như sau.
> caver.klay.tài khoảns.createAccountForUpdate('0x5B4EF8e2417DdE1b9B80BcfC35d1bfeF3D7234ef', { transactionKey: 'legacyKey', updateKey: 'failKey' })
AccountForUpdate { address:'0x5B4EF8e2417DdE1b9B80BcfC35d1bfeF3D7234ef', keyForUpdate: { roleTransactionKey: { legacyKey:true }, roleAccountUpdateKey: { failKey:true } }}
Tạo một phiên bản AccountForUpdate bằng khóa công khai của khóa mới cần cập nhật.
AccountForUpdate có thể được sử dụng trong đối tượng giao dịch cập nhật tài khoản (ACCOUNT_UPDATE, FEE_DELEGATED_ACCOUNT_UPDATE hoặc FEE_DELEGATED_ACCOUNT_UPDATE_WITH_RATIO) dưới dạng khóa. Nếu bạn muốn biết cách sử dụng AccountForUpdate trong giao dịch, hãy xem [Cập nhật tài khoản với AccountForUpdate ](../getting-started_1.4.1.md#tài khoản-update-with-tài khoảnforupdate).
NOTEcaver.klay.tài khoảns.createAccountForUpdateWithPublicKey được hỗ trợ kể từ caver-js v1.2.0.
Tham số
Tên
Loại
Mô tả
address
Chuỗi
Địa chỉ của tài khoản.
keyForUpdate
Chuỗi | Mảng | Đối tượng
Khóa công khai của khóa mới cần cập nhật. Giá trị này là một chuỗi khóa công khai khi khóa là AccountKeyPublic, một mảng chuỗi khóa công khai khi AccountKeyMultiSig, một đối tượng khi khóa là AccountKeyRoleBased.
tùy chọn
Đối tượng
Một đối tượng tùy chọn chứa ngưỡng và trọng số. Điều này là bắt buộc khi sử dụng AccountKeyMultiSig. Nếu bạn sử dụng AccountkeyMultiSig làm một trong các khóa trong AccountKeyRoleBased, hãy chỉ định vai trò của ngưỡng và trọng số. Cách sử dụng được minh họa trong ví dụ dưới đây.
Giá trị trả về
Đối tượng - Phiên bản AccountForUpdate, xem [caver.klay.tài khoảns.createAccountForUpdate](#createtài khoảnforupdate).
Tạo một phiên bản AccountForUpdate để cập nhật khóa của tài khoản bằng [AccountKeyLegacy](../../../../../klaytn/design/tài khoảns.md#tài khoảnkeylegacy). Đảm bảo rằng bạn có khóa riêng tư khớp với địa chỉ tài khoản của mình trước khi cập nhật lên AccountKeyLegacy.
AccountForUpdate có thể được sử dụng trong đối tượng giao dịch cập nhật tài khoản (ACCOUNT_UPDATE, FEE_DELEGATED_ACCOUNT_UPDATE hoặc FEE_DELEGATED_ACCOUNT_UPDATE_WITH_RATIO) dưới dạng khóa. Nếu bạn muốn biết cách sử dụng AccountForUpdate trong giao dịch, hãy xem [Cập nhật tài khoản với AccountForUpdate ](../getting-started_1.4.1.md#tài khoản-update-with-tài khoảnforupdate).
Lưu ýcaver.klay.tài khoảns.createAccountForUpdateWithLegacyKey được hỗ trợ kể từ caver-js v1.2.0.
Tham số
Tên
Loại
Mô tả
address
Chuỗi
Địa chỉ của tài khoản.
Giá trị trả về
Đối tượng - Phiên bản AccountForUpdate, xem [caver.klay.tài khoảns.createAccountForUpdate](#createtài khoảnforupdate).
Ví dụ
// Tạo AccountForUpdate cho AccountKeyLegacy>caver.klay.tài khoảns.createAccountForUpdateWithLegacyKey('0x5B4EF8e2417DdE1b9B80BcfC35d1bfeF3D7234ef')AccountForUpdate { address:'0x5B4EF8e2417DdE1b9B80BcfC35d1bfeF3D7234ef', keyForUpdate: { legacyKey:true } }
Tạo một phiên bản AccountForUpdate để cập nhật khóa của tài khoản bằng [AccountKeyFail](../../../../../klaytn/design/tài khoảns.md#tài khoảnkeyfail). Các giao dịch được gửi bởi một tài khoản có AccountKeyFail luôn không thành công trong quá trình xác thực.
AccountForUpdate có thể được sử dụng trong đối tượng giao dịch cập nhật tài khoản (ACCOUNT_UPDATE, FEE_DELEGATED_ACCOUNT_UPDATE hoặc FEE_DELEGATED_ACCOUNT_UPDATE_WITH_RATIO) dưới dạng khóa. Nếu bạn muốn biết cách sử dụng AccountForUpdate trong giao dịch, hãy xem [Cập nhật tài khoản với AccountForUpdate ](../getting-started_1.4.1.md#tài khoản-update-with-tài khoảnforupdate).
LƯU Ýcaver.klay.tài khoảns.createAccountForUpdateWithFailKey được hỗ trợ kể từ caver-js v1.2.0.
Tham số
Tên
Loại
Mô tả
address
Chuỗi
Địa chỉ của tài khoản.
Giá trị trả về
Đối tượng - Phiên bản AccountForUpdate, xem [caver.klay.tài khoảns.createAccountForUpdate](#createtài khoảnforupdate).
Ví dụ
// Tạo AccountForUpdate cho AccountKeyFail>caver.klay.tài khoảns.createAccountForUpdateWithFailKey('0x5B4EF8e2417DdE1b9B80BcfC35d1bfeF3D7234ef')AccountForUpdate { address:'0x5B4EF8e2417DdE1b9B80BcfC35d1bfeF3D7234ef', keyForUpdate: { failKey:true } }
Ký một giao dịch Klaytn bằng một khóa riêng tư đã cho.
Vì caver-js v1.2.0 nên phương pháp này lấy một giao dịch được mã hóa RLP làm một đầu vào cũng như một đối tượng giao dịch thuần. Xem caver.klay.sendTransaction để biết các loại đối tượng giao dịch khác nhau. Về cơ bản, phương pháp này ký với tư cách là người gửi. Nếu bạn muốn ký với tư cách là người trả phí, bạn nên sử dụng caver.klay.tài khoảns.feePayerSignTransaction. Tuy nhiên, người trả phí vẫn có thể ký bằng phương pháp này bằng cách chuyển một đối tượng, {senderRawTransaction: rawTransaction, feePayer: feePayerAddress}, dưới dạng tx. senderRawTransaction phải là giao dịch loại FEE_DELEGATED_.
Ngoài ra, vì caver-js v1.2.0, signTransaction giữ chữ ký/feePayerSignatures hiện có trong giao dịch đầu vào và nối (các) chữ ký của người ký vào đó.
Đối tượng giao dịch hoặc chuỗi giao dịch được mã hóa RLP (rawTransaction). Các thuộc tính của một đối tượng giao dịch khác nhau tùy thuộc vào loại giao dịch. Để biết mô tả về từng loại giao dịch, hãy xem caver.klay.sendTransaction.
privateKey
Chuỗi | Mảng
(tùy chọn) Khóa riêng tư dùng để ký.
callback
Hàm
(tùy chọn) Hàm callback tùy chọn trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.
LƯU Ý Tham số privateKey đã được thay đổi thành tham số tùy chọn kể từ caver-js v1.2.0-rc.3. Ngoài ra, tham số privateKey hỗ trợ mảng của các chuỗi khóa riêng tư kể từ caver-js v1.2.0-rc.3. Nếu bạn không chuyển khóa riêng tư, tài khoản từ hoặc feePayer phải tồn tại trong caver.klay.tài khoảns.wallet để ký giao dịch. Nếu một mảng privateKeys được cung cấp, thì giao dịch được ký bằng tất cả các khóa bên trong mảng.
LƯU Ý Tham số tx chấp nhận giao dịch được mã hóa RLP kể từ caver-js v1.2.0.
Giá trị trả về
Promise trả về Đối tượng: Giao dịch đã ký được mã hóa RLP. Các thuộc tính đối tượng như sau:
Tên
Loại
Mô tả
messageHash
Chuỗi
Hàm băm của thông báo đã cho.
r
Chuỗi
Chữ ký ECDSA r.
s
Chuỗi
Chữ ký ECDSA s.
v
Chuỗi
Mã khôi phục ECDSA.
rawTransaction
Chuỗi
Giao dịch được mã hóa RLP, sẵn sàng gửi bằng cách sử dụng caver.klay.sendSignedTransaction.
txHash
Chuỗi 32 byte
Hàm băm của giao dịch.
senderTxHash
Chuỗi 32 byte
Hàm băm của một giao dịch chỉ được người gửi ký. Xem SenderTxHash
chữ ký
Mảng
(tùy chọn) Một mảng (các) chữ ký của người gửi.
feePayerSignatures
Mảng
(tùy chọn) Một mảng (các) chữ ký của người trả phí.
LƯU Ý Các thuộc tính signature và feePayerSignatures đã được thêm từ caver-js v1.2.0-rc.3. Nếu người gửi ký giao dịch, mảng chữ ký sẽ được trả về trong signatures. Nếu người trả phí ký, mảng chữ ký sẽ được trả về trong feePayerSignatures.
LƯU ÝtxHash và senderTxHash trong đối tượng kết quả có thể không phải là giá trị cuối cùng. Nếu chữ ký của người gửi khác được thêm vào, txHash và người gửiTxHash sẽ thay đổi. Nếu chữ ký của người trả phí được thêm vào, txHash sẽ thay đổi.