ar.ioar.io Documentation

Observation & Incentive Protocol

Overview

The Observation and Incentive Protocol (OIP) pays gateways for serving data well. Gateways check on each other: each epoch (24 hours on mainnet), up to 50 gateways are chosen as observers and test every gateway. Gateways that pass earn ARIO. Gateways that fail earn no gateway reward for that epoch, and a gateway that fails 30 epochs in a row can be pruned.

How an epoch works

No central server runs the protocol or sends notifications. Crankers, which can be any wallet with SOL, move each epoch forward. Each observer reads the current epoch on Solana to learn whether it was chosen and which names to test.

Observers test every gateway, and the protocol pays the gateways that most observers passed

Observers pay SOL to submit their results, so an observer wallet needs SOL. Every report stays on Arweave, and you can browse current observers and results at gateways.ar.io. ArNS name fees and other protocol fees fund the protocol balance that pays the rewards. For the transactions behind each step, see Epoch pipeline.

What observers check

Observers test whether each gateway can:

  • Resolve ArNS names to the same transaction ID, cache time (TTL), and content type that reference gateways return
  • Return the same data, compared by its hash
  • Serve Arweave data by its position on the chain (its offset), with proof that it matches the chain

Observers can change how they test without a change to the protocol.

Explore the protocol

How is this guide?