Merge branch 'main' into empieichO-docs-review

kmurphypolygon · web-flow · commit 0338f5ce3b62 · 2023-12-19T10:36:56.000+01:00
diff --git a/.cache/plugin/git-committers/page-authors.json b/.cache/plugin/git-committers/page-authors.json
diff --git a/docs/pos/architecture/heimdall/governance.md b/docs/pos/architecture/heimdall/governance.md
@@ -1,4 +1,4 @@
-Heimdall's governance operates identically to the Cosmos-sdk `x/gov` module, as detailed in [Cosmos-sdk documentation](https://docs.cosmos.network/master/modules/gov/).
+Heimdall's governance operates identically to the Cosmos-sdk `x/gov` module, as detailed in [Cosmos-sdk documentation](https://docs.cosmos.network/main/build/modules/gov).
 
 ## Overview
 
diff --git a/docs/pos/concepts/tokens/matic.md b/docs/pos/concepts/tokens/matic.md
@@ -16,4 +16,4 @@ For testing purposes on the Mumbai Testnet, test MATIC can be obtained, which do
 3. Choose the Mumbai network
 4. Enter your account address and confirm
 
-For interactions between Goerli and Mumbai, consider using tools like [Matic.js](https://maticnetwork.github.io/matic.js/) or the [Polygon Web Wallet](https://wallet-dev.polygon.technology/).
+For interactions between Goerli and Mumbai, consider using tools like [Matic.js](https://maticnetwork.github.io/matic.js/) or use the the [Polygon wallet page](https://wallet.polygon.technology/).
diff --git a/docs/pos/concepts/transactions/meta-transactions.md b/docs/pos/concepts/transactions/meta-transactions.md
@@ -102,7 +102,7 @@ Under the hood, user signs on an intent to execute a transaction, which is relay
 
 ## What is enabling transaction execution?
 
-The client that the user interacts with (web browser, mobile apps, etc) never interacts with the blockchain, instead it interacts with a simple relayer server (or a network of relayers), similar to the way GSN or any meta-transaction solution works ( see: [Meta Transactions: An Introduction](https://www.notion.so/Meta-Transactions-An-Introduction-8f54cf75321e4ec3b6d755e18e406590)).
+The client that the user interacts with (web browser, mobile apps, etc) never interacts with the blockchain, instead it interacts with a simple relayer server (or a network of relayers), similar to the way GSN or any meta-transaction solution works.
 
 For any action that requires blockchain interaction,
 
@@ -115,7 +115,7 @@ For any action that requires blockchain interaction,
 
 - Choose between a custom simple relayer node/biconomy.
 
-  - For biconomy, setup a dapp from the dashboard and save the api-id and api-key, see: [Tutorial: Biconomy](https://www.notion.so/Tutorial-Biconomy-7f578bfb4e7d4904b8c79522085ba568) or [https://docs.biconomy.io/](https://docs.biconomy.io/)
+  - For biconomy, setup a dapp from the dashboard and save the api-id and api-key, see: [https://docs.biconomy.io/](https://docs.biconomy.io/)
 
     **Steps:**
 
diff --git a/docs/pos/how-to/smart-contracts/alchemy.md b/docs/pos/how-to/smart-contracts/alchemy.md
@@ -54,7 +54,7 @@ To get your custom Polygon RPC URL from Alchemy, go to your **Hello World** app
 
 ![img](../../../img/pos/view-key.png)
 
-You can download and create a MetaMask account for free [here](https://metamask.io/download.html). Once you've created an account, follow these steps to set up the Polygon PoS network on your wallet.
+You can download and create a MetaMask account for free [here](https://metamask.io/download/). Once you've created an account, follow these steps to set up the Polygon PoS network on your wallet.
 
 1. Select **Settings** from the drop-down menu in the top right corner of your MetaMask wallet.
 2. Select **Networks** from the menu to the left.
@@ -356,7 +356,7 @@ We’ve adopted the Hardhat team explanations to what each of these lines of cod
 const HelloWorld = await ethers.getContractFactory("HelloWorld");
 ```
 
-A `ContractFactory` in ethers.js is an abstraction used to deploy new smart contracts, so `HelloWorld` here is a [factory](https://en.wikipedia.org/wiki/Factory\_\(object-oriented\_programming\)) for instances of our hello world contract. When using the `hardhat-ethers` plugin `ContractFactory` and `Contract`, instances are connected to the first signer (owner) by default.
+A `ContractFactory` in ethers.js is an abstraction used to deploy new smart contracts, so `HelloWorld` here is a [factory](https://en.wikipedia.org/wiki/Factory_(object-oriented_programming)) for instances of our hello world contract. When using the `hardhat-ethers` plugin `ContractFactory` and `Contract`, instances are connected to the first signer (owner) by default.
 
 ```javascript
 const hello_world = await HelloWorld.deploy();
diff --git a/docs/pos/how-to/smart-contracts/getblock.md b/docs/pos/how-to/smart-contracts/getblock.md
@@ -34,7 +34,7 @@ In this tutorial, you will:
 
   ![img](https://storage.getblock.io/web/blog/article-images/imga3.png)
 
-If you don't have any tokens in your account, you can request some from the Mumbai faucet through the [faucet website](https://chat.openai.com/develop/tools/matic-faucet.md).
+If you don't have any tokens in your account, you can request some from the Mumbai faucet through the [faucet website](https://faucet.polygon.technology/).
 
 ## Smart Contract Development
 
diff --git a/docs/pos/operate-node/validator/getting-started.md b/docs/pos/operate-node/validator/getting-started.md
@@ -1,10 +1,3 @@
-
-!!!tip
-    Stay in the know
-
-    Keep up with the latest node and validator updates from the Polygon team and the community by subscribing to [Polygon notifications](https://polygon.technology/notifications/).
-
-
 Validators are the key actor in maintaining the Polygon network. Validators run a full node, secure the network by staking MATIC to produce blocks, validate and participate in PoS consensus.
 
 !!!info
diff --git a/docs/pos/operate-node/validator/kb/how-to.md b/docs/pos/operate-node/validator/kb/how-to.md
@@ -96,7 +96,7 @@ sudo dpkg -i rabbitmq-server_3.10.8-1_all.deb
 
 This document gives some additional details for setting up a new node based on [Full Node Deployment](/operate/full-node-binaries.md) guide.
 
-- VPN setup is required before proceeding with any of these steps can be done by referring [Bastillion user guide](https://www.notion.so/Bastillion-VPN-user-guide-c04f5f26afda4fa59d5d9f6041327f43).
+- VPN setup is required before proceeding with any of these steps.
 - If you are using Macbook, it has native Python 2.7 available which **needs to be replaced by with anything Python 3.x**.
 - Make sure if pip3 packages are installed correctly
 
diff --git a/docs/pos/operate-node/validator/run-validator/packages.md b/docs/pos/operate-node/validator/run-validator/packages.md
@@ -517,7 +517,7 @@ will start the Bor service on the validator machine.
     The Heimdall service takes several days to sync from scratch fully.
 
     Alternatively, you can use a maintained snapshot, which will reduce the sync time to a few hours.
-    For detailed instructions, see [Snapshot Instructions for Heimdall and Bor](https://forum.matic.network/t/snapshot-instructions-for-heimdall-and-bor/2278).
+    For detailed instructions, see [Snapshot Instructions for Heimdall and Bor](https://forum.polygon.technology/t/snapshot-instructions-for-heimdall-and-bor/9233).
 
     For snapshot download links, see [Polygon Chains Snapshots](https://snapshot.polygon.technology/).
 
diff --git a/docs/pos/reference/rpc-endpoints.md b/docs/pos/reference/rpc-endpoints.md
@@ -12,7 +12,7 @@ The Mumbai testnet serves as a replica of the Polygon mainnet and is primarily u
 | Parent chain     | **[Goërli](https://goerli.net/)**                                                                   |
 | Chain ID         | `80001`                                                                                            |
 | Gas token        | MATIC                                                                                  |
-| Gas station      | [Mumbai gas station](https://gasstation-mumbai.matic.today/v2)                                       |
+| Gas station      | [Mumbai gas station](https://gasstation-testnet.polygon.technology/v2)                                       |
 | RPC endpoint     | [https://rpc-mumbai.matic.today](https://rpc-mumbai.matic.today)                                     |
 | Node endpoint    | [wss://rpc-mumbai.matic.today](wss://rpc-mumbai.matic.today)                                        |
 | Heimdall API     | [https://heimdall-api-testnet.polygon.technology](https://heimdall-api-testnet.polygon.technology)   |
@@ -56,7 +56,7 @@ Developers can interact with on-chain data and execute various types of transact
 !!!info
     Getting started with RPC calls
 
-    For a comprehensive list of API documentation, visit [**Polygon JSON-RPC calls**](https://edge-docs.polygon.technology/docs/get-started/json-rpc-commands/).
+    For a comprehensive list of API documentation, visit [**Polygon JSON-RPC calls**](https://github.com/0xPolygon/polygon-edge/tree/develop/docs/docs/api).
 
     To explore API requests without any setup, fix failing requests, or discover new methods on the Polygon network, try the [**Composer App**](https://composer.alchemyapi.io).
 
@@ -70,7 +70,6 @@ Public RPCs may have rate limits or traffic restrictions. For dedicated free RPC
 - [Ankr](https://www.ankr.com/)
 - [Blast (Bware Labs)](https://blastapi.io/)
 - [BlockPI](https://blockpi.io/)
-- [BlockSpaces](https://www.blockspaces.com/web3-infrastructure)
 - [Chainnodes](https://www.chainnodes.org/)
 - [Chainstack](https://chainstack.com/build-better-with-polygon/)
 - [DataHub (Figment)](https://datahub.figment.io)
@@ -79,7 +78,6 @@ Public RPCs may have rate limits or traffic restrictions. For dedicated free RPC
 - [Moralis](https://moralis.io)
 - [NodeReal](https://nodereal.io)
 - [OnFinality](https://onfinality.io/)
-- [Pocket Network](https://www.portal.pokt.network/)
 - [QuickNode](https://www.quicknode.com/chains/matic)
 - [SettleMint](https://docs.settlemint.com/docs/polygon-connect-to-a-node)
 - [Tatum](https://tatum.io/)
diff --git a/docs/tools/data/the-graph/data.md b/docs/tools/data/the-graph/data.md
@@ -16,6 +16,6 @@ The PolygonRoot subgraph works by listening for events emitted by one or more da
 - [Managing your API Key & setting your indexer preferences](https://thegraph.com/docs/en/studio/managing-api-keys/).
 - [Querying from an application](https://thegraph.com/docs/en/developer/querying-from-your-app/).
 - [How to use the explorer and playground to query on-chain data](https://medium.com/@chidubem_/how-to-query-on-chain-data-with-the-graph-f8507488215).
-- [Explorer page](https://thegraph.com/explorer/subgraph?id=FDrqtqbp8LhG1hSnwtWB2hE6C97FWA54irrozjb2TtMH&view=Overview).
+- [Explorer page](https://thegraph.com/explorer/).
 - GraphQL Endpoint: <https://gateway.thegraph.com/api/[api-key]/subgraphs/id/FDrqtqbp8LhG1hSnwtWB2hE6C97FWA54irrozjb2TtMH>.
 - [Code repo](https://github.com/maticnetwork/subgraphs).
diff --git a/docs/tools/oracles/bandchain.md b/docs/tools/oracles/bandchain.md
@@ -6,23 +6,23 @@ Band Protocol allows you to query data from traditional web APIs and use it in t
 
 1. **Choosing the oracle scripts**
 
-    Oracle script is a hash that uniquely identifies the type of data to be requested from band-chain. These scripts can be found [**here**](https://guanyu-devnet.cosmoscan.io/oracle-scripts). These scripts are used as one of the parameters while making the oracle request.
+    Oracle script is a hash that uniquely identifies the type of data to be requested from band-chain. These scripts are used as one of the parameters while making the oracle request.
 
 2. **Requesting data from BandChain**
 
     This can be done in two ways:
 
     - **Using the BandChain explorer**
 
-        You can click on the oracle script of your choice, and then from the **Execute** tab you can pass in the parameters and get the response from BandChain. The response will contain the result and also an EVM proof. This proof has to be copied and will be used in the final step. The BandChain docs for querying oracle using explorer are available [**here**](https://docs.bandchain.org/dapp-developers/requesting-data-from-bandchain/requesting-data-via-explorer).
+        You can click on the oracle script of your choice, and then from the **Execute** tab you can pass in the parameters and get the response from BandChain. The response will contain the result and also an EVM proof. This proof has to be copied and will be used in the final step. The BandChain docs for querying oracle using explorer are available [**here**](hthttps://docs.bandchain.org/develop/custom-scripts/data-source/introduction).
 
         ![img](../../img/tools/oracles/bandchain/executeoracle.png)
 
         Given above is an example of making an oracle request to get the random number values. The value 100 is passed to the `max_range` parameter of the oracle request. We get a hash in response. Clicking on this hash will show us the complete details of the response.
 
     - **Using the BandChain-Devnet JS library**
 
-        You can query BandChain directly using the BandChain-Devnet library. When queried, it gives an **EVM proof** in the response. This proof can be used for the final step of BandChain integration. The BandChain docs for querying oracle using BandChain-Devnet JS Library is available [**here**](https://docs.bandchain.org/dapp-developers/requesting-data-from-bandchain/requesting-data-via-js-library). The request payload for the random number oracle will look like this. Make sure the request body is passed in application/json format.
+        You can query BandChain directly using the BandChain-Devnet library. When queried, it gives an **EVM proof** in the response. This proof can be used for the final step of BandChain integration. The BandChain docs for querying oracle using BandChain-Devnet JS Library is available [**here**](https://docs.bandchain.org/develop/custom-scripts/data-source/introduction). The request payload for the random number oracle will look like this. Make sure the request body is passed in application/json format.
 
 3. **Using the data in smart contracts**
 
@@ -69,10 +69,10 @@ Band Protocol allows you to query data from traditional web APIs and use it in t
   }
   ```
 
-  When deploying, 3 parameters have to be passed. The **first parameter** is the `codeHash` which is the oracle script hash. The **second parameter** is the oracle script request parameters object. This has to be passed in bytes format. BandChain provides a REST API for converting the parameter JSON object to bytes format. The API details can be found [**here**](https://docs.bandchain.org/references/encoding-params). A 0x has to be appended to the response received from this API. The **third parameter** is the contract address of the BandChain contract that is already deployed on the Polygon network. Band Protocol supports Polygon TestnetV3: 0x3ba819b03fb8d34995f68304946eefa6dcff7cbf.
-
-  Another thing to note is that the validation contract should import the helper library and interface which is called `BandChainLib.sol` and `IBridge.sol` respectively. They can be found in the following links: [**Bandchain**](https://docs.bandchain.org/references/bandchainlib-library) Library and [**IBridge**](https://docs.bandchain.org/references/ibridge-interface) interface.
+  When deploying, 3 parameters have to be passed. The **first parameter** is the `codeHash` which is the oracle script hash. The **second parameter** is the oracle script request parameters object. This has to be passed in bytes format. BandChain provides a REST API for converting the parameter JSON object to bytes format. The API details can be found [**here**](https://docs.bandchain.org/develop/developer-guides/obi). A 0x has to be appended to the response received from this API. The **third parameter** is the contract address of the BandChain contract that is already deployed on the Polygon network. Band Protocol supports Polygon TestnetV3: 0x3ba819b03fb8d34995f68304946eefa6dcff7cbf.
 
+  Another thing to note is that the validation contract should import the helper library and interface which is called `BandChainLib.sol` and `IBridge.sol` respectively. 
+  
   Once the validation contract is deployed, the state variables can be accessed by querying from a dApp. Similarly multiple validation contracts can be created for different in-built oracle scripts. The IBridge interface has a method called `relayAndVerify()` that verifies the values being updated each time in the validation contract. The `update()` method in the validation contract has the logic to update the state variables. The EVM proof obtained from querying the oracle script has to be passed to the `update()` method. Each time a value is updated, the BandChain contract deployed on Polygon verifies the data before storing it in the contract state variable.
 
   The BandChain provides a decentralized network of oracles that can be used by dApps to boost their smart contract logic. The BandChain docs on deploying the contract, storing the values, and updating them can be found [**here**](https://docs.bandchain.org/dapp-developers/requesting-data-from-bandchain/requesting-data-via-js-library).
diff --git a/docs/tools/oracles/bandstandarddataset.md b/docs/tools/oracles/bandstandarddataset.md
@@ -6,7 +6,7 @@ Developers building on Polygon can now leverage Band Protocol's decentralized or
 
 ## Supported tokens
 
-Currently, the list of supported symbols can be found at [data.bandprotocol.com](http://data.bandprotcool.com). Going forward, this list will continue to expand based on developer needs and community feedback.
+Currently, the list of supported symbols can be found at [https://data.bandprotocol.com/](https://data.bandprotocol.com/). Going forward, this list will continue to expand based on developer needs and community feedback.
 
 ## Price pairs
 
diff --git a/docs/tools/oracles/getting-started.md b/docs/tools/oracles/getting-started.md
@@ -8,6 +8,5 @@ Inbound oracles bring off-chain or real-world data to the blockchain, whereas th
 
 1. [What is the blockchain oracle problem?](https://blog.chain.link/what-is-the-blockchain-oracle-problem/).
 1. [What is Blockchain Oracle](https://cryptobriefing.com/what-is-blockchain-oracle/).
-2. [Types of Blockchain Oracle](https://blockchainhub.net/blockchain-oracles/).
+2. [Types of Blockchain Oracle](http://blockchainhub.net/blockchain-oracles/).
 3. [Tutorial: Getting decentralized price data](https://docs.chain.link/docs/get-the-latest-price).
-4. [Tutorial: How to integrate Razor on Polygon](https://docs.razor.network/tutorial/matic/).
diff --git a/docs/tools/smart-contracts/replit.md b/docs/tools/smart-contracts/replit.md
@@ -1,6 +1,6 @@
 ## Overview
 
-[Replit](https://docs.replit.com/tutorials/01-introduction-to-the-repl-it-ide) is a coding platform that allows you to write code and host apps. Replit supports [Solidity programming language](https://replit.com/@replit/Solidity-starter-beta?v=1) so it provides all of the features and functionality for Web3 developers to create and deploy smart contracts.
+[Replit](https://docs.replit.com/) is a coding platform that allows you to write code and host apps. Replit supports Solidity so it provides all of the features and functionality for Web3 developers to create and deploy smart contracts.
 
 This article guides you to build and deploy a solidity smart contract on Polygon using [Replit IDE](https://replit.com/signup) and [Replit Solidity development template (Solidity starter beta)](https://replit.com/@replit/Solidity-starter-beta?v=1).
 
@@ -14,7 +14,7 @@ This article guides you to build and deploy a solidity smart contract on Polygon
 
 !!! tip
 
-    For additional examples about Solidity with Replit, you can read the article [Get started with Replit](https://blog.replit.com/solidity) or check [Replit Solidity documentation and Escrow contract tutorial](https://docs.replit.com/tutorials/33-escrow-contract-with-solidity).
+    For additional examples about Solidity with Replit, you can read the article [Get started with Replit](https://blog.replit.com/solidity).
 
 ## Prerequisites
 
diff --git a/docs/tools/storage/nftstorage.md b/docs/tools/storage/nftstorage.md
@@ -310,8 +310,6 @@ You can expect to see the following output:
 NFT minted to: 0x<YOUR_WALLET_ADDRESS>
 ```
 
-Looking for the sample code from this tutorial? You can find it in the polygon-nft.storage-demo [link](https://github.com/itsPiyushMaheshwari/Polygon-nft.storage-demo) Github repo.
-
 ## Conclusion
 
 In this tutorial, we learned how to mint a NFT end-to-end with Polygon and NFT.Storage. This technology combination results in proper decentralization and guarantees *scalability*, *durability*, and *immutability*.
diff --git a/docs/zkEVM/architecture/zkprover/binary-sm.md b/docs/zkEVM/architecture/zkprover/binary-sm.md
@@ -474,7 +474,7 @@ The binary operations it executes, together with their specific opcodes, are:
 
 **Secondly,** it executes the Binary Actions.
 
-**And thirdly,** it uses the [Binary PIL program](https://github.com/hermeznetwork/zkproverjs/blob/main/pil/binary.pil), to check correct execution of the Binary Actions using Plookup.
+**And thirdly,** it uses the [Binary PIL program](https://github.com/0xPolygonHermez/zkevm-proverjs/blob/main/pil/binary.pil), to check correct execution of the Binary Actions using Plookup.
 
 #### Translation to PIL language
 
diff --git a/docs/zkEVM/architecture/zkprover/hashing-state-machines/index.md b/docs/zkEVM/architecture/zkprover/hashing-state-machines/index.md
diff --git a/mkdocs.yml b/mkdocs.yml
diff --git a/requirements.txt b/requirements.txt

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		-Heimdall's governance operates identically to the Cosmos-sdk `x/gov` module, as detailed in [Cosmos-sdk documentation](https://docs.cosmos.network/master/modules/gov/).
	`1`	+Heimdall's governance operates identically to the Cosmos-sdk `x/gov` module, as detailed in [Cosmos-sdk documentation](https://docs.cosmos.network/main/build/modules/gov).
`2`	`2`
`3`	`3`	`## Overview`
`4`	`4`