package hw.trezor.messages.monero

Get desktop application:
View/edit binary Protocol Buffers messages

* Response: Response to Monero diagnosis protocol. @end

• optional uint64 ins = 1

• optional uint64 p1 = 2

• optional uint64 p2 = 3

• repeated uint64 pd = 4

• optional bytes data1 = 5

• optional bytes data2 = 6

* Request: Universal Monero protocol implementation diagnosis request. @start @next DebugMoneroDiagAck

• optional uint64 ins = 1

• optional uint64 p1 = 2

• optional uint64 p2 = 3

• repeated uint64 pd = 4

• optional bytes data1 = 5

• optional bytes data2 = 6

* Response: Contains Monero watch-only credentials derived from device private seed @end

• required bytes address = 1

* Request: Ask device for public address derived from seed and address_n @start @next MoneroAddress @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 MoneroNetworkType network_type = 3

  Network type

• optional uint32 account = 4

  Major subaddr index

• optional uint32 minor = 5

  Minor subaddr index

• optional bytes payment_id = 6

  Payment ID for integrated address

• optional bool chunkify = 7

  display the address in chunks of 4 characters

* Response: Response with the re-encrypted private keys and derivations blob under view key @end

• optional bytes salt = 1

• optional bytes tx_keys = 2

• optional bytes tx_derivations = 3

* Request: Decrypt tx private keys blob @next MoneroGetTxKeyAck

• repeated uint32 address_n = 1

  BIP-32 path to derive the key from master node

• optional MoneroNetworkType network_type = 2

  network type

• required bytes salt1 = 3

• required bytes salt2 = 4

• required bytes tx_enc_keys = 5

• required bytes tx_prefix_hash = 6

• optional uint32 reason = 7

  reason to display for user. e.g., tx_proof

• optional bytes view_public_key = 8

  addr for derivation

* Request: Ask device for watch only credentials @start @next MoneroWatchKey @next Failure

• repeated uint32 address_n = 1

  BIP-32 path to derive the key from master node

• optional MoneroNetworkType network_type = 2

  Network type

* Response: Response to key image sync initialization. @next MoneroKeyImageSyncStepRequest

(message has no fields)

* Request: Sub request of MoneroKeyImageSync. Initializing key image sync. @start @next MoneroKeyImageExportInitAck

• required uint64 num = 1

• required bytes hash = 2

• repeated uint32 address_n = 3

  BIP-32 path to derive the key from master node

• optional MoneroNetworkType network_type = 4

  network type

• repeated MoneroKeyImageExportInitRequest.MoneroSubAddressIndicesList subs = 5

* Structure representing Monero list of sub-addresses

Used in: MoneroKeyImageExportInitRequest

• required uint32 account = 1

• repeated uint32 minor_indices = 2

* Response: Response to key image sync step. Contains encryption keys for exported key images. @end

• optional bytes enc_key = 1

* Request: Sub request of MoneroKeyImageSync. Final message of the sync protocol. @next MoneroKeyImageSyncFinalAck

(message has no fields)

* Response: Response to key image sync step. Contains encrypted exported key image. @next MoneroKeyImageSyncStepRequest @next MoneroKeyImageSyncFinalRequest

• repeated MoneroKeyImageSyncStepAck.MoneroExportedKeyImage kis = 1

* Structure representing Monero encrypted exported key image

Used in: MoneroKeyImageSyncStepAck

• optional bytes iv = 1

• optional bytes blob = 3

* Request: Sub request of MoneroKeyImageSync. Contains batch of the UTXO to export key image for. @next MoneroKeyImageSyncStepAck

• repeated MoneroKeyImageSyncStepRequest.MoneroTransferDetails tdis = 1

* Structure representing Monero UTXO for key image sync

Used in: MoneroKeyImageSyncStepRequest

• required bytes out_key = 1

• required bytes tx_pub_key = 2

• repeated bytes additional_tx_pub_keys = 3

• required uint64 internal_output_index = 4

• optional uint32 sub_addr_major = 5

• optional uint32 sub_addr_minor = 6

* Response: Response on termination of live refresh mode. @end

(message has no fields)

* Request: Request terminating live refresh mode. @next MoneroLiveRefreshFinishedAck

(message has no fields)

* Response after user gave permission @next MoneroLiveRefreshStepRequest @next MoneroLiveRefreshFinalRequest

(message has no fields)

* Request: Starts live refresh flow. Asks user permission, switches state @next MoneroLiveRefreshStartAck

• repeated uint32 address_n = 1

  BIP-32 path to derive the key from master node

• optional MoneroNetworkType network_type = 2

  network type

* Response: Response with the encrypted key image + signature @next MoneroLiveRefreshStepRequest @next MoneroLiveRefreshFinishedRequest

• optional bytes salt = 1

• optional bytes key_image = 2

* Request: Request to compute a single key image during live sync @next MoneroLiveRefreshStepAck

• required bytes out_key = 1

• required bytes recv_deriv = 2

• required uint64 real_out_idx = 3

• required uint32 sub_addr_major = 4

• required uint32 sub_addr_minor = 5

Used in: MoneroGetAddress, MoneroGetTxKeyRequest, MoneroGetWatchKey, MoneroKeyImageExportInitRequest, MoneroLiveRefreshStartRequest, MoneroTransactionInitRequest

• MAINNET = 0

• TESTNET = 1

• STAGENET = 2

• FAKECHAIN = 3

* Response: Response to after all inputs have been set. @next MoneroTransactionSetOutputRequest

• optional MoneroTransactionRsigData rsig_data = 1

* Request: Sub request of MoneroTransactionSign. Sent after all inputs have been sent. Useful for rangesig offloading. @next MoneroTransactionAllInputsSetAck

(message has no fields)

* Response: After all outputs are sent the initial RCT signature fields are sent. @next MoneroTransactionSignInputRequest

• optional bytes extra = 1

• optional bytes tx_prefix_hash = 2

• optional MoneroTransactionAllOutSetAck.MoneroRingCtSig rv = 4

  xmrtypes.RctSig

• optional bytes full_message_hash = 5

Structure represents initial fields of the Monero RCT signature

Used in: MoneroTransactionAllOutSetAck

• optional uint64 txn_fee = 1

• optional bytes message = 2

• optional uint32 rv_type = 3

* Request: Sub request of MoneroTransactionSign. Sent after all outputs are sent. @next MoneroTransactionAllOutSetAck

• optional MoneroTransactionRsigData rsig_data = 1

* Structure representing Monero transaction destination entry @embed

Used in: MoneroTransactionInitRequest.MoneroTransactionData, MoneroTransactionSetOutputRequest

• optional uint64 amount = 1

• optional MoneroTransactionDestinationEntry.MoneroAccountPublicAddress addr = 2

• optional bool is_subaddress = 3

• optional bytes original = 4

• optional bool is_integrated = 5

* Structure representing Monero public address

Used in: MoneroTransactionDestinationEntry

• optional bytes spend_public_key = 1

• optional bytes view_public_key = 2

* Response: Contains transaction metadata and encryption keys needed for further transaction operations (e.g. multisig, send proof). @end

• optional bytes cout_key = 1

• optional bytes salt = 2

• optional bytes rand_mult = 3

• optional bytes tx_enc_keys = 4

• optional bytes opening_key = 5

  enc master key to decrypt CLSAGs after protocol finishes correctly

* Request: Sub request of MoneroTransactionSign. Final message of the protocol after all UTXOs are signed @next MoneroTransactionFinalAck

(message has no fields)

* Response: Response to transaction signing initialization. @next MoneroTransactionSetInputRequest

• repeated bytes hmacs = 1

• optional MoneroTransactionRsigData rsig_data = 2

* Request: Sub request of MoneroTransactionSign. Initializes transaction signing. @start @next MoneroTransactionInitAck

• optional uint32 version = 1

• repeated uint32 address_n = 2

• optional MoneroNetworkType network_type = 3

  Network type

• optional MoneroTransactionInitRequest.MoneroTransactionData tsx_data = 4

* Structure representing Monero initial transaction information

Used in: MoneroTransactionInitRequest

• optional uint32 version = 1

• optional bytes payment_id = 2

• optional uint64 unlock_time = 3

• repeated MoneroTransactionDestinationEntry outputs = 4

• optional MoneroTransactionDestinationEntry change_dts = 5

• optional uint32 num_inputs = 6

• optional uint32 mixin = 7

• optional uint64 fee = 8

• optional uint32 account = 9

• repeated uint32 minor_indices = 10

• optional MoneroTransactionRsigData rsig_data = 11

• repeated uint32 integrated_indices = 12

• optional uint32 client_version = 13

  connected client version

• optional uint32 hard_fork = 14

  transaction hard fork number

• optional bytes monero_version = 15

  monero software version

• optional bool chunkify = 16

  display the address in chunks of 4 characters

* Response: Response to setting UTXO to the device @next MoneroTransactionInputViniRequest @next MoneroTransactionAllInputsSetRequest

(message has no fields)

* Request: Sub request of MoneroTransactionSign. Sends one UTXO to device together with sealed values. @next MoneroTransactionInputViniAck

• optional MoneroTransactionSourceEntry src_entr = 1

• optional bytes vini = 2

  xmrtypes.TxinToKey

• optional bytes vini_hmac = 3

• optional bytes pseudo_out = 4

• optional bytes pseudo_out_hmac = 5

• optional uint32 orig_idx = 6

  original sort index, before sorting by key-images

* Range sig parameters / data. @embed

Used in: MoneroTransactionAllInputsSetAck, MoneroTransactionAllOutSetRequest, MoneroTransactionInitAck, MoneroTransactionInitRequest.MoneroTransactionData, MoneroTransactionSetOutputAck, MoneroTransactionSetOutputRequest

• optional uint32 rsig_type = 1

  range signature (aka proof) type

• optional uint32 offload_type = 2

• repeated uint64 grouping = 3

  aggregation scheme for BP

• optional bytes mask = 4

  mask vector

• optional bytes rsig = 5

  range sig data, all of it or partial (based on rsig_parts)

• repeated bytes rsig_parts = 6

• optional uint32 bp_version = 7

  Bulletproof version

* Response: Response to setting UTXO for signature. Contains sealed values needed for further protocol steps. @next MoneroTransactionSetInputAck @next MoneroTransactionInputViniRequest

• optional bytes vini = 1

  xmrtypes.TxinToKey

• optional bytes vini_hmac = 2

• optional bytes pseudo_out = 3

• optional bytes pseudo_out_hmac = 4

• optional bytes pseudo_out_alpha = 5

• optional bytes spend_key = 6

* Request: Sub request of MoneroTransactionSign. Sends one UTXO to device @next MoneroTransactionSetInputAck

• optional MoneroTransactionSourceEntry src_entr = 1

* Response: Response to setting transaction destination. Contains sealed values needed for further protocol steps. @next MoneroTransactionSetOutputRequest @next MoneroTransactionAllOutSetRequest

• optional bytes tx_out = 1

  xmrtypes.TxOut

• optional bytes vouti_hmac = 2

• optional MoneroTransactionRsigData rsig_data = 3

• optional bytes out_pk = 4

• optional bytes ecdh_info = 5

* Request: Sub request of MoneroTransactionSign. Sends one transaction destination to device (HMACed) @next MoneroTransactionSetOutputAck

• optional MoneroTransactionDestinationEntry dst_entr = 1

• optional bytes dst_entr_hmac = 2

• optional MoneroTransactionRsigData rsig_data = 3

• optional bool is_offloaded_bp = 4

  Extra message, with offloaded BP.

* Response: Contains full MG signature of the UTXO + multisig data if applicable. @next MoneroTransactionSignInputRequest @next MoneroTransactionFinalRequest

• optional bytes signature = 1

• optional bytes pseudo_out = 2

  updated pseudo-out after mask correction

* Request: Sub request of MoneroTransactionSign. Sends UTXO for the signing. @next MoneroTransactionSignInputAck

• optional MoneroTransactionSourceEntry src_entr = 1

• optional bytes vini = 2

  xmrtypes.TxinToKey

• optional bytes vini_hmac = 3

• optional bytes pseudo_out = 4

• optional bytes pseudo_out_hmac = 5

• optional bytes pseudo_out_alpha = 6

• optional bytes spend_key = 7

• optional uint32 orig_idx = 8

  original sort index, before sorting by key-images

* Structure representing Monero transaction source entry, UTXO @embed

Used in: MoneroTransactionInputViniRequest, MoneroTransactionSetInputRequest, MoneroTransactionSignInputRequest

• repeated MoneroTransactionSourceEntry.MoneroOutputEntry outputs = 1

  all outputs including decoys (forms the ring)

• optional uint64 real_output = 2

  index denoting which item in `outputs` is our real output (not a decoy)

• optional bytes real_out_tx_key = 3

  tx key located in the real output's tx

• repeated bytes real_out_additional_tx_keys = 4

  additional tx keys if applicable

• optional uint64 real_output_in_tx_index = 5

  index of our real output in the tx

• optional uint64 amount = 6

  (aka which output was it in the transaction)

• optional bool rct = 7

  is RingCT used (true for newer UTXOs)

• optional bytes mask = 8

• optional MoneroTransactionSourceEntry.MoneroMultisigKLRki multisig_kLRki = 9

• optional uint32 subaddr_minor = 10

  minor subaddr index UTXO was sent to

Used in: MoneroTransactionSourceEntry

• optional bytes K = 1

• optional bytes L = 2

• optional bytes R = 3

• optional bytes ki = 4

Used in: MoneroTransactionSourceEntry

• optional uint64 idx = 1

• optional MoneroOutputEntry.MoneroRctKeyPublic key = 2

Used in: MoneroOutputEntry

• required bytes dest = 1

• required bytes commitment = 2

* Response: Contains Monero watch-only credentials derived from device private seed @end

• required bytes watch_key = 1

• required bytes address = 2