benduran 31c364cf41 feat: performed a minor bump all packages, since all were changed in the big dual package update		2 nedēļas atpakaļ
..
src	dfcb87d16f chore: eslint yakshaving	3 nedēļas atpakaļ
.gitignore	ab0cf6f7d8 chore: updated gitignore to excluse the built dist/ folder	3 nedēļas atpakaļ
.prettierignore	6efbe89542 chore: updated prettier ignores to prevent bikeshedding	2 nedēļas atpakaļ
README.md	08833c43ba fix(hermes-docs)-fix Readme file (#2651)	6 mēneši atpakaļ
eslint.config.js	6efbe89542 chore: updated prettier ignores to prevent bikeshedding	2 nedēļas atpakaļ
jest.config.js	99a6a2468b fix: tests for all	2 nedēļas atpakaļ
package.json	31c364cf41 feat: performed a minor bump all packages, since all were changed in the big dual package update	2 nedēļas atpakaļ
tsconfig.build.json	99a6a2468b fix: tests for all	2 nedēļas atpakaļ
tsconfig.json	741e22485b fix: fixed a lot of TSC builds	3 nedēļas atpakaļ
turbo.json	8a05757929 chore: update turbo config	8 mēneši atpakaļ

Hermes Client

Pyth Network provides real-time pricing data in a variety of asset classes, including cryptocurrency, equities, FX and commodities. These prices are available either via HTTP or Streaming from Hermes. This library is a client for interacting with Hermes, allowing your application to consume Pyth real-time prices in on- and off-chain Javascript/Typescript applications.

Installation

npm

npm install --save @pythnetwork/hermes-client

Yarn

yarn add @pythnetwork/hermes-client

Quickstart

Typical usage of the connection is along the following lines:

const connection = new HermesClient("https://hermes.pyth.network", {}); // See Hermes endpoints section below for other endpoints

const priceIds = [
  // You can find the ids of prices at https://pyth.network/developers/price-feed-ids
  "0xe62df6c8b4a85fe1a67db44dc12de5db330f7ac66b72dc658afedf0f4a415b43", // BTC/USD price id
  "0xff61491a931112ddf1bd8147cd1b641375f79f5825126d665480874634fd0ace", // ETH/USD price id
];

// Get price feeds
const priceFeeds = await connection.getPriceFeeds({
  query: "btc",
  assetType: "crypto",
});
console.log(priceFeeds);

// Latest price updates
const priceUpdates = await connection.getLatestPriceUpdates(priceIds);
console.log(priceUpdates);

HermesClient also allows subscribing to real-time price updates over a Server-Sent Events (SSE) connection:

// Streaming price updates
const eventSource = await connection.getPriceUpdatesStream(priceIds);

eventSource.onmessage = (event) => {
  console.log("Received price update:", event.data);
};

eventSource.onerror = (error) => {
  console.error("Error receiving updates:", error);
  eventSource.close();
};

await sleep(5000);

// To stop listening to the updates, you can call eventSource.close();
console.log("Closing event source.");
eventSource.close();

On-chain Applications

On-chain applications will need to submit the price updates returned by Hermes to the Pyth contract on their blockchain. By default, these updates are returned as binary data and is serialized as either a base64 string or a hex string depending on the chosen encoding. This binary data will need to be submitted to the Pyth contract.

Examples

The HermesClient example demonstrates both the examples above. To run the example:

Clone the Pyth monorepo

In the root of the monorepo, run pnpm turbo --filter @pythnetwork/hermes-client example -- <args>. For example, to print BTC and ETH price feeds in the testnet network, run:

pnpm turbo --filter @pythnetwork/hermes-client example -- \
--endpoint https://hermes.pyth.network \
--price-ids \
0xe62df6c8b4a85fe1a67db44dc12de5db330f7ac66b72dc658afedf0f4a415b43 \
0xff61491a931112ddf1bd8147cd1b641375f79f5825126d665480874634fd0ace

Hermes endpoints

Pyth offers a free public endpoint at https://hermes.pyth.network. However, it is recommended to obtain a private endpoint from one of the Hermes RPC providers for more reliability. You can find more information about Hermes RPC providers here.

README.md