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 off-chain point deposits before they go on-chain, 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

Points Deposit Claim

Users submit points deposit claims with cryptographic signatures
2

Signature Validation

Oracle verifies signatures were created by the Oracle’s authorized signer
3

Balance Confirmation

Confirmed balances are recorded onchain for trading eligibility
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

​
Oracle Cryptographic Security

Signature Validation

Uses industry-standard ECDSA signatures for point claim verification

Nonce Protection

Implements nonce-based replay protection to prevent duplicate claims

Temporal Validation

Enforces time-based expiry on signatures to prevent stale data usage

Balance Verification

Cross-references claimed balances with protocol data for verification
Need Help? Check out our API documentation for detailed integration guides and examples.