Merge pull request #3039 from pyth-network/pyth-token

chore(developer-hub): Pyth token and its pages

Author: nidhi-singh02

apps/developer-hub/content/docs/meta.json

@@ -1,3 +1,3 @@
 {
-  "pages": ["price-feeds", "entropy", "express-relay"]
+  "pages": ["pyth-core", "pyth-token", "express-relay", "entropy"]
 }

apps/developer-hub/content/docs/pyth-token/index.mdx

@@ -0,0 +1,36 @@
+---
+title: PYTH Token
+description: The governance token of the Pyth Network
+---
+
+The Pyth Network, as a distributed system, needs to have a constitution and a clear governance system.
+
+PYTH is the governance token of the Pyth Network, and the [Pyth DAO constitution](https://github.com/pyth-network/governance/blob/main/docs/constitution/pyth-dao-constitution.md) is the governance framework for the Pyth DAO. The constitution outlines the rules and procedures of the Pyth DAO. These rules and procedures are generally enforced through on-chain contracts and the associated parameters, unless specified by the Pyth DAO for actuation off-chain.
+
+## PYTH Token Staking
+
+PYTH Token can be staked for Governance and Oracle Integrity.
+
+### 1. Staking PYTH for Governance
+
+PYTH token holders can participate in Pyth governance through [staking](https://staking.pyth.network/) and [governance](https://app.realms.today/dao/PYTH). Token holders use their staked tokens in the Pyth staking program to vote on community governance proposals.
+
+Governance uses a 1:1 coin-voting system, where each staked token confers one vote.
+
+Any PYTH Token holder can submit proposals to the Pyth DAO as long as they have **0.25%** of the total PYTH tokens staked.
+At the end of the **7 day** voting period, a proposal is passes if it meets the following conditions:
+
+- **More yesses** have been cast than nos.
+- The "**Approval Quorum**" has been met. \
+  **Approval Quorum** is a percentage of staked PYTH tokens that must have voted yes for the proposal to pass. "Community Vote Threshold Percentage" is expressed as percentage of staked tokens at the start of the voting period for the proposal. This percentage threshold can vary depending on the type of proposal. The current threshold can be found in the "Governances" sections of the [parameters of the DAO](https://app.realms.today/dao/PYTH/params).
+
+Please note that the scope of community governance proposals may be expanded if the PYTH token holders (or the Pyth DAO) decide so.
+
+### 2. Staking PYTH for Oracle Integrity
+
+The Pyth Network is built to provide decentralized applications with reliable and trustworthy data. The quality of the data it provides is paramount for these application's functions and the network's overall success.
+
+Pyth's [Oracle Integrity Staking (OIS)](./oracle-integrity-staking) concentrates on producing quality data in the hands of a limited set of semi-trusted entities to achieve more coverage and lower latency than the competition. The responsibility of publishers over data quality is not just ethical but also incentivized through economics:
+
+- **Staking and Slashing:** Publishers can self-stake PYTH tokens as collateral. It also allows other stakers to choose publishers to delegate their PYTH tokens. In the event of data inaccuracies or inconsistencies, a portion of this stake can be slashed as a penalty. This mechanism ensures that publishers have a vested interest in providing accurate data
+- **Reputation:** The reputation of data publishers is directly linked to the quality of data they provide. Publishers with a track record of providing accurate data are more likely to be trusted and attract more interest.

apps/developer-hub/content/docs/pyth-token/meta.json

@@ -0,0 +1,4 @@
+{
+  "title": "PYTH Token",
+  "pages": ["index", "pyth-distribution", "pyth-token-addresses"]
+}

apps/developer-hub/content/docs/pyth-token/pyth-distribution.mdx

@@ -0,0 +1,74 @@
+---
+title: PYTH Token Distribution
+description: Details about PYTH token distribution and lockup schedules
+---
+
+There is a total of 10,000,000,000 (10B) PYTH tokens existing.
+
+The initial circulating supply (November 2023) was 1,500,000,000 (15%) PYTH. And the remaining supply (85%) are initially locked and locked tokens will unlock 6, 18, 30 and 42 months after the initial token launch.
+
+**PYTH Lockup Schedule**
+
+![PYTH Lockup Schedule](/images/token/Pyth_Lockup_Schedule.png)
+
+## Token Distribution
+
+Below is the PYTH Token distribution table as per the whitepaper.
+
+![Token Distribution](/images/token/Token_breakdown.png)
+
+## Publisher Rewards
+
+22% — 2,200,000,000 PYTH
+
+This allocation is reserved for the Pyth Network data providers, or "publishers".
+
+The publishers are responsible for publishing price data to the Pyth Network. The "Publisher Rewards" allocation consists of reserved tokens for various reward mechanisms and grant programs to encourage publishers to publish accurate and timely price data.
+
+This is designed to encourage more publishers to support new symbols which may lack the initial popularity or liquidity for the network to launch immediately.
+
+~2% (50M) of the 2.2B PYTH Tokens are unlocked. The remaining PYTH Tokens (2.15B) are subject to the lockup schedule described above. Note that these rewards can only be distributed to publishers once they are unlocked.
+
+![Publisher Rewards Lockup Schedule](/images/token/PYTH_Publisher_Rewards_Lockup_Schedule.png)
+
+## Ecosystem Growth
+
+52% — 5,200,000,000 PYTH
+
+The "Ecosystem Growth" allocation is a strategic portion of tokens set aside for contributors to the Pyth Network, including developers, educators, researchers, strategic contributors, early publishers, and more.
+
+This allocation aims to facilitate practical initiatives including funding research projects aimed at advancing the Pyth Network, incentivizing developers to build complementary tooling and resources, and supporting public education programs to increase awareness. This allocation aims to recognize and reward individuals and organizations that go beyond the contributors in fostering the expansion and vitality of the Pyth Network.
+
+13% (700M) of the 5.2B PYTH Tokens are unlocked. The remaining tokens (4.5B) are subject to the unlock schedule described above.
+
+![Ecosystem Growth Lockup Schedule](/images/token/PYTH_Ecosystem_Growth_Lockup_Schedule.png)
+
+## Protocol Development
+
+10% — 1,000,000,000
+
+This portion of the token supply has been allocated to contributors focused on building oracle tooling, products, and infrastructure to expand the network's suite of decentralized data services.
+
+15% (150M) of the 1B PYTH Tokens are unlocked. The remaining tokens (850M) are subject to the unlock schedule described above.
+
+![Protocol Development Lockup Schedule](/images/token/PYTH_Protocol_Development_Lockup_Schedule.png)
+
+## Community and Launch
+
+6% — 600,000,000
+
+This portion of PYTH Tokens is set aside for the initial launch phase and related activities and initiatives. 41% (250M) of the 600M PYTH tokens were allocated to DeFi Participants (of an application that use Pyth data) ; 16% (100M) of the Community and Launch bucket are directly assigned to protocols and DAOs ; and the rest (250M) was used for other launch activities.
+
+All 600M PYTH Tokens of "Community and Launch" allocation are unlocked from day one.
+
+![Community and Launch Lockup Schedule](/images/token/PYTH_Community_Launch_Lockup_Schedule.png)
+
+## Private Sales
+
+10% — 1,000,000,000
+
+This category represents two historical funding rounds to strategic contributors who add value to the network in terms of advisory and infrastructure support.
+
+All of 1B PYTH Tokens are locked and subject to the unlock schedule described above.
+
+![Private Sales Lockup Schedule](/images/token/PYTH_Private_Sales_Lockup_Schedule.png)

apps/developer-hub/content/docs/pyth-token/pyth-token-addresses.mdx

@@ -0,0 +1,30 @@
+---
+title: PYTH Token Contract Addresses
+description: Official PYTH token contract addresses across different blockchain networks
+---
+
+import CopyAddress from "../../../src/components/CopyAddress";
+
+The PYTH token is a native Solana token following the SPL model. Through the use of permissionless bridges like Wormhole, (wrapped) PYTH tokens may exist on various other chains.
+
+Below is the list of all official PYTH token representation on various blockchains:
+
+## Networks
+
+| Network   | Token address                                                                                                                                                                                                                                   |
+| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Solana    | <CopyAddress address="HZ1JovNiVvGrGNiiYvEozEVgZ58xaU3RKwX8eACQBCt3" url="https://solana.fm/address/HZ1JovNiVvGrGNiiYvEozEVgZ58xaU3RKwX8eACQBCt3?cluster=mainnet-solanafmbeta" />                                                                |
+| Ethereum  | <CopyAddress address="0xeFc0CED4B3D536103e76a1c4c74F0385C8F4Bdd3" url="https://etherscan.io/token/0xeFc0CED4B3D536103e76a1c4c74F0385C8F4Bdd3" />                                                                                                |
+| Arbitrum  | <CopyAddress address="0xE4D5c6aE46ADFAF04313081e8C0052A30b6Dd724" url="https://arbiscan.io/token/0xE4D5c6aE46ADFAF04313081e8C0052A30b6Dd724" />                                                                                                 |
+| Optimism  | <CopyAddress address="0x99C59ACeBFEF3BBFB7129DC90D1a11DB0E91187f" url="https://optimistic.etherscan.io/token/0x99C59ACeBFEF3BBFB7129DC90D1a11DB0E91187f" />                                                                                     |
+| Fantom    | <CopyAddress address="0x77ad3B2dA29FBd208F12c3C701E969F4422aAD79" url="https://ftmscan.com/token/0x77ad3B2dA29FBd208F12c3C701E969F4422aAD79" />                                                                                                 |
+| Base      | <CopyAddress address="0x4c5d8A75F3762c1561D96f177694f67378705E98" url="https://basescan.org/token/0x4c5d8A75F3762c1561D96f177694f67378705E98" />                                                                                                |
+| BNB Chain | <CopyAddress address="0xb0188B0bb2cD4a6D2744637fC83C94a284B247Da" url="https://bscscan.com/token/0xb0188B0bb2cD4a6D2744637fC83C94a284B247Da" />                                                                                                 |
+| Polygon   | <CopyAddress address="0xFa4B761A1e07909Ba31331a5dfa12390E3ff5583" url="https://polygonscan.com/token/0xFa4B761A1e07909" />                                                                                                                      |
+| Avalanche | <CopyAddress address="0x8A0691e602B7a5FCc51a27E4a08376dE50889B42" url="https://avascan.info/blockchain/c/token/0x8A0691e602B7a5FCc51a27E4a08376dE50889B42" />                                                                                   |
+| Manta     | <CopyAddress address="0x90E95735378A31BfAD2Dcd87128Fbb80FFeB6917" url="https://manta-pacific.calderaexplorer.xyz/address/0x90E95735378A31BfAD2Dcd87128Fbb80FFeB6917" />                                                                         |
+| Aptos     | <CopyAddress address="0x770211b47954e15bec1a4271bf33bacebc2d2adb43b7dc1ca45efa787615dd4c" url="https://explorer.aptoslabs.com/account/0x770211b47954e15bec1a4271bf33bacebc2d2adb43b7dc1ca45efa787615dd4c?network=mainnet" />                    |
+| Sui       | <CopyAddress address="0x9c6d76eb273e6b5ba2ec8d708b7fa336a5531f6be59f326b5be8d4d8b12348a4" url="https://suiexplorer.com/object/0x9c6d76eb273e6b5ba2ec8d708b7fa336a5531f6be59f326b5be8d4d8b12348a4" />                                            |
+| Injective | <CopyAddress address="inj1tjcf9497fwmrnk22jfu5hsdq82qshga54ajvzy" url="https://explorer.injective.network/asset/?tokenType=tokenFactory&denom=factory/inj14ejqjyq8um4p3xfqj74yld5waqljf88f9eneuk/inj1tjcf9497fwmrnk22jfu5hsdq82qshga54ajvzy" /> |
+| Sei       | <CopyAddress address="sei1cl90kjpf6wnfa9vvynmqva6vpy7xv3u84e6fkx96tx89axsf3gcq2vuync" url="https://sei.explorers.guru/account/sei1cl90kjpf6wnfa9vvynmqva6vpy7xv3u84e6fkx96tx89axsf3gcq2vuync" />                                                |
+| NEAR      | <CopyAddress address="21.contract.portalbridge.near" url="https://nearblocks.io/address/21.contract.portalbridge.near" />                                                                                                                       |