Running the Price feeder
How to run your own Oracle and price feeder
The Price Feeder is an essential component for validators added to Kiichain since version v4.0.0 to provide accurate cryptocurrency price data to the Kiichain network using the Oracle module. Follow these steps to set it up:
Prerequisites
A running Kiichain validator node
At least
100000000ukii
in your validator account for feeder delegation
Installation Steps
Download the Setup Script
Edit Configuration Variables
Open the script and modify these values at the top:
Run the Installation
The script will automatically:
Build and install the price-feeder
Create a dedicated feeder account
Delegate price reporting rights
Fund the feeder account
Configure the systemd service
Verify Operation
Check the service logs:
Look for the following log with the success voting and broadcast process, should look as this example.
Important Note: Oracle Voting Performance Requirements
Validators running the Price Feeder must maintain a high success rate when submitting price votes. The Oracle module enforces this through a slashing mechanism:
MinValidPerWindow
Parameter: This governance-defined threshold (5%) sets the minimum percentage of successful votes a validator must submit per voting window (3600 blocks).Penalty for Underperformance: If a validator’s ratio of successful votes / total votes falls below
MinValidPerWindow
:The validator is automatically jailed
It cannot participate in consensus or earn staking rewards
Manual unjailing requires a governance proposal or fixed downtime duration
Recommendations for Validators:
Monitor your feeder’s logs (
journalctl -fu price_feeder.service
)Ensure stable API connections to price providers
Maintain sufficient gas fees for timely transactions
If you are using os as KEYRING_BACKEND
make sure you have set the env variable PRICE_FEEDER_PASS
with your keyring password. If not, the script run_price_feeder.sh will ask you to type your keyring password using the CLI.
Current exchange rates fetched by the price feeder and handled by the Oracle module
These are the prices stored on the blockchain (represented in USD).
$BTC
$ETC
$SOL
$XRP
$BNB
$USDT
$USDC
References
Last updated