Welcome to the Histori RPC Router repository.
The Histori RPC Router is a robust service designed to provide access to blockchain data across multiple networks. With features like unified multi-network support, secure transaction submission via Flashbots integration, fallback RPC calls on failure and verification of RPC calls from multiple providers, it simplifies the development of decentralized applications while ensuring data integrity and security. The service includes advanced capabilities such as parallel requests for consistency verification, automatic fallback mechanisms for high availability, and random provider selection for load balancing and rate limit safety, making it ideal for high-traffic applications like DeFi platforms and NFT marketplaces. Whether you need reliable access to historical blockchain states or protection against MEV attacks, Histori RPC Router delivers performance, reliability, and peace of mind.
- Node.js: Version 16 or higher
- npm: Installed with Node.js
- Compatible browser for viewing the documentation.
Follow these steps to set up the project locally:
- Install dependencies:
npm install- Ensure your environment variables are properly configured in a .env file or set in your shell.
The networks.json file is where you configure network-specific details for accessing blockchain data through the Histori RPC Router. This includes RPC URLs and network IDs. You can fill this configuration with custom RPC URLs or use Histori’s multi-RPC service for seamless integration.
-
Understand the Fields:
networkId: A unique identifier for the network (e.g.,eth-mainnet).rpc: List of RPC URLs for the network.
-
Option 1: Using Custom RPC URLs:
- Replace the
<YOUR_HISTORI_PROJECT_ID_HERE>placeholder in therpc.urlwith your preferred RPC URL. - Example:
{ "url": "https://custom-node.example.com/eth-mainnet" }
- Replace the
-
Option 2: Using Histori Multi-RPC Service:
- Histori provides a multi-RPC service with optimized performance and reliability. Follow these steps to obtain your
projectId:
- Histori provides a multi-RPC service with optimized performance and reliability. Follow these steps to obtain your
-
Visit the Histori Dashboard:
- Go to the Histori Dashboard and log in or sign up for an account.
-
Create a Project:
- Navigate to the Projects section and click Create New Project.
- Fill in your project details and save.
-
Get Your
projectId:- Once your project is created, you’ll see a unique
projectIdassociated with it. - Example:
abc123xyz456
- Once your project is created, you’ll see a unique
-
Update
networks.json:- Replace
<YOUR_HISTORI_PROJECT_ID_HERE>in the RPC URLs with yourprojectId. - Example:
{ "url": "https://node.histori.xyz/eth-mainnet?projectId=abc123xyz456" }
- Replace
[
{
"networkId": "eth-mainnet",
"rpc": [
{
"url": "https://node.histori.xyz/eth-mainnet?projectId=abc123xyz456"
}
],
},
{
"networkId": "eth-sepolia",
"rpc": [
{
"url": "https://node.histori.xyz/eth-sepolia?projectId=abc123xyz456"
}
],
}
]We welcome contributions to improve the Histori RPC router. To contribute:
- Fork this repository.
- Make your changes.
- Submit a pull request with a detailed description of your updates.
Please ensure that any edits maintain clarity and follow the existing structure.
For any issues or questions, reach out to us:
- Email: support@histori.xyz
- Website: histori.xyz
- API Documentation: docs.histori.xyz
- Telegram: Join
⭐️ From the Histori Team – Your gateway to blockchain insights.