Mainnet Quickstart Guide

This quickstart guide will walk you through the necessary steps to download, install & configure the SagaCLI, request your tokens and launch your chainlet.

1. Faucet Airdrop Key

Your contact at Saga will send you a Faucet Airdrop Key which will auto-fund your wallet address. If you don't have your Faucet Airdrop Key, reach out to your contact at Saga.

After you have the passphrase from your Saga contact, tokens from the Saga Mainnet Faucet can be requested into your Saga account using the Saga Web App

Saga Web App is now online at https://app.saga.xyz/

You will need a wallet, such as Keplr, that supports Cosmos SDK based blockchains If this is your first time using Keplr Wallet, follow this tutorial to install and start using it.

Click the Get Tokens! button towards the top right. This will open your Saga wallet.

Simply fill in the received passphrase and click on Request PSAGA Tokens

Your Keplr wallet may prompt you to approve this request. Simply click approve and your wallet will be funded with 350 PSAGA tokens.

2. Launch your chainlet

All chainlets launched will require a setup fee and a 30-day upfront deposit of the epoch fee

Please ensure you have sufficient funds available in the launcher's wallet to successfully launch a chainlet

See Chainlet Billing for details

Saga Web App is now online at https://app.saga.xyz/

You will need a wallet, such as Keplr, that supports Cosmos SDK based blockchains If this is your first time using Keplr Wallet, follow this tutorial to install and start using it.

To launch a chainlet, simply click on the Launch tab on the Saga Web App.

In the example displayed in the image above, we are launching a chainlet called SagaWebAppTst. You can specify

  • Chainlet token's denom

  • Number of days of credit (note that this must be a value greater than or equal to the minimum value) you wish to add to the chainlet

  • EVM account address

  • Amount of tokens to add to the EVM account at genesis (launch of the chainlet)

To add additional EVM accounts and their associated token amount at chainlet launch, simply click the + sign next to the EVM token amount.

When you are done, simply click Launch Chainlet

You will get a prompt from the Keplr wallet to approve this transaction. Click Approve and the chainlet is launched!

You can view Chainlet API and Block Explorer info from the Saga Web App for any chainlet.

To view this information, simply head on over to the Chainlets tab on the landing page and then click on any chainlet to view its detailed information.

As an example, in the above listing, to view the chainlet API and block explorer details for the chainlet called abstract, simply click on it.

You can see the RPC endpoint, the websocket endpoint and the block explorer URL in the chainlet details page shown in the image above.

4. Configuring Metamask

The fastest way to configure your chainlet network settings into your metamask browser plugin is by visiting your chainlet's dedicated block explorer page and clicking on the Add <chainlet name> link present on the footer menus.

You can also see how this looks like in the image included below:

Or if you want to configure Metamask network manually you need to navigate to go: Metamask -> Settings -> Networks -> Add Network

The settings screen will look something like this:

From here, click on "Add a network manually" and type in the following settings in the required fields:

  • Network Name: This will be your Chainlet name (in this example I'm using "abstract")

  • New RPC URL: This will be your chainlet's JSON-RPC endpoint, you can get this in https://app.saga.xyz/ -> search your chainlet -> chainlet details -> RPC Endpoint

  • Chain ID: Here you need to input the middle numerical part of the ChainID, (make sure to drop the '-1') Example: 2712762876035000

  • Currency Symbol: This is your Chainlet currency symbol. You can get this in in https://app.saga.xyz/ -> search your chainlet -> chainlet details -> on the right of the chainlet name (On the example before abstract -> ABSTR, ABSTR is the Currency Symbol)

  • Block Explorer URL: This will be your personal chainlet's block explorer url, you can get this in https://app.saga.xyz/ -> search your chainlet -> chainlet details -> Block Explorer

Taken together, the output will look SIMILAR with what you see in the following image below:

Once this final step is complete, you're ready to deploy any EVM-based smart contract. You can deploy with tools such as Remix, Truffle, even Thirdweb.

Last updated