2020-07-02 08:22:45 +00:00
|
|
|
<!--
|
2021-08-17 14:11:26 +00:00
|
|
|
order: 3
|
2020-07-02 08:22:45 +00:00
|
|
|
-->
|
|
|
|
|
|
2021-08-19 10:23:33 +00:00
|
|
|
# Transaction Lifecycle
|
2020-07-02 08:22:45 +00:00
|
|
|
|
2021-08-19 10:23:33 +00:00
|
|
|
This document describes the lifecycle of a transaction from creation to committed state changes on the EVM. {synopsis}
|
|
|
|
|
|
2021-09-04 10:18:32 +00:00
|
|
|
## Pre-requisite Readings
|
2021-08-19 10:23:33 +00:00
|
|
|
|
|
|
|
|
- [SDK transaction lifecycle](https://docs.cosmos.network/master/basics/tx-lifecycle.html) {prereq}
|
|
|
|
|
|
|
|
|
|
<!-- TODO: rewrite. This is not a lifecycle doc -->
|
2020-07-02 08:22:45 +00:00
|
|
|
## Routing
|
|
|
|
|
|
2021-08-19 10:23:33 +00:00
|
|
|
Ethermint needs to parse and handle transactions routed for both the EVM and for Cosmos SDK modules. We
|
2021-08-03 17:35:31 +00:00
|
|
|
attempt to achieve this by mimicking [geth's](https://github.com/ethereum/go-ethereum) `Transaction`
|
2020-07-02 08:22:45 +00:00
|
|
|
structure and treat it as a unique Cosmos SDK message type. An Ethereum transaction is a single
|
2021-08-03 17:35:31 +00:00
|
|
|
[`sdk.Msg`](https://godoc.org/github.com/cosmos/cosmos-sdk/types#Msg). All relevant Ethereum
|
2020-07-02 08:22:45 +00:00
|
|
|
transaction information is contained in this message. This includes the signature, gas, payload,
|
2021-08-03 17:35:31 +00:00
|
|
|
amount, etc.
|
2020-07-02 08:22:45 +00:00
|
|
|
|
|
|
|
|
Being that Ethermint implements the Tendermint ABCI application interface, as transactions are
|
|
|
|
|
consumed, they are passed through a series of handlers. Once such handler, the `AnteHandler`, is
|
|
|
|
|
responsible for performing preliminary message execution business logic such as fee payment,
|
|
|
|
|
signature verification, etc. This is particular to Cosmos SDK routed transactions. Ethereum routed
|
|
|
|
|
transactions will bypass this as the EVM handles the same business logic.
|
|
|
|
|
|
2021-08-03 17:35:31 +00:00
|
|
|
All EVM transactions are [RLP](./../core/encoding.md#rlp) encoded using a custom tx encoder.
|
2020-07-02 08:22:45 +00:00
|
|
|
|
2021-08-03 17:35:31 +00:00
|
|
|
## Signers
|
2020-07-02 08:22:45 +00:00
|
|
|
|
2021-08-03 17:35:31 +00:00
|
|
|
The signature processing and verification in Ethereum is performed by the `Signer` interface. The
|
|
|
|
|
protocol supports different signer types based on the chain configuration params and the block number.
|
2020-07-02 08:22:45 +00:00
|
|
|
|
2021-08-03 17:35:31 +00:00
|
|
|
+++ https://github.com/ethereum/go-ethereum/blob/v1.10.3/core/types/transaction_signing.go#L145-L166
|
2020-07-02 08:22:45 +00:00
|
|
|
|
2021-08-03 17:35:31 +00:00
|
|
|
Ethermint supports all Ethereum `Signer`s up to the latest go-ethereum version (London, Berlin,
|
|
|
|
|
EIP155, Homestead and Frontier). The chain will generate the latest `Signer` type depending on the
|
|
|
|
|
`ChainConfig`.
|
