/

/Babylon - gRPC Gateway docs

APIs
Generators
Stacks
Projects

Docs
History
Schema
Sources

Checked 1h ago · Updated 1mo ago View markdown

babylonlabs-io
Babylon - gRPC Gateway docs
getCurrentEpoch queries the current epoch

latestSwagger 2.02026-07-1768122667.5 KB

93a09c641887

Query68

getBtcCheckpointsInfo returns checkpoint info for a range of epochs
getParameters queries the parameters of the module.
getBtcCheckpointInfo returns checkpoint info for a given epoch
getEpochSubmissions returns all submissions for a given epoch
getBaseHeader returns the base BTC header of the chain. This header is defined on genesis.
getContains checks whether a hash is maintained by the module.
getContainsBytes is a temporary method that checks whether a hash is maintained by the module. See discussion at https://github.com/babylonlabs-io/babylon/pull/132 for more details.
getHeaderDepth returns the depth of the header in main chain or error if the block is not found or it exists on fork
getHashes retrieves the hashes maintained by the module.
getMainChain returns the canonical chain
getParams queries the parameters of the module.
getTip return best header on canonical chain
getCurrentEpoch queries the current epoch
getDelegationLifecycle queries the lifecycle of a given delegation
getEpochsInfo queries the metadata of epochs in a given range, depending on the parameters in the pagination request. Th main use case will be querying the latest epochs in time order.
getEpochInfo queries the information of a given epoch
getEpochMsgs queries the messages of a given epoch
getEpochValSet queries the validator set of a given epoch
getLatestEpochMsgs queries the messages within a given number of most recent epochs
getParams queries the parameters of the module.
getValidatorLifecycle queries the lifecycle of a given validator
getBTCDelegation retrieves delegation by corresponding staking tx hash
getBTCDelegations queries all BTC delegations under a given status
getFinalityProviders queries all finality providers
getFinalityProviderDelegations queries all BTC delegations of the given finality provider
getFinalityProvider info about one finality provider
getLargestBtcReOrg retrieves the largest BTC reorg
getParameters queries the parameters of the module.
getParamsByBTCHeight queries the parameters of the module for a specific BTC height
getParamsByVersion queries the parameters of the module for a specific version of past params.
getParamsVersions queries all the parameters of the module with version.
getActivatedHeight queries the height when BTC staking protocol is activated, i.e., the first height when there exists 1 finality provider with voting power
getListBlocks is a range query for blocks at a given status
getBlock queries a block at a given height
getListEvidences queries is a range query for evidences
getEvidence queries the first evidence which can be used for extracting the BTC SK
getFinalityProviderCurrentPower queries the voting power of a finality provider at the current height
getFinalityProviderPowerAtHeight queries the voting power of a finality provider at a given height
getListPubRandCommit is a range query for public randomness commitments of a given finality provider
getListPublicRandomness is a range query for public randomness of a given finality provider NOTE: Babylon only has the knowledge of public randomness that is already revealed by finality providers, i.e., the finality provider already provides a finality signature at the corresponding height
getActiveFinalityProvidersAtHeight queries finality providers with non zero voting power at given height.
getParameters queries the parameters of the module.
getSigningInfos queries the signing info of all the active finality providers
getSigningInfo queries the signing info of given finality provider BTC public key
getVotesAtHeight queries finality providers who have signed the block at given height.
getVotingPowerDistribution queries the voting power distribution cache Note: The vp dst cache is only kept at the store until that block height is finalized
getAnnualProvisions returns the current annual provisions.
getGenesisTime returns the genesis time.
getInflationRate returns the current inflation rate.
getReportedCheckpointBtcHeight returns the BTC light client height at which the checkpoint with the given hash is reported back to Babylon
getEndedEpochBtcHeight returns the BTC light client height at provided epoch finish
getBlsPublicKeyList queries a list of bls public keys of the validators at a given epoch number.
getEpochStatus queries the status of the checkpoint at a given epoch
getRecentEpochStatusCount queries the number of epochs with each status in recent epochs
getLastCheckpointWithStatus queries the last checkpoint with a given status or a more matured status
getRawCheckpoint queries a checkpoints at a given epoch number.
getRawCheckpoints queries checkpoints for a epoch range specified in pagination params.
getRawCheckpointList queries all checkpoints that match the given status.
getRewardGauge queries the reward gauge of a given stakeholder address
getBTCStakingGauge queries the BTC staking gauge of a given height
getDelegatorWithdrawAddress queries withdraw address of a delegator.
getDelegationRewards queries the delegation rewards of given finality provider and delegator addresses
getFpCurrentRewards queries the finality provider pool of rewards
getParameters queries the parameters of the module.
getCostakerRewardsTracker queries the costaker reward tracker.
getCurrentRewards queries the current rewards structure for costaking single pool.
getHistoricalRewards queries the historical rewards structure per period for costaking single pool.
getParams queries the parameters of the module.

Query

CurrentEpoch queries the current epoch

get/babylon/epoching/v1/current_epoch

Response

A successful response.