Skip to main content

MetaMask & API Configuration

This guide will help you set up MetaMask and configure your API key for use with Stability.

Prerequisites

This tutorial presumes a foundational understanding of blockchain technology and familiarity with tools that interact directly with the blockchain. For example, smart contracts and development tools such as Remix and Viem.

Register for an API Key

Global Trust Network (GTN) and Stability Testnet employ API keys to manage transactions. On Global Trust Network, an API key is required to perform write transactions. On Stability Testnet, each address is given a limited number of free transactions without an API key using our public RPC. To increase the number of transactions that a certain user can execute on either chain, users are required to sign up with our Account Manager for their very own private RPC address. Only an e-mail is required.

For detailed instructions on creating your API key, see Creating Your API Key.

Quick Setup Steps

Step 1 - Navigate to Stability Portal

Step 2 - Select Your Preferred Registration

Stability Account Portal Screen with Login Options

Select your preferred registration method. Stability supports Google Sign-in or Email registration.

  • Note: If registering via email, ensure you can verify your address.

Step 3 - Select Your Preferred Network - GTN or Testnet

Stability Account Portal Screen with Select Network Dropdown Highlighted

Use the dropdown menu in the top-right corner to select your target environment:

  • GTN (Mainnet): For production-ready applications.

  • Testnet: For development and experimental testing.

Step 4 - Click the Create New Key Button

Stability Account Portal Screen with Create API Key Button Highlighted

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

Stability Account Portal Screen with View Details Button Highlighted

To view your personal RPC URL, click the View Details button next to your API key, followed by the Setup Instructions button.

Here, you will find your personal RPC URL, as well a link that will add either network to your Metamask in one click.

Add Network to Metamask

Add Network Automatically

Stability Account Portal Screen with Add to Metamask

To add your custom RPC to your browser extension wallet, which will allow you to use Global Trust Network or Stability Testnet, click the Add To Metamask button. 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.

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.

PropertyValue
Network NameGlobal Trust Network
New RPC URLhttps://rpc.stabilityprotocol.com/zgt/YOUR_API_KEY
Chain ID101010
Currency SymbolFREE
Block Explorer URLhttps://stability.blockscout.com/
Request Limit60 Per Minute. (Higher Limits Available)
Max Batch Size40

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

Step 4 - Click the Add a network manually text link.

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

Next Steps