package cosmos.authz.v1beta1

Get desktop application:
View/edit binary Protocol Buffers messages

Msg defines the authz Msg service.

• rpc Grant (MsgGrant, MsgGrantResponse)

  tx.proto:23

  Grant grants the provided authorization to the grantee on the granter's account with the provided expiration time. If there is already a grant for the given (granter, grantee, Authorization) triple, then the grant will be overwritten.

  message MsgGrant

  tx.proto:37

  MsgGrant is a request type for Grant method. It declares authorization to the grantee on behalf of the granter with the provided expiration time.

  • string granter = 1

  • string grantee = 2

  • optional Grant grant = 3

  message MsgGrantResponse

  tx.proto:67

  MsgGrantResponse defines the Msg/MsgGrant response type.

  (message has no fields)

• rpc Exec (MsgExec, MsgExecResponse)

  tx.proto:28

  Exec attempts to execute the provided messages using authorizations granted to the grantee. Each message should have only one signer corresponding to the granter of the authorization.

  message MsgExec

  tx.proto:55

  MsgExec attempts to execute the provided messages using authorizations granted to the grantee. Each message should have only one signer corresponding to the granter of the authorization.

  • string grantee = 1

  • repeated google.protobuf.Any msgs = 2

    Execute Msg. The x/authz will try to find a grant matching (msg.signers[0], grantee, MsgTypeURL(msg)) triple and validate it.

  message MsgExecResponse

  tx.proto:48

  MsgExecResponse defines the Msg/MsgExecResponse response type.

  • repeated bytes results = 1

• rpc Revoke (MsgRevoke, MsgRevokeResponse)

  tx.proto:32

  Revoke revokes any authorization corresponding to the provided method name on the granter's account that has been granted to the grantee.

  message MsgRevoke

  tx.proto:71

  MsgRevoke revokes any authorization with the provided sdk.Msg type on the granter's account with that has been granted to the grantee.

  • string granter = 1

  • string grantee = 2

  • string msg_type_url = 3

  message MsgRevokeResponse

  tx.proto:81

  MsgRevokeResponse defines the Msg/MsgRevokeResponse response type.

  (message has no fields)

Query defines the gRPC querier service.

• rpc Grants (QueryGrantsRequest, QueryGrantsResponse)

  query.proto:15

  Returns list of `Authorization`, granted to the grantee by the granter.

  message QueryGrantsRequest

  query.proto:35

  QueryGrantsRequest is the request type for the Query/Grants RPC method.

  • string granter = 1

  • string grantee = 2

  • string msg_type_url = 3

    Optional, msg_type_url, when set, will query only grants matching given msg type.

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

    pagination defines an pagination for the request.

  message QueryGrantsResponse

  query.proto:45

  QueryGrantsResponse is the response type for the Query/Authorizations RPC method.

  • repeated Grant grants = 1

    authorizations is a list of grants granted for grantee by granter.

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

    pagination defines an pagination for the response.

• rpc GranterGrants (QueryGranterGrantsRequest, QueryGranterGrantsResponse)

  query.proto:22

  GranterGrants returns list of `GrantAuthorization`, granted by granter. Since: cosmos-sdk 0.46

  message QueryGranterGrantsRequest

  query.proto:53

  QueryGranterGrantsRequest is the request type for the Query/GranterGrants RPC method.

  • string granter = 1

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

    pagination defines an pagination for the request.

  message QueryGranterGrantsResponse

  query.proto:61

  QueryGranterGrantsResponse is the response type for the Query/GranterGrants RPC method.

  • repeated GrantAuthorization grants = 1

    grants is a list of grants granted by the granter.

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

    pagination defines an pagination for the response.

• rpc GranteeGrants (QueryGranteeGrantsRequest, QueryGranteeGrantsResponse)

  query.proto:29

  GranteeGrants returns a list of `GrantAuthorization` by grantee. Since: cosmos-sdk 0.46

  message QueryGranteeGrantsRequest

  query.proto:69

  QueryGranteeGrantsRequest is the request type for the Query/IssuedGrants RPC method.

  • string grantee = 1

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

    pagination defines an pagination for the request.

  message QueryGranteeGrantsResponse

  query.proto:77

  QueryGranteeGrantsResponse is the response type for the Query/GranteeGrants RPC method.

  • repeated GrantAuthorization grants = 1

    grants is a list of grants granted to the grantee.

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

    pagination defines an pagination for the response.

EventGrant is emitted on Msg/Grant

• string msg_type_url = 2

  Msg type URL for which an autorization is granted

• string granter = 3

  Granter account address

• string grantee = 4

  Grantee account address

EventRevoke is emitted on Msg/Revoke

• string msg_type_url = 2

  Msg type URL for which an autorization is revoked

• string granter = 3

  Granter account address

• string grantee = 4

  Grantee account address

GenericAuthorization gives the grantee unrestricted permissions to execute the provided method on behalf of the granter's account.

• string msg = 1

  Msg, identified by it's type URL, to grant unrestricted permissions to execute

GenesisState defines the authz module's genesis state.

• repeated GrantAuthorization authorization = 1

Grant gives permissions to execute the provide method with expiration time.

Used in: MsgGrant, QueryGrantsResponse

• optional google.protobuf.Any authorization = 1

• optional google.protobuf.Timestamp expiration = 2

  time when the grant will expire and will be pruned. If null, then the grant doesn't have a time expiration (other conditions in `authorization` may apply to invalidate the grant)

GrantAuthorization extends a grant with both the addresses of the grantee and granter. It is used in genesis.proto and query.proto

Used in: GenesisState, QueryGranteeGrantsResponse, QueryGranterGrantsResponse

• string granter = 1

• string grantee = 2

• optional google.protobuf.Any authorization = 3

• optional google.protobuf.Timestamp expiration = 4

GrantQueueItem contains the list of TypeURL of a sdk.Msg.

• repeated string msg_type_urls = 1

  msg_type_urls contains the list of TypeURL of a sdk.Msg.