docs: add auth module client docs (#10384)
* add auth module docs * add link to auth docs
This commit is contained in:
parent
e85964683a
commit
94b62c2d67
|
@ -4,6 +4,383 @@ order: 7
|
||||||
|
|
||||||
# Client
|
# Client
|
||||||
|
|
||||||
|
# Auth
|
||||||
|
|
||||||
|
## CLI
|
||||||
|
|
||||||
|
A user can query and interact with the `auth` module using the CLI.
|
||||||
|
|
||||||
|
### Query
|
||||||
|
|
||||||
|
The `query` commands allow users to query `auth` state.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
simd query auth --help
|
||||||
|
```
|
||||||
|
|
||||||
|
#### account
|
||||||
|
|
||||||
|
The `account` command allow users to query for an account by it's address.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
simd query auth account [address] [flags]
|
||||||
|
```
|
||||||
|
|
||||||
|
Example:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
simd query auth account cosmos1...
|
||||||
|
```
|
||||||
|
|
||||||
|
Example Output:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
'@type': /cosmos.auth.v1beta1.BaseAccount
|
||||||
|
account_number: "0"
|
||||||
|
address: cosmos1zwg6tpl8aw4rawv8sgag9086lpw5hv33u5ctr2
|
||||||
|
pub_key:
|
||||||
|
'@type': /cosmos.crypto.secp256k1.PubKey
|
||||||
|
key: ApDrE38zZdd7wLmFS9YmqO684y5DG6fjZ4rVeihF/AQD
|
||||||
|
sequence: "1"
|
||||||
|
```
|
||||||
|
|
||||||
|
#### accounts
|
||||||
|
|
||||||
|
The `accounts` command allow users to query all the available accounts.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
simd query auth accounts [flags]
|
||||||
|
```
|
||||||
|
|
||||||
|
Example:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
simd query auth accounts
|
||||||
|
```
|
||||||
|
|
||||||
|
Example Output:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
accounts:
|
||||||
|
- '@type': /cosmos.auth.v1beta1.BaseAccount
|
||||||
|
account_number: "0"
|
||||||
|
address: cosmos1zwg6tpl8aw4rawv8sgag9086lpw5hv33u5ctr2
|
||||||
|
pub_key:
|
||||||
|
'@type': /cosmos.crypto.secp256k1.PubKey
|
||||||
|
key: ApDrE38zZdd7wLmFS9YmqO684y5DG6fjZ4rVeihF/AQD
|
||||||
|
sequence: "1"
|
||||||
|
- '@type': /cosmos.auth.v1beta1.ModuleAccount
|
||||||
|
base_account:
|
||||||
|
account_number: "8"
|
||||||
|
address: cosmos1yl6hdjhmkf37639730gffanpzndzdpmhwlkfhr
|
||||||
|
pub_key: null
|
||||||
|
sequence: "0"
|
||||||
|
name: transfer
|
||||||
|
permissions:
|
||||||
|
- minter
|
||||||
|
- burner
|
||||||
|
- '@type': /cosmos.auth.v1beta1.ModuleAccount
|
||||||
|
base_account:
|
||||||
|
account_number: "4"
|
||||||
|
address: cosmos1fl48vsnmsdzcv85q5d2q4z5ajdha8yu34mf0eh
|
||||||
|
pub_key: null
|
||||||
|
sequence: "0"
|
||||||
|
name: bonded_tokens_pool
|
||||||
|
permissions:
|
||||||
|
- burner
|
||||||
|
- staking
|
||||||
|
- '@type': /cosmos.auth.v1beta1.ModuleAccount
|
||||||
|
base_account:
|
||||||
|
account_number: "5"
|
||||||
|
address: cosmos1tygms3xhhs3yv487phx3dw4a95jn7t7lpm470r
|
||||||
|
pub_key: null
|
||||||
|
sequence: "0"
|
||||||
|
name: not_bonded_tokens_pool
|
||||||
|
permissions:
|
||||||
|
- burner
|
||||||
|
- staking
|
||||||
|
- '@type': /cosmos.auth.v1beta1.ModuleAccount
|
||||||
|
base_account:
|
||||||
|
account_number: "6"
|
||||||
|
address: cosmos10d07y265gmmuvt4z0w9aw880jnsr700j6zn9kn
|
||||||
|
pub_key: null
|
||||||
|
sequence: "0"
|
||||||
|
name: gov
|
||||||
|
permissions:
|
||||||
|
- burner
|
||||||
|
- '@type': /cosmos.auth.v1beta1.ModuleAccount
|
||||||
|
base_account:
|
||||||
|
account_number: "3"
|
||||||
|
address: cosmos1jv65s3grqf6v6jl3dp4t6c9t9rk99cd88lyufl
|
||||||
|
pub_key: null
|
||||||
|
sequence: "0"
|
||||||
|
name: distribution
|
||||||
|
permissions: []
|
||||||
|
- '@type': /cosmos.auth.v1beta1.BaseAccount
|
||||||
|
account_number: "1"
|
||||||
|
address: cosmos147k3r7v2tvwqhcmaxcfql7j8rmkrlsemxshd3j
|
||||||
|
pub_key: null
|
||||||
|
sequence: "0"
|
||||||
|
- '@type': /cosmos.auth.v1beta1.ModuleAccount
|
||||||
|
base_account:
|
||||||
|
account_number: "7"
|
||||||
|
address: cosmos1m3h30wlvsf8llruxtpukdvsy0km2kum8g38c8q
|
||||||
|
pub_key: null
|
||||||
|
sequence: "0"
|
||||||
|
name: mint
|
||||||
|
permissions:
|
||||||
|
- minter
|
||||||
|
- '@type': /cosmos.auth.v1beta1.ModuleAccount
|
||||||
|
base_account:
|
||||||
|
account_number: "2"
|
||||||
|
address: cosmos17xpfvakm2amg962yls6f84z3kell8c5lserqta
|
||||||
|
pub_key: null
|
||||||
|
sequence: "0"
|
||||||
|
name: fee_collector
|
||||||
|
permissions: []
|
||||||
|
pagination:
|
||||||
|
next_key: null
|
||||||
|
total: "0"
|
||||||
|
```
|
||||||
|
|
||||||
|
#### params
|
||||||
|
|
||||||
|
The `params` command allow users to query the current auth parameters.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
simd query auth params [flags]
|
||||||
|
```
|
||||||
|
|
||||||
|
Example:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
simd query auth params
|
||||||
|
```
|
||||||
|
|
||||||
|
Example Output:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
max_memo_characters: "256"
|
||||||
|
sig_verify_cost_ed25519: "590"
|
||||||
|
sig_verify_cost_secp256k1: "1000"
|
||||||
|
tx_sig_limit: "7"
|
||||||
|
tx_size_cost_per_byte: "10"
|
||||||
|
```
|
||||||
|
|
||||||
|
## gRPC
|
||||||
|
|
||||||
|
A user can query the `auth` module using gRPC endpoints.
|
||||||
|
|
||||||
|
### Account
|
||||||
|
|
||||||
|
The `account` endpoint allow users to query for an account by it's address.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cosmos.auth.v1beta1.Query/Account
|
||||||
|
```
|
||||||
|
|
||||||
|
Example:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
grpcurl -plaintext \
|
||||||
|
-d '{"address":"cosmos1.."}' \
|
||||||
|
localhost:9090 \
|
||||||
|
cosmos.auth.v1beta1.Query/Account
|
||||||
|
```
|
||||||
|
|
||||||
|
Example Output:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
{
|
||||||
|
"account":{
|
||||||
|
"@type":"/cosmos.auth.v1beta1.BaseAccount",
|
||||||
|
"address":"cosmos1zwg6tpl8aw4rawv8sgag9086lpw5hv33u5ctr2",
|
||||||
|
"pubKey":{
|
||||||
|
"@type":"/cosmos.crypto.secp256k1.PubKey",
|
||||||
|
"key":"ApDrE38zZdd7wLmFS9YmqO684y5DG6fjZ4rVeihF/AQD"
|
||||||
|
},
|
||||||
|
"sequence":"1"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Accounts
|
||||||
|
|
||||||
|
The `accounts` endpoint allow users to query all the available accounts.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cosmos.auth.v1beta1.Query/Accounts
|
||||||
|
```
|
||||||
|
|
||||||
|
Example:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
grpcurl -plaintext \
|
||||||
|
localhost:9090 \
|
||||||
|
cosmos.auth.v1beta1.Query/Accounts
|
||||||
|
```
|
||||||
|
|
||||||
|
Example Output:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
{
|
||||||
|
"accounts":[
|
||||||
|
{
|
||||||
|
"@type":"/cosmos.auth.v1beta1.BaseAccount",
|
||||||
|
"address":"cosmos1zwg6tpl8aw4rawv8sgag9086lpw5hv33u5ctr2",
|
||||||
|
"pubKey":{
|
||||||
|
"@type":"/cosmos.crypto.secp256k1.PubKey",
|
||||||
|
"key":"ApDrE38zZdd7wLmFS9YmqO684y5DG6fjZ4rVeihF/AQD"
|
||||||
|
},
|
||||||
|
"sequence":"1"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"@type":"/cosmos.auth.v1beta1.ModuleAccount",
|
||||||
|
"baseAccount":{
|
||||||
|
"address":"cosmos1yl6hdjhmkf37639730gffanpzndzdpmhwlkfhr",
|
||||||
|
"accountNumber":"8"
|
||||||
|
},
|
||||||
|
"name":"transfer",
|
||||||
|
"permissions":[
|
||||||
|
"minter",
|
||||||
|
"burner"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"@type":"/cosmos.auth.v1beta1.ModuleAccount",
|
||||||
|
"baseAccount":{
|
||||||
|
"address":"cosmos1fl48vsnmsdzcv85q5d2q4z5ajdha8yu34mf0eh",
|
||||||
|
"accountNumber":"4"
|
||||||
|
},
|
||||||
|
"name":"bonded_tokens_pool",
|
||||||
|
"permissions":[
|
||||||
|
"burner",
|
||||||
|
"staking"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"@type":"/cosmos.auth.v1beta1.ModuleAccount",
|
||||||
|
"baseAccount":{
|
||||||
|
"address":"cosmos1tygms3xhhs3yv487phx3dw4a95jn7t7lpm470r",
|
||||||
|
"accountNumber":"5"
|
||||||
|
},
|
||||||
|
"name":"not_bonded_tokens_pool",
|
||||||
|
"permissions":[
|
||||||
|
"burner",
|
||||||
|
"staking"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"@type":"/cosmos.auth.v1beta1.ModuleAccount",
|
||||||
|
"baseAccount":{
|
||||||
|
"address":"cosmos10d07y265gmmuvt4z0w9aw880jnsr700j6zn9kn",
|
||||||
|
"accountNumber":"6"
|
||||||
|
},
|
||||||
|
"name":"gov",
|
||||||
|
"permissions":[
|
||||||
|
"burner"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"@type":"/cosmos.auth.v1beta1.ModuleAccount",
|
||||||
|
"baseAccount":{
|
||||||
|
"address":"cosmos1jv65s3grqf6v6jl3dp4t6c9t9rk99cd88lyufl",
|
||||||
|
"accountNumber":"3"
|
||||||
|
},
|
||||||
|
"name":"distribution"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"@type":"/cosmos.auth.v1beta1.BaseAccount",
|
||||||
|
"accountNumber":"1",
|
||||||
|
"address":"cosmos147k3r7v2tvwqhcmaxcfql7j8rmkrlsemxshd3j"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"@type":"/cosmos.auth.v1beta1.ModuleAccount",
|
||||||
|
"baseAccount":{
|
||||||
|
"address":"cosmos1m3h30wlvsf8llruxtpukdvsy0km2kum8g38c8q",
|
||||||
|
"accountNumber":"7"
|
||||||
|
},
|
||||||
|
"name":"mint",
|
||||||
|
"permissions":[
|
||||||
|
"minter"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"@type":"/cosmos.auth.v1beta1.ModuleAccount",
|
||||||
|
"baseAccount":{
|
||||||
|
"address":"cosmos17xpfvakm2amg962yls6f84z3kell8c5lserqta",
|
||||||
|
"accountNumber":"2"
|
||||||
|
},
|
||||||
|
"name":"fee_collector"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"pagination":{
|
||||||
|
"total":"9"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
### Params
|
||||||
|
|
||||||
|
The `params` endpoint allow users to query the current auth parameters.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cosmos.auth.v1beta1.Query/Params
|
||||||
|
```
|
||||||
|
|
||||||
|
Example:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
grpcurl -plaintext \
|
||||||
|
localhost:9090 \
|
||||||
|
cosmos.auth.v1beta1.Query/Params
|
||||||
|
```
|
||||||
|
|
||||||
|
Example Output:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
{
|
||||||
|
"params": {
|
||||||
|
"maxMemoCharacters": "256",
|
||||||
|
"txSigLimit": "7",
|
||||||
|
"txSizeCostPerByte": "10",
|
||||||
|
"sigVerifyCostEd25519": "590",
|
||||||
|
"sigVerifyCostSecp256k1": "1000"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## REST
|
||||||
|
|
||||||
|
A user can query the `auth` module using REST endpoints.
|
||||||
|
|
||||||
|
### Account
|
||||||
|
|
||||||
|
The `account` endpoint allow users to query for an account by it's address.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
/cosmos/auth/v1beta1/account?address={address}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Accounts
|
||||||
|
|
||||||
|
The `accounts` endpoint allow users to query all the available accounts.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
/cosmos/auth/v1beta1/accounts
|
||||||
|
```
|
||||||
|
|
||||||
|
### Params
|
||||||
|
|
||||||
|
The `params` endpoint allow users to query the current auth parameters.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
/cosmos/auth/v1beta1/params
|
||||||
|
```
|
||||||
|
|
||||||
|
# Vesting
|
||||||
|
|
||||||
## CLI
|
## CLI
|
||||||
|
|
||||||
A user can query and interact with the `vesting` module using the CLI.
|
A user can query and interact with the `vesting` module using the CLI.
|
||||||
|
|
|
@ -38,4 +38,9 @@ This module is used in the Cosmos Hub.
|
||||||
- [Glossary](05_vesting.md#glossary)
|
- [Glossary](05_vesting.md#glossary)
|
||||||
6. **[Parameters](06_params.md)**
|
6. **[Parameters](06_params.md)**
|
||||||
7. **[Client](07_client.md)**
|
7. **[Client](07_client.md)**
|
||||||
- [CLI](07_client.md#cli)
|
- **[Auth](07_client.md#auth)**
|
||||||
|
- [CLI](07_client.md#cli)
|
||||||
|
- [gRPC](07_client.md#grpc)
|
||||||
|
- [REST](07_client.md#rest)
|
||||||
|
- **[Vesting](07_client.md#vesting)**
|
||||||
|
- [CLI](07_client.md#vesting#cli)
|
||||||
|
|
Loading…
Reference in New Issue