Documentation menu

Deterministic addresses

Omnisea uses deterministic deployment so bridge contracts and representation tokens can keep the same address across supported chains.

The bridges, the representation implementations, and every representation token live at identical addresses on every supported chain - including chains where they have not been deployed yet.

How the guarantee works

The bridge computes each representation address from the asset's canonical identity: (originalChainId, originalToken). That means predictRepresentation(originalChainId, originalToken) returns the same address on every supported chain, and that address is correct before the first transfer ever happens.

Indexers, wallets, and UIs can label Omnisea representations of a known original without maintaining a separate address registry per chain.

What this means for integrators

  • Hardcode one bridge address per asset kind for every chain. There is no per-chain address registry to maintain.
  • Compute a representation address off-chain once; it is valid network-wide.
  • A token's representation address can be safely displayed, allowlisted, or used in routing logic before that token has ever been bridged to the chain in question.

See Deployments for the live addresses.

Feedback