# caver.wallet `caver.wallet` là gói quản lý các đối tượng [Keyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md) trong ví trong bộ nhớ. `caver.wallet` chấp nhận tất cả [SingleKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#singlekeyring), [MultipleKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#multiplekeyring) và [RoleBasedKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#rolebasedkeyring), đồng thời quản lý chúng theo địa chỉ. ## Lớp ### KeyringContainer ```javascript caver.wallet ``` `KeyringContainer` là lớp quản lý các đối tượng [SingleKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#singlekeyring), [MultipleKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#multiplekeyring) và [RoleBasedKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#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`. **thuộc tính** | Tên | type | Mô tả | | ------ | ---- | ---------------------------------- | | length | số | Số keyring trong keyringContainer. | ## caver.wallet.generate ```javascript caver.wallet.generate(numberOfKeyrings [, entropy]) ``` Tạo các đối tượng [SingleKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#singlekeyring) trong keyringContainer với các khóa riêng tư được tạo ngẫu nhiên. **Tham số** | Tên | Loại | Mô tả | | ---------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------- | | numberOfKeyrings | số | Số lượng đối tượng [SingleKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#singlekeyring) cần tạo. | | entropy | chuỗi | (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ụ** ```javascript // 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 ```javascript 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](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#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](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#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](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#rolebasedkeyring) sẽ được tạo. Keyring đã tạo sẽ được thêm vào `caver.wallet`. **Tham số** | Tên | Loại | Mô tả | | ------- | -------- | -------------- | | address | chuỗi | Chuỗi địa chỉ. | | khóa | chuỗi \\ | Mảng | **Giá trị trả về** | Loại | Mô tả | | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | đối tượng | Đối tượng keyring ([SingleKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#singlekeyring), [MultipleKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#multiplekeyring) hoặc [RoleBasedKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#rolebasedkeyring)) được thêm vào caver.wallet được trả về. | **Ví dụ** ```javascript // 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 > const roleBasedKeys = [ ['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 ```javascript caver.wallet.updateKeyring(keyring) ``` Cập nhật keyring bên trong `caver.wallet`. Khi đối tượng `keyring` mới ([SingleKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#singlekeyring), [MultipleKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#multiplekeyring) hoặc [RoleBasedKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#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. **Tham số** | Tên | type | Mô tả | | ------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | keyring | đối tượng | Keyring mới ([SingleKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#singlekeyring), [MultipleKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#multiplekeyring) hoặc [RoleBasedKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#rolebasedkeyring)) sẽ được lưu trữ trong `caver.wallet`. | **Giá trị trả về** | Loại | Mô tả | | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | đối tượng | Khóa đã cập nhật ([SingleKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#singlekeyring), [MultipleKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#multiplekeyring) hoặc [RoleBasedKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#rolebasedkeyring)) được lưu trữ trong `caver.wallet`. | **Ví dụ** ```javascript > caver.wallet.updateKeyring(newKeyring) SingleKeyring { _address: '0x386a4bb40abbfaa59cecdc3ced202475895fd569', _key: PrivateKey { _privateKey: '0x{private key}' } } ``` ## caver.wallet.getKeyring ```javascript caver.wallet.getKeyring(address) ``` Trả về đối tượng keyring tương ứng với địa chỉ trong `caver.wallet`. **Tham số** | Tên | Loại | Mô tả | | ------- | ----- | -------------------------------- | | address | chuỗi | Địa chỉ của keyring để truy vấn. | **Giá trị trả về** | Loại | Mô tả | | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | đối tượng | Đối tượng keyring được tìm thấy ([SingleKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#singlekeyring), [MultipleKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#multiplekeyring) hoặc [RoleBasedKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#rolebasedkeyring)) được lưu trữ trong `caver.wallet`. | **Ví dụ** ```javascript > caver.wallet.getKeyring('0x386a4bb40abbfaa59cecdc3ced202475895fd569') SingleKeyring { _address: '0x386a4bb40abbfaa59cecdc3ced202475895fd569', _key: PrivateKey { _privateKey: '0x{private key}' } } ``` ## caver.wallet.isExisted ```javascript caver.wallet.isExisted(address) ``` Trả về `true` nếu có một chuỗi keyring khớp với địa chỉ. **Tham số** | Tên | type | Mô tả | | ------- | ----- | ------------------------------------------- | | address | chuỗi | Địa chỉ của keyring để kiểm tra sự tồn tại. | **Giá trị trả về** | Loại | Mô tả | | ------- | -------------------------------------------------------------------------------- | | boolean | `true` có nghĩa là đã tồn tại một keyring khớp với địa chỉ trong `caver.wallet`. | **Ví dụ** ```javascript > caver.wallet.isExisted('0x386a4bb40abbfaa59cecdc3ced202475895fd569') true ``` ## caver.wallet.add ```javascript caver.wallet.add(keyring) ``` 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](#caver-wallet-updatekeyring) để cập nhật keyring hiện có trong `caver.wallet`. **Tham số** | Tên | type | Mô tả | | ------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | keyring | đối tượng | Đối tượng keyring([SingleKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#singlekeyring), [MultipleKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#multiplekeyring) hoặc [RoleBasedKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#rolebasedkeyring)) để thêm vào `caver.wallet`. | **Giá trị trả về** | type | Mô tả | | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | đối tượng | Keyring đã được thêm ([SingleKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#singlekeyring), [MultipleKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#multiplekeyring) hoặc [RoleBasedKeyring](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#rolebasedkeyring)) trong `caver.wallet`. | **Ví dụ** ```javascript > caver.wallet.add(keyring) SingleKeyring { _address: '0x386a4bb40abbfaa59cecdc3ced202475895fd569', _key: PrivateKey { _privateKey: '0x{private key}' } } ``` ## caver.wallet.remove ```javascript caver.wallet.remove(address) ``` Xóa keyring khỏi `caver.wallet` có địa chỉ khớp với địa chỉ của keyring đã cho. **Tham số** | Tên | Loại | Mô tả | | ------- | ----- | --------------------------------------------------- | | address | chuỗi | Địa chỉ của keyring sẽ bị xóa trong `caver.wallet`. | **Giá trị trả về** | Loại | Mô tả | | ------- | ---------------------------------------------- | | boolean | `true` nếu keyring bị xóa khỏi `caver.wallet`. | **Ví dụ** ```javascript > caver.wallet.remove('0x6a3edfad6d1126020d5369e9097db39281876c5d') true ``` ## caver.wallet.signMessage ```javascript 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. | | chữ ký | Mảng | Một mảng [SignatureData](/content/dapp/sdk/caver-js/api-references/caver.wallet/keyring.md#signaturedata). | | thông báo | chuỗi | Tin nhắn cần ký. | **Ví dụ** ```javascript // 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' } ``` ## caver.wallet.sign ```javascript caver.wallet.sign(address, transaction [, index] [, hasher]) ``` 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. **Tham số** | Tên | Loại | Mô tả | | ----------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | address | chuỗi | Một địa chỉ của keyring sẽ được sử dụng. | | transaction | đối tượng | Một đối tượng [Giao dịch](https://github.com/klaytn/klaytn-docs-vn/blob/main/docs/dapp/sdk/caver-js/api-references/caver.transaction#class). | | 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ư. | | 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](/content/klaytn/design/transactions/basic.md) để 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](https://github.com/klaytn/klaytn-docs-vn/blob/main/docs/dapp/sdk/caver-js/api-references/caver.transaction). **Ví dụ** ```javascript // 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. > const transaction = caver.transaction.valueTransfer.create({ from: '0xe7e9184c125020af5d34eab7848bab799a1dcba9', to: '0x3424b91026bdc5ec55df4548e6ebf0f28b60abd7', value: 1, gas: 30000, }) > const customHasher = () => { ... } // 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' } ``` ## caver.wallet.signAsFeePayer ```javascript caver.wallet.signAsFeePayer(address, transaction [, index] [, hasher]) ``` 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. **Tham số** | Tên | Loại | Mô tả | | ----------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | address | chuỗi | Một địa chỉ của keyring sẽ được sử dụng. | | transaction | đối tượng | Một đối tượng [FeeDelegatedTransaction](/content/dapp/sdk/caver-js/api-references/caver.transaction/fee-delegation.md). | | 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ư. | | 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](https://github.com/klaytn/klaytn-docs-vn/blob/main/docs/dapp/sdk/caver-js/api-references/caver.transaction). **Ví dụ** ```javascript // 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. > const transaction = caver.transaction.feeDelegatedValueTransfer.create({ from: '0x6fddbcb99d31b8755c2b840a367f53eea4b4f45c', to: '0x3424b91026bdc5ec55df4548e6ebf0f28b60abd7', value: 1, gas: 30000, }) > const customHasher = () => { ... } // 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' } ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://archive-vn.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/caver.wallet.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.