Skip to main content

Client

CLI​

A user can query and interact with the authz module using the CLI.

Query​

The query commands allow users to query authz state.

injectived query authz --help

grants​

The grants command allows users to query grants for a granter-grantee pair. If the message type URL is set, it selects grants only for that message type.

injectived query authz grants [granter-addr] [grantee-addr] [msg-type-url]? [flags]

Example:

injectived query authz grants cosmos1.. cosmos1.. /cosmos.bank.v1beta1.MsgSend

Example Output:

grants:
- authorization:
    '@type': /cosmos.bank.v1beta1.SendAuthorization
    spend_limit:
    - amount: "100"
      denom: stake
  expiration: "2022-01-01T00:00:00Z"
pagination: null

Transactions​

The tx commands allow users to interact with the authz module.

injectived tx authz --help

exec​

The exec command allows a grantee to execute a transaction on behalf of granter.

  injectived tx authz exec [tx-json-file] --from [grantee] [flags]

Example:

injectived tx authz exec tx.json --from=cosmos1..

grant​

The grant command allows a granter to grant an authorization to a grantee.

injectived tx authz grant <grantee> <authorization_type="send"|"generic"|"delegate"|"unbond"|"redelegate"> --from <granter> [flags]

Example:

injectived tx authz grant cosmos1.. send --spend-limit=100stake --from=cosmos1..

revoke​

The revoke command allows a granter to revoke an authorization from a grantee.

injectived tx authz revoke [grantee] [msg-type-url] --from=[granter] [flags]

Example:

injectived tx authz revoke cosmos1.. /cosmos.bank.v1beta1.MsgSend --from=cosmos1..

gRPC​

A user can query the authz module using gRPC endpoints.

Grants​

The Grants endpoint allows users to query grants for a granter-grantee pair. If the message type URL is set, it selects grants only for that message type.

cosmos.authz.v1beta1.Query/Grants

Example:

grpcurl -plaintext \
    -d '{"granter":"cosmos1..","grantee":"cosmos1..","msg_type_url":"/cosmos.bank.v1beta1.MsgSend"}' \
    localhost:9090 \
    cosmos.authz.v1beta1.Query/Grants

Example Output:

{
  "grants": [
    {
      "authorization": {
        "@type": "/cosmos.bank.v1beta1.SendAuthorization",
        "spendLimit": [
          {
            "denom":"stake",
            "amount":"100"
          }
        ]
      },
      "expiration": "2022-01-01T00:00:00Z"
    }
  ]
}

REST​

A user can query the authz module using REST endpoints.

/cosmos/authz/v1beta1/grants

Example:

curl "localhost:1317/cosmos/authz/v1beta1/grants?granter=cosmos1..&grantee=cosmos1..&msg_type_url=/cosmos.bank.v1beta1.MsgSend"

Example Output:

{
  "grants": [
    {
      "authorization": {
        "@type": "/cosmos.bank.v1beta1.SendAuthorization",
        "spend_limit": [
          {
            "denom": "stake",
            "amount": "100"
          }
        ]
      },
      "expiration": "2022-01-01T00:00:00Z"
    }
  ],
  "pagination": null
}