Skip to content

Latest commit

 

History

History
100 lines (64 loc) · 7.16 KB

testnet.md

File metadata and controls

100 lines (64 loc) · 7.16 KB
Raw

Testnet

Introduction

A testnet network is an almost identical copy of a blockchain that serves as an alternative specifically made for testing without affecting the operation of the original network (mainnet).

Secret Network has its own testnets which are an essential tool for the development of Dapps and mainnet blockchain upgrades. The testnet is not just a test environment(sandbox) for programmers and builders. It is available for all users and can be used to learn how to interact with the Secret Network blockchain without fear of (financial) consequences.

In this step-by-step guide I’ll show you how to connect to a testnet with Keplr and SecretCLI, get some tokens through a faucet and finally interact with secret applications.

Set up with Keplr

The easy way to use a testnet is via the Keplr wallet browser extension, you can install it and set it up by following this guide or this video. For safety reasons we recommend using a separate secondary wallet for testing purposes (read this article to learn about the best practices to stay safe in Secret Defi).

Once you have saved your mnemonic phrase you can connect to the pulsar-2 chain. The pulsar chain is hosted by the griptape team which updates it periodically to make sure it’s in parallel with the current mainnet version.

  • Go to connect.pulsar.griptapejs.com and click on the "pulsar-2" button
  • Click “approve” once the Keplr window pops

  • Now you should be able to see the pulsar-2 network on Keplr wallet by selecting it from the drop down menu. (verify that your Secret mainnet and testnet addresses coincide and start with “secret”)
  • \

You have now successfully added the Secret Testnet to your wallet and you’re ready to get your first tokens and experiment!

Faucet

The fastest and easiest way to get some test SCRT into your wallet is to use faucets which are tools that distribute a standard amount of tokens to a specific address.

Remember that all tokens on the Secret Testnet have no real value as they’re free to mint and they’re impossible to transfer to mainnet.

  • Go to faucet.secrettestnet.io
  • Paste your address in the text box, verify the captcha and click on “Send me tokens”

In a matter of seconds you should be able to see 100 test SCRT on your Keplr balance, otherwise the faucet may be down and in that case you can let the #secret-testnet channel know on the Secret Network discord, and they should be able to send some your way.

Set Up SecretCLI

To have access to all the testnet functionalities and to develop you can connect using SecretCLI, a desktop client tool to interact with the blockchain from the console.

  • Install and configure SecretCLI by following this tutorial

  • Open your terminal and run the following commands to connect to pulsar-2 and add your wallet:

    secretcli config node http://rpc.pulsar.griptapejs.com:26657
secretcli config output json
secretcli config chain-id pulsar-2
secretcli keys add <a-name> --recover ```

  • Paste your wallet’s mnemonic phrase when asked to do so

You can always change the parameters to connect to alternative APIs and testnets. You can find the full list of testnets, APIs, faucets and explorers on the official github repository.

Secret Tokens

On top of that 100 SCRT, the faucet sends you a basket of Secret Tokens that you can only view by generating a new viewing key.

  • Search for a token that you want to view the amount of on this list
  • Copy the contract address
  • Open your Keplr extension and click on the hamburger menu on the top left
  • Select “Add Token”
  • Paste the address and click “Submit” and approve the transaction (you can set high fees as it’s paid in test SCRT)
  • You should now be able to see the Secret Token balance on your Keplr extension under the section “Tokens”

Interact With Dapps

Once you have everything set up you can connect to protocols that have a public testnet URL available.

Here’s a table of the main ones:

Dapp Website Testnet Chain
Stashh https://stashhapp-public-testnet.azurewebsites.net/ Pulsar-2
Jackal https://alpha.jackaldao.com/ Pulsar-2
Sienna https://testnet.sienna.network/ Pulsar-2

Alternatively you can directly interact with their testnet secret contracts. Below are some of the main smart contract addresses available:

Contract Address Testnet Chain
Jackal secret1epm82uygswvgzy32es2nu4fnjsztfln8mud84ksecret1epm82uygswvgzy32es2nu4fnjsztfln8mud84k Pulsar-2
Sienna AMM secret1203futsqmxjjjk6rv8lvxmxlgwyje8jkf7ndxf Pulsar-2
Sienna Lend secret13jw078vweqgr4v0q9u0l8a44525nlqxju29xkq Pulsar-2
Sienna Rewards Rewards Address List Pulsar-2
StakeEasy secret1qrhv2lwjaawevskdz5v5mn4t4d65c2ndtltf8p Pulsar-2
Time Capsule secret1hznvj7amwq5dqnl0snyhzpyrwufdcjll6my6casecret1hznvj7amwq5dqnl0snyhzpyrwufdcjll6my6ca Pulsar-2

With Keplr you’ll need to approve a connection request for each protocol that you want to connect to. You can easily manage active website connections under “Manage Connections” in the Keplr settings.

Note: If you’re using secretcli view a full list of commands for Secret Contracts here.

Viewing Testnet Transactions

To view testnet transactions and contract interactions on the testnets you can use the SecretNodes block explorer — the chain configured for this page's demonstration purposes is pulsar-2.