Merge branch 'main' of https://github.com/0xPolygon/polygon-docs into platform/404s

Author: kmurphypolygon

docs/cdk/getting-started/local-deployment.md

@@ -38,33 +38,6 @@ git clone https://github.com/0xPolygon/kurtosis-cdk.git
 cd kurtosis-cdk
 ```
 
-### Check your environment
-
-Run the `tool_check.sh` script to confirm you have all the prerequisite software.
-
-!!! tip
-      You may need to make the script executable: `chmod +x scripts/tool_check.sh`
-
-```sh
-./scripts/tool_check.sh
-```
-
-If everything is installed correctly, you should see the following output:
-
-```bash
-Checking that you have the necessary tools to deploy the Kurtosis CDK package...
-✅ kurtosis is installed, meets the requirement (=0.89).
-✅ docker is installed, meets the requirement (>=24.7).
-
-You might as well need the following tools to interact with the environment...
-✅ jq is installed.
-✅ yq is installed, meets the requirement (>=3.2).
-✅ cast is installed.
-✅ polycli is installed.
-
-🎉 You are ready to go!
-```
-
 ### Understanding the deployment steps
 
 There are two configuration files which help you understand what happens during a deployment.

docs/img/pos/delegateB.png

@@ -113,7 +113,7 @@ Expected result:
 ```json
 address: 0x68243159a498cf20d945cf3e4250918278ba538e
 coins:
-- denom: matic
+- denom: pol
     amount:
     i: "1000000000000000000000"
 pubkey: ""

docs/pos/architecture/heimdall/authentication.md

@@ -39,8 +39,8 @@ The bank module contains the following parameters:
 
 ### Send balance
 
-The following command sends 1000 matic tokens to the specified `address`:
+The following command sends 1000 POL tokens to the specified `address`:
 
 ```bash
-heimdallcli tx bank send <address> 1000matic --chain-id <chain-id>
+heimdallcli tx bank send <address> 1000pol --chain-id <chain-id>
 ```

docs/pos/architecture/heimdall/balance-transfers.md

@@ -13,8 +13,8 @@ type ChainParams struct {
  // BorChainID is valid bor chainId
  BorChainID            string                  `json:"bor_chain_id" yaml:"bor_chain_id"`
 
- // MaticTokenAddress is valid matic token address
- MaticTokenAddress     hmTypes.HeimdallAddress `json:"matic_token_address" yaml:"matic_token_address"`
+ // PolTokenAddress is valid POL token address
+ PolTokenAddress     hmTypes.HeimdallAddress `json:"pol_token_address" yaml:"pol_token_address"`
 
  // StakingManagerAddress is valid contract address
  StakingManagerAddress hmTypes.HeimdallAddress `json:"staking_manager_address" yaml:"staking_manager_address"`
@@ -53,7 +53,7 @@ Expected result:
 tx_confirmation_time: 12s
 chain_params:
   bor_chain_id: "15001"
-  matic_token_address: "0x0000000000000000000000000000000000000000"
+  pol_token_address: "0x0000000000000000000000000000000000000000"
   staking_manager_address: "0x0000000000000000000000000000000000000000"
   root_chain_address: "0x0000000000000000000000000000000000000000"
   staking_info_address: "0x0000000000000000000000000000000000000000"

docs/pos/architecture/heimdall/chain-management.md

@@ -8,7 +8,7 @@ The signer key is an address that is used for signing Heimdall blocks, checkpoin
 
 The validator must keep two types of balances on this address:
 
-- MATIC tokens on Heimdall (through top-up transactions) to perform validator responsibilities on Heimdall.
+- POL tokens on Heimdall (through top-up transactions) to perform validator responsibilities on Heimdall.
 - ETH on Ethereum chain to send checkpoints on Ethereum.
 
 ## Owner key

docs/pos/architecture/heimdall/key-management.md

@@ -1,16 +1,19 @@
-!!! danger "Important update"
+!!! info "Transitioning to POL"
 
-    There is a proposal to transition the native token of the Polygon PoS network from MATIC to POL. Please find more information [here](https://polygon.technology/blog/polygon-2-0-implementation-officially-begins-the-first-set-of-pips-polygon-improvement-proposals-released).
+    Polygon network is transitioning from MATIC to POL, which will serve as the gas and staking token on Polygon PoS. Use the links below to learn more:
 
-[MATIC](https://etherscan.io/token/0x7D1AfA7B718fb893dB30A3aBc0Cfc608AaCfeBB0) serves as the native cryptocurrency for the Polygon PoS network, analogous to how ETH functions within the Ethereum ecosystem.
+    - [Migrate from MATIC to POL](../../get-started/matic-to-pol.md)
+    - [POL token specs](../tokens/pol.md)
 
-To engage with the Polygon PoS network, users must use MATIC tokens, which are necessary to cover gas fees for transactions, smart contract interactions, and part of the network's security model via staking.
+[MATIC](https://etherscan.io/token/0x7D1AfA7B718fb893dB30A3aBc0Cfc608AaCfeBB0) is a native cryptocurrency that served as the gas token on Polygon PoS, analogous to how ETH functions within the Ethereum ecosystem.
+
+To engage with the Polygon PoS network, users previously used MATIC tokens to cover gas fees for transactions, smart contract interactions, and as a part of the network's security model via staking.
 
 This is an [example script](https://gist.github.com/rahuldamodar94/ea3bc4c551e6fc2d318767dcd7e5bffe) to send MATIC tokens from one account to another on the Polygon chain.
 
-!!! info "Acquiring MATIC"
+!!! info "MATIC rewards"
 
-    MATIC tokens can be acquired through methods such as validator rewards, staking, or by purchasing them on the open market.
+    Validator and staking rewards will now be distributed in the form of POL tokens.
 
 You can obtain test MATIC for testing purposes on the Amoy testnet. Testnet tokens don't hold any real-world value. This can be done via the Polygon faucet in the following way:
 

docs/pos/concepts/tokens/matic.md

@@ -2,9 +2,16 @@
 comments: true
 ---
 
-Validators are the key actor in maintaining the Polygon PoS network. Validators run a full node, secure the network by staking MATIC to produce blocks, validate and participate in PoS consensus.
+!!! info "Transitioning to POL"
 
-Validators play a crucial role in maintaining the integrity and security of the Polygon PoS network. By running a full node, validators contribute to the network's infrastructure and help facilitate transactions. They secure the network by staking MATIC tokens, which enables them to produce blocks and participate in network consensus (PoS). This contributes to greater network security and enhances network decentralization making it more resilient against potential attacks.
+    Polygon network is transitioning from MATIC to POL, which will serve as the gas and staking token on Polygon PoS. Use the links below to learn more:
+
+    - [Migrate from MATIC to POL](../get-started/matic-to-pol.md)
+    - [POL token specs](../concepts/tokens/pol.md)
+
+Validators are the key actor in maintaining the Polygon PoS network. Validators run a full node, secure the network by staking POL to produce blocks, validate and participate in PoS consensus.
+
+Validators play a crucial role in maintaining the integrity and security of the Polygon PoS network. By running a full node, validators contribute to the network's infrastructure and help facilitate transactions. They secure the network by staking POL tokens, which enables them to produce blocks and participate in network consensus (PoS). This contributes to greater network security and enhances network decentralization making it more resilient against potential attacks.
 
 In return for their efforts, validators are rewarded with incentives, encouraging active participation and commitment to the network's stability and growth.
 
@@ -29,7 +36,7 @@ To be a validator on the Polygon PoS network, you must do the following:
 
 * Run a sentry node: A separate machine running a Heimdall node and a Bor node. A sentry node is open to all nodes on the Polygon PoS network.
 * Run a validator node: A separate machine running a Heimdall node and a Bor node. A validator node is only open to its sentry node and closed to the rest of the network.
-* Stake the MATIC tokens in the staking contracts deployed on the Ethereum mainnet.
+* Stake the POL tokens in the staking contracts deployed on the Ethereum mainnet.
 
 ## Components
 
@@ -68,11 +75,11 @@ Bor is the block producing node and layer for the Polygon PoS network. It is bas
 
     Keep up with the latest node and validator updates from the Polygon team and the community by keeping an eye on the [announcements posed to Polygon forums](https://forum.polygon.technology/c/announcement/6).
 
-A blockchain validator is someone who is responsible for validating transactions within a blockchain. On the Polygon PoS network, any participant can be qualified to become a Polygon's validator by running a validator node (sentry + validator) to earn rewards and collect transaction fees. To ensure the good participation by validators, they lock up at least 1 MATIC token as a stake in the ecosystem.
+A blockchain validator is someone who is responsible for validating transactions within a blockchain. On the Polygon PoS network, any participant can be qualified to become a Polygon's validator by running a validator node (sentry + validator) to earn rewards and collect transaction fees. To ensure the good participation by validators, they lock up at least 1 POL token as a stake in the ecosystem.
 
-!!! info "PIP4 raises the minimum staking amount"
+!!! info "PIP4 raised the minimum staking amount"
 
-    After the implementation of the [PIP4 governance proposal](https://forum.polygon.technology/t/pip-4-validator-performance-management/9956) at the contract level, the minimum staking amount will increase to *10,000 MATIC*.
+    After the implementation of the [PIP4 governance proposal](https://forum.polygon.technology/t/pip-4-validator-performance-management/9956) at the contract level, the minimum staking amount was increased to *10,000 POL*.
 
 Any validator on the Polygon PoS network has the following responsibilities:
 

docs/pos/get-started/becoming-a-validator.md

@@ -2,6 +2,13 @@
 comments: true
 ---
 
+!!! info "Transitioning to POL"
+
+    Polygon network is transitioning from MATIC to POL, which will serve as the gas and staking token on Polygon PoS. Use the links below to learn more:
+
+    - [Migrate from MATIC to POL](../get-started/matic-to-pol.md)
+    - [POL token specs](../concepts/tokens/pol.md)
+
 ## Overview
 
 All your favorite Ethereum tools (Foundry, Remix, Web3.js) work seamlessly on Polygon, with the same familiar UX. Just switch to the [Polygon RPC](https://polygon-rpc.com/) and keep building.

docs/pos/get-started/building-on-polygon.md

@@ -8,7 +8,7 @@ Changes to the network require a high level of coordination and ecosystem consen
 
     A block number is selected, before which all nodes in the network should have upgraded to the new version; nodes running the old version will be disconnected from the canonical chain after the hard fork block.
 
-    Should there be ${1/3}+1$ staked MATIC in disagreement with the fork, two canonical chains will temporarily form until the end of the current span. Afterwards, Bor will stop producing blocks, and the chain will halt until consensus is reached.
+    Should there be ${1/3}+1$ staked POL in disagreement with the fork, two canonical chains will temporarily form until the end of the current span. Afterwards, Bor will stop producing blocks, and the chain will halt until consensus is reached.
 
     In contrast, a *soft fork* is backward-compatible with the pre-fork blocks. This type of protocol change does not require nodes to upgrade before a deadline, therefore, multiple versions of the node software can be running at once and be able to validate transactions. 
 
@@ -69,7 +69,7 @@ The Heimdall client also has an [in-built governance module](https://github.com/
 2. Each validator then tallies votes cast by validators.
 3. When the defined voting parameters are met, each validator makes the upgrade with the proposal data.
 
-The current voting parameters (denominated in staked MATIC):
+The current voting parameters (denominated in staked POL):
 
 - Quorum: 33.4%		
 - Threshold: 50%