Hashprice Oracle

On-chain oracle for Bitcoin hashprice data, providing real-time hashrate-to-token conversion rates for the Lumerin protocol.

Overview

This repository contains:

• Smart Contracts (/contracts) - Solidity contracts for the HashrateOracle, which calculates the number of hashes required to mine BTC equivalent to a given token amount
• Oracle Updater (/oracle-update) - AWS Lambda function that fetches Bitcoin network data and updates the on-chain oracle
• Subgraph Indexer (/indexer) - A Graph Protocol subgraph that indexes oracle updates and provides historical hashprice data with hourly/daily aggregations

Contracts

The HashrateOracle contract:

• Integrates with Chainlink price feeds for BTC/token pricing
• Stores and updates hashesForBTC (hashes required to mine 1 satoshi)
• Calculates hashesForToken based on current BTC price
• Uses UUPS upgradeable proxy pattern
• Supports authorized updater addresses for oracle data

Key Functions

Function	Description
setHashesForBTC(uint256)	Update the hashes-per-satoshi value
getHashesForBTCV2()	Get current hashesForBTC with timestamp
getHashesForTokenV2()	Get hashes per token unit with timestamp

Oracle Updater

The oracle-update service is an AWS Lambda function that keeps the on-chain oracle up to date:

• Fetches latest Bitcoin block data (difficulty, block reward, transaction fees)
• Calculates hashesForBTC using a 144-block Simple Moving Average (SMA)
• Submits on-chain updates only when values change
• Runs on a 5-minute schedule
• Caches block data in AWS SSM Parameter Store for efficiency

Data Sources

• Bitcoin RPC - Block headers, difficulty, and fee data
• Coingecko - BTC/USD exchange rate (for dev environments)

Quick Start

Contracts

cd contracts
yarn install
yarn test
yarn compile

Oracle Updater

cd oracle-update
yarn install
# Configure .env with RPC URLs and keys
yarn dev      # Run locally
yarn build    # Build Lambda zip

Indexer

cd indexer
yarn install
# Configure .env from .env.example
yarn codegen
yarn build

License

MIT