1package users23import (4 "errors"5)67const prefix = "r/sys/users: "89var (10 ErrAlreadyWhitelisted = errors.New(prefix + "already whitelisted")11 ErrWhitelistRemoveFailed = errors.New(prefix + "failed to remove address from whitelist")1213 ErrNameTaken = errors.New(prefix + "name/Alias already taken")14 ErrCanonicalCollision = errors.New(prefix + "name collides with a confusable variant of an existing name")15 ErrInvalidAddress = errors.New(prefix + "invalid address")1617 ErrEmptyUsername = errors.New(prefix + "empty username provided")18 ErrNameLikeAddress = errors.New(prefix + "username resembles a gno.land address")19 ErrInvalidUsername = errors.New(prefix + "username must match ^[a-z][a-z0-9]*([_-][a-z0-9]+)*$ (max 64 chars)")2021 ErrAlreadyHasName = errors.New(prefix + "username for this address already registered - try creating an Alias")22 ErrDeletedUser = errors.New(prefix + "cannot register a new username after deleting")2324 ErrUserNotExistOrDeleted = errors.New(prefix + "this user does not exist or was deleted")2526 // ErrInvalidRealm is returned by controller-gated *UserData mutators27 // when the supplied rlm is not the caller's live cur (i.e.28 // rlm.IsCurrent() is false). Closes Class-2 designation forgery via29 // a stored stale realm value whose .Address() resolves to a30 // whitelisted controller. See docs/resources/gno-security.md.31 ErrInvalidRealm = errors.New(prefix + "rlm is not the caller's live cur")32)3334// ErrNotWhitelisted stores the failing caller's realm identity as a35// plain string so the error is a pure data record (no live realm values36// in its fields).37type ErrNotWhitelisted struct {38 Caller string // "CodeRealm{ <addr>, <pkgPath> }" or "UserRealm{ <addr> }" — failed the whitelist check39}4041// NewErrNotWhitelisted constructs the error with the caller's realm42// identity captured as a string at construction time. The _ int43// discriminator keeps this non-crossing (a non-crossing function can't44// take a `realm`-named-`cur` first param, so we use the standard45// _ int, rlm realm shape).46func NewErrNotWhitelisted(_ int, caller realm) ErrNotWhitelisted {47 return ErrNotWhitelisted{48 Caller: caller.String(),49 }50}5152func (e ErrNotWhitelisted) Error() string {53 return prefix + "caller realm/user does not exist in whitelist: " + e.Caller54}55AddControllerAtGenesis(interface {.seal func(); Address func() .uverse.address; IsCode func() bool; IsCurrent func() bool; IsEphemeral func() bool; IsUser func() bool; IsUserCall func() bool; IsUserRun func() bool; PkgPath func() string; Previous func() .uverse.realm; String func() string; Sub func(string) .uverse.realm; Subpath func() string}, addr string)
Canonicalize(name string) string
Controllers() [].uverse.address
GetReadonlyAddrStore() *gno.land/p/nt/bptree/rotree/v0.ReadOnlyTree
GetReadOnlyNameStore() *gno.land/p/nt/bptree/rotree/v0.ReadOnlyTree
IsCanonicalTaken(name string) (existing string, taken bool)
IsController(addr string) bool
IsNameTaken(name string) bool
NewErrNotWhitelisted(int, caller interface {.seal func(); Address func() .uverse.address; IsCode func() bool; IsCurrent func() bool; IsEphemeral func() bool; IsUser func() bool; IsUserCall func() bool; IsUserRun func() bool; PkgPath func() string; Previous func() .uverse.realm; String func() string; Sub func(string) .uverse.realm; Subpath func() string}) struct{Caller string}
ProposeControllerAdditionAndRemoval(cur interface {.seal func(); Address func() .uverse.address; IsCode func() bool; IsCurrent func() bool; IsEphemeral func() bool; IsUser func() bool; IsUserCall func() bool; IsUserRun func() bool; PkgPath func() string; Previous func() .uverse.realm; String func() string; Sub func(string) .uverse.realm; Subpath func() string}, toAdd string, toRemove string) struct{title string; description string; executor gno.land/r/gov/dao.Executor; filter gno.land/r/gov/dao.Filter}
ProposeControllerRemoval(cur interface {.seal func(); Address func() .uverse.address; IsCode func() bool; IsCurrent func() bool; IsEphemeral func() bool; IsUser func() bool; IsUserCall func() bool; IsUserRun func() bool; PkgPath func() string; Previous func() .uverse.realm; String func() string; Sub func(string) .uverse.realm; Subpath func() string}, addr string) struct{title string; description string; executor gno.land/r/gov/dao.Executor; filter gno.land/r/gov/dao.Filter}
ProposeDeleteUser(cur interface {.seal func(); Address func() .uverse.address; IsCode func() bool; IsCurrent func() bool; IsEphemeral func() bool; IsUser func() bool; IsUserCall func() bool; IsUserRun func() bool; PkgPath func() string; Previous func() .uverse.realm; String func() string; Sub func(string) .uverse.realm; Subpath func() string}, addr string) struct{title string; description string; executor gno.land/r/gov/dao.Executor; filter gno.land/r/gov/dao.Filter}
ProposeNewController(cur interface {.seal func(); Address func() .uverse.address; IsCode func() bool; IsCurrent func() bool; IsEphemeral func() bool; IsUser func() bool; IsUserCall func() bool; IsUserRun func() bool; PkgPath func() string; Previous func() .uverse.realm; String func() string; Sub func(string) .uverse.realm; Subpath func() string}, addr string) struct{title string; description string; executor gno.land/r/gov/dao.Executor; filter gno.land/r/gov/dao.Filter}
ProposeRegisterUser(cur interface {.seal func(); Address func() .uverse.address; IsCode func() bool; IsCurrent func() bool; IsEphemeral func() bool; IsUser func() bool; IsUserCall func() bool; IsUserRun func() bool; PkgPath func() string; Previous func() .uverse.realm; String func() string; Sub func(string) .uverse.realm; Subpath func() string}, name string, addr string) struct{title string; description string; executor gno.land/r/gov/dao.Executor; filter gno.land/r/gov/dao.Filter}
ProposeUpdateName(cur interface {.seal func(); Address func() .uverse.address; IsCode func() bool; IsCurrent func() bool; IsEphemeral func() bool; IsUser func() bool; IsUserCall func() bool; IsUserRun func() bool; PkgPath func() string; Previous func() .uverse.realm; String func() string; Sub func(string) .uverse.realm; Subpath func() string}, addr string, newName string) struct{title string; description string; executor gno.land/r/gov/dao.Executor; filter gno.land/r/gov/dao.Filter}
RegisterUser(cur interface {.seal func(); Address func() .uverse.address; IsCode func() bool; IsCurrent func() bool; IsEphemeral func() bool; IsUser func() bool; IsUserCall func() bool; IsUserRun func() bool; PkgPath func() string; Previous func() .uverse.realm; String func() string; Sub func(string) .uverse.realm; Subpath func() string}, name string, address_XXX string) interface {Error func() string}
RegisterUserIgnoreCanonical(cur interface {.seal func(); Address func() .uverse.address; IsCode func() bool; IsCurrent func() bool; IsEphemeral func() bool; IsUser func() bool; IsUserCall func() bool; IsUserRun func() bool; PkgPath func() string; Previous func() .uverse.realm; String func() string; Sub func(string) .uverse.realm; Subpath func() string}, name string, address_XXX string) interface {Error func() string}
Render(string) string
ResolveAddress(addr string) *gno.land/r/sys/users.UserData
ResolveAny(input string) (*gno.land/r/sys/users.UserData, bool)
ResolveName(name string) (data *gno.land/r/sys/users.UserData, isCurrent bool)
Signatures reconstructed verbatim from vm/qfuncs — interface params keep their inline definitions.
vm/qrender output, sanitized (docs/render-security.md) and displayed in an empty-sandbox iframe — scripts, forms and popups cannot run. Links stay inert in-preview; right-click to open.