Repository files navigation

Union is the hyper-efficient zero-knowledge infrastructure layer for general message passing, asset transfers, NFTs, and DeFi. It’s based onConsensus Verification and has no dependencies on trusted third parties, oracles, multi-signatures, or MPC. It implementsIBC for compatibility withCosmos chains and connects to EVM chains likeEthereum,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.

InstallNix toreproducibly build any component, and to enter a dev shell withall 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 usingOrbStack to easily set up aNixOS VM within two minutes. Most Union developers use macOS withOrbStack, and there is no need to install Nix inside of theNixOS VM.)

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

nix build .#uniond -Lnix build .#voyager -Lnix build .#app -L# to see all packages, run:nix flake show

The result of whatever you build will be inresult/

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 onUnion's discord if you need any help with this.

The official docs are hostedhere. Each individual component also has accompanying developer documentation for contributors, which you can find in eachREADME.md.