StorageProviders
Queries a list of GetStorageProviders items.
Query Parameters
key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.
offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.
limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.
count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.
reverse is set to true if results are to be returned in the descending order.
Since: cosmos-sdk 0.43
- 200
- default
A successful response.
Schema
- Array [
- ]
sps object[]
operator_address defines the account address of the storage provider's operator; It also is the unique index key of sp.
funding_address defines one of the storage provider's accounts which is used to deposit and reward.
gc_address defines one of the storage provider's accounts which is used for gc purpose.
total_deposit defines the number of tokens deposited by this storage provider for staking.
Possible values: [STATUS_IN_SERVICE
, STATUS_IN_JAILED
, STATUS_GRACEFUL_EXITING
, STATUS_IN_MAINTENANCE
]
Default value: STATUS_IN_SERVICE
Status is the status of a storage provider.
description object
description defines the description terms for the storage provider.
identity defines an optional identity signature (ex. UPort or Keybase).
website defines an optional website link.
security_contact defines an optional email for security contact.
details define other optional details.
pagination object
pagination defines the pagination in the response.
next_key is the key to be passed to PageRequest.key to query the next page most efficiently. It will be empty if there are no more results.
{
"sps": [
{
"id": 0,
"operator_address": "string",
"funding_address": "string",
"seal_address": "string",
"approval_address": "string",
"gc_address": "string",
"maintenance_address": "string",
"total_deposit": "string",
"status": "STATUS_IN_SERVICE",
"endpoint": "string",
"description": {
"moniker": "string",
"identity": "string",
"website": "string",
"security_contact": "string",
"details": "string"
},
"bls_key": "string"
}
],
"pagination": {
"next_key": "string",
"total": "string"
}
}
An unexpected error response.
Schema
- Array [
- ]
details object[]
{
"error": "string",
"code": 0,
"message": "string",
"details": [
{
"type_url": "string",
"value": "string"
}
]
}