Skip to main content

How to connect Orchestrate to a Blockchain network

Use the Orchestrate Gateway API to connect Orchestrate to blockchain networks. Orchestrate is compatible with all Ethereum Blockchain networks (public or private) and supports connection to multiple networks simultaneously. For example, you could connect to the Ethereum mainnet and Rinkeby testnet on the same Orchestrate instance.

Connecting to a Blockchain network serves three purposes:

tip

Check the REST API Reference or the JS SDK Reference for a detailed description of all endpoints.

Register a chain​

Register a chain using the Orchestrate Gateway API by sending a POST request to the /chains endpoint.

{
  "name": "mainnet",
  "urls": ["https://mainnet.infura.io/v3/a73136601e6f4924a0baa4ed880b535e"],
  "listener": {
    "backOffDuration": "1s",
    "depth": 0,
    "externalTxEnabled": false,
    "fromBlock": "latest"
  }
}
  • name - name of the chain. Must be unique.
  • urls - list of URLs of Ethereum nodes to connect to
  • listener (optional) - Transaction Listener configuration
    • fromBlock - block from which the Transaction Listener should start processing transactions (default latest)
    • backoffDuration - time to wait before trying to fetch a new mined block (for example 1s or 1m, default is 5s)
    • depth - block depth after which the Transaction Listener considers a block final and processes it (default 0)
    • externalTxEnabled - whether to listen to external transactions, meaning not crafted by Orchestrate (default false)

Register a private GoQuorum (Tessera) chain​

To send private transactions using GoQuorum, you will have to register a private transaction manager when creating a chain.

{
  "name": "mainnet",
  "urls": ["https://mainnet.infura.io/v3/a73136601e6f4924a0baa4ed880b535e"],
  "listener": {
    "backOffDuration": "1s",
    "depth": 0,
    "externalTxEnabled": false,
    "fromBlock": "latest"
  },
  "privateTxManager": {
    "type": "Tessera",
    "url": "http://tessera:3000"
  }
}
  • privateTxManager(optional) - to be used for GoQuorum (Tessera) private transactions
    • url - transaction manager endpoint
    • type - currently only supports Tessera
tip

If using Hyperledger Besu private transactions, configuring the private transaction manager is not required.