Search Apps Documentation Source Content File Folder Download Copy Actions Download

xgns package

Overview

Package xgns implements the GRC20-compliant xGNS token that represents staked GNS tokens. It manages minting/burning operations and tracks voting power for governance.

Functions

BalanceOf

func BalanceOf(owner address) int64

BalanceOf returns token balance for address.

Parameters:

  • owner: address to check balance for

Returns balance amount.

Param

Command

gnokey query vm/qeval -remote "https://rpc.test13.testnets.gno.land" -data "gno.land/r/gnoswap/gov/xgns.BalanceOf()"

Result

Burn

func Burn(cur realm, from address, amount int64)

Burn burns tokens from address.

Parameters:

  • from: address to burn from
  • amount: amount to burn

Only callable by governance staker contract.

Params

Command

# WARNING: This command is running in an INSECURE mode.
# It is strongly recommended to use a hardware device for signing
# and avoid trusting any computer connected to the internet,
# as your private keys could be exposed.

gnokey maketx call -pkgpath "gno.land/r/gnoswap/gov/xgns" -func "Burn" -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -chainid "test-13" -remote "https://rpc.test13.testnets.gno.land" ADDRESSgnokey query -remote "https://rpc.test13.testnets.gno.land" auth/accounts/ADDRESS
gnokey maketx call -pkgpath "gno.land/r/gnoswap/gov/xgns" -func "Burn" -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -broadcast=false ADDRESS > call.tx
gnokey sign -tx-path call.tx -chainid "test-13" -account-number ACCOUNTNUMBER -account-sequence SEQUENCENUMBER ADDRESS
gnokey broadcast -remote "https://rpc.test13.testnets.gno.land" call.tx

Mint

func Mint(cur realm, to address, amount int64)

Mint mints tokens to address.

Parameters:

  • to: recipient address
  • amount: amount to mint

Only callable by governance staker contract.

Params

Command

# WARNING: This command is running in an INSECURE mode.
# It is strongly recommended to use a hardware device for signing
# and avoid trusting any computer connected to the internet,
# as your private keys could be exposed.

gnokey maketx call -pkgpath "gno.land/r/gnoswap/gov/xgns" -func "Mint" -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -chainid "test-13" -remote "https://rpc.test13.testnets.gno.land" ADDRESSgnokey query -remote "https://rpc.test13.testnets.gno.land" auth/accounts/ADDRESS
gnokey maketx call -pkgpath "gno.land/r/gnoswap/gov/xgns" -func "Mint" -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -broadcast=false ADDRESS > call.tx
gnokey sign -tx-path call.tx -chainid "test-13" -account-number ACCOUNTNUMBER -account-sequence SEQUENCENUMBER ADDRESS
gnokey broadcast -remote "https://rpc.test13.testnets.gno.land" call.tx

Render

func Render(path string) string

Render returns a formatted representation of the token state.

Param

Command

gnokey query vm/qeval -remote "https://rpc.test13.testnets.gno.land" -data "gno.land/r/gnoswap/gov/xgns.Render()"

Result

SupplyInfo

func SupplyInfo() (totalIssued, issuedByDelegate, issuedByDepositGns int64, err error)

SupplyInfo returns supply breakdown information.

Returns:

  • totalIssued: total xGNS tokens issued
  • issuedByDelegate: tokens issued through governance delegation
  • issuedByDepositGns: tokens issued through launchpad deposit
  • error: error if launchpad address not found

Command

gnokey query vm/qeval -remote "https://rpc.test13.testnets.gno.land" -data "gno.land/r/gnoswap/gov/xgns.SupplyInfo()"

Result

TotalSupply

func TotalSupply() int64

TotalSupply returns the total supply of xGNS tokens.

Command

gnokey query vm/qeval -remote "https://rpc.test13.testnets.gno.land" -data "gno.land/r/gnoswap/gov/xgns.TotalSupply()"

Result