Prediction Markets

# Prediction Markets Roadmap

This document lays out the realistic options for turning Potline from a league-and-commerce app into a prediction-markets product.

It is intentionally split into product, technical, and protocol choices because "add betting" is not one feature. It is a stack of:

- market creation
- pricing / odds or pooled-entry rules
- user entry flow
- custody and settlement
- dispute / resolution rules
- compliance and geo controls

## Current Potline Position

What Potline already has:

- Solana wallet onboarding
- stake-gated identity
- on-chain escrow settlement
- jobs, promotions, and sports market metadata
- payout and escrow state sync

What Potline does not yet have as a full prediction-markets product:

- real paid market-entry protocol
- odds / pricing engine
- oracle-grade resolution system
- compliance layer for regulated market access
- market-maker or liquidity model

So the correct question is not "can we add betting?" The correct question is "which market model do we want to become?"

## Option 1: Polymarket Proxy / Aggregation Layer

Summary:

- Potline stays the agent layer
- Polymarket stays the market and settlement layer
- Potline agents discover, rank, comment on, and optionally route users into Polymarket markets

### What this means

Potline would use Polymarket as an external market backend rather than building its own market protocol first.

Use cases:

- agents summarize live Polymarket markets
- agents recommend trades
- agents publish market analysis
- Potline pages deep-link to Polymarket outcomes or mirror market data
- a Potline "proxy agent" could execute or prepare external market actions if that is legally and technically allowed

### Complexity

- Product complexity: medium
- Engineering complexity: medium
- Protocol complexity: low to medium
- Compliance complexity: high

### Pros

- fastest route to a real market surface
- no need to build a market-pricing engine first
- existing liquidity and market inventory already exist externally
- Potline can focus on agent identity, ranking, and signal quality

### Cons

- Potline does not own the core market protocol
- user experience depends on external APIs, rules, and availability
- custody and entry flow are constrained by Polymarket's model
- likely compliance and jurisdiction complexity remains significant
- difficult to make Potline feel like a first-party market if execution happens elsewhere

### Recommendation

Use this only as:

- a discovery and content layer
- a market-intelligence layer
- possibly an execution-routing layer later

Do not treat this as the final Potline protocol if the long-term goal is a Solana-native market product.

## Option 2: Potline Native Pooled-Entry Sports Markets

Summary:

- Potline owns market metadata
- users pay fixed entry amounts into an escrow-backed pool
- the pool resolves into winners / losers / refunds

This is the closest extension of the current Potline system.

### What this means

Instead of a live order book or AMM, markets are:

- fixed-entry contests
- optional multiple-choice outcomes
- pooled prize distribution after lock and resolution

This maps closely to the current `prediction_markets`, `sports_predictions`, `payouts`, and `escrow_settlement` model.

### Complexity

- Product complexity: medium
- Engineering complexity: medium
- Protocol complexity: medium
- Compliance complexity: high

### Pros

- fits current Potline architecture best
- easiest way to make sports markets real using the current escrow primitives
- simpler than building an exchange or AMM
- strong compatibility with agent-ranked submissions and social scoring

### Cons

- not a true Polymarket-style trading market
- no continuous pricing
- weaker liquidity dynamics
- still needs trusted resolution and legal/compliance review

### Recommendation

This is the best first-party market path for Potline if you want a launchable, ownable protocol before attempting a full exchange model.

## Option 3: Potline Native AMM / Order-Book Prediction Market

Summary:

- Potline becomes a true exchange-like prediction market
- users buy and sell outcome exposure continuously
- Potline owns pricing, settlement, and market protocol

### What this means

You would need:

- market maker / AMM logic or order book
- price discovery
- liquidity incentives
- oracle and resolution logic
- trade settlement
- likely a fee router and rewards distributor

### Complexity

- Product complexity: very high
- Engineering complexity: very high
- Protocol complexity: very high
- Compliance complexity: very high

### Pros

- full protocol ownership
- strongest long-term strategic position
- closest to the "Polymarket clone" idea in feature shape

### Cons

- far beyond current Potline scope
- requires multiple new contracts
- requires liquidity strategy
- hardest operational and legal path

### Recommendation

Do not choose this as the first betting implementation. It is a later-stage protocol track.

## Option 4: Hybrid

Summary:

- near-term Potline supports pooled-entry native markets
- Potline also indexes or references external Polymarket markets
- over time Potline can decide whether to remain hybrid or deepen the native market stack

### Recommendation

This is the most practical roadmap if you want:

- short-term signal and content value
- medium-term native market ownership
- flexibility without prematurely committing to a full exchange build

## Should Potline Use Polymarket as a Proxy Agent?

Short answer:

- yes, for discovery/routing/intelligence
- no, as the core long-term market protocol

Using Polymarket as a proxy agent is good if the goal is:

- enrich Potline with real markets quickly
- let agents discuss live external markets
- test agent performance against real-world market data

It is not enough if the goal is:

- own the market protocol
- own custody and settlement
- make Potline the primary venue

## Recommended Potline Roadmap

### Phase 1: Finish Potline Native Fixed-Entry Markets

Build the smallest real market protocol on top of existing escrow and payout rails.

Deliverables:

- prepare entry transaction
- wallet sign/send
- confirm on-chain funding
- sync market pool from chain only
- lock market at cutoff
- resolve outcome
- release payouts or refunds

This should be the first real betting milestone.

### Phase 2: Add External Market Intelligence Layer

Optional but valuable:

- ingest external market data such as Polymarket
- let agents create commentary, rankings, and alerts around those markets
- optionally deep-link out for execution

This gives Potline agent utility without forcing Potline to become a full exchange immediately.

### Phase 3: Decide Long-Term Market Direction

After native pooled markets are working:

- stay pooled-entry and agent-first
- or expand toward more exchange-like market mechanics

That decision should happen only after real user testing.

## Concrete Engineering Options

### A. Native pooled-entry market protocol

Needed work:

- complete `/api/sports/[marketId]/pick` as a fully funded entry path
- require wallet-signed entry transaction
- sync entry pool from chain only
- define payout formula for winners, losers, and voids
- connect scoring to market accuracy and participation

Estimated complexity:

- moderate