Orbit CLI tools

CLI tools to work with Orbit chains

Available tools:

• Find chains
• Fetch chain information
• Get chain
• Calculate chains value
• Get chains' client version
• Get chain's fee information
• Find cross-chain messages

Find chains

This tool searches new orbit chains that have been deployed on the specified parent chain. It does so by searching for RollupInitialized events, which are usually emitted by RollupCreator contracts whenever a new chain is created.

Once a chain has been found, it returns the following information:

• chain id
• hash of the transaction where the chain was created
• block where the chain was created
• rollup address
• sequencerInbox address

Usage:

yarn findChains --parentChainId <chainId>

Available options:

• --parentChainId (required): id of the parent chain (it must be supported by the orbit SDK)
• --fromBlock and --toBlock: blocks to limit the search range
• --parentChainRpc: rpc to use (by default, the script will use the rpc provided by viem)
• --saveChainsInformation: saves the information of the chain to the orbit-chains.json file (notice that information like the block explorer URL or the orbit chain RPC can't be found this way and won't be saved)

Example:

yarn findChains --parentChainId 42161 --fromBlock 244716654

Fetch chain information

This tool fetches the following information from an orbit chain:

• chain id
• core contracts
• token bridge contracts

Additionally, this tool can save this information in a local json file orbit-chains.json (name by default).

Usage:

yarn fetchChainInformation --rollup <rollup address> --parentChainId <parent chain id>

Available options:

• --rollup (required): address of the rollup contract
• --parentChainId (required): id of the parent chain (it must be supported by the orbit SDK)
• --parentChainRpc: parent chain RPC to use (by default, the script will use the RPC provided by viem)
• --rpc: RPC of the orbit chain, it will be used to extract the chain id, and optionally to save it to the local JSON file
• --tokenBridgeCreator: address of the TokenBridgeCreator contract used to create the token bridge of the chain (by default, the script will use the one set in the Orbit SDK)
• --saveChainInformation: whether or not to save the information found in the local JSON file (if the chain id exists, it will not save the information) (by default, the script won't save the information)
• --updateInformation: whether or not to update the information found in the local JSON file, even if the chain id already exists there. It must be used with --saveChainInformation.

Example:

yarn fetchChainInformation --rollup 0xC47DacFbAa80Bd9D8112F4e8069482c2A3221336 --parentChainId 42161 --rpc https://xai-chain.net/rpc --saveChainInformation

Get chain

Returns the information of a chain that exists in the local JSON file.

Usage:

yarn getChain --id <chain id> --rpc <chain RPC> --rollup <rollup address>

All parameters are optional, but at least one must be used.

Calculate chains value

Calculates the following information of all the chains that exist in the orbit-chains.json file:

• TVL of the chain: calculated as the amount of native tokens locked in the Bridge contract
• Last block number reported by the sequencer

The TVL is calculated in both native token assets and USD. The USD value is obtained by calling Coingecko's API, so a DEMO api key is required for it to work. Otherwise, 0 USD will be returned.

The scripts yields the information of all chains in a table format, ordered by the amount of USD locked in the Bridge contract.

Available options:

• --sortByActivity: orders the information by last block number reported, instead of TVL
• --showFullTable: shows all the information obtained (might not fit smaller screens)

Example:

yarn calculateChainsValue

Get chains' client version

Calculates the following information of all the chains that exist in the orbit-chains.json file:

• Client version run by the RPC
• Last block number reported by the RPC

The scripts yields the information of all chains in a table format.

Available options:

• --sortByClientVersion: orders the information by the RPC's client version
• --sortByLastBlockDate: orders the information by last block number reported by the RPC
• --showFullTable: shows all the information obtained (might not fit smaller screens)

Example:

yarn getChainsClientVersion

Get chain's fee information

Calculates the following information of the specified chain:

• Batch poster address
• Parent chain base fee collector address
• Current estimated parent chain base fee
• Parent chain surplus fee collector address
• Parent chain surplus fee rate
• Orbit chain base fee collector address
• Minimum chain base fee
• Orbit chain surplus fee collector address
• Current chain surplus fee

The options available are the same as for the "Get chain" script.

Example:

yarn getChainFeesInformation --id <chain id> --rpc <chain RPC> --rollup <rollup address>

Find cross-chain messages

Finds all cross-chain messages created from a transaction on the parent chain. It shows the following information about them:

• Parent chain transaction hash
• Depost transaction on the orbit chain (if it's a deposit)
• SubmitRetryable transaction (if it's a retryable ticket)
• Retryable execution transaction (if it's a retryable ticket that was auto-redeemed)

Available options:

• One of --id, --rpc, --rollup: to find the chain in the orbit-chains.json file, just like in the "Get chain" script
• --transactionHash: hash of the transaction on the parent chain, that potentially created the cross-chain messages

Example:

yarn findCrosschainMessages --id <chain id> --rpc <chain RPC> --rollup <rollup address> --transactionHash <transaction on parent chain>