Cw20 Staking App

Deploying a cw20 staking App using the Andromeda CLI.
If unfimailar with the steps of deploying an app, go back to the first example where we explain in detail all the different parts of deploying an App.
If any of the messages in this example do not work, you might want to cross reference the messages with the ADO specific section which always contains the latest ADO versions to make sure they are correct. Other than that the logic will remain the same.
Make sure to read the Introduction to Apps before going through building an app.
Defining our App
For this example, we will assume that we have a project that wants to create their own cw-20 token that can be staked for rewards.
The steps we will perform: 
Mint some coins to different addresses
Stake some of the coins for rewards of our choice 
Check that all the results are as expected
Defining the Messages
The components/ADOs we would need:
​CW20​
​Cw-20 staking​
Although not necessary, if you are unfamiliar with these ADOs, it is suggested to read through each of the them before deploying an app. 
Let us first start by representing the instantiation message for each of our ADOs:
Keep in mind that the app takes these messages as base64 encoded.
Cw-20 Token
I will start out by giving 10000 tokens to three addresses. We have not set a minter, meaning no additional tokens can ever be minted. I specify 3 addresses to receive an initial balance.
DO NOT use the same addresses for the initial balances. Instead use some of your addresses  (Create new ones if you dont have).
{
 "name": "Staking Token",
 "symbol":"STK",
 "decimals":6,
 "initial_balances":[
                {
              "address":"andr1cp9vxvplgjf508thtacvxeh6qxqsx67gseqcd5",
              "amount":"10000"
          },
                   {
              "address":"andr1f9q5dhg5q434jyjes002fvkcuk062tnt0wdzl8",
              "amount":"10000"
          },
                   {
              "address":"andr1e9qgel058tvgryvsu8uhta0u4sswajre3cjhav",
              "amount":"10000"
          }
             
        ]
 }  
As Base64: 
eyJuYW1lIjogIlN0YWtpbmcgVG9rZW4iLCJzeW1ib2wiOiJTVEsiLCJkZWNpbWFscyI6NiwiaW5pdGlhbF9iYWxhbmNlcyI6W3siYWRkcmVzcyI6ImFuZHIxY3A5dnh2cGxnamY1MDh0aHRhY3Z4ZWg2cXhxc3g2N2dzZXFjZDUiLCJhbW91bnQiOiIxMDAwMCJ9LHsiYWRkcmVzcyI6ImFuZHIxZjlxNWRoZzVxNDM0anlqZXMwMDJmdmtjdWswNjJ0bnQwd2R6bDgiLCJhbW91bnQiOiIxMDAwMCJ9LHsiYWRkcmVzcyI6ImFuZHIxZTlxZ2VsMDU4dHZncnl2c3U4dWh0YTB1NHNzd2FqcmUzY2poYXYiLCJhbW91bnQiOiIxMDAwMCJ9XX0gIA==
Cw-20 Staking
We have not set any additional rewards. This means that the rewards are the same as the staking token as most staking works. If you want, you can add up to 10 different reward tokens to the staking.
{
"staking_token":{
          "identifier":"cw20"
              }
     }
As Base64:
eyJzdGFraW5nX3Rva2VuIjp7ImlkZW50aWZpZXIiOiJjdzIwIn19
App
The primitive address used here might be outdated in the future. Check our deployed contracts to get the latest registry.
The instantiate_message of the cw20 will be different for you since you are using different addresses to receive initial balances.
{
  "name": "Staking App",
  "app_components": [
    {
      "name": "cw20",
      "ado_type": "cw20",
      "instantiate_msg": "eyJuYW1lIjogIlN0YWtpbmcgVG9rZW4iLCJzeW1ib2wiOiJTVEsiLCJkZWNpbWFscyI6NiwiaW5pdGlhbF9iYWxhbmNlcyI6W3siYWRkcmVzcyI6ImFuZHIxY3A5dnh2cGxnamY1MDh0aHRhY3Z4ZWg2cXhxc3g2N2dzZXFjZDUiLCJhbW91bnQiOiIxMDAwMCJ9LHsiYWRkcmVzcyI6ImFuZHIxZjlxNWRoZzVxNDM0anlqZXMwMDJmdmtjdWswNjJ0bnQwd2R6bDgiLCJhbW91bnQiOiIxMDAwMCJ9LHsiYWRkcmVzcyI6ImFuZHIxZTlxZ2VsMDU4dHZncnl2c3U4dWh0YTB1NHNzd2FqcmUzY2poYXYiLCJhbW91bnQiOiIxMDAwMCJ9XX0gIA=="
    },
    {
      "name": "staking",
      "ado_type": "cw20-staking",
      "instantiate_msg": "eyJzdGFraW5nX3Rva2VuIjp7ImlkZW50aWZpZXIiOiJjdzIwIn19"
    }
  ],
  "primitive_contract": "andr1mfxffyrda922hpt23f7hpf8t50sadcwavkt54cuyl3w6p4zwz36sc9hfj6"
  }
Instantiating the App
If you do not have the CLI downloaded, go to the Introduction to Apps section to get the latest version.
First, let us open the CLI by running andr in our terminal. We then need to choose the chain we want to deploy on. Run "chain use" in the CLI and select the testnet that you want to deploy on. For this example I will be using the Andromeda test-net Galileo-3.
If this is the first time using the CLI make sure to run "wallet add <wallet-name>"in order to create a wallet. Then go to that chain's faucet (usually located in their discord) and request tokens.
We have already uploaded the App ADO to the Andromeda testnet. The code Id I will use is 55. This code Id will most likely be outdated in the future. A simple way to check the latest code id for the App ADO is to query it from the ADODB using the chain you want to use. 
In the CLI, while connected to the chain of choice, run:
ado db getcodeid app
The code Id to use will be returned.
 Now we can instantiate our App. We will be using our wasm command to instantiate our app:
Do not copy and paste the command below as it will not work. Make sure to make the appropriate changes before running the command. 
Replace the <code_id> with the returned code-id for the app ADO. 
wasm instantiate <app-code-id> '{"name": "Staking App","app_components": [{"name": "cw20","ado_type": "cw20","instantiate_msg": "eyJuYW1lIjogIlN0YWtpbmcgVG9rZW4iLCJzeW1ib2wiOiJTVEsiLCJkZWNpbWFscyI6NiwiaW5pdGlhbF9iYWxhbmNlcyI6W3siYWRkcmVzcyI6ImFuZHIxY3A5dnh2cGxnamY1MDh0aHRhY3Z4ZWg2cXhxc3g2N2dzZXFjZDUiLCJhbW91bnQiOiIxMDAwMCJ9LHsiYWRkcmVzcyI6ImFuZHIxZjlxNWRoZzVxNDM0anlqZXMwMDJmdmtjdWswNjJ0bnQwd2R6bDgiLCJhbW91bnQiOiIxMDAwMCJ9LHsiYWRkcmVzcyI6ImFuZHIxZTlxZ2VsMDU4dHZncnl2c3U4dWh0YTB1NHNzd2FqcmUzY2poYXYiLCJhbW91bnQiOiIxMDAwMCJ9XX0gIA=="},{"name": "staking","ado_type": "cw20-staking","instantiate_msg": "eyJzdGFraW5nX3Rva2VuIjp7ImlkZW50aWZpZXIiOiJjdzIwIn19"}],"primitive_contract": "andr1mfxffyrda922hpt23f7hpf8t50sadcwavkt54cuyl3w6p4zwz36sc9hfj6"}'
​Instantiation​
You will be using the contract addresses that were instantiated for you instead of the ones in this tutorial.
Interacting with the App
Andromeda contracts assign the original instantiator as contract owners. Due to how instantiation via a submessage operates in CosmWasm contracts, we must claim ownership of the components in order to execute messages that have authorization restrictions (owner restricted).
You can also use proxy messages to execute through the app ADO itself, but for these examples we will be claiming ownership.
Claim Components
{
"claim_ownership":{}
}
  wasm execute <app_contract_address> '{"claim_ownership":{}}' 
​Claim Components​
User 1 stakes tokens
To stake tokens we perform a send message from Token contract and attach the Stake{} message to it. For user 1 we will stake 3000 tokens. 
This message needs to be performed by the address user 1. This means you need to switch wallets to one of the addresses that you specified when distributing initial balances.
{
 "send":{
    "contract":"<staking-contract-address>",
    "amount":"3000",
    "msg":"ewogICAgInN0YWtlX3Rva2VucyI6e30KICAgIAp9"
    }
 }
Here the attached message is:
{
"stake_tokens":{}
}
Let us execute it:
wasm execute <cw20-contract-address> '{"send":{"contract":"<staking-contract-address>","amount":"3000","msg":"ewogICAgInN0YWtlX3Rva2VucyI6e30KICAgIAp9"}}' 
​User 1 stakes 3000 tokens​
We perform the same steps to stake for users 2 and 3:
Make sure to change wallet for each user and change the amount being staked.
​User 2 stakes 1000 tokens ​
​User 3 stakes 6000 tokens​
Checking Pending Rewards
Let us check the staker data for user 1:
wasm query  <staking-contract-address> '{"staker":{"address":"<user-address>"}}' 
Result:
{
  "address": "andr1cp9vxvplgjf508thtacvxeh6qxqsx67gseqcd5",
  "share": "3000",
  "balance": "3000",
  "pending_rewards": []
}
Here we check one of the stakers. As we can see, the pending rewards are empty and the balance is the same as the share. 
Transfer Some Tokens as Rewards
Now let us send 1000 tokens to the contract. By doing this, we are telling the contract to use them as rewards for stakers.
You can use any of the wallets that cw20 tokens remaining. 
{
 "transfer":{
      "recipient":"<staking-contract-address>",
      "amount": "1000"
      }
 }
wasm execute <cw20-contract-address> '{"transfer":{"recipient":"<staking-contract-address>","amount": "1000"}}'
Now since the token we sent is the same one being staked, then the rewards are distributed automatically to the stakers, and there is no need to call Claim or UpdateGlobalIndex.

Let us check the new balances of the users:
User 1:
wasm query  <staking-contract-address> '{"staker":{"address":"<user1-address>"}}' 
Result:
{
  "address": "andr1cp9vxvplgjf508thtacvxeh6qxqsx67gseqcd5",
  "share": "3000",
  "balance": "3300",
  "pending_rewards": []
}
User 2:
wasm query  <staking-contract-address> '{"staker":{"address":"<user2-address>"}}' 
Result:
{
  "address": "andr1f9q5dhg5q434jyjes002fvkcuk062tnt0wdzl8",
  "share": "1000",
  "balance": "1100",
  "pending_rewards": []
}
User 3:
wasm query  <staking-contract-address> '{"staker":{"address":"<user3-address>"}}' 
Result:
{
  "address": "andr1e9qgel058tvgryvsu8uhta0u4sswajre3cjhav",
  "share": "6000",
  "balance": "6600",
  "pending_rewards": []
}
As we can see each of the stakers got the amount proportional to the amount staked. 
Conclusion
This was a very simple App that showcases our cw20-staking contract. If you want to play around with it more, you can built it using the allocated rewards and add up to 10 different token rewards. It would also allow you to spread the rewards distribution to be in cycles instead of instant as we got here. This App although simple, is needed in most web3 projects that launch their own token. With Andromeda, you can have it all setup easily like we saw in this example or even using our no-code builder App which takes minutes.
Andromeda Apps - Previous
Auctioning App
Next - Andromeda Apps
Marketplace App
Last modified 2mo ago