Liquid Staked NIBI (stNIBI) Eris Protocol Smart Contract Calls

[Unique-Divine]

Liquid Staked NIBI (stNIBI)

This is an outline of specific Web3 calls for liquid staking using the Eris hub contract on the Nibiru mainnet.

To liquid stake and liquid unstake are called "bond" and "unbond" on the Eris Rust enums.

---

Liquid Staking: Web3 calls

1 - Liquid stake - IBC wallet

[1 - Liquid stake - IBC wallet]

Here's an example tx body (part of it) for a liquid staking call:

"memo": "www.erisprotocol.com",
"messages": [
  {
    "typeUrl": "/cosmwasm.wasm.v1.MsgExecuteContract",
    "value": {
      "contract": "nibi1udqqx30cw8nwjxtl4l28ym9hhrp933zlq8dqxfjzcdhvl8y24zcqpzmh8m",
      "funds": [
        {
          "amount": "40000000",
          "denom": "unibi"
        }
      ],
      "msg": "eyJib25kIjp7fX0=",
      "sender": "nibi1rlvdjfmxkyfj4tzu73p8m4g2h4y89xccf9622l"
    }
  }
],

This value for msg, "eyJib25kIjp7fX0=", is the base 64 encoded version of the execute message:

{"bond":{}}

The contract at address
"nibi1udqqx30cw8nwjxtl4l28ym9hhrp933zlq8dqxfjzcdhvl8y24zcqpzmh8m" is called a "hub" in the Eris lingo. The available tx types correspond to these Rust enums
from the smart
contract.

2 - Liquid stake - EVM Wallet

This is the same as (1), except the message is routed through the Wasm.sol
precompiled contract on the EVM.

3 - Redeem / Unstake - IBC wallet

[Un(liquid) stake - IBC wallet]

{
  "@type": "/cosmwasm.wasm.v1.MsgExecuteContract",
  "contract": "nibi1udqqx30cw8nwjxtl4l28ym9hhrp933zlq8dqxfjzcdhvl8y24zcqpzmh8m",
  "funds": [
    {
      "amount": "200000000",
      "denom": "tf/nibi1udqqx30cw8nwjxtl4l28ym9hhrp933zlq8dqxfjzcdhvl8y24zcqpzmh8m/ampNIBI"
    }
  ],
  "msg": {
    "queue_unbond": {}
  },
  "sender": "nibi1ah8gqrtjllhc5ld4rxgl4uglvwl93ag0sh6e6v"
},

4 - Redeem / Unstake - EVM Wallet

This is the same as (3), except the message is routed through the Wasm.sol
precompiled contract on the EVM.

---

Queries

This is the QueryMsg::State from the Eris hub contract.

# Eris Hub contract
CONTRACT_ADDR="nibi1udqqx30cw8nwjxtl4l28ym9hhrp933zlq8dqxfjzcdhvl8y24zcqpzmh8m"
nibid q wasm state smart $CONTRACT_ADDR '{"state": {}}' | jq

Returns this object

#[cw_serde]
pub struct StateResponse {
    /// Total supply to the Stake token
    pub total_ustake: Uint128,
    /// Total amount of utoken staked (bonded)
    pub total_utoken: Uint128,
    /// The exchange rate between ustake and utoken, in terms of utoken per ustake
    pub exchange_rate: Decimal,
    /// Staking rewards currently held by the contract that are ready to be reinvested
    pub unlocked_coins: Vec<Coin>,
    // Amount of utoken currently unbonding
    pub unbonding: Uint128,
    // Amount of utoken currently available as balance of the contract
    pub available: Uint128,
    // Total amount of utoken within the contract (bonded + unbonding + available)
    pub tvl_utoken: Uint128,
}