From 20aceeb8e88df02f18ab62c6ec699fad36e9588e Mon Sep 17 00:00:00 2001 From: johnnymatthews <9611008+johnnymatthews@users.noreply.github.com> Date: Tue, 1 Sep 2026 13:09:18 +0100 Subject: [PATCH 1/2] Adds "add testnet to your wallet" guide. Closes #308. --- config.toml | 3 +- .../add-the-testnet-to-your-wallet/index.md | 64 +++++++++++++++++++ 2 files changed, 66 insertions(+), 1 deletion(-) create mode 100644 content/run/add-the-testnet-to-your-wallet/index.md diff --git a/config.toml b/config.toml index 00bd154..772a45b 100644 --- a/config.toml +++ b/config.toml @@ -88,7 +88,7 @@ section = "reference" # "build", "run", "reference"). The macro filters by the current path so # only the active section's groups are shown. The home page has no sidebar. # - `label`: group heading text. -# - `page`: optional path to a section _index.md; when set, the group label +# - `page`: optional; path to a section _index.md; when set, the group label # is a link to that landing page. # - `pages`: content paths relative to content/; page titles are resolved # from front matter. @@ -146,6 +146,7 @@ section = "run" label = "Quickstart" pages = [ "run/get-started/index.md", + "run/add-the-testnet-to-your-wallet/index.md", ] [[extra.sidebar]] diff --git a/content/run/add-the-testnet-to-your-wallet/index.md b/content/run/add-the-testnet-to-your-wallet/index.md new file mode 100644 index 0000000..bf7f41c --- /dev/null +++ b/content/run/add-the-testnet-to-your-wallet/index.md @@ -0,0 +1,64 @@ ++++ +title = "Add the Shinzo testnet to your wallet" +description = "Connect MetaMask, Trust Wallet, and other browser wallets to the Shinzo testnet with the correct network parameters." +aliases = ["/wallets/add-testnet"] ++++ + +To interact with the Shinzo testnet from a browser wallet, you add it as a custom network. This page lists the values every wallet needs, then steps through adding the network in MetaMask and Trust Wallet, with a generic method for any other EVM-compatible wallet at the end. + +You need testnet SHNZ to pay for transactions such as registering a Host or Generator. Get it from the [testnet faucet](https://faucet.shinzo.network/), and track on-chain activity on the [Explorer](https://explorer.shinzo.network/). + +## Network parameters + +Every wallet asks for the same set of fields. Use these values for the testnet: + +| Field | Value | +| --- | --- | +| Network name | Shinzo | +| RPC URL | `http://testnet.shinzo.network:8545` | +| Chain ID | `91273001` | +| Currency symbol | `SHNZ` | +| Block explorer URL | `https://explorer.shinzo.network` | + +The block explorer URL field is optional in some wallets. Fill it in when the field is there, so transaction hashes and addresses link out to the Explorer. + +{% admonition(type="warning", title="HTTP RPC caveat") %} +The testnet RPC endpoint uses plain HTTP rather than HTTPS. Some wallets refuse to add an HTTP endpoint for security reasons, and others add it but mark the network as untrusted. We are tracking the HTTPS work in [shinzohub#97](https://github.com/shinzonetwork/shinzohub/issues/97). Until that lands, use a wallet that accepts HTTP endpoints. MetaMask and Trust Wallet both do, and both are known to work with the testnet. +{% end %} + +## Add the network to MetaMask + +1. Open the MetaMask extension and click the network selector at the top. +1. Click **Add network** and choose **Add a network manually**. +1. Enter the values from the [network parameters](#network-parameters) table. The Chain ID field accepts the decimal form `91273001`. +1. Click **Save**. MetaMask warns that the RPC endpoint is not HTTPS. Review the warning and confirm to continue. +1. Switch to the Shinzo network from the network selector. + +## Add the network to Trust Wallet + +Trust Wallet runs as both a mobile app and a browser extension. The fields are the same in each. + +On mobile: + +1. Open the Trust Wallet app and tap the asset management icon in the top right of the main wallet screen. +1. Tap the **+** button and switch to the **Network** tab. +1. Select **EVM** as the network type and tap **Add custom network**. +1. Enter the values from the [network parameters](#network-parameters) table. +1. Tap **Save**. + +On the browser extension: + +1. Open the extension and select the **Settings** icon. +1. Go to **Network** and click **Add custom network**. +1. Enter the values from the [network parameters](#network-parameters) table. +1. Save the network and switch to it from the network selector. + +## Add the network to any other EVM-compatible wallet + +If your wallet is not listed above, add the network manually from its custom-network or add-chain screen. The field names vary, but every EVM-compatible wallet asks for the same four required values plus an optional block explorer URL. Copy them from the [network parameters](#network-parameters) table. + +Wallets that expose the standard `wallet_addEthereumChain` method can also pick up the network from a dApp that calls it. Shinzo does not host that flow yet, so add the values by hand for now. + +## Next steps + +Once your wallet is connected, you can register as a Host or Generator on the [Registration app](https://registration.shinzo.network/). See the [Host quickstart](/run/run-a-host/quickstart/) and [Generator registration](/run/run-a-generator/register/) guides for the full registration flow. From 05d860847d58f56dee25163001cd900257d17f26 Mon Sep 17 00:00:00 2001 From: johnnymatthews <9611008+johnnymatthews@users.noreply.github.com> Date: Tue, 1 Sep 2026 13:10:52 +0100 Subject: [PATCH 2/2] Simplifies wallet process. --- content/run/run-a-host/quickstart/index.md | 10 ++-------- 1 file changed, 2 insertions(+), 8 deletions(-) diff --git a/content/run/run-a-host/quickstart/index.md b/content/run/run-a-host/quickstart/index.md index 65d18de..9ae00f8 100644 --- a/content/run/run-a-host/quickstart/index.md +++ b/content/run/run-a-host/quickstart/index.md @@ -215,7 +215,7 @@ http { add_header 'Access-Control-Allow-Methods' 'GET, POST, PUT, DELETE, OPTIONS' always; add_header 'Access-Control-Allow-Headers' 'Authorization, Content-Type, Accept, Origin' always; add_header 'Access-Control-Max-Age' 3600 always; - add_header 'Vary' 'Origin' always; + add_header 'Vary' Origin always; location / { if ($request_method = OPTIONS) { return 204; } @@ -349,13 +349,7 @@ To participate in the Shinzo Network, you must register your Host. Registration ### Register with the GUI (Option A) 1. Start your Host client. -1. Add Shinzo testnet to Metamask with the following values: - - Network name: Shinzo - - Default RPC URL: `http://testnet.shinzo.network:8545` - - Chain ID: `91273001` - - Currency symbol: `SHNZ` - - You need a small amount of SHNZ for the registration transaction fee. Get testnet SHNZ from the [faucet](https://faucet.shinzo.network/). +1. Add the Shinzo testnet to your wallet using the values on the [Add the Shinzo testnet to your wallet](/run/add-the-testnet-to-your-wallet/) page. You need a small amount of SHNZ for the registration transaction fee. Get testnet SHNZ from the [faucet](https://faucet.shinzo.network/). 1. Open the [Registration app](https://registration.shinzo.network/) and connect your wallet. If your Host is on a private network, the Host client also serves a local registration app at `http://localhost:8080/registration-app`; use SSH port forwarding to reach a remote node. 1. On the registration page, click **Register** and select **Host** as your role to complete the process. 1. Submit your registration, then confirm the transaction in MetaMask. You should see a successful registration notification.