Skip to main content

Getting Started

This quickstart guide is intended for users who wish to use the Global Trust Network (GTN) or Stability Testnet through browser extensions. In this example, we will use MetaMask, the most popular browser extension for interacting with blockchains.

MetaMask Configuration

MetaMask allows users to interact with the Global Trust Network or Stability Testnet easily. Here's how to set it up:

1. Installing MetaMask

If you haven't already, install MetaMask for your browser from the official MetaMask website.

2. Sign Up For An API Key

Step 1 - Navigate to Stability Portal and click the `Login | New User' button.

Stability Portal Page

Step 2 - Select Your Preferred Registration

On this screen, select your preferred method of registration. For this tutorial, we will be following the Google sign-in path. You may also similarly log in via Email, GitHub, Magiclink, or directly through Metamask.

It is important to note that registrations through Metamask or Magiclink do not provide a dedicated API Key. Without an API Key, you will not be able to perform transactions on Global Trust Network (GTN) and Stability Testnet. To receive an API Key, you must register using either GitHub, Google, or Email.

If you opt to register via email, ensure you can verify your email address.

Stability Login Screen

Step 3 - Select Your Preferred Network

Using the dropdown menu on the top right, select the network you wish to generate an API Key on.

Stability Portal Screen with Networks Highlighted

Step 4 - Click the Create New API Key Button

Stability Portal Screen with Create New API Key Button Highlighted

Step 5 - Congrats! You've created an API Key.

To view your personal RPC URL, click the Info button. Stability Portal Screen with Info Button Highlighted

Here, you will find your personal RPC URL. Stability Portal Screen with API URL Highlighted

3a. Add Network Automatically to Metamask + Other Compatible Wallets

Metamask Logo

To add your custom RPC to your browser extension wallet, which will allow you to use Global Trust Network or Stability Testnet, click the Metamask Fox Logo next to your API Key. This will work with Metamask as well as many other browser extension based wallets.

If you are not able to add the network to your wallet, you may have to add the network manually. Follow the instructions below.

3b. Add Network Manually to Metamask

In the event you are unable to add your wallet automatically via clicking the Metamask Fox Logo above, or you wish to add the network manually, simply follow the steps below.

Step 1 - Navigate to Settings in Metamask.

Metamask Main Screen with Settings Highlighted

Step 2 - Click on the Networks tab.

Metamask Settings Screen with Networks Highlighted

Step 3 - Click the Add a network button.

Metamask Networks Screen with 'Add a network' Button Highlighted

Metamask Add Network Screen with 'Add a network manually' Highlighted

Step 5 - Go to the Stability Account Manager and copy your API Key.

Stability Account Manager Screen with an Example API Key Highlighted

Step 6 - Fill out the network settings using the details below. Be sure to replace the YOUR_API_KEY with your own API Key. Afterward, click Save.

Metamask Manual Network Screen with Details Filled and Save Button Highlighted

PropertyGlobal Trust NetworkStability Testnet
Network NameGlobal Trust NetworkStability Test Net
New RPC URLhttps://rpc.stabilityprotocol.com/zgt/YOUR_API_KEYhttps://rpc.testnet.stabilityprotocol.com/zgt/YOUR_API_KEY
Chain ID10101020180427
Currency SymbolFREEFREE
Block Explorer URLhttps://stability.blockscout.com/https://stability-testnet.blockscout.com/

4. Configure your Metamask for Zero Fees

Transactions submitted to Stability require the max base fee and priority fee to be set to zero. For the your first transaction, you will have to manually set these values to zero. It is advised that you save these values as the default setting for our network.

Adjust Gas Icon in Metamask

On your first transaction, A MetaMask popup will appear to confirm the transaction. Click the pencil icon in the estimated fee box.

Advanced Gas Fee Settings in Metamask

This will allow you to customize Metamask for zero gas transactions. Click the advanced gas fee icon. Set your Max Base Fee and Priority Fee to zero. Click the Save these values as my default... checkbox to avoid having to manually set the gas in the future.

5. Complete!

You're now connected to our blockchain network and ready to make transactions or interact with smart contracts!