Skip to content

README.md

Latest commit

 

History

History
105 lines (70 loc) · 5.32 KB

README.md

File metadata and controls

105 lines (70 loc) · 5.32 KB
Raw

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

flowchart LR
  User[User]
  App[Your App]
  SDK[Epoch SDK]
  Chain[Blockchains]

  User --> App
  App --> SDK
  SDK --> Chain
  Chain --> User
Loading
  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
Gasless mode (testnet) Sign-only UX — smart wallet batches or relay handles on-chain gas Testnet; see Gasless Deposits and Transaction Batching & EIP-7702

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.
  • Gasless mode is testnet-only today; when enabled, treat the whole user flow as gasless. Local wallets: convertToSmartAccount then solveIntent({ gasless: true, allowGaslessSmartAccount: true }). Test with pnpm example:local-wallet in smallocator/sdk. See Gasless Deposits and Transaction Batching & EIP-7702.
  • 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