enclave.proto

syntax = "proto3";

option go_package = "enclave/rpc/generated";

package generated;

// todo (low priority) - remove these comments which duplicate those in common/enclave.go.
service EnclaveProto {
  // Status is used to check whether the server is ready for requests.
  rpc Status(StatusRequest) returns (StatusResponse) {}

  // Attestation - Produces an attestation report which will be used to request the shared secret from another enclave.
  rpc Attestation(AttestationRequest) returns (AttestationResponse) {}

  // GenerateSecret - the genesis enclave is responsible with generating the secret entropy
  rpc GenerateSecret(GenerateSecretRequest) returns (GenerateSecretResponse) {}

  // Init - initialise an enclave with a seed received by another enclave
  rpc InitEnclave(InitEnclaveRequest) returns (InitEnclaveResponse) {}

  // EnclaveID - request the EnclaveID from the enclave
  rpc EnclaveID(EnclaveIDRequest) returns (EnclaveIDResponse) {}

  // SubmitL1Block - Used for the host to submit blocks to the enclave, these may be:
  //  a. historic block - if the enclave is behind and in the process of catching up with the L1 state
  //  b. the latest block published by the L1, to which the enclave should respond with a rollup
  // It is the responsibility of the host to gossip the returned rollup
  // For good functioning the caller should always submit blocks ordered by height
  // submitting a block before receiving ancestors of it, will result in it being ignored
  rpc SubmitL1Block(SubmitBlockRequest) returns (SubmitBlockResponse) {}

  // SubmitTx - user transactions
  rpc SubmitTx(SubmitTxRequest) returns (SubmitTxResponse) {}

  // SubmitBatch submits a batch received from the sequencer for processing.
  rpc SubmitBatch(SubmitBatchRequest) returns (SubmitBatchResponse) {}

  // ObsCall - returns the result of executing the smart contract as a user, encrypted with the
  // viewing key corresponding to the `from` field
  rpc ObsCall(ObsCallRequest) returns (ObsCallResponse) {}

  // GetTransactionCount - returns the nonce of the wallet with the given address.
  rpc GetTransactionCount(GetTransactionCountRequest) returns (GetTransactionCountResponse) {}

  // Stop gracefully stops the enclave
  rpc Stop(StopRequest) returns (StopResponse) {}

  // GetTransaction returns a transaction given its Signed Hash, returns nil, false when Transaction is unknown
  rpc GetTransaction(GetTransactionRequest) returns (GetTransactionResponse) {}

  // GetTransaction returns a transaction receipt given the transaction's signed hash, encrypted with the viewing key
  // corresponding to the original transaction submitter
  rpc GetTransactionReceipt(GetTransactionReceiptRequest) returns (GetTransactionReceiptResponse) {}

  // GetBalance returns the address's balance on the Obscuro network, encrypted with the viewing key corresponding to
  // the address
  rpc GetBalance(GetBalanceRequest) returns (GetBalanceResponse) {}

  // GetCode returns the code stored at the given address in the state for the given rollup height or rollup hash
  rpc GetCode(GetCodeRequest) returns (GetCodeResponse) {}

  rpc GetStorageSlot(GetStorageSlotRequest) returns (GetStorageSlotResponse) {}


  rpc Subscribe(SubscribeRequest) returns (SubscribeResponse) {}

  rpc Unsubscribe(UnsubscribeRequest) returns (UnsubscribeResponse) {}

  // EstimateGas returns the estimation of gas used for the given transactions
  rpc EstimateGas(EstimateGasRequest) returns (EstimateGasResponse) {}

  rpc GetLogs(GetLogsRequest) returns (GetLogsResponse) {}

  // HealthCheck returns the health status of enclave + db
  rpc HealthCheck(EmptyArgs) returns (HealthCheckResponse) {}

  // GetBatch returns the encrypted batch based on a hash
  rpc GetBatch(GetBatchRequest) returns (GetBatchResponse) {}

  // GetBatch returns the encrypted batch based on a hash
  rpc GetBatchBySeqNo(GetBatchBySeqNoRequest) returns (GetBatchResponse) {}

  // GetRollupData returns the first batch sequence number in the rollup and the timestamp
  rpc GetRollupData(GetRollupDataRequest) returns (GetRollupDataResponse) {}

  rpc CreateBatch(CreateBatchRequest) returns (CreateBatchResponse) {}

  rpc CreateRollup(CreateRollupRequest) returns (CreateRollupResponse) {}

  rpc ExportCrossChainData(ExportCrossChainDataRequest) returns (ExportCrossChainDataResponse) {}

  rpc DebugTraceTransaction(DebugTraceTransactionRequest) returns (DebugTraceTransactionResponse) {}

  rpc StreamL2Updates(StreamL2UpdatesRequest) returns (stream EncodedUpdateResponse) {}

  rpc DebugEventLogRelevancy(DebugEventLogRelevancyRequest) returns (DebugEventLogRelevancyResponse) {}

  rpc GetTotalContractCount(GetTotalContractCountRequest) returns (GetTotalContractCountResponse) {}

  rpc GetReceiptsByAddress(GetReceiptsByAddressRequest) returns (GetReceiptsByAddressResponse) {}

  // EnclavePublicConfig returns public network data that is known to the enclave but may not be known to the host
  rpc EnclavePublicConfig(EnclavePublicConfigRequest) returns (EnclavePublicConfigResponse) {}
}

message EnclavePublicConfigRequest {}

message EnclavePublicConfigResponse{
  bytes l2MessageBusAddress = 1;
  bytes transactionPostProcessorAddress = 2;
  SystemError systemError = 3;
}

message GetReceiptsByAddressRequest {
  bytes encryptedParams = 1;
}

message GetReceiptsByAddressResponse{
  bytes encodedEnclaveResponse = 1;
  SystemError systemError = 2;
}

message GetBatchRequest {
  bytes knownHead = 1;
}

message GetBatchBySeqNoRequest {
  uint64 seqNo = 1;
}

message GetBatchResponse {
  bytes batch = 1;
  SystemError systemError = 2;
}

message GetRollupDataRequest {
  bytes hash = 1;
}

message GetRollupDataResponse {
  PublicRollupDataMsg msg = 1;
  SystemError systemError = 2;
}

message PublicRollupDataMsg {
  uint64 startSeq = 1;
  uint64 timestamp = 2;
}

message StreamL2UpdatesRequest {}

message EncodedUpdateResponse {
  bytes batch = 1;
}

message Pagination{
  int32 offset = 1;
  int32 size = 2;
}

message SystemError{
  int32 errorCode = 1;
  string errorString = 2;
}

message GetTotalContractCountRequest {}

message GetTotalContractCountResponse{
  int64 count = 1;
  SystemError systemError = 2;
}

message DebugEventLogRelevancyRequest{
  bytes txHash = 1;
}

message DebugEventLogRelevancyResponse{
  string msg = 1;
  SystemError systemError = 2;
}

message DebugTraceTransactionRequest{
  bytes txHash = 1;
  bytes config = 2;
}
message DebugTraceTransactionResponse{
  string msg = 1;
  SystemError systemError = 2;
}

message CreateBatchRequest{
  bool skipIfEmpty = 1;
}
message CreateBatchResponse{
  string error = 2;
}

message CreateRollupRequest{
  optional uint64 fromSequenceNumber = 1;
}

message CreateRollupResponse{
  ExtRollupMsg msg = 1;
  SystemError systemError = 2;
}

message ExportCrossChainDataRequest {
  uint64 fromSeqNo = 1;
  uint64 toSeqNo = 2;
}

message ExportCrossChainDataResponse {
  bytes msg = 1;
}

message StatusRequest {}
message StatusResponse {
  int32 statusCode = 1;
  bytes l1Head = 2; // hash for the L1 head block in enclave's view of the canonical chain
  bytes l2Head = 3; // seq number (big.Int) for the L2 head batch that the enclave has seen
  SystemError systemError = 4;
}

message AttestationRequest {}
message AttestationResponse {
  AttestationReportMsg attestationReportMsg = 1;
  SystemError systemError = 2;
}

message GenerateSecretRequest {}
message GenerateSecretResponse {
  bytes encryptedSharedEnclaveSecret = 1;
  SystemError systemError = 2;
}

message InitEnclaveRequest {
  bytes encryptedSharedEnclaveSecret = 1;
}
message InitEnclaveResponse {
  SystemError systemError = 1;
}

message EnclaveIDRequest {}
message EnclaveIDResponse {
  bytes enclaveID = 1;
  SystemError systemError = 2;
}

message StartRequest {
  bytes encodedBlock = 1;
}
message StartResponse {
  SystemError systemError = 1;
}

message SubmitBlockRequest {
  bytes encodedBlock = 1;
  bytes encodedReceipts = 2;
  bool isLatest = 3;

}
message SubmitBlockResponse {
  BlockSubmissionResponseMsg blockSubmissionResponse = 1;
  SystemError systemError = 2;
}

message SubmitTxRequest {
  bytes encryptedTx = 1;
}
message SubmitTxResponse {
  bytes encodedEnclaveResponse = 1;
  SystemError systemError = 2;
}

message SubmitBatchRequest {
  ExtBatchMsg batch = 1;
}
message SubmitBatchResponse {
  SystemError systemError = 1;
}

message ObsCallRequest {
  bytes encryptedParams = 1;
}
message ObsCallResponse {
  bytes encodedEnclaveResponse = 1;
  SystemError systemError = 2;
}

message GetTransactionCountRequest {
  bytes encryptedParams = 1;
}
message GetTransactionCountResponse {
  bytes encodedEnclaveResponse = 1;
  SystemError systemError = 2;
}

message StopRequest {}
message StopResponse {
  SystemError systemError = 1;
}

message GetTransactionRequest {
  bytes encryptedParams = 1;
}
message GetTransactionResponse {
  bytes encodedEnclaveResponse = 1;
  SystemError systemError = 2;
}

message GetTransactionReceiptRequest {
  bytes encryptedParams = 1;
}
message GetTransactionReceiptResponse {
  bytes encodedEnclaveResponse = 1;
  SystemError systemError = 2;
}

message GetBalanceRequest {
  bytes encryptedParams = 1;
}
message GetBalanceResponse {
  bytes encodedEnclaveResponse = 1;
  SystemError systemError = 2;
}

message GetStorageSlotRequest {
  bytes encryptedParams = 1;
}
message GetStorageSlotResponse {
  bytes encodedEnclaveResponse = 1;
  SystemError systemError = 2;
}

message GetCodeRequest {
  bytes address = 1;
  bytes rollupHash = 2;
}
message GetCodeResponse {
  bytes code = 1;
  SystemError systemError = 2;
}

message SubscribeRequest {
  bytes id = 1;
  bytes encryptedSubscription = 2;
}
message SubscribeResponse {
  SystemError systemError = 2;
}

message UnsubscribeRequest {
  bytes id = 1;
}
message UnsubscribeResponse {
  SystemError systemError = 2;
}

message EstimateGasRequest {
  bytes encryptedParams = 1;
}

message EstimateGasResponse {
  bytes encodedEnclaveResponse = 1;
  SystemError systemError = 2;
}

message GetLogsRequest {
  bytes encryptedParams = 1;
}

message GetLogsResponse {
  bytes encodedEnclaveResponse = 1;
  SystemError systemError = 2;
}

message HealthCheckResponse {
  bool status = 1;
  SystemError systemError = 2;
}

message EmptyArgs {}

// Nested message types.

message AttestationReportMsg {
  bytes Report = 1; // The actual report bytes so it can be shared and verified by other nodes
  bytes PubKey = 2; // Public key to encrypt traffic back to this enclave
  bytes EnclaveID = 3;
  string HostAddress = 4; // The IP address on which the host can be contacted by other Obscuro hosts for peer-to-peer communication
  SystemError systemError = 5;
}

message BlockSubmissionResponseMsg {
  repeated SecretResponseMsg producedSecretResponses = 1;
  BlockSubmissionErrorMsg error = 2; // todo (@matt) - remove this BlockSubmissionError field once we are using the Status() to update host view of enclave state
}

message BlockSubmissionErrorMsg {
  string cause = 1; // error cause description
  bytes l1Head = 2; // hash for the L1 head block in enclave's view of the canonical chain
}

message CrossChainMsg {
  bytes Sender = 1;
  uint64 Sequence = 2;
  uint32 Nonce = 3;
  uint32 Topic = 4;
  bytes Payload = 5;
}

message ExtBatchMsg {
  BatchHeaderMsg header = 1;
  repeated bytes txHashes = 2;
  bytes txs = 3;
}

message BatchHeaderMsg {
  bytes ParentHash = 1;
  bytes Proof = 2;
  bytes Root = 3;
  bytes TxHash = 4;
  uint64 Number = 5;
  uint64 SequencerOrderNo = 6;
  bytes ReceiptHash = 7;
  bytes Extra = 8;
  bytes Signature = 9;
  uint64 GasLimit = 10;
  uint64 GasUsed = 11;
  uint64 Time = 12;
  uint64 BaseFee = 13;
  bytes LatestInboundCrossChainHeight = 14;
  bytes LatestInboundCrossChainHash = 15;
  repeated CrossChainMsg CrossChainMessages = 16;
  bytes TransferTree = 17;
  bytes Coinbase = 18;
  bytes CrossChainTree = 19;
}

message ExtRollupMsg {
  RollupHeaderMsg header = 1;
  bytes batchPayloads = 2;
  bytes calldataRollupHeader = 3;
}

message RollupHeaderMsg {
  bytes ParentHash = 1;
  bytes CompressionL1Head = 2;
  uint64 ProofNumber = 3;
  uint64 Number = 4;
  uint64 Time = 5;
  bytes EnclaveID = 6;
  repeated CrossChainMsg CrossChainMessages = 7;
  bytes Signature = 8;
  uint64 LastBatchSeqNo = 9;
}

message SecretResponseMsg {
  bytes Secret = 1;
  bytes RequesterID = 2;
  bytes AttesterID = 3;
  string HostAddress = 4;
  SystemError systemError = 5;
}

message WithdrawalMsg {
  bytes amount = 1;
  bytes recipient = 2;
  bytes contract = 3;
}