Skip to content
You are reading Codefi Orchestrate development version documentation and some displayed features may not be available in the stable release. You can switch to stable version using the version box at screen bottom.

Connect blockchain to Orchestrate

Use the Orchestrate Gateway API to register blockchain networks. Orchestrate is compatible with all Ethereum (EVM) based blockchain networks.

Each time you register a new network, Orchestrate automatically starts a transaction listener that processes transaction receipts mined on the blockchain network.

The Orchestrate Gateway API stores the following:

  • uuid: Orchestrate’s unique internal identifier
  • name: user given name of the chain
  • urls: list of JSON-RPC URLs of nodes in the chains
  • listener: Transaction Listener configuration (optional)
    • fromBlock: block from which the Transaction Listener started processing transaction receipts (default latest)
    • backoffDuration: time to wait before trying to fetch a new mined block (for example 1s or 1m, default is 1s)
    • depth: block depth after which the Transaction Listener considers a block final and processes it (default 0)
    • blockPosition: last block processed by the Transaction Listener.
    • externalTxEnabled: whether to listen to external transactions, meaning not crafted by Orchestrate (default False)
  • privateTxManager: to be used for GoQuorum private transactions (optional)
    • url: transaction manager endpoint
    • type: Tessera


If using Besu private transactions, Orchestrate does not directly communicate with Orion so configuring the private transaction manager is not required.

Use the REST APIs to manipulate the chain. Use the uuid of the chain to update, amend, or delete the chain.

ConsenSys has acquired Quorum from J.P. Morgan. Please read the FAQ.
Questions or feedback? You can obtain paid professional support by Consensys at