# Table of Contents

- [Introduction](#introduction)

---

# Introduction

Introduction
============

Welcome to the Open Intents Framework documentation

Copy MarkdownOpen

[Open Intents Framework (OIF)](https://docs.openintents.xyz/docs#open-intents-framework-oif)

=============================================================================================

The Open Intents Framework (OIF) is a full-stack developer framework that enables permissionless cross-chain intents to be deployed, solved, and discovered. OIF provides a modular, intent-based protocol for cross-chain swaps where users sign customizable intents describing desired assets, delivery conditions, validation requirements, and execution parameters.

[What Are Intents?](https://docs.openintents.xyz/docs#what-are-intents)

------------------------------------------------------------------------

Intents are user-signed descriptions of desired outcomes. Instead of specifying exact transaction steps, users express what they want to achieve (e.g., "swap 100 USDC on Base for ETH on Arbitrum"), and solvers compete to fulfill these intents efficiently.

[Core Components](https://docs.openintents.xyz/docs#core-components)

---------------------------------------------------------------------

OIF consists of three main components:

*   **Smart Contracts**: On-chain settlement infrastructure for intent execution and validation
*   **Solvers**: Off-chain services that discover, price, and fulfill user intents
*   **Aggregators**: Services that route intents to multiple solvers for optimal pricing

### [How It Works](https://docs.openintents.xyz/docs#how-it-works)

get quote

request quotes

request quotes

quote response

quote response

best quotes

submit intent

route intent

fulfill

User

Aggregator

Solver A

Solver B

Aggregator

User

User

Aggregator

Best Solver

Smart Contracts

[Key Features](https://docs.openintents.xyz/docs#key-features)

---------------------------------------------------------------

### [Output-Input Separation](https://docs.openintents.xyz/docs#output-input-separation)

OIF is built with output-input separation, fully decoupling system components to support different asset collection mechanisms. Both Output First and Input Second flows are supported through Resource Locks and traditional escrows in a unified system.

### [Permissionless Architecture](https://docs.openintents.xyz/docs#permissionless-architecture)

The framework is designed to be permissionlessly expanded while providing a foundation for more expressive intents that can be composed with OIF deployments.

### [Modular Design](https://docs.openintents.xyz/docs#modular-design)

The protocol is structured around specialized contracts:

*   **InputSettler**: Validates intent fulfillment and releases input assets
*   **OutputSettler**: Enables solvers to deliver output assets
*   **Oracle**: Proof layer for cross-chain validation (messaging protocols, optimistic proofs, storage proofs, etc.)

[Architecture Overview](https://docs.openintents.xyz/docs#architecture-overview)

---------------------------------------------------------------------------------

InputSettlerOracleOutputSettlerSolverAggregatorUserInputSettlerOracleOutputSettlerSolverAggregatorUserRequest quoteQuery solversReturn quoteBest quoteSign & submit intentFill output assetsGenerate proofValidate proofRelease input assets

[Getting Started](https://docs.openintents.xyz/docs#getting-started)

---------------------------------------------------------------------

Choose your integration path:

[### Smart Contracts](https://docs.openintents.xyz/docs/smart-contracts)
[### Solvers](https://docs.openintents.xyz/docs/solvers)
[### Aggregators](https://docs.openintents.xyz/docs/aggregators)
[### Integration Guide](https://docs.openintents.xyz/docs/integration)

[Use Cases](https://docs.openintents.xyz/docs#use-cases)

---------------------------------------------------------

*   **Cross-Chain Swaps**: Exchange assets across different blockchain networks
*   **Gas Sponsorship**: Execute logic with sponsored gas payments
*   **DeFi Composability**: Chain complex operations across multiple chains
*   **New L2 Onboarding**: Provide instant liquidity for emerging Layer 2 networks

[Next Steps](https://docs.openintents.xyz/docs#next-steps)

-----------------------------------------------------------

*   **New to OIF?** Start with the [Smart Contracts Overview](https://docs.openintents.xyz/docs/smart-contracts/overview)
    
*   **Building a Solver?** Check out the [Solver Quickstart](https://docs.openintents.xyz/docs/solvers/quickstart)
    
*   **Integrating OIF?** Read the [Integration Guide](https://docs.openintents.xyz/docs/integration/overview)
    

[Smart Contracts\
\
On-chain contracts for the Open Intents Framework](https://docs.openintents.xyz/docs/smart-contracts)

### On this page

[Open Intents Framework (OIF)](https://docs.openintents.xyz/docs#open-intents-framework-oif)
[What Are Intents?](https://docs.openintents.xyz/docs#what-are-intents)
[Core Components](https://docs.openintents.xyz/docs#core-components)
[How It Works](https://docs.openintents.xyz/docs#how-it-works)
[Key Features](https://docs.openintents.xyz/docs#key-features)
[Output-Input Separation](https://docs.openintents.xyz/docs#output-input-separation)
[Permissionless Architecture](https://docs.openintents.xyz/docs#permissionless-architecture)
[Modular Design](https://docs.openintents.xyz/docs#modular-design)
[Architecture Overview](https://docs.openintents.xyz/docs#architecture-overview)
[Getting Started](https://docs.openintents.xyz/docs#getting-started)
[Use Cases](https://docs.openintents.xyz/docs#use-cases)
[Next Steps](https://docs.openintents.xyz/docs#next-steps)

---