Transactions

Transactions are essential on the Sei blockchain for any state updates, including token transfers, account linking, and smart contract execution. While creating an account doesn’t require a transaction, associating an account with blockchain actions does.

Each transaction is signed with the sender’s private key to verify authenticity and ownership. For more on private keys, see HD Paths and Coin Types.

Transaction Types

Since Sei supports both EVM and Cosmos SDK transactions, there are different transaction types based on the execution environment. The following sections provide an overview of Cosmos and EVM transactions on Sei.

Cosmos Transactions

Cosmos transactions are used for interacting with Cosmos based RPC's and tooling. They consist of the body, auth info, and signatures.

{
      "body": {
        "messages": [
          {
            "@type": "/cosmos.bank.v1beta1.MsgSend",
            "from_address": "sei1tgaen946qle7lttgjjfwea9qq02y6f8j7nkxry",
            "to_address": "SENDER_ADDRESS",
            "amount": [
              {
                "denom": "usei",
                "amount": "1000"
              }
            ]
          }
        ],
        "memo": "",
        "timeout_height": "0",
        "extension_options": [],
        "non_critical_extension_options": []
      },
      "auth_info": {
        "signer_infos": [
          {
            "public_key": {
              "@type": "/cosmos.crypto.secp256k1.PubKey",
              "key": "A807McXECLx88ANdcwysZSVeelx0gNpYChBJZe8kya9X"
            },
            "mode_info": {
              "single": {
                "mode": "SIGN_MODE_DIRECT"
              }
            },
            "sequence": "0"
          }
        ],
        "fee": {
          "amount": [],
          "gas_limit": "200000",
          "payer": "",
          "granter": ""
        }
      },
      "signatures": ["SIGNER_SIGNATURE_VALUE"]
}

Signing Cosmos Transactions

Cosmos transactions on the Sei blockchain follow the standard Cosmos SDK format. They include various types of messages that can be included in the transaction body.

Using the seid CLI, you can use the --generate-only flag to generate an unsigned transaction in JSON format. The transaction can then be signed and broadcasted to the network.

Assuming you have an unsigned JSON transaction file, you can sign it using the seid tx sign command. The signed transaction will be in JSON format and can be broadcasted to the network.

seid tx sign unsigned_tx.json --chain-id my-test-chain --keyring-backend test --from $SIGNER_ADDRESS

EVM Transactions

The Sei blockchain supports Ethereum Virtual Machine (EVM) transactions, allowing compatibility with Ethereum-based tools and contracts. EVM transactions follow a different structure compared to Cosmos transactions.

{
	id: 2,
	jsonrpc: '2.0',
	method: 'account_signTransaction',
	params: [
		{
			from: '0x1923f626bb8dc025849e00f99c25fe2b2f7fb0db',
			gas: '0x55555',
			maxFeePerGas: '0x1234',
			maxPriorityFeePerGas: '0x1234',
			input: '0xabcd',
			nonce: '0x0',
			to: '0x07a565b7ed7d7a678680a4c162885bedbb695fe0',
			value: '0x1234'
		}
	]
}