Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

DApp Integration Overview

Concero V2 is a message protocol where each message defines its own delivery and verification stack.

At a high level:

  1. Source app creates a MessageRequest and pays message fee.
  2. ConceroRouter emits a message receipt.
  3. Relayer requests message verification for the message and delivers it to destination router.
  4. Destination router receives the message, forwarding it to the app.
  5. Destination app verifies the message and runs its logic.

Mental model: two layers

Protocol Layer

Handled by router, relayers and verifiers:

  • Fee quoting,
  • Message event emission,
  • Message verification,
  • Message delivery to destination router.

Application Layer

Handled by your ConceroClient on the destination chain:

  • Accepting messages only from Concero Router.
  • Allowing only trusted relayers and verifiers.
  • Executing app logic in _conceroReceive.

Your Application Responsibilities

  • Configure ConceroClient/ConceroClientBase safely.
  • Allowlist relayer and verifier modules you trust.
  • Set verification policy (all required verifiers by default in ConceroClient).
  • Decode and process payload in _conceroReceive.