Merge pull request #207 from rsksmart/docs/maintenance-dec-updates

Docs: Maintenance updates for December

changelog/2024-11-05-introducing-arrowhead-6.4.0.md

@@ -5,6 +5,8 @@ tags: [release, arrowhead]
 url: https://blog.rootstock.io/noticia/arrowhead-6-4-0-introducing-fiat-stable-minimum-gas-price/
 ---
 
-**Summary**: The Rootstock community is pleased to announce the release of the latest version of the RSKj client, which is now available in the [RSKj GitHub repository](https://github.com/rsksmart/rskj/releases/tag/ARROWHEAD-6.4.0). This update introduces the **fiat-stable minimum gas price feature** (disabled by default), enabling mining pools to automatically adjust their minimum gas price configuration based on the price of Bitcoin. Additionally, it includes JSON-RPC interface improvements and dependency upgrades, now supporting **Java 21 LTS**.
+**Summary**: 
+
+The Rootstock community is pleased to announce the release of the latest version of the RSKj client, which is now available in the [RSKj GitHub repository](https://github.com/rsksmart/rskj/releases/tag/ARROWHEAD-6.4.0). This update introduces the **fiat-stable minimum gas price feature** (disabled by default), enabling mining pools to automatically adjust their minimum gas price configuration based on the price of Bitcoin. Additionally, it includes JSON-RPC interface improvements and dependency upgrades, now supporting **Java 21 LTS**.
 
 > Note that this upgrade is optional, however it is strongly recommended that users update their nodes to the latest version to benefit from enhanced performance and security.

changelog/2024-12-06-introducing-arrowhead-6.5.0.md

@@ -0,0 +1,12 @@
+---
+title: "Introducing Arrowhead 6.5.0"
+author: Rootstock
+tags: [release, arrowhead]
+url: https://blog.rootstock.io/noticia/rootstock-arrowhead-6-5-0-optimizing-developer-experience/
+---
+
+**Summary**: 
+
+The Rootstock community is pleased to announce the release of the latest version of the RSKj client, which is now available in the [RSKj GitHub repository](https://github.com/rsksmart/rskj/releases/tag/ARROWHEAD-6.5.0). This update features new debugging methods and other improvements to the JSON-RPC interface, designed to optimize the developer experience.
+
+> Note that this upgrade is optional, however it is strongly recommended that users update their nodes to the latest version to benefit from enhanced performance and security.

docs/01-concepts/glossary.md

@@ -3,7 +3,7 @@ sidebar_position: 1.5
 title: Glossary | Key Terms and Definitions
 sidebar_label: Glossary
 tags: [rsk, rootstock, developer tools, courses, guides, tutorials, glossary]
-description: "This glossary contains key terms and definitions to help you better understand the technologies and concepts related to Rootstock."
+description: "This glossary provides essential definitions for key terms related to Rootstock and blockchain technology."
 ---
 # Glossary | Key Terms and Definitions
 
@@ -163,7 +163,8 @@ This is a platform where users can trade cryptocurrencies and other digital asse
 
 This is a tool that distributes small amounts of cryptocurrency for testing purposes on test networks, allowing developers and users to experiment without financial risk. In the context of Rootstock, faucets can be used to obtain test RBTC (tRBTC), enabling developers to test their applications in a realistic environment. This practice is crucial for ensuring that dApps function correctly before deployment on the mainnet.
 
-<Button size="sm" href="https://faucet.rootstock.io/">Get tRBTC</Button>
+<Button size="sm" href="/dev-tools/additional-tools/#faucets">Get tRBTC</Button>
+
 <br/>
 <br/>
 

docs/01-concepts/index.md

@@ -16,6 +16,7 @@ This section equips you with the fundamental knowledge required to navigate the
 | ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
 | [Rootstock Blockchain Overview](/concepts/fundamentals/) | Gain a comprehensive understanding of the Rootstock platform. |
 | [Rootstock Stack](/concepts/fundamentals/stack/) |  Learn about how Rootstock combines the security of Bitcoin PoW with Ethereum's smart contract functionality.|
+| [Glossary](/concepts/glossary/) |  This glossary provides essential definitions for key terms related to Rootstock and blockchain technology.|
 | [RBTC Token](/concepts/rbtc/) | The RBTC token fuels transactions on the Rootstock network. Converting BTC to RBTC is straightforward using various methods. Visit the RBTC section for a comprehensive list of exchanges and applications facilitating RBTC acquisition. Visit the [RBTC section](https://rootstock.io/rbtc/) for a list of exchanges and apps to get RBTC.|
 | [RIF Suite](/concepts/rif-suite/) | Learn about the Rootstock Infrastructure Framework, a comprehensive set of Open-source tools and technologies designed to streamline and incentivize development on Bitcoin.|
 | [Rootstock Security](/concepts/powpeg/security-model/) | The Rootstock platform uses a security mechanism called the [Powpeg](/concepts/powpeg/), it is based on a layered security model, called “defence-in-depth”.|

docs/01-concepts/rbtc/conversion-with-ledger.md

@@ -15,7 +15,7 @@ In this section, we will go over the steps of converting BTC to RBTC using Ledge
   [Ledger Live](https://www.ledger.com/ledger-live)
   and review this tutorial:
 - You need to have [Electrum](https://electrum.org/).
-  Install it and [configure it to be used with Ledger](https://support.ledgerwallet.com/hc/en-us/articles/115005161925-Set-up-and-use-Electrum).
+  Install it and [configure it to be used with Ledger](https://support.ledger.com/article/115005161925-zd).
 - Node >= 10.16.0
 
 ## BTC to RBTC conversion
@@ -28,7 +28,7 @@ We recommend to use Electrum BTC wallet for connecting to
 BTC Mainnet using Ledger hardware wallet.
 
 - Download the wallet from
-  [Electrum Website](https://bitzuma.com/posts/a-beginners-guide-to-the-electrum-bitcoin-wallet/)
+  [Electrum Website](https://coingate.com/blog/post/setup-electrum-guide)
 - Install Electrum
 - Connect and unlock your Ledger device.
 - Open the Bitcoin app

docs/01-concepts/rbtc/index.md

@@ -7,6 +7,13 @@ sidebar_label: RBTC Token
 
 RBTC is the token used to [pay for the execution](/concepts/rbtc/gas/) of transactions in Rootstock. You can [convert BTC into RBTC](conversion.md) by sending BTC through the [Powpeg](/concepts/powpeg/) (both in Testnet and Mainnet), or by using the [faucet in Testnet](https://faucet.rootstock.io/), or via decentralized exchanges.
 
+:::info[Additional Faucet Options (Please note these faucets may have daily limits)]
+
+* Use [Thirdweb Faucet](https://thirdweb.com/rootstock-testnet): This faucet offers a convenient way to get free test RBTC tokens for development and testing. Its max daily token allocation is `0.01` tRBTC.
+* Use [Blast Faucet](https://blastapi.io/faucets/rootstock-testnet): This faucet offers a convenient way to get free test RBTC tokens for development and testing. It has a higher max daily token allocation of `0.1` tRBTC.
+
+:::
+
 See [supported wallets](/dev-tools/wallets/).
 
 <Button href="https://rootstock.io/rbtc/#get-rbtc">Get RBTC</Button>

docs/02-developers/02-requirements/index.md

@@ -21,7 +21,6 @@ This guide provides clear instructions for developers on the supported Solidity
  <Step title="Software Requirements:">
 
 
-
 Set up the necessary software for a seamless development experience:  
 
 - **Solidity Version:**  

docs/02-developers/03-blockchain-essentials/03-browser/index.md

@@ -91,6 +91,13 @@ This is currently zero, which means that we cannot send any transactions to the
 
 Now you should have a balance of tRBTC, and you will be able to send transactions on the Rootstock Testnet!
 
+:::info[Additional Faucet Options (Please note these faucets may have daily limits)]
+
+* Use [Thirdweb Faucet](https://thirdweb.com/rootstock-testnet): This faucet offers a convenient way to get free test RBTC tokens for development and testing. Its max daily token allocation is `0.01` tRBTC.
+* Use [Blast Faucet](https://blastapi.io/faucets/rootstock-testnet): This faucet offers a convenient way to get free test RBTC tokens for development and testing. It has a higher max daily token allocation of `0.1` tRBTC.
+
+:::
+
 ## Configure Custom Token for tRIF
 
 The Rootstock Infrastructure Framework (RIF) includes multiple services for decentralised applications.

docs/02-developers/04-quickstart/ape.md

@@ -14,7 +14,7 @@ In this guide, we will learn about the [Ape Framework](https://apeworx.io/framew
 To get started with Ape, ensure the following tools are installed:
 - Linux or macOS
 - Python 3.9 up to 3.12
-- Windows: Install Windows Subsystem Linux [(WSL](https://learn.microsoft.com/en-us/windows/wsl/install))
+- Windows: Install Windows Subsystem Linux [(WSL](https://learn.microsoft.com/en-us/windows/wsl/install)
 - Check the python version in a terminal with python3 --version.
 
 ## Create a Ape project
@@ -99,7 +99,7 @@ If you do not want to see your mnemonic, select `n`. Alternatively, use the `--h
 
 :::warning[Warning]
 
-Don't forget to add funds to the account generated. To get tRBTC, use the [Rootstock Faucet](https://faucet.rootstock.io/).
+Don't forget to add funds to the account generated. To get tRBTC, use the [Rootstock Faucet](https://faucet.rootstock.io/). Additional faucet options include; [Thirdweb](https://thirdweb.com/rootstock-testnet) and [Blast](https://blastapi.io/faucets/rootstock-testnet) Faucets.
 
 To import an existing account check [Importing Existing Accounts](https://docs.apeworx.io/ape/stable/userguides/accounts.html#importing-existing-accounts) documentation.
 

docs/02-developers/05-smart-contracts/02-hardhat/configure-hardhat-rootstock.md

@@ -75,4 +75,4 @@ To configure your `rskMainnet` and `rskTestnet` private keys, you'll need to upd
 - Mainnet
   - You'll need RBTC, which you can obtain from an exchange. See [Get RBTC using Exchanges](https://rootstock.io/rbtc/).
 - Testnet
-  - You can get tRBTC from the [Rootstock Faucet](https://faucet.rootstock.io/).
+  - You can get tRBTC from the [Rootstock Faucet](https://faucet.rootstock.io/). Additional faucet options include; [Thirdweb](https://thirdweb.com/rootstock-testnet) and [Blast](https://blastapi.io/faucets/rootstock-testnet) Faucets.

docs/02-developers/06-integrate/01-rif-relay/deployment.md

@@ -56,7 +56,7 @@ After deployment, you'll see a summary of the deployed contracts. This summary i
 The deployment summary shows two sets of Smart Wallets, each paired with its verifiers. This is because the verifier is used for both deployment and transaction validation. For testing purposes, the focus will be on using these Smart Wallet Contracts.
 
 #### Testnet
-1. Ensure your account is funded. You can get funds from the [tRBTC Faucet](https://faucet.rootstock.io/).
+1. Ensure your account is funded. You can get funds from the [tRBTC Faucet](https://faucet.rootstock.io/). Additional faucet options include; [Thirdweb](https://thirdweb.com/rootstock-testnet) and [Blast](https://blastapi.io/faucets/rootstock-testnet) Faucets.
 2. Deploy on Testnet:
     ```bash
       npx hardhat deploy --network testnet

docs/02-developers/08-libraries/01-rsk-precompiled-abis/index.md

@@ -84,3 +84,5 @@ If the version to be installed is not defined in the command line, the version w
 | 6.3.0-ARROWHEAD | ARROWHEAD-6.3.0 |
 | 6.3.1-ARROWHEAD | ARROWHEAD-6.3.1 |
 | 6.4.0-ARROWHEAD | ARROWHEAD-6.4.0 |
+| 6.5.0-ARROWHEAD | ARROWHEAD-6.5.0 |
+

docs/03-node-operators/04-setup/02-installation/java.md

@@ -13,7 +13,7 @@ To setup a Rootstock node using Java, you need to:
 
 :::warning[Important]
 
-Starting with v6.4.0, the minimum supported Java LTS version is Java 17. Previous Java versions will no longer be supported.
+Starting with [v6.4.0](/changelog/2024-11-05-introducing-arrowhead-6.4.0/), the minimum supported Java LTS version is Java 17. Previous Java versions will no longer be supported.
 
 :::
 
@@ -41,7 +41,7 @@ cd ~/rskj-node-jar
 ```
 3. **Move the JAR**: Move or copy the just downloaded jar file to your directory.
 ```jsx
-mv ~/Downloads/rskj-core-6.4.0-ARROWHEAD-all.jar SHA256SUMS.asc /Users/{user}/rskj-node-jar/
+mv ~/Downloads/rskj-core-6.5.0-ARROWHEAD-all.jar SHA256SUMS.asc /Users/{user}/rskj-node-jar/
 ```
 
 <!-- ### Configuration
@@ -69,7 +69,7 @@ mv ~/Downloads/rskj-core-6.4.0-ARROWHEAD-all.jar SHA256SUMS.asc /Users/{user}/rs
 
 :::tip[Tip]
 
-Replace `<PATH-TO-THE-RSKJ-JAR>` with the actual path to your JAR file. For example, `C:/RskjCode/rskj-core-6.4.0-ARROWHEAD-all.jar`.
+Replace `<PATH-TO-THE-RSKJ-JAR>` with the actual path to your JAR file. For example, `C:/RskjCode/rskj-core-6.5.0-ARROWHEAD-all.jar`.
 :::
 
 ## Using Import Sync
@@ -136,7 +136,7 @@ After starting the node, if there's no output, this means it's running correctly
 Output:
 
 ```shell
-{"jsonrpc":"2.0","id":67,"result":"RskJ/6.4.0/Mac OS X/Java21/ARROWHEAD-e016b25"}
+{"jsonrpc":"2.0","id":67,"result":"RskJ/6.5.0/Mac OS X/Java21/ARROWHEAD-e016b25"}
 ```
 
 2. To check the block number:

docs/03-node-operators/04-setup/02-installation/ubuntu.md

@@ -39,16 +39,16 @@ Choose `mainnet` and press `Enter` to continue
 
 ## Install via Direct Downloads
 
-You can also download the RSKj Ubuntu Package for the latest RSKj release `ARROWHEAD 6.4.0` and install it with the `dpkg` command. Follow this [download link](https://launchpad.net/~rsksmart/+archive/ubuntu/rskj/+packages) to download the matching package for your ubuntu system.
+You can also download the RSKj Ubuntu Package for the latest RSKj release `ARROWHEAD 6.5.0` and install it with the `dpkg` command. Follow this [download link](https://launchpad.net/~rsksmart/+archive/ubuntu/rskj/+packages) to download the matching package for your ubuntu system.
 
 ```shell
 # first install openjdk-17-jre or oracle-java17-installer
 sudo apt-get install openjdk-17-jre
 
-# download the RSKj package and find the file rskj-6.4.0~UBUNTU_VERSION_NAME_amd64.deb
+# download the RSKj package and find the file rskj-6.5.0~UBUNTU_VERSION_NAME_amd64.deb
 
 # run this command in the same directory as the deb file above
-dpkg -i rskj-6.4.0~UBUNTU_VERSION_NAME_amd64.deb
+dpkg -i rskj-6.5.0~UBUNTU_VERSION_NAME_amd64.deb
 ```
 
 We recommend that you check that the SHA256 hash of the downloaded package file matches, prior to installation:

docs/03-node-operators/04-setup/04-node-runner/linux.md

@@ -24,7 +24,7 @@ Recommended IDEs:
 
 :::warning[Important]
 
-Starting with v6.4.0, the minimum supported Java LTS version is Java 17. Previous Java versions will no longer be supported.
+Starting with [v6.4.0](/changelog/2024-11-05-introducing-arrowhead-6.4.0/), the minimum supported Java LTS version is Java 17. Previous Java versions will no longer be supported.
 
 :::
 
@@ -37,7 +37,7 @@ Run these commands in the terminal:
 ```shell
 git clone --recursive https://github.com/rsksmart/rskj.git
 cd rskj
-git checkout tags/ARROWHEAD-6.4.0 -b ARROWHEAD-6.4.0
+git checkout tags/ARROWHEAD-6.5.0 -b ARROWHEAD-6.5.0
 ```
 
 *Note:* It is better to download the code into a short path.

docs/03-node-operators/04-setup/04-node-runner/macos.md

@@ -42,7 +42,7 @@ Run these commands on Git command line:
 ```shell
 git clone --recursive https://github.com/rsksmart/rskj.git
 cd rskj
-git checkout tags/ARROWHEAD-6.4.0 -b ARROWHEAD-6.4.0
+git checkout tags/ARROWHEAD-6.5.0 -b ARROWHEAD-6.5.0
 ```
 
 *Note:* It is better to download the code into a short path.

docs/03-node-operators/04-setup/reproducible-build.md

@@ -14,7 +14,7 @@ It's highly recommended to follow the steps by yourself to avoid contamination o
 
 :::warning[Important]
 
-Starting with v6.4.0, the minimum supported Java LTS version is Java 17. Previous Java versions will no longer be supported. The following example for Linux OS is showing instructions for v6.3.1, and thus uses jdk 8, this must be replaced by jdk 17 for v6.4.0 and up.
+Starting with [v6.4.0](/changelog/2024-11-05-introducing-arrowhead-6.4.0.md), the minimum supported Java LTS version is Java 17. Previous Java versions will no longer be supported. The following example for Linux OS is showing instructions for v6.3.1, and thus uses jdk 8, this must be replaced by jdk 17 for v6.4.0 and up.
 
 :::
 
@@ -50,9 +50,9 @@ Create a ```Dockerfile``` to setup the build environment.
           apt-get clean
         gpg --keyserver https://secchannel.rsk.co/release.asc --recv-keys 1A92D8942171AFA951A857365DECF4415E3B8FA4
         gpg --finger 1A92D8942171AFA951A857365DECF4415E3B8FA4
-        git clone --single-branch --depth 1 --branch ARROWHEAD-6.4.0 https://github.com/rsksmart/rskj.git /code/rskj
+        git clone --single-branch --depth 1 --branch ARROWHEAD-6.5.0 https://github.com/rsksmart/rskj.git /code/rskj
         git clone https://github.com/rsksmart/reproducible-builds 
-        CP /Users/{$USER}/reproducible-builds/rskj/6.4.0-arrowhead/Dockerfile  /Users/{$USER}/code/rskj
+        CP /Users/{$USER}/reproducible-builds/rskj/6.5.0-arrowhead/Dockerfile  /Users/{$USER}/code/rskj
         WORKDIR /code/rskj
         gpg --verify SHA256SUMS.asc
         sha256sum --check SHA256SUMS.asc
@@ -69,10 +69,10 @@ Create a ```Dockerfile``` to setup the build environment.
           brew cleanup
         gpg --keyserver https://secchannel.rsk.co/release.asc --recv-keys 1A92D8942171AFA951A857365DECF4415E3B8FA4
         gpg --finger 1A92D8942171AFA951A857365DECF4415E3B8FA4
-        git clone --single-branch --depth 1 --branch ARROWHEAD-6.4.0 https://github.com/rsksmart/rskj.git ./code/rskj
+        git clone --single-branch --depth 1 --branch ARROWHEAD-6.5.0 https://github.com/rsksmart/rskj.git ./code/rskj
         git clone https://github.com/rsksmart/reproducible-builds 
-        CP /Users/{$USER}/reproducible-builds/rskj/6.4.0-arrowhead/Dockerfile  /Users/{$USER}/code/rskj
-        cd /code/rskj
+        CP /Users/{$USER}/reproducible-builds/rskj/6.5.0-arrowhead/Dockerfile  /Users/{$USER}/code/rskj
+        cd ./code/rskj
         gpg --verify SHA256SUMS.asc
         sha256sum --check SHA256SUMS.asc
         ./configure.sh
@@ -106,7 +106,7 @@ If you are not familiar with Docker or the ```Dockerfile``` format: what this do
 To create a reproducible build, run the command below in the same directory:
 
 ```bash
-docker build -t rskj/6.4.0-arrowhead .     
+docker build -t rskj/6.5.0-arrowhead .     
 ```
 
 :::danger[Error]
@@ -127,7 +127,7 @@ This may take several minutes to complete. What is done is:
 The last step of the build prints the `sha256sum` of the files, to obtain `SHA-256` checksums, run the following command in the same directory as shown above:
 
 ```bash
-docker run --rm rskj/6.4.0-arrowhead sh -c 'sha256sum * | grep -v javadoc.jar'
+docker run --rm rskj/6.5.0-arrowhead sh -c 'sha256sum * | grep -v javadoc.jar'
 ```
 
 ## Check Results
@@ -137,11 +137,11 @@ After running the build process, a JAR file will be created in ```/rskj/rskj-cor
 You can check the SHA256 sum of the result file and compare it to the one published by Rootstock for that version.
 
 ```bash
-269c6416759ff8979e6bc6a6b1ae96ab95705f1c397df06b160a9f2070a373ce  rskj-core-6.4.0-ARROWHEAD-all.jar
-cb4ecbcf4654d97177389f5505764e3cc9ef5b5f87f7aca2956151c71416d315  rskj-core-6.4.0-ARROWHEAD-sources.jar
-bbc0fc1bb7e865c9e11eb78317db32592c9b7dfd8a6818890729af5827a66237  rskj-core-6.4.0-ARROWHEAD.jar
-fabf8af48c167d42d290e9fa44f80b76b96cd403b56c4c87f8df23fd0ea3c9f0  rskj-core-6.4.0-ARROWHEAD.module
-6dbc8153d510d4e910759e2e76cf40f9c0635185f66aa612dac4b2c8a60d0c63  rskj-core-6.4.0-ARROWHEAD.pom
+294f99ec76befa7d9ef18eca28d0c884ceb463ce855ef23ddb7a476e551ba191  rskj-core-6.5.0-ARROWHEAD-all.jar
+ec4ea3143fb95fbf878b24c8d00ebe5994c4586ecf92930743b26dc77395c17a  rskj-core-6.5.0-ARROWHEAD-sources.jar
+7721f59632d9ff825b0bb23cf52fa3eff347852068a03d792ce18d0deae547ae  rskj-core-6.5.0-ARROWHEAD.jar
+16283f4aebbf5b5b35c63f098d81fb0d2aeb5e9fc3be51128ab300333127077f  rskj-core-6.5.0-ARROWHEAD.module
+ee4f7e684044302e3819f8c50d9b85af5b3391d14e6ed6110b98e8387a1b2837  rskj-core-6.5.0-ARROWHEAD.pom
 ```
 
 For SHA256 sum of older versions check the [releases page](https://github.com/rsksmart/rskj/releases).

docs/03-node-operators/08-public-nodes/index.md

@@ -16,7 +16,7 @@ and in accordance with the bitcoiners' maxim: **Don't trust. Verify.**
 
 :::info[RPC Node Providers]
 The Rootstock public nodes do not expose WebSockets, they are `HTTP` only.
-To work around this, you may either [run your own Rootstock node](/node-operators/setup/node-runner/), or use the [Rootstock RPC API](/developers/rpc-api/rootstock/setup/) or use a third-party node provider, such as [Getblock](https://getblock.io/nodes/rsk/), [NowNodes](https://nownodes.io/nodes/rsk) or [dRPC](https://drpc.org/chainlist/rootstock?utm_source=docs&utm_medium=rootstock).
+To work around this, you may either [run your own Rootstock node](/node-operators/setup/node-runner/), or use the [Rootstock RPC API](/developers/rpc-api/rootstock/setup/) or use a third-party node provider, such as [Getblock](https://getblock.io/nodes/rsk/), [NowNodes](https://nownodes.io/nodes/rsk), [dRPC](https://drpc.org/chainlist/rootstock?utm_source=docs&utm_medium=rootstock) or [Blast API](https://blastapi.io/).
 :::
 
 ## Testnet