Go API client for celenium

Celenium API is a powerful tool to access all blockchain data that is processed and indexed by our proprietary indexer. With Celenium API you can retrieve all historical data, off-chain data, blobs and statistics through our REST API. Celenium API indexer are open source, which allows you to not depend on third-party services. You can clone, build and run them independently, giving you full control over all components. If you have any questions or feature requests, please feel free to contact us. We appreciate your feedback!

Overview

This API client was generated by the OpenAPI Generator project. By using the OpenAPI-spec from a remote server, you can easily generate an API client.

• API version: 1.0
• Package version: 1.0.0
• Generator version: 7.24.0-SNAPSHOT
• Build package: org.openapitools.codegen.languages.GoClientCodegen For more information, please visit https://discord.gg/3k83Przqk8

Installation

Import the package in a go file in your project and run go mod tidy:

import celenium "github.com/celenium-io/celenium-api-go"

To use a proxy, set the environment variable HTTP_PROXY:

os.Setenv("HTTP_PROXY", "http://proxy_name:proxy_port")

Configuration of Server URL

Default configuration comes with Servers field that contains server objects as defined in the OpenAPI specification.

Select Server Configuration

For using other server than the one defined on index 0 set context value celenium.ContextServerIndex of type int.

ctx:=context.WithValue(context.Background(), celenium.ContextServerIndex, 1)

Templated Server URL

Templated server URL is formatted using default variables from configuration or from context value celenium.ContextServerVariables of type map[string]string.

ctx:=context.WithValue(context.Background(), celenium.ContextServerVariables, map[string]string{
"basePath": "v2",
})

Note, enum values are always validated and all unused variables are silently ignored.

URLs Configuration per Operation

Each operation can use different server URL defined using OperationServers map in the Configuration. An operation is uniquely identified by "{classname}Service.{nickname}" string. Similar rules for overriding default operation server index and variables applies by using celenium.ContextOperationServerIndices and celenium.ContextOperationServerVariables context maps.

ctx:=context.WithValue(context.Background(), celenium.ContextOperationServerIndices, map[string]int{
"{classname}Service.{nickname}": 2,
})
ctx=context.WithValue(context.Background(), celenium.ContextOperationServerVariables, map[string]map[string]string{
"{classname}Service.{nickname}": {
"port": "8443",
},
})

Documentation for API Endpoints

All URIs are relative to https://api-mainnet.celenium.io/v1

Class	Method	HTTP request	Description
AddressAPI	AddressBalances	Get /address/{hash}/balances	Get list of balances for address
AddressAPI	AddressBlobs	Get /address/{hash}/blobs	Get blobs pushed by address
AddressAPI	AddressCelestials	Get /address/{hash}/celestials	Get list of celestial id for address
AddressAPI	AddressDelegations	Get /address/{hash}/delegations	Get delegations made by address
AddressAPI	AddressGrantee	Get /address/{hash}/granters	Get grants where address is grantee
AddressAPI	AddressGrants	Get /address/{hash}/grants	Get grants made by address
AddressAPI	AddressMessages	Get /address/{hash}/messages	Get address messages
AddressAPI	AddressRedelegations	Get /address/{hash}/redelegations	Get redelegations made by address
AddressAPI	AddressStats	Get /address/{hash}/stats/{name}/{timeframe}	Get address stats
AddressAPI	AddressTransactions	Get /address/{hash}/txs	Get address transactions
AddressAPI	AddressUndelegations	Get /address/{hash}/undelegations	Get undelegations made by address
AddressAPI	AddressVesting	Get /address/{hash}/vestings	Get vesting for address
AddressAPI	AddressVotes	Get /address/{hash}/votes	Get list of votes for address
AddressAPI	GetAddress	Get /address/{hash}	Get address info
AddressAPI	GetAddressCount	Get /address/count	Get count of addresses in network
AddressAPI	ListAddress	Get /address	List addresses
BlockAPI	BlockBlobsCount	Get /block/{height}/blobs/count	Count of blobs which was pushed in the block
BlockAPI	GetBlock	Get /block/{height}	Get block info
BlockAPI	GetBlockBlobs	Get /block/{height}/blobs	List blobs which was pushed in the block
BlockAPI	GetBlockCount	Get /block/count	Get count of blocks in network
BlockAPI	GetBlockEvents	Get /block/{height}/events	Get events from begin and end of block
BlockAPI	GetBlockMessages	Get /block/{height}/messages	Get messages contained in the block
BlockAPI	GetBlockStats	Get /block/{height}/stats	Get block stats by height
BlockAPI	ListBlock	Get /block	List blocks info
ForwardingAPI	GetForwarding	Get /forwarding/{id}	Get forwarding event by ID
ForwardingAPI	ListForwarding	Get /forwarding	List forwarding events
GasAPI	GasEstimateForPfb	Get /gas/estimate_for_pfb	Get estimated gas for pay for blob
GasAPI	GasPrice	Get /gas/price	Get estimated gas price
GasAPI	GasPricePriority	Get /gas/price/{priority}	Get estimated gas price with priority filter
GeneralAPI	GetConstants	Get /constants	Get network constants
GeneralAPI	GetEnums	Get /enums	Get celenium enumerators
GeneralAPI	Head	Get /head	Get current indexer head
HyperlaneAPI	GetHyperlaneIgp	Get /hyperlane/igp/{id}	Get IGP by id
HyperlaneAPI	GetHyperlaneMailbox	Get /hyperlane/mailbox/{id}	Get hyperlane mailbox info
HyperlaneAPI	GetHyperlaneToken	Get /hyperlane/token/{id}	Get hyperlane token info
HyperlaneAPI	GetHyperlaneTransfer	Get /hyperlane/transfer/{id}	Get transfer by id
HyperlaneAPI	GetZkism	Get /hyperlane/zkism/{id}	Get ZK ISM by id
HyperlaneAPI	GetZkismMessages	Get /hyperlane/zkism/{id}/messages	Get ZK ISM authorized messages
HyperlaneAPI	GetZkismUpdates	Get /hyperlane/zkism/{id}/updates	Get ZK ISM state update history
HyperlaneAPI	ListHyperlaneDomains	Get /hyperlane/domains	List hyperlane domains info
HyperlaneAPI	ListHyperlaneIgps	Get /hyperlane/igp	List hyperlane Interchain Gas Paymaster (IGP)
HyperlaneAPI	ListHyperlaneMailbox	Get /hyperlane/mailbox	List hyperlane mailboxes info
HyperlaneAPI	ListHyperlaneTokens	Get /hyperlane/token	List hyperlane tokens info
HyperlaneAPI	ListHyperlaneTransfers	Get /hyperlane/transfer	List hyperlane transfers info
HyperlaneAPI	ListZkism	Get /hyperlane/zkism	List ZK Interchain Security Modules
IbcAPI	GetIbcChannel	Get /ibc/channel/{id}	Get ibc channel info
IbcAPI	GetIbcChannels	Get /ibc/channel	Get ibc channels info
IbcAPI	GetIbcClient	Get /ibc/client/{id}	Get ibc client info
IbcAPI	GetIbcClients	Get /ibc/client	Get ibc clients info
IbcAPI	GetIbcConn	Get /ibc/connection/{id}	Get ibc connection info
IbcAPI	GetIbcConns	Get /ibc/connection	Get ibc connections info
IbcAPI	GetIbcRelayers	Get /ibc/relayers	List ibc relayers
IbcAPI	GetIbcTransfer	Get /ibc/transfer/{id}	Get transfer by id
IbcAPI	GetIbcTransfers	Get /ibc/transfer	Get ibc transfers info
NamespaceAPI	GetBlob	Post /blob	Get namespace blob by commitment on height
NamespaceAPI	GetBlobLogs	Get /namespace/{id}/{version}/blobs	Get blob changes for namespace
NamespaceAPI	GetBlobMetadata	Post /blob/metadata	Get blob metadata by commitment on height
NamespaceAPI	GetBlobProof	Post /blob/proofs	Get blob inclusion proofs
NamespaceAPI	GetBlobs	Get /blob	List all blobs with filters
NamespaceAPI	GetNamespace	Get /namespace/{id}	Get namespace info
NamespaceAPI	GetNamespaceBase64	Get /namespace_by_hash/{hash}	Get namespace info by base64
NamespaceAPI	GetNamespaceBlobs	Get /namespace_by_hash/{hash}/{height}	Get namespace blobs on height
NamespaceAPI	GetNamespaceByVersionAndId	Get /namespace/{id}/{version}	Get namespace info by id and version
NamespaceAPI	GetNamespaceMessages	Get /namespace/{id}/{version}/messages	Get namespace messages by id and version
NamespaceAPI	GetNamespaceRollups	Get /namespace/{id}/{version}/rollups	List rollups using the namespace
NamespaceAPI	ListNamespace	Get /namespace	List namespace info
ProposalAPI	GetProposal	Get /proposal/{id}	Get proposal info
ProposalAPI	ListProposal	Get /proposal	List proposal info
ProposalAPI	ProposalVotes	Get /proposal/{id}/votes	Get proposal's votes
RollupAPI	GetRollup	Get /rollup/{id}	Get rollup info
RollupAPI	GetRollupAllSeries	Get /rollup/stats/series/{timeframe}	Get series for all rollups
RollupAPI	GetRollupBlobs	Get /rollup/{id}/blobs	Get rollup blobs
RollupAPI	GetRollupBySlug	Get /rollup/slug/{slug}	Get rollup by slug
RollupAPI	GetRollupDistribution	Get /rollup/{id}/distribution/{name}/{timeframe}	Get rollup distribution
RollupAPI	GetRollupNamespaces	Get /rollup/{id}/namespaces	Get rollup namespaces info
RollupAPI	GetRollupProviders	Get /rollup/{id}/providers	Get rollup providers info
RollupAPI	GetRollupStats	Get /rollup/{id}/stats/{name}/{timeframe}	Get rollup stats
RollupAPI	GetRollupsCount	Get /rollup/count	Get count of rollups in network
RollupAPI	ListRollup	Get /rollup	List rollups info
RollupAPI	ListRollup24h	Get /rollup/day	List rollups info with stats by previous 24 hours
RollupAPI	RollupExport	Get /rollup/{id}/export	Export rollup blobs
RollupAPI	RollupGroupedStatistics	Get /rollup/group	Rollup Grouped Statistics
SearchAPI	Search	Get /search	Search by hash
SignalAPI	GetUpgrade	Get /signal/upgrade/{version}	Get upgrade by version
SignalAPI	ListSignal	Get /signal	List signals
SignalAPI	ListUpgrades	Get /signal/upgrade	List upgrades
StatsAPI	Stats24hChanges	Get /stats/changes_24h	Get changes for 24 hours
StatsAPI	StatsHlDomains	Get /stats/hyperlane/chains	Get stats for hyperlane transfers splitted by domain
StatsAPI	StatsHlSeries	Get /stats/hyperlane/series/{id}/{name}/{timeframe}	Get histogram for hyperlane domains with precomputed stats
StatsAPI	StatsHlTotalSeries	Get /stats/hyperlane/chains/{name}/{timeframe}	Get histogram for aggregated hyperlane domains with precomputed stats
StatsAPI	StatsIbcChains	Get /stats/ibc/chains	Get stats for ibc channels splitted by chains
StatsAPI	StatsIbcSeries	Get /stats/ibc/series/{id}/{name}/{timeframe}	Get histogram for ibc channels with precomputed stats
StatsAPI	StatsIbcSummary	Get /stats/ibc/summary	Get stats for ibc the largest transfer and busiest channel per day
StatsAPI	StatsMessagesCount24h	Get /stats/messages_count_24h	Get messages distribution for the last 24 hours
StatsAPI	StatsNamespaceUsage	Get /stats/namespace/usage	Get namespaces with sorting by size.
StatsAPI	StatsNsSeries	Get /stats/namespace/series/{id}/{name}/{timeframe}	Get histogram for namespace with precomputed stats
StatsAPI	StatsRollup24h	Get /stats/rollup_stats_24h	Get rollups stats for last 24 hours
StatsAPI	StatsSeries	Get /stats/series/{name}/{timeframe}	Get histogram with precomputed stats
StatsAPI	StatsSeriesCumulative	Get /stats/series/{name}/{timeframe}/cumulative	Get cumulative histogram with precomputed stats
StatsAPI	StatsSizeGroups	Get /stats/size_groups	Get blobs count grouped by size
StatsAPI	StatsSquareSize	Get /stats/square_size	Get histogram for square size distribution
StatsAPI	StatsStakingDistribution	Get /stats/staking/distribution	Get histogram for staking
StatsAPI	StatsStakingSeries	Get /stats/staking/series/{id}/{name}/{timeframe}	Get histogram for staking with precomputed stats
StatsAPI	StatsSummary	Get /stats/summary/{table}/{function}	Get value by table and function
TransactionsAPI	GetTransaction	Get /tx/{hash}	Get transaction by hash
TransactionsAPI	GetTransactionEvents	Get /tx/{hash}/events	Get transaction events
TransactionsAPI	GetTransactionMessages	Get /tx/{hash}/messages	Get transaction messages
TransactionsAPI	GetTransactionsCount	Get /tx/count	Get count of transactions in network
TransactionsAPI	ListGenesisTransactions	Get /tx/genesis	List genesis transactions info
TransactionsAPI	ListTransactionBlobs	Get /tx/{hash}/blobs	List blobs which was pushed by transaction
TransactionsAPI	ListTransactions	Get /tx	List transactions info
TransactionsAPI	TransactionBlobsCount	Get /tx/{hash}/blobs/count	Count of blobs which was pushed by transaction
ValidatorAPI	GetValidator	Get /validators/{id}	Get validator info
ValidatorAPI	GetValidatorBlocks	Get /validators/{id}/blocks	Get blocks which was proposed by validator
ValidatorAPI	GetValidatorUptime	Get /validators/{id}/uptime	Get validator's uptime and history of signed block
ValidatorAPI	ListValidator	Get /validators	List validators
ValidatorAPI	ValidatorCount	Get /validators/count	Get validator's count by status
ValidatorAPI	ValidatorDelegators	Get /validators/{id}/delegators	Get validator's delegators
ValidatorAPI	ValidatorJails	Get /validators/{id}/jails	Get validator's jails
ValidatorAPI	ValidatorMessages	Get /validators/{id}/messages	Get validator messages
ValidatorAPI	ValidatorMetrics	Get /validators/{id}/metrics	Get validator's metrics
ValidatorAPI	ValidatorVotes	Get /validators/{id}/votes	Get list of votes for validator
ValidatorAPI	ValidatorsMetrics	Get /validators/metrics	Get validators metrics
VestingAPI	GetVestingPeriods	Get /vesting/{id}/periods	Get vesting periods by id

Documentation For Models

• HandlerError
• HandlerPostBlobRequest
• ResponsesAddress
• ResponsesBalance
• ResponsesBlob
• ResponsesBlobLog
• ResponsesBlock
• ResponsesBlockExplorer
• ResponsesBlockStats
• ResponsesBusiestChannel
• ResponsesCelestial
• ResponsesChainMetadata
• ResponsesChange24hBlockStats
• ResponsesConstants
• ResponsesContact
• ResponsesCountItem
• ResponsesDelegation
• ResponsesDenomMetadata
• ResponsesDistributionItem
• ResponsesDomainMetadata
• ResponsesEnums
• ResponsesEvent
• ResponsesForwarding
• ResponsesForwardingInput
• ResponsesGasPayment
• ResponsesGasPrice
• ResponsesGrant
• ResponsesHistogramItem
• ResponsesHlDomainStats
• ResponsesHyperlaneCounterparty
• ResponsesHyperlaneIgp
• ResponsesHyperlaneIgpConfig
• ResponsesHyperlaneMailbox
• ResponsesHyperlaneRemoteDomain
• ResponsesHyperlaneToken
• ResponsesHyperlaneTransfer
• ResponsesIbcChainStats
• ResponsesIbcChannel
• ResponsesIbcClient
• ResponsesIbcConnection
• ResponsesIbcSummaryStats
• ResponsesIbcTransfer
• ResponsesJail
• ResponsesLightBlobLog
• ResponsesMessage
• ResponsesMessageForAddress
• ResponsesMetrics
• ResponsesNamespace
• ResponsesNamespaceKind
• ResponsesNamespaceMessage
• ResponsesNamespaceUsage
• ResponsesNativeToken
• ResponsesODS
• ResponsesODSItem
• ResponsesProposal
• ResponsesRedelegation
• ResponsesRelayer
• ResponsesRollup
• ResponsesRollupAllSeriesItem
• ResponsesRollupAllSeriesResponse
• ResponsesRollupGroupedStats
• ResponsesRollupProvider
• ResponsesRollupStats24h
• ResponsesRollupWithDayStats
• ResponsesRollupWithStats
• ResponsesSearchItem
• ResponsesSeriesItem
• ResponsesShortAddress
• ResponsesShortIbcClient
• ResponsesShortProposal
• ResponsesShortRollup
• ResponsesShortValidator
• ResponsesSignalVersion
• ResponsesSignedBlocks
• ResponsesSizeGroup
• ResponsesStakingDistributionItem
• ResponsesState
• ResponsesTPS
• ResponsesTimeValueItem
• ResponsesTopNMetrics
• ResponsesTx
• ResponsesTxForAddress
• ResponsesUndelegation
• ResponsesUpgrade
• ResponsesValidator
• ResponsesValidatorCount
• ResponsesValidatorUptime
• ResponsesVesting
• ResponsesVestingPeriod
• ResponsesVote
• ResponsesZkISM
• ResponsesZkISMMessage
• ResponsesZkISMUpdate
• TypesEventType
• TypesMsgAddressType
• TypesMsgType
• TypesStatus

Documentation For Authorization

Authentication schemes defined for the API:

ApiKeyAuth

• Type: API key
• API key parameter name: apikey
• Location: HTTP header

Note, each API key must be added to a map of map[string]APIKey where the key is: ApiKeyAuth and passed in as the auth context for each request.

Example

auth:=context.WithValue(
context.Background(),
celenium.ContextAPIKeys,
map[string]celenium.APIKey{
"ApiKeyAuth": {Key: "API_KEY_STRING"},
},
)
r, err:=client.Service.Operation(auth, args)

Documentation for Utility Methods

Due to the fact that model structure members are all pointers, this package contains a number of utility functions to easily obtain pointers to values of basic types. Each of these functions takes a value of the given basic type and returns a pointer to it:

• PtrBool
• PtrInt
• PtrInt32
• PtrInt64
• PtrFloat
• PtrFloat32
• PtrFloat64
• PtrString
• PtrTime

Author

celenium@pklabs.me