# Invarians

Invarians provides on-chain execution context for AI agents operating on blockchain infrastructure.

## What Invarians does

Invarians observes and certifies the structural regime of blockchain networks: L1, L2, and cross-chain bridges. It does not execute transactions. It provides signed attestations of infrastructure state before an agent acts.

## REST API - Live now

Endpoint: https://api.invarians.com/v2/
Auth: Bearer token - get at https://invarians.com/signup
Docs: https://invarians.com/developers

## MCP Server - Coming Q2 2026

Endpoint: https://agentic.invarians.com/mcp (not yet live)
Discovery: https://agentic.invarians.com/.well-known/mcp.json

## Tools (MCP - Q2 2026)

### invarians_get_scope()

Purpose: Discover the certified operational state of all chains and bridges.
Call this first when the chain pair is not known in advance.

Input (all optional):
- actionable (boolean): if true, returns only actionable chains and bridges
- bridge_type (string): "native" or "ccip"
- include_l2 (boolean): default true
- include_bridges (boolean): default true

Output: scope object with l1[], l2[], bridges[] - each entry includes:
- id: chain or bridge identifier
- regime: S1D1 / S1D2 / S2D1 / S2D2 (L1/L2) or state: BS1 / BS2 (bridges)
- actionable: boolean - computed summary, agent reads this field
- calibrated: boolean - true if threshold from historical backtests
- certified_at: ISO 8601 timestamp

### invarians_get_execution_context(from, to)

Purpose: Certify a specific chain pair before acting.
Returns a signed attestation covering L1 regime, L2 regime, bridge state, and freshness.

Input:
- from (required): source chain - e.g. "ethereum", "solana"
- to (required): target chain - e.g. "arbitrum", "base", "solana"
- bridge (optional): "native" or "ccip"

Output:
- chain: target chain identifier
- oracle_status: "OK" or error
- l1_regime: S1D1 / S1D2 / S2D1 / S2D2
- l2_regime: S1D1 / S1D2 / S2D1 / S2D2
- bridge_state: BS1 / BS2
- l2_verified: boolean
- data_age_seconds: integer
- signature: HMAC-SHA256 string

## Field semantics

actionable: true = proceed. actionable: false = do not act, regardless of reason (BS2, S2Dx, uncalibrated threshold).

calibrated: true = threshold from >=30 days historical backtests. false = hardcoded threshold, lower statistical confidence. Signal is valid in both cases.

Regime codes (L1 and L2):
- S1D1: structure nominal, demand nominal - optimal conditions
- S1D2: structure nominal, demand elevated - elevated costs, no structural risk
- S2D1: structure stressed, demand nominal - not detectable by fee monitors
- S2D2: structure stressed, demand elevated - compound stress, high execution risk

Bridge state:
- BS1: nominal flow - proceed
- BS2: degraded or RMN pause - do not execute cross-chain, regardless of L1/L2 regime

signature: HMAC-SHA256 attestation. Verifiable via GET /attestation/verify - no additional secret required beyond API key.

## Call sequence (MCP - Q2 2026)

1. invarians_get_scope() - discover what is available and actionable
2. Filter by actionable = true and calibrated = true for highest confidence
3. invarians_get_execution_context(from, to) - certify the chosen pair
4. Act with cryptographic proof

## A2A usage

In agent-to-agent coordination, Agent A calls get_scope(), builds a shared context with the signature and computed_at, and passes it to Agent B via A2A protocol. Agent B can verify independently via get_scope() or trust the signed payload. Both agents operate on the same certified ground truth.

shared_context = {
  actionable_chains: [c.id for c in scope.l1 if c.actionable],
  actionable_bridges: [{from, to, type} for b in scope.bridges if b.actionable],
  invarians_signature: scope.signature,
  computed_at: scope.computed_at
}

## Coverage

Live (V1, centralized - REST API):
- L1: Ethereum (calibrated), Polygon (calibrated), Solana (tau only - demand dimension not calibrated), Avalanche (in progress)
- L2: Arbitrum, Base, Optimism
- Bridges (variable-latency scope): 10 Circle CCTP routes (BS1/BS2 preliminary calibration on circle_api_latency_ms since 2026-05-04, P97/14d, confidence LOW; lifecycle to MEDIUM ~2026-05-29 then HIGH ~2026-06-03). 10 Chainlink CCIP lanes (raw observability, statistical classification deferred to Q3-Q4 2026; RMN cursed binary safety override available regardless).

Preview Q3-Q4 2026:
- Chainlink CRE integration (Hybrid / DON threshold signature)
- CCIP EVM lanes (ETH->ARB/BASE/OP/POL/AVAX)

## Links

- Full docs: https://invarians.com/developers
- Get API key: https://invarians.com/signup
- CRE integration: https://invarians.com/cre.html
- A2A architecture: https://invarians.com/a2a-pipe-diagram.html
- MCP discovery: https://agentic.invarians.com/.well-known/mcp.json
- A2A discovery: https://agentic.invarians.com/.well-known/agent.json