Search Apps Documentation Source Content File Folder Download Copy Actions Download State String Boolean Number Struct Map Slice Pointer Function Closure Reference Nil Package Type Interface Unknown

forms package

Overview

Package forms is a Google-Forms-shaped questionnaire realm: publish a form, collect responses on chain, read them back rendered — with gnoweb as the only UI.

How it works

The realm renders each form with p/jeronimoalbi/mdform. gnoweb turns that markdown into a real HTML form whose submit builds a /vm.m_call to Submit, mapping every input to the Submit parameter of the same name. A respondent fills the form in a browser, signs with their wallet, and the answers land in realm state. No frontend, no backend, no indexer.

Slugs

A form's ID is a slug chosen at creation — lowercase letters, digits and single hyphens, 3 to 48 characters, unique per realm. It is the URL segment: /r/<ns>/forms:valoper-questionnaire. Response IDs are sequential.

Field encoding

Create takes four parallel, pipe-separated strings so it stays usable from gnokey and gnoweb without structured arguments:

Example
1labels:   "Name|Why gno.land?|Server type"
2kinds:    "text|textarea|select"
3required: "1|1|0"
4options:  "||cloud,on-prem,data-center"

Kinds are text, textarea, number and select. Options are comma-separated and only read for select fields. A form has at most MaxFields (8) fields; Submit accordingly takes eight answer slots, of which the form's field count are read and the rest must be empty. gnoweb passes "" for any parameter the form does not render an input for.

Who pays

Respondents pay the storage deposit for their own answers, which is the spam resistance. Withdraw deletes a response and the chain refunds the deposit to the caller — which is why only the author may withdraw: a deletion by the owner would refund the owner with the respondent's coins.

What is public

Everything. Answers, who gave them, and when are all readable by anyone from realm state and from the transactions themselves. This realm is for information that can be public. Sealed responses would need encryption on the respondent's side before the transaction exists, which gnoweb cannot do on a realm's behalf; that is a deliberate non-goal of v1.

Routes

Example
1/r/<ns>/forms                     index
2/r/<ns>/forms:<id>                a form, fillable
3/r/<ns>/forms:<id>/responses      responses, paginated
4/r/<ns>/forms:<id>/responses.csv  responses as CSV in a code block

Function

Create

func Create(cur realm, slug, title, description, labels, kinds, required, options string, onePerAddr bool, deadline int64) string

Create publishes a new form under slug, which becomes its ID and its URL segment (/r/<ns>/forms:<slug>). Slugs are unique per realm.

Fields are described by four parallel, pipe-separated strings so the call stays usable from gnokey and gnoweb without structured arguments:

Example
1labels:   "Name|Why gno.land?|Server type"
2kinds:    "text|textarea|select"
3required: "1|1|0"
4options:  "||cloud,on-prem,data-center"   (comma-separated; only select uses it)

deadline is a chain height after which the form stops accepting responses, or 0 for none. onePerAddr limits each address to a single response.

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/nym-encapsulate001/forms" -func "Create" -args $'' -args $'' -args $'' -args $'' -args $'' -args $'' -args $'' -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -chainid "pearl-1" -remote "https://rpc.pearl.testnets.gno.land" ADDRESSgnokey query -remote "https://rpc.pearl.testnets.gno.land" auth/accounts/ADDRESS
gnokey maketx call -pkgpath "gno.land/r/nym-encapsulate001/forms" -func "Create" -args $'' -args $'' -args $'' -args $'' -args $'' -args $'' -args $'' -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -broadcast=false ADDRESS > call.tx
gnokey sign -tx-path call.tx -chainid "pearl-1" -account-number ACCOUNTNUMBER -account-sequence SEQUENCENUMBER ADDRESS
gnokey broadcast -remote "https://rpc.pearl.testnets.gno.land" call.tx