Skip to main content

Overview

The UMA CTF Adapter is a smart contract infrastructure that enables Polymarket prediction markets to be resolved through UMA’s Optimistic Oracle. It serves as an oracle bridge between the Conditional Tokens Framework (CTF) and UMA’s decentralized resolution mechanism.

Architecture

Understand how the adapter integrates CTF with UMA

Quickstart

Deploy and initialize your first market

API Reference

Explore the complete contract API

Operations

Learn about admin controls and monitoring

Key Features

Leverages UMA’s Optimistic Oracle for decentralized, economically-secured market resolution with configurable rewards and bonds.
When a resolution is disputed for the first time, the market automatically resets with a new Optimistic Oracle request to prevent obviously incorrect disputes from slowing down resolution.
Admins can flag markets for manual resolution with a 1-hour safety period, providing a fallback mechanism for edge cases.
Configure reward amounts, proposal bonds, and liveness periods per market to properly incentivize proposers based on market value.
Security-audited by OpenZeppelin to ensure contract safety and reliability.

How It Works

1

Initialize Market

A market creator calls initialize() with the question data, reward token, reward amount, proposal bond, and liveness period. This prepares the condition on CTF and requests resolution data from UMA’s Optimistic Oracle.
2

Proposer Response

UMA proposers fetch resolution data off-chain and submit proposals on-chain. If not disputed, the data becomes available after the liveness period (typically 2 hours).
3

Dispute Handling

If disputed once, the market automatically resets with a new request. If disputed again, UMA’s DVM (Data Verification Mechanism) arbitrates over 48-72 hours.
4

Resolve Market

Once resolution data is available, anyone can call resolve() to finalize the market using the Optimistic Oracle’s result.

Use Cases

The UMA CTF Adapter is designed for:
  • Prediction Markets: Resolve binary and multi-outcome prediction markets on Polymarket
  • Conditional Tokens: Any application using the Conditional Tokens Framework that needs decentralized oracle resolution
  • DeFi Protocols: Insurance, derivatives, and other DeFi products requiring trustless event resolution

Next Steps

Learn the Architecture

Deep dive into contract design and data flow

Deploy the Adapter

Set up and configure your own deployment

Build docs developers (and LLMs) love