# polymarket/polymarket-v2-external architecture

> Architecture diagram of the GitHub repository polymarket/polymarket-v2-external, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/polymarket/polymarket-v2-external
- Repository: https://github.com/polymarket/polymarket-v2-external

## Overview

Polymarket V2 is a smart-contract prediction-market system. Its documented capabilities cover collateral conversion, position-token management, order matching, oracle-based market resolution, and cross-chain bridging. The README describes position IDs as encoding module routing and condition/outcome identity. No source excerpts were provided, so the graph shows only these documented capabilities and avoids asserting contract-to-contract calls or a specific execution sequence.

Main entry points: [`src/oracle/OracleAggregator.sol`](https://github.com/polymarket/polymarket-v2-external/blob/main/src/oracle/OracleAggregator.sol) (Oracle aggregator), [`src/libraries/Ids.sol`](https://github.com/polymarket/polymarket-v2-external/blob/main/src/libraries/Ids.sol) (Position IDs), [`src/routers/Router.sol`](https://github.com/polymarket/polymarket-v2-external/blob/main/src/routers/Router.sol) (Router), [`src/routers/BridgeRouter.sol`](https://github.com/polymarket/polymarket-v2-external/blob/main/src/routers/BridgeRouter.sol) (Bridge router)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_market["Market positions"]
  node_router["Router<br/>[Router.sol]"]
  node_position_ids["Position IDs<br/>[Ids.sol]"]
  node_position_manager["Position manager"]
  node_binary["Binary markets<br/>[BinaryModule.sol]"]
  node_combinatorial["Combinatorial markets"]
  node_negrisk["Neg-risk markets<br/>[NegRiskModule.sol]"]
  node_auto_redeemer["Auto redeemer<br/>[AutoRedeemer.sol]"]
end

subgraph group_trading["Trading and collateral"]
  node_exchange["Order matching<br/>[Exchange.sol]"]
  node_collateral_token["Collateral token"]
  node_onramp["Collateral onramp"]
  node_offramp["Collateral offramp"]
end

subgraph group_resolution["Oracle resolution"]
  node_oracle["Oracle aggregator"]
  node_oo_reporter["OO reporter"]
  node_chainlink_reporter["Chainlink reporter"]
  node_eoa_reporter["EOA reporter"]
end

subgraph group_crosschain["Cross-chain"]
  node_bridge_router["Bridge router<br/>[BridgeRouter.sol]"]
  node_bridge["CCIP bridge<br/>[CcipBridge.sol]"]
end

node_user(("User"))

node_user -.->|"uses"| node_router
node_user -.->|"places orders"| node_exchange
node_router -.->|"manages positions"| node_position_manager
node_position_ids -->|"encodes routing"| node_binary
node_position_ids -->|"encodes routing"| node_combinatorial
node_position_ids -->|"encodes routing"| node_negrisk
node_user -.->|"wraps collateral"| node_onramp
node_user -.->|"unwraps collateral"| node_offramp
node_user -.->|"resolves markets"| node_oracle
node_oracle -.->|"uses reporters"| node_oo_reporter
node_oracle -.->|"uses reporters"| node_chainlink_reporter
node_oracle -.->|"uses reporters"| node_eoa_reporter
node_user -.->|"bridges positions"| node_bridge_router
node_bridge_router -.->|"routes bridging"| node_bridge

click node_router "https://github.com/polymarket/polymarket-v2-external/blob/main/src/routers/Router.sol"
click node_position_ids "https://github.com/polymarket/polymarket-v2-external/blob/main/src/libraries/Ids.sol"
click node_position_manager "https://github.com/polymarket/polymarket-v2-external/blob/main/src/positionManager/PositionManager.sol"
click node_binary "https://github.com/polymarket/polymarket-v2-external/blob/main/src/modules/BinaryModule.sol"
click node_combinatorial "https://github.com/polymarket/polymarket-v2-external/blob/main/src/modules/CombinatorialModule.sol"
click node_negrisk "https://github.com/polymarket/polymarket-v2-external/blob/main/src/modules/NegRiskModule.sol"
click node_exchange "https://github.com/polymarket/polymarket-v2-external/blob/main/src/exchange/Exchange.sol"
click node_collateral_token "https://github.com/polymarket/polymarket-v2-external/blob/main/src/collateral/CollateralToken.sol"
click node_onramp "https://github.com/polymarket/polymarket-v2-external/blob/main/src/collateral/CollateralOnramp.sol"
click node_offramp "https://github.com/polymarket/polymarket-v2-external/blob/main/src/collateral/CollateralOfframp.sol"
click node_oracle "https://github.com/polymarket/polymarket-v2-external/blob/main/src/oracle/OracleAggregator.sol"
click node_oo_reporter "https://github.com/polymarket/polymarket-v2-external/blob/main/src/oracle/modules/OOReporterModule.sol"
click node_chainlink_reporter "https://github.com/polymarket/polymarket-v2-external/blob/main/src/oracle/modules/reporters/ChainlinkReporterModule.sol"
click node_eoa_reporter "https://github.com/polymarket/polymarket-v2-external/blob/main/src/oracle/modules/reporters/EOAReporterModule.sol"
click node_bridge_router "https://github.com/polymarket/polymarket-v2-external/blob/main/src/routers/BridgeRouter.sol"
click node_bridge "https://github.com/polymarket/polymarket-v2-external/blob/main/src/bridge/CcipBridge.sol"
click node_auto_redeemer "https://github.com/polymarket/polymarket-v2-external/blob/main/src/utils/AutoRedeemer.sol"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_router,node_position_ids,node_position_manager,node_binary,node_combinatorial,node_negrisk,node_auto_redeemer,node_user toneBlue
class node_exchange,node_collateral_token,node_onramp,node_offramp toneAmber
class node_oracle,node_oo_reporter,node_chainlink_reporter,node_eoa_reporter toneMint
class node_bridge_router,node_bridge toneRose
```

## Components

### Market positions

- [Router](https://github.com/polymarket/polymarket-v2-external/blob/main/src/routers/Router.sol): `src/routers/Router.sol`
- [Position IDs](https://github.com/polymarket/polymarket-v2-external/blob/main/src/libraries/Ids.sol): `src/libraries/Ids.sol`
- [Position manager](https://github.com/polymarket/polymarket-v2-external/blob/main/src/positionManager/PositionManager.sol): `src/positionManager/PositionManager.sol`
- [Binary markets](https://github.com/polymarket/polymarket-v2-external/blob/main/src/modules/BinaryModule.sol): `src/modules/BinaryModule.sol`
- [Combinatorial markets](https://github.com/polymarket/polymarket-v2-external/blob/main/src/modules/CombinatorialModule.sol): `src/modules/CombinatorialModule.sol`
- [Neg-risk markets](https://github.com/polymarket/polymarket-v2-external/blob/main/src/modules/NegRiskModule.sol): `src/modules/NegRiskModule.sol`
- [Auto redeemer](https://github.com/polymarket/polymarket-v2-external/blob/main/src/utils/AutoRedeemer.sol): `src/utils/AutoRedeemer.sol`

### Trading and collateral

- [Order matching](https://github.com/polymarket/polymarket-v2-external/blob/main/src/exchange/Exchange.sol): `src/exchange/Exchange.sol`
- [Collateral token](https://github.com/polymarket/polymarket-v2-external/blob/main/src/collateral/CollateralToken.sol): `src/collateral/CollateralToken.sol`
- [Collateral onramp](https://github.com/polymarket/polymarket-v2-external/blob/main/src/collateral/CollateralOnramp.sol): `src/collateral/CollateralOnramp.sol`
- [Collateral offramp](https://github.com/polymarket/polymarket-v2-external/blob/main/src/collateral/CollateralOfframp.sol): `src/collateral/CollateralOfframp.sol`

### Oracle resolution

- [Oracle aggregator](https://github.com/polymarket/polymarket-v2-external/blob/main/src/oracle/OracleAggregator.sol): `src/oracle/OracleAggregator.sol`
- [OO reporter](https://github.com/polymarket/polymarket-v2-external/blob/main/src/oracle/modules/OOReporterModule.sol): `src/oracle/modules/OOReporterModule.sol`
- [Chainlink reporter](https://github.com/polymarket/polymarket-v2-external/blob/main/src/oracle/modules/reporters/ChainlinkReporterModule.sol): `src/oracle/modules/reporters/ChainlinkReporterModule.sol`
- [EOA reporter](https://github.com/polymarket/polymarket-v2-external/blob/main/src/oracle/modules/reporters/EOAReporterModule.sol): `src/oracle/modules/reporters/EOAReporterModule.sol`

### Cross-chain

- [Bridge router](https://github.com/polymarket/polymarket-v2-external/blob/main/src/routers/BridgeRouter.sol): `src/routers/BridgeRouter.sol`
- [CCIP bridge](https://github.com/polymarket/polymarket-v2-external/blob/main/src/bridge/CcipBridge.sol): `src/bridge/CcipBridge.sol`

### Other components

- **User**

## Connections

- User → Router: uses
- User → Order matching: places orders
- Router → Position manager: manages positions
- Position IDs → Binary markets: encodes routing (evidence: `README.md`)
- Position IDs → Combinatorial markets: encodes routing (evidence: `README.md`)
- Position IDs → Neg-risk markets: encodes routing (evidence: `README.md`)
- User → Collateral onramp: wraps collateral
- User → Collateral offramp: unwraps collateral
- User → Oracle aggregator: resolves markets
- Oracle aggregator → OO reporter: uses reporters
- Oracle aggregator → Chainlink reporter: uses reporters
- Oracle aggregator → EOA reporter: uses reporters
- User → Bridge router: bridges positions
- Bridge router → CCIP bridge: routes bridging
