impl/v1 package

Overview

Package impl is version 1 of the implementation realm of the "self-registering implementation" upgrade pattern (pattern E; see ../../README.md).

Identical wiring to v0, different behaviour. Deploying it takes the facade over on the spot, with no transaction from anybody.

Functions

Instance


              func Instance() facade.Impl

Instance exposes the singleton so a test (or a rollback) can re-register it without redeploying.

Command

gnokey query vm/qeval -remote "https://rpc.gno.land" -data "gno.land/r/moul/x/upgrade/selfreg/impl/v1.Instance()"

Result

Register


              func Register(cur realm)

Register re-registers this implementation with the facade. init does it once at deploy; exposing it as a transaction is what makes a rollback to an already-deployed version a single call.

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/moul/x/upgrade/selfreg/impl/v1" -func "Register" -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -chainid "gnoland-1" -remote "https://rpc.gno.land" ADDRESSgnokey query -remote "https://rpc.gno.land" auth/accounts/ADDRESS
gnokey maketx call -pkgpath "gno.land/r/moul/x/upgrade/selfreg/impl/v1" -func "Register" -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -broadcast=false ADDRESS > call.tx
gnokey sign -tx-path call.tx -chainid "gnoland-1" -account-number ACCOUNTNUMBER -account-sequence SEQUENCENUMBER ADDRESS
gnokey broadcast -remote "https://rpc.gno.land" call.tx

Seal


              func Seal(cur realm)

Seal asks the facade to end its upgradeability, forever. It only succeeds while this implementation is the live one: the facade reads the caller off the crossing frame, so this cannot be used to seal somebody else's tenure.

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/moul/x/upgrade/selfreg/impl/v1" -func "Seal" -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -chainid "gnoland-1" -remote "https://rpc.gno.land" ADDRESSgnokey query -remote "https://rpc.gno.land" auth/accounts/ADDRESS
gnokey maketx call -pkgpath "gno.land/r/moul/x/upgrade/selfreg/impl/v1" -func "Seal" -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -broadcast=false ADDRESS > call.tx
gnokey sign -tx-path call.tx -chainid "gnoland-1" -account-number ACCOUNTNUMBER -account-sequence SEQUENCENUMBER ADDRESS
gnokey broadcast -remote "https://rpc.gno.land" call.tx