@clonegod/ttd-sui-common 1.0.6 → 1.0.8

package/dist/grpc/protos/sui/rpc/v2beta2/README.md

@@ -0,0 +1,123 @@
+## Overview
+This package defines a number of APIs for interacting with services in the Sui
+ecosystem. Some of the below API semantics and guidelines are inspired by
+[Google's AIPs](https://google.aip.dev/) and apply to all services in this
+package. For information on the individual services themselves, see their
+definitions:
+
+- [`LedgerService`](./ledger_service.proto)
+- [`LiveDataService`](./live_data_service.proto)
+- [`MovePackageService`](./move_package_service.proto.proto)
+- [`SignatureVerificationService`](./signature_verification_service.proto)
+- [`SubscriptionService`](./subscription_service.proto.proto)
+- [`TransactionExecutionService`](./transaction_execution_service.proto.proto)
+
+## Encoding
+In order to improve usability of these APIs a number of identifiers are
+encoding in messages in this package using their human-readable string
+representations instead of a more compact bytes representation.
+
+- `Address` and `ObjectId`: Represented as 64 hexadecimal characters with a
+  leading `0x`.
+- `Digest`s: Represented as
+  [Base58](https://learnmeabitcoin.com/technical/keys/base58/).
+- `TypeTag` and `StructTag`: Represented in their canonical string format (for
+  example,
+  `0x0000000000000000000000000000000000000000000000000000000000000002::coin::Coin<0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI>`)
+
+## Field Masks and Partial Responses
+Some APIs may return resources that are either larger or expensive to compute
+and the API may want to give the user control over which fields it returns.
+
+In such circumstances Field Masks
+[(google.protobuf.FieldMask)](../../../google/protobuf/field_mask.proto) can be
+used for granting the user fine-grained control over what fields are returned.
+
+For APIs where Field Masks are supported:
+
+- The field masks must be a google.protobuf.FieldMask and should be named
+  `read_mask`.
+- The field mask parameter must be optional:
+    - An explicit value of `"*"` should be supported, and must return all
+      fields.
+    - If the field mask parameter is omitted, it must default to `"*"`, unless
+      otherwise documented.
+- An API may allow read masks with non-terminal repeated fields (counter to the
+  documentation on Field Masks).
+
+## Pagination
+Some APIs often need to provide collections of data. However, collections can
+often be arbitrarily sized, and also often grow over time, increasing lookup
+time as well as the size of the responses being sent over the wire. Therefore,
+it is important that such APIs listing over a collection be paginated.
+
+APIs returning collections of data must provide pagination at the outset, as it
+is a backwards-incompatible change to add pagination to an existing method.
+
+- Request messages for collections should define an `uint32 page_size` field,
+  allowing users to specify the maximum number of results to return.
+    - The `page_size` field must not be required.
+    - If the user does not specify `page_size` (or specifies `0`), the API
+      chooses an appropriate default, which the API should document. The API
+      must not return an error.
+    - If the user specifies `page_size` greater than the maximum permitted by
+      the API, the API should coerce down to the maximum permitted page size.
+    - The API may return fewer results than the number requested (including
+      zero results), even if not at the end of the collection.
+- Request messages for collections should define a `bytes page_token` field,
+  allowing users to advance to the next page in the collection.
+    - The `page_token` field must not be required.
+    - If the user changes the `page_size` in a request for subsequent pages,
+      the service must honor the new page size.
+    - The user is expected to keep all other arguments to the RPC the same; if
+      any arguments are different, the API should send an `INVALID_ARGUMENT`
+      error.
+- Response messages for collections should define a `bytes next_page_token`
+  field, providing the user with a page token that may be used to retrieve the
+  next page.
+    - The field containing pagination results should be the first field in the
+      message and have a field number of `1`. It should be a repeated field
+      containing a list of resources constituting a single page of results.
+    - If the end of the collection has been reached, the `next_page_token`
+      field must be empty. This is the only way to communicate
+      "end-of-collection" to users.
+    - If the end of the collection has not been reached (or if the API can not
+      determine in time), the API must provide a `next_page_token`.
+
+## Field Presence
+The proto files used in this package for message and service definitions are
+all defined using protobuf version 3 (`proto3`). In `proto3`, fields that are
+primitives (that is, they are not a `message`) and are not present on the wire
+are zero-initialized. To gain the ability to detect [field
+presence](https://github.com/protocolbuffers/protobuf/blob/main/docs/field_presence.md),
+these definitions follow the convention of having all fields marked `optional`,
+and wrapping `repeated` fields in a message as needed.
+
+## Errors
+The services defined in this package support the [richer error
+model](https://grpc.io/docs/guides/error/#richer-error-model) following [AIP
+193](https://google.aip.dev/193). In particular, when an RPC returns a response
+with a non-OK status code, richer error information can generally be found by
+looking at the `grpc-status-details-bin` header which contains a
+[google.rpc.Status](https://github.com/googleapis/googleapis/blob/master/google/rpc/status.proto)
+message encoded in Base64.
+
+## HTTP Headers
+Implementations of the services defined in this package should set the
+following HTTP headers in responses where possible:
+
+- `x-sui-chain-id`: Chain Id of the current chain
+- `x-sui-chain`: Human-readable name of the current chain
+- `x-sui-checkpoint-height`: Current checkpoint height
+- `x-sui-lowest-available-checkpoint`: Lowest available checkpoint for which
+  transaction and checkpoint data can be requested. Specifically this is the
+  lowest checkpoint for which the following data can be requested: checkpoints,
+  transactions, effects and events.
+- `x-sui-lowest-available-checkpoint-objects`: Lowest available checkpoint for
+  which object data can be requested. Specifically this is the lowest
+  checkpoint for which input/output object data will be available.
+- `x-sui-epoch`: Current epoch of the chain.
+- `x-sui-timestamp-ms`: Current timestamp of the chain, represented as number
+  of milliseconds from the Unix epoch.
+- `x-sui-timestamp`: Current timestamp of the chain, encoded in the
+  [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format.

package/dist/grpc/protos/sui/rpc/v2beta2/argument.proto

@@ -0,0 +1,34 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+syntax = "proto3";
+
+package sui.rpc.v2beta2;
+
+// An argument to a programmable transaction command.
+message Argument {
+  enum ArgumentKind {
+    ARGUMENT_KIND_UNKNOWN = 0;
+
+    // The gas coin.
+    GAS = 1;
+
+    // One of the input objects or primitive values (from
+    // `ProgrammableTransaction` inputs).
+    INPUT = 2;
+
+    // The result of another command (from `ProgrammableTransaction` commands).
+    RESULT = 3;
+  }
+
+  optional ArgumentKind kind = 1;
+
+  // Index of an input when `kind` is `INPUT`.
+  optional uint32 input = 2;
+
+  // Index of a result when `kind` is `RESULT`.
+  optional uint32 result = 3;
+
+  // Used to access a nested result when `kind` is `RESULT`.
+  optional uint32 subresult = 4;
+}

package/dist/grpc/protos/sui/rpc/v2beta2/balance_change.proto

@@ -0,0 +1,18 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+syntax = "proto3";
+
+package sui.rpc.v2beta2;
+
+// The delta, or change, in balance for an address for a particular `Coin` type.
+message BalanceChange {
+  // The account address that is affected by this balance change event.
+  optional string address = 1;
+
+  // The `Coin` type of this balance change event.
+  optional string coin_type = 2;
+
+  // The amount or change in balance.
+  optional string amount = 3;
+}

package/dist/grpc/protos/sui/rpc/v2beta2/bcs.proto

@@ -0,0 +1,17 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+syntax = "proto3";
+
+package sui.rpc.v2beta2;
+
+// `Bcs` contains an arbitrary type that is serialized using the
+// [BCS](https://mystenlabs.github.io/sui-rust-sdk/sui_sdk_types/index.html#bcs)
+// format as well as a name that identifies the type of the serialized value.
+message Bcs {
+  // Name that identifies the type of the serialized value.
+  optional string name = 1;
+
+  // Bytes of a BCS serialized value.
+  optional bytes value = 2;
+}

package/dist/grpc/protos/sui/rpc/v2beta2/checkpoint.proto

@@ -0,0 +1,32 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+syntax = "proto3";
+
+package sui.rpc.v2beta2;
+
+import "sui/rpc/v2beta2/checkpoint_contents.proto";
+import "sui/rpc/v2beta2/checkpoint_summary.proto";
+import "sui/rpc/v2beta2/executed_transaction.proto";
+import "sui/rpc/v2beta2/signature.proto";
+
+message Checkpoint {
+  // The height of this checkpoint.
+  optional uint64 sequence_number = 1;
+
+  // The digest of this Checkpoint's CheckpointSummary.
+  optional string digest = 2;
+
+  // The `CheckpointSummary` for this checkpoint.
+  optional CheckpointSummary summary = 3;
+
+  // An aggregated quorum signature from the validator committee that
+  // certified this checkpoint.
+  optional ValidatorAggregatedSignature signature = 4;
+
+  // The `CheckpointContents` for this checkpoint.
+  optional CheckpointContents contents = 5;
+
+  // List of transactions included in this checkpoint.
+  repeated ExecutedTransaction transactions = 6;
+}

package/dist/grpc/protos/sui/rpc/v2beta2/checkpoint_contents.proto

@@ -0,0 +1,34 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+syntax = "proto3";
+
+package sui.rpc.v2beta2;
+
+import "sui/rpc/v2beta2/bcs.proto";
+import "sui/rpc/v2beta2/signature.proto";
+
+// The committed to contents of a checkpoint.
+message CheckpointContents {
+  // This CheckpointContents serialized as BCS.
+  optional Bcs bcs = 1;
+
+  // The digest of this CheckpointContents.
+  optional string digest = 2;
+
+  // Version of this CheckpointContents
+  optional int32 version = 3;
+
+  // Set of transactions committed to in this checkpoint.
+  repeated CheckpointedTransactionInfo transactions = 4;
+}
+
+// Transaction information committed to in a checkpoint.
+message CheckpointedTransactionInfo {
+  // Digest of the transaction.
+  optional string transaction = 1;
+  // Digest of the effects.
+  optional string effects = 2;
+  // Set of user signatures that authorized the transaction.
+  repeated UserSignature signatures = 3;
+}

package/dist/grpc/protos/sui/rpc/v2beta2/checkpoint_summary.proto

@@ -0,0 +1,102 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+syntax = "proto3";
+
+package sui.rpc.v2beta2;
+
+import "google/protobuf/timestamp.proto";
+import "sui/rpc/v2beta2/bcs.proto";
+import "sui/rpc/v2beta2/gas_cost_summary.proto";
+import "sui/rpc/v2beta2/signature.proto";
+
+// A header for a checkpoint on the Sui blockchain.
+//
+// On the Sui network, checkpoints define the history of the blockchain. They are quite similar to
+// the concept of blocks used by other blockchains like Bitcoin or Ethereum. The Sui blockchain,
+// however, forms checkpoints after transaction execution has already happened to provide a
+// certified history of the chain, instead of being formed before execution.
+//
+// Checkpoints commit to a variety of state, including but not limited to:
+// - The hash of the previous checkpoint.
+// - The set of transaction digests, their corresponding effects digests, as well as the set of
+//   user signatures that authorized its execution.
+// - The objects produced by a transaction.
+// - The set of live objects that make up the current state of the chain.
+// - On epoch transitions, the next validator committee.
+//
+// `CheckpointSummary`s themselves don't directly include all of the previous information but they
+// are the top-level type by which all the information is committed to transitively via cryptographic
+// hashes included in the summary. `CheckpointSummary`s are signed and certified by a quorum of
+// the validator committee in a given epoch to allow verification of the chain's state.
+message CheckpointSummary {
+  // This CheckpointSummary serialized as BCS.
+  optional Bcs bcs = 1;
+
+  // The digest of this CheckpointSummary.
+  optional string digest = 2;
+
+  // Epoch that this checkpoint belongs to.
+  optional uint64 epoch = 3;
+
+  // The height of this checkpoint.
+  optional uint64 sequence_number = 4;
+
+  // Total number of transactions committed since genesis, including those in this
+  // checkpoint.
+  optional uint64 total_network_transactions = 5;
+
+  // The hash of the `CheckpointContents` for this checkpoint.
+  optional string content_digest = 6;
+
+  // The hash of the previous `CheckpointSummary`.
+  //
+  // This will be `None` only for the first, or genesis, checkpoint.
+  optional string previous_digest = 7;
+
+  // The running total gas costs of all transactions included in the current epoch so far
+  // until this checkpoint.
+  optional GasCostSummary epoch_rolling_gas_cost_summary = 8;
+
+  // Timestamp of the checkpoint - number of milliseconds from the Unix epoch
+  // Checkpoint timestamps are monotonic, but not strongly monotonic - subsequent
+  // checkpoints can have the same timestamp if they originate from the same underlining consensus commit.
+  optional google.protobuf.Timestamp timestamp = 9;
+
+  // Commitments to checkpoint-specific state.
+  repeated CheckpointCommitment commitments = 10;
+
+  // Extra data only present in the final checkpoint of an epoch.
+  optional EndOfEpochData end_of_epoch_data = 11;
+
+  // `CheckpointSummary` is not an evolvable structure - it must be readable by any version of
+  // the code. Therefore, to allow extensions to be added to `CheckpointSummary`,
+  // opaque data can be added to checkpoints, which can be deserialized based on the current
+  // protocol version.
+  optional bytes version_specific_data = 12;
+}
+
+// Data, which when included in a `CheckpointSummary`, signals the end of an `Epoch`.
+message EndOfEpochData {
+  // The set of validators that will be in the `ValidatorCommittee` for the next epoch.
+  repeated ValidatorCommitteeMember next_epoch_committee = 1;
+  // The protocol version that is in effect during the next epoch.
+  optional uint64 next_epoch_protocol_version = 2;
+  // Commitments to epoch specific state (live object set)
+  repeated CheckpointCommitment epoch_commitments = 3;
+}
+
+// A commitment made by a checkpoint.
+message CheckpointCommitment {
+  enum CheckpointCommitmentKind {
+    CHECKPOINT_COMMITMENT_KIND_UNKNOWN = 0;
+
+    // An elliptic curve multiset hash attesting to the set of objects that
+    // comprise the live state of the Sui blockchain.
+    ECMH_LIVE_OBJECT_SET = 1;
+  }
+
+  optional CheckpointCommitmentKind kind = 1;
+
+  optional string digest = 2;
+}

package/dist/grpc/protos/sui/rpc/v2beta2/effects.proto

@@ -0,0 +1,154 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+syntax = "proto3";
+
+package sui.rpc.v2beta2;
+
+import "sui/rpc/v2beta2/bcs.proto";
+import "sui/rpc/v2beta2/execution_status.proto";
+import "sui/rpc/v2beta2/gas_cost_summary.proto";
+import "sui/rpc/v2beta2/owner.proto";
+
+// The effects of executing a transaction.
+message TransactionEffects {
+  // This TransactionEffects serialized as BCS.
+  optional Bcs bcs = 1;
+
+  // The digest of this TransactionEffects.
+  optional string digest = 2;
+
+  // Version of this TransactionEffects.
+  optional int32 version = 3;
+
+  // The status of the execution.
+  optional ExecutionStatus status = 4;
+
+  // The epoch when this transaction was executed.
+  optional uint64 epoch = 5;
+
+  // The gas used by this transaction.
+  optional GasCostSummary gas_used = 6;
+
+  // The transaction digest.
+  optional string transaction_digest = 7;
+
+  // Information about the gas object. Also present in the `changed_objects` vector.
+  //
+  // System transaction that don't require gas will leave this as `None`.
+  optional ChangedObject gas_object = 8;
+
+  // The digest of the events emitted during execution,
+  // can be `None` if the transaction does not emit any event.
+  optional string events_digest = 9;
+
+  // The set of transaction digests this transaction depends on.
+  repeated string dependencies = 10;
+
+  // The version number of all the written objects (excluding packages) by this transaction.
+  optional uint64 lamport_version = 11;
+
+  // Objects whose state are changed by this transaction.
+  repeated ChangedObject changed_objects = 12;
+
+  // Consensus objects that are not mutated in this transaction. Unlike owned objects,
+  // read-only consensus objects' version are not committed in the transaction,
+  // and in order for a node to catch up and execute it without consensus sequencing,
+  // the version needs to be committed in the effects.
+  repeated UnchangedConsensusObject unchanged_consensus_objects = 13;
+
+  // Auxiliary data that are not protocol-critical, generated as part of the effects but are stored separately.
+  // Storing it separately allows us to avoid bloating the effects with data that are not critical.
+  // It also provides more flexibility on the format and type of the data.
+  optional string auxiliary_data_digest = 14;
+}
+
+// Input/output state of an object that was changed during execution.
+message ChangedObject {
+  // ID of the object.
+  optional string object_id = 1;
+
+  enum InputObjectState {
+    INPUT_OBJECT_STATE_UNKNOWN = 0;
+    INPUT_OBJECT_STATE_DOES_NOT_EXIST = 1;
+    INPUT_OBJECT_STATE_EXISTS = 2;
+  }
+
+  optional InputObjectState input_state = 2;
+
+  // Version of the object before this transaction executed.
+  optional uint64 input_version = 3;
+  // Digest of the object before this transaction executed.
+  optional string input_digest = 4;
+  // Owner of the object before this transaction executed.
+  optional Owner input_owner = 5;
+
+  enum OutputObjectState {
+    OUTPUT_OBJECT_STATE_UNKNOWN = 0;
+    OUTPUT_OBJECT_STATE_DOES_NOT_EXIST = 1;
+    OUTPUT_OBJECT_STATE_OBJECT_WRITE = 2;
+    OUTPUT_OBJECT_STATE_PACKAGE_WRITE = 3;
+  }
+
+  optional OutputObjectState output_state = 6;
+  // Version of the object after this transaction executed.
+  optional uint64 output_version = 7;
+  // Digest of the object after this transaction executed.
+  optional string output_digest = 8;
+  // Owner of the object after this transaction executed.
+  optional Owner output_owner = 9;
+
+  enum IdOperation {
+    ID_OPERATION_UNKNOWN = 0;
+    NONE = 1;
+    CREATED = 2;
+    DELETED = 3;
+  }
+
+  // What happened to an `ObjectId` during execution.
+  optional IdOperation id_operation = 10;
+
+  // Type information is not provided by the effects structure but is instead
+  // provided by an indexing layer
+  optional string object_type = 11;
+}
+
+// A consensus object that wasn't changed during execution.
+message UnchangedConsensusObject {
+  enum UnchangedConsensusObjectKind {
+    UNCHANGED_CONSENSUS_OBJECT_KIND_UNKNOWN = 0;
+
+    // Read-only consensus object from the input.
+    READ_ONLY_ROOT = 1;
+
+    // Objects with ended consensus streams that appear mutably/owned in the input.
+    MUTATE_CONSENSUS_STREAM_ENDED = 2;
+
+    // Objects with ended consensus streams objects that appear as read-only in the input.
+    READ_CONSENSUS_STREAM_ENDED = 3;
+
+    // Consensus objects that were congested and resulted in this transaction being
+    // canceled.
+    CANCELED = 4;
+
+    // Read of a per-epoch config object that should remain the same during an
+    // epoch. This optionally will indicate the sequence number of the config
+    // object at the start of the epoch.
+    PER_EPOCH_CONFIG = 5;
+  }
+
+  optional UnchangedConsensusObjectKind kind = 1;
+
+  // ObjectId of the consensus object.
+  optional string object_id = 2;
+
+  // Version of the consensus object.
+  optional uint64 version = 3;
+
+  // Digest of the consensus object.
+  optional string digest = 4;
+
+  // Type information is not provided by the effects structure but is instead
+  // provided by an indexing layer
+  optional string object_type = 5;
+}

package/dist/grpc/protos/sui/rpc/v2beta2/epoch.proto

@@ -0,0 +1,34 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+syntax = "proto3";
+
+package sui.rpc.v2beta2;
+
+import "google/protobuf/timestamp.proto";
+import "sui/rpc/v2beta2/protocol_config.proto";
+import "sui/rpc/v2beta2/signature.proto";
+import "sui/rpc/v2beta2/system_state.proto";
+
+message Epoch {
+  optional uint64 epoch = 1;
+
+  // The committee governing this epoch.
+  optional ValidatorCommittee committee = 2;
+
+  // Snapshot of Sui's SystemState (`0x3::sui_system::SystemState`) at the
+  // beginning of the epoch, for past epochs, or the current state for the
+  // current epoch.
+  optional SystemState system_state = 3;
+
+  optional uint64 first_checkpoint = 4;
+  optional uint64 last_checkpoint = 5;
+
+  optional google.protobuf.Timestamp start = 6;
+  optional google.protobuf.Timestamp end = 7;
+
+  // Reference gas price denominated in MIST
+  optional uint64 reference_gas_price = 8;
+
+  optional ProtocolConfig protocol_config = 9;
+}

package/dist/grpc/protos/sui/rpc/v2beta2/error_reason.proto

@@ -0,0 +1,12 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+syntax = "proto3";
+
+package sui.rpc.v2beta2;
+
+enum ErrorReason {
+  ERROR_REASON_UNKNOWN = 0;
+  FIELD_INVALID = 1;
+  FIELD_MISSING = 2;
+}

package/dist/grpc/protos/sui/rpc/v2beta2/event.proto

@@ -0,0 +1,44 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+syntax = "proto3";
+
+package sui.rpc.v2beta2;
+
+import "google/protobuf/struct.proto";
+import "sui/rpc/v2beta2/bcs.proto";
+
+// Events emitted during the successful execution of a transaction.
+message TransactionEvents {
+  // This TransactionEvents serialized as BCS.
+  optional Bcs bcs = 1;
+
+  // The digest of this TransactionEvents.
+  optional string digest = 2;
+
+  // Set of events emitted by a transaction.
+  repeated Event events = 3;
+}
+
+// An event.
+message Event {
+  // Package ID of the top-level function invoked by a `MoveCall` command that triggered this
+  // event to be emitted.
+  optional string package_id = 1;
+
+  // Module name of the top-level function invoked by a `MoveCall` command that triggered this
+  // event to be emitted.
+  optional string module = 2;
+
+  // Address of the account that sent the transaction where this event was emitted.
+  optional string sender = 3;
+
+  // The type of the event emitted.
+  optional string event_type = 4;
+
+  // BCS serialized bytes of the event.
+  optional Bcs contents = 5;
+
+  // JSON rendering of the event.
+  optional google.protobuf.Value json = 6;
+}

package/dist/grpc/protos/sui/rpc/v2beta2/executed_transaction.proto

@@ -0,0 +1,51 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+syntax = "proto3";
+
+package sui.rpc.v2beta2;
+
+import "google/protobuf/timestamp.proto";
+import "sui/rpc/v2beta2/balance_change.proto";
+import "sui/rpc/v2beta2/effects.proto";
+import "sui/rpc/v2beta2/event.proto";
+import "sui/rpc/v2beta2/object.proto";
+import "sui/rpc/v2beta2/signature.proto";
+import "sui/rpc/v2beta2/transaction.proto";
+
+message ExecutedTransaction {
+  // The digest of this Transaction.
+  optional string digest = 1;
+
+  // The transaction itself.
+  optional Transaction transaction = 2;
+
+  // List of user signatures that are used to authorize the
+  // execution of this transaction.
+  repeated UserSignature signatures = 3;
+
+  // The `TransactionEffects` for this transaction.
+  optional TransactionEffects effects = 4;
+
+  // The `TransactionEvents` for this transaction.
+  //
+  // This field might be empty, even if it was explicitly requested, if the
+  // transaction didn't produce any events.
+  // `sui.types.TransactionEffects.events_digest` is populated if the
+  // transaction produced any events.
+  optional TransactionEvents events = 5;
+
+  // The sequence number for the checkpoint that includes this transaction.
+  optional uint64 checkpoint = 6;
+
+  // The Unix timestamp of the checkpoint that includes this transaction.
+  optional google.protobuf.Timestamp timestamp = 7;
+
+  repeated BalanceChange balance_changes = 8;
+
+  // Set of input objects used during the execution of this transaction.
+  repeated Object input_objects = 10;
+
+  // Set of output objects produced from the execution of this transaction.
+  repeated Object output_objects = 11;
+}