Skip to content

ERC-7683

ERC-7683

Overview

ERC-7683 (Cross Chain Intents) is Ethereum's cross-chain intent standard, co-proposed by Uniswap Labs and Across Protocol. This standard provides a unified API interface for cross-chain value transfer systems, including a universal order structure and standardized settlement smart contract interfaces.

The core idea of ERC-7683 is to let users express "intents" rather than execute specific steps -- users only need to state the desired end result, and a network of fillers competes to fulfill the cross-chain operation.

Problems Solved

Complexity of Cross-Chain Interactions Traditional cross-chain bridging requires users to: 1. Approve tokens on the source chain 2. Initiate a cross-chain transaction 3. Wait for lengthy confirmation times 4. Manually claim assets on the destination chain 5. Handle failures and rollbacks

This process is complex, slow, and error-prone.

Liquidity Fragmentation Each cross-chain protocol has its own: - Order format - Filler network - Settlement mechanism - Data propagation method

This leads to fragmented liquidity, requiring fillers to integrate multiple protocols, and resulting in a poor user experience.

Lack of Standardization Different cross-chain intent systems cannot interoperate: - Orders cannot be shared between systems - Filler networks are isolated - Developers must write adapters for each system

Core Concepts

Intent-Driven Cross-Chain Interaction Users express an intent: "I want to exchange 100 USDC for at least 0.025 ETH on Optimism"

The filler network sees this intent and: 1. Competes to provide the best execution 2. Advances the ETH to the user on the destination chain 3. Receives USDC as compensation on the source chain

Standardized Order Structure ERC-7683 defines a unified cross-chain order (CrossChainOrder) structure: - Initiator address - Source and destination chains - Input assets and amounts - Output assets and minimum amounts - Fill deadline - Order data and attributes

Settlement Contract Interface Standardized smart contract interfaces for: - Creating cross-chain orders - Filling orders (executing on the destination chain) - Settlement and verification (on the source chain)

How It Works

Order Lifecycle

  1. User Initiates 

    User creates an order on the source chain (e.g., Ethereum mainnet):
"I want to exchange 100 USDC for at least 0.025 ETH on Arbitrum"

  2. Order Propagation Orders are propagated to all fillers through an off-chain network

  3. Filler Competition Multiple fillers review the order and compete to provide the best execution:

  4. Filler A: Willing to give 0.0251 ETH
  5. Filler B: Willing to give 0.0252 ETH

  6. Filler C: Willing to give 0.0253 ETH

  7. Fast Execution The winning filler immediately sends 0.0253 ETH to the user on Arbitrum

  8. Settlement The filler proves on Ethereum mainnet that the fill was completed and receives 100 USDC

Standard Interface

Create Order 

function open(OnchainCrossChainOrder calldata order) external returns (bytes32 orderId)

Fill Order 

function fill(bytes32 orderId, bytes calldata originData, bytes calldata fillerData) external

Resolve Order 

function resolve(ResolvedCrossChainOrder memory order) external

Key Advantages

Shared Liquidity - All protocols supporting ERC-7683 share the filler network - Deeper liquidity pools - Better prices and faster execution

User Experience Improvement - One-click cross-chain interaction - No need to wait for lengthy bridging times - Lower failure rates - Better prices (filler competition)

Developer Friendly - Unified integration interface - No need to write adapters for each bridge protocol - Composable cross-chain applications

Filler Incentives - Access to more order flow - Higher capital efficiency - Competitive market

Use Cases

Cross-Chain DEX Aggregation DEX aggregators can integrate ERC-7683 to provide optimal cross-chain trading paths: - User initiates a trade on one chain - Aggregator finds the best cross-chain route - Filler network executes quickly

Cross-Chain Yield Optimization DeFi protocols can automatically deploy funds to the highest-yield chain: - Protocol creates cross-chain intent orders - Fillers handle cross-chain transfers - Seamless cross-chain yield optimization for users

Cross-Chain Payments Payment applications can use ERC-7683 for seamless cross-chain payments: - User pays USDC on Polygon - Merchant receives USDC on Optimism - Fillers handle cross-chain settlement

Multi-Chain *DApps* Applications can build truly multi-chain experiences: - Users operate on any chain - Application logic is distributed across multiple chains - ERC-7683 handles cross-chain communication

Ecosystem

Protocol Support - *Uniswap* X: Uses ERC-7683 for cross-chain swaps - **Across Protocol: Cross-chain bridging protocol and co-proposer of ERC-7683 - 1inch: DEX aggregator, planning to integrate ERC-7683 - Cowswap: Intent-driven trading protocol

Filler Network - Professional market makers - MEV searchers - Cross-chain liquidity providers - Arbitrage bots

Technical Details

Order Structure 

struct CrossChainOrder {
    address settlementContract;  // Settlement contract address
    address swapper;             // Initiator
    uint256 nonce;
    uint32 originChainId;        // Source chain
    uint32 destinationChainId;   // Destination chain
    bytes32 orderDataType;       // Order data type
    bytes orderData;             // Order-specific data
}

Settlement Verification - Uses cross-chain messaging protocols to verify fills - Supports optimistic verification (fast) and pessimistic verification (secure) - Extensible proof systems

Security Considerations

Filler Trust - Users need to trust that fillers will execute correctly - Uses reputation systems and bond mechanisms - Settlement contracts ensure fund safety

Order Validity - Set reasonable deadlines - Prevent expired orders from being filled - Handle network congestion situations

Cross-Chain Message Verification - Ensure authenticity of fill proofs - Prevent double spending - Handle chain reorganizations

Relationship with Other Standards

vs Traditional Cross-Chain Bridges - Traditional bridges: Slow, complex, multi-step operations required - ERC-7683: Fast, simple, one-click completion

vs EIP-4337 (Account** Abstraction)** - Can be used together - Smart contract wallets can use ERC-7683 for cross-chain operations - Provides a complete chain abstraction experience

Development Resources

Reference Implementations - ERC-7683 Specification Code - Across Protocol Implementation

Integration Guide 1. Implement the ISettlementContract interface 2. Deploy to supported chains 3. Integrate the filler network 4. Implement order propagation mechanism

Future Outlook

Cross-Chain Interoperability ERC-7683 is driving the Ethereum ecosystem toward true multi-chain interoperability: - Chain abstraction: Users do not need to know which chain they are on - Unified liquidity: Liquidity across all chains is interconnected - Seamless experience: Cross-chain operations are as simple as single-chain

Ecosystem Growth As more protocols and fillers join the network: - Faster execution speeds - Better prices - Support for more chains and assets