Package coins provides simple helpers to retrieve information about coins on the Gno.land blockchain.
The primary goal of this realm is to allow users to check their token balances without relying on external tools or services. This is particularly valuable for new networks that aren't yet widely supported by public explorers or wallets. By using this realm, users can always access their balance information directly through the gnodev.
While currently focused on basic balance checking functionality, this realm could potentially be extended to support other banker-related workflows in the future. However, we aim to keep it minimal and focused on its core purpose.
This is a "Render-only realm" - it exposes only a Render function as its public interface and doesn't maintain any state of its own. This pattern allows for simple, stateless information retrieval directly through the blockchain's rendering capabilities.
Function
Render
func Render(path string) string
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/gnoland/coins" -func "Render" -args "" -gas-fee 1000000ugnot -gas-wanted 5000000 -send "" -broadcast -chainid "test6" -remote "https://rpc.test6.testnets.gno.land" ADDRESSgnokey query -remote "https://rpc.test6.testnets.gno.land" auth/accounts/ADDRESS
gnokey maketx call -pkgpath "gno.land/r/gnoland/coins" -func "Render" -args "" -gas-fee 1000000ugnot -gas-wanted 5000000 -send "" ADDRESS > call.tx
gnokey sign -tx-path call.tx -chainid "test6" -account-number ACCOUNTNUMBER -account-sequence SEQUENCENUMBER ADDRESS
gnokey broadcast -remote "https://rpc.test6.testnets.gno.land" call.tx