Skip to content
This repository has been archived by the owner on Sep 11, 2024. It is now read-only.

Adding testnet node/wallet guide #226

Merged
merged 7 commits into from
May 6, 2024
Merged
Show file tree
Hide file tree
Changes from 3 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
1 change: 1 addition & 0 deletions website/_i18n/en.yml
Original file line number Diff line number Diff line change
Expand Up @@ -450,6 +450,7 @@ dict:
run_pactus_docker: How to run Pactus using Docker?
send_transactions_gui: How to send transactions in Graphic Mode?
use_wallet_cli: How to use wallet in Command Line Mode?
pactus_testnet: How to use and interact with Pactus testnet (Pheonix)?
kehiy marked this conversation as resolved.
Show resolved Hide resolved
reduce_network: How to reduce the network usage?
run_pactus_metrics: How to run Pactus Metrics?
grpc-sign-transactions: How to sign transaction using gRPC?
Expand Down
96 changes: 96 additions & 0 deletions website/_i18n/en/user-guides/pactus-testnet/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,96 @@
---
version: 8
---

## Preface

Pactus Blockchain has a Test network for developers to test their software which is using Pactus, users
kehiy marked this conversation as resolved.
Show resolved Hide resolved
that are wiling to test Pactus, etc. This testnet is called Phoenix and you can interact with
phoenix with official Pactus pieces of software that you use for main network. In this guide we are
going to show how you can use them to connect and interact with Phoenix.

## Download

To get started, download and extract the Pactus software
[here]({{ site.baseurl }}/download).
Once you have downloaded and extracted the Pactus software file, you can proceed to the next step.

---

## Phoenix network
kehiy marked this conversation as resolved.
Show resolved Hide resolved

Pactus has 3 different genesis block types for mainnet, testnet and localnet (used for setting up
kehiy marked this conversation as resolved.
Show resolved Hide resolved
dev environment). this genesis type is determined in your Pactus working directory and your wallet
file once you made or initialized it. the rest of commands can find-out the network type based on
this and there is no need to specify which network you are using.

## CLI Softwares

To interact with pheonix using wallet, daemon CLI, there is a flag called `--testnet` provided on
kehiy marked this conversation as resolved.
Show resolved Hide resolved
all CLI softwares.

{% tabs create_wallet ltr %}

{% tab create_wallet linux-mac <i class="fa-brands fa-linux"></i> Linux / <i class="fa-brands fa-apple"></i> macOS %}

```text
./pactus-wallet create --testnet
./pactus-daemon init --testnet
```

{% endtab %}

{% tab create_wallet windows <i class="fa-brands fa-windows"></i> Windows %}

```text
pactus-wallet.exe create --testnet
pactus-daemon.exe init --testnet
```

{% endtab %}

{% endtabs %}

You can use this flag for recover command as well.

{% alert_start info %}
<b>Wallet Address</b>
<br><br>
Pactus address have pc HRP on mainnet and a tpc HRP on testnet. any address with pc prefix is invalid
kehiy marked this conversation as resolved.
Show resolved Hide resolved
on testnet.
<br><br>
You can check pip-8 for more details on Pactus address.
{% alert_end %}

## GUI Node and wallet
kehiy marked this conversation as resolved.
Show resolved Hide resolved

Pactus also offers a GUI to run a node, if you want to use GUI as a testnet node you have to run it
wit the same flag in your terminal.
kehiy marked this conversation as resolved.
Show resolved Hide resolved

{% tabs gui_node ltr %}

{% tab gui_node linux-mac <i class="fa-brands fa-linux"></i> Linux / <i class="fa-brands fa-apple"></i> macOS %}

```text
./pactus-gui --testnet
```

{% endtab %}

{% tab gui_node windows <i class="fa-brands fa-windows"></i> Windows %}

```text
pactus-gui.exe --testnet
```

{% endtab %}

{% endtabs %}

## Notes

As it's mentioned, the rest of work will be handled by the software which read the network type from
wallet file and working directory. the rest of commands and instructions can be found in mainnet docs.
kehiy marked this conversation as resolved.
Show resolved Hide resolved

When you make multiple wallet and nodes, may you get conflicts with old wallet file or working directories.
kehiy marked this conversation as resolved.
Show resolved Hide resolved
you have to specify a new path for them using `--path` flag or just remove the old one.
kehiy marked this conversation as resolved.
Show resolved Hide resolved
8 changes: 8 additions & 0 deletions website/user-guides/pactus-testnet/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
layout: guide
title: dict.guide.pactus_testnet
---

# {% t dict.guide.pactus_testnet %}

{% translate_with_version user-guides/pactus-testnet/index.md %}
Loading