Search Apps Documentation Source Content File Folder Download Copy Actions Download

faucet package

Overview

Package faucet is a toy points faucet realm for the gno.land test13 testnet.

Any caller may Claim() 100 points, but only once per cooldown window of 100 blocks. Cooldown is enforced deterministically via runtime.ChainHeight() — no real clocks, no RNG. Per-caller balance and last-claim height live in an avl.Tree so Render iterates in deterministic (address-sorted) order.

Functions

BalanceOf

func BalanceOf(addr string) int64

BalanceOf returns the current point balance of addr (0 if never claimed).

Param

Command

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

Result

Claim

func Claim(cur realm)

Claim grants ClaimAmount points to the caller, subject to the per-caller cooldown. It aborts (cross-realm) if the caller must still wait.

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/g12cs4cehujpffpjpywmkqj43m6u5ya53nj69sjz/faucet" -func "Claim" -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/g12cs4cehujpffpjpywmkqj43m6u5ya53nj69sjz/faucet" -func "Claim" -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 produces a Markdown dashboard of faucet activity.

Param

Command

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

Result