union

Union is the hyper-efficient zero-knowledge infrastructure layer for general message passing, asset transfers, NFTs, and DeFi. Its based on Consensus Verification and has no dependencies on trusted third parties, oracles, multi-signatures or MPC. It implements IBC for compatibility with Cosmos chains and connects to EVM chains like Ethereum, Berachain (beacon-kit), Arbitrum, and more.

The upgradability of contracts on other chains, connections, token configurations, and evolution of the protocol will all be controlled by decentralized governance, aligning the priorities of Union with its users, validators, and operators.

Components

Component	Description	Language(s)
uniond	The Union node implementation, using CometBLS	Go
galoisd	The zero-knowledge prover implementation	Go Gnark
voyager	Modular hyper-performant cross-ecosystem relayer	Rust
cosmwasm	CosmWasm smart contract stack	Rust
light-clients	Light Clients for various ecosystems	Rust
unionvisor	Node supervisor intended for production usage	Rust
drip	Faucet for Cosmos chains: app.union.build/faucet	Rust
evm	EVM smart contract stack

Quickstart

Install Nix to reproducibly build any component, and to enter a dev shell with all dependencies:

curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | sh -s -- install

(Note that some components can only be built on Linux. If you are using macOS, we recommend using OrbStack to easily set up a NixOS VM within two minutes. Most Union developers use macOS with OrbStack, and there is no need to install Nix inside of the NixOS VM.)

You can now reproducibly build any of Union's components from source:

nix build .#uniond -L
nix build .#voyager -L
nix build .#app -L

# to see all packages, run:
nix flake show

The result of whatever you build will be in result/

You can now also enter our dev shell, which has all of the dependencies (cargo, rustc, node, go, etc.) you need to work on any component: (Don't worry, this will not affect your system outside of this repo)

nix develop

Run the following to format the entire repo and check your spelling before each PR:

nix run .#pre-commit -L

Check the #developers channel on Union's discord if you need any help with this.

Supported Chains

Network	Mainnets	Testnets
Arbitrum	arbitrum.42161	arbitrum.421614
Babylon	babylon.bbn-1	babylon.bbn-test-6
Base	base.8453	base.84532
Berachain	berachain.80094	berachain.80069
Bob	bob.60808	bob.808813
BSC	bsc.56	bsc.97
Corn	corn.21000000	corn.21000001
Ethereum	ethereum.1	ethereum.11155111, ethereum.560048
Osmosis	osmosis.osmosis-1	osmosis.osmo-test-5
Sei	sei.pacific-1, sei.1329	sei.atlantic-2, sei.1328
Sui	-	sui.4c78adac
Union	union.union-1	union.union-testnet-10
Xion	xion.xion-mainnet-1	xion.xion-testnet-2

For the full list see https://docs.union.build/ucs/04/

Docs

The official docs are hosted here. Each individual component also has accompanying developer documentation for contributors, which you can find in each README.md.