イーサリアム互換性
KaiaはEthereumとの互換性をサポートするためにラップされたトランザクションタイプを提供する。 Kaiaにおけるイーサリアムのトランザクションタイプは、EthereumTxTypeEnvelopeと呼ばれる1バイトのタイプ区切り文字を除き、イーサリアムの設計と同じ属性とRLPエンコーディングスキームを持っています。したがって、ユーザーはEthereum開発ツールで生成したトランザクションをKaia上で正常に展開することができます。ユーザーがeth名前空間APIを使用する場合、タイプデリミターも省略されるため、Ethereumを使用するのと同じようにKaiaを使用することができます。 kaia名前空間APIを使用することで、ユーザーは既存のKaiaトランザクションタイプと混同することなく、EthereumフォーマットのトランザクションをKaiaトランザクションタイプとしてデプロイおよび取得することができる。
EthereumTxTypeEnvelope
EthereumTxTypeEnvelopeは、Ethereumのトランザクションタイプを示す生トランザクション用の1バイト接頭辞である。 EthereumはEIP-2718から拡張可能なトランザクション型スキームを採用しており、Kaiaと競合する型番号システムを使用している。 2つの異なるトランザクションタイプのスキーム間の衝突を解決するために、Kaiaは将来のEthereumトランザクションタイプの分離と拡張を可能にするEthereumTxTypeEnvelopeを導入した。 EthereumはEIP-2718から拡張可能なトランザクション型スキームを採用しており、Kaiaと競合する型番号システムを使用している。 2つの異なるトランザクションタイプのスキーム間の衝突を解決するために、Kaiaは将来のEthereumトランザクションタイプの分離と拡張を可能にするEthereumTxTypeEnvelopeを導入した。
EthereumTxTypeEnvelopeは追加の型区切り文字であり、生のトランザクションと型番号付けにのみ使用される。トランザクションハッシュや署名ハッシュには使用されない。そのために、EIPs で定義されている EthereumTransactionType が使われる。
- EthereumTxTypeEnvelope:
0x78 - TxHashRLP : EthereumTransactionType || TransactionPayload
- RawTransaction : EthereumTxTypeEnvelope || EthereumTransactionType || TransactionPayload
TxTypeEthereumAccessList
TxTypeEthereumAccessListはEIP-2930で指定されたイーサリアム取引のタイプを表す。このトランザクションタイプは、アクセスリスト、すなわち、トランザクションが アクセスすることになっているアドレスとストレージキーのリストを含む。このトランザクション・タイプは互換性をサポートするために存在するため、[AccountKeyLegacy]に関連付けられた EOA でのみ機能する。他のアカウント・キー・タイプに関連する EOA は、TxTypeValueTransfer や TxTypeSmartContractExecution などの他のトランザクション・タイプを使用すべきである。このトランザクションタイプは、アカウントの作成、トークンの移転、スマートコントラクトのデプロイ/実行、または前述の混合が可能である。
Kaiaネットワークは EthTxTypeCompatibleBlock の後にこのトランザクションタイプを処理できる。
注:このトランザクションタイプはイーサリアムのトランザクションタイプのフォーマットのみをサポートする。 EIP-2930](https://eips.ethereum.org/EIPS/eip-2930)と異なり、アクセスリストを使用することによる取引手数料のメリットはない。
属性
| 属性 | タイプ | 説明 |
|---|---|---|
| type | uint8 (Go) | EthereumTxTypeEnvelope と EthereumTransactionType を連結した TxTypeEthereumAccessList 型。これは0x7801でなければならない。 |
| chainId | *big.Int (Go) | デスティネーションチェーンID。 |
| nonce | uint64 (Go) | 送信者のトランザクションを一意に識別するために使用される値。送信者のトランザクションを一意に識別するために使用される値。 同じnonceを持つ2つのトランザクションが送信者によって生成された場合、1つだけが実行される。 |
| gasPrice | *big.Int (Go) | 送信者がトークンで支払う金額を得るための乗数。送信者が支払うトークンの金額は gas ⑭ gasPrice によって計算される。送信者が取引手数料として支払うガスの単価。 取引手数料の金額は、gas * gasPrice として計算されます。 KAIAのユニット](../../learn/token-economics/kaia-native-token.md#units-of-kaia)を参照。 |
| gas | uint64 (Go) | トランザクションが使用できる取引手数料の上限額。 |
| to | *common.Address (Go) | 送金された金額を受け取る口座アドレス。 |
| value | *big.Int (Go) | 譲渡されるkeiのKAIAの量。 |
| data | []byte (Go) | トランザクションの実行に使用される、トランザクションに添付されたデータ。 |
| accessList | type.AccessList (Go) | A list of addresses and storage keys consisting of [](common.Address, []common.Hash). |
| v, r, s | *big.Int (Go) | 受信者が送信者のアドレスを取得するために送信者が生成した暗号署名。 |
署名用RLPエンコーディング
このトランザクションタイプの署名を作成するために、RLPのシリアライズは以下のように進められる:
この種のトランザクションはロンドン・シグナーで署名されるべきである。
SigRLP = EthereumTransactionType || encode([chainId, nonce, gasPrice, gasLimit, to, value, data, accessList])SigHash = keccak256(SigRLP)Signature = sign(SigHash, <private key>)
SenderTxHashのRLPエンコーディング
このトランザクションタイプの SenderTxHash を得るために、RLPのシリアライズは以下のように進められる:
SenderTxHashRLP = EthereumTransactionType || encode([chainId, nonce, gasPrice, gasLimit, to, value, data, accessList, v, r, s])SenderTxHash = keccak256(SenderTxHashRLP)Signature = sign(SenderTxHash, <private key>)
トランザクション・ハッシュのRLPエンコーディング
トランザクションハッシュを作成するために、RLPのシリアライゼーションは以下のように進められる:
TxHashRLP = EthereumTransactionType || encode([chainId, nonce, gasPrice, gasLimit, to, value, data, accessList, v, r, s])TxHash = keccak256(TxHashRLP)
未加工取引
RawTx = EthereumTxTypeEnvelope || EthereumTransactionType || encode([chainId, nonce, gasPrice, gasLimit, to, value, data, accessList, v, r, s])
RLP Encoding (Example)
以下は、RLPシリアライズの結果とトランザクション・オブジェクトを示している:
TX(3a3ab67168de40b1f8a2141a70a4e2f551f90d7814b2fbcb3ac99ad8d8d0b641) Contract: false Chaind: 0x2 From: a94f5374fce5edbc8e2a8697c15331677e6ebf0b To: 7b65b75d204abed71587c9e519a89277766ee1d0 Nonce: 1234 GasPrice: 0x19 GasLimit 0xf4240 Value: 0xa Data: 0x31323334 AccessList: [{0000000000000000000000000000000000000001 [0000000000000000000000000000000000000000000000000000000000000000]}] V: 0x1 R: 0xbfc80a874c43b71b67c68fa5927d1443407f31aef4ec6369bbecdb76fc39b0c0 S: 0x193e62c1dd63905aee7073958675dcb45d78c716a9a286b54a496e82cb762f26 Hex: 7801f8a1028204d219830f4240947b65b75d204abed71587c9e519a89277766ee1d00a8431323334f838f7940000000000000000000000000000000000000001e1a0000000000000000000000000000000000000000000000000000000000000000001a0bfc80a874c43b71b67c68fa5927d1443407f31aef4ec6369bbecdb76fc39b0c0a0193e62c1dd63905aee7073958675dcb45d78c716a9a286b54a496e82cb762f26
RPC Output (Example)
以下は、JSON RPCを介して返されるトランザクション・オブジェクトを示している。
eth_getTransactionByHash の戻り値。
{ "blockHash": "0x7bd7e8a92ecaa5781a15a8b6fff589f8ac8a79325b517a1ba5d5f2f3d7af1b00", "blockNumber": "0x1c8f4b", "from": "0x5618e15ec2916bbe6cf2cce20ce31e61d6062cac", "gas": "0x174876e800", "gasPrice": "0x5d21dba00", "hash": "0x3f67e48c2090f560234f555cd4edf7853b6327aa9a6a795be1efe3f360dac118", "input": "0x1122", "nonce": "0x11", "to": "0x5dce87b5bfcde54023811b168dc97a9f10913957", "transactionIndex": "0x0", "value": "0x186a0", "type": "0x1", "accessList": [ { "address": "0x0000000000000000000000000000000000000001", "storageKeys": [ "0x0000000000000000000000000000000000000000000000000000000000000000" ] } ], "chainId": "0x2710", "v": "0x1", "r": "0xebb2d2144293c257e27aaa1d22156f322b0d2d7385257f186c117899d791f174", "s": "0x5cea970287c9f0f9754050a552c458c066d8f3b3e4639f561b22ce4cb7553ac0"}
kaia_getTransactionByHash の戻り値
{ "accessList": [ { "address": "0x0000000000000000000000000000000000000001", "storageKeys": [ "0x0000000000000000000000000000000000000000000000000000000000000000" ] } ], "blockHash": "0x7bd7e8a92ecaa5781a15a8b6fff589f8ac8a79325b517a1ba5d5f2f3d7af1b00", "blockNumber": "0x1c8f4b", "chainID": "0x2710", "from": "0x5618e15ec2916bbe6cf2cce20ce31e61d6062cac", "gas": "0x174876e800", "gasPrice": "0x5d21dba00", "hash": "0x3f67e48c2090f560234f555cd4edf7853b6327aa9a6a795be1efe3f360dac118", "input": "0x1122", "nonce": "0x11", "senderTxHash": "0x3f67e48c2090f560234f555cd4edf7853b6327aa9a6a795be1efe3f360dac118", "signatures": [ { "V": "0x1", "R": "0xebb2d2144293c257e27aaa1d22156f322b0d2d7385257f186c117899d791f174", "S": "0x5cea970287c9f0f9754050a552c458c066d8f3b3e4639f561b22ce4cb7553ac0" } ], "to": "0x5dce87b5bfcde54023811b168dc97a9f10913957", "transactionIndex": "0x0", "type": "TxTypeEthereumAccessList", "typeInt": 30721, "value": "0x186a0"}
TxTypeEthereumDynamicFee
TxTypeEthereumDynamicFee は、EIP-1559 で指定されているイーサリアム取引のタイプを表す。この取引タイプは gasPrice の代わりに gasTipCap と gasFeeCap を含む。このトランザクション・タイプは互換性をサポートするために存在するため、[AccountKeyLegacy]に関連付けられた EOA でのみ機能する。他のアカウント・キー・タイプに関連する EOA は、TxTypeValueTransfer や TxTypeSmartContractExecution などの他のトランザクション・タイプを使用すべきである。この種の取引は、アカウントの作成、トークンの移転、スマートコントラクトの導入/実行、または前述の混合が可能である。
注: Kaia ネットワークは EthTxTypeCompatibleBlock の後にこのトランザクションタイプを処理できる。
現在、このタイプのトランザクションはイーサリアムのトランザクションタイプのフォーマットのみをサポートしている。現在、このタイプのトランザクションはイーサリアムのトランザクションタイプのフォーマットのみをサポートしている。 EIP-2930](https://eips.ethereum.org/EIPS/eip-2930)と異なり、アクセスリストを使用することによる取引手数料のメリットはない。
注意: カイアのガス料金は固定なので、gasTipCapとgasFeeCapはそれぞれのネットワークのガス料金を取るべきである。
属性
| 属性 | タイプ | 説明 |
|---|---|---|
| type | uint8 (Go) | EthereumTxTypeEnvelope と EthereumTransactionType を連結した TxTypeEthereumDynamicFee の型。 0x7802`でなければならない。 |
| chainId | *big.Int (Go) | デスティネーションチェーンID。 |
| nonce | uint64 (Go) | 送信者のトランザクションを一意に識別するために使用される値。送信者のトランザクションを一意に識別するために使用される値。 同じnonceを持つ2つのトランザクションが送信者によって生成された場合、1つだけが実行される。 |
| gasTipCap | *big.Int (Go) | ベースフィー(baseFee)に加えて送信者が支払う金額を得るための乗数。カイアのガス料金は固定なので、gasTipCapとgasFeeCapはそれぞれのネットワークのガス料金を取る必要がある。 |
| gasFeeCap | *big.Int (Go) | 送信者がトークンで支払う金額を得るための乗数。送信者がトークンで支払う金額を得るための乗数。 送信者が支払うトークンの量は、gas* gasFeeCap によって計算されます。 カイアのガス料金は固定なので、gasTipCapとgasFeeCapはそれぞれのネットワークのガス料金を取る必要がある。カイアのガス料金は固定なので、gasTipCapとgasFeeCapはそれぞれのネットワークのガス料金を取る必要がある。 |
| gas | uint64 (Go) | トランザクションが使用できる取引手数料の上限額。 |
| to | *common.Address (Go) | 送金された金額を受け取る口座アドレス。 |
| value | *big.Int (Go) | 譲渡されるkeiのKAIAの量。 |
| data | []byte (Go) | トランザクションの実行に使用される、トランザクションに添付されたデータ。 |
| accessList | type.AccessList (Go) | A list of addresses and storage keys consisting of [](common.Address, []common.Hash). |
| v, r, s | *big.Int (Go) | 受信者が送信者のアドレスを取得するために送信者が生成した暗号署名。 |
署名用RLPエンコーディング
このトランザクションタイプの署名を作成するために、RLPのシリアライズは以下のように進められる:
この種のトランザクションはロンドン・シグナーで署名されるべきである。
SigRLP = EthereumTransactionType || encode([chainId, nonce, gasTipCap, gasFeeCap, gasLimit, to, value, data, accessList])SigHash = keccak256(SigRLP)Signature = sign(SigHash, <private key>)
SenderTxHashのRLPエンコーディング
このトランザクションタイプの SenderTxHash を得るために、RLPのシリアライズは以下のように進められる:
SenderTxHashRLP = EthereumTransactionType || encode([chainId, nonce, gasTipCap, gasFeeCap, gasLimit, to, value, data, accessList, v, r, s])SenderTxHash = keccak256(SenderTxHashRLP)Signature = sign(SenderTxHash, <private key>)
トランザクション・ハッシュのRLPエンコーディング
トランザクションハッシュを得るために、RLPシリアライゼーションは以下のように進められる:
TxHashRLP = EthereumTransactionType || encode([chainId, nonce, gasTipCap, gasFeeCap, gasLimit, to, value, data, accessList, v, r, s])TxHash = keccak256(TxHashRLP)
未加工取引
RawTx = EthereumTxTypeEnvelope || EthereumTransactionType || encode([chainId, nonce, gasTipCap, gasFeeCap, gasLimit, to, value, data, accessList, v, r, s])
RLP Encoding (Example)
以下は、RLPシリアライズの結果とトランザクション・オブジェクトを示している:
TX(be74e122acf00c2f257e8698ecf01140b58b2880de3f24d0875730425eccb45a) Contract: false Chaind: 0x2 From: a94f5374fce5edbc8e2a8697c15331677e6ebf0b To: 7b65b75d204abed71587c9e519a89277766ee1d0 Nonce: 1234 GasTipCap: 0x19 GasFeeCap: 0x19 GasLimit 0xf4240 Value: 0xa Data: 0x31323334 AccessList: [{0000000000000000000000000000000000000001 [0000000000000000000000000000000000000000000000000000000000000000]}] V: 0x0 R: 0xca14aa0bada2da7ca1b143c16e2dd4a69f2a1e77ce54c7f6d440fe828a777f4f S: 0x117f0f78aed398b2995b5ee7c67ace25d52be3c72c1384c2aaa9683b351556 Hex: 7802f8a1028204d21919830f4240947b65b75d204abed71587c9e519a89277766ee1d00a8431323334f838f7940000000000000000000000000000000000000001e1a0000000000000000000000000000000000000000000000000000000000000000080a0ca14aa0bada2da7ca1b143c16e2dd4a69f2a1e77ce54c7f6d440fe828a777f4f9f117f0f78aed398b2995b5ee7c67ace25d52be3c72c1384c2aaa9683b351556
RPC Output (Example)
以下は、JSON RPCを介して返されるトランザクション・オブジェクトを示している。
eth_getTransactionByHash の戻り値。
{ "blockHash": "0x55792fe186e3d1515fe35a68c2c8d7977b2d7db184d80526f906c53222b77833", "blockNumber": "0x1c944d", "from": "0x5618e15ec2916bbe6cf2cce20ce31e61d6062cac", "gas": "0x174876e800", "gasPrice": "0x5d21dba00", "maxFeePerGas": "0x5d21dba00", "maxPriorityFeePerGas": "0x5d21dba00", "hash": "0x5db239963029ad9ef6c3331b10ae455638316e330b0efdae2cc1f8e86884e66e", "input": "0x1122", "nonce": "0x13", "to": "0xa0f1633f4c666d7fe5ba912bd5caf03d3655ac31", "transactionIndex": "0x0", "value": "0x186a0", "type": "0x2", "accessList": [ { "address": "0x0000000000000000000000000000000000000001", "storageKeys": [ "0x0000000000000000000000000000000000000000000000000000000000000000" ] } ], "chainId": "0x2710", "v": "0x1", "r": "0x27e007cbe79fd8cc9b89dd798bdd5aa62d038273bf006c7c3b40e13a938ab807", "s": "0x6209bb328855f02fa2671fecb41efd9f191b03ecab5e580227fa2a0674879384"}
kaia_getTransactionByHash の戻り値
{ "accessList": [ { "address": "0x0000000000000000000000000000000000000001", "storageKeys": [ "0x0000000000000000000000000000000000000000000000000000000000000000" ] } ], "blockHash": "0x55792fe186e3d1515fe35a68c2c8d7977b2d7db184d80526f906c53222b77833", "blockNumber": "0x1c944d", "chainId": "0x2710", "from": "0x5618e15ec2916bbe6cf2cce20ce31e61d6062cac", "gas": "0x174876e800", "hash": "0x5db239963029ad9ef6c3331b10ae455638316e330b0efdae2cc1f8e86884e66e", "input": "0x1122", "maxFeePerGas": "0x5d21dba00", "maxPriorityFeePerGas": "0x5d21dba00", "nonce": "0x13", "senderTxHash": "0x5db239963029ad9ef6c3331b10ae455638316e330b0efdae2cc1f8e86884e66e", "signatures": [ { "V": "0x1", "R": "0x27e007cbe79fd8cc9b89dd798bdd5aa62d038273bf006c7c3b40e13a938ab807", "S": "0x6209bb328855f02fa2671fecb41efd9f191b03ecab5e580227fa2a0674879384" } ], "to": "0xa0f1633f4c666d7fe5ba912bd5caf03d3655ac31", "transactionIndex": "0x0", "type": "TxTypeEthereumDynamicFee", "typeInt": 30722, "value": "0x186a0"}
TxTypeEthereumBlob
TxTypeEthereumBlobは、[EIP-4844](https://eips.ethereum.org/EIPS/eip-4844)および[KIP-279](https://kips.kaia.io/KIPs/kip-279 )で指定されているイーサリアム取引のタイプを表す。このトランザクション・タイプは、データのバイナリ・ラージ・オブジェクト(ブロブ)を搬送し、カイアのレイヤ2ロールアップにコスト効率の良いデータ・アベイラビリティ・レイヤーを提供する。ブロブデータを永続的なcalldataストレージから分離することで、ロールアップは独立したブロブ料金市場を通じて、より低コストでデータを掲載することができる。 blobVersionedHashesコミットメントだけがオンチェーンでアクセスできる。このトランザクション・タイプは互換性をサポートするために存在するため、[AccountKeyLegacy]に関連付けられた EOA でのみ機能する。このトランザクションタイプはコントラクトの作成には使用できない。
KaiaネットワークはOsakaCompatibleBlockの後にこのトランザクションタイプを処理することができる。
カイアのブロブガスのパラメーターは1秒ブロック用に調整されている。ブロックにつき1つのブロブしか許可されない。 EIP-7594](https://eips.ethereum.org/EIPS/eip-7594) のサイドカーフォーマット (V1) のみが受け付けられます - V0 サイドカーは拒否されます。ブロブ・サイドカーは1,814,400ブロック(~21日間)保持される。
eth_sendRawTransaction はサイドカー付きの完全な blob トランザクション (BlobTxWithBlobs) を必要とします。 blobVersionedHashes はバージョン接頭辞 0x01 を使用しなければならない。
属性
| 属性 | タイプ | 説明 |
|---|---|---|
| タイプ | uint8 | EthereumTxTypeEnvelopeとEthereumTransactionTypeを連結したTxTypeEthereumBlob 型。これは0x7803`でなければならない。 |
| チェーンID | *Ω*big.Int | デスティネーションチェーンID。 |
| ノンス | uint64 | 送信者のトランザクションを一意に識別するために使用される値。同じnonceを持つ2つのトランザクションが送信者によって生成された場合、1つだけが実行される。 |
| ガスあたりの最大優先料金 | *Ω*big.Int | ベースフィー(baseFee)に加えて送信者が支払う金額を得るための乗数。カイアのガス料金は固定なので、それぞれのネットワークのガス料金を使用する。 |
| ガス料金 | *Ω*big.Int | 送り手がガス1単位あたりに支払ってもよいと考える最大金額。カイアのガス料金は固定なので、それぞれのネットワークのガス料金を使用する。 |
| ガス | uint64 | トランザクションが使用できる取引手数料の上限額。 |
| への | *(´・ω・`)・・・(´・ω・`)・・・(´・ω・`) | 送金された金額を受け取る口座アドレス。 nilであってはならない - blobトランザクションはコントラクトを作成できない。 |
| 価値 | *Ω*big.Int | 譲渡されるKAIAの金額。 |
| データ | \バイト | トランザクションの実行に使用される、トランザクションに添付されたデータ。 |
| アクセスリスト | type.AccessList (Go) | (common.Address、[]common.Hash)で構成されるアドレスと保存キーのリスト。 |
| 最大料金PerBlobGas | *Ω*big.Int | 送信者が支払ってもよいとするブロブガス1単位あたりの最大料金。ブロブガスは通常のガスとは独立した価格設定となっている。 |
| blobVersionedHashes | (´・ω・`)コモンハッシュ | このトランザクションに関連付けられたblobのバージョン付きハッシュのリスト。各ハッシュはバージョン接頭辞 0x01 を使用しなければならない。少なくとも1つのハッシュが必要である。 |
| V, R, S | *Ω*big.Int | 受信者が送信者のアドレスを取得するために送信者が生成した暗号署名。 |
署名用RLPエンコーディング
このトランザクションタイプの署名を作成するために、RLPのシリアライズは以下のように進められる:
この種の取引は、大阪サイナーで署名する必要があります。
SigRLP = EthereumTransactionType || encode([chainId, nonce, maxPriorityFeePerGas, maxFeePerGas, gasLimit, to, value, data, accessList, maxFeePerBlobGas, blobVersionedHashes])SigHash = keccak256(SigRLP)Signature = sign(SigHash,<private key>)
SenderTxHashのRLPエンコーディング
このトランザクションタイプの SenderTxHash を得るために、RLPのシリアライズは以下のように進められる:
SenderTxHashRLP = EthereumTransactionType || encode([chainId, nonce, maxPriorityFeePerGas, maxFeePerGas, gasLimit, to, value, data, accessList, maxFeePerBlobGas, blobVersionedHashes, v, r, s])SenderTxHash = keccak256(SenderTxHashRLP)
トランザクション・ハッシュのRLPエンコーディング
トランザクションハッシュを得るために、RLPの直列化は以下のように進められる:
TxHashRLP = EthereumTransactionType || encode([chainId, nonce, maxPriorityFeePerGas, maxFeePerGas, gasLimit, to, value, data, accessList, maxFeePerBlobGas, blobVersionedHashes, v, r, s])TxHash = keccak256(TxHashRLP)
未加工取引
RawTx = EthereumTxTypeEnvelope || EthereumTransactionType || encode([chainId, nonce, maxPriorityFeePerGas, maxFeePerGas, gasLimit, to, value, data, accessList, maxFeePerBlobGas, blobVersionedHashes, v, r, s])
eth_sendRawTransaction` で送信する場合は、サイドカーを含む完全なネットワーク表現を提供する必要があります:
BlobTxWithBlobs = rlp([TransactionPayloadBody, sidecar_version, blobs, commitments, proofs])
ここでsidecar_versionはEIP-7594に従って0x01である。
RLP Encoding (Example)
以下は、RLPシリアライズの結果とトランザクション・オブジェクトを示している:
TX(b4687ea17a0908a4dce2d83f8c2566881474b9da30ee8b8979b028778761c9d7) Contract: false Chaind: 0x3e9 From: 0a3fa1b8fbdaeabcd2a7cb13abb87e8d1bd0a3b5 To: a9ef4a5bfb21e92c06da23ed79294dab11f5a6df Nonce: 366 GasTipCap: 0x0 GasFeeCap: 0xba43b7400 GasLimit 0xc350 Value: 0x0 Data: 0xd09de08a AccessList:[] MaxFeePerBlobGas: 0x5d21dba000 BlobVersionedHashes:[016f2dec5826dba2b8071deb0fba09244486cc4f9b981fe26396bc3206d2a8d7] V: 0x1 R: 0x4b6905c3f06373638576004b2367caa5e1d4c60fa3091a058ddbfef34e30ff S: 0x659b7ede7f3439a3f07958abe448c25ddfc0ba0b530bff60356552484a854916 Hex: 7803f8978203e982016e80850ba43b740082c35094a9ef4a5bfb21e92c06da23ed79294dab11f5a6df8084d09de08ac0855d21dba000e1a0016f2dec5826dba2b8071deb0fba09244486cc4f9b981fe26396bc3206d2a8d701a04b6905c3f0637363857626004b2367caa5e1d4c60fa3091a058ddbfef34e30ffa0659b7ede7f3439a3f07958abe448c25ddfc0ba0b530bff60356552484a854916
RPC出力
以下は、JSON RPCを介して返されるトランザクション・オブジェクトを示している。
eth_getTransactionByHash` の戻り値。
{ "blockHash":"0x1683db8c05f898cd9084a8905b3fa2a64b1380b6543e963ea15d2858b241c339", "blockNumber":"0xc77238e", "from":"0x0a3fa1b8fbdaeabcd2a7cb13abb87e8d1bd0a3b5", "gas":"0xc350", "gasPrice":"0x5d21dba00", "maxFeePerGas":"0xba43b7400", "maxPriorityFeePerGas":"0x0", "maxFeePerBlobGas":"0x5d21dba000", "hash":"0xb4687ea17a0908a4dce2d83f8c2566881474b9da30ee8b8979b028778761c9d7", "input":"0xd09de08a", "nonce":"0x16e", "to":"0xa9ef4a5bfb21e92c06da23ed79294dab11f5a6df", "transactionIndex":"0x0", "value":"0x0", "type":"0x3", "accessList":[], "chainId":"0x3e9", "blobVersionedHashes":[ "0x016f2dec5826dba2b8071deb0fba09244486cc4f9b981fe26396bc3206d2a8d7" ], "v":"0x1", "r":"0x4b6905c3f0637363857626004b2367caa5e1d4c60fa3091a058ddbfef34e30ff", "s":"0x659b7ede7f3439a3f07958abe448c25ddfc0ba0b530bff60356552484a854916"}
kaia_getTransactionByHash` の戻り値。
{ "accessList":[], "blobVersionedHashes":[ "0x016f2dec5826dba2b8071deb0fba09244486cc4f9b981fe26396bc3206d2a8d7" ], "blockHash":"0x1683db8c05f898cd9084a8905b3fa2a64b1380b6543e963ea15d2858b241c339", "blockNumber":"0xc77238e", "chainId":"0x3e9", "from":"0x0a3fa1b8fbdaeabcd2a7cb13abb87e8d1bd0a3b5", "gas":"0xc350", "gasPrice":"0x5d21dba00", "hash":"0xb4687ea17a0908a4dce2d83f8c2566881474b9da30ee8b8979b028778761c9d7", "input":"0xd09de08a", "maxFeePerBlobGas":"0x5d21dba000", "maxFeePerGas":"0xba43b7400", "maxPriorityFeePerGas":"0x0", "nonce":"0x16e", "senderTxHash":"0xb4687ea17a0908a4dce2d83f8c2566881474b9da30ee8b8979b028778761c9d7", "signatures":[ { "V":"0x1", "R":"0x4b6905c3f0637363857626004b2367caa5e1d4c60fa3091a058ddbfef34e30ff", "S":"0x659b7ede7f3439a3f07958abe448c25ddfc0ba0b530bff60356552484a854916" }. ], "to":"0xa9ef4a5bfb21e92c06da23ed79294dab11f5a6df", "transactionIndex":"0x0", "type":"TxTypeEthereumBlob", "typeInt":30723, "value":"0x0"}.
TxTypeEthereumSetCode
TxTypeEthereumSetCode は、[EIP-7702](https://eips.ethereum.org/EIPS/eip-7702)および[KIP-228](https://kips.kaia.io/KIPs/kip-228 )で指定されているイーサリアム取引のタイプを表す。このトランザクション・タイプは、すでに存在するEOAへのアカウント抽象化機能を可能にすることで、ユーザー・エクスペリエンスを向上させる。以前は、スマートアカウント機能を求めるEOAオーナーは、新しいスマートアカウントを作成し、すべての資産と権限を移行しなければならなかった。 SetCodeトランザクションを使えば、ユーザーは既存のEOAにその場でコードを付加することができ、コストのかかるマイグレーションが不要になる。 authorizationListは、コードが設定されるべきアカウントによって署名された (chainId, address, nonce)タプルのリストを指定する。デリゲーションは、別の SetCode トランザクションによって明示的に変更または削除されるまで持続する。このトランザクション・タイプは互換性をサポートするために存在するため、[AccountKeyLegacy]に関連付けられた EOA でのみ機能する。このトランザクションタイプは契約の作成には使用できない。
KaiaネットワークはPragueCompatibleBlockの後にこのトランザクションタイプを処理できる。
AccountKeyLegacyを持つEOAだけが、認可タプルを介してコードを割り当てることができる。他のキー・タイプを持つアカウントを参照する認証タプルはスキップされる。 EOAにコードが設定されると、標準の TxTypeValueTransfer トランザクションはそれをターゲットにできず、TxTypeAccountUpdate` トランザクションはそれを起点にできない。
EIP-7702](https://eips.ethereum.org/EIPS/eip-7702) で規定されているように、各認証タプルは、keccak256(MAGIC || rlp([chainId, address, nonce])) (MAGIC = 0x05)上で独立に署名される。少なくとも1つの認可タプルが必要である。
属性
| 属性 | タイプ | 説明 |
|---|---|---|
| タイプ | uint8 | EthereumTxTypeEnvelopeとEthereumTransactionTypeを連結したTxTypeEthereumSetCode 型。これは0x7804`でなければならない。 |
| チェーンID | *Ω*big.Int | デスティネーションチェーンID。 |
| ノンス | uint64 | 送信者のトランザクションを一意に識別するために使用される値。同じnonceを持つ2つのトランザクションが送信者によって生成された場合、1つだけが実行される。 |
| ガスあたりの最大優先料金 | *Ω*big.Int | ベースフィー(baseFee)に加えて送信者が支払う金額を得るための乗数。カイアのガス料金は固定なので、それぞれのネットワークのガス料金を使用する。 |
| ガス料金 | *Ω*big.Int | 送り手がガス1単位あたりに支払ってもよいと考える最大金額。カイアのガス料金は固定なので、それぞれのネットワークのガス料金を使用する。 |
| ガス | uint64 | トランザクションが使用できる取引手数料の上限額。 |
| 目的地 | *(´・ω・`)・・・(´・ω・`)・・・(´・ω・`) | 送金された金額を受け取る口座アドレス。 nilであってはならない - SetCodeトランザクションはコントラクトを作成できない。 |
| 価値 | *Ω*big.Int | 譲渡されるKAIAの金額。 |
| データ | \バイト | トランザクションの実行に使用される、トランザクションに添付されたデータ。 |
| アクセスリスト | type.AccessList (Go) | (common.Address、[]common.Hash)で構成されるアドレスと保存キーのリスト。 |
| 認可リスト | \ʬʬʬʬʬʬ | 各タプルは [chainId, address, nonce, yParity, r, s] という形式で、address は署名権限が委任するコントラクトのコードである。少なくとも1つのタプルが必要。 |
| V, R, S | *Ω*big.Int | 受信者が送信者のアドレスを取得するために送信者が生成した暗号署名。 |
署名用RLPエンコーディング
このトランザクションタイプの署名を作成するために、RLPのシリアライズは以下のように進められる:
このタイプのトランザクションは、プラハ署名者で署名されなければならない。
SigRLP = EthereumTransactionType || encode([chainId, nonce, maxPriorityFeePerGas, maxFeePerGas, gasLimit, destination, value, data, accessList, authorizationList])SigHash = keccak256(SigRLP)Signature = sign(SigHash,<private key>)
authorizationList`内の各認証タプルはそれぞれ独立に署名される:
AuthSigRLP = MAGIC || encode([chainId, address, nonce]) // MAGIC = 0x05AuthSigHash = keccak256(AuthSigRLP)AuthSignature = sign(AuthSigHash,<authority private key>)
SenderTxHashのRLPエンコーディング
このトランザクションタイプの SenderTxHash を得るために、RLPのシリアライズは以下のように進められる:
SenderTxHashRLP = EthereumTransactionType || encode([chainId, nonce, maxPriorityFeePerGas, maxFeePerGas, gasLimit, destination, value, data, accessList, authorizationList, v, r, s])SenderTxHash = keccak256(SenderTxHashRLP)
トランザクション・ハッシュのRLPエンコーディング
トランザクションハッシュを得るために、RLPの直列化は以下のように進められる:
TxHashRLP = EthereumTransactionType || encode([chainId, nonce, maxPriorityFeePerGas, maxFeePerGas, gasLimit, destination, value, data, accessList, authorizationList, v, r, s])TxHash = keccak256(TxHashRLP)
未加工取引
RawTx = EthereumTxTypeEnvelope || EthereumTransactionType || encode([chainId, nonce, maxPriorityFeePerGas, maxFeePerGas, gasLimit, destination, value, data, accessList, authorizationList, v, r, s])
RLP Encoding (Example)
以下は、RLPシリアライズの結果とトランザクション・オブジェクトを示している:
TX(383aafe58842af80cc63747b781439cc8b1786b70fedfd86d966b1ea728da1) Contract: false Chaind: 0x3e9 From: 698f9bd1a4fc200f8d0c7997810e02a77ca6d5ce To: 698f9bd1a4fc200f8d0c7997810e02a77ca6d5ce Nonce: 29 GasTipCap: 0x0 GasFeeCap: 0x6fc23ac00 GasLimit 0x186a0 Value: 0x0 Data: 0x8129fc1c AccessList:[] AuthorizationList:[{ChainID: 0x3e9, Address:5fa0193098ecbbad437243fe0ed77a402cd62242, Nonce: 30}] とする。 V: 0x1 R: 0x77b03c8fd556255dff1f7af72e7a9a8f081e1da9daeb09800d139bf22f22708e S: 0x26b7d4762db258e596382de1416753c65ca8e3b0855e8276eecf22d019af2805 Hex: 7804f8ce8203e91d808506fc23ac00830186a094698f9bd1a4fc200f8d0c7997810e02a77ca6d5ce80848129fc1cc0f85ef85c8203e9945fa0193098ecbbad437243fe0ed77a402cd622421e01a0a21df3fb047c656d5046ae6b5ea81743c047b281b07591f742a13606f09c4969a01494cb06d71cbaa002d669ff63e1d0044bb5d06a00ca550a103ac0287789614a01a077b03c8fd556255dff1f7af72e7a9a8f081e1da9daeb09800d139bf22f22708ea026b7d4762db258e596382de1416753c65ca8e3b0855e8276eecf22d019af2805
RPC出力
以下は、JSON RPCを介して返されるトランザクション・オブジェクトを示している。
eth_getTransactionByHash` の戻り値。
{ "blockHash":"0xb76e4a38c1311159ed6fe704f4b220294589accf1c5ec440a471fd4201c6c968", "blockNumber":"0xb35bcdd", "from":"0x698f9bd1a4fc200f8d0c7997810e02a77ca6d5ce", "gas":"0x186a0", "gasPrice":"0x5d21dba00", "maxFeePerGas":"0x6fc23ac00", "maxPriorityFeePerGas":"0x0", "hash":"0x383aafe58842af80cc63747b78181439cc8b1786b70fedfd86d966b1ea728da1", "input":"0x8129fc1c", "nonce":"0x1d", "to":"0x698f9bd1a4fc200f8d0c7997810e02a77ca6d5ce", "transactionIndex":"0x0", "value":"0x0", "type":"0x4", "accessList":[], "chainId":"0x3e9", "authorizationList":[ { "chainId":"0x3e9", "address":"0x5fa0193098ecbbad437243fe0ed77a402cd62242", "nonce":"0x1e", "yParity":"0x1", "r":"0xa21df3fb047c656d5046ae6b5ea81743c047b281b07591f742a13606f09c4969", "s":"0x1494cb06d71cbaa002d669ff63e1d0044bb5d06a00ca550a103ac0287789614a" }. ], "v":"0x1", "r":"0x77b03c8fd556255dff1f7af72e7a9a8f081e1da9daeb09800d139bf22f22708e", "s":"0x26b7d4762db258e596382de1416753c65ca8e3b0855e8276eecf22d019af2805"}
kaia_getTransactionByHash` の戻り値。
{ "accessList":[], "authorizationList":[ { "chainId":"0x3e9", "address":"0x5fa0193098ecbbad437243fe0ed77a402cd62242", "nonce":"0x1e", "yParity":"0x1", "r":"0xa21df3fb047c656d5046ae6b5ea81743c047b281b07591f742a13606f09c4969", "s":"0x1494cb06d71cbaa002d669ff63e1d0044bb5d06a00ca550a103ac0287789614a" }. ], "blockHash":"0xb76e4a38c1311159ed6fe704f4b220294589accf1c5ec440a471fd4201c6c968", "blockNumber":"0xb35bcdd", "chainId":"0x3e9", "from":"0x698f9bd1a4fc200f8d0c7997810e02a77ca6d5ce", "gas":"0x186a0", "gasPrice":"0x5d21dba00", "hash":"0x383aafe58842af80cc63747b781439cc8b1786b70fedfd86d966b1ea728da1", "input":"0x8129fc1c", "maxFeePerGas":"0x6fc23ac00", "maxPriorityFeePerGas":"0x0", "nonce":"0x1d", "senderTxHash":"0x383aafe58842af80cc63747b78181439cc8b1786b70fedfd86d966b1ea728da1", "signatures":[ { "V":"0x1", "R":"0x77b03c8fd556255dff1f7af72e7a9a8f081e1da9daeb09800d139bf22f22708e", "S":"0x26b7d4762db258e596382de1416753c65ca8e3b0855e8276eecf22d019af2805" }. ], "to":"0x698f9bd1a4fc200f8d0c7997810e02a77ca6d5ce", "transactionIndex":"0x0", "type":"TxTypeEthereumSetCode", "typeInt":30724, "value":"0x0"}.