package cosmos.group.v1

Get desktop application:
View/edit binary Protocol Buffers messages

Msg is the cosmos.group.v1 Msg service.

• rpc CreateGroup (MsgCreateGroup, MsgCreateGroupResponse)

  tx.proto:18

  CreateGroup creates a new group with an admin account address, a list of members and some optional metadata.

  message MsgCreateGroup

  tx.proto:66

  MsgCreateGroup is the Msg/CreateGroup request type.

  • string admin = 1

    admin is the account address of the group admin.

  • repeated Member members = 2

    members defines the group members.

  • string metadata = 3

    metadata is any arbitrary metadata to attached to the group.

  message MsgCreateGroupResponse

  tx.proto:79

  MsgCreateGroupResponse is the Msg/CreateGroup response type.

  • uint64 group_id = 1

    group_id is the unique ID of the newly created group.

• rpc CreateGroupPolicy (MsgCreateGroupPolicy, MsgCreateGroupPolicyResponse)

  tx.proto:30

  CreateGroupPolicy creates a new group policy using given DecisionPolicy.

  message MsgCreateGroupPolicy

  tx.proto:142

  MsgCreateGroupPolicy is the Msg/CreateGroupPolicy request type.

  • string admin = 1

    admin is the account address of the group admin.

  • uint64 group_id = 2

    group_id is the unique ID of the group.

  • string metadata = 3

    metadata is any arbitrary metadata attached to the group policy.

  • optional google.protobuf.Any decision_policy = 4

    decision_policy specifies the group policy's decision policy.

  message MsgCreateGroupPolicyResponse

  tx.proto:161

  MsgCreateGroupPolicyResponse is the Msg/CreateGroupPolicy response type.

  • string address = 1

    address is the account address of the newly created group policy.

• rpc CreateGroupWithPolicy (MsgCreateGroupWithPolicy, MsgCreateGroupWithPolicyResponse)

  tx.proto:33

  CreateGroupWithPolicy creates a new group with policy.

  message MsgCreateGroupWithPolicy

  tx.proto:182

  MsgCreateGroupWithPolicy is the Msg/CreateGroupWithPolicy request type.

  • string admin = 1

    admin is the account address of the group and group policy admin.

  • repeated Member members = 2

    members defines the group members.

  • string group_metadata = 3

    group_metadata is any arbitrary metadata attached to the group.

  • string group_policy_metadata = 4

    group_policy_metadata is any arbitrary metadata attached to the group policy.

  • bool group_policy_as_admin = 5

    group_policy_as_admin is a boolean field, if set to true, the group policy account address will be used as group and group policy admin.

  • optional google.protobuf.Any decision_policy = 6

    decision_policy specifies the group policy's decision policy.

  message MsgCreateGroupWithPolicyResponse

  tx.proto:205

  MsgCreateGroupWithPolicyResponse is the Msg/CreateGroupWithPolicy response type.

  • uint64 group_id = 1

    group_id is the unique ID of the newly created group with policy.

  • string group_policy_address = 2

    group_policy_address is the account address of the newly created group policy.

• rpc Exec (MsgExec, MsgExecResponse)

  tx.proto:55

  Exec executes a proposal.

  message MsgExec

  tx.proto:339

  MsgExec is the Msg/Exec request type.

  • uint64 proposal_id = 1

    proposal is the unique ID of the proposal.

  • string signer = 2

    signer is the account address used to execute the proposal.

  message MsgExecResponse

  tx.proto:350

  MsgExecResponse is the Msg/Exec request type.

  (message has no fields)

• rpc LeaveGroup (MsgLeaveGroup, MsgLeaveGroupResponse)

  tx.proto:58

  LeaveGroup allows a group member to leave the group.

  message MsgLeaveGroup

  tx.proto:353

  MsgLeaveGroup is the Msg/LeaveGroup request type.

  • string address = 1

    address is the account address of the group member.

  • uint64 group_id = 2

    group_id is the unique ID of the group.

  message MsgLeaveGroupResponse

  tx.proto:364

  MsgLeaveGroupResponse is the Msg/LeaveGroup response type.

  (message has no fields)

• rpc SubmitProposal (MsgSubmitProposal, MsgSubmitProposalResponse)

  tx.proto:46

  SubmitProposal submits a new proposal.

  message MsgSubmitProposal

  tx.proto:272

  MsgSubmitProposal is the Msg/SubmitProposal request type.

  • string address = 1

    address is the account address of group policy.

  • repeated string proposers = 2

    proposers are the account addresses of the proposers. Proposers signatures will be counted as yes votes.

  • string metadata = 3

    metadata is any arbitrary metadata to attached to the proposal.

  • repeated google.protobuf.Any messages = 4

    messages is a list of `sdk.Msg`s that will be executed if the proposal passes.

  • Exec exec = 5

    exec defines the mode of execution of the proposal, whether it should be executed immediately on creation or not. If so, proposers signatures are considered as Yes votes.

  message MsgSubmitProposalResponse

  tx.proto:297

  MsgSubmitProposalResponse is the Msg/SubmitProposal response type.

  • uint64 proposal_id = 1

    proposal is the unique ID of the proposal.

• rpc UpdateGroupAdmin (MsgUpdateGroupAdmin, MsgUpdateGroupAdminResponse)

  tx.proto:24

  UpdateGroupAdmin updates the group admin with given group id and previous admin address.

  message MsgUpdateGroupAdmin

  tx.proto:104

  MsgUpdateGroupAdmin is the Msg/UpdateGroupAdmin request type.

  • string admin = 1

    admin is the current account address of the group admin.

  • uint64 group_id = 2

    group_id is the unique ID of the group.

  • string new_admin = 3

    new_admin is the group new admin account address.

  message MsgUpdateGroupAdminResponse

  tx.proto:118

  MsgUpdateGroupAdminResponse is the Msg/UpdateGroupAdmin response type.

  (message has no fields)

• rpc UpdateGroupMembers (MsgUpdateGroupMembers, MsgUpdateGroupMembersResponse)

  tx.proto:21

  UpdateGroupMembers updates the group members with given group id and admin address.

  message MsgUpdateGroupMembers

  tx.proto:86

  MsgUpdateGroupMembers is the Msg/UpdateGroupMembers request type.

  • string admin = 1

    admin is the account address of the group admin.

  • uint64 group_id = 2

    group_id is the unique ID of the group.

  • repeated Member member_updates = 3

    member_updates is the list of members to update, set weight to 0 to remove a member.

  message MsgUpdateGroupMembersResponse

  tx.proto:101

  MsgUpdateGroupMembersResponse is the Msg/UpdateGroupMembers response type.

  (message has no fields)

• rpc UpdateGroupMetadata (MsgUpdateGroupMetadata, MsgUpdateGroupMetadataResponse)

  tx.proto:27

  UpdateGroupMetadata updates the group metadata with given group id and admin address.

  message MsgUpdateGroupMetadata

  tx.proto:121

  MsgUpdateGroupMetadata is the Msg/UpdateGroupMetadata request type.

  • string admin = 1

    admin is the account address of the group admin.

  • uint64 group_id = 2

    group_id is the unique ID of the group.

  • string metadata = 3

    metadata is the updated group's metadata.

  message MsgUpdateGroupMetadataResponse

  tx.proto:135

  MsgUpdateGroupMetadataResponse is the Msg/UpdateGroupMetadata response type.

  (message has no fields)

• rpc UpdateGroupPolicyAdmin (MsgUpdateGroupPolicyAdmin, MsgUpdateGroupPolicyAdminResponse)

  tx.proto:36

  UpdateGroupPolicyAdmin updates a group policy admin.

  message MsgUpdateGroupPolicyAdmin

  tx.proto:168

  MsgUpdateGroupPolicyAdmin is the Msg/UpdateGroupPolicyAdmin request type.

  • string admin = 1

    admin is the account address of the group admin.

  • string address = 2

    address is the account address of the group policy.

  • string new_admin = 3

    new_admin is the new group policy admin.

  message MsgUpdateGroupPolicyAdminResponse

  tx.proto:215

  MsgUpdateGroupPolicyAdminResponse is the Msg/UpdateGroupPolicyAdmin response type.

  (message has no fields)

• rpc UpdateGroupPolicyDecisionPolicy (MsgUpdateGroupPolicyDecisionPolicy, MsgUpdateGroupPolicyDecisionPolicyResponse)

  tx.proto:39

  UpdateGroupPolicyDecisionPolicy allows a group policy's decision policy to be updated.

  message MsgUpdateGroupPolicyDecisionPolicy

  tx.proto:218

  MsgUpdateGroupPolicyDecisionPolicy is the Msg/UpdateGroupPolicyDecisionPolicy request type.

  • string admin = 1

    admin is the account address of the group admin.

  • string address = 2

    address is the account address of group policy.

  • optional google.protobuf.Any decision_policy = 3

    decision_policy is the updated group policy's decision policy.

  message MsgUpdateGroupPolicyDecisionPolicyResponse

  tx.proto:234

  MsgUpdateGroupPolicyDecisionPolicyResponse is the Msg/UpdateGroupPolicyDecisionPolicy response type.

  (message has no fields)

• rpc UpdateGroupPolicyMetadata (MsgUpdateGroupPolicyMetadata, MsgUpdateGroupPolicyMetadataResponse)

  tx.proto:43

  UpdateGroupPolicyMetadata updates a group policy metadata.

  message MsgUpdateGroupPolicyMetadata

  tx.proto:237

  MsgUpdateGroupPolicyMetadata is the Msg/UpdateGroupPolicyMetadata request type.

  • string admin = 1

    admin is the account address of the group admin.

  • string address = 2

    address is the account address of group policy.

  • string metadata = 3

    metadata is the updated group policy metadata.

  message MsgUpdateGroupPolicyMetadataResponse

  tx.proto:251

  MsgUpdateGroupPolicyMetadataResponse is the Msg/UpdateGroupPolicyMetadata response type.

  (message has no fields)

• rpc Vote (MsgVote, MsgVoteResponse)

  tx.proto:52

  Vote allows a voter to vote on a proposal.

  message MsgVote

  tx.proto:316

  MsgVote is the Msg/Vote request type.

  • uint64 proposal_id = 1

    proposal is the unique ID of the proposal.

  • string voter = 2

    voter is the voter account address.

  • VoteOption option = 3

    option is the voter's choice on the proposal.

  • string metadata = 4

    metadata is any arbitrary metadata to attached to the vote.

  • Exec exec = 5

    exec defines whether the proposal should be executed immediately after voting or not.

  message MsgVoteResponse

  tx.proto:336

  MsgVoteResponse is the Msg/Vote response type.

  (message has no fields)

• rpc WithdrawProposal (MsgWithdrawProposal, MsgWithdrawProposalResponse)

  tx.proto:49

  WithdrawProposal aborts a proposal.

  message MsgWithdrawProposal

  tx.proto:304

  MsgWithdrawProposal is the Msg/WithdrawProposal request type.

  • uint64 proposal_id = 1

    proposal is the unique ID of the proposal.

  • string address = 2

    address is the admin of the group policy or one of the proposer of the proposal.

  message MsgWithdrawProposalResponse

  tx.proto:313

  MsgWithdrawProposalResponse is the Msg/WithdrawProposal response type.

  (message has no fields)

Query is the cosmos.group.v1 Query service.

• rpc GroupInfo (QueryGroupInfoRequest, QueryGroupInfoResponse)

  query.proto:17

  GroupInfo queries group info based on group id.

  message QueryGroupInfoRequest

  query.proto:83

  QueryGroupInfoRequest is the Query/GroupInfo request type.

  • uint64 group_id = 1

    group_id is the unique ID of the group.

  message QueryGroupInfoResponse

  query.proto:90

  QueryGroupInfoResponse is the Query/GroupInfo response type.

  • optional GroupInfo info = 1

    info is the GroupInfo for the group.

• rpc GroupMembers (QueryGroupMembersRequest, QueryGroupMembersResponse)

  query.proto:27

  GroupMembers queries members of a group

  message QueryGroupMembersRequest

  query.proto:111

  QueryGroupMembersRequest is the Query/GroupMembers request type.

  • uint64 group_id = 1

    group_id is the unique ID of the group.

  • optional base.query.v1beta1.PageRequest pagination = 2

    pagination defines an optional pagination for the request.

  message QueryGroupMembersResponse

  query.proto:121

  QueryGroupMembersResponse is the Query/GroupMembersResponse response type.

  • repeated GroupMember members = 1

    members are the members of the group with given group_id.

  • optional base.query.v1beta1.PageResponse pagination = 2

    pagination defines the pagination in the response.

• rpc GroupPoliciesByAdmin (QueryGroupPoliciesByAdminRequest, QueryGroupPoliciesByAdminResponse)

  query.proto:42

  GroupsByAdmin queries group policies by admin address.

  message QueryGroupPoliciesByAdminRequest

  query.proto:171

  QueryGroupPoliciesByAdminRequest is the Query/GroupPoliciesByAdmin request type.

  • string admin = 1

    admin is the admin address of the group policy.

  • optional base.query.v1beta1.PageRequest pagination = 2

    pagination defines an optional pagination for the request.

  message QueryGroupPoliciesByAdminResponse

  query.proto:181

  QueryGroupPoliciesByAdminResponse is the Query/GroupPoliciesByAdmin response type.

  • repeated GroupPolicyInfo group_policies = 1

    group_policies are the group policies info with provided admin.

  • optional base.query.v1beta1.PageResponse pagination = 2

    pagination defines the pagination in the response.

• rpc GroupPoliciesByGroup (QueryGroupPoliciesByGroupRequest, QueryGroupPoliciesByGroupResponse)

  query.proto:37

  GroupPoliciesByGroup queries group policies by group id.

  message QueryGroupPoliciesByGroupRequest

  query.proto:151

  QueryGroupPoliciesByGroupRequest is the Query/GroupPoliciesByGroup request type.

  • uint64 group_id = 1

    group_id is the unique ID of the group policy's group.

  • optional base.query.v1beta1.PageRequest pagination = 2

    pagination defines an optional pagination for the request.

  message QueryGroupPoliciesByGroupResponse

  query.proto:161

  QueryGroupPoliciesByGroupResponse is the Query/GroupPoliciesByGroup response type.

  • repeated GroupPolicyInfo group_policies = 1

    group_policies are the group policies info associated with the provided group.

  • optional base.query.v1beta1.PageResponse pagination = 2

    pagination defines the pagination in the response.

• rpc GroupPolicyInfo (QueryGroupPolicyInfoRequest, QueryGroupPolicyInfoResponse)

  query.proto:22

  GroupPolicyInfo queries group policy info based on account address of group policy.

  message QueryGroupPolicyInfoRequest

  query.proto:97

  QueryGroupPolicyInfoRequest is the Query/GroupPolicyInfo request type.

  • string address = 1

    address is the account address of the group policy.

  message QueryGroupPolicyInfoResponse

  query.proto:104

  QueryGroupPolicyInfoResponse is the Query/GroupPolicyInfo response type.

  • optional GroupPolicyInfo info = 1

    info is the GroupPolicyInfo for the group policy.

• rpc GroupsByAdmin (QueryGroupsByAdminRequest, QueryGroupsByAdminResponse)

  query.proto:32

  GroupsByAdmin queries groups by admin address.

  message QueryGroupsByAdminRequest

  query.proto:131

  QueryGroupsByAdminRequest is the Query/GroupsByAdmin request type.

  • string admin = 1

    admin is the account address of a group's admin.

  • optional base.query.v1beta1.PageRequest pagination = 2

    pagination defines an optional pagination for the request.

  message QueryGroupsByAdminResponse

  query.proto:141

  QueryGroupsByAdminResponse is the Query/GroupsByAdminResponse response type.

  • repeated GroupInfo groups = 1

    groups are the groups info with the provided admin.

  • optional base.query.v1beta1.PageResponse pagination = 2

    pagination defines the pagination in the response.

• rpc GroupsByMember (QueryGroupsByMemberRequest, QueryGroupsByMemberResponse)

  query.proto:72

  GroupsByMember queries groups by member address.

  message QueryGroupsByMemberRequest

  query.proto:281

  QueryGroupsByMemberRequest is the Query/GroupsByMember request type.

  • string address = 1

    address is the group member address.

  • optional base.query.v1beta1.PageRequest pagination = 2

    pagination defines an optional pagination for the request.

  message QueryGroupsByMemberResponse

  query.proto:290

  QueryGroupsByMemberResponse is the Query/GroupsByMember response type.

  • repeated GroupInfo groups = 1

    groups are the groups info with the provided group member.

  • optional base.query.v1beta1.PageResponse pagination = 2

    pagination defines the pagination in the response.

• rpc Proposal (QueryProposalRequest, QueryProposalResponse)

  query.proto:47

  Proposal queries a proposal based on proposal id.

  message QueryProposalRequest

  query.proto:191

  QueryProposalRequest is the Query/Proposal request type.

  • uint64 proposal_id = 1

    proposal_id is the unique ID of a proposal.

  message QueryProposalResponse

  query.proto:198

  QueryProposalResponse is the Query/Proposal response type.

  • optional Proposal proposal = 1

    proposal is the proposal info.

• rpc ProposalsByGroupPolicy (QueryProposalsByGroupPolicyRequest, QueryProposalsByGroupPolicyResponse)

  query.proto:52

  ProposalsByGroupPolicy queries proposals based on account address of group policy.

  message QueryProposalsByGroupPolicyRequest

  query.proto:205

  QueryProposalsByGroupPolicyRequest is the Query/ProposalByGroupPolicy request type.

  • string address = 1

    address is the account address of the group policy related to proposals.

  • optional base.query.v1beta1.PageRequest pagination = 2

    pagination defines an optional pagination for the request.

  message QueryProposalsByGroupPolicyResponse

  query.proto:215

  QueryProposalsByGroupPolicyResponse is the Query/ProposalByGroupPolicy response type.

  • repeated Proposal proposals = 1

    proposals are the proposals with given group policy.

  • optional base.query.v1beta1.PageResponse pagination = 2

    pagination defines the pagination in the response.

• rpc TallyResult (QueryTallyResultRequest, QueryTallyResultResponse)

  query.proto:77

  TallyResult queries the tally of a proposal votes.

  message QueryTallyResultRequest

  query.proto:299

  QueryTallyResultRequest is the Query/TallyResult request type.

  • uint64 proposal_id = 1

    proposal_id is the unique id of a proposal.

  message QueryTallyResultResponse

  query.proto:305

  QueryTallyResultResponse is the Query/TallyResult response type.

  • optional TallyResult tally = 1

    tally defines the requested tally.

• rpc VoteByProposalVoter (QueryVoteByProposalVoterRequest, QueryVoteByProposalVoterResponse)

  query.proto:57

  VoteByProposalVoter queries a vote by proposal id and voter.

  message QueryVoteByProposalVoterRequest

  query.proto:225

  QueryVoteByProposalVoterRequest is the Query/VoteByProposalVoter request type.

  • uint64 proposal_id = 1

    proposal_id is the unique ID of a proposal.

  • string voter = 2

    voter is a proposal voter account address.

  message QueryVoteByProposalVoterResponse

  query.proto:235

  QueryVoteByProposalVoterResponse is the Query/VoteByProposalVoter response type.

  • optional Vote vote = 1

    vote is the vote with given proposal_id and voter.

• rpc VotesByProposal (QueryVotesByProposalRequest, QueryVotesByProposalResponse)

  query.proto:62

  VotesByProposal queries a vote by proposal.

  message QueryVotesByProposalRequest

  query.proto:242

  QueryVotesByProposalRequest is the Query/VotesByProposal request type.

  • uint64 proposal_id = 1

    proposal_id is the unique ID of a proposal.

  • optional base.query.v1beta1.PageRequest pagination = 2

    pagination defines an optional pagination for the request.

  message QueryVotesByProposalResponse

  query.proto:252

  QueryVotesByProposalResponse is the Query/VotesByProposal response type.

  • repeated Vote votes = 1

    votes are the list of votes for given proposal_id.

  • optional base.query.v1beta1.PageResponse pagination = 2

    pagination defines the pagination in the response.

• rpc VotesByVoter (QueryVotesByVoterRequest, QueryVotesByVoterResponse)

  query.proto:67

  VotesByVoter queries a vote by voter.

  message QueryVotesByVoterRequest

  query.proto:262

  QueryVotesByVoterRequest is the Query/VotesByVoter request type.

  • string voter = 1

    voter is a proposal voter account address.

  • optional base.query.v1beta1.PageRequest pagination = 2

    pagination defines an optional pagination for the request.

  message QueryVotesByVoterResponse

  query.proto:271

  QueryVotesByVoterResponse is the Query/VotesByVoter response type.

  • repeated Vote votes = 1

    votes are the list of votes by given voter.

  • optional base.query.v1beta1.PageResponse pagination = 2

    pagination defines the pagination in the response.

DecisionPolicyWindows defines the different windows for voting and execution.

Used in: PercentageDecisionPolicy, ThresholdDecisionPolicy

• optional google.protobuf.Duration voting_period = 1

  voting_period is the duration from submission of a proposal to the end of voting period Within this times votes can be submitted with MsgVote.

• optional google.protobuf.Duration min_execution_period = 2

  min_execution_period is the minimum duration after the proposal submission where members can start sending MsgExec. This means that the window for sending a MsgExec transaction is: `[ submission + min_execution_period ; submission + voting_period + max_execution_period]` where max_execution_period is a app-specific config, defined in the keeper. If not set, min_execution_period will default to 0. Please make sure to set a `min_execution_period` that is smaller than `voting_period + max_execution_period`, or else the above execution window is empty, meaning that all proposals created with this decision policy won't be able to be executed.

EventCreateGroup is an event emitted when a group is created.

• uint64 group_id = 1

  group_id is the unique ID of the group.

EventCreateGroupPolicy is an event emitted when a group policy is created.

• string address = 1

  address is the account address of the group policy.

EventExec is an event emitted when a proposal is executed.

• uint64 proposal_id = 1

  proposal_id is the unique ID of the proposal.

• ProposalExecutorResult result = 2

  result is the proposal execution result.

EventLeaveGroup is an event emitted when group member leaves the group.

• uint64 group_id = 1

  group_id is the unique ID of the group.

• string address = 2

  address is the account address of the group member.

EventSubmitProposal is an event emitted when a proposal is created.

• uint64 proposal_id = 1

  proposal_id is the unique ID of the proposal.

EventUpdateGroup is an event emitted when a group is updated.

• uint64 group_id = 1

  group_id is the unique ID of the group.

EventUpdateGroupPolicy is an event emitted when a group policy is updated.

• string address = 1

  address is the account address of the group policy.

EventVote is an event emitted when a voter votes on a proposal.

• uint64 proposal_id = 1

  proposal_id is the unique ID of the proposal.

EventWithdrawProposal is an event emitted when a proposal is withdrawn.

• uint64 proposal_id = 1

  proposal_id is the unique ID of the proposal.

Exec defines modes of execution of a proposal on creation or on new vote.

Used in: MsgSubmitProposal, MsgVote

• EXEC_UNSPECIFIED = 0

  An empty value means that there should be a separate MsgExec request for the proposal to execute.

• EXEC_TRY = 1

  Try to execute the proposal immediately. If the proposal is not allowed per the DecisionPolicy, the proposal will still be open and could be executed at a later point.

GenesisState defines the group module's genesis state.

• uint64 group_seq = 1

  group_seq is the group table orm.Sequence, it is used to get the next group ID.

• repeated GroupInfo groups = 2

  groups is the list of groups info.

• repeated GroupMember group_members = 3

  group_members is the list of groups members.

• uint64 group_policy_seq = 4

  group_policy_seq is the group policy table orm.Sequence, it is used to generate the next group policy account address.

• repeated GroupPolicyInfo group_policies = 5

  group_policies is the list of group policies info.

• uint64 proposal_seq = 6

  proposal_seq is the proposal table orm.Sequence, it is used to get the next proposal ID.

• repeated Proposal proposals = 7

  proposals is the list of proposals.

• repeated Vote votes = 8

  votes is the list of votes.

GroupInfo represents the high-level on-chain information for a group.

Used in: GenesisState, QueryGroupInfoResponse, QueryGroupsByAdminResponse, QueryGroupsByMemberResponse

• uint64 id = 1

  id is the unique ID of the group.

• string admin = 2

  admin is the account address of the group's admin.

• string metadata = 3

  metadata is any arbitrary metadata to attached to the group.

• uint64 version = 4

  version is used to track changes to a group's membership structure that would break existing proposals. Whenever any members weight is changed, or any member is added or removed this version is incremented and will cause proposals based on older versions of this group to fail

• string total_weight = 5

  total_weight is the sum of the group members' weights.

• optional google.protobuf.Timestamp created_at = 6

  created_at is a timestamp specifying when a group was created.

GroupMember represents the relationship between a group and a member.

Used in: GenesisState, QueryGroupMembersResponse

• uint64 group_id = 1

  group_id is the unique ID of the group.

• optional Member member = 2

  member is the member data.

GroupPolicyInfo represents the high-level on-chain information for a group policy.

Used in: GenesisState, QueryGroupPoliciesByAdminResponse, QueryGroupPoliciesByGroupResponse, QueryGroupPolicyInfoResponse

• string address = 1

  address is the account address of group policy.

• uint64 group_id = 2

  group_id is the unique ID of the group.

• string admin = 3

  admin is the account address of the group admin.

• string metadata = 4

  metadata is any arbitrary metadata to attached to the group policy.

• uint64 version = 5

  version is used to track changes to a group's GroupPolicyInfo structure that would create a different result on a running proposal.

• optional google.protobuf.Any decision_policy = 6

  decision_policy specifies the group policy's decision policy.

• optional google.protobuf.Timestamp created_at = 7

  created_at is a timestamp specifying when a group policy was created.

Member represents a group member with an account address, non-zero weight and metadata.

Used in: GroupMember, Members, MsgCreateGroup, MsgCreateGroupWithPolicy, MsgUpdateGroupMembers

• string address = 1

  address is the member's account address.

• string weight = 2

  weight is the member's voting weight that should be greater than 0.

• string metadata = 3

  metadata is any arbitrary metadata to attached to the member.

• optional google.protobuf.Timestamp added_at = 4

  added_at is a timestamp specifying when a member was added.

Members defines a repeated slice of Member objects.

• repeated Member members = 1

  members is the list of members.

PercentageDecisionPolicy implements the DecisionPolicy interface

• string percentage = 1

  percentage is the minimum percentage the weighted sum of yes votes must meet for a proposal to succeed.

• optional DecisionPolicyWindows windows = 2

  windows defines the different windows for voting and execution.

Proposal defines a group proposal. Any member of a group can submit a proposal for a group policy to decide upon. A proposal consists of a set of `sdk.Msg`s that will be executed if the proposal passes as well as some optional metadata associated with the proposal.

Used in: GenesisState, QueryProposalResponse, QueryProposalsByGroupPolicyResponse

• uint64 id = 1

  id is the unique id of the proposal.

• string address = 2

  address is the account address of group policy.

• string metadata = 3

  metadata is any arbitrary metadata to attached to the proposal.

• repeated string proposers = 4

  proposers are the account addresses of the proposers.

• optional google.protobuf.Timestamp submit_time = 5

  submit_time is a timestamp specifying when a proposal was submitted.

• uint64 group_version = 6

  group_version tracks the version of the group that this proposal corresponds to. When group membership is changed, existing proposals from previous group versions will become invalid.

• uint64 group_policy_version = 7

  group_policy_version tracks the version of the group policy that this proposal corresponds to. When a decision policy is changed, existing proposals from previous policy versions will become invalid.

• ProposalStatus status = 8

  status represents the high level position in the life cycle of the proposal. Initial value is Submitted.

• ProposalResult result = 9

  result is the final result based on the votes and election rule. Initial value is unfinalized. The result is persisted so that clients can always rely on this state and not have to replicate the logic.

• optional TallyResult final_tally_result = 10

  final_tally_result contains the sums of all weighted votes for this proposal for each vote option, after tallying. When querying a proposal via gRPC, this field is not populated until the proposal's voting period has ended.

• optional google.protobuf.Timestamp voting_period_end = 11

  voting_period_end is the timestamp before which voting must be done. Unless a successfull MsgExec is called before (to execute a proposal whose tally is successful before the voting period ends), tallying will be done at this point, and the `final_tally_result`, as well as `status` and `result` fields will be accordingly updated.

• ProposalExecutorResult executor_result = 12

  executor_result is the final result based on the votes and election rule. Initial value is NotRun.

• repeated google.protobuf.Any messages = 13

  messages is a list of Msgs that will be executed if the proposal passes.

ProposalExecutorResult defines types of proposal executor results.

Used in: EventExec, Proposal

• PROPOSAL_EXECUTOR_RESULT_UNSPECIFIED = 0

  An empty value is not allowed.

• PROPOSAL_EXECUTOR_RESULT_NOT_RUN = 1

  We have not yet run the executor.

• PROPOSAL_EXECUTOR_RESULT_SUCCESS = 2

  The executor was successful and proposed action updated state.

• PROPOSAL_EXECUTOR_RESULT_FAILURE = 3

  The executor returned an error and proposed action didn't update state.

ProposalResult defines types of proposal results.

Used in: Proposal

• PROPOSAL_RESULT_UNSPECIFIED = 0

  An empty value is invalid and not allowed

• PROPOSAL_RESULT_UNFINALIZED = 1

  Until a final tally has happened the status is unfinalized

• PROPOSAL_RESULT_ACCEPTED = 2

  Final result of the tally

• PROPOSAL_RESULT_REJECTED = 3

  Final result of the tally

ProposalStatus defines proposal statuses.

Used in: Proposal

• PROPOSAL_STATUS_UNSPECIFIED = 0

  An empty value is invalid and not allowed.

• PROPOSAL_STATUS_SUBMITTED = 1

  Initial status of a proposal when persisted.

• PROPOSAL_STATUS_CLOSED = 2

  Final status of a proposal when the final tally was executed.

• PROPOSAL_STATUS_ABORTED = 3

  Final status of a proposal when the group was modified before the final tally.

• PROPOSAL_STATUS_WITHDRAWN = 4

  A proposal can be deleted before the voting start time by the owner. When this happens the final status is Withdrawn.

TallyResult represents the sum of weighted votes for each vote option.

Used in: Proposal, QueryTallyResultResponse

• string yes_count = 1

  yes_count is the weighted sum of yes votes.

• string abstain_count = 2

  abstain_count is the weighted sum of abstainers.

• string no_count = 3

  no is the weighted sum of no votes.

• string no_with_veto_count = 4

  no_with_veto_count is the weighted sum of veto.

ThresholdDecisionPolicy implements the DecisionPolicy interface

• string threshold = 1

  threshold is the minimum weighted sum of yes votes that must be met or exceeded for a proposal to succeed.

• optional DecisionPolicyWindows windows = 2

  windows defines the different windows for voting and execution.

Vote represents a vote for a proposal.

Used in: GenesisState, QueryVoteByProposalVoterResponse, QueryVotesByProposalResponse, QueryVotesByVoterResponse

• uint64 proposal_id = 1

  proposal is the unique ID of the proposal.

• string voter = 2

  voter is the account address of the voter.

• VoteOption option = 3

  option is the voter's choice on the proposal.

• string metadata = 4

  metadata is any arbitrary metadata to attached to the vote.

• optional google.protobuf.Timestamp submit_time = 5

  submit_time is the timestamp when the vote was submitted.

VoteOption enumerates the valid vote options for a given proposal.

Used in: MsgVote, Vote

• VOTE_OPTION_UNSPECIFIED = 0

  VOTE_OPTION_UNSPECIFIED defines a no-op vote option.

• VOTE_OPTION_YES = 1

  VOTE_OPTION_YES defines a yes vote option.

• VOTE_OPTION_ABSTAIN = 2

  VOTE_OPTION_ABSTAIN defines an abstain vote option.

• VOTE_OPTION_NO = 3

  VOTE_OPTION_NO defines a no vote option.

• VOTE_OPTION_NO_WITH_VETO = 4

  VOTE_OPTION_NO_WITH_VETO defines a no with veto vote option.