Search Apps Documentation Source Content File Folder Download Copy Actions Download

v0 package

Overview

v0 - Unaudited: This is an initial version that has not yet been formally audited. A fully audited version will be published as a subsequent release. Use in production at your own risk. Package commondao provides a reference realm implementation of the commondao package for managing Decentralized Autonomous Organizations.

Functions

CreateDissolutionProposal

func CreateDissolutionProposal(_ realm, daoID uint64) uint64

CreateDissolutionProposal creates a new proposal to dissolve a DAO or SubDAO. SubDAOs can only be dissolveed by the the parent DAO. Parameters: - daoID: ID of the DAO to dissolve (required)

Param

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/nt/commondao/v0" -func "CreateDissolutionProposal" -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -chainid "dev" -remote "https://api.gno.berty.io:443" ADDRESSgnokey query -remote "https://api.gno.berty.io:443" auth/accounts/ADDRESS
gnokey maketx call -pkgpath "gno.land/r/nt/commondao/v0" -func "CreateDissolutionProposal" -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -broadcast=false ADDRESS > call.tx
gnokey sign -tx-path call.tx -chainid "dev" -account-number ACCOUNTNUMBER -account-sequence SEQUENCENUMBER ADDRESS
gnokey broadcast -remote "https://api.gno.berty.io:443" call.tx

CreateMembersUpdateProposal

func CreateMembersUpdateProposal(_ realm, daoID uint64, newMembers, removeMembers string) uint64

CreateMembersUpdateProposal creates a new proposal to add and/or remove DAO members. Parameters: - daoID: ID of the root DAO (required) - newMembers: Comma separated list of addresses to add as members - removeMembers: Comma separated list of member addresses to remove

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/nt/commondao/v0" -func "CreateMembersUpdateProposal" -args $'' -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -chainid "dev" -remote "https://api.gno.berty.io:443" ADDRESSgnokey query -remote "https://api.gno.berty.io:443" auth/accounts/ADDRESS
gnokey maketx call -pkgpath "gno.land/r/nt/commondao/v0" -func "CreateMembersUpdateProposal" -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 "dev" -account-number ACCOUNTNUMBER -account-sequence SEQUENCENUMBER ADDRESS
gnokey broadcast -remote "https://api.gno.berty.io:443" call.tx

CreateSubDAOProposal

func CreateSubDAOProposal(_ realm, daoID uint64, name, members string) uint64

CreateSubDAOProposal creates a new proposal to create a new SubDAO. Parameters: - daoID: ID of the parent DAO (required) - name: A name for the SubDAO (required) - members: Comma separated list of addresses to add as members

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/nt/commondao/v0" -func "CreateSubDAOProposal" -args $'' -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -chainid "dev" -remote "https://api.gno.berty.io:443" ADDRESSgnokey query -remote "https://api.gno.berty.io:443" auth/accounts/ADDRESS
gnokey maketx call -pkgpath "gno.land/r/nt/commondao/v0" -func "CreateSubDAOProposal" -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 "dev" -account-number ACCOUNTNUMBER -account-sequence SEQUENCENUMBER ADDRESS
gnokey broadcast -remote "https://api.gno.berty.io:443" call.tx

CreateTextProposal

func CreateTextProposal(_ realm, daoID uint64, title, body string, votingDays uint8) uint64

CreateTextProposal creates a new general text proposal. Parameters: - daoID: ID of the root DAO (required) - title: Title of the proposal (required) - body: Body of the proposal (required) - votingDays: The number of days where proposal accepts votes. The default voting period is 7 days.

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/nt/commondao/v0" -func "CreateTextProposal" -args $'' -args $'' -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -chainid "dev" -remote "https://api.gno.berty.io:443" ADDRESSgnokey query -remote "https://api.gno.berty.io:443" auth/accounts/ADDRESS
gnokey maketx call -pkgpath "gno.land/r/nt/commondao/v0" -func "CreateTextProposal" -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 "dev" -account-number ACCOUNTNUMBER -account-sequence SEQUENCENUMBER ADDRESS
gnokey broadcast -remote "https://api.gno.berty.io:443" call.tx

Execute

func Execute(_ realm, daoID, proposalID uint64)

Execute executes a DAO proposal.

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/nt/commondao/v0" -func "Execute" -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -chainid "dev" -remote "https://api.gno.berty.io:443" ADDRESSgnokey query -remote "https://api.gno.berty.io:443" auth/accounts/ADDRESS
gnokey maketx call -pkgpath "gno.land/r/nt/commondao/v0" -func "Execute" -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -broadcast=false ADDRESS > call.tx
gnokey sign -tx-path call.tx -chainid "dev" -account-number ACCOUNTNUMBER -account-sequence SEQUENCENUMBER ADDRESS
gnokey broadcast -remote "https://api.gno.berty.io:443" call.tx

Get

func Get(daoID uint64) *commondao.CommonDAO

Get returns a common DAO searched by ID. It panics if caller doesn't have ownership of the DAO instance. Only toplevel DAOs are returned, to get SubDAOs use \`GetSubDAO()\`.

Param

Command

gnokey query vm/qeval -remote "https://api.gno.berty.io:443" -data "gno.land/r/nt/commondao/v0.Get()"

Result

GetSize

func GetSize(rootID uint64) int

GetSize returns the number of SubDAOs under a specified root DAO.

Param

Command

gnokey query vm/qeval -remote "https://api.gno.berty.io:443" -data "gno.land/r/nt/commondao/v0.GetSize()"

Result

Invite

func Invite(_ realm, invitee address)

Invite invites a user to the realm. A user invitation is required to start creating new DAOs.

Param

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/nt/commondao/v0" -func "Invite" -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -chainid "dev" -remote "https://api.gno.berty.io:443" ADDRESSgnokey query -remote "https://api.gno.berty.io:443" auth/accounts/ADDRESS
gnokey maketx call -pkgpath "gno.land/r/nt/commondao/v0" -func "Invite" -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -broadcast=false ADDRESS > call.tx
gnokey sign -tx-path call.tx -chainid "dev" -account-number ACCOUNTNUMBER -account-sequence SEQUENCENUMBER ADDRESS
gnokey broadcast -remote "https://api.gno.berty.io:443" call.tx

IsInvited

func IsInvited(addr address) bool

IsInvited check if an address has an invitation to the realm.

Param

Command

gnokey query vm/qeval -remote "https://api.gno.berty.io:443" -data "gno.land/r/nt/commondao/v0.IsInvited()"

Result

IsOwner

func IsOwner(addr address, daoID uint64) bool

IsOwner checks if an address has ownership of a DAO.

Params

Command

gnokey query vm/qeval -remote "https://api.gno.berty.io:443" -data "gno.land/r/nt/commondao/v0.IsOwner(,)"

Result

New

func New(_ realm, name string, options ...Option) *commondao.CommonDAO

New creates a new CommonDAO. An invitation is required to be able to create new DAOs.

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/nt/commondao/v0" -func "New" -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -chainid "dev" -remote "https://api.gno.berty.io:443" ADDRESSgnokey query -remote "https://api.gno.berty.io:443" auth/accounts/ADDRESS
gnokey maketx call -pkgpath "gno.land/r/nt/commondao/v0" -func "New" -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -broadcast=false ADDRESS > call.tx
gnokey sign -tx-path call.tx -chainid "dev" -account-number ACCOUNTNUMBER -account-sequence SEQUENCENUMBER ADDRESS
gnokey broadcast -remote "https://api.gno.berty.io:443" call.tx

NewSubDAO

func NewSubDAO(_ realm, name string, parentID uint64, options ...Option) *commondao.CommonDAO

NewSubDAO creates a new SubDAO.

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/nt/commondao/v0" -func "NewSubDAO" -args $'' -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -chainid "dev" -remote "https://api.gno.berty.io:443" ADDRESSgnokey query -remote "https://api.gno.berty.io:443" auth/accounts/ADDRESS
gnokey maketx call -pkgpath "gno.land/r/nt/commondao/v0" -func "NewSubDAO" -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 "dev" -account-number ACCOUNTNUMBER -account-sequence SEQUENCENUMBER ADDRESS
gnokey broadcast -remote "https://api.gno.berty.io:443" call.tx

Render

func Render(path string) string

Param

Command

gnokey query vm/qeval -remote "https://api.gno.berty.io:443" -data "gno.land/r/nt/commondao/v0.Render()"

Result

TransferOwnership

func TransferOwnership(cur realm, daoID uint64, newOwner address)

TransferOwnership transfers DAO ownership to a different address.

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/nt/commondao/v0" -func "TransferOwnership" -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -chainid "dev" -remote "https://api.gno.berty.io:443" ADDRESSgnokey query -remote "https://api.gno.berty.io:443" auth/accounts/ADDRESS
gnokey maketx call -pkgpath "gno.land/r/nt/commondao/v0" -func "TransferOwnership" -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -broadcast=false ADDRESS > call.tx
gnokey sign -tx-path call.tx -chainid "dev" -account-number ACCOUNTNUMBER -account-sequence SEQUENCENUMBER ADDRESS
gnokey broadcast -remote "https://api.gno.berty.io:443" call.tx

Vote

func Vote(_ realm, daoID, proposalID uint64, vote commondao.VoteChoice, reason string)

Vote submits a vote for a DAO proposal.

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/nt/commondao/v0" -func "Vote" -args $'' -args $'' -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -chainid "dev" -remote "https://api.gno.berty.io:443" ADDRESSgnokey query -remote "https://api.gno.berty.io:443" auth/accounts/ADDRESS
gnokey maketx call -pkgpath "gno.land/r/nt/commondao/v0" -func "Vote" -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 "dev" -account-number ACCOUNTNUMBER -account-sequence SEQUENCENUMBER ADDRESS
gnokey broadcast -remote "https://api.gno.berty.io:443" call.tx

NewIterator

func NewIterator(rootID uint64, options ...IteratorOption) Iterator

NewIterator returns a SubDAO iterator.

Params

Command

gnokey query vm/qeval -remote "https://api.gno.berty.io:443" -data "gno.land/r/nt/commondao/v0.NewIterator(,)"

Result

WithCount

func WithCount(count uint) IteratorOption

WithCount assigns a number to limit the number of iterated DAOs. A zero count means to iterates until the last DAO.

Param

Command

gnokey query vm/qeval -remote "https://api.gno.berty.io:443" -data "gno.land/r/nt/commondao/v0.WithCount()"

Result

WithOffset

func WithOffset(offset uint) IteratorOption

WithOffset assigns a initial offset to start iterating DAOs. Offset can be used to reduce the number of iterated DAOs for example during pagination.

Param

Command

gnokey query vm/qeval -remote "https://api.gno.berty.io:443" -data "gno.land/r/nt/commondao/v0.WithOffset()"

Result

AllowChildren

func AllowChildren(allow bool) Option

AllowChildren configures DAO support for SubDAOs.

Param

Command

gnokey query vm/qeval -remote "https://api.gno.berty.io:443" -data "gno.land/r/nt/commondao/v0.AllowChildren()"

Result

AllowDissolutionProposals

func AllowDissolutionProposals(allow bool) Option

AllowDissolutionProposals configures support for DAO dissolution proposals.

Param

Command

gnokey query vm/qeval -remote "https://api.gno.berty.io:443" -data "gno.land/r/nt/commondao/v0.AllowDissolutionProposals()"

Result

AllowExecution

func AllowExecution(allow bool) Option

AllowExecution configures DAO support for executing proposals through CommonDAO realm.

Param

Command

gnokey query vm/qeval -remote "https://api.gno.berty.io:443" -data "gno.land/r/nt/commondao/v0.AllowExecution()"

Result

AllowListing

func AllowListing(allow bool) Option

AllowListing configures DAO listing within CommonDAO realm.

Param

Command

gnokey query vm/qeval -remote "https://api.gno.berty.io:443" -data "gno.land/r/nt/commondao/v0.AllowListing()"

Result

AllowMembersUpdate

func AllowMembersUpdate(allow bool) Option

AllowMembersUpdate configures support for DAO members update proposals.

Param

Command

gnokey query vm/qeval -remote "https://api.gno.berty.io:443" -data "gno.land/r/nt/commondao/v0.AllowMembersUpdate()"

Result

AllowRender

func AllowRender(allow bool) Option

AllowRender configures DAO, proposals and votes rendering within CommonDAO.

Param

Command

gnokey query vm/qeval -remote "https://api.gno.berty.io:443" -data "gno.land/r/nt/commondao/v0.AllowRender()"

Result

AllowSubDAOPorposals

func AllowSubDAOPorposals(allow bool) Option

AllowSubDAOPorposals configures support for SubDAO creation proposals.

Param

Command

gnokey query vm/qeval -remote "https://api.gno.berty.io:443" -data "gno.land/r/nt/commondao/v0.AllowSubDAOPorposals()"

Result

AllowTextProposals

func AllowTextProposals(allow bool) Option

AllowTextProposals configures support generic text proposals.

Param

Command

gnokey query vm/qeval -remote "https://api.gno.berty.io:443" -data "gno.land/r/nt/commondao/v0.AllowTextProposals()"

Result

AllowVoting

func AllowVoting(allow bool) Option

AllowVoting configures DAO support for voting through CommonDAO realm.

Param

Command

gnokey query vm/qeval -remote "https://api.gno.berty.io:443" -data "gno.land/r/nt/commondao/v0.AllowVoting()"

Result

GetOptions

func GetOptions(daoID uint64) *Options

GetOptions returns the configuration of a DAO. It panics if caller doesn't have ownership of the DAO instance.

Param

Command

gnokey query vm/qeval -remote "https://api.gno.berty.io:443" -data "gno.land/r/nt/commondao/v0.GetOptions()"

Result

NewTextPropDefinition

func NewTextPropDefinition(title, body string, quorum float64, votingPeriod time.Duration) TextPropDefinition

NewTextPropDefinition creates a new general text proposal definition.

Params

Command

gnokey query vm/qeval -remote "https://api.gno.berty.io:443" -data "gno.land/r/nt/commondao/v0.NewTextPropDefinition(,,,)"

Result