unionlabs/union

The trust-minimized, zero-knowledge bridging protocol, designed for censorship resistance, extremely high security, and usage in decentralized finance.

View on GitHub ↗Jump to charts ↓Open shareable report

Summary Information

Updated 37 minutes ago
Added to GitGenius on May 17th, 2025
Created on May 16th, 2023
Open Issues & Pull Requests: 193 (+1)
Number of forks: 3,888
Total Stargazers: 73,844 (-2)
Total Subscribers: 1,599 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 12.8 hours
Mean response time: 52.6 days
90th percentile: 199.0 days
Tracked items: 1,045

How this project is maintained

Around half of the issues opened in the past year never receive a reply. 90% of open issues come from outside the core team, so the backlog reflects real-world use rather than internal planning. Work labelled "P-high" is answered fastest, typically in under an hour, while "C-dead-link" waits about 5 days. Only 3% of issues opened in the past year have been closed. Three people close 70% of everything that gets resolved.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 106
New in 7 days: 0
Closed in 7 days: 0
Avg open age: 609 days
Stale 30+ days: 105
Stale 90+ days: 104

Recent activity

Opened in 7 days: 0
Closed in 7 days: 0
Comments in 7 days: 0
Events in 7 days: 0

Top labels

  • C-bug (227)
  • C-enhancement (171)
  • A-docs (128)
  • C-nightly (128)
  • C-dead-link (92)
  • A-app (89)
  • P-high (81)
  • E-easy (72)

Most active issues this week

No issue events were indexed in the last 7 days.

Detailed Description

Union is a trust-minimized, zero-knowledge bridging protocol built in Rust that enables censorship-resistant cross-chain communication and asset transfers for decentralized finance applications. The protocol implements consensus verification without reliance on trusted third parties, oracles, multi-signatures, or MPC, distinguishing it from conventional bridging solutions. Union integrates with Cosmos chains through IBC compatibility and connects to EVM chains including Ethereum, Arbitrum, Base, Berachain, and numerous others, supporting both mainnet and testnet deployments across a diverse ecosystem of blockchain networks.

The repository contains multiple specialized components working in concert to deliver the protocol's functionality. The uniond component serves as the Union node implementation using CometBLS, while galoisd provides the zero-knowledge prover implementation. Voyager functions as a modular, high-performance cross-ecosystem relayer written in Rust. The cosmwasm directory contains the CosmWasm smart contract stack with light clients for various ecosystems, and the evm directory houses Solidity-based smart contracts for EVM compatibility. Supporting infrastructure includes unionvisor, a production-grade node supervisor, drip, a faucet for Cosmos chains, and a TypeScript SDK for programmatic interaction with Union.

The project maintains a web presence through multiple components: app.union.build provides a user-facing application built with TypeScript and Svelte, while union.build serves as the main website constructed with TypeScript and Astro. Development is facilitated through Nix, enabling reproducible builds across all components and providing a comprehensive development shell with all necessary dependencies including Cargo, Rustc, Node, and Go. The repository explicitly supports macOS developers using OrbStack for NixOS virtualization, reflecting practical consideration for the development community.

Activity tracking reveals sustained engagement with the codebase.

The protocol's governance model ensures decentralized control over contract upgradability, connections, token configurations, and protocol evolution. This alignment of Union's priorities with users, validators, and operators reflects a commitment to community-driven development. The supported chain list encompasses major networks like Ethereum, Arbitrum, and Osmosis alongside emerging ecosystems such as Berachain and Babylon, with testnet availability enabling developer experimentation.