Request form
Pyth Network
  • Oracle
  • Example
  • Protocol
Docs
Source
ChefGPT

Bringing real-world data on-chain at a sub-second timescale

Ownable2StepUpgradeable.sol
OwnableUpgradeable.sol
draft-IERC1822Upgradeable.sol
IBeaconUpgradeable.sol
ERC1967UpgradeUpgradeable.sol
Initializable.sol
UUPSUpgradeable.sol
AddressUpgradeable.sol
ContextUpgradeable.sol
StorageSlotUpgradeable.sol
Ownable.sol
draft-IERC1822.sol
IBeacon.sol
ERC1967Proxy.sol
ERC1967Upgrade.sol
Proxy.sol
Address.sol
Context.sol
SafeCast.sol
StorageSlot.sol
EntropyErrors.sol
EntropyEvents.sol
EntropyStructs.sol
IEntropy.sol
AbstractPyth.sol
IPyth.sol
IPythEvents.sol
PythErrors.sol
PythStructs.sol
IPriceOracleGetter.sol
PythAssetRegistry.sol
PythPriceOracleGetter.sol
Entropy.sol
EntropyGovernance.sol
EntropyState.sol
EntropyUpgradable.sol
Executor.sol
ExecutorErrors.sol
ExecutorUpgradable.sol
BytesLib.sol
UnsafeBytesLib.sol
UnsafeCalldataBytesLib.sol
MerkleTree.sol
Migrations.sol
MockPythProxyUpgrade.sol
MockUpgradeableProxy.sol
Pyth.sol
PythAccumulator.sol
PythDeprecatedStructs.sol
PythGetters.sol
PythGovernance.sol
PythGovernanceInstructions.sol
PythInternalStructs.sol
PythSetters.sol
PythState.sol
PythUpgradable.sol
ReceiverGetters.sol
ReceiverGovernance.sol
ReceiverGovernanceStructs.sol
ReceiverImplementation.sol
ReceiverMessages.sol
ReceiverSetters.sol
ReceiverSetup.sol
ReceiverState.sol
ReceiverStructs.sol
WormholeReceiver.sol
Getters.sol
Governance.sol
GovernanceStructs.sol
Implementation.sol
IWormhole.sol
Messages.sol
Setters.sol
Setup.sol
State.sol
Structs.sol
Wormhole.sol

11 downloads

Chains

Authors

Pyth Network
  • Oracle
  • Example
  • Protocol
Info
Source
ChefGPT
Expand
Share

Get Cookin'

11 downloads

Chains

Authors

Pyth Crosschain

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

Within this monorepo you will find the following subprojects:

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, SDKs, and examples.

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.

Development

Pull requests

Use the following format for naming the pull requests:

[component] PR description

For example:

[hermes] Add storage tests

Releases

The repository has a CI workflow that will release javascript packages whose version number has changed. To perform a release, follow these steps:

  1. Update the version number in the package.json file for the package(s) you wish to release. Please follow Semantic Versioning for package versions.
  2. Submit a PR with the changes and merge them in to main.
  3. Create a new tag pyth-js-v<number> and push to github. You can simply increment the version number each time -- it doesn't affect any of the published information.
  4. Pushing the tag automatically triggers a CI workflow to publish the updated packages to NPM.

If you have a javascript package that shouldn't be published, simply add "private": "true" to the package.json file and it will be excluded from the publishing workflow. If you are creating a new public javascript package, you should add the following config option to package.json:

  "publishConfig": {
    "access": "public"
  },

pre-commit hooks

pre-commit is a tool that checks and fixes simple issues (formatting, ...) before each commit. You can install it by following their website. In order to enable checks for this repo run pre-commit install from command-line in the root of this repo.

The checks are also performed in the CI to ensure the code follows consistent formatting.

Tilt CI

Integration tests run in Tilt (via the tilt ci command). The Tilt CI workflow requires approval from a member of the Pyth team. If you are a member, click on "Details" next to the "Workflow / ci-pyth-crosschain" check in a pull request, and then on the "Resume" button on the workflow page.

Typescript Monorepo

All of the typescript / javascript packages in this repository are part of a lerna monorepo. This setup allows each package to reference the current version of the others. You can install dependencies using npm ci from the repository root. You can build all of the packages using npx lerna run build and test with npx lerna run test.

Lerna has some common failure modes that you may encounter:

  1. npm ci fails with a typescript compilation error about a missing package. This error likely means that the failing package has a prepare entry compiling the typescript in its package.json. Fix this error by moving that logic to the prepublishOnly entry.
  2. The software builds locally but fails in CI, or vice-versa. This error likely means that some local build caches need to be cleaned. The build error may not indicate that this is a caching issue, e.g., it may appear that the packages are being built in the wrong order. Delete node_modules/, lib/ and tsconfig.tsbuildinfo from each package's subdirectory. then try again.

Audit / Feature Status

This software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. Or plainly spoken - this is a very complex piece of software which targets a bleeding-edge, experimental smart contract runtime. Mistakes happen, and no matter how hard you try and whether you pay someone to audit it, it may eat your tokens, set your printer on fire or startle your cat. Cryptocurrencies are a high-risk investment, no matter how fancy.

Bringing real-world data on-chain at a sub-second timescale
Ownable2StepUpgradeable.sol
OwnableUpgradeable.sol
draft-IERC1822Upgradeable.sol
IBeaconUpgradeable.sol
ERC1967UpgradeUpgradeable.sol
Initializable.sol
UUPSUpgradeable.sol
AddressUpgradeable.sol
ContextUpgradeable.sol
StorageSlotUpgradeable.sol
Ownable.sol
draft-IERC1822.sol
IBeacon.sol
ERC1967Proxy.sol
ERC1967Upgrade.sol
Proxy.sol
Address.sol
Context.sol
SafeCast.sol
StorageSlot.sol
EntropyErrors.sol
EntropyEvents.sol
EntropyStructs.sol
IEntropy.sol
AbstractPyth.sol
IPyth.sol
IPythEvents.sol
PythErrors.sol
PythStructs.sol
IPriceOracleGetter.sol
PythAssetRegistry.sol
PythPriceOracleGetter.sol
Entropy.sol
EntropyGovernance.sol
EntropyState.sol
EntropyUpgradable.sol
Executor.sol
ExecutorErrors.sol
ExecutorUpgradable.sol
BytesLib.sol
UnsafeBytesLib.sol
UnsafeCalldataBytesLib.sol
MerkleTree.sol
Migrations.sol
MockPythProxyUpgrade.sol
MockUpgradeableProxy.sol
Pyth.sol
PythAccumulator.sol
PythDeprecatedStructs.sol
PythGetters.sol
PythGovernance.sol
PythGovernanceInstructions.sol
PythInternalStructs.sol
PythSetters.sol
PythState.sol
PythUpgradable.sol
ReceiverGetters.sol
ReceiverGovernance.sol
ReceiverGovernanceStructs.sol
ReceiverImplementation.sol
ReceiverMessages.sol
ReceiverSetters.sol
ReceiverSetup.sol
ReceiverState.sol
ReceiverStructs.sol
WormholeReceiver.sol
Getters.sol
Governance.sol
GovernanceStructs.sol
Implementation.sol
IWormhole.sol
Messages.sol
Setters.sol
Setup.sol
State.sol
Structs.sol
Wormhole.sol