Skip to main content
Checkpoint Oracle title image, light 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

Validates cryptographic signatures from protocols to verify point claims

Tracks Points Changes

Keeps your point balances updated automatically across all supported protocols

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

​
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
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

Real-time Monitoring

1

Automatic Points Balance Change

Point balance changes across protocols automatically
2

Balance Confirmation

Crosschain settlement requirements
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.