Skip to main content

Get a System Transaction

The Flow CLI provides a command to fetch the system transaction for a given block reference. You can optionally provide a transaction ID to target a specific system transaction within that block.


_10
flow transactions get-system <block_id|latest|block_height> [tx_id]

warning

Querying with a system transaction ID ([tx_id]) is part of the Forte network upgrade and is currently available on Flow Emulator (CLI v2.7.0+) and Flow Testnet. See the announcement for context: Forte: Introducing Actions & Agents.

Use Cases​

Example Usage​


_23
> flow transactions get-system latest --network mainnet
_23
_23
Status ✅ SEALED
_23
ID 40bc4b100c1930c61381c22e0f4c10a7f5827975ee25715527c1061b8d71e5aa
_23
Payer —
_23
Authorizers []
_23
_23
Proposal Key: —
_23
_23
No Payload Signatures
_23
No Envelope Signatures
_23
_23
Events:
_23
Index 0
_23
Type A.1654653399040a61.FlowToken.TokensDeposited
_23
Tx ID 40bc4b100c1930c61381c22e0f4c10a7f5827975ee25715527c1061b8d71e5aa
_23
Values
_23
- amount (UFix64): 0.00100000
_23
- to ({}?): 5068e27f275c546c
_23
_23
Code (hidden, use --include code)
_23
_23
Payload (hidden, use --include payload)

Select a specific system transaction within the block by ID:


_10
> flow transactions get-system latest 07a8...b433 --network mainnet

Arguments​

Block Reference​

  • Name: <block_id|latest|block_height>
  • Valid Input: a block ID (hex), the keyword latest, or a block height (number).

The first argument is a reference to the block whose system transaction you want to fetch.

Transaction ID (optional)​

  • Name: [tx_id]
  • Valid Input: a transaction ID (hex).

Optionally narrow the result to a specific system transaction within the referenced block.

Flags​

Include Fields​

  • Flag: --include
  • Valid inputs: code, payload, signatures, fee-events

Specify fields to include in the result output. Applies only to the text output.

Exclude Fields​

  • Flag: --exclude
  • Valid inputs: events

Specify fields to exclude from the result output. Applies only to the text output.

Host​

  • Flag: --host
  • Valid inputs: an IP address or host address.
  • Default: 127.0.0.1:3569 (Flow Emulator)

Specify the host address of the Access API that will be used to execute the command. This flag overrides any host defined by the --network flag.

Network Key​

  • Flag: --network-key
  • Valid inputs: A valid network public key of the host in hex string format

Specify the network public key of the Access API that will be used to create secure client connections when executing the command.

Network​

  • Flag: --network
  • Short Flag: -n
  • Valid inputs: the name of a network defined in the configuration (flow.json)
  • Default: emulator

Specify which network you want the command to use for execution.

Filter​

  • Flag: --filter
  • Short Flag: -x
  • Valid inputs: a case-sensitive name of the result property.

Specify any property name from the result you want to return as the only value.

Output​

  • Flag: --output
  • Short Flag: -o
  • Valid inputs: json, inline

Specify the format of the command results.

Save​

  • Flag: --save
  • Short Flag: -s
  • Valid inputs: a path in the current file system.

Specify the filename where you want the result to be saved

Log​

  • Flag: --log
  • Short Flag: -l
  • Valid inputs: none, error, debug
  • Default: info

Specify the log level. Control how much output you want to see during command execution.

Configuration​

  • Flag: --config-path
  • Short Flag: -f
  • Valid inputs: a path in the current file system.
  • Default: flow.json

Specify the path to the flow.json configuration file. You can use the -f flag multiple times to merge several configuration files.

Version Check​

  • Flag: --skip-version-check
  • Default: false

Skip version check during start up to speed up process for slow connections.

Notes​

System transactions currently cover:

More resources:

Rate this page