Stop Building Oracle Infrastructure. Start Shipping Features.

Join developers who ship oracle integrations in hours, not weeks. Three smart contract primitives that handle all your on-chain/off-chain integration needs.

Start Building in 5 Minutes View on GitHub

Smart Contract Primitives

5min

Setup Time

25+

Monitoring Metrics

Three Smart Contract Primitives

With these building blocks, you can build any blockchain solution needing on-chain and off-chain integration.

Datafeed

Datafeed Primitive

Bring any data from off-chain APIs to the blockchain. Point Omikuji at your API, tell it what contract function to call, and configure how often you want updates.

Price feeds:ETH/USD from CoinGecko to your DeFi protocol
Weather data:Temperature API to parametric insurance
Sports results:ESPN API to prediction markets
Asset prices:Real estate APIs to tokenized properties
Exchange rates:FX APIs to cross-border payments

Scheduled

Schedule-Based Triggers

Blockchains can't call smart contracts themselves - you need an external trigger. Omikuji is that trigger, controlled by your schedule and on-chain rules.

Yield harvesting:Call harvest() every 24 hours
Rebalancing:Trigger portfolio rebalance weekly
Subscription billing:Charge users monthly via cron
Governance execution:Execute passed proposals after timelock
Liquidations:Check undercollateralized positions hourly

Off-Chain

Off-Chain Compute

Smart contracts have limits on data processing. Omikuji monitors your contract events and calls your off-chain APIs - and when they're done, your APIs can call back to update contracts.

Complex calculations:ML models for risk scoring
External validation:KYC/AML checks via third-party APIs
Batch processing:Aggregate multiple transactions off-chain
Web2 integrations:Email notifications, database updates
Cross-chain messaging:Bridge events between networks

Production-Ready Infrastructure Features Included

Everything you need for enterprise-grade oracle deployments

EIP-1559 Gas Optimization

20-40% gas savings with intelligent fee bumping. Monitor and manage gas expenditure.

Prometheus Metrics

25+ metrics for monitoring oracle health

Enterprise Key Management

Store your private keys in OS keyrings, Hashicorp Vault, or AWS Secrets Manager

Multi-Chain Support

Ethereum, BASE, Polygon, any EVM network

Smart Contract Integration Examples

See how the three primitives solve real smart contract challenges

DeFi Lending Protocol

Datafeed

Contract needs:

function updatePrice(uint256 _price)

Configuration:

ETH/USD from CoinGecko to updatePrice() every 0.5% deviation

Result:

Real-time price feeds without building oracle infrastructure. Ships in 1 hour vs 3 weeks.

Yield Optimization Vault

Scheduled

Contract needs:

function harvest() external onlyKeeper

Configuration:

Call harvest() daily at 2 AM GMT + check if gas < 50 gwei

Result:

Automated yield compounding with gas optimization. Zero manual intervention.

NFT Marketplace

Off-Chain

Contract needs:

event ListingCreated(uint256 tokenId, address seller)

Configuration:

Call image analysis API and then updateMetadata(tokenId, rarity)

Result:

Complex ML processing off-chain with automatic on-chain updates.

Prediction Market

Datafeed

Contract needs:

function resolveMarket(uint256 marketId, bool outcome)

Configuration:

Sports API to resolveMarket() when game ends

Result:

Instant market resolution without manual oracle management.

DAO Governance

Scheduled

Contract needs:

function executeProposal(uint256 proposalId)

Configuration:

Check if proposal.endTime < now && proposal.passed then execute

Result:

Automatic governance execution with on-chain rule validation.

Insurance Claims

Off-Chain

Contract needs:

event ClaimSubmitted(uint256 claimId, string flightNumber)

Configuration:

Check FlightAware API then approveClaim(claimId, payout)

Result:

Parametric insurance with external data validation and automatic payouts.

These are just examples - build any integration you can imagine

Three Primitives, One Configuration File

Real configuration showing all three smart contract primitives working together

config.yaml

# 1. DATAFEED PRIMITIVE - Bring off-chain data on-chain
datafeeds:
- name: eth_price_feed
  networks: ethereum-mainnet
  contract_address: 0x123...abc # Your DeFi contract
  function_name: updatePrice # function updatePrice(uint256)
  check_frequency: 30 # Check every 30 seconds
  deviation_threshold_pct: 0.5 # Update on 0.5% change
  feed_url: https://api.coingecko.com/api/v3/simple/price?ids=ethereum&vs_currencies=usd
  feed_json_path: ethereum.usd

# 2. SCHEDULE-BASED TRIGGERS - External automation for your contracts
scheduled_tasks:
- name: daily_harvest
  networks: ethereum-mainnet
  contract_address: 0x456...def # Your yield farming contract
  function_name: harvest # function harvest() external
  schedule: "0 2 * * *" # Daily at 2 AM GMT
  conditions:
  - gas_price_max: 50 # Only if gas < 50 gwei

# 3. OFF-CHAIN COMPUTE - Monitor events, call APIs, update contracts
event_monitors:
- name: process_deposits
  networks: ethereum-mainnet
  contract_address: 0x789...ghi # Your main contract
  event_name: DepositReceived # event DepositReceived(address user, uint256 amount)
  webhook_url: https://your-api.com/process-deposit
  response_handler:
    function_name: confirmDeposit # function confirmDeposit(address user, bool approved)

Result

Complete smart contract automation - price feeds, scheduled execution, and off-chain processing with automatic callbacks. All three primitives working together with production-grade monitoring and gas optimization.

Choose Your Edition

Start with open source for development, scale to decentralized Pro for mainnet

Free and Open Source

Omikuji

Perfect for development, testing, and single-node production deployments

All 3 smart contract primitives
EIP-1559 gas management and optimization
25+ Prometheus metrics
Single binary download and install
YAML configuration
Multi-chain support
MIT License

Download Free

Coming Soon

Omikuji Pro

Decentralized oracle clusters for mainnet production deployments

Everything in Omikuji +
Multi-node operator clusters
Gossip protocol for decentralization
Gas cost optimization via node elections
Maximum uptime through redundancy
Truthful, reliable, dependable data
Commercial licensing and support

USD 2000 / year

Seamless Development-to-Production Pipeline

Development and Testing: Use free Omikuji to build and validate your oracle integrations

Mainnet Launch: Deploy multiple Omikuji Pro nodes operated by different parties for true decentralization

Same Configuration: Your YAML configs work seamlessly across both editions

Ship Your Oracle in 5 Minutes

From zero to production oracle with built-in monitoring and cost optimization

Download and Install

Get the latest binary and make it executable

wget https://github.com/ijonas/omikuji/releases/latest/download/omikuji-linux-x64

chmod +x omikuji-linux-x64

sudo mv omikuji-linux-x64 /usr/local/bin/omikuji

Configure Your Oracle

Create config.yaml with your network, contract address, and data source URL. Omikuji automatically reads contract configuration and optimizes gas settings.

Import Private Key

Secure storage using OS keyring, Vault, or AWS Secrets Manager.

omikuji key import --network ethereum-mainnet

Launch and Monitor

View metrics at http://localhost:9090/metrics - full Prometheus integration included.

omikuji --config config.yaml

Start Building Now Read Full Documentation

No dependencies, no complex setup required.