Pyth Crosschain

This repository acts as a monorepo for the various components that make up
Pyth protocols.

Within this monorepo you will find the following subprojects:

Table of Contents

Target Chains

Hermes

Fortuna

Pyth Lazer Pusher

Local Development

- Setup
- Pull requests
- Releases
- Typescript Monorepo
- Setting up
- Common tasks
- Building a new web app, JS / TS library or CLI tool

Audit / Feature Status

Target Chains

> target_chains

This directory contains on-chain contracts and SDKs for all of the various
blockchain runtimes that Pyth supports. Each subdirectory corresponds to a
blockchain runtime. Inside each subdirectory, there are subfolders for
contracts and SDKs.

Hermes

> hermes

Hermes is an off-chain service which constantly observes Pythnet and the
Wormhole network watching for price updates emitted from the Pyth contract. It
exposes all observed attestations via a public API over HTTPS/WSS which can be
consumed by client-side applications that wish to use Pyth pricing data.

The price_service/client directory provides an SDK for interacting with Hermes.
However, most users will interact with the price service via a chain-specific SDK

For a guide on utilising this service in your project, see the chain-specific SDK
and examples for your blockchain runtime in the target_chains directory.

Fortuna

> fortuna

Fortuna is an off-chain service which can be used by Entropy providers.

Pyth Lazer Pusher

> pyth-lazer-pusher

Price feed pushers that deliver Pyth Lazer data to external systems. Currently supports pushing to Bulk Trade validators.

Local Development

Setup

Please install the following tools in order to work in this repository:

NVM to manage your node version, then run nvm use 22 to ensure you are using node version 22.

- Optionally, you can also use mise. If you install mise, you can run all of your commands like the following: mise x -- pnpm <SOME_COMMAND>, which will ensure you are running your commands while using the correct tool versions for this repository.

Foundry in order to use forge for Ethereum contract development

Solana CLI for working with Solana programs.

- After installing, please run solana keygen new to generate a local private key.

[Anchor](h

... [truncated — view full README on GitHub]