Skip to main content
This section explains the anatomy of a transaction in the NEAR Protocol, describing its structure, components, and the actions that can be performed within a transaction. A transaction is a request from a user to the network to perform a set of actions. To create a transaction, the user must specify the following fields:
  • Signer: the account that signs the transaction
  • Actions: the set of actions to be performed (see below)
  • Receiver: the account on which to perform the actions
In addition, a transaction has the following fields to ensure its integrity and validity:
  • PublicKey: the public key used to sign the transaction (so the network can verify the signature)
  • Nonce: a number that is incremented for each transaction sent by the Signer
  • BlockHash: the hash of a recent block, to limit the time-validity of the transaction
Users create transactions and sign them with their private keys. Then, the transaction and its signature are broadcast together to the network, where they are validated and processed.
Each transaction has exactly one Signer and Receiver, but can have multiple Actions.
About nonce values:
  • When adding a key, the nonce is automatically assigned - particularly, it is given the value block height * 10^6 - so the value in the ADD_KEY action is ignored
  • A transaction is accepted only if the nonce value is in the range of: [(current_nonce_of_access_key + 1) .. (block_height * 10^6)]
  • Once a transaction is accepted, the access key’s nonce is set to the nonce value of the included transaction

​
Actions

Each transaction can have one or multiple Actions, which are the actual operations to be performed on the Receiver account. There are different types of actions that can be performed:
Invoke a function on a contract (optionally attaching NEAR to the call)Learn more
Transfer tokens to another accountLearn more
Deploy a contract in the accountLearn more

​
Example: Bundled Actions

For example, bob.near can bundle the following actions in a single transaction:
  • Create the account contract.bob.near
  • Transfer 5 NEAR to contract.bob.near
  • Deploy a contract in contract.bob.near
  • Call the function init in contract.bob.near
The Actions are executed in the order they are specified in the transaction. If any of the actions fails, the transaction is discarded and none of the actions take effect.
Notice that all actions are performed on the same account. It is not possible to perform actions on multiple accounts in a single transaction, because transactions can have only one receiver

Build docs developers (and LLMs) love

Get started for freeTalk to us