Mirroring https://github.com/pyth-network/pyth-crosschain

Reisen 1c49b582ff near: add Tilt changes for local testing 2 tahun lalu
.github d95c9247a2 [cosmwasm] Release setup (#594) 2 tahun lalu
governance 040169a196 [xc-admin] Forbid more than 32 pubs (#607) 2 tahun lalu
price_service 3e9472b8ef [price service] Return VAA without prepending publish time (#577) 2 tahun lalu
scripts 0df243ba9e [eth] Add benchmark tests (#368) 3 tahun lalu
target_chains 1c49b582ff near: add Tilt changes for local testing 2 tahun lalu
third_party 3f7cffd5b2 [price-service/client] Add e2 test (#559) 2 tahun lalu
tilt_devnet 1c49b582ff near: add Tilt changes for local testing 2 tahun lalu
tilt_modules d6e25d9209 Add pre-commit globally (#393) 3 tahun lalu
wormhole_attester 2a906b6d90 [wormhole-attester/sdk/js] Fix Status Enum case (#598) 2 tahun lalu
.dockerignore 78cd4ee437 pyth2wormhole: build + deploy program into local devnet 4 tahun lalu
.gitignore 4c5d0d5e1b [refactor] Add global lerna (#546) 2 tahun lalu
.pre-commit-config.yaml 70fd0a6c15 [wormhole-attester] Move p2w-sdk inside wormhole_attester directory (#534) 2 tahun lalu
CONTRIBUTING.md d6e25d9209 Add pre-commit globally (#393) 3 tahun lalu
DEVELOP.md d6e25d9209 Add pre-commit globally (#393) 3 tahun lalu
LICENSE fedb92e446 Remove unused components/projects (#481) 2 tahun lalu
README.md 084acdb57e [refactor] Convert hyphen to underscore in the directory tree (#524) 2 tahun lalu
SECURITY.md 91533aa02d update links (#554) 2 tahun lalu
Tiltfile 1c49b582ff near: add Tilt changes for local testing 2 tahun lalu
lerna.json 4c5d0d5e1b [refactor] Add global lerna (#546) 2 tahun lalu
package-lock.json b2cae745c8 [xc-admin] improve UI/UX of xc-admin-frontend (#605) 2 tahun lalu
package.json 56e5ed8c1d [prettier] Prettier sync (#562) 2 tahun lalu
rustfmt.toml becc216853 Abehjati/repo-improvement (#395) 3 tahun lalu
tsconfig.base.json 481c61bc2c [refactor] Improve typescript codebase (#553) 2 tahun lalu

README.md

Pyth Crosschain

This repository acts as a monorepo for the various components that make up Pyth Crosschain. The base repository is a fork from Certus One's reference Wormhole implementation in order to take advantage of the existing tooling for building projects based on Wormhole's various SDKs. Much of the existing documentation from there will also apply to this repository.

Within this monorepo you will find the following subprojects:

Wormhole Attester

wormhole_attester

The main Pyth implementation currently exists as an on-chain contract on Solana. In order to expose these prices cross-chain, the Wormhole Attester contract acts as a sender for Pyth prices. At regular intervals the Pyth contract will observe the current Pyth price for selected products, and produce an attestation which is then relayed over Wormhole to be consumed by the various receiver contracts.

Target Chains

Ethereum

target_chains/ethereum/contracts/pyth

The Ethereum contract acts as a receiver for Pyth prices relayed from the Wormhole Attester. It also provides a public API for other Ethereum contracts that can be used to consume Pyth prices. For a guide on using this API to consume Pyth price feeds see pyth-sdk-solidity which contains documented examples.

Price Service

price_service

The Price Service is an off-chain service which constantly observes the Wormhole network watching for price attestations emitted from the Pyth Solana 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.

For a guide on utilising this service in your project, see the documentation in the pyth-js repository.


See DEVELOP.md for instructions on how to set up a local devnet, and CONTRIBUTING.md for instructions on how to contribute to this project.

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.

Development

Releases

We use Semantic Versioning for our releases.

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.