# caver.transaction

`caver.transaction`는 트랜잭션 관련 기능을 제공하는 패키지입니다.

## Class <a href="#class" id="class"></a>

각 트랜잭션 클래스에 대한 자세한 설명이 있습니다:

|                        | Basic                                                                                                                                     | Fee Delegation                                                                                                                                                             | Partial Fee Delegation                                                                                                                                                                               |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| LegacyTransaction      | [LegacyTransaction](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/basic#legacytransaction)           | N/A                                                                                                                                                                        | N/A                                                                                                                                                                                                  |
| ValueTransfer          | [ValueTransfer](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/basic#valuetransfer)                   | [FeeDelegatedValueTransfer](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/fee-delegation#feedelegatedvaluetransfer)                   | [FeeDelegatedValueTransferWithRatio](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/partial-fee-delegation#feedelegatedvaluetransferwithratio)                   |
| ValueTransferMemo      | [ValueTransferMemo](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/basic#valuetransfermemo)           | [FeeDelegatedValueTransferMemo](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/fee-delegation#feedelegatedvaluetransfermemo)           | [FeeDelegatedValueTransferMemoWithRatio](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/partial-fee-delegation#feedelegatedvaluetransfermemowithratio)           |
| SmartContractDeploy    | [SmartContractDeploy](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/basic#smartcontractdeploy)       | [FeeDelegatedSmartContractDeploy](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/fee-delegation#feedelegatedsmartcontractdeploy)       | [FeeDelegatedSmartContractDeployWithRatio](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/partial-fee-delegation#feedelegatedsmartcontractdeploywithratio)       |
| SmartContractExecution | [SmartContractExecution](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/basic#smartcontractexecution) | [FeeDelegatedSmartContractExecution](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/fee-delegation#feedelegatedsmartcontractexecution) | [FeeDelegatedSmartContractExecutionWithRatio](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/partial-fee-delegation#feedelegatedsmartcontractexecutionwithratio) |
| AccountUpdate          | [AccountUpdate](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/basic#accountupdate)                   | [FeeDelegatedAccountUpdate](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/fee-delegation#feedelegatedaccountupdate)                   | [FeeDelegatedAccountUpdateWithRatio](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/partial-fee-delegation#feedelegatedaccountupdatewithratio)                   |
| Cancel                 | [Cancel](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/basic#cancel)                                 | [FeeDelegatedCancel](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/fee-delegation#feedelegatedcancel)                                 | [FeeDelegatedCancelWithRatio](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/partial-fee-delegation#feedelegatedcancelwithratio)                                 |
| ChainDataAnchoring     | [ChainDataAnchoring](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/basic#chaindataanchoring)         | [FeeDelegatedChainDataAnchoring](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/fee-delegation#feedelegatedchaindataanchoring)         | [FeeDelegatedChainDataAnchoringWithRatio](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/partial-fee-delegation#feedelegatedchaindataanchoringwithratio)         |
| EthereumAccessList     | [EthereumAccessList](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/basic#ethereumaccesslist)         | N/A                                                                                                                                                                        | N/A                                                                                                                                                                                                  |
| EthereumDynamicFee     | [EthereumDynamicFee](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/basic#ethereumdynamicfee)         | N/A                                                                                                                                                                        | N/A                                                                                                                                                                                                  |

## caver.transaction.decode <a href="#caver-transaction-decode" id="caver-transaction-decode"></a>

```javascript
caver.transaction.decode(rlpEncoded)
```

Decodes RLP-encoded transaction string, a raw transaction, and returns a [Transaction](#class) instance.

**Parameters**

| Name       | Type   | Description                |
| ---------- | ------ | -------------------------- |
| rlpEncoded | string | 디코딩할 RLP 인코딩된 트랜잭션 문자열입니다. |

**Return Value**

| Type   | Description                                                                                            |
| ------ | ------------------------------------------------------------------------------------------------------ |
| object | An instance of [Transaction](#class). For details of each transaction, refer to [Transaction](#class). |

**Example**

```javascript
> caver.transaction.decode('0x08f87...')
ValueTransfer {
    _type: 'TxTypeValueTransfer',
    _from: '0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b',
    _gas: '0xf4240',
    _nonce: '0x4d2',
    _gasPrice: '0x19',
    _signatures: [ 
        SignatureData { _v: '0x25', _r: '0xf3d0c...', _s: '0x6748a...' }
    ],
    _to: '0x7b65b75d204abed71587c9e519a89277766ee1d0',
    _value: '0xa'
}
```

## caver.transaction.getTransactionByHash <a href="#caver-transaction-gettransactionbyhash" id="caver-transaction-gettransactionbyhash"></a>

```javascript
caver.transaction.getTransactionByHash('0x{transaction hash}')
```

Queries a transaction from Klaytn and converts to a caver transaction instance.

**NOTE** `caver.transaction.getTransactionByHash` is supported since caver-js [v1.6.3](https://www.npmjs.com/package/caver-js/v/1.6.3).

**Parameters**

| Name            | Type   | Description                                       |
| --------------- | ------ | ------------------------------------------------- |
| transactionHash | string | The transaction hash string to query from Klaytn. |

**Return Value**

`Promise` returning `object`: An instance of [Transaction](#class). If it fails to receive a transaction object from Klaytn, an error occurs.

| Type   | Description                                                                                            |
| ------ | ------------------------------------------------------------------------------------------------------ |
| object | An instance of [Transaction](#class). For details of each transaction, refer to [Transaction](#class). |

**Example**

```javascript
> caver.transaction.getTransactionByHash('0x30575f5a76a4477502aa1e5e707e47f05b92c3450132529cf55764cc94f780b0').then(console.log)
LegacyTransaction {
  _type: 'TxTypeLegacyTransaction',
  _from: '0x9ce618d097ea54c00d1562cb060576ff64139f10',
  _gas: '0x81b320',
  _nonce: '0x1de',
  _gasPrice: '0x5d21dba00',
  _signatures: SignatureData {
    _v: '0x07f5',
    _r: '0x359a09ebd2842cfc9cad6fd93c299da8629292bb3a69410c73837f7ca15cfd51',
    _s: '0x6f348cc656b90e79cfc1e748c3371fbd0128b83b787a110622f3aa5143a017f8'
  },
  _to: '0x',
  _input: '0x60806...',
  _value: '0x0'
}
```

## caver.transaction.recoverPublicKeys <a href="#caver-transaction-recoverpublickeys" id="caver-transaction-recoverpublickeys"></a>

```javascript
caver.transaction.recoverPublicKeys('0x{RLP-encoded transaction}')
```

Recovers the public key strings from `signatures` field of the given transaction.

**NOTE** `caver.transaction.recoverPublicKeys` is supported since caver-js [v1.6.3](https://www.npmjs.com/package/caver-js/v/1.6.3).

**Parameters**

| Name  | Type   | Description                                                                  |
| ----- | ------ | ---------------------------------------------------------------------------- |
| rawTx | string | The RLP-encoded transaction string to recover public keys from `signatures`. |

**Return Value**

| Type  | Description                                                  |
| ----- | ------------------------------------------------------------ |
| Array | An array containing public keys recovered from `signatures`. |

**Example**

```javascript
> caver.transaction.recoverPublicKeys('0x08f9010e808505d21dba008402faf0809459177716c34ac6e49e295a0e78e33522f14d61ee0194f21460730845e3652aa3cc9bc13b345e4f53984af8d5f845820feaa02b5934c6d26bb3e65edf099d79c57c743d2f70744ca09d3ba9a1099edff9f173a00797886edff4b449c1a599943e3a6003ae9e46b3f3f34862ced327e43fba3a6af845820fe9a063177648732ef855f800eb9f80f68501abb507f84c0d660286a6e0801334a1d2a0620a996623c114f2df35b11ec8ac4f3758d3ad89cf81ba13614e51908cfe9218f845820fe9a086c8ecbfd892be41d48443a2243274beb6daed3f72895045965a3baede4c350ea069ea748aff6e4c106d3a8ba597d8f134745b76f12dacb581318f9da07351511a')
[
  '0x8bb6aaeb2d96d024754d3b50babf116cece68977acbe8ba6a66f14d5217c60d96af020a0568661e7c72e753e80efe084a3aed9f9ac87bf44d09ce67aad3d4e01',
  '0xc7751c794337a93e4db041fb5401c2c816cf0a099d8fd4b1f3f555aab5dfead2417521bb0c03d8637f350df15ef6a6cb3cdb806bd9d10bc71982dd03ff5d9ddd',
  '0x3919091ba17c106dd034af508cfe00b963d173dffab2c7702890e25a96d107ca1bb4f148ee1984751e57d2435468558193ce84ab9a7731b842e9672e40dc0f22'
]
```

## caver.transaction.recoverFeePayerPublicKeys <a href="#caver-transaction-recoverfeepayerpublickeys" id="caver-transaction-recoverfeepayerpublickeys"></a>

```javascript
caver.transaction.recoverFeePayerPublicKeys('0x{RLP-encoded transaction}')
```

Recovers the public key strings from `feePayerSignatures` field of the given transaction.

**NOTE** `caver.transaction.recoverFeePayerPublicKeys` is supported since caver-js [v1.6.3](https://www.npmjs.com/package/caver-js/v/1.6.3).

**Parameters**

| Name  | Type   | Description                                                                                                                                                                                                                |
| ----- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| rawTx | string | The RLP-encoded transaction string to recover public keys from `feePayerSignatures`. To recover fee payer's public keys, the transaction should be a fee-delegated transaction with the `feePayerSignatures` field inside. |

**Return Value**

| Type  | Description                                                          |
| ----- | -------------------------------------------------------------------- |
| Array | An array containing public keys recovered from `feePayerSignatures`. |

**Example**

```javascript
> caver.transaction.recoverFeePayerPublicKeys('0x09f901fa808505d21dba008402faf0809459177716c34ac6e49e295a0e78e33522f14d61ee019407a9a76ef778676c3bd2b334edcf581db31a85e5f8d5f845820feaa0cb2bbf04a12ec3a06163c30ce8782739ec4745a53e265aa9443f1c0d678bb871a07dd348c7d8fce6be36b661f116973d1c36cc92a389ad4a1a4053bd486060a083f845820fe9a06d5dfca992d6833c0da272578bc6ea941be45f44fb2fa114310ebe18d673ed52a04dc5cd7985c9ce7d44d46d65e65c995a4a8c97159a1eed8b2efb0510b981ab7cf845820feaa0945151edf556fbcebf832092d4534b9a3b1f3d46f85bce09e7d7211070cb57bea01617c8f918f96970baddd12f240a9824eca6b29d91eb7333adacb987f2dcd8dd94b5db72925b1b6b79299a1a49ae226cd7861083acf8d5f845820feaa086fd17d788e89a6e0639395b3c0a04f916103debd6cbe639d6f4ff5034dde3e8a00795551c551d9096234c290689767f34f2d409c95166ab18d216dbc93845ba16f845820feaa00653b6d1cdb90462094b089ce8e2fed0e3b8ec2c44125965e1a5af286644c758a0259b10e3bf594d48535fd0d95e15d095897c8d075c01dd56e7417d5943b0d53af845820fe9a0ce8d051427adab10d1dc93de49123aeab18ba8aadedce0d57ef5b7fa451b1f4fa04fe2a845d92ff48abca3e1d59637fab5f4a4e3172d91772d9bfce60760edc506')
[
  '0x2b557d80ddac3a0bbcc8a7861773ca7434c969e2721a574bb94a1e3aa5ceed3819f08a82b31682c038f9f691fb38ee4aaf7e016e2c973a1bd1e48a51f60a54ea',
  '0x1a1cfe1e2ec4b15520c57c20c2460981a2f16003c8db11a0afc282abf929fa1c1868f60f91b330c423aa660913d86acc2a0b1b15e7ba1fe571e5928a19825a7e',
  '0xdea23a89dbbde1a0c26466c49c1edd32785432389641797038c2b53815cb5c73d6cf5355986fd9a22a68bb57b831857fd1636362b383bd632966392714b60d72'
]
```

## transaction.sign <a href="#transaction-sign" id="transaction-sign"></a>

```javascript
transaction.sign(keyring [, index] [, hasher])
```

Signs the transaction as a transaction sender with the private key(s) in the `keyring` and appends `signatures` in the transaction object.

For [Account Update](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/api-references/basic#accountupdate) transaction, use [roleAccountUpdateKey](https://archive-ko.docs.klaytn.foundation/klaytn/design/accounts#roles), or otherwise, use [roleTransactionKey](https://archive-ko.docs.klaytn.foundation/klaytn/design/accounts#roles) in [RoleBasedKeyring](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/caver.wallet/keyring#rolebasedkeyring). If the user has not defined an `index`, `transaction.sign` signs the transaction using all the private keys used by the role. If `index` is defined, the `transaction.sign` signs the transaction using only one private key at the given index.

**Parameters**

| Name    | Type      | Description                                                                                                   |
| ------- | --------- | ------------------------------------------------------------------------------------------------------------- |
| keyring | object \\ | string                                                                                                        |
| index   | number    | (선택 사항) 사용하고자 하는 개인키의 인덱스입니다. 인덱스는 각각의 역할에 정의된 개인키들의 배열 길이보다 작아야 합니다. 인덱스가 정의되지 않았을 경우, 이 메서드는 모든 개인키를 사용합니다. |
| hasher  | Function  | (optional) The hash function to get the hash of the transaction.                                              |

**Return Value**

`Promise`는 `객체`를 반환: 서명된 트랜잭션입니다.

| Type   | Description                                                                                             |
| ------ | ------------------------------------------------------------------------------------------------------- |
| object | An instance of signed [Transaction](#class). The signature is appended to the `transaction.signatures`. |

**Example**

```javascript
// 이 예시는 ValueTransfer 트랜잭션 사용
> const transaction = caver.transaction.valueTransfer.create({
    from: '0xe7e9184c125020af5d34eab7848bab799a1dcba9',
    to: '0x3424b91026bdc5ec55df4548e6ebf0f28b60abd7',
    value: 1,
    gas: 30000,
})

> const customHasher = () => { ... }

// roleTransactionKey에 두 개인키를 사용하는 roleBasedKeyring로 트랜잭션 서명
> transaction.sign(roleBasedKeyring).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'
}

// roleTransactionKey와 인덱스에 두 개인키를 사용하는 roleBasedKeyring로 트랜잭션 서명
> transaction.sign(roleBasedKeyring, 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'
}

// roleTransactionKey와 hasher에 두 개인키를 사용하는 roleBasedKeyring로 트랜잭션 서명
> transaction.sign(roleBasedKeyring, 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'
}

// roleTransactionKey, 인덱스, hasher에 두 개인키를 사용하는 roleBasedKeyring로 트랜잭션 서명
> transaction.sign(roleBasedKeyring, 1, customHasher).then(console.log)
ValueTransfer {
    _type: 'TxTypeValueTransfer',
    _from: '0xe7e9184c125020af5d34eab7848bab799a1dcba9',
    _gas: '0x7530',
    _signatures: [
        SignatureData { _v: '0x4e43', _r: '0x7f978...', _s: '0x1a532...' }
    ],
    _to: '0x3424b91026bdc5ec55df4548e6ebf0f28b60abd7',
    _value: '0x1',
    _chainId: '0x2710',
    _gasPrice: '0x5d21dba00',
    _nonce: '0x0'
}
```

## transaction.signAsFeePayer <a href="#transaction-signasfeepayer" id="transaction-signasfeepayer"></a>

```javascript
transaction.signAsFeePayer(keyring [, index] [, hasher])
```

트랜잭션 `fee payer`로서 서명하며, `keyring` 내 개인키를 사용하여 트랜잭션 객체에 `feePayerSignatures`를 첨부합니다.

For signing a transaction as a fee payer, use [roleFeePayerKey](https://archive-ko.docs.klaytn.foundation/klaytn/design/accounts#roles) in `keyring`. 사용자가 `index`를 정의하지 않았다면, `transaction.signAsFeePayer`이 해당 역할에 의해 사용되는 모든 개인키를 가지고 트랜잭션에 서명합니다. `index`가 정의되어 있다면, `transaction.signAsFeePayer`이 주어진 인덱스에 대응하는 하나의 개인키를 가지고 트랜잭션에 서명합니다.

`transaction.feePayer`가 정의되어 있지 않은 경우, 주어진 keyring의 주소는 `transaction.feePayer`로 설정됩니다.

If the `keyring` to be used for signing the transaction was added to `caver.wallet`, you can use [caver.wallet.signAsFeePayer](https://github.com/klaytn/klaytn-docs-ko/blob/main/docs/dapp/sdk/caver-js/api-references/caver.wallet#caver-wallet-signasfeepayer).

**참고** 이 함수는 "수수료 대납" 트랜잭션 또는 "수수료 부분 대납" 트랜잭션에서만 작동합니다.

**Parameters**

| Name    | Type      | Description                                                                                                                                                                                                                    |
| ------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| keyring | object \\ | string                                                                                                                                                                                                                         |
| index   | number    | (optional) The index of the private key you want to use. The index must be less than the length of the array of the private keys defined for each role. If an index is not defined, this method will use all the private keys. |
| hasher  | Function  | (optional) The hash function to get the hash of the transaction.                                                                                                                                                               |

**Return Value**

`Promise` returning `object`: The signed transaction.

| Type   | Description                                                                                                     |
| ------ | --------------------------------------------------------------------------------------------------------------- |
| object | An instance of signed [Transaction](#class). The signature is appended to the `transaction.feePayerSignatures`. |

**Example**

```javascript
// This example uses the FeeDelegatedValueTransfer transaction.
> const transaction = caver.transaction.feeDelegatedValueTransfer.create({
    from: '0x6fddbcb99d31b8755c2b840a367f53eea4b4f45c',
    to: '0x3424b91026bdc5ec55df4548e6ebf0f28b60abd7',
    value: 1,
    gas: 30000,
})

> const customHasher = () => { ... }

// Sign a transaction with the address of RoleBasedKeyring which use two private keys for roleFeePayerKey
> transaction.signAsFeePayer(roleBasedKeyring).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'
}

// Sign a transaction with the address of RoleBasedKeyring which use two private keys for roleFeePayerKey and index
> transaction.signAsFeePayer(roleBasedKeyring, 1).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: '0x96ef2...', _s: '0x77f34...' }
    ],
    _to: '0x3424b91026bdc5ec55df4548e6ebf0f28b60abd7',
    _value: '0x1',
    _chainId: '0x2710',
    _gasPrice: '0x5d21dba00',
    _nonce: '0x0'
}

// Sign a transaction with the address of RoleBasedKeyring which use two private keys for roleFeePayerKey and hasher
> transaction.signAsFeePayer(roleBasedKeyring, 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'
}

// Sign a transaction with the address of RoleBasedKeyring which use two private keys for roleFeePayerKey, index and hasher
> transaction.signAsFeePayer(roleBasedKeyring, 1, 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'
}
```

## transaction.appendSignatures <a href="#transaction-appendsignatures" id="transaction-appendsignatures"></a>

```javascript
transaction.appendSignatures(signatures)
```

Appends `signatures` to the transaction.

**Parameters**

| Name       | Type      | Description |
| ---------- | --------- | ----------- |
| signatures | object \\ | Array       |

**Example**

```javascript
> transaction.appendSignatures([ '0x4e44', '0x7010e...', '0x65d6b...' ])
```

## transaction.appendFeePayerSignatures <a href="#transaction-appendfeepayersignatures" id="transaction-appendfeepayersignatures"></a>

```javascript
transaction.appendFeePayerSignatures(signatures)
```

Appends `feePayerSignatures` to the transaction.

**NOTE** This function works only for "fee-delegated" transactions or "fee-delegated with ratio" transactions.

**Parameters**

| Name               | Type      | Description |
| ------------------ | --------- | ----------- |
| feePayerSignatures | object \\ | Array       |

**Example**

```javascript
> transaction.appendFeePayerSignatures([ '0x4e44', '0x7010e...', '0x65d6b...' ])
```

## transaction.combineSignedRawTransactions <a href="#transaction-combinesignatures" id="transaction-combinesignatures"></a>

```javascript
transaction.combineSignedRawTransactions(rlpEncodedTxs)
```

Collects signs in each RLP-encoded transaction string in the given array, combines them with the transaction instance, and returns a RLP-encoded transaction string which includes all signs. Note that the transaction instance doesn't necessarily be signed in advance. If the transaction is either a type of "fee-delegated" or "fee-delegated with ratio", `feePayerSignatures` is also merged and included in the output RLP-encoded transaction string.

**Parameters**

| Name          | Type  | Description                                         |
| ------------- | ----- | --------------------------------------------------- |
| rlpEncodedTxs | Array | An array of signed RLP-encoded transaction strings. |

**Return Value**

| Type   | Description                                                                                                                                                                  |
| ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| string | A RLP-encoded transaction string which includes all `signatures` (and `feePayerSignatures` if transaction is a type of either "fee-delgated" or "fee-delegated with ratio"). |

**Example**

```javascript
> transaction.combineSignedRawTransactions(['0x09f88...'])
'0x09f885018505d21dba00830f4240947b65b75d204abed71587c9e519a89277766ee1d00a9404bb86a1b16113ebe8f57071f839b002cbcbf7d0f847f845820feaa068e56f3da7fbe7a86543eb4b244ddbcb13b2d1cb9adb3ee8a4c8b046821bc492a068c29c057055f68a7860b54184bba7967bcf42b6aae12beaf9f30933e6e730c280c4c3018080'
```

## transaction.getRLPEncoding <a href="#transaction-getrlpencoding" id="transaction-getrlpencoding"></a>

```javascript
transaction.getRLPEncoding()
```

RLP 인코딩된 트랜잭션 문자열을 반환합니다.

For information on how to make the RLP-encoded string for each transaction type, see [Klaytn Design - Transactions](https://archive-ko.docs.klaytn.foundation/content/klaytn/design/transactions).

**Return Value**

| Type   | Description           |
| ------ | --------------------- |
| string | RLP 인코딩된 트랜잭션 문자열입니다. |

**Example**

```javascript
> transaction.getRLPEncoding()
'0x09f885018505d21dba00830f4240947b65b75d204abed71587c9e519a89277766ee1d00a9404bb86a1b16113ebe8f57071f839b002cbcbf7d0f847f845820feaa068e56f3da7fbe7a86543eb4b244ddbcb13b2d1cb9adb3ee8a4c8b046821bc492a068c29c057055f68a7860b54184bba7967bcf42b6aae12beaf9f30933e6e730c280c4c3018080'
```

## transaction.getRawTransaction <a href="#transaction-getrawtransaction" id="transaction-getrawtransaction"></a>

```javascript
transaction.getRawTransaction()
```

`rawTransaction` 문자열을 반환합니다(RLP 인코딩된 트랜잭션 문자열). This function is same with [transaction.getRLPEncoding](#transaction-getrlpencoding).

**Return Value**

| Type   | Description                       |
| ------ | --------------------------------- |
| string | A RLP-encoded transaction string. |

**Example**

```javascript
> transaction.getRawTransaction()
'0x09f885018505d21dba00830f4240947b65b75d204abed71587c9e519a89277766ee1d00a9404bb86a1b16113ebe8f57071f839b002cbcbf7d0f847f845820feaa068e56f3da7fbe7a86543eb4b244ddbcb13b2d1cb9adb3ee8a4c8b046821bc492a068c29c057055f68a7860b54184bba7967bcf42b6aae12beaf9f30933e6e730c280c4c3018080'
```

## transaction.getTransactionHash <a href="#transaction-gettransactionhash" id="transaction-gettransactionhash"></a>

```javascript
transaction.getTransactionHash()
```

`transactionHash`를 반환합니다.

For information on how to make the transaction hash for each transaction type, see [Klaytn Design - Transactions](https://archive-ko.docs.klaytn.foundation/content/klaytn/design/transactions).

**Return Value**

| Type   | Description |
| ------ | ----------- |
| string | 트랜잭션 해시입니다. |

**Example**

```javascript
> transaction.getTransactionHash()
'0x8ac53afbba014201b02398545653683fe0536c49707fe302c59423012c0e8697'
```

## transaction.getSenderTxHash <a href="#transaction-getsendertxhash" id="transaction-getsendertxhash"></a>

```javascript
transaction.getSenderTxHash()
```

Returns a [senderTxHash](https://archive-ko.docs.klaytn.foundation/klaytn/design/transactions#sendertxhash) of transaction.

The [senderTxHash](https://archive-ko.docs.klaytn.foundation/klaytn/design/transactions#sendertxhash) is a hash of the transaction except for the fee payer's address and signature, so [transactionHash](#transaction-gettransactionhash) and [senderTxHash](https://archive-ko.docs.klaytn.foundation/klaytn/design/transactions#sendertxhash) are the same for basic transactions.

For information on how to make the [senderTxHash](https://archive-ko.docs.klaytn.foundation/klaytn/design/transactions#sendertxhash) for each transaction type, see [Klaytn Design - Transactions](https://archive-ko.docs.klaytn.foundation/content/klaytn/design/transactions).

**Return Value**

| Type   | Description                     |
| ------ | ------------------------------- |
| string | 전송자의 트랜잭션 해시(senderTxHash) 입니다. |

**Example**

```javascript
> transaction.getSenderTxHash()
'0xb61cc1ddadb6f2ec34c9f9e6a7b6cf0a606422654d649d998587c77daa3c31fe'
```

## transaction.getRLPEncodingForSignature <a href="#transaction-getrlpencodingforsignature" id="transaction-getrlpencodingforsignature"></a>

```javascript
transaction.getRLPEncodingForSignature()
```

트랜잭션 전송자의 서명을 만들기 위한 RLP 인코딩된 트랜잭션 문자열을 반환합니다. 반환된 RLP 인코딩된 트랜잭션 문자열은 서명에 추가되는 것이 아니라, 이 서명을 생성하는 데 사용된다는 점을 참고하세요.

For information on how to make a RLP-encoded transaction string to generate the transaction sender's signature for each transaction type, see [Klaytn Design - Transactions](https://archive-ko.docs.klaytn.foundation/content/klaytn/design/transactions).

**Return Value**

| Type   | Description                       |
| ------ | --------------------------------- |
| string | 서명이 첨부되지 않은 RLP 인코딩된 트랜잭션 문자열입니다. |

**Example**

```javascript
> transaction.getRLPEncodingForSignature()
'0xf83fb838f709018505d21dba00830f4240947b65b75d204abed71587c9e519a89277766ee1d00a9404bb86a1b16113ebe8f57071f839b002cbcbf7d08207e38080'
```

## transaction.getRLPEncodingForFeePayerSignature <a href="#transaction-getrlpencodingforfeepayersignature" id="transaction-getrlpencodingforfeepayersignature"></a>

```javascript
transaction.getRLPEncodingForFeePayerSignature()
```

수수료 납부자의 서명을 생성하기 위한 RLP 인코딩된 트랜잭션 문자열을 반환합니다. Note that the returned RLP-encoded transaction string is not added with the signature and rather is used to generate this signature.

For information on how to make a RLP-encoded transaction string to generate the fee payer's signature for each transaction type, see [Klaytn Design - Transactions](https://archive-ko.docs.klaytn.foundation/content/klaytn/design/transactions).

**NOTE** This function works only for "fee-delegated" transactions or "fee-delegated with ratio" transactions.

**Return Value**

| Type   | Description                                                      |
| ------ | ---------------------------------------------------------------- |
| string | A RLP-encoded transaction string without any signature attached. |

**Example**

```javascript
> transaction.getRLPEncodingForFeePayerSignature()
'0xf840b838f709018505d21dba00830f4240947b65b75d204abed71587c9e519a89277766ee1d00a9404bb86a1b16113ebe8f57071f839b002cbcbf7d0808207e38080'
```

## transaction.fillTransaction <a href="#transaction-filltransaction" id="transaction-filltransaction"></a>

```javascript
transaction.fillTransaction()
```

트랜잭션의 선택 사항 변수들을 기입해 줍니다.

이 메서드는 트랜잭션의 선택 변수 `gasPrice`, `nonce`, 또는 `chainId`가 정의되지 않은 경우, 각각의 기본값을 조회하여 연결된 Klaytn Node에 JSON RPC 호출을 함으로서 이 값들을 지정시킵니다.

Use [caver.rpc.klay.getGasPrice](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/caver.rpc/klay#caver-rpc-klay-getgasprice) to get `gasPrice`, [caver.rpc.klay.getTransactionCount](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/caver.rpc/klay#caver-rpc-klay-gettransactioncount) to get `nonce` and [caver.rpc.klay.getChainId](https://archive-ko.docs.klaytn.foundation/content/dapp/sdk/caver-js/caver.rpc/klay#caver-rpc-klay-getchainid) call to get `chainId`.

**Return Value**

`Promise`는 `void`을 반환합니다.

**Example**

```javascript
> transaction.fillTransaction()
```

## transaction.recoverPublicKeys <a href="#transaction-recoverpublickeys" id="transaction-recoverpublickeys"></a>

```javascript
transaction.recoverPublicKeys()
```

`signatures`에서 공개키 스트링을 복구합니다.

**참고** `transaction.recoverPublicKeys`는 caver-js [v1.6.3](https://www.npmjs.com/package/caver-js/v/1.6.3)부터 지원됩니다.

**Return Value**

| Type  | Description                                                  |
| ----- | ------------------------------------------------------------ |
| Array | An array containing public keys recovered from `signatures`. |

**Example**

```javascript
> transaction.recoverPublicKeys()
[
  '0x8bb6aaeb2d96d024754d3b50babf116cece68977acbe8ba6a66f14d5217c60d96af020a0568661e7c72e753e80efe084a3aed9f9ac87bf44d09ce67aad3d4e01',
  '0xc7751c794337a93e4db041fb5401c2c816cf0a099d8fd4b1f3f555aab5dfead2417521bb0c03d8637f350df15ef6a6cb3cdb806bd9d10bc71982dd03ff5d9ddd',
  '0x3919091ba17c106dd034af508cfe00b963d173dffab2c7702890e25a96d107ca1bb4f148ee1984751e57d2435468558193ce84ab9a7731b842e9672e40dc0f22'
]
```

## transaction.recoverFeePayerPublicKeys <a href="#transaction-recoverfeepayerpublickeys" id="transaction-recoverfeepayerpublickeys"></a>

```javascript
transaction.recoverFeePayerPublicKeys()
```

`feePayerSignatures` 필드에서 공개키 문자열을 복구합니다.

**참고** `transaction.recoverFeePayerPublicKeys`는 caver-js [v1.6.3](https://www.npmjs.com/package/caver-js/v/1.6.3)부터 지원됩니다.

**Return Value**

| Type  | Description                                                          |
| ----- | -------------------------------------------------------------------- |
| Array | An array containing public keys recovered from `feePayerSignatures`. |

**Example**

```javascript
> transaction.recoverFeePayerPublicKeys()
[
  '0x2b557d80ddac3a0bbcc8a7861773ca7434c969e2721a574bb94a1e3aa5ceed3819f08a82b31682c038f9f691fb38ee4aaf7e016e2c973a1bd1e48a51f60a54ea',
  '0x1a1cfe1e2ec4b15520c57c20c2460981a2f16003c8db11a0afc282abf929fa1c1868f60f91b330c423aa660913d86acc2a0b1b15e7ba1fe571e5928a19825a7e',
  '0xdea23a89dbbde1a0c26466c49c1edd32785432389641797038c2b53815cb5c73d6cf5355986fd9a22a68bb57b831857fd1636362b383bd632966392714b60d72'
]
```

## transaction.suggestGasPrice <a href="#transaction-suggestgasprice" id="transaction-suggestgasprice"></a>

```javascript
transaction.suggestGasPrice()
```

Returns suggested gas price. This function is used to set gasPrice field in the [fillTransaction](#transaction-fillTransaction).

Before the Magma hard fork, `suggestGasPrice` returns the unit price of the network. After the Magma hard fork, `suggestGasPrice` returns `baseFee * 2` which is recommended to use as gasPrice.

**NOTE** `transaction.suggestGasPrice` is supported since caver-js [v1.9.0](https://www.npmjs.com/package/caver-js/v/1.9.0).

**Return Value**

`Promise` returning `string`: The suggested gas price in hexadecimal string.

| Type   | Description              |
| ------ | ------------------------ |
| string | The suggested gas price. |

**Example**

```javascript
> tx.suggestGasPrice().then(console.log)
0xba43b7400
```