package aptos.transaction.v1

Get desktop application:
View/edit binary Protocol Buffers messages

Used in: AccountSignature

• string function_info = 1

• bytes signature = 2

Used in: FeePayerSignature, MultiAgentSignature, SingleSender

• AccountSignature.Type type = 1

• oneof signature

  • Ed25519Signature ed25519 = 2

  • MultiEd25519Signature multi_ed25519 = 3

  • SingleKeySignature single_key_signature = 5

    4 is reserved.

  • MultiKeySignature multi_key_signature = 6

  • AbstractionSignature abstraction = 7

Used in: AccountSignature

• TYPE_UNSPECIFIED = 0

• TYPE_ED25519 = 1

• TYPE_MULTI_ED25519 = 2

• TYPE_SINGLE_KEY = 4

• TYPE_MULTI_KEY = 5

• TYPE_ABSTRACTION = 6

Used in: MultiKeySignature, SingleKeySignature

• AnyPublicKey.Type type = 1

• bytes public_key = 2

Used in: AnyPublicKey

• TYPE_UNSPECIFIED = 0

• TYPE_ED25519 = 1

• TYPE_SECP256K1_ECDSA = 2

• TYPE_SECP256R1_ECDSA = 3

• TYPE_KEYLESS = 4

• TYPE_FEDERATED_KEYLESS = 5

Used in: IndexedSignature, SingleKeySignature

• AnySignature.Type type = 1

• bytes signature = 2

  Deprecated: use signature_variant instead. Note: >= 1.10, this field is deprecated.

• oneof signature_variant

  Support: >= 1.10.

  • Ed25519 ed25519 = 3

  • Secp256k1Ecdsa secp256k1_ecdsa = 4

  • WebAuthn webauthn = 5

  • Keyless keyless = 6

Used in: AnySignature

• TYPE_UNSPECIFIED = 0

• TYPE_ED25519 = 1

• TYPE_SECP256K1_ECDSA = 2

• TYPE_WEBAUTHN = 3

• TYPE_KEYLESS = 4

A block on Aptos holds transactions in chronological order (ordered by a transactions monotonically increasing `version` field) All blocks start with a `BlockMetadataTransaction`, and are followed by zero or more transactions. The next `BlockMetadataTransaction` denotes the end of the current block, and the start of the next one. The Block `height` is a strictly monotonically increasing count of the number of blocks, and there will never be a gap in the numbers. It is also a unique identifier: there will never be two blocks with the same `height`. The Genesis Transaction (version 0) is contained within the first block, which has a height of `0`

• optional util.timestamp.Timestamp timestamp = 1

  Timestamp represents the timestamp of the `BlockMetadataTransaction` (or `GenesisTransaction` for the genesis block) and every transaction in the `transactions` will have the same `timestamp` as the block.

• uint64 height = 2

  Height represents the block number and ultimately, is the count of `BlockMetadataTransaction` that happened on the chain.

• repeated Transaction transactions = 3

  Transactions holds all transactions that happened in the Block, which is transactions that happened starting with (and including) a `BlockMetadataTransaction`, and every other transaction up to (but excluding) the next `BlockMetadataTransaction`.

• uint32 chain_id = 4

  Chain ID informs us which chain we're trying to index, this is important to ensure that we're not mixing chains within a single pipeline.

Used in: BlockEpilogueTransaction

• bool block_gas_limit_reached = 1

• bool block_output_limit_reached = 2

• uint64 block_effective_block_gas_units = 3

• uint64 block_approx_output_size = 4

Used in: Transaction

• optional BlockEndInfo block_end_info = 1

Transaction types.

Used in: Transaction

• string id = 1

• uint64 round = 2

• repeated Event events = 3

• bytes previous_block_votes_bitvec = 4

• string proposer = 5

• repeated uint32 failed_proposer_indices = 6

Used in: WriteSetChange

• string address = 1

• bytes state_key_hash = 2

• optional MoveModuleId module = 3

Used in: WriteSetChange

• string address = 1

• bytes state_key_hash = 2

• optional MoveStructTag type = 3

• string type_str = 4

Used in: DeleteTableItem

• string key = 1

• string key_type = 2

Used in: WriteSetChange

• bytes state_key_hash = 1

• string handle = 2

• string key = 3

• optional DeleteTableData data = 4

Used in: WriteSet

• repeated WriteSetChange write_set_change = 1

• repeated Event events = 2

Used in: AnySignature

• bytes signature = 1

Used in: AccountSignature, Signature

• bytes public_key = 1

• bytes signature = 2

Used in: EntryFunctionPayload

• optional MoveModuleId module = 1

• string name = 2

Used in: MultisigTransactionPayload, TransactionPayload

• optional EntryFunctionId function = 1

• repeated MoveType type_arguments = 2

• repeated string arguments = 3

• string entry_function_id_str = 4

Used in: BlockMetadataTransaction, DirectWriteSet, GenesisTransaction, UserTransaction, ValidatorTransaction

• optional EventKey key = 1

• uint64 sequence_number = 2

• optional MoveType type = 3

• string type_str = 5

• string data = 4

Used in: Event

• uint64 creation_number = 1

• string account_address = 2

Used in: TransactionSizeInfo

• uint32 type_tag_bytes = 1

• uint32 total_bytes = 2

Used in: TransactionPayload

• optional string multisig_address = 1

• optional uint64 replay_protection_nonce = 2

Used in: Signature

• optional AccountSignature sender = 1

• repeated string secondary_signer_addresses = 2

• repeated AccountSignature secondary_signers = 3

• string fee_payer_address = 4

• optional AccountSignature fee_payer_signer = 5

Used in: Transaction

• optional WriteSet payload = 1

• repeated Event events = 2

Used in: MultiKeySignature

• uint32 index = 1

• optional AnySignature signature = 2

Used in: AnySignature

• bytes signature = 1

Used in: MoveFunctionGenericTypeParam, MoveStruct, MoveStructGenericTypeParam

• MOVE_ABILITY_UNSPECIFIED = 0

• MOVE_ABILITY_COPY = 1

• MOVE_ABILITY_DROP = 2

• MOVE_ABILITY_STORE = 3

• MOVE_ABILITY_KEY = 4

Used in: MoveModule, MoveScriptBytecode

• string name = 1

• MoveFunction.Visibility visibility = 2

• bool is_entry = 3

• repeated MoveFunctionGenericTypeParam generic_type_params = 4

• repeated MoveType params = 5

• repeated MoveType return = 6

Used in: MoveFunction

• VISIBILITY_UNSPECIFIED = 0

• VISIBILITY_PRIVATE = 1

• VISIBILITY_PUBLIC = 2

• VISIBILITY_FRIEND = 3

Used in: MoveFunction

• repeated MoveAbility constraints = 1

Used in: MoveModuleBytecode

• string address = 1

• string name = 2

• repeated MoveModuleId friends = 3

• repeated MoveFunction exposed_functions = 4

• repeated MoveStruct structs = 5

Used in: WriteModule

• bytes bytecode = 1

• optional MoveModule abi = 2

Used in: DeleteModule, EntryFunctionId, MoveModule

• string address = 1

• string name = 2

Used in: ScriptPayload

• bytes bytecode = 1

• optional MoveFunction abi = 2

Used in: MoveModule

• string name = 1

• bool is_native = 2

• bool is_event = 6

• repeated MoveAbility abilities = 3

• repeated MoveStructGenericTypeParam generic_type_params = 4

• repeated MoveStructField fields = 5

Used in: MoveStruct

• string name = 1

• optional MoveType type = 2

Used in: MoveStruct

• repeated MoveAbility constraints = 1

• bool is_phantom = 2

Used in: DeleteResource, MoveType, WriteResource

• string address = 1

• string module = 2

• string name = 3

• repeated MoveType generic_type_params = 4

Used in: EntryFunctionPayload, Event, MoveFunction, MoveStructField, MoveStructTag, MoveType.ReferenceType, ScriptPayload

• MoveTypes type = 1

• oneof content

  • MoveType vector = 3

  • MoveStructTag struct = 4

  • uint32 generic_type_param_index = 5

  • MoveType.ReferenceType reference = 6

  • string unparsable = 7

Used in: MoveType

• bool mutable = 1

• optional MoveType to = 2

Used in: MoveType

• MOVE_TYPES_UNSPECIFIED = 0

• MOVE_TYPES_BOOL = 1

• MOVE_TYPES_U8 = 2

• MOVE_TYPES_U16 = 12

• MOVE_TYPES_U32 = 13

• MOVE_TYPES_U64 = 3

• MOVE_TYPES_U128 = 4

• MOVE_TYPES_U256 = 14

• MOVE_TYPES_ADDRESS = 5

• MOVE_TYPES_SIGNER = 6

• MOVE_TYPES_VECTOR = 7

  `{ items: Box<MoveType> }`,

• MOVE_TYPES_STRUCT = 8

  `(MoveStructTag)`,

• MOVE_TYPES_GENERIC_TYPE_PARAM = 9

  `{ index: u16 }``,

• MOVE_TYPES_REFERENCE = 10

  `{ mutable: bool, to: Box<MoveType> }`,

• MOVE_TYPES_UNPARSABLE = 11

  `(String)`,

Used in: Signature

• optional AccountSignature sender = 1

• repeated string secondary_signer_addresses = 2

• repeated AccountSignature secondary_signers = 3

Used in: AccountSignature, Signature

• repeated bytes public_keys = 1

• repeated bytes signatures = 2

• uint32 threshold = 3

• repeated uint32 public_key_indices = 4

Used in: AccountSignature

• repeated AnyPublicKey public_keys = 1

• repeated IndexedSignature signatures = 2

• uint32 signatures_required = 3

Used in: TransactionPayload

• string multisig_address = 1

• optional MultisigTransactionPayload transaction_payload = 2

Used in: MultisigPayload

• MultisigTransactionPayload.Type type = 1

• oneof payload

  • EntryFunctionPayload entry_function_payload = 2

Used in: MultisigTransactionPayload

• TYPE_UNSPECIFIED = 0

• TYPE_ENTRY_FUNCTION_PAYLOAD = 1

Used in: ScriptWriteSet, TransactionPayload

• optional MoveScriptBytecode code = 1

• repeated MoveType type_arguments = 2

• repeated string arguments = 3

Used in: WriteSet

• string execute_as = 1

• optional ScriptPayload script = 2

Used in: AnySignature

• bytes signature = 1

Used in: UserTransactionRequest

• Signature.Type type = 1

• oneof signature

  • Ed25519Signature ed25519 = 2

  • MultiEd25519Signature multi_ed25519 = 3

  • MultiAgentSignature multi_agent = 4

  • FeePayerSignature fee_payer = 5

  • SingleSender single_sender = 7

    6 is reserved.

Used in: Signature

• TYPE_UNSPECIFIED = 0

• TYPE_ED25519 = 1

• TYPE_MULTI_ED25519 = 2

• TYPE_MULTI_AGENT = 3

• TYPE_FEE_PAYER = 4

• TYPE_SINGLE_SENDER = 6

Used in: AccountSignature

• optional AnyPublicKey public_key = 1

• optional AnySignature signature = 2

Used in: Signature

• optional AccountSignature sender = 1

Used in: Transaction

(message has no fields)

Transaction as it happened on the chain, there are 4 types of transactions: - User Transaction: a user initiated transaction to interact with the chain - Block Metadata Transaction: transactions generated by the chain to group together transactions forming a "block" - Block Epilogue / State Checkpoint Transaction: transactions generated by the chain to end the group transactions forming a bloc - Genesis Transaction: the first transaction of the chain, with all core contract and validator information baked in

Used in: indexer.v1.TransactionsInStorage, indexer.v1.TransactionsResponse, internal.fullnode.v1.TransactionsOutput, Block

• optional util.timestamp.Timestamp timestamp = 1

• uint64 version = 2

• optional TransactionInfo info = 3

• uint64 epoch = 4

• uint64 block_height = 5

• Transaction.TransactionType type = 6

• oneof txn_data

  • BlockMetadataTransaction block_metadata = 7

  • GenesisTransaction genesis = 8

  • StateCheckpointTransaction state_checkpoint = 9

  • UserTransaction user = 10

  • ValidatorTransaction validator = 21

    value 11-19 skipped for no reason

  • BlockEpilogueTransaction block_epilogue = 23

    value 22 is used up below (all Transaction fields have to have different index), so going to 23

• optional TransactionSizeInfo size_info = 22

Used in: indexer.v1.TransactionRootFilter, Transaction

• TRANSACTION_TYPE_UNSPECIFIED = 0

• TRANSACTION_TYPE_GENESIS = 1

• TRANSACTION_TYPE_BLOCK_METADATA = 2

• TRANSACTION_TYPE_STATE_CHECKPOINT = 3

• TRANSACTION_TYPE_USER = 4

• TRANSACTION_TYPE_VALIDATOR = 20

  values 5-19 skipped for no reason

• TRANSACTION_TYPE_BLOCK_EPILOGUE = 21

Used in: Transaction

• bytes hash = 1

• bytes state_change_hash = 2

• bytes event_root_hash = 3

• optional bytes state_checkpoint_hash = 4

• uint64 gas_used = 5

• bool success = 6

• string vm_status = 7

• bytes accumulator_root_hash = 8

• repeated WriteSetChange changes = 9

Question: Not sure if this is the correct way to add extra config in protobuf here. Not sure about the numbering as well. Please double check.

Used in: UserTransactionRequest

• TransactionPayload.Type type = 1

• oneof payload

  • EntryFunctionPayload entry_function_payload = 2

  • ScriptPayload script_payload = 3

  • WriteSetPayload write_set_payload = 5

  • MultisigPayload multisig_payload = 6

• oneof extra_config

  • ExtraConfigV1 extra_config_v1 = 7

Used in: TransactionPayload

• TYPE_UNSPECIFIED = 0

• TYPE_ENTRY_FUNCTION_PAYLOAD = 1

• TYPE_SCRIPT_PAYLOAD = 2

• TYPE_WRITE_SET_PAYLOAD = 4

• TYPE_MULTISIG_PAYLOAD = 5

Used in: Transaction

• uint32 transaction_bytes = 1

• repeated EventSizeInfo event_size_info = 2

• repeated WriteOpSizeInfo write_op_size_info = 3

Used in: Transaction

• optional UserTransactionRequest request = 1

• repeated Event events = 2

Used in: UserTransaction

• string sender = 1

• uint64 sequence_number = 2

• uint64 max_gas_amount = 3

• uint64 gas_unit_price = 4

• optional util.timestamp.Timestamp expiration_timestamp_secs = 5

• optional TransactionPayload payload = 6

• optional Signature signature = 7

Used in: Transaction

• oneof ValidatorTransactionType

  • ValidatorTransaction.ObservedJwkUpdate observed_jwk_update = 1

  • ValidatorTransaction.DkgUpdate dkg_update = 2

• repeated Event events = 3

Used in: ValidatorTransaction

• optional DkgUpdate.DkgTranscript dkg_transcript = 1

Used in: DkgUpdate

• uint64 epoch = 1

• string author = 2

• bytes payload = 3

Used in: ValidatorTransaction

• optional ObservedJwkUpdate.QuorumCertifiedUpdate quorum_certified_update = 1

Used in: QuorumCertifiedUpdate

• repeated uint64 signer_indices = 1

• bytes sig = 2

  HexToBytes.

Used in: QuorumCertifiedUpdate

• string issuer = 1

• uint64 version = 2

• repeated ExportedProviderJWKs.JWK jwks = 3

Used in: ExportedProviderJWKs

• oneof JwkType

  • JWK.UnsupportedJWK unsupported_jwk = 1

  • JWK.RSA rsa = 2

Used in: JWK

• string kid = 1

• string kty = 2

• string alg = 3

• string e = 4

• string n = 5

Used in: JWK

• bytes id = 1

• bytes payload = 2

Used in: ObservedJwkUpdate

• optional ExportedProviderJWKs update = 1

• optional ExportedAggregateSignature multi_sig = 2

Used in: AnySignature

• bytes signature = 1

Used in: WriteSetChange

• string address = 1

• bytes state_key_hash = 2

• optional MoveModuleBytecode data = 3

Used in: TransactionSizeInfo

• uint32 key_bytes = 1

• uint32 value_bytes = 2

Used in: WriteSetChange

• string address = 1

• bytes state_key_hash = 2

• optional MoveStructTag type = 3

• string type_str = 4

• string data = 5

Used in: GenesisTransaction, WriteSetPayload

• WriteSet.WriteSetType write_set_type = 1

• oneof write_set

  • ScriptWriteSet script_write_set = 2

  • DirectWriteSet direct_write_set = 3

Used in: WriteSet

• WRITE_SET_TYPE_UNSPECIFIED = 0

• WRITE_SET_TYPE_SCRIPT_WRITE_SET = 1

• WRITE_SET_TYPE_DIRECT_WRITE_SET = 2

Used in: DirectWriteSet, TransactionInfo

• WriteSetChange.Type type = 1

• oneof change

  • DeleteModule delete_module = 2

  • DeleteResource delete_resource = 3

  • DeleteTableItem delete_table_item = 4

  • WriteModule write_module = 5

  • WriteResource write_resource = 6

  • WriteTableItem write_table_item = 7

Used in: WriteSetChange

• TYPE_UNSPECIFIED = 0

• TYPE_DELETE_MODULE = 1

• TYPE_DELETE_RESOURCE = 2

• TYPE_DELETE_TABLE_ITEM = 3

• TYPE_WRITE_MODULE = 4

• TYPE_WRITE_RESOURCE = 5

• TYPE_WRITE_TABLE_ITEM = 6

Used in: TransactionPayload

• optional WriteSet write_set = 1

Used in: WriteTableItem

• string key = 1

• string key_type = 2

• string value = 3

• string value_type = 4

Used in: WriteSetChange

• bytes state_key_hash = 1

• string handle = 2

• string key = 3

• optional WriteTableData data = 4