Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Overview

What problem Epoch solves

Users increasingly hold assets on one chain but want to act on another — swap tokens, bridge value, or call a protocol (buy a ticket, deposit into a pool, etc.). Today that usually means multiple manual steps: bridge, swap, approve, execute.

Epoch collapses that into a single signed intent. The user connects their wallet, confirms what they want, and Epoch handles routing, quoting, and execution across chains.

Example: a user on Polygon wants to buy raffle tickets on Base. They pick USDC on Polygon, sign once, and receive tickets on Base — without managing bridges or separate swap UIs.

How it works

  1. Your app builds a task describing the desired outcome (token in, token out, destination chain, optional protocol action).

  2. The SDK fetches a quote, coordinates wallet signatures, and submits the intent.

  3. Epoch finds a path, executes transactions, and reports status via the SDK.

  4. The user sees the result on the destination chain.

Users sign with a standard wallet (MetaMask, Rainbow, WalletConnect, etc.). No smart-wallet deployment is required.

Capabilities

Capability
Description
Example

Cross-chain swap

Exchange token A on chain X for token B on chain Y

USDC on Polygon → USDC on Base

Cross-chain bridge

Move the same asset across chains

USDC on Arbitrum → USDC on Optimism

Swap + bridge

Combined routing in one intent

WETH on Optimism → USDC on Base

Protocol interaction

Execute an on-chain action after funding

Buy raffle tickets on Base from Polygon

Resource locks (Compact)

Collateral-backed intents via The Compact

Partner flows requiring locked deposits

Supported networks

Epoch supports a growing set of source chains (where the user holds funds) and destination chains (where the outcome is delivered).

See the full list in Supported Chains & Tokens.

Mainnet source chains (reference integration): Polygon, Optimism, Arbitrum One Testnet source chains: Ethereum Sepolia, Base Sepolia, Optimism Sepolia Destination (raffles example): Base, Base Sepolia

Contact the Epoch team to confirm availability for your use case or to request new chains.

Reference integration: Kismet

Kismet is a live application built on Epoch:

  • Raffles are deployed on Base (mainnet) or Base Sepolia (testnet).

  • Users can fund and buy tickets from Polygon, Optimism, or Arbitrum (and testnets).

  • The app uses the Epoch SDK with a quote-then-confirm flow for fixed-price ticket purchases.

This is the recommended pattern for protocol interaction integrations. Details: Protocol Interaction Guide.

Limitations (integration-facing)

  • Reverse quotes are required when the output amount is fixed (e.g. ticket price × quantity). Pass tokenInAmount: "0" and set minTokenOut to the required output.

  • Execution time depends on cross-chain path complexity; poll intent status rather than assuming instant completion.

  • Supported tokens vary by chain; see Supported Chains & Tokens.

  • New protocols require Epoch partner onboarding before extraData actions are routable.

Protocol products

Epoch ships supporting tools alongside the SDK and allocator:

Product
Description

User Dashboard

View Compact deposits, mint testnet tokens, and manage forced withdrawals. Source.

See Links for all official URLs.

Next steps

NextOne Pager

Last updated