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:20

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

  message MsgCreateGroup

  tx.proto:68

  MsgCreateGroup is the Msg/CreateGroup request type.

  • string admin = 1

    admin is the account address of the group admin.

  • repeated MemberRequest members = 2

    members defines the group members.

  • string metadata = 3

    metadata is any arbitrary metadata to attached to the group.

  message MsgCreateGroupResponse

  tx.proto:83

  MsgCreateGroupResponse is the Msg/CreateGroup response type.

  • uint64 group_id = 1

    group_id is the unique ID of the newly created group.

• rpc UpdateGroupMembers (MsgUpdateGroupMembers, MsgUpdateGroupMembersResponse)

  tx.proto:23

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

  message MsgUpdateGroupMembers

  tx.proto:89

  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 MemberRequest member_updates = 3

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

  message MsgUpdateGroupMembersResponse

  tx.proto:105

  MsgUpdateGroupMembersResponse is the Msg/UpdateGroupMembers response type.

  (message has no fields)

• rpc UpdateGroupAdmin (MsgUpdateGroupAdmin, MsgUpdateGroupAdminResponse)

  tx.proto:26

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

  message MsgUpdateGroupAdmin

  tx.proto:108

  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:123

  MsgUpdateGroupAdminResponse is the Msg/UpdateGroupAdmin response type.

  (message has no fields)

• rpc UpdateGroupMetadata (MsgUpdateGroupMetadata, MsgUpdateGroupMetadataResponse)

  tx.proto:29

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

  message MsgUpdateGroupMetadata

  tx.proto:126

  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:141

  MsgUpdateGroupMetadataResponse is the Msg/UpdateGroupMetadata response type.

  (message has no fields)

• rpc CreateGroupPolicy (MsgCreateGroupPolicy, MsgCreateGroupPolicyResponse)

  tx.proto:32

  CreateGroupPolicy creates a new group policy using given DecisionPolicy.

  message MsgCreateGroupPolicy

  tx.proto:148

  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:168

  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:35

  CreateGroupWithPolicy creates a new group with policy.

  message MsgCreateGroupWithPolicy

  tx.proto:192

  MsgCreateGroupWithPolicy is the Msg/CreateGroupWithPolicy request type.

  • string admin = 1

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

  • repeated MemberRequest 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:218

  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 UpdateGroupPolicyAdmin (MsgUpdateGroupPolicyAdmin, MsgUpdateGroupPolicyAdminResponse)

  tx.proto:38

  UpdateGroupPolicyAdmin updates a group policy admin.

  message MsgUpdateGroupPolicyAdmin

  tx.proto:174

  MsgUpdateGroupPolicyAdmin is the Msg/UpdateGroupPolicyAdmin request type.

  • string admin = 1

    admin is the account address of the group admin.

  • string group_policy_address = 2

    group_policy_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:189

  MsgUpdateGroupPolicyAdminResponse is the Msg/UpdateGroupPolicyAdmin response type.

  (message has no fields)

• rpc UpdateGroupPolicyDecisionPolicy (MsgUpdateGroupPolicyDecisionPolicy, MsgUpdateGroupPolicyDecisionPolicyResponse)

  tx.proto:41

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

  message MsgUpdateGroupPolicyDecisionPolicy

  tx.proto:227

  MsgUpdateGroupPolicyDecisionPolicy is the Msg/UpdateGroupPolicyDecisionPolicy request type.

  • string admin = 1

    admin is the account address of the group admin.

  • string group_policy_address = 2

    group_policy_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:244

  MsgUpdateGroupPolicyDecisionPolicyResponse is the Msg/UpdateGroupPolicyDecisionPolicy response type.

  (message has no fields)

• rpc UpdateGroupPolicyMetadata (MsgUpdateGroupPolicyMetadata, MsgUpdateGroupPolicyMetadataResponse)

  tx.proto:45

  UpdateGroupPolicyMetadata updates a group policy metadata.

  message MsgUpdateGroupPolicyMetadata

  tx.proto:247

  MsgUpdateGroupPolicyMetadata is the Msg/UpdateGroupPolicyMetadata request type.

  • string admin = 1

    admin is the account address of the group admin.

  • string group_policy_address = 2

    group_policy_address is the account address of group policy.

  • string metadata = 3

    metadata is the group policy metadata to be updated.

  message MsgUpdateGroupPolicyMetadataResponse

  tx.proto:262

  MsgUpdateGroupPolicyMetadataResponse is the Msg/UpdateGroupPolicyMetadata response type.

  (message has no fields)

• rpc SubmitProposal (MsgSubmitProposal, MsgSubmitProposalResponse)

  tx.proto:48

  SubmitProposal submits a new proposal.

  message MsgSubmitProposal

  tx.proto:282

  MsgSubmitProposal is the Msg/SubmitProposal request type.

  • string group_policy_address = 1

    group_policy_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 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.

  • string title = 6

    title is the title of the proposal. Since: cosmos-sdk 0.47

  • string summary = 7

    summary is the summary of the proposal. Since: cosmos-sdk 0.47

  message MsgSubmitProposalResponse

  tx.proto:318

  MsgSubmitProposalResponse is the Msg/SubmitProposal response type.

  • uint64 proposal_id = 1

    proposal is the unique ID of the proposal.

• rpc WithdrawProposal (MsgWithdrawProposal, MsgWithdrawProposalResponse)

  tx.proto:51

  WithdrawProposal withdraws a proposal.

  message MsgWithdrawProposal

  tx.proto:324

  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:336

  MsgWithdrawProposalResponse is the Msg/WithdrawProposal response type.

  (message has no fields)

• rpc Vote (MsgVote, MsgVoteResponse)

  tx.proto:54

  Vote allows a voter to vote on a proposal.

  message MsgVote

  tx.proto:339

  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 attached to the vote.

  • Exec exec = 5

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

  message MsgVoteResponse

  tx.proto:361

  MsgVoteResponse is the Msg/Vote response type.

  (message has no fields)

• rpc Exec (MsgExec, MsgExecResponse)

  tx.proto:57

  Exec executes a proposal.

  message MsgExec

  tx.proto:364

  MsgExec is the Msg/Exec request type.

  • uint64 proposal_id = 1

    proposal is the unique ID of the proposal.

  • string executor = 2

    executor is the account address used to execute the proposal.

  message MsgExecResponse

  tx.proto:376

  MsgExecResponse is the Msg/Exec request type.

  • ProposalExecutorResult result = 2

    result is the final result of the proposal execution.

• rpc LeaveGroup (MsgLeaveGroup, MsgLeaveGroupResponse)

  tx.proto:60

  LeaveGroup allows a group member to leave the group.

  message MsgLeaveGroup

  tx.proto:382

  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:394

  MsgLeaveGroupResponse is the Msg/LeaveGroup response type.

  (message has no fields)

Query is the cosmos.group.v1 Query service.

• rpc GroupInfo (QueryGroupInfoRequest, QueryGroupInfoResponse)

  query.proto:19

  GroupInfo queries group info based on group id.

  message QueryGroupInfoRequest

  query.proto:96

  QueryGroupInfoRequest is the Query/GroupInfo request type.

  • uint64 group_id = 1

    group_id is the unique ID of the group.

  message QueryGroupInfoResponse

  query.proto:102

  QueryGroupInfoResponse is the Query/GroupInfo response type.

  • optional GroupInfo info = 1

    info is the GroupInfo of the group.

• rpc GroupPolicyInfo (QueryGroupPolicyInfoRequest, QueryGroupPolicyInfoResponse)

  query.proto:24

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

  message QueryGroupPolicyInfoRequest

  query.proto:108

  QueryGroupPolicyInfoRequest is the Query/GroupPolicyInfo request type.

  • string address = 1

    address is the account address of the group policy.

  message QueryGroupPolicyInfoResponse

  query.proto:114

  QueryGroupPolicyInfoResponse is the Query/GroupPolicyInfo response type.

  • optional GroupPolicyInfo info = 1

    info is the GroupPolicyInfo of the group policy.

• rpc GroupMembers (QueryGroupMembersRequest, QueryGroupMembersResponse)

  query.proto:29

  GroupMembers queries members of a group by group id.

  message QueryGroupMembersRequest

  query.proto:120

  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:129

  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 GroupsByAdmin (QueryGroupsByAdminRequest, QueryGroupsByAdminResponse)

  query.proto:34

  GroupsByAdmin queries groups by admin address.

  message QueryGroupsByAdminRequest

  query.proto:138

  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:147

  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 GroupPoliciesByGroup (QueryGroupPoliciesByGroupRequest, QueryGroupPoliciesByGroupResponse)

  query.proto:39

  GroupPoliciesByGroup queries group policies by group id.

  message QueryGroupPoliciesByGroupRequest

  query.proto:156

  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:165

  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 GroupPoliciesByAdmin (QueryGroupPoliciesByAdminRequest, QueryGroupPoliciesByAdminResponse)

  query.proto:44

  GroupPoliciesByAdmin queries group policies by admin address.

  message QueryGroupPoliciesByAdminRequest

  query.proto:174

  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:183

  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 Proposal (QueryProposalRequest, QueryProposalResponse)

  query.proto:49

  Proposal queries a proposal based on proposal id.

  message QueryProposalRequest

  query.proto:192

  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:54

  ProposalsByGroupPolicy queries proposals based on account address of group policy.

  message QueryProposalsByGroupPolicyRequest

  query.proto:204

  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:213

  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 VoteByProposalVoter (QueryVoteByProposalVoterRequest, QueryVoteByProposalVoterResponse)

  query.proto:59

  VoteByProposalVoter queries a vote by proposal id and voter.

  message QueryVoteByProposalVoterRequest

  query.proto:222

  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:231

  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:64

  VotesByProposal queries a vote by proposal id.

  message QueryVotesByProposalRequest

  query.proto:237

  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:246

  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:69

  VotesByVoter queries a vote by voter.

  message QueryVotesByVoterRequest

  query.proto:255

  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:264

  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.

• rpc GroupsByMember (QueryGroupsByMemberRequest, QueryGroupsByMemberResponse)

  query.proto:74

  GroupsByMember queries groups by member address.

  message QueryGroupsByMemberRequest

  query.proto:273

  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:282

  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 TallyResult (QueryTallyResultRequest, QueryTallyResultResponse)

  query.proto:83

  TallyResult returns the tally result of a proposal. If the proposal is still in voting period, then this query computes the current tally state, which might not be final. On the other hand, if the proposal is final, then it simply returns the `final_tally_result` state stored in the proposal itself.

  message QueryTallyResultRequest

  query.proto:291

  QueryTallyResultRequest is the Query/TallyResult request type.

  • uint64 proposal_id = 1

    proposal_id is the unique id of a proposal.

  message QueryTallyResultResponse

  query.proto:297

  QueryTallyResultResponse is the Query/TallyResult response type.

  • optional TallyResult tally = 1

    tally defines the requested tally.

• rpc Groups (QueryGroupsRequest, QueryGroupsResponse)

  query.proto:90

  Groups queries all groups in state. Since: cosmos-sdk 0.47.1

  message QueryGroupsRequest

  query.proto:305

  QueryGroupsRequest is the Query/Groups request type. Since: cosmos-sdk 0.47.1

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

    pagination defines an optional pagination for the request.

  message QueryGroupsResponse

  query.proto:314

  QueryGroupsResponse is the Query/Groups response type. Since: cosmos-sdk 0.47.1

  • repeated GroupInfo groups = 1

    `groups` is all the groups present in state.

  • 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.

• string logs = 3

  logs contains error logs in case the execution result is FAILURE.

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.

EventProposalPruned is an event emitted when a proposal is pruned.

• uint64 proposal_id = 1

  proposal_id is the unique ID of the proposal.

• ProposalStatus status = 2

  status is the proposal status (UNSPECIFIED, SUBMITTED, ACCEPTED, REJECTED, ABORTED, WITHDRAWN).

• optional TallyResult tally_result = 3

  tally_result is the proposal tally result (when applicable).

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, QueryGroupsResponse

• 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 attached to the group policy. the recommended format of the metadata is to be found here: https://docs.cosmos.network/v0.47/modules/group#decision-policy-1

• 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, metadata and added_at timestamp.

Used in: GroupMember

• 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 attached to the member.

• optional google.protobuf.Timestamp added_at = 4

  added_at is a timestamp specifying when a member was added.

MemberRequest represents a group member to be used in Msg server requests. Contrary to `Member`, it doesn't have any `added_at` field since this field cannot be set as part of requests.

Used in: 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 attached to the member.

PercentageDecisionPolicy is a decision policy where a proposal passes when it satisfies the two following conditions: 1. The percentage of all `YES` voters' weights out of the total group weight is greater or equal than the given `percentage`. 2. The voting and execution periods of the proposal respect the parameters given by `windows`.

• string percentage = 1

  percentage is the minimum percentage of 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 group_policy_address = 2

  group_policy_address is the account address of group policy.

• string metadata = 3

  metadata is any arbitrary metadata attached to the proposal. the recommended format of the metadata is to be found here: https://docs.cosmos.network/v0.47/modules/group#proposal-4

• 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 at proposal submission. This field is here for informational purposes only.

• uint64 group_policy_version = 7

  group_policy_version tracks the version of the group policy at proposal submission. When a decision policy is changed, existing proposals from previous policy versions will become invalid with the `ABORTED` status. This field is here for informational purposes only.

• ProposalStatus status = 8

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

• optional TallyResult final_tally_result = 9

  final_tally_result contains the sums of all weighted votes for this proposal for each vote option. It is empty at submission, and only populated after tallying, at voting period end or at proposal execution, whichever happens first.

• optional google.protobuf.Timestamp voting_period_end = 10

  voting_period_end is the timestamp before which voting must be done. Unless a successful 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`and `status` fields will be accordingly updated.

• ProposalExecutorResult executor_result = 11

  executor_result is the final result of the proposal execution. Initial value is NotRun.

• repeated google.protobuf.Any messages = 12

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

• string title = 13

  title is the title of the proposal Since: cosmos-sdk 0.47

• string summary = 14

  summary is a short summary of the proposal Since: cosmos-sdk 0.47

ProposalExecutorResult defines types of proposal executor results.

Used in: EventExec, MsgExecResponse, 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.

ProposalStatus defines proposal statuses.

Used in: EventProposalPruned, Proposal

• PROPOSAL_STATUS_UNSPECIFIED = 0

  An empty value is invalid and not allowed.

• PROPOSAL_STATUS_SUBMITTED = 1

  Initial status of a proposal when submitted.

• PROPOSAL_STATUS_ACCEPTED = 2

  Final status of a proposal when the final tally is done and the outcome passes the group policy's decision policy.

• PROPOSAL_STATUS_REJECTED = 3

  Final status of a proposal when the final tally is done and the outcome is rejected by the group policy's decision policy.

• PROPOSAL_STATUS_ABORTED = 4

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

• PROPOSAL_STATUS_WITHDRAWN = 5

  A proposal can be withdrawn 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: EventProposalPruned, 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_count is the weighted sum of no votes.

• string no_with_veto_count = 4

  no_with_veto_count is the weighted sum of veto.

ThresholdDecisionPolicy is a decision policy where a proposal passes when it satisfies the two following conditions: 1. The sum of all `YES` voter's weights is greater or equal than the defined `threshold`. 2. The voting and execution periods of the proposal respect the parameters given by `windows`.

• 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 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 an unspecified vote option which will return an error.

• 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.