Overview
Connect is Neutron’s price oracle service that fetches market prices from various providers and makes them available to the Neutron blockchain. Connect is forked from Skip-mev’s Connect oracle and maintained by the Neutron team at neutron-org/connect. Running Connect properly ensures that your validator contributes accurate price data to the network, which is essential for:- Meeting validator performance thresholds
- Enabling DeFi applications that require accurate price feeds
- Supporting financial operations on the network
Oracle price update reliability is one of the key performance metrics for Neutron validators. You must maintain at least 95% success rate for oracle price updates to receive rewards.
Installation Options
- Pre-built Binary
- Build from Source
Download the latest stable version of Connect:
Configuration
You can configure Connect using one of the following methods:- Method 1: SystemD Service
- Method 2: Configuration File
Create a systemd service file to manage the Connect service:Add the following content:
Replace
$USER
with your actual username and adjust the path to the Connect binary as needed. The --market-map-endpoint
should point to your node’s gRPC port.Configure Neutron Node
Edit the Neutron node’sapp.toml
file to enable the oracle:
[oracle]
section and update it:
Make sure to use lowercase
true
for boolean values, not capitalized True
. Also ensure gRPC is enabled in your app.toml
.Starting the Service
Enable and start the Connect service:Verification
Verify that your Connect oracle is working correctly:1
Check Connect Logs
2
Check Oracle Metrics
Success
values increasing, your setup is working correctly.Troubleshooting
Missing Prices
Missing Prices
If you see log entries like:This is normal and can be ignored. It indicates that some price feeds are temporarily unavailable from providers.
WebSocket Errors
WebSocket Errors
If you see errors like:These are typically transient connection issues with price providers and can be ignored as long as your oracle responses show successful metrics.
Configuration Issues
Configuration Issues
Common configuration issues include:
- Make sure the
market-map-endpoint
in your configuration points to the correct gRPC port of your Neutron node. - Ensure all boolean values in
app.toml
use lowercasetrue
not capitalizedTrue
. - Verify that your Neutron node’s gRPC service is enabled and running.
Monitoring
Set up monitoring for your oracle service to ensure it maintains the required performance thresholds:This simple script checks the success rate of your oracle responses. You can expand it to send alerts via Telegram, Discord, or email when the success rate falls below the threshold.
Best Practices
- Regular Updates: Keep your Connect binary updated to the latest version from neutron-org/connect
- Network Configuration: Ensure proper firewall rules to allow Connect to access external price providers
- Log Rotation: Configure log rotation for Connect logs to prevent disk space issues
- Monitoring: Set up comprehensive monitoring for oracle performance with alerting