Testnet 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.
Last updated
This quickstart guide will walk you through the necessary steps to download, install & configure the SagaCLI, request your tokens and launch your chainlet.
Last updated
IMPORTANT: Pegasus Incentivized Testnet is for testing purposes only. As such, this should be used for testing ONLY, not production deployments.
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 Testnet Faucet can be requested into your Saga account using the Saga Web App
Saga Web App is now online at https://testnet.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.
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://testnet.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 freedomchain, 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.
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 "freedomchain")
New RPC URL: This will be your chainlet's JSON-RPC endpoint, you can get this in https://testnet.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: 1712762003250914
Currency Symbol: This is your Chainlet currency symbol. You can get this in in https://testnet.app.saga.xyz/ -> search your chainlet -> chainlet details -> on the right of the chainlet name (On the example before freedomchain -> FDC, FDC is the Currency Symbol)
Block Explorer URL: This will be your personal chainlet's block explorer url, you can get this in https://testnet.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.
