app

package
v8.0.8 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jun 2, 2026 License: Apache-2.0 Imports: 156 Imported by: 0

Documentation

Index

Constants

View Source
const EnvPrefix = "CELESTIA_APP"

EnvPrefix is the environment variable prefix for celestia-appd. Environment variables that Cobra reads must be prefixed with this value.

View Source
const Name = "celestia-app"

Name is the name of the application.

Variables

ModuleEncodingRegisters keeps track of all the module methods needed to register interfaces and specific type to encoding config

View Source
var NodeHome string

NodeHome is the home directory for the application daemon. This gets set as a side-effect of the init() function.

Functions

func DefaultAppConfig

func DefaultAppConfig() *serverconfig.Config

func DefaultBlockParams

func DefaultBlockParams() *tmproto.BlockParams

DefaultBlockParams returns a default BlockParams with a MaxBytes determined using a goal square size.

func DefaultConsensusConfig

func DefaultConsensusConfig() *tmcfg.Config

func DefaultConsensusParams

func DefaultConsensusParams() *tmproto.ConsensusParams

DefaultConsensusParams returns default consensus params.

func EvidenceParams

func EvidenceParams() *tmproto.EvidenceParams

EvidenceParams returns the evidence params defined in CIP-37. The evidence parameters are not modifiable by governance so a consensus breaking release is needed to modify the evidence parameters.

func HasPersistedStore

func HasPersistedStore(cms storetypes.CommitMultiStore, storeName string) (bool, error)

func IcaAllowMessages

func IcaAllowMessages() []string

IcaAllowMessages returns the list of messages that are allowed to be sent via ICA.

Types

type App

type App struct {
	*baseapp.BaseApp

	// keepers
	AccountKeeper       authkeeper.AccountKeeper
	BankKeeper          bankkeeper.Keeper
	AuthzKeeper         authzkeeper.Keeper
	ConsensusKeeper     consensuskeeper.Keeper
	CapabilityKeeper    *capabilitykeeper.Keeper
	StakingKeeper       *stakingkeeper.Keeper
	SlashingKeeper      slashingkeeper.Keeper
	MintKeeper          mintkeeper.Keeper
	DistrKeeper         distrkeeper.Keeper
	GovKeeper           *govkeeper.Keeper
	UpgradeKeeper       *upgradekeeper.Keeper // Upgrades are set in endblock when signaled
	SignalKeeper        signal.Keeper
	MinFeeKeeper        *minfeekeeper.Keeper
	ParamsKeeper        paramskeeper.Keeper
	IBCKeeper           *ibckeeper.Keeper // IBCKeeper must be a pointer in the app, so we can SetRouter on it correctly
	EvidenceKeeper      evidencekeeper.Keeper
	TransferKeeper      ibctransferkeeper.Keeper
	FeeGrantKeeper      feegrantkeeper.Keeper
	ICAHostKeeper       icahostkeeper.Keeper
	PacketForwardKeeper *packetforwardkeeper.Keeper
	BlobKeeper          blobkeeper.Keeper
	CircuitKeeper       circuitkeeper.Keeper
	HyperlaneKeeper     hyperlanekeeper.Keeper
	WarpKeeper          warpkeeper.Keeper
	IsmKeeper           *zkismkeeper.Keeper
	ForwardingKeeper    forwardingkeeper.Keeper

	ScopedIBCKeeper      capabilitykeeper.ScopedKeeper // This keeper is public for test purposes
	ScopedTransferKeeper capabilitykeeper.ScopedKeeper // This keeper is public for test purposes
	ScopedICAHostKeeper  capabilitykeeper.ScopedKeeper // This keeper is public for test purposes

	BasicManager  module.BasicManager
	ModuleManager *module.Manager
	// contains filtered or unexported fields
}

App extends an ABCI application, but with most of its parameters exported. They are exported for convenience in creating helper functions, as object capabilities aren't needed for testing.

func New

func New(
	logger log.Logger,
	db dbm.DB,
	traceStore io.Writer,
	delayedPrecommitTimeout time.Duration,
	appOpts servertypes.AppOptions,
	baseAppOptions ...func(*baseapp.BaseApp),
) *App

New returns a reference to an uninitialized app. Callers must subsequently call app.Info or app.InitChain to initialize the baseapp. Setting delayedPrecommitTimeout to 0 will result in using the default value.

func (*App) AppCodec

func (app *App) AppCodec() codec.Codec

AppCodec implements the TestingApp interface.

func (*App) AutoCliOpts

func (app *App) AutoCliOpts() autocli.AppOptions

AutoCliOpts returns the autocli options for the app.

func (*App) BeginBlocker

func (app *App) BeginBlocker(ctx sdk.Context) (sdk.BeginBlock, error)

BeginBlocker application updates every begin block

func (*App) BlockedAddresses

func (app *App) BlockedAddresses() map[string]bool

BlockedAddresses returns a map of the app's blocked account addresses. NOTE: This blocklist defines the set of addresses that are not allowed to receive funds through direct and explicit actions, for example, by using a MsgSend or by using a SendCoinsFromModuleToAccount execution. Thus, a module account such as the Hyperlane module account can still receive escrow funds via the protocol, however sending directly to the module account via x/bank is forbidden.

func (*App) CheckTx

func (app *App) CheckTx(req *abci.RequestCheckTx) (*abci.ResponseCheckTx, error)

CheckTx implements the ABCI interface and executes a tx in CheckTx mode. This method wraps the default Baseapp's method so that it can parse and check transactions that contain blobs.

func (*App) Commit

func (app *App) Commit() (*abci.ResponseCommit, error)

Commit overrides BaseApp's Commit to add synchronization with QuerySequence. This prevents data races between commit updating checkState (mempool state) and QuerySequence reading it via CheckState().

func (*App) DefaultGenesis

func (app *App) DefaultGenesis() GenesisState

DefaultGenesis returns the default genesis state

func (*App) EndBlocker

func (app *App) EndBlocker(ctx sdk.Context) (sdk.EndBlock, error)

EndBlocker executes application updates at the end of every block.

func (*App) ExportAppStateAndValidators

func (app *App) ExportAppStateAndValidators(
	forZeroHeight bool, jailAllowedAddrs []string, _ []string,
) (servertypes.ExportedApp, error)

ExportAppStateAndValidators exports the state of the application for a genesis file.

func (*App) FinalizeBlock

func (app *App) FinalizeBlock(req *abci.RequestFinalizeBlock) (*abci.ResponseFinalizeBlock, error)

FinalizeBlock implements the abci interface. It overrides baseapp's FinalizeBlock method, essentially becoming a decorator in order to add transaction pruning logic after normal finalize block processing.

func (*App) GetBaseApp

func (app *App) GetBaseApp() *baseapp.BaseApp

GetBaseApp implements the TestingApp interface.

func (*App) GetEncodingConfig

func (app *App) GetEncodingConfig() encoding.Config

GetEncodingConfig returns the app encoding config.

func (*App) GetIBCKeeper

func (app *App) GetIBCKeeper() *ibckeeper.Keeper

GetIBCKeeper implements the TestingApp interface.

func (*App) GetKey

func (app *App) GetKey(storeKey string) *storetypes.KVStoreKey

GetKey returns the KVStoreKey for the provided store key.

NOTE: This is solely to be used for testing purposes.

func (*App) GetMemKey

func (app *App) GetMemKey(storeKey string) *storetypes.MemoryStoreKey

GetMemKey returns the MemStoreKey for the provided mem key.

NOTE: This is solely used for testing purposes.

func (*App) GetScopedIBCKeeper

func (app *App) GetScopedIBCKeeper() capabilitykeeper.ScopedKeeper

GetScopedIBCKeeper implements the TestingApp interface.

func (*App) GetStakingKeeper

func (app *App) GetStakingKeeper() ibctestingtypes.StakingKeeper

GetStakingKeeper implements the TestingApp interface.

func (*App) GetSubspace

func (app *App) GetSubspace(moduleName string) paramstypes.Subspace

GetSubspace returns a param subspace for a given module name.

NOTE: This is solely to be used for testing purposes.

func (*App) GetTKey

func (app *App) GetTKey(storeKey string) *storetypes.TransientStoreKey

GetTKey returns the TransientStoreKey for the provided store key.

NOTE: This is solely to be used for testing purposes.

func (*App) GetTxConfig

func (app *App) GetTxConfig() client.TxConfig

GetTxConfig implements the TestingApp interface.

func (*App) GovParamFilters

func (app *App) GovParamFilters() map[string]ante.ParamFilter

GovParamFilters returns the params that require a hardfork to change, and cannot be changed via governance.

func (*App) Info

func (app *App) Info(req *abci.RequestInfo) (*abci.ResponseInfo, error)

Info implements the abci interface. It overrides baseapp's Info method, essentially becoming a decorator in order to assign TimeoutInfo values in the response.

func (*App) InitChainer

func (app *App) InitChainer(ctx sdk.Context, req *abci.RequestInitChain) (*abci.ResponseInitChain, error)

InitChainer is middleware that gets invoked part-way through the baseapp's InitChain invocation.

func (*App) LoadHeight

func (app *App) LoadHeight(height int64) error

LoadHeight loads a particular height

func (*App) MaxEffectiveSquareSize

func (app *App) MaxEffectiveSquareSize(ctx sdk.Context) int

MaxEffectiveSquareSize returns the max effective square size.

func (*App) ModuleAccountAddrs

func (app *App) ModuleAccountAddrs() map[string]bool

ModuleAccountAddrs returns a map of the app's module account addresses.

func (*App) Name

func (app *App) Name() string

Name returns the name of the App

func (*App) NewProposalContext

func (app *App) NewProposalContext(header tmproto.Header) sdk.Context

NewProposalContext returns a context with a branched version of the state that is safe to query during ProcessProposal.

func (*App) PreBlocker

func (app *App) PreBlocker(ctx sdk.Context, _ *abci.RequestFinalizeBlock) (*sdk.ResponsePreBlock, error)

PreBlocker application updates every pre block

func (*App) PrepareProposalHandler

func (app *App) PrepareProposalHandler(ctx sdk.Context, req *abci.RequestPrepareProposal) (*abci.ResponsePrepareProposal, error)

PrepareProposalHandler fulfills the celestia-core version of the ABCI interface by preparing the proposal block data. This method generates the data root for the proposal block and passes it back to tendermint via the BlockData. Errors are returned instead of panicking to improve error handling and reduce attack surface.

func (*App) ProcessProposalHandler

func (app *App) ProcessProposalHandler(ctx sdk.Context, req *abci.RequestProcessProposal) (resp *abci.ResponseProcessProposal, err error)

func (*App) QuerySequence

func (app *App) QuerySequence(_ context.Context, req *abci.RequestQuerySequence) (*abci.ResponseQuerySequence, error)

QuerySequence returns the committed account sequence for the provided signer. We bypass BaseApp's mempool-aware implementation so the application can ensure it queries from the latest committed state.

func (*App) RegisterAPIRoutes

func (app *App) RegisterAPIRoutes(apiSvr *api.Server, _ config.APIConfig)

RegisterAPIRoutes registers all application module routes with the provided API server.

func (*App) RegisterNodeService

func (app *App) RegisterNodeService(clientCtx client.Context, cfg config.Config)

func (*App) RegisterTendermintService

func (app *App) RegisterTendermintService(clientCtx client.Context)

RegisterTendermintService implements the Application.RegisterTendermintService method.

func (*App) RegisterTxService

func (app *App) RegisterTxService(clientCtx client.Context)

RegisterTxService implements the Application.RegisterTxService method.

func (App) RegisterUpgradeHandlers

func (app App) RegisterUpgradeHandlers()

RegisterUpgradeHandlers is used for registering any on-chain upgrades.

func (App) SetMinCommissionRate

func (a App) SetMinCommissionRate(ctx context.Context) error

func (*App) TimeoutInfo

func (app *App) TimeoutInfo() abci.TimeoutInfo

func (*App) TreePool

func (app *App) TreePool() *wrapper.TreePool

TreePool returns the instance used for managing a pool of Merkle trees.

func (App) UpdateValidatorCommissionRates

func (a App) UpdateValidatorCommissionRates(ctx context.Context) error

UpdateValidatorCommissionRates iterates over all validators and increases their commission rate to MinCommissionRate (20%) if below, and their max commission rate to MaxCommissionRate (60%) if below.

func (*App) ValidateBlobTxWithCache

func (app *App) ValidateBlobTxWithCache(blobTx *blobtx.BlobTx) (bool, error)

ValidateBlobTxWithCache validates a blob transaction, using cached validation results when possible. It returns (fromCache, error) where fromCache indicates if the validation was skipped using cache.

type FilteredSquareBuilder

type FilteredSquareBuilder struct {
	// contains filtered or unexported fields
}

FilteredSquareBuilder filters txs and blobs using a copy of the state and tx validity rules before adding it the square.

func NewFilteredSquareBuilder

func NewFilteredSquareBuilder(
	handler sdk.AnteHandler,
	txConfig client.TxConfig,
	maxSquareSize,
	subtreeRootThreshold int,
) (*FilteredSquareBuilder, error)

func (*FilteredSquareBuilder) Build

func (fsb *FilteredSquareBuilder) Build() (square.Square, error)

func (*FilteredSquareBuilder) Builder

func (fsb *FilteredSquareBuilder) Builder() *square.Builder

func (*FilteredSquareBuilder) Fill

func (fsb *FilteredSquareBuilder) Fill(ctx sdk.Context, txs [][]byte) [][]byte

type GenesisState

type GenesisState map[string]json.RawMessage

The genesis state of the blockchain is represented here as a map of raw json messages key'd by an identifier string. The identifier is used to determine which module genesis information belongs to so it may be appropriately routed during init chain. Within this application default genesis information is retrieved from the ModuleBasicManager which populates json from each BasicModule object provided to it during init.

type TxCache

type TxCache struct {
	// contains filtered or unexported fields
}

TxCache caches the transactions

func NewTxCache

func NewTxCache() *TxCache

NewTxCache creates a new transaction cache

func (*TxCache) Exists

func (c *TxCache) Exists(tx []byte, blobs []*share.Blob) bool

Exists checks whether the Tx exists in the cache and the blobs match the cached blobs

func (*TxCache) RemoveTransaction

func (c *TxCache) RemoveTransaction(tx []byte)

RemoveTransaction removes specific transactions from the cache

func (*TxCache) Set

func (c *TxCache) Set(tx []byte, blobs []*share.Blob)

Set stores the Tx in the cache

func (*TxCache) Size

func (c *TxCache) Size() int

Size returns the current number of entries in the cache

Directories

Path Synopsis
grpc
tx
Package tx is a reverse proxy.
Package tx is a reverse proxy.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
⌂ 换网址