KeyringContainer là lớp quản lý các đối tượng SingleKeyring, MultipleKeyring và RoleBasedKeyring. Khi Caver được khởi tạo, nó sẽ tạo một đối tượng KeyringContainer trong caver.wallet. Bạn có thể lưu trữ và quản lý các đối tượng keyring trong ví trong bộ nhớ thông qua caver.wallet.
(tùy chọn) Một chuỗi ngẫu nhiên để tăng độ nhiễu loạn.
Giá trị trả về
Loại
Mô tả
Mảng
Một mảng chứa các địa chỉ được tạo.
Ví dụ
// tạo mà không cần entropy>caver.wallet.generate(3)['0xb4b0c3781082cf818bfaf5adfc73fdf59d92c1cd','0x9957dfd92e4b70f91131c573293343bc5f21f215','0xed2fe179c18fa528da2392532998560bd1008511']// tạo với entropy>caver.wallet.generate(3,caver.utils.randomHex(32))['0xb4b0c3781082cf818bfaf5adfc73fdf59d92c1cd','0x9957dfd92e4b70f91131c573293343bc5f21f215','0xed2fe179c18fa528da2392532998560bd1008511']
caver.wallet.newKeyring
caver.wallet.newKeyring(address, key)
Tạo một đối tượng keyring với các tham số đã cho và thêm nó vào caver.wallet.
Nếu key là một chuỗi khóa riêng tư thì đối tượng SingleKeyring sử dụng một khóa riêng tư sẽ được tạo. Nếu key là một mảng chứa các chuỗi khóa riêng tư thì một đối tượng MultipleKeyring sử dụng nhiều khóa riêng tư sẽ được tạo. Nếu key là một mảng 2D trong đó mỗi phần tử chứa (các) khóa riêng được sử dụng cho mỗi vai trò thì một đối tượng RoleBasedKeyring sẽ được tạo. Keyring đã tạo sẽ được thêm vào caver.wallet.
// Tạo một đối tượng SingleKeyring và thêm vào caver.wallet>caver.wallet.newKeyring('0x{address in hex}','0x{private key}')SingleKeyring { _address:'0x386a4bb40abbfaa59cecdc3ced202475895fd569', _key: PrivateKey { _privateKey:'0x{private key}' }}// Tạo một đối tượng MultipleKeyring và thêm vào caver.wallet>caver.wallet.newKeyring('0x{address in hex}', ['0x{private key1}','0x{private key2}'])MultipleKeyring { _address:'0x17e7531b40ad5d7b5fa7b4ec78df64ce1cb36d24', _keys: [ PrivateKey { _privateKey:'0x{private key1}' }, PrivateKey { _privateKey:'0x{private key2}' } ]}// Tạo một đối tượng RoleBasedKeyring và thêm vào caver.wallet>constroleBasedKeys= [ ['0x{private key1}','0x{private key2}'], ['0x{private key3}','0x{private key4}'], ['0x{private key5}','0x{private key6}'],]>caver.wallet.newKeyring('0x{address in hex}', roleBasedKeys)RoleBasedKeyring { _address:'0xe7e9184c125020af5d34eab7848bab799a1dcba9', _keys: [ [ PrivateKey { _privateKey:'0x{private key1}' }, PrivateKey { _privateKey:'0x{private key2}' } ], [ PrivateKey { _privateKey:'0x{private key3}' }, PrivateKey { _privateKey:'0x{private key4}' } ], [ PrivateKey { _privateKey:'0x{private key5}' }, PrivateKey { _privateKey:'0x{private key6}' } ] ]}
caver.wallet.updateKeyring
caver.wallet.updateKeyring(keyring)
Cập nhật keyring bên trong caver.wallet. Khi đối tượng keyring mới (SingleKeyring, MultipleKeyring hoặc RoleBasedKeyring) được thông qua dưới dạng tham số thì keyring hiện tại được lưu trữ trong caver.wallet khớp với thuộc tính address của đối tượng keyring đã cho sẽ được tìm thấy và thay thế bằng đối tượng đã cho. Thông báo lỗi khi không tìm thấy keyring phù hợp.
Thêm đối tượng keyring vào caver.wallet. Nếu keyring đã cho mới có cùng địa chỉ với một trong các keyring đã tồn tại trong caver.wallet thì sẽ trả về thông báo lỗi. Trong trường hợp này, hãy sử dụng updateKeyring để cập nhật keyring hiện có trong caver.wallet.
caver.wallet.signMessage(address, message, role [, index])
Ký tin nhắn bằng tiền tố dành riêng cho Klaytn bằng cách sử dụng keyring được lưu trữ trong caver.wallet. Thao tác này tính toán chữ ký dành riêng cho Klaytn bằng hàm:
sign(keccak256("\x19Klaytn Signed Message:\n" + len(message) + message)))
Nếu người dùng chưa cung cấp tham số chỉ mục, caver.wallet.signMessage sẽ ký tin nhắn bằng cách sử dụng tất cả các khóa riêng tư mà vai trò này sử dụng. Nếu tham số chỉ mục được cung cấp, caver.wallet.signMessage sẽ ký tin nhắn chỉ bằng một khóa riêng tư tại chỉ mục đã cho. Bạn có thể tìm thấy vai trò được sử dụng trong caver-js từ caver.wallet.keyring.role.
Tham số
Tên
Loại
Mô tả
address
chuỗi
Một địa chỉ của keyring sẽ được sử dụng.
thông báo
chuỗi
Tin nhắn cần ký.
vai trò
số
Một con số biểu thị vai trò của khóa. Bạn có thể sử dụng caver.wallet.keyring.role.
chỉ số
số
(tùy chọn) Chỉ mục khóa riêng tư bạn muốn sử dụng. Chỉ mục phải nhỏ hơn độ dài của mảng các khóa riêng tư được định rõ cho mỗi vai trò. Nếu không định rõ chỉ mục, phương pháp này sẽ sử dụng tất cả các khóa riêng tư.
Giá trị trả về
Loại
Mô tả
đối tượng
Một đối tượng bao gồm kết quả ký.
Đối tượng được trả về chứa các mục sau:
Tên
type
Mô tả
messageHash
chuỗi
Hàm băm của tin nhắn có tiền tố dành riêng cho Klaytn.
// Ký tin nhắn với roleTransactionKey sử dụng hai khóa riêng tư>caver.wallet.signMessage('0x386a4bb40abbfaa59cecdc3ced202475895fd569','message to sign',caver.wallet.keyring.role.roleTransactionKey){ messageHash:'0x9c4c1ae0aa1faf7e59eaf6fcf36a34542698197b379a9949b58c92925e74c069', signatures: [ SignatureData { _v:'0x1c', _r:'0xb3239...', _s:'0x584d2...' }, SignatureData { _v:'0x1b', _r:'0x13c64...', _s:'0x60c61...' } ], message:'message to sign'}// Ký tin nhắn với roleTransactionKey và chỉ mục>caver.wallet.signMessage('0x386a4bb40abbfaa59cecdc3ced202475895fd569','message to sign',caver.wallet.keyring.role.roleTransactionKey,1){ messageHash:'0x9c4c1ae0aa1faf7e59eaf6fcf36a34542698197b379a9949b58c92925e74c069', signatures: [ SignatureData { _v:'0x1b', _r:'0x13c64...', _s:'0x60c61...' } ], message:'message to sign'}
Ký giao dịch với tư cách là sender của giao dịch và thêm signatures vào đối tượng giao dịch bằng cách sử dụng keyring trong caver.wallet.
Đối với giao dịch [Cập nhật tài khoản](../caver.transaction/basic.md#tài khoảnupdate), sử dụng [roleTransactionKey](../../../../../klaytn/design/tài khoảns.md#roles), nếu không, hãy sử dụng [roleTransactionKey](../../../../../klaytn/design/tài khoảns.md#roles). Nếu người dùng chưa xác định index thì caver.wallet.sign sẽ ký giao dịch bằng cách sử dụng tất cả các khóa riêng tư mà vai trò này sử dụng. Nếu index được xác định thì caver.wallet.sign sẽ ký giao dịch chỉ bằng một khóa riêng tư tại chỉ mục đã cho.
(tùy chọn) Chỉ mục khóa riêng tư bạn muốn sử dụng. Chỉ mục phải nhỏ hơn độ dài của mảng các khóa riêng tư được định rõ cho mỗi vai trò. Nếu không định rõ chỉ mục, phương pháp này sẽ sử dụng tất cả các khóa riêng tư.
hasher
hàm
(tùy chọn) Một hàm băm để lấy hàm băm giao dịch. Nếu hasher được cung cấp dưới dạng tham số thì nó sẽ tính toán hàm băm giao dịch thay vì phương pháp mặc định để tính toán hàm băm giao dịch được triển khai trong caver-js. Xem Thông tin cơ bản để biết chi tiết về phương pháp mặc định để tạo hàm băm giao dịch.
Giá trị trả về
Promise trả về object: Giao dịch đã ký.
Loại
Mô tả
đối tượng
Đối tượng của giao dịch đã ký. (Các) chữ ký được thêm vào transaction.signatures.
Để biết thêm thông tin về các trường theo loại giao dịch, xem caver.transaction.
Ví dụ
// Ví dụ này sử dụng giao dịch ValueTransfer.// Vui lòng tham khảo [caver.transaction] để biết cách sử dụng các loại giao dịch khác nhau.>consttransaction=caver.transaction.valueTransfer.create({ from:'0xe7e9184c125020af5d34eab7848bab799a1dcba9', to:'0x3424b91026bdc5ec55df4548e6ebf0f28b60abd7', value:1, gas:30000,})>constcustomHasher= () => { ... }// Ký giao dịch với địa chỉ của RoleBasedKeyring sử dụng hai khóa riêng tư cho roleTransactionKey>caver.wallet.sign('0xe7e9184c125020af5d34eab7848bab799a1dcba9', transaction).then(console.log)ValueTransfer { _type:'TxTypeValueTransfer', _from:'0xe7e9184c125020af5d34eab7848bab799a1dcba9', _gas:'0x7530', _signatures: [ SignatureData { _v:'0x4e43', _r:'0xd78a2...', _s:'0x379e9...' }, SignatureData { _v:'0x4e43', _r:'0x70a58...', _s:'0x2ab28...' } ], _to:'0x3424b91026bdc5ec55df4548e6ebf0f28b60abd7', _value:'0x1', _chainId:'0x2710', _gasPrice:'0x5d21dba00', _nonce:'0x0'}// Ký giao dịch với địa chỉ của RoleBasedKeyring sử dụng hai khóa riêng tư cho roleTransactionKey và chỉ mục>caver.wallet.sign('0xe7e9184c125020af5d34eab7848bab799a1dcba9', transaction,1).then(console.log)ValueTransfer { _type:'TxTypeValueTransfer', _from:'0xe7e9184c125020af5d34eab7848bab799a1dcba9', _gas:'0x7530', _signatures: [ SignatureData { _v:'0x4e43', _r:'0x70a58...', _s:'0x2ab28...' } ], _to:'0x3424b91026bdc5ec55df4548e6ebf0f28b60abd7', _value:'0x1', _chainId:'0x2710', _gasPrice:'0x5d21dba00', _nonce:'0x0'}// Ký giao dịch với địa chỉ của RoleBasedKeyring sử dụng hai khóa riêng tư cho roleTransactionKey và hasher>caver.wallet.sign('0xe7e9184c125020af5d34eab7848bab799a1dcba9', transaction, customHasher).then(console.log)ValueTransfer { _type:'TxTypeValueTransfer', _from:'0xe7e9184c125020af5d34eab7848bab799a1dcba9', _gas:'0x7530', _signatures: [ SignatureData { _v:'0x4e44', _r:'0x7a8b6...', _s:'0x17139...' }, SignatureData { _v:'0x4e43', _r:'0x7f978...', _s:'0x1a532...' } ], _to:'0x3424b91026bdc5ec55df4548e6ebf0f28b60abd7', _value:'0x1', _chainId:'0x2710', _gasPrice:'0x5d21dba00', _nonce:'0x0'}// Ký giao dịch với địa chỉ của RoleBasedKeyring sử dụng hai khóa riêng tư cho roleTransactionKey, chỉ mục và hasher>caver.wallet.sign('0xe7e9184c125020af5d34eab7848bab799a1dcba9', transaction,0, customHasher).then(console.log)ValueTransfer { _type:'TxTypeValueTransfer', _from:'0xe7e9184c125020af5d34eab7848bab799a1dcba9', _gas:'0x7530', _signatures: [ SignatureData { _v:'0x4e44', _r:'0x7a8b6...', _s:'0x17139...' } ], _to:'0x3424b91026bdc5ec55df4548e6ebf0f28b60abd7', _value:'0x1', _chainId:'0x2710', _gasPrice:'0x5d21dba00', _nonce:'0x0'}
Ký giao dịch với tư cách là fee payer của giao dịch và thêm feePayerSignatures vào đối tượng giao dịch bằng cách sử dụng keyring trong caver.wallet.
Để ký giao dịch với vai trò là người trả phí, hãy sử dụng [roleFeePayerKey](../../../../../klaytn/design/tài khoảns.md#roles). Nếu người dùng chưa xác định index thì caver.wallet.signAsFeePayer sẽ ký giao dịch bằng cách sử dụng tất cả các khóa riêng tư mà vai trò này sử dụng. Nếu index được xác định thì caver.wallet.signAsFeePayer sẽ ký giao dịch chỉ bằng một khóa riêng tư tại chỉ mục đã cho.
Nếu transaction.feePayer không được xác định thì địa chỉ của keyring được tạo từ caver.wallet sẽ được chỉ định.
(tùy chọn) Chỉ mục khóa riêng tư bạn muốn sử dụng. Chỉ mục phải nhỏ hơn độ dài của mảng các khóa riêng tư được định rõ cho mỗi vai trò. Nếu không định rõ chỉ mục, phương pháp này sẽ sử dụng tất cả các khóa riêng tư.
hasher
hàm
(tùy chọn) Một hàm để lấy hàm băm giao dịch. Nếu hasher được xác định là một tham số thì tham số này dùng để lấy hàm băm giao dịch, thay vì triển khai mặc định trong caver-js.
Giá trị trả về
Promise trả về object: Giao dịch đã ký.
type
Mô tả
đối tượng
Đối tượng của giao dịch đã ký. Kết quả ký được thêm vào trường transaction.feePayerSignatures.
Để biết thêm thông tin về các trường theo loại giao dịch, xem caver.transaction.
Ví dụ
// Ví dụ này sử dụng giao dịch FeeDelegatedValueTransfer.// Vui lòng tham khảo [caver.transaction] để biết cách sử dụng các loại giao dịch khác nhau.>consttransaction=caver.transaction.feeDelegatedValueTransfer.create({ from:'0x6fddbcb99d31b8755c2b840a367f53eea4b4f45c', to:'0x3424b91026bdc5ec55df4548e6ebf0f28b60abd7', value:1, gas:30000,})>constcustomHasher= () => { ... }// Ký giao dịch với địa chỉ của RoleBasedKeyring sử dụng hai khóa riêng tư cho roleFeePayerKey>caver.wallet.signAsFeePayer('0xe7e9184c125020af5d34eab7848bab799a1dcba9', transaction).then(console.log)FeeDelegatedValueTransfer { _type:'TxTypeFeeDelegatedValueTransfer', _from:'0x6fddbcb99d31b8755c2b840a367f53eea4b4f45c', _gas:'0x7530', _signatures: [ SignatureData { _v:'0x01', _r:'0x', _s:'0x' } ], _feePayer:'0xe7e9184c125020af5d34eab7848bab799a1dcba9', _feePayerSignatures: [ SignatureData { _v:'0x4e44', _r:'0x7010e...', _s:'0x65d6b...' }, SignatureData { _v:'0x4e43', _r:'0x96ef2...', _s:'0x77f34...' } ], _to:'0x3424b91026bdc5ec55df4548e6ebf0f28b60abd7', _value:'0x1', _chainId:'0x2710', _gasPrice:'0x5d21dba00', _nonce:'0x0'}// Ký giao dịch với địa chỉ của RoleBasedKeyring sử dụng hai khóa riêng tư cho roleFeePayerKey, chỉ mục>caver.wallet.signAsFeePayer('0xe7e9184c125020af5d34eab7848bab799a1dcba9', transaction,0).then(console.log)FeeDelegatedValueTransfer { _type:'TxTypeFeeDelegatedValueTransfer', _from:'0x6fddbcb99d31b8755c2b840a367f53eea4b4f45c', _gas:'0x7530', _signatures: [ SignatureData { _v:'0x01', _r:'0x', _s:'0x' } ], _feePayer:'0xe7e9184c125020af5d34eab7848bab799a1dcba9', _feePayerSignatures: [ SignatureData { _v:'0x4e44', _r:'0x7010e...', _s:'0x65d6b...' } ], _to:'0x3424b91026bdc5ec55df4548e6ebf0f28b60abd7', _value:'0x1', _chainId:'0x2710', _gasPrice:'0x5d21dba00', _nonce:'0x0'}// Ký giao dịch với địa chỉ của RoleBasedKeyring sử dụng hai khóa riêng tư cho roleFeePayerKey và hasher>caver.wallet.signAsFeePayer('0xe7e9184c125020af5d34eab7848bab799a1dcba9', transaction, customHasher).then(console.log)FeeDelegatedValueTransfer { _type:'TxTypeFeeDelegatedValueTransfer', _from:'0x6fddbcb99d31b8755c2b840a367f53eea4b4f45c', _gas:'0x7530', _signatures: [ SignatureData { _v:'0x01', _r:'0x', _s:'0x' } ], _feePayer:'0xe7e9184c125020af5d34eab7848bab799a1dcba9', _feePayerSignatures: [ SignatureData { _v:'0x4e43', _r:'0xe48bf...', _s:'0x1cf36...' }, SignatureData { _v:'0x4e43', _r:'0x82976...', _s:'0x3c5e0...' } ], _to:'0x3424b91026bdc5ec55df4548e6ebf0f28b60abd7', _value:'0x1', _chainId:'0x2710', _gasPrice:'0x5d21dba00', _nonce:'0x0'}// Ký giao dịch với địa chỉ của RoleBasedKeyring sử dụng hai khóa riêng tư cho roleFeePayerKey, index và hasher>caver.wallet.signAsFeePayer('0xe7e9184c125020af5d34eab7848bab799a1dcba9', transaction,0, customHasher).then(console.log)FeeDelegatedValueTransfer { _type:'TxTypeFeeDelegatedValueTransfer', _from:'0x6fddbcb99d31b8755c2b840a367f53eea4b4f45c', _gas:'0x7530', _signatures: [ SignatureData { _v:'0x01', _r:'0x', _s:'0x' } ], _feePayer:'0xe7e9184c125020af5d34eab7848bab799a1dcba9', _feePayerSignatures: [ SignatureData { _v:'0x4e43', _r:'0x82976...', _s:'0x3c5e0...' } ], _to:'0x3424b91026bdc5ec55df4548e6ebf0f28b60abd7', _value:'0x1', _chainId:'0x2710', _gasPrice:'0x5d21dba00', _nonce:'0x0'}