Skip to main content

Welcome to Horizon Protocol

Horizon is a decentralized, gamified coordination platform for real-world missions built natively on Base L2. It bridges digital incentives with physical-world tasks through blockchain-backed escrow, location verification, and guild-based coordination.

Built on Base​

Horizon leverages the Coinbase/Base ecosystem:

  • Base L2 - Low-cost, fast EVM transactions
  • USDC - Native stablecoin for mission payments
  • Basenames - .base.eth identity integration
  • EAS - On-chain reputation attestations
  • CDP Paymaster - Gasless operations for ratings & achievements
  • OnchainKit + MiniKit - Coinbase Wallet Mini App
  • Talent Protocol - Builder Score XP multipliers

Horizon Mini App​

A lightweight companion app that runs inside Coinbase Wallet and Farcaster clients:

  • πŸ” Discover - Browse missions without leaving the wallet
  • ⚑ Quick Claim - Gasless mission claims with one tap
  • πŸ† Track Progress - View XP, achievements, and guild memberships
  • πŸ“± Full App Link - Seamless handoff for GPS-verified missions

Learn more about the Mini App β†’

What is Horizon?​

Horizon Protocol enables:

  • Mission Posting & Execution: Post tasks with escrowed rewards, accept missions based on location
  • Guild Coordination: Form teams, curate mission boards, share reputation
  • On-chain Escrow: Secure USDC payments with automated settlement
  • Location Verification: Geofenced missions with privacy-preserving location proofs
  • XP & NFT Rewards: Level up, earn achievements, collect tradable items

πŸš€ Getting Started

Set up your development environment and integrate with Horizon.

πŸ“– Protocol Overview

Understand how Horizon's mission engine, guilds, and economics work.

πŸ”§ Smart Contracts

Explore the on-chain architecture: MissionEscrow, PaymentRouter, GuildDAO.

πŸ—ΊοΈ API Reference

Complete API documentation for missions, guilds, map, and WebSocket.

Core Concepts​

Mission Lifecycle​

  1. Poster creates mission β†’ Funds deposited in escrow
  2. Performer accepts mission β†’ Begins execution
  3. Performer submits proof β†’ Photos, signatures, etc.
  4. Poster approves β†’ Escrow settles, funds distributed
  5. Or dispute raised β†’ DDR/LPP resolution process

How It Works​

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ User Interface β”‚
β”‚ Mobile App Β· Web App β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
β”‚
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Horizon API β”‚
β”‚ REST Endpoints Β· WebSocket Β· Authentication β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
β”‚
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Base L2 Blockchain β”‚
β”‚ MissionFactory Β· MissionEscrow Β· PaymentRouter Β· GuildDAO β”‚
β”‚ ReputationAttestations Β· DisputeResolver β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Deployments​

Testnet (Base Sepolia)​

ContractAddress
MissionFactory0xee9234954b134c39c17a75482da78e46b16f466c
PaymentRouter0x94fb7908257ec36f701d2605b51eefed4326ddf5
GuildFactory0xfeae3538a4a1801e47b6d16104aa8586edb55f00
ReputationAttestations0xedae9682a0fb6fb3c18d6865461f67db7d748002
DisputeResolver0xb00ac4278129928aecc72541b0bcd69d94c1691e
HorizonAchievements0x568e0e3102bfa1f4045d3f62559c0f9823b469bc
USDC (testnet)0x036CbD53842c5426634e7929541eC2318f3dCF7e

Open Source​

Horizon Protocol is open source and available on GitHub:

Contributing​

We welcome contributions! See our repositories for details on how to get started.