Skip to main content
Checkpoint Oracle title image, light theme Checkpoint Oracle title image, dark theme

Checkpoint Oracle

The Points Oracle is Checkpoint’s verification layer. It fetches points data from offchain sources and signs it with cryptographic signatures, making the data verifiable onchain. The Oracle is a core component of Checkpoint and is responsible for writing points data to the blockchain, verifying claims and settlement among other things.

Checkpoint NFT

Checkpoint Points receipt

Oracle Systems

Checkpoint verification layer

Oracle Functionalities

The Oracle serves two major functions: verifying offchain point deposits before they go onchain, and confirming settlement claims when protocols TGE. Fundamentally, these translate to various programmatic features:

Signature Verification

Checks account-owner authorization and signs verified points balances

Tracks Points Changes

Reviews balance changes before updating supported points programs onchain

Settlement Verification

Confirms that offers were settled correctly on-chain, on supported chains

Vesting Status

Provides vesting status checks and claimable amount calculations for settlement

Deposit Reviews

A first deposit can be available immediately, partially available, or placed under review, depending on the program’s account limit and shared capacity. Delayed deposits need matching observations, a review period, and a fresh balance check. Follow the reported deposit status for progress; scans, backlogs, or pauses can extend the wait. You can follow progress without signing repeatedly. When a deposit is ready, authorize it again and submit the short-lived claim. If you already deposited the available portion, the oracle reviews and updates the remainder automatically. Unusual balance changes or source outages can pause oracle updates while they are checked.

Oracle Process Breakdown

The Oracle components can be further viewed more granularly by examining the Oracle’s workflow
1

Signature Verification

1

Deposit Authorization

Users request a short-lived authorization payload and sign it as the underlying points account owner
2

Oracle Claim Generation

The Oracle verifies that authorization, fetches the latest points balance, and signs the deposit claim, subject to capacity limits and review
3

Onchain Deposit

The operator submits the Oracle-signed claim onchain so the confirmed balance becomes tradable
After verification, users should receive a Soulbound Checkpoint NFT
2

Balance Monitoring

1

Automatic Points Balance Change

The oracle checks supported programs periodically for points balance changes
2

Balance Confirmation

Matching observations and a review period are required before balance updates are released
Balance change can trigger a Shortfall Event, enabling buyers to cancel offers within a time frame
3

Settlement

1

Settlement Activation

Triggers settlement processes when protocols TGE
2

Balance Reconciliation

Reconciles final token distributions with traded point amounts to ensure accurate settlement
3

Crosschain Verification

Coordinates token distribution across multiple chains using LayerZero infrastructure
Need Help? Check out our API documentation for detailed integration guides and examples.