[hermes] Rename from price service and add README. (#705)
* pyth-node: rename from price service and document * pyth_node: Add visual architecture to README.
This commit is contained in:
Reisen
GitHub
parent
a9f5cfcced
commit
3f56b3064d
|
|
@ -1453,6 +1453,38 @@ version = "0.4.1"
|
||||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||||
checksum = "95505c38b4572b2d910cecb0281560f54b440a19336cbbcb27bf6ce6adc6f5a8"
|
checksum = "95505c38b4572b2d910cecb0281560f54b440a19336cbbcb27bf6ce6adc6f5a8"
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "hermes"
|
||||||
|
version = "0.1.0"
|
||||||
|
dependencies = [
|
||||||
|
"anyhow",
|
||||||
|
"axum",
|
||||||
|
"axum-macros",
|
||||||
|
"bs58",
|
||||||
|
"dashmap",
|
||||||
|
"der 0.7.0",
|
||||||
|
"env_logger",
|
||||||
|
"futures",
|
||||||
|
"hex",
|
||||||
|
"lazy_static",
|
||||||
|
"libc",
|
||||||
|
"libp2p",
|
||||||
|
"log",
|
||||||
|
"rand 0.8.5",
|
||||||
|
"reqwest",
|
||||||
|
"ring",
|
||||||
|
"rusqlite",
|
||||||
|
"secp256k1",
|
||||||
|
"serde",
|
||||||
|
"serde_arrays",
|
||||||
|
"serde_cbor",
|
||||||
|
"serde_json",
|
||||||
|
"sha256",
|
||||||
|
"structopt",
|
||||||
|
"tokio",
|
||||||
|
"typescript-type-def",
|
||||||
|
]
|
||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "hermit-abi"
|
name = "hermit-abi"
|
||||||
version = "0.1.19"
|
version = "0.1.19"
|
||||||
|
|
@ -2940,38 +2972,6 @@ dependencies = [
|
||||||
"syn",
|
"syn",
|
||||||
]
|
]
|
||||||
|
|
||||||
[[package]]
|
|
||||||
name = "price-service"
|
|
||||||
version = "0.1.0"
|
|
||||||
dependencies = [
|
|
||||||
"anyhow",
|
|
||||||
"axum",
|
|
||||||
"axum-macros",
|
|
||||||
"bs58",
|
|
||||||
"dashmap",
|
|
||||||
"der 0.7.0",
|
|
||||||
"env_logger",
|
|
||||||
"futures",
|
|
||||||
"hex",
|
|
||||||
"lazy_static",
|
|
||||||
"libc",
|
|
||||||
"libp2p",
|
|
||||||
"log",
|
|
||||||
"rand 0.8.5",
|
|
||||||
"reqwest",
|
|
||||||
"ring",
|
|
||||||
"rusqlite",
|
|
||||||
"secp256k1",
|
|
||||||
"serde",
|
|
||||||
"serde_arrays",
|
|
||||||
"serde_cbor",
|
|
||||||
"serde_json",
|
|
||||||
"sha256",
|
|
||||||
"structopt",
|
|
||||||
"tokio",
|
|
||||||
"typescript-type-def",
|
|
||||||
]
|
|
||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "proc-macro-crate"
|
name = "proc-macro-crate"
|
||||||
version = "1.1.3"
|
version = "1.1.3"
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
[package]
|
[package]
|
||||||
name = "price-service"
|
name = "hermes"
|
||||||
version = "0.1.0"
|
version = "0.1.0"
|
||||||
edition = "2021"
|
edition = "2021"
|
||||||
|
|
||||||
|
|
@ -0,0 +1,200 @@
|
||||||
|
# Hermes
|
||||||
|
|
||||||
|
Hermes is a highly available and versatile software that defines the Pyth P2P
|
||||||
|
network. It also provides the public Pyth API and connects with the Pyth Geyser
|
||||||
|
node software to listen for Pythnet events. Hermes offers both REST and
|
||||||
|
WebSocket APIs for seamless integration and interaction with the Pyth network
|
||||||
|
stack. Anyone can run the Node to:
|
||||||
|
|
||||||
|
1. Provide their own Pyth API for interacting with the Pyth Network stack.
|
||||||
|
2. Observe Pyth price updates in real-time.
|
||||||
|
3. Operate alongside their Pythnet validator for fully decentralized access to Pyth.
|
||||||
|
|
||||||
|
## Getting Started
|
||||||
|
|
||||||
|
To set up and run a Hermes node, follow the steps below:
|
||||||
|
|
||||||
|
1. **Install Rust**: If you haven't already, you'll need to install Rust. You can
|
||||||
|
do so by following the official instructions.
|
||||||
|
2. **Install Go**: If you haven't already, you'll also need to install Go. You can
|
||||||
|
do so by following the official instructions.
|
||||||
|
3. **Clone the repository**: Clone the Pyth Crosschain repository to your local
|
||||||
|
machine using the following command:
|
||||||
|
```bash
|
||||||
|
git clone https://github.com/pyth-network/pyth-crosschain.git
|
||||||
|
```
|
||||||
|
4. **Build the project**: Navigate to the project directory and run the following command to build the project:
|
||||||
|
```bash
|
||||||
|
cd hermes
|
||||||
|
cargo build --release
|
||||||
|
```
|
||||||
|
This will create a binary in the target/release directory.
|
||||||
|
5. **Run the node**: To run Hermes, use the following command:
|
||||||
|
```bash
|
||||||
|
./target/release/hermes run --geyser-socket /tmp/geyser.ipc
|
||||||
|
```
|
||||||
|
Your Hermes node will now start and connect to the specified networks. You
|
||||||
|
can interact with the node using the REST and Websocket APIs as described
|
||||||
|
in the [API Documentation](). You can leave off the `--geyser-socket` arg
|
||||||
|
if you are planning to run the node without a Pythnet validator, it will
|
||||||
|
extract data only from the Pyth P2P network. Running a Pythnet node will
|
||||||
|
improve the speed and accuracy of network observations.
|
||||||
|
|
||||||
|
## Architecture Overview
|
||||||
|
|
||||||
|
For users who simply want to run the software, this section can be skipped.
|
||||||
|
However, for those interested in understanding Pyth's architecture, this
|
||||||
|
section explains the old and new architecture, as well as our motivation for
|
||||||
|
the design.
|
||||||
|
|
||||||
|
### Background
|
||||||
|
|
||||||
|
The Pyth project offers a cross-chain price oracle service for real-time access
|
||||||
|
to current prices of real-world assets. These prices are aggregated on Pythnet,
|
||||||
|
where core Pyth contracts are hosted, and pricing information is generated. The
|
||||||
|
Wormhole project currently sends these prices to other chains.
|
||||||
|
|
||||||
|
To share these prices, the Pyth project provides a standalone application
|
||||||
|
called the Price Service, which queries the message API provided by Wormhole to
|
||||||
|
look for Pyth prices.
|
||||||
|
|
||||||
|
The original communication flow can be visualized in the following graph:
|
||||||
|
|
||||||
|
```
|
||||||
|
+--------+ +--------+ +--------+
|
||||||
|
| User 3 | | User 2 | | User 1 |
|
||||||
|
+--------+ +--------+ +--------+
|
||||||
|
| | |
|
||||||
|
| | |
|
||||||
|
+--------------+--------------+
|
||||||
|
|
|
||||||
|
v
|
||||||
|
+---------------------+
|
||||||
|
| Price Service | (Weakly Decentralised)
|
||||||
|
+----------+----------+
|
||||||
|
|
|
||||||
|
v
|
||||||
|
+---------------------+
|
||||||
|
| Wormhole | (Decentralised)
|
||||||
|
+---------------------+
|
||||||
|
^
|
||||||
|
|
|
||||||
|
v
|
||||||
|
+ - - - - - - - - - + - - - - - - - - - - - +
|
||||||
|
' Pythnet '
|
||||||
|
' '
|
||||||
|
' +----------------+ '
|
||||||
|
' | Pythnet Node 1 | ------+ '
|
||||||
|
' +----------------+ | '
|
||||||
|
' | | '
|
||||||
|
' | | '
|
||||||
|
' +----------------+ | ' (Decentralised)
|
||||||
|
' | Pythnet Node 2 | | '
|
||||||
|
' +----------------+ | '
|
||||||
|
' | | '
|
||||||
|
' | | '
|
||||||
|
' +----------------+ +----------------+ '
|
||||||
|
' | Pythnet Node 3 | --- | Pythnet Node 4 | '
|
||||||
|
' +----------------+ +----------------+ '
|
||||||
|
+ - - - - - - - - - - - - - - - - - - - - - +
|
||||||
|
```
|
||||||
|
|
||||||
|
This design has issues due to latency and API complexity introduced by the
|
||||||
|
Price Service, which acts as a middleman between the user, Wormhole, and
|
||||||
|
Pythnet. Additionally, it does not represent a particularly decentralized
|
||||||
|
design, which was a weak point for Pyth.
|
||||||
|
|
||||||
|
### New Model
|
||||||
|
|
||||||
|
In the new model, we designed a single node-style service, Hermes, intended for
|
||||||
|
direct integration into Pythnet nodes. This aligns with other blockchain
|
||||||
|
projects where running standard node software allows users to act as observers
|
||||||
|
of the network:
|
||||||
|
|
||||||
|
```
|
||||||
|
+--------+ +--------+ +--------+
|
||||||
|
| User 3 | | User 2 | | User 1 |
|
||||||
|
+--------+ +--------+ +--------+
|
||||||
|
| | |
|
||||||
|
| | |
|
||||||
|
+--------------+--------------+
|
||||||
|
|
|
||||||
|
v
|
||||||
|
+ - - - - - - - - - + - - - - - - - - - - - +
|
||||||
|
' Pythnet '
|
||||||
|
' '
|
||||||
|
' +----------------+ '
|
||||||
|
' | Pythnet Node 1 | ------+ '
|
||||||
|
' +----------------+ | '
|
||||||
|
' | |Hermes| | '
|
||||||
|
' | +------+ | '
|
||||||
|
' | | '
|
||||||
|
' +----------------+ | '
|
||||||
|
' | Pythnet Node 2 | | '
|
||||||
|
' +----------------+ | '
|
||||||
|
' | |Hermes| | '
|
||||||
|
' | +------+ | '
|
||||||
|
' | | '
|
||||||
|
' +----------------+ +----------------+ '
|
||||||
|
' | Pythnet Node 3 | --- | Pythnet Node 4 | '
|
||||||
|
' +----------------+ +----------------+ '
|
||||||
|
' |Hermes| |Hermes| '
|
||||||
|
' +------+ +------+ '
|
||||||
|
+ - - - - - - - - - - - - - - - - - - - - - +
|
||||||
|
^
|
||||||
|
|
|
||||||
|
v
|
||||||
|
+---------------------+
|
||||||
|
| Wormhole |
|
||||||
|
+---------------------+
|
||||||
|
```
|
||||||
|
|
||||||
|
In this new design, the Price Service is integrated into the Hermes node
|
||||||
|
service, decentralizing the API. Hermes is now also responsible for direct
|
||||||
|
communication with Wormhole over P2P, which reduces latency and simplifies
|
||||||
|
responsibilities.
|
||||||
|
|
||||||
|
The new design offers several benefits:
|
||||||
|
|
||||||
|
1. Hermes can participate as a P2P node in the Wormhole network directly.
|
||||||
|
2. Hermes nodes form a Pyth-specific P2P network with fast communication.
|
||||||
|
3. Hermes can directly observe on-chain state for faster operation.
|
||||||
|
4. Hermes can have its identity tied to a Pythnet node for authenticated operation.
|
||||||
|
5. Data ownership is clearer with the removal of the middleman.
|
||||||
|
|
||||||
|
With tighter communication flow, we can define new behaviors such as
|
||||||
|
Pyth-specific threshold signing, fast price accumulation with proving (due to
|
||||||
|
direct node access), improved metrics and observations, and the ability for
|
||||||
|
users to run observe-only Hermes nodes to watch the Pyth network directly
|
||||||
|
instead of relying on a Price Service host.
|
||||||
|
|
||||||
|
The Hermes node architecture is as follows:
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
This is more in line with other well-known projects in the blockchain and P2P
|
||||||
|
space, such as Solana, Bitcoin, and Cosmos chains, where users who run the node
|
||||||
|
can also act as observers with specific features disabled.
|
||||||
|
|
||||||
|
In our case, the node software can be run with or without a Pythnet validator
|
||||||
|
running due to it being designed to fetch updates from either Pyth or Geyser
|
||||||
|
networks for high availability.
|
||||||
|
|
||||||
|
## Components
|
||||||
|
|
||||||
|
The Hermes Node software consists of the following components:
|
||||||
|
|
||||||
|
- **Wormhole P2P Connector**: Connects to the Wormhole P2P network and listens for VAAs.
|
||||||
|
- **Pyth P2P Connector**: Connects to the Pyth P2P network and listens for Account Updates.
|
||||||
|
- **Geyser Connector**: Connects to the Geyser node software and listens for Account Updates.
|
||||||
|
- **REST API**: Provides an interface for external applications to interact with Pythnet.
|
||||||
|
- **Websocket API**: Offers real-time data streaming for interacting with Pythnet.
|
||||||
|
|
||||||
|
While Hermes will always participate in the Wormhole and Pyth P2P networks, the
|
||||||
|
Pyth network shares network updates on the Pyth layer and so can be run without
|
||||||
|
a Pythnet node running along-side it for a spy-only mode. This can be done by
|
||||||
|
running without specifying `--geyser-socket`.
|
||||||
Loading…
Reference in New Issue