syntax = "proto2";

// Sugar for easier handling in Java
option java_package = "com.satoshilabs.trezor.lib.protobuf";
option java_outer_classname = "TrezorMessageMonero";

import "messages-common.proto";


/**
 * Structure representing Monero public address
 */
message MoneroAccountPublicAddress {
    optional bytes spend_public_key = 1;
    optional bytes view_public_key = 2;
}

/**
 * Structure representing Monero transaction destination entry
 */
message MoneroTransactionDestinationEntry {
    optional uint64 amount = 1;
    optional MoneroAccountPublicAddress addr = 2;
    optional bool is_subaddress = 3;
}

/**
 * Structure representing Monero initial transaction information
 */
message MoneroTransactionData {
	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 bool is_multisig = 11;
	optional bytes exp_tx_prefix_hash = 12;
	repeated bytes use_tx_keys = 13;
	optional bool is_bulletproof = 14;
}

/**
 * Structure representing Monero list of sub-addresses
 */
message MoneroSubAddressIndicesList {
    optional uint32 account = 1;
    repeated uint32 minor_indices = 2;
}

/**
 * Structure representing Monero UTXO for key image sync
 */
message MoneroTransferDetails {
    optional bytes out_key = 1;
    optional bytes tx_pub_key = 2;
    repeated bytes additional_tx_pub_keys = 3;
    optional uint64 internal_output_index = 4;
}

/**
 * Structure representing Monero encrypted exported key image
 */
message MoneroExportedKeyImage {
    optional bytes iv = 1;
    optional bytes tag = 2;
    optional bytes blob = 3;
}

/**
 * Request: Ask device for public address derived from seed and address_n
 * @next MoneroAddressAck
 */
message MoneroGetAddressRequest {
    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 uint32 network_type = 3;		// Main-net / testnet / stagenet
	optional uint32 account = 4;            // Major subaddr index
	optional uint32 minor = 5;              // Minor subaddr index
}

/**
 * Response: Contains Monero watch-only credentials derived from device private seed
 * @prev MoneroGetAddressRequest
 */
message MoneroAddressAck {
    optional bytes address = 1;
}

/**
 * Request: Ask device for watch only credentials
 * @next MoneroWatchKeyAck
 */
message MoneroGetWatchKeyRequest {
    repeated uint32 address_n = 1;          // BIP-32 path to derive the key from master node
    optional uint32 network_type = 2;		// Main-net / testnet / stagenet
}

/**
 * Response: Contains Monero watch-only credentials derived from device private seed
 * @prev MoneroGetWatchKey
 */
message MoneroWatchKeyAck {
    optional bytes watch_key = 1;
    optional bytes address = 2;
}

/**
 * Request: Sub request of MoneroTransactionSign. Initializes transaction signing.
 * @next MoneroTransactionInitAck
 */
message MoneroTransactionInitRequest {
    optional uint32 version = 1;
    repeated uint32 address_n = 2;
    optional uint32 network_type = 3;		// Main-net / testnet / stagenet
    optional MoneroTransactionData tsx_data = 4;
}

/**
 * Response: Response to transaction signing initialization.
 * @prev MoneroTransactionInitRequest
 */
message MoneroTransactionInitAck {
    optional uint32 version = 1;
    optional uint32 status = 2;
    optional bool in_memory = 3;
    repeated bytes hmacs = 4;
    optional bool many_inputs = 5;
    optional bool many_outputs = 6;
}

/**
 * Request: Sub request of MoneroTransactionSign. Sends one UTXO to device
 * @next MoneroTransactionSetInputAck
 */
message MoneroTransactionSetInputRequest {
    optional uint32 version = 1;
    optional bytes src_entr = 2;  // xmrtypes.TxSourceEntry
}

/**
 * Response: Response to setting UTXO for signature. Contains sealed values needed for further protocol steps.
 * @prev MoneroTransactionSetInputRequest
 */
message MoneroTransactionSetInputAck {
    optional bytes vini = 1;      // xmrtypes.TxinToKey
    optional bytes vini_hmac = 2;
    optional bytes pseudo_out = 3;
    optional bytes pseudo_out_hmac = 4;
    optional bytes alpha_enc = 5;
    optional bytes spend_enc = 6;
}

/**
 * Request: Sub request of MoneroTransactionSign. Permutation on key images.
 * @next MoneroTransactionInputsPermutationAck
 */
message MoneroTransactionInputsPermutationRequest {
    repeated uint32 perm = 1;
}

/**
 * Response: Response to setting permutation on key images
 * @prev MoneroTransactionInputsPermutationRequest
 */
message MoneroTransactionInputsPermutationAck {

}

/**
 * Request: Sub request of MoneroTransactionSign. Sends one UTXO to device together with sealed values.
 * @next MoneroTransactionInputViniAck
 */
message MoneroTransactionInputViniRequest {
    optional bytes src_entr = 1;  // xmrtypes.TxSourceEntry
    optional bytes vini = 2;      // xmrtypes.TxinToKey
    optional bytes vini_hmac = 3;
    optional bytes pseudo_out = 4;
    optional bytes pseudo_out_hmac = 5;
}

/**
 * Response: Response to setting UTXO to the device
 * @prev MoneroTransactionInputViniRequest
 */
message MoneroTransactionInputViniAck {

}

/**
 * Request: Sub request of MoneroTransactionSign. Sends one transaction destination to device (HMACed)
 * @next MoneroTransactionSetOutputAck
 */
message MoneroTransactionSetOutputRequest {
    optional bytes dst_entr = 1;  // xmrtypes.TxDestinationEntry
    optional bytes dst_entr_hmac = 2;
}

/**
 * Response: Response to setting transaction destination. Contains sealed values needed for further protocol steps.
 * @prev MoneroTransactionSetOutputRequest
 */
message MoneroTransactionSetOutputAck {
    optional bytes tx_out = 1;  // xmrtypes.TxOut
    optional bytes vouti_hmac = 2;
    optional bytes rsig = 3;    // byte-encoded range signature
    optional bytes out_pk = 4;
    optional bytes ecdh_info = 5;
}

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

}

/*
 * Structure represents initial fields of the Monero RCT signature
 */
message MoneroRingCtSig {
    optional uint64 txn_fee = 1;
    optional bytes message = 2;
    optional uint32 rv_type = 3;
}

/**
 * Response: After all outputs are sent the initial RCT signature fields are sent.
 * @prev MoneroTransactionAllOutSetRequest
 */
message MoneroTransactionAllOutSetAck {
    optional bytes extra = 1;
    optional bytes tx_prefix_hash = 2;
    optional MoneroRingCtSig rv = 3;  // xmrtypes.RctSig
}

/**
 * Request: Sub request of MoneroTransactionSign.
 * @next MoneroTransactionMlsagDoneAck
 */
message MoneroTransactionMlsagDoneRequest {

}

/**
 * Response: Contains full message hash needed for the signature
 * @prev MoneroTransactionMlsagDoneRequest
 */
message MoneroTransactionMlsagDoneAck {
    optional bytes full_message_hash = 1;
}

/**
 * Request: Sub request of MoneroTransactionSign. Sends UTXO for the signing.
 * @next MoneroTransactionSignInputAck
 */
message MoneroTransactionSignInputRequest {
    optional bytes src_entr = 1; // xmrtypes.TxSourceEntry
    optional bytes vini = 2;     // xmrtypes.TxinToKey
    optional bytes vini_hmac = 3;
    optional bytes pseudo_out = 4;
    optional bytes pseudo_out_hmac = 5;
    optional bytes alpha_enc = 6;
    optional bytes spend_enc = 7;
}

/**
 * Response: Contains full MG signature of the UTXO + multisig data if applicable.
 * @prev MoneroTransactionSignInputRequest
 */
message MoneroTransactionSignInputAck {
    optional bytes signature = 1;
    optional bytes cout = 2;
}

/**
 * Request: Sub request of MoneroTransactionSign. Final message of the procol after all UTXOs are signed
 * @next MoneroTransactionFinalAck
 */
message MoneroTransactionFinalRequest {

}

/**
 * Response: Contains transaction metadata and encryption keys needed for further transaction operations (e.g. multisig, send proof).
 * @prev MoneroTransactionFinalRequest
 */
message MoneroTransactionFinalAck {
    optional bytes cout_key = 1;
    optional bytes salt = 2;
    optional bytes rand_mult = 3;
    optional bytes tx_enc_keys = 4;
}

/**
 * Request: Wrapping request for transaction signature protocol.
 * @next MoneroTransactionInitAck
 * @next MoneroTransactionSetInputAck
 * @next MoneroTransactionInputsPermutationAck
 * @next MoneroTransactionInputViniAck
 * @next MoneroTransactionSetOutputAck
 * @next MoneroTransactionAllOutSetAck
 * @next MoneroTransactionMlsagDoneAck
 * @next MoneroTransactionSignInputAck
 * @next MoneroTransactionFinalAck
 */
message MoneroTransactionSignRequest {
    optional MoneroTransactionInitRequest init = 1;
    optional MoneroTransactionSetInputRequest set_input = 2;
    optional MoneroTransactionInputsPermutationRequest input_permutation = 3;
    optional MoneroTransactionInputViniRequest input_vini = 4;
    optional MoneroTransactionSetOutputRequest set_output = 5;
    optional MoneroTransactionAllOutSetRequest all_out_set = 6;
    optional MoneroTransactionMlsagDoneRequest mlsag_done = 7;
    optional MoneroTransactionSignInputRequest sign_input = 8;
    optional MoneroTransactionFinalRequest final_msg = 9;
}

/**
 * Request: Sub request of MoneroKeyImageSync. Initializing key image sync.
 * @next MoneroKeyImageExportInitAck
 */
message MoneroKeyImageExportInitRequest {
    optional uint64 num = 1;
    optional bytes hash = 2;
    repeated uint32 address_n = 3;               // BIP-32 path to derive the key from master node
    optional uint32 network_type = 4;		     // Main-net / testnet / stagenet
    repeated MoneroSubAddressIndicesList subs = 5;
}

/**
 * Response: Response to key image sync initialization.
 * @prev MoneroKeyImageExportInitRequest
 */
message MoneroKeyImageExportInitAck {

}

/**
 * Request: Sub request of MoneroKeyImageSync. Contains batch of the UTXO to export key image for.
 * @next MoneroKeyImageSyncStepAck
 */
message MoneroKeyImageSyncStepRequest {
    repeated MoneroTransferDetails tdis = 1;
}

/**
 * Response: Response to key image sync step. Contains encrypted exported key image.
 * @prev MoneroKeyImageSyncStepRequest
 */
message MoneroKeyImageSyncStepAck {
    repeated MoneroExportedKeyImage kis = 1;
}

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

}

/**
 * Response: Response to key image sync step. Contains encryption keys for exported key images.
 * @prev MoneroKeyImageSyncFinalRequest
 */
message MoneroKeyImageSyncFinalAck {
    optional bytes enc_key = 1;
}

/**
 * Request: Wrapping request for key image sync protocol.
 * @next MoneroKeyImageExportInitAck
 * @next MoneroKeyImageSyncStepAck
 * @next MoneroKeyImageSyncFinalAck
 */
message MoneroKeyImageSyncRequest {
    optional MoneroKeyImageExportInitRequest init = 1;
    optional MoneroKeyImageSyncStepRequest step = 2;
    optional MoneroKeyImageSyncFinalRequest final_msg = 3;
}

/**
 * Request: Universal Monero protocol implementation diagnosis request.
 * @next DebugMoneroDiagAck
 */
message DebugMoneroDiagRequest {
    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: Response to Monero diagnosis protocol.
 * @prev DebugMoneroDiagRequest
 */
message 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;
}