Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 8 additions & 12 deletions apps/developer-hub/content/docs/entropy/chainlist.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,10 @@ import { EntropyTable } from "../../../src/components/EntropyTable";

## Mainnets

<InfoBox variant="warning">
<div>
The fees for mainnet are dynamically set. Always use the on-chain method
`entropy.getFeeV2()` to get the current fee.
</div>
</InfoBox>
<Callout type="warning">
The fees for mainnet are dynamically set. Always use the on-chain method
`entropy.getFeeV2()` to get the current fee.
</Callout>

The following tables shows the total fees payable when using the **default provider**.
Note that the fees shown below will vary over time with prevailing gas prices on each chain.
Expand All @@ -32,12 +30,10 @@ Entropy callbacks the consumer as part of this transaction.

## Testnets

<InfoBox variant="info">
<div>
The fees for testnets are kept deliberately low and different from the
mainnet fees.
</div>
</InfoBox>
<Callout type="info">
The fees for testnets are kept deliberately low and different from the mainnet
fees.
</Callout>

The Entropy contract is deployed on the following testnet chains:

Expand Down
2 changes: 1 addition & 1 deletion apps/developer-hub/content/docs/entropy/fees.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,4 +17,4 @@ Note that protocols integrating with Entropy can pass these fees along to their
submits a transaction that requests a random number, the user can directly pay the entropy fees required
with the native blockchain token. There are no fees for revealing the random numbers.

You can check the current fees in the [chainlist and fee details](./entropy/chainlist) page for each blockchain.
You can check the current fees in the [chainlist and fee details](./chainlist) page for each blockchain.
Original file line number Diff line number Diff line change
Expand Up @@ -147,7 +147,7 @@ IEntropyV2 entropy;

When the final random number is ready to use, the entropyCallback function will be called by the Entropy contract. This will happen in a separate transaction submitted by the requested provider.

<Callout variant="warning">
<Callout type="warning">
The `entropyCallback` function on your contract should **never** return an
error. If it returns an error, the keeper will not be able to invoke the
callback. If you are having problems receiving the callback, please see
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -127,7 +127,7 @@ mapping(uint64 => bool) public processedRequests;

When setting custom gas limits, be aware of these constraints:

<Callout variant="info" header="Gas Limit Rules">
<Callout type="info" title="Gas Limit Rules">
Gas limits are automatically rounded up to the nearest multiple of **10,000**.
Example: 19,000 becomes 20,000 25,500 becomes 30,000. The minimum gas limit is
the provider's configured default limit. The maximum gas limit is 655,350,000
Expand Down Expand Up @@ -169,7 +169,7 @@ uint32 customGasLimit = estimatedGas + safetyBuffer;

Be prepared to handle cases where your gas limit is insufficient:

<Callout variant="warning">
<Callout type="warning">
If your callback **runs out of gas**, the entropy provider will **not** be
able to complete the callback. Always test your gas limits thoroughly and
include adequate safety margins.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,6 @@ Each of these request types is described in more detail with examples in [Reques
### 2. Enhanced Callback Status

Entropy V2 introduces callback statuses, which allow users to track the status of their callbacks.

[Pyth Dev-Forum Announcement](https://dev-forum.pyth.network/t/announcing-entropy-v2/324#p-649-enhanced-callback-statuses-2) provides more details on enhanced callback statuses.

### 3. Entropy Explorer
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ description: >-
</Tab>
<Tab value="testing">

<Callout variant="warning">
<Callout type="warning">
To simulate real performance conditions and activity, the staging/testing
environment for Solana is on the mainnet-beta network. This environment is not
for production use and should only be used for testing.
Expand Down
4 changes: 2 additions & 2 deletions apps/developer-hub/content/docs/metrics/kpi.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,14 @@ title: Pyth Network KPI
description: Monthly informative data points on the Pyth network, its growth, and performance metrics.
---

<Callout variant="info" header="Pyth Network KPI ">
<Callout type="info" title="Pyth Network KPI ">
For the latest KPI dashboard, please visit
[https://kpi.pyth.network/](https://kpi.pyth.network/).
</Callout>
Every month, the Pyth contributors collect informative data points on the
network, its growth, as well as its performance.

<Callout variant="warning" header="Disclaimer">
<Callout type="warning" title="Disclaimer">
All figures mentioned are just rough estimations. Due to Pyth's permissionless
nature, any apps can use the Pyth price feeds without talking to the Pyth
contributors. This will exclude them from the calculations.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,10 +1,7 @@
---
title: "Access Hermes & Pythnet RPC: Developer API Guide"
description: >-
Streamline integration of Pyth Price Feeds with Hermes and Pythnet RPC. Choose
self-hosted or third-party instances to boost development efficiency.
full: false
index: false
title: API Instances and Providers
description: Guide to accessing Hermes and Pythnet RPC instances through self-hosting or third-party providers
icon: Globe
---

# API Instances and Providers
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
{
"hermes": "Hermes",
"benchmarks": "Benchmarks / Historical Prices",
"pythnet-rpc": "Pythnet RPC"
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
---
title: "Benchmarks API Instances"
description: "Access public instances of the Pyth Benchmarks API for retrieving historical price data and performance metrics."
icon: "ChartLineUp"
---

# Benchmarks API Instances

The Pyth Data Association hosts a public instance of the Benchmarks API at the following URL:

| Channel | URL |
| ------- | ------------------------------- |
| Stable | https://benchmarks.pyth.network |

There is currently no Benchmarks instance for the Beta channel.
Original file line number Diff line number Diff line change
@@ -1,13 +1,3 @@
---
title: "Hermes: Open-Source Service for Pyth Price Updates"
description: >-
Experience real-time Pyth price feeds with Hermes: an open-source REST and
streaming API. Use public endpoints or self-host for reliable, decentralized
data.
full: false
index: false
---

# Hermes

Hermes is an open-source service that listens to the Pythnet and the Wormhole Network for Pyth price updates, and
Expand All @@ -23,16 +13,22 @@ Network:

URL: https://hermes.pyth.network

<InfoBox variant="warning">
<div>For developers building on **Aptos testnet**, **Sui testnet** or **Near testnet**, please use the Hermes Beta endpoint:</div>
<Callout type="info">
For developers building on **Aptos testnet**, **Sui testnet** or **Near testnet**, please use the Hermes Beta endpoint:

URL: https://hermes-beta.pyth.network

</Callout>

<div>URL: https://hermes-beta.pyth.network</div>
### Rate limits

</InfoBox>
In order to maximize the reliability of the Public Hermes API, a request rate limit is enforced.
All endpoints limits are set at 30 requests every 10 seconds per IP address.
Clients issuing request above the limit will receive a 429 (Too Many Requests) response for the subsequent 60-second period.

For production deployments, developers integrating with Pyth Network are **strongly encouraged** to use Node Providers
for maximum resilience and decentralization. Moreover, Hermes is designed to be self-hosted, so developers can run their own
instance of Hermes to fetch Pyth price updates. Please note it is not recommended to use the public endpoint for production as it has rate limits.
instance of Hermes to fetch Pyth price updates.

## Node Providers

Expand Down
Original file line number Diff line number Diff line change
@@ -1,12 +1,3 @@
---
title: "Pythnet RPC: How to Access and Use for Developers"
description: >-
Use Hermes to configure Pythnet RPC. Choose from trusted providers like Triton
or P2P, or self-host a node for secure, reliable data access.
full: false
index: false
---

# Pythnet RPC

You will need a Pythnet RPC to run Hermes, which you can obtain from any of the Pythnet RPC
Expand Down
Original file line number Diff line number Diff line change
@@ -1,11 +1,7 @@
---
title: "Pyth API Reference: On- and Off-Chain Developer Tools"
description: >-
Pyth Core’s API reference covers EVM, Aptos, CosmWasm, and Hermes. It provides
interactive documentation and guides for both on-chain and off-chain
integration.
full: false
index: false
title: API Reference
description: Comprehensive interactive guide to on-chain and off-chain APIs for developers
icon: Code
---

# API Reference
Expand All @@ -17,9 +13,8 @@ The API reference is interactive, so developers can try out the APIs from the we
The following on-chain contracts are documented in the API reference:

- [EVM](api-reference/evm)
- [Aptos](api-reference/aptos)
- [CosmWasm](api-reference/cosmwasm)

Hermes also has interactive API documentation hosted by the service itself:

- [Hermes](https://hermes.pyth.network/docs/)
- [Benchmarks / Historical Prices](https://benchmarks.pyth.network/docs)
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
{
"evm": {
"title": "EVM ↗",
"href": "https://api-reference.pyth.network/price-feeds/evm/getPriceNoOlderThan",
"newWindow": true
},
"hermes": {
"title": "Hermes ↗",
"href": "https://hermes.pyth.network/docs/",
"newWindow": true
}
}
Original file line number Diff line number Diff line change
@@ -1,11 +1,7 @@
---
title: "Pyth Price Feeds: Best Practices for Safe Use"
description: >-
Best practices for Pyth price feeds: secure fixed-point representation,
mitigate latency & threats, use confidence intervals, and follow futures
pricing guidelines.
full: false
index: false
title: Best Practices
description: Technical guidance for safe and effective use of Pyth price feeds in your application
icon: ShieldCheck
---

# Best Practices
Expand Down
Original file line number Diff line number Diff line change
@@ -1,10 +1,7 @@
---
title: Pyth Contract Addresses for Multiple Blockchains
description: >-
Discover Pyth Price Feed contract addresses for EVM, Solana, Aptos, and more.
Visit our Developer Hub for quick access to your blockchain’s address.
full: false
index: false
title: Contract Addresses
description: Deployed Pyth Price Feed contract addresses across all supported blockchains
icon: AddressBook
---

# Contract Addresses
Expand Down
Original file line number Diff line number Diff line change
@@ -1,12 +1,11 @@
---
title: "Aptos Pyth Contract Addresses (Mainnet, Testnet, Devnet)"
description: >-
Browse Pyth’s Aptos contract addresses on Mainnet, Testnet, and Devnet with
direct links to Pyth, Wormhole, and the Deployer for quick reference.
full: false
index: false
title: "Aptos Contract Addresses"
description: "Pyth Network price feed contract addresses and named addresses for Aptos blockchain including mainnet, testnet, and Movement networks."
icon: "hexagon"
---

import CopyAddress from "../../../components/CopyAddress";

# Price Feed Contract Addresses on Aptos

Pyth is currently deployed on Aptos Mainnet, Aptos Testnet, and Movement devnet.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,10 +1,7 @@
---
title: Price Feed Contract Addresses on CosmWasm Networks
description: >-
Find Pyth contract addresses on CosmWasm networks—mainnets and testnets across
multiple chains. Access your network’s address instantly.
full: false
index: false
title: "CosmWasm Contract Addresses"
description: "Pyth Network price feed contract addresses for CosmWasm-based blockchain networks including Injective, Osmosis, Neutron, and more."
icon: "atom"
---

# Price Feed Contract Addresses on CosmWasm Networks
Expand Down
Loading