Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/unionlabs/union
The trust-minimized, zero-knowledge bridging protocol, designed for censorship resistance, extremely high security, and usage in decentralized finance.
https://github.com/unionlabs/union
astro blockchain bridge cosmos cosmwasm ethereum evm golang indexer nix prover relayer rust solidity svelte typescipt typescript zero-knowledge
Last synced: about 3 hours ago
JSON representation
The trust-minimized, zero-knowledge bridging protocol, designed for censorship resistance, extremely high security, and usage in decentralized finance.
- Host: GitHub
- URL: https://github.com/unionlabs/union
- Owner: unionlabs
- License: apache-2.0
- Created: 2023-05-16T22:33:39.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-06T13:12:12.000Z (7 days ago)
- Last Synced: 2024-12-06T13:57:34.632Z (7 days ago)
- Topics: astro, blockchain, bridge, cosmos, cosmwasm, ethereum, evm, golang, indexer, nix, prover, relayer, rust, solidity, svelte, typescipt, typescript, zero-knowledge
- Language: Rust
- Homepage: https://union.build
- Size: 442 MB
- Stars: 384
- Watchers: 5
- Forks: 33
- Open Issues: 308
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE-APACHE
- Codeowners: CODEOWNERS
Awesome Lists containing this project
- awesome-ccamel - unionlabs/union - The trust-minimized, zero-knowledge bridging protocol, designed for censorship resistance, extremely high security, and usage in decentralized finance. (Rust)
README
[](https://garnix.io)
[][docs]
[![Discord badge]](https://discord.union.build)
[![Twitter handle]][twitter badge]
Union is the hyper-efficient zero-knowledge infrastructure layer for general message passing, asset transfers, NFTs, and DeFi. It’s 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)](https://github.com/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`](./uniond) | The Union node implementation, using [`CometBLS`] | [Go] |
| [`galoisd`](./galoisd) | The zero-knowledge prover implementation | [Go] [Gnark] |
| [`voyager`](./voyager) | Modular hyper-performant cross-ecosystem relayer | [Rust] |
| [`hubble`](./hubble) | Multi-ecosystem, GMP-enabled chain indexer | [Rust] |
| [`cosmwasm`](./cosmwasm) | [CosmWasm] smart contract stack | [Rust] |
| [`light-clients`](./light-clients) | [Light Clients] for various ecosystems | [Rust] |
| [`unionvisor`](./unionvisor/README.md) | Node supervisor intended for production usage | [Rust] |
| [`drip`](./drip) | Faucet for [Cosmos] chains: [app.union.build/faucet] | [Rust] |
| [`evm`](./evm) | [EVM] smart contract stack | [Solidity] |
| [`app`](./app) | [app.union.build] | [TypeScript] [Svelte] |
| [`site`](./site) | [union.build] | [TypeScript] [Astro] |
| [`TypeScript SDK`](./typescript-sdk) | TypeScript SDK for interacting with Union | [TypeScript] |
## Quickstart
Install [Nix] to _[reproducibly build](https://en.wikipedia.org/wiki/Reproducible_builds) any component_, and to enter a dev shell with _all dependencies_:
```sh
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:
```sh
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)_
```sh
nix develop
```
Run the following to format the entire repo and check your spelling before each PR:
```sh
nix run .#pre-commit -L
```
Check the `#developers` channel on [Union's discord](https://discord.union.build) if you need any help with this.
## Docs
The official docs are hosted [here][docs]. Each individual component also has accompanying developer documentation for contributors, which you can find in each `README.md`.
[app.union.build]: https://app.union.build
[app.union.build/faucet]: https://app.union.build/faucet
[arbitrum]: https://github.com/OffchainLabs/arbitrum
[astro]: https://astro.build
[consensus verification]: https://union.build/docs/concepts/consensus-verification/
[cosmos]: https://cosmos.network
[cosmwasm]: https://cosmwasm.com/
[discord badge]: https://img.shields.io/discord/1158939416870522930?logo=discord
[docs]: https://docs.union.build "Official Union Docs"
[ethereum]: https://ethereum.org
[evm]: https://ethereum.org/en/developers/docs/evm/
[gnark]: https://github.com/ConsenSys/gnark
[go]: https://go.dev/
[ibc]: https://github.com/cosmos/ibc "cosmos/ibc"
[light clients]: https://a16zcrypto.com/posts/article/an-introduction-to-light-clients/
[nix]: https://zero-to-nix.com/
[nixos]: https://nixos.org
[orbstack]: https://orbstack.dev/
[rust]: https://www.rust-lang.org/
[solidity]: https://soliditylang.org/
[svelte]: https://svelte.dev
[twitter badge]: https://twitter.com/intent/follow?screen_name=union_build
[twitter handle]: https://img.shields.io/twitter/follow/union_build.svg?style=social&label=Follow
[typescript]: https://www.typescriptlang.org/
[union.build]: https://union.build
[`cometbls`]: https://github.com/unionlabs/cometbls