* This field MUST be present.
* This field MUST NOT exceed the current network transaction size limit
* (currently 6144 bytes).
*/
bytes signedTransactionBytes = 5;
}
/**
* A transaction body.
*
* Every transaction is structured as a signed byte array. That byte array
* is a serialized `TransactionBody`. The transaction body contains the full
* content of the transaction, while the `SignedTransaction` includes a
* signature map for signatures authenticating that byte array, and that is
* serialized and transmitted wrapped in a `Transaction` message.
* Each transaction identifier MUST be unique.
* This MUST identify the account of the consensus node to which
* this transaction is submitted.
*/
AccountID nodeAccountID = 2;
/**
* A maximum transaction fee, in tinybar.
*
* The network SHALL NOT charge a transaction fee that exceeds this
* amount.
* This transaction SHALL be rejected as expired if the valid start time,
* extended by this duration, is less than the current network consensus
* time when the transaction is submitted.
* This flag SHALL be ignored. Every transaction SHALL generate a record,
* or block stream equivalent.
*/
bool generateRecord = 5 [deprecated = true];
/**
* A short description for this transaction.
*
* This value, if set, MUST NOT exceed `transaction.maxMemoUtf8Bytes`
* (default 100) bytes when encoded as UTF-8.
*/
string memo = 6;
/**
* The public key of the trusted batch assembler.
*/
Key batch_key = 73;
// The fields here are ordered in strictly ascending field ordinal
// order due to limitations in PBJ.
oneof data {
/**
* Call a function defined on a smart contract.
*/
ContractCallTransactionBody contractCall = 7;
/**
* Create a smart contract.
*/
ContractCreateTransactionBody contractCreateInstance = 8;
/**
* Update a smart contract.
*/
ContractUpdateTransactionBody contractUpdateInstance = 9;
/**
* An obsolete, and unsupported, operation to add a "live hash" to
* an account.
*/
CryptoAddLiveHashTransactionBody cryptoAddLiveHash = 10 [deprecated = true];
/**
* Create a new Hedera account.
*/
CryptoCreateTransactionBody cryptoCreateAccount = 11;
/**
* Delete an Hedera account.
* This transaction MAY be implemented in testing networks, but
* SHALL NOT be enabled or supported in production environments.
* This transaction MUST be signed by the "pause key" for the token.
*/
TokenPauseTransactionBody token_pause = 46;
/**
* Unpause a Token.
*
* This transaction MUST be signed by the "pause key" for the token.
*/
TokenUnpauseTransactionBody token_unpause = 47;
/**
* Add one or more approved allowances for spenders to transfer the
* paying account's hbar or tokens.
*/
CryptoApproveAllowanceTransactionBody cryptoApproveAllowance = 48;
/**
* Delete one or more approvals for spenders to transfer the
* paying account's hbar or tokens.
*/
CryptoDeleteAllowanceTransactionBody cryptoDeleteAllowance = 49;
/**
* Perform an Ethereum encoded transaction.
*/
EthereumTransactionBody ethereumTransaction = 50;
/**
* Update the staking information.
* This transaction SHALL create a new consensus node record and add
* that record to the network address book.
*/
com.hedera.hapi.node.addressbook.NodeCreateTransactionBody nodeCreate = 54;
/**
* Update a node in the network address book.
* This transaction SHALL update an existing consensus node record in
* the network address book.
*/
com.hedera.hapi.node.addressbook.NodeUpdateTransactionBody nodeUpdate = 55;
/**
* Delete a node from the network address book.
* This transaction SHALL mark an existing consensus node record as
* deleted and remove that node from the network address book.
*/
com.hedera.hapi.node.addressbook.NodeDeleteTransactionBody nodeDelete = 56;
/**
* Reject and return a token to treasury.
* Each transfer MUST be one of the following:
*
* If a recipient account cannot immediately receive the token(s) sent,
* a "pending" airdrop SHALL be created and MUST be claimed.
*/
TokenAirdropTransactionBody tokenAirdrop = 58;
/**
* Cancel one or more "pending" airdrops that are not yet claimed.
*/
TokenCancelAirdropTransactionBody tokenCancelAirdrop = 59;
/**
* Claim one or more "pending" airdrops.
*/
TokenClaimAirdropTransactionBody tokenClaimAirdrop = 60;
/**
* A transaction body for signature of a state root hash gossiped to other nodes
*/
com.hedera.hapi.platform.event.StateSignatureTransaction state_signature_transaction = 65;
/**
* A transaction body for voting on hinTS aggregation keys.
*/
com.hedera.hapi.services.auxiliary.hints.HintsPreprocessingVoteTransactionBody hints_preprocessing_vote = 66;
/**
* A transaction body for publishing a node's hintTS key.
*/
com.hedera.hapi.services.auxiliary.hints.HintsKeyPublicationTransactionBody hints_key_publication = 67;
/**
* A transaction body for broadcasting a node's hintTS partial signature on a message.
*/
com.hedera.hapi.services.auxiliary.hints.HintsPartialSignatureTransactionBody hints_partial_signature = 68;
/**
* A transaction body for contributed a signature with a node's proof key to a history proof.
*/
com.hedera.hapi.services.auxiliary.history.HistoryProofSignatureTransactionBody history_proof_signature = 69;
/**
* A transaction body for publishing a node's metadata proof key.
*/
com.hedera.hapi.services.auxiliary.history.HistoryProofKeyPublicationTransactionBody history_proof_key_publication = 70;
/**
* A transaction body for voting on a metadata proof descending from the ledger id.
*/
com.hedera.hapi.services.auxiliary.history.HistoryProofVoteTransactionBody history_proof_vote = 71;
/**
* A transaction body for broadcasting a node's crs publication
*/
com.hedera.hapi.services.auxiliary.hints.CrsPublicationTransactionBody crs_publication = 72;
/**
* A transaction body for handling a set of transactions atomically.
*/
AtomicBatchTransactionBody atomic_batch = 74;
/**
* A transaction body for updating the storage of a EVM lambda hook.
*/
com.hedera.hapi.node.hooks.LambdaSStoreTransactionBody lambda_sstore = 75;
/**
* An internal-only transaction body for dispatching a hook CRUD operation.
*/
com.hedera.hapi.node.hooks.HookDispatchTransactionBody hook_dispatch = 76;
}
/**
* A list of maximum custom fees that the users are willing to pay.
*
* This field is OPTIONAL.
* The bulk of this message is a `oneof` block which offers the option for
* any one of the transaction messages for the network.
* This message also includes several additional fields to specify
* various parameters required to process a transaction.
*/
message TransactionBody {
// <<
* Each transaction is uniquely identified by its transaction
* identifier.
*
* Multiple transactions MAY be submitted with the same transaction
* identifier, but all except the first SHALL be rejected as duplicate
* transactions.
* This identifier MUST specify a `payer` account to be charged
* all fees associated with the transaction.
* This identifier MUST specify a "valid start time".
* The "valid start time" MUST be strictly _earlier_ than the current
* network consensus time.
* The "valid start time" MUST NOT be more than the current network
* configuration value for `transaction.maxValidDuration` seconds
* before the current network consensus time.
* This identifier MUST NOT set the `scheduled` flag.
* This identifier MUST NOT set a nonce value.
*/
TransactionID transactionID = 1;
/**
* A node account identifier.
*
* The network MAY charge up to this amount, and reject the transaction,
* if the amount offered is insufficient to cover the required fees.
* The network MAY charge a minimum fee equal to 80% of the amount offered
* if the amount offered is much larger than the required fees.
*/
uint64 transactionFee = 3;
/**
* A maximum duration in which to execute this transaction.
*
* This transaction SHALL be rejected with an invalid duration if this
* value is greater than the current network configuration value for
* `transaction.maxValidDuration`.
*/
Duration transactionValidDuration = 4;
/**
* Records are always generated.
* Obsolete option to not generate a record.
*
* This will mark the account as deleted, and transfer all remaining
* HBAR to a receiver account.
*/
CryptoDeleteTransactionBody cryptoDelete = 12;
/**
* An obsolete, and unsupported, operation to remove a "live hash" from
* an account.
*/
CryptoDeleteLiveHashTransactionBody cryptoDeleteLiveHash = 13 [deprecated = true];
/**
* Transfer HBAR between accounts.
*/
CryptoTransferTransactionBody cryptoTransfer = 14;
/**
* Modify an Hedera account.
*/
CryptoUpdateTransactionBody cryptoUpdateAccount = 15;
/**
* Append data to the end of a file.
*/
FileAppendTransactionBody fileAppend = 16;
/**
* Create a new file.
*/
FileCreateTransactionBody fileCreate = 17;
/**
* Delete a file.
* This will remove the content of the file, and mark the file as
* deleted.
*/
FileDeleteTransactionBody fileDelete = 18;
/**
* Modify a file.
* This may modify any metadata, and/or _replace_ the content.
*/
FileUpdateTransactionBody fileUpdate = 19;
/**
* Delete a file as an Hedera administrative function.
* This is a privileged operation.
*/
SystemDeleteTransactionBody systemDelete = 20;
/**
* Restore a file deleted via `systemDelete`.
* This is a privileged operation.
*/
SystemUndeleteTransactionBody systemUndelete = 21;
/**
* Delete a smart contract and transfer remaining balance
* to a specified account.
*/
ContractDeleteTransactionBody contractDeleteInstance = 22;
/**
* Freeze the network.
* This is actually several possible operations, and the caller
* should examine the "freeze service" for more detail.
* This is a privileged operation.
*/
FreezeTransactionBody freeze = 23;
/**
* Create a topic.
*/
ConsensusCreateTopicTransactionBody consensusCreateTopic = 24;
/**
* Update a topic.
*/
ConsensusUpdateTopicTransactionBody consensusUpdateTopic = 25;
/**
* Delete a topic.
*/
ConsensusDeleteTopicTransactionBody consensusDeleteTopic = 26;
/**
* Submit a message to a topic.
* A message may be "chunked", and submitted in parts, if the total
* message size exceeds the limit for a single transaction.
*/
ConsensusSubmitMessageTransactionBody consensusSubmitMessage = 27;
/**
* Unsupported system transaction.
*
* Clients MUST NOT call this method, and any such transaction SHALL
* be rejected.
* A network MAY choose to charge punitive fees for attempting to
* execute an `uncheckedSubmit`.
*/
UncheckedSubmitBody uncheckedSubmit = 28;
/**
* Create a new Hedera token.
*/
TokenCreateTransactionBody tokenCreation = 29;
/**
* Freeze an account with respect to a token.
* A frozen account cannot transact in that token until unfrozen.
*/
TokenFreezeAccountTransactionBody tokenFreeze = 31;
/**
* Unfreeze an account with respect to a token.
*/
TokenUnfreezeAccountTransactionBody tokenUnfreeze = 32;
/**
* Grant KYC to an account with respect to a token.
* KYC is generally a "know your customer" assertion that a
* responsible entity has sufficient information to positively
* identify the account holder to relevant authorities.
*/
TokenGrantKycTransactionBody tokenGrantKyc = 33;
/**
* Revoke KYC from an account with respect to a token.
*/
TokenRevokeKycTransactionBody tokenRevokeKyc = 34;
/**
* Delete an Hedera token.
* The token will be marked deleted.
*/
TokenDeleteTransactionBody tokenDeletion = 35;
/**
* Update an Hedera token.
* Depending on what fields are to be modified, the signature
* requirements will vary. See `TokenUpdateTransactionBody` for
* further detail.
*/
TokenUpdateTransactionBody tokenUpdate = 36;
/**
* Mint new tokens.
* All minted tokens will be delivered to the treasury account for
* the token type. The "mint key" for the token must sign this
* transaction.
*/
TokenMintTransactionBody tokenMint = 37;
/**
* Burn tokens from the treasury account.
* The "burn key" for the token must sign this transaction.
*/
TokenBurnTransactionBody tokenBurn = 38;
/**
* Wipe tokens from an account.
* This will remove a specified amount of fungible/common tokens or
* a specified list of non-fungible/unique serial numbered tokens
* of a given token type from an Hedera account. The removed tokens
* are _burned_ as if by a `tokenBurn` transaction.
* The "wipe key" for the token must sign this transaction.
*/
TokenWipeAccountTransactionBody tokenWipe = 39;
/**
* Associate tokens to an account.
*/
TokenAssociateTransactionBody tokenAssociate = 40;
/**
* Dissociate tokens from an account.
*/
TokenDissociateTransactionBody tokenDissociate = 41;
/**
* Create a schedule.
* A schedule is a request to execute a specific transaction, included
* in the create body, in the future. The scheduled transaction may
* execute as soon as all signature requirements are met with the
* schedule create or a subsequent schedule sign transaction.
* A schedule may, alternatively, execute on expiration if
* long-term schedules are enabled and the schedule meets signature
* requirements at that time.
*/
ScheduleCreateTransactionBody scheduleCreate = 42;
/**
* Delete a schedule.
* The schedule will be marked as deleted.
*/
ScheduleDeleteTransactionBody scheduleDelete = 43;
/**
* Sign a schedule.
* Add one or more cryptographic keys to the list of keys that have
* signed a schedule, and which may serve to meet the signature
* requirements for the scheduled transaction.
*/
ScheduleSignTransactionBody scheduleSign = 44;
/**
* Update the custom fee schedule for a token.
* This transaction must be signed by the "fee schedule key"
* for the token.
*/
TokenFeeScheduleUpdateTransactionBody token_fee_schedule_update = 45;
/**
* Pause a Token.
*
* This internal transaction is performed at the end of a staking
* period to complete staking calculations and indicate that new
* staking period has started.
*/
NodeStakeUpdateTransactionBody node_stake_update = 51;
/**
* Provide a deterministic pseudorandom number based on network state.
*/
UtilPrngTransactionBody util_prng = 52;
/**
* Update one or more non-fungible/unique tokens.
* This will update metadata for one or more serial numbers within
* a collection (token type).
*/
TokenUpdateNftsTransactionBody token_update_nfts = 53;
/**
* Create a new node in the network address book.
* This is a privileged operation.
*
* This is a privileged operation.
*
* This is a privileged operation.
*
* This transaction will transfer one or more tokens or token
* balances held by the requesting account to the treasury
* for each token type.
*
*
* When complete, the requesting account SHALL NOT hold the
* rejected tokens.
* Custom fees and royalties defined for the tokens rejected
* SHALL NOT be charged for this transaction.
*/
TokenRejectTransactionBody tokenReject = 57;
/**
* "Airdrop" tokens.
* This transaction sends tokens from one or more "sender" accounts
* to one or more "recipient" accounts.
*
* If left empty, the users are accepting to pay any custom fee.
* If used with a transaction type that does not support custom fee limits, the transaction will fail.
*/
repeated CustomFeeLimit max_custom_fees = 1001;
}
/**
* A transaction body for handling a set of transactions atomically.
*/
message AtomicBatchTransactionBody {
// <<