How unionlabs/union works
Union is a cross-chain messaging and asset-transfer infrastructure project built around consensus verification and IBC compatibility. Its principal documented runtime workflow is Voyager relaying messages between supported ecosystems, using chain event sources, state access, and client modules; CosmWasm contracts and light clients provide on-chain protocol components. The repository also contains a user-facing app, SDKs, node, prover, and supporting services. The tree and excerpts establish these components but provide limited wiring evidence, so only README-documented relationships are connected; unsampled implementation links are omitted.
Main entry points: main.rs Voyager relay · transfer Transfer workflows · lightclient Light clients · cosmwasm CosmWasm contracts
Components 18
Relaying and state
- Voyager relay
voyager/src/main.rs - Voyager RPC
lib/voyager-core/src/server.rs - Relay queue
voyager/src/queue.rs - Chain event sources
voyager/plugins/event-source - Chain state modules
voyager/modules/state - ZKGM filter
voyager/plugins/zkgm-filter/src/main.rs
Chain protocol
- Light clients
cosmwasm/lightclient - CosmWasm contracts
cosmwasm - Union node
uniond/app/app.go
User application
- Transfer workflows
app2/src/lib/transfer - Chain explorer
app2/src/routes/explorer - Rewards dashboard
app2/src/lib/dashboard
Node and services
- ZK prover
galoisd/grpc/server.go - Node supervisor
unionvisor/src/main.rs - Cosmos faucet
drip/src/main.rs - MPC services
mpc/coordinator/src/main.rs
Shared libraries
- TypeScript SDK
ts-sdk/src
Other components
- Relayer operator
Connections 8
- Relayer operator → Voyager relay: operates
README.md - Voyager relay → Chain event sources: relays across
README.md - Voyager relay → Chain state modules: queries chain state
- Voyager relay → Light clients: supports verification
README.md - Voyager relay → CosmWasm contracts: relays messages
- Transfer workflows → CosmWasm contracts: transfers assets
- Transfer workflows → TypeScript SDK: uses SDK
- Union node → Light clients: uses CometBLS
README.md