package hw.trezor.messages.ethereum

Get desktop application:
View/edit binary Protocol Buffers messages

* Response: Contains an Ethereum address derived from device private seed @end

• optional bytes _old_address = 1

  trezor <1.8.0, <2.1.0 - raw bytes of Ethereum address

• optional string address = 2

  Ethereum address as hex-encoded string

• optional bytes mac = 3

  Address authentication code

* Response: Signed EIP 7702 authorization @end

• required uint32 signature_v = 1

  Computed signature (y parity)

• required bytes signature_r = 2

  Computed signature R component (256 bit)

• required bytes signature_s = 3

  Computed signature S component (256 bit)

* Request: Definitions payload data. `definitions` can be missing if the host did not find matching definitions. @next EthereumTxRequest @next EthereumDefinitionRequest

• optional EthereumDefinitions definitions = 1

* Structure representing a request for extra Ethereum definitions. `token_address` carries the token address for token-definition lookups, or the target contract address when `func_sig` is set and a display format is being requested. @next EthereumDefinitionAck

• required uint64 chain_id = 1

• required bytes token_address = 2

• optional bytes func_sig = 3

* Contains encoded network, token and display format definitions. See external-definitions.md for details. @embed

Used in: EthereumDefinitionAck, EthereumSignAuth7702, EthereumSignTx, EthereumSignTxEIP1559, ethereum_eip712.EthereumSignTypedData

• optional bytes encoded_network = 1

  encoded ethereum network

• optional bytes encoded_token = 2

  encoded ethereum token

• optional bytes encoded_display_format = 3

  encoded display format

* Request: Ask device for Ethereum address corresponding to address_n path @start @next EthereumAddress @next Failure

• repeated uint32 address_n = 1

  BIP-32 path to derive the key from master node

• optional bool show_display = 2

  optionally show on display before sending the result

• optional bytes encoded_network = 3

  encoded Ethereum network, see external-definitions.md for details

• optional bool chunkify = 4

  display the address in chunks of 4 characters

* Request: Ask device for public key corresponding to address_n path @start @next EthereumPublicKey @next Failure

• repeated uint32 address_n = 1

  BIP-32 path to derive the key from master node

• optional bool show_display = 2

  optionally show on display before sending the result

* Response: Signed message @end

• required bytes signature = 2

  signature of the message

• required string address = 3

  address used to sign the message

* Response: Contains public key derived from device private seed @end

• required common.HDNodeType node = 1

  BIP32 public node

• required string xpub = 2

  serialized form of public node

* Request: Ask device to sign an EIP 7702 authorization @start @next EthereumAuth7702Signature @next Failure

• repeated uint32 address_n = 1

  BIP-32 path to derive the key from master node

• required uint64 chain_id = 2

  chain id on which the authorization is valid, or 0 for all

• required string delegate = 3

  address of the code that will be delegated to the EOA

• required uint64 nonce = 4

  account nonce for which the authorization is valid

• optional EthereumDefinitions definitions = 5

  network definitions (for chain ID)

* Request: Ask device to sign message @start @next EthereumMessageSignature @next Failure

• repeated uint32 address_n = 1

  BIP-32 path to derive the key from master node

• required bytes message = 2

  message to be signed

• optional bytes encoded_network = 3

  encoded Ethereum network, see external-definitions.md for details

• optional bool chunkify = 4

  display the address in chunks of 4 characters

* Request: Ask device to sign transaction gas_price, gas_limit and chain_id must be provided and non-zero. All other fields are optional and default to value `0` if missing. Note: the first at most 1024 bytes of data MUST be transmitted as part of this message. @start @next EthereumTxRequest @next Failure

• repeated uint32 address_n = 1

  BIP-32 path to derive the key from master node

• optional bytes nonce = 2

  <=256 bit unsigned big endian

• required bytes gas_price = 3

  <=256 bit unsigned big endian (in wei)

• required bytes gas_limit = 4

  <=256 bit unsigned big endian

• optional string to = 11

  recipient address

• optional bytes value = 6

  <=256 bit unsigned big endian (in wei)

• optional bytes data_initial_chunk = 7

  The initial data chunk (<= 1024 bytes)

• optional uint32 data_length = 8

  Length of transaction payload

• required uint64 chain_id = 9

  Chain Id for EIP 155

• optional uint32 tx_type = 10

  Used for Wanchain

• optional EthereumDefinitions definitions = 12

  network and/or token definitions for tx

• optional bool chunkify = 13

  display the address in chunks of 4 characters

• optional common.PaymentRequest payment_req = 14

  SLIP-24 payment request

• optional bool supports_definition_request = 15

  whether the client supports EthereumDefinitionRequest

* Request: Ask device to sign EIP1559 transaction Note: the first at most 1024 bytes of data MUST be transmitted as part of this message. @start @next EthereumTxRequest @next Failure

• repeated uint32 address_n = 1

  BIP-32 path to derive the key from master node

• required bytes nonce = 2

  <=256 bit unsigned big endian

• required bytes max_gas_fee = 3

  <=256 bit unsigned big endian (in wei)

• required bytes max_priority_fee = 4

  <=256 bit unsigned big endian (in wei)

• required bytes gas_limit = 5

  <=256 bit unsigned big endian

• optional string to = 6

  recipient address

• required bytes value = 7

  <=256 bit unsigned big endian (in wei)

• optional bytes data_initial_chunk = 8

  The initial data chunk (<= 1024 bytes)

• required uint32 data_length = 9

  Length of transaction payload

• required uint64 chain_id = 10

  Chain Id for EIP 155

• repeated EthereumSignTxEIP1559.EthereumAccessList access_list = 11

  Access List

• optional EthereumDefinitions definitions = 12

  network and/or token definitions for tx

• optional bool chunkify = 13

  display the address in chunks of 4 characters

• optional common.PaymentRequest payment_req = 14

  SLIP-24 payment request

• optional bool supports_definition_request = 15

  whether the client supports EthereumDefinitionRequest

Used in: EthereumSignTxEIP1559

• required string address = 1

• repeated bytes storage_keys = 2

* Request: Ask device to sign hash of typed data @start @next EthereumTypedDataSignature @next Failure

• repeated uint32 address_n = 1

  BIP-32 path to derive the key from master node

• required bytes domain_separator_hash = 2

  Hash of domainSeparator of typed data to be signed

• optional bytes message_hash = 3

  Hash of the data of typed data to be signed (empty if domain-only data)

• optional bytes encoded_network = 4

  encoded Ethereum network, see external-definitions.md for details

* Request: Transaction payload data. @next EthereumTxRequest @next EthereumDefinitionRequest

• required bytes data_chunk = 1

  requested number of bytes from transaction payload (<= 1024)

* Response: Device asks for more data from transaction payload, or returns the signature. If data_length is set, device awaits that many more bytes of payload. Otherwise, the signature_* fields contain the computed transaction signature. All three fields will be present. @end @next EthereumTxAck

• optional uint32 data_length = 1

  Request more information

  Number of bytes being requested (<= 1024)

• optional uint32 signature_v = 2

  Done. Return signature.

  Computed signature (recovery parameter, limited to 27 or 28)

• optional bytes signature_r = 3

  Computed signature R component (256 bit)

• optional bytes signature_s = 4

  Computed signature S component (256 bit)

* Response: Signed typed data @end

• required bytes signature = 1

  signature of the typed data

• required string address = 2

  address used to sign the typed data

* Request: Ask device to verify message @start @next Success @next Failure

• required bytes signature = 2

  signature to verify

• required bytes message = 3

  message to verify

• required string address = 4

  address to verify

• optional bool chunkify = 5

  display the address in chunks of 4 characters