From 7458093c775136ae83f73e34ba5d4905fc3ea950 Mon Sep 17 00:00:00 2001 From: Lucas Bertrand Date: Fri, 10 May 2024 14:59:47 +0200 Subject: [PATCH] feat: add `ibc` and `ibc-transfer` modules (#2145) * add IBC to app.go * add ibc transfer * docs * add changelog * change capoability order * add module in setup handler --- app/app.go | 190 +++++++++++++++--- app/init_genesis.go | 8 + app/setup_handlers.go | 11 +- changelog.md | 1 + docs/cli/zetacored/zetacored_query.md | 2 + .../zetacored/zetacored_query_ibc-transfer.md | 31 +++ ...zetacored_query_ibc-transfer_denom-hash.md | 44 ++++ ...etacored_query_ibc-transfer_denom-trace.md | 44 ++++ ...tacored_query_ibc-transfer_denom-traces.md | 50 +++++ ...cored_query_ibc-transfer_escrow-address.md | 44 ++++ .../zetacored_query_ibc-transfer_params.md | 44 ++++ ...tacored_query_ibc-transfer_total-escrow.md | 44 ++++ docs/cli/zetacored/zetacored_query_ibc.md | 32 +++ .../zetacored/zetacored_query_ibc_channel.md | 40 ++++ .../zetacored_query_ibc_channel_channels.md | 50 +++++ ...etacored_query_ibc_channel_client-state.md | 44 ++++ ...zetacored_query_ibc_channel_connections.md | 50 +++++ .../zetacored_query_ibc_channel_end.md | 45 +++++ ...query_ibc_channel_next-sequence-receive.md | 45 +++++ .../zetacored_query_ibc_channel_packet-ack.md | 45 +++++ ...red_query_ibc_channel_packet-commitment.md | 45 +++++ ...ed_query_ibc_channel_packet-commitments.md | 50 +++++ ...acored_query_ibc_channel_packet-receipt.md | 45 +++++ ...cored_query_ibc_channel_unreceived-acks.md | 49 +++++ ...ed_query_ibc_channel_unreceived-packets.md | 49 +++++ .../zetacored/zetacored_query_ibc_client.md | 38 ++++ ...uery_ibc_client_consensus-state-heights.md | 50 +++++ ...acored_query_ibc_client_consensus-state.md | 47 +++++ ...cored_query_ibc_client_consensus-states.md | 50 +++++ .../zetacored_query_ibc_client_header.md | 44 ++++ .../zetacored_query_ibc_client_params.md | 44 ++++ ...d_query_ibc_client_self-consensus-state.md | 44 ++++ .../zetacored_query_ibc_client_state.md | 45 +++++ .../zetacored_query_ibc_client_states.md | 50 +++++ .../zetacored_query_ibc_client_status.md | 44 ++++ .../zetacored_query_ibc_connection.md | 29 +++ ...acored_query_ibc_connection_connections.md | 50 +++++ .../zetacored_query_ibc_connection_end.md | 45 +++++ .../zetacored_query_ibc_connection_params.md | 44 ++++ .../zetacored_query_ibc_connection_path.md | 45 +++++ docs/cli/zetacored/zetacored_tx.md | 2 + ...zetacored_tx_gov_submit-legacy-proposal.md | 2 + ..._gov_submit-legacy-proposal_ibc-upgrade.md | 71 +++++++ ...ov_submit-legacy-proposal_update-client.md | 62 ++++++ .../zetacored/zetacored_tx_ibc-transfer.md | 30 +++ .../zetacored_tx_ibc-transfer_transfer.md | 72 +++++++ docs/cli/zetacored/zetacored_tx_ibc.md | 31 +++ .../cli/zetacored/zetacored_tx_ibc_channel.md | 29 +++ docs/cli/zetacored/zetacored_tx_ibc_client.md | 33 +++ .../zetacored_tx_ibc_client_create.md | 65 ++++++ .../zetacored_tx_ibc_client_misbehaviour.md | 63 ++++++ .../zetacored_tx_ibc_client_update.md | 63 ++++++ .../zetacored_tx_ibc_client_upgrade.md | 65 ++++++ 53 files changed, 2334 insertions(+), 25 deletions(-) create mode 100644 docs/cli/zetacored/zetacored_query_ibc-transfer.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc-transfer_denom-hash.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc-transfer_denom-trace.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc-transfer_denom-traces.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc-transfer_escrow-address.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc-transfer_params.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc-transfer_total-escrow.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_channel.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_channel_channels.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_channel_client-state.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_channel_connections.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_channel_end.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_channel_next-sequence-receive.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_channel_packet-ack.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_channel_packet-commitment.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_channel_packet-commitments.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_channel_packet-receipt.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_channel_unreceived-acks.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_channel_unreceived-packets.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_client.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_client_consensus-state-heights.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_client_consensus-state.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_client_consensus-states.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_client_header.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_client_params.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_client_self-consensus-state.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_client_state.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_client_states.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_client_status.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_connection.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_connection_connections.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_connection_end.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_connection_params.md create mode 100644 docs/cli/zetacored/zetacored_query_ibc_connection_path.md create mode 100644 docs/cli/zetacored/zetacored_tx_gov_submit-legacy-proposal_ibc-upgrade.md create mode 100644 docs/cli/zetacored/zetacored_tx_gov_submit-legacy-proposal_update-client.md create mode 100644 docs/cli/zetacored/zetacored_tx_ibc-transfer.md create mode 100644 docs/cli/zetacored/zetacored_tx_ibc-transfer_transfer.md create mode 100644 docs/cli/zetacored/zetacored_tx_ibc.md create mode 100644 docs/cli/zetacored/zetacored_tx_ibc_channel.md create mode 100644 docs/cli/zetacored/zetacored_tx_ibc_client.md create mode 100644 docs/cli/zetacored/zetacored_tx_ibc_client_create.md create mode 100644 docs/cli/zetacored/zetacored_tx_ibc_client_misbehaviour.md create mode 100644 docs/cli/zetacored/zetacored_tx_ibc_client_update.md create mode 100644 docs/cli/zetacored/zetacored_tx_ibc_client_upgrade.md diff --git a/app/app.go b/app/app.go index 234c979e7d..195dd14cf5 100644 --- a/app/app.go +++ b/app/app.go @@ -43,6 +43,9 @@ import ( "github.com/cosmos/cosmos-sdk/x/bank" bankkeeper "github.com/cosmos/cosmos-sdk/x/bank/keeper" banktypes "github.com/cosmos/cosmos-sdk/x/bank/types" + "github.com/cosmos/cosmos-sdk/x/capability" + capabilitykeeper "github.com/cosmos/cosmos-sdk/x/capability/keeper" + capabilitytypes "github.com/cosmos/cosmos-sdk/x/capability/types" "github.com/cosmos/cosmos-sdk/x/consensus" "github.com/cosmos/cosmos-sdk/x/crisis" crisiskeeper "github.com/cosmos/cosmos-sdk/x/crisis/keeper" @@ -79,7 +82,15 @@ import ( upgradeclient "github.com/cosmos/cosmos-sdk/x/upgrade/client" upgradekeeper "github.com/cosmos/cosmos-sdk/x/upgrade/keeper" upgradetypes "github.com/cosmos/cosmos-sdk/x/upgrade/types" - + "github.com/cosmos/ibc-go/v7/modules/apps/transfer" + ibctransferkeeper "github.com/cosmos/ibc-go/v7/modules/apps/transfer/keeper" + ibctransfertypes "github.com/cosmos/ibc-go/v7/modules/apps/transfer/types" + ibc "github.com/cosmos/ibc-go/v7/modules/core" + ibcclientclient "github.com/cosmos/ibc-go/v7/modules/core/02-client/client" + porttypes "github.com/cosmos/ibc-go/v7/modules/core/05-port/types" + ibcexported "github.com/cosmos/ibc-go/v7/modules/core/exported" + ibckeeper "github.com/cosmos/ibc-go/v7/modules/core/keeper" + ibctm "github.com/cosmos/ibc-go/v7/modules/light-clients/07-tendermint" evmante "github.com/evmos/ethermint/app/ante" ethermint "github.com/evmos/ethermint/types" "github.com/evmos/ethermint/x/evm" @@ -166,6 +177,8 @@ func getGovProposalHandlers() []govclient.ProposalHandler { paramsclient.ProposalHandler, upgradeclient.LegacyProposalHandler, upgradeclient.LegacyCancelProposalHandler, + ibcclientclient.UpdateClientProposalHandler, + ibcclientclient.UpgradeProposalHandler, ) return govProposalHandlers } @@ -175,14 +188,18 @@ var ( auth.AppModuleBasic{}, genutil.NewAppModuleBasic(genutiltypes.DefaultMessageValidator), bank.AppModuleBasic{}, + capability.AppModuleBasic{}, staking.AppModuleBasic{}, distr.AppModuleBasic{}, gov.NewAppModuleBasic(getGovProposalHandlers()), params.AppModuleBasic{}, crisis.AppModuleBasic{}, slashing.AppModuleBasic{}, + ibc.AppModuleBasic{}, + ibctm.AppModuleBasic{}, upgrade.AppModuleBasic{}, evidence.AppModuleBasic{}, + transfer.AppModuleBasic{}, vesting.AppModuleBasic{}, consensus.AppModuleBasic{}, evm.AppModuleBasic{}, @@ -204,6 +221,7 @@ var ( stakingtypes.BondedPoolName: {authtypes.Burner, authtypes.Staking}, stakingtypes.NotBondedPoolName: {authtypes.Burner, authtypes.Staking}, govtypes.ModuleName: {authtypes.Burner}, + ibctransfertypes.ModuleName: {authtypes.Minter, authtypes.Burner}, crosschaintypes.ModuleName: {authtypes.Minter, authtypes.Burner}, evmtypes.ModuleName: {authtypes.Minter, authtypes.Burner}, fungibletypes.ModuleName: {authtypes.Minter, authtypes.Burner}, @@ -250,6 +268,7 @@ type App struct { // sdk keepers AccountKeeper authkeeper.AccountKeeper BankKeeper bankkeeper.Keeper + CapabilityKeeper *capabilitykeeper.Keeper StakingKeeper *stakingkeeper.Keeper SlashingKeeper slashingkeeper.Keeper DistrKeeper distrkeeper.Keeper @@ -257,11 +276,17 @@ type App struct { CrisisKeeper crisiskeeper.Keeper UpgradeKeeper *upgradekeeper.Keeper ParamsKeeper paramskeeper.Keeper + IBCKeeper *ibckeeper.Keeper + TransferKeeper ibctransferkeeper.Keeper EvidenceKeeper evidencekeeper.Keeper GroupKeeper groupkeeper.Keeper AuthzKeeper authzkeeper.Keeper ConsensusParamsKeeper consensusparamkeeper.Keeper + // scoped keepers + ScopedIBCKeeper capabilitykeeper.ScopedKeeper + ScopedTransferKeeper capabilitykeeper.ScopedKeeper + // evm keepers EvmKeeper *evmkeeper.Keeper FeeMarketKeeper feemarketkeeper.Keeper @@ -273,6 +298,8 @@ type App struct { ObserverKeeper *observerkeeper.Keeper FungibleKeeper fungiblekeeper.Keeper EmissionsKeeper emissionskeeper.Keeper + + transferModule transfer.AppModule } // New returns a reference to an initialized ZetaApp. @@ -299,11 +326,19 @@ func New( bApp.SetInterfaceRegistry(interfaceRegistry) keys := sdk.NewKVStoreKeys( - authtypes.StoreKey, banktypes.StoreKey, stakingtypes.StoreKey, distrtypes.StoreKey, slashingtypes.StoreKey, - govtypes.StoreKey, paramstypes.StoreKey, + authtypes.StoreKey, + banktypes.StoreKey, + stakingtypes.StoreKey, + distrtypes.StoreKey, + slashingtypes.StoreKey, + govtypes.StoreKey, + paramstypes.StoreKey, group.StoreKey, upgradetypes.StoreKey, evidencetypes.StoreKey, + ibcexported.StoreKey, + ibctransfertypes.StoreKey, + capabilitytypes.StoreKey, authzkeeper.StoreKey, evmtypes.StoreKey, feemarkettypes.StoreKey, @@ -317,7 +352,7 @@ func New( crisistypes.StoreKey, ) tkeys := sdk.NewTransientStoreKeys(paramstypes.TStoreKey, evmtypes.TransientKey, feemarkettypes.TransientKey) - memKeys := sdk.NewMemoryStoreKeys() + memKeys := sdk.NewMemoryStoreKeys(capabilitytypes.MemStoreKey) app := &App{ BaseApp: bApp, @@ -341,6 +376,16 @@ func New( app.ConsensusParamsKeeper = consensusparamkeeper.NewKeeper(appCodec, keys[consensusparamtypes.StoreKey], authAddr) bApp.SetParamStore(&app.ConsensusParamsKeeper) + // add capability keeper and ScopeToModule for ibc module + app.CapabilityKeeper = capabilitykeeper.NewKeeper( + appCodec, + keys[capabilitytypes.StoreKey], + memKeys[capabilitytypes.MemStoreKey], + ) + + scopedIBCKeeper := app.CapabilityKeeper.ScopeToModule(ibcexported.ModuleName) + scopedTransferKeeper := app.CapabilityKeeper.ScopeToModule(ibctransfertypes.ModuleName) + // add keepers // use custom Ethermint account for contracts app.AccountKeeper = authkeeper.NewAccountKeeper( @@ -354,27 +399,91 @@ func New( logger.Info("bank keeper blocklist addresses", "addresses", app.BlockedAddrs()) app.BankKeeper = bankkeeper.NewBaseKeeper( - appCodec, keys[banktypes.StoreKey], app.AccountKeeper, app.BlockedAddrs(), authAddr, + appCodec, + keys[banktypes.StoreKey], + app.AccountKeeper, + app.BlockedAddrs(), + authAddr, ) app.StakingKeeper = stakingkeeper.NewKeeper( - appCodec, keys[stakingtypes.StoreKey], app.AccountKeeper, app.BankKeeper, authAddr, + appCodec, + keys[stakingtypes.StoreKey], + app.AccountKeeper, + app.BankKeeper, + authAddr, ) app.DistrKeeper = distrkeeper.NewKeeper( - appCodec, keys[distrtypes.StoreKey], app.AccountKeeper, app.BankKeeper, - app.StakingKeeper, authtypes.FeeCollectorName, authAddr, + appCodec, + keys[distrtypes.StoreKey], + app.AccountKeeper, + app.BankKeeper, + app.StakingKeeper, + authtypes.FeeCollectorName, + authAddr, ) app.SlashingKeeper = slashingkeeper.NewKeeper( - appCodec, app.LegacyAmino(), keys[slashingtypes.StoreKey], app.StakingKeeper, authAddr, + appCodec, + app.LegacyAmino(), + keys[slashingtypes.StoreKey], + app.StakingKeeper, + authAddr, ) app.CrisisKeeper = *crisiskeeper.NewKeeper( - appCodec, keys[crisistypes.StoreKey], invCheckPeriod, app.BankKeeper, authtypes.FeeCollectorName, authAddr, + appCodec, + keys[crisistypes.StoreKey], + invCheckPeriod, + app.BankKeeper, + authtypes.FeeCollectorName, + authAddr, + ) + + app.UpgradeKeeper = upgradekeeper.NewKeeper( + skipUpgradeHeights, + keys[upgradetypes.StoreKey], + appCodec, + homePath, + app.BaseApp, + authAddr, + ) + + // IBC keepers + + app.IBCKeeper = ibckeeper.NewKeeper( + appCodec, + keys[ibcexported.StoreKey], + app.GetSubspace(ibcexported.ModuleName), + app.StakingKeeper, + app.UpgradeKeeper, + scopedIBCKeeper, ) - app.UpgradeKeeper = upgradekeeper.NewKeeper(skipUpgradeHeights, keys[upgradetypes.StoreKey], appCodec, homePath, app.BaseApp, authAddr) + ibcRouter := porttypes.NewRouter() + + app.TransferKeeper = ibctransferkeeper.NewKeeper( + appCodec, + keys[ibctransfertypes.StoreKey], + app.GetSubspace(ibctransfertypes.ModuleName), + app.IBCKeeper.ChannelKeeper, + app.IBCKeeper.ChannelKeeper, + &app.IBCKeeper.PortKeeper, + app.AccountKeeper, + app.BankKeeper, + scopedTransferKeeper, + ) + app.transferModule = transfer.NewAppModule(app.TransferKeeper) + + // create IBC module from bottom to top of stack + var transferStack porttypes.IBCModule + transferStack = transfer.NewIBCModule(app.TransferKeeper) + + // Add transfer stack to IBC Router + ibcRouter.AddRoute(ibctransfertypes.ModuleName, transferStack) + + // ZetaChain keepers app.AuthorityKeeper = authoritykeeper.NewKeeper( appCodec, @@ -404,7 +513,8 @@ func New( // register the staking hooks // NOTE: stakingKeeper above is passed by reference, so that it will contain these hooks app.StakingKeeper.SetHooks( - stakingtypes.NewMultiStakingHooks(app.DistrKeeper.Hooks(), app.SlashingKeeper.Hooks(), app.ObserverKeeper.Hooks())) + stakingtypes.NewMultiStakingHooks(app.DistrKeeper.Hooks(), app.SlashingKeeper.Hooks(), app.ObserverKeeper.Hooks()), + ) app.AuthzKeeper = authzkeeper.NewKeeper( keys[authzkeeper.StoreKey], @@ -429,17 +539,27 @@ func New( tracer := cast.ToString(appOpts.Get(srvflags.EVMTracer)) feeSs := app.GetSubspace(feemarkettypes.ModuleName) app.FeeMarketKeeper = feemarketkeeper.NewKeeper( - appCodec, authtypes.NewModuleAddress(govtypes.ModuleName), - keys[feemarkettypes.StoreKey], tkeys[feemarkettypes.TransientKey], + appCodec, + authtypes.NewModuleAddress(govtypes.ModuleName), + keys[feemarkettypes.StoreKey], + tkeys[feemarkettypes.TransientKey], feeSs, app.ConsensusParamsKeeper, ) evmSs := app.GetSubspace(evmtypes.ModuleName) app.EvmKeeper = evmkeeper.NewKeeper( - appCodec, keys[evmtypes.StoreKey], tkeys[evmtypes.TransientKey], authtypes.NewModuleAddress(govtypes.ModuleName), - app.AccountKeeper, app.BankKeeper, app.StakingKeeper, - &app.FeeMarketKeeper, nil, geth.NewEVM, - tracer, evmSs, + appCodec, + keys[evmtypes.StoreKey], + tkeys[evmtypes.TransientKey], + authtypes.NewModuleAddress(govtypes.ModuleName), + app.AccountKeeper, + app.BankKeeper, + app.StakingKeeper, + &app.FeeMarketKeeper, + nil, + geth.NewEVM, + tracer, + evmSs, app.ConsensusParamsKeeper, ) @@ -466,10 +586,16 @@ func New( app.AuthorityKeeper, app.LightclientKeeper, ) - app.GroupKeeper = groupkeeper.NewKeeper(keys[group.StoreKey], appCodec, app.MsgServiceRouter(), app.AccountKeeper, group.Config{ - MaxExecutionPeriod: 2 * time.Hour, // Two hours. - MaxMetadataLen: 255, - }) + app.GroupKeeper = groupkeeper.NewKeeper( + keys[group.StoreKey], + appCodec, + app.MsgServiceRouter(), + app.AccountKeeper, + group.Config{ + MaxExecutionPeriod: 2 * time.Hour, // Two hours. + MaxMetadataLen: 255, + }, + ) // register the proposal types govRouter := govv1beta1.NewRouter() @@ -505,6 +631,9 @@ func New( app.FungibleKeeper.EVMHooks(), )) + // seal the IBC router + app.IBCKeeper.SetRouter(ibcRouter) + /**** Module Options ****/ // NOTE: we may consider parsing `appOpts` inside module constructors. For the moment @@ -522,6 +651,7 @@ func New( auth.NewAppModule(appCodec, app.AccountKeeper, nil, app.GetSubspace(authtypes.ModuleName)), vesting.NewAppModule(app.AccountKeeper, app.BankKeeper), bank.NewAppModule(appCodec, app.BankKeeper, app.AccountKeeper, app.GetSubspace(banktypes.ModuleName)), + capability.NewAppModule(appCodec, *app.CapabilityKeeper, false), crisis.NewAppModule(&app.CrisisKeeper, skipGenesisInvariants, app.GetSubspace(crisistypes.ModuleName)), gov.NewAppModule(appCodec, &app.GovKeeper, app.AccountKeeper, app.BankKeeper, app.GetSubspace(govtypes.ModuleName)), slashing.NewAppModule(appCodec, app.SlashingKeeper, app.AccountKeeper, app.BankKeeper, app.StakingKeeper, app.GetSubspace(slashingtypes.ModuleName)), @@ -531,6 +661,9 @@ func New( evidence.NewAppModule(app.EvidenceKeeper), params.NewAppModule(app.ParamsKeeper), consensus.NewAppModule(appCodec, app.ConsensusParamsKeeper), + app.transferModule, + ibc.NewAppModule(app.IBCKeeper), + transfer.NewAppModule(app.TransferKeeper), groupmodule.NewAppModule(appCodec, app.GroupKeeper, app.AccountKeeper, app.BankKeeper, interfaceRegistry), feemarket.NewAppModule(app.FeeMarketKeeper, feeSs), evm.NewAppModule(app.EvmKeeper, app.AccountKeeper, evmSs), @@ -547,8 +680,8 @@ func New( // there is nothing left over in the validator fee pool, so as to keep the // CanWithdrawInvariant invariant. // NOTE: staking module is required if HistoricalEntries param > 0 - app.mm.SetOrderBeginBlockers( + capabilitytypes.ModuleName, upgradetypes.ModuleName, evmtypes.ModuleName, distrtypes.ModuleName, @@ -563,6 +696,8 @@ func New( paramstypes.ModuleName, group.ModuleName, vestingtypes.ModuleName, + ibcexported.ModuleName, + ibctransfertypes.ModuleName, feemarkettypes.ModuleName, crosschaintypes.ModuleName, observertypes.ModuleName, @@ -574,6 +709,7 @@ func New( consensusparamtypes.ModuleName, ) app.mm.SetOrderEndBlockers( + capabilitytypes.ModuleName, banktypes.ModuleName, authtypes.ModuleName, upgradetypes.ModuleName, @@ -584,6 +720,8 @@ func New( vestingtypes.ModuleName, govtypes.ModuleName, paramstypes.ModuleName, + ibcexported.ModuleName, + ibctransfertypes.ModuleName, genutiltypes.ModuleName, group.ModuleName, crisistypes.ModuleName, @@ -652,6 +790,9 @@ func New( } } + app.ScopedIBCKeeper = scopedIBCKeeper + app.ScopedTransferKeeper = scopedTransferKeeper + return app } @@ -813,7 +954,8 @@ func initParamsKeeper(appCodec codec.BinaryCodec, legacyAmino *codec.LegacyAmino paramsKeeper.Subspace(slashingtypes.ModuleName) paramsKeeper.Subspace(govtypes.ModuleName).WithKeyTable(govv1.ParamKeyTable()) paramsKeeper.Subspace(crisistypes.ModuleName) - //pkt := ibctransfertypes.ParamKeyTable().RegisterParamSet(&ibccoreclienttypes.Params{}).RegisterParamSet(&ibcconnectiontypes.Params{}) + paramsKeeper.Subspace(ibctransfertypes.ModuleName) + paramsKeeper.Subspace(ibcexported.ModuleName) paramsKeeper.Subspace(evmtypes.ModuleName) paramsKeeper.Subspace(feemarkettypes.ModuleName) paramsKeeper.Subspace(group.ModuleName) diff --git a/app/init_genesis.go b/app/init_genesis.go index fc26ec6189..cdddb498e0 100644 --- a/app/init_genesis.go +++ b/app/init_genesis.go @@ -5,6 +5,7 @@ import ( vestingtypes "github.com/cosmos/cosmos-sdk/x/auth/vesting/types" "github.com/cosmos/cosmos-sdk/x/authz" banktypes "github.com/cosmos/cosmos-sdk/x/bank/types" + capabilitytypes "github.com/cosmos/cosmos-sdk/x/capability/types" consensusparamtypes "github.com/cosmos/cosmos-sdk/x/consensus/types" crisistypes "github.com/cosmos/cosmos-sdk/x/crisis/types" distrtypes "github.com/cosmos/cosmos-sdk/x/distribution/types" @@ -16,6 +17,8 @@ import ( slashingtypes "github.com/cosmos/cosmos-sdk/x/slashing/types" stakingtypes "github.com/cosmos/cosmos-sdk/x/staking/types" upgradetypes "github.com/cosmos/cosmos-sdk/x/upgrade/types" + ibctransfertypes "github.com/cosmos/ibc-go/v7/modules/apps/transfer/types" + ibcexported "github.com/cosmos/ibc-go/v7/modules/core/exported" evmtypes "github.com/evmos/ethermint/x/evm/types" feemarkettypes "github.com/evmos/ethermint/x/feemarket/types" authoritytypes "github.com/zeta-chain/zetacore/x/authority/types" @@ -26,14 +29,19 @@ import ( observertypes "github.com/zeta-chain/zetacore/x/observer/types" ) +// InitGenesisModuleList returns the module list for genesis initialization +// NOTE: Capability module must occur first so that it can initialize any capabilities func InitGenesisModuleList() []string { return []string{ + capabilitytypes.ModuleName, authtypes.ModuleName, banktypes.ModuleName, distrtypes.ModuleName, stakingtypes.ModuleName, slashingtypes.ModuleName, govtypes.ModuleName, + ibcexported.ModuleName, + ibctransfertypes.ModuleName, evmtypes.ModuleName, feemarkettypes.ModuleName, paramstypes.ModuleName, diff --git a/app/setup_handlers.go b/app/setup_handlers.go index 050547e4d2..3c13cac2ff 100644 --- a/app/setup_handlers.go +++ b/app/setup_handlers.go @@ -7,6 +7,7 @@ import ( "github.com/cosmos/cosmos-sdk/types/module" authtypes "github.com/cosmos/cosmos-sdk/x/auth/types" banktypes "github.com/cosmos/cosmos-sdk/x/bank/types" + capabilitytypes "github.com/cosmos/cosmos-sdk/x/capability/types" consensustypes "github.com/cosmos/cosmos-sdk/x/consensus/types" crisistypes "github.com/cosmos/cosmos-sdk/x/crisis/types" distrtypes "github.com/cosmos/cosmos-sdk/x/distribution/types" @@ -16,6 +17,8 @@ import ( slashingtypes "github.com/cosmos/cosmos-sdk/x/slashing/types" stakingtypes "github.com/cosmos/cosmos-sdk/x/staking/types" "github.com/cosmos/cosmos-sdk/x/upgrade/types" + ibctransfertypes "github.com/cosmos/ibc-go/v7/modules/apps/transfer/types" + ibcexported "github.com/cosmos/ibc-go/v7/modules/core/exported" "github.com/zeta-chain/zetacore/pkg/constant" emissionstypes "github.com/zeta-chain/zetacore/x/emissions/types" ) @@ -79,7 +82,13 @@ func SetupHandlers(app *App) { } if upgradeInfo.Name == constant.Version && !app.UpgradeKeeper.IsSkipHeight(upgradeInfo.Height) { storeUpgrades := storetypes.StoreUpgrades{ - Added: []string{consensustypes.ModuleName, crisistypes.ModuleName}, + Added: []string{ + consensustypes.ModuleName, + crisistypes.ModuleName, + capabilitytypes.ModuleName, + ibcexported.ModuleName, + ibctransfertypes.ModuleName, + }, } // Use upgrade store loader for the initial loading of all stores when app starts, // it checks if version == upgradeHeight and applies store upgrades before loading the stores, diff --git a/changelog.md b/changelog.md index 2c9d0211ad..8eedfe2ac3 100644 --- a/changelog.md +++ b/changelog.md @@ -11,6 +11,7 @@ * [2032](https://github.com/zeta-chain/node/pull/2032) - improve some general structure of the ZetaClient codebase * [2100](https://github.com/zeta-chain/node/pull/2100) - cosmos v0.47 upgrade +* [2145](https://github.com/zeta-chain/node/pull/2145) - add `ibc` and `ibc-transfer` modules * [2135](https://github.com/zeta-chain/node/pull/2135) - add develop build version logic ### Refactor diff --git a/docs/cli/zetacored/zetacored_query.md b/docs/cli/zetacored/zetacored_query.md index 7fc71e343d..5d35daf3c5 100644 --- a/docs/cli/zetacored/zetacored_query.md +++ b/docs/cli/zetacored/zetacored_query.md @@ -41,6 +41,8 @@ zetacored query [flags] * [zetacored query fungible](zetacored_query_fungible.md) - Querying commands for the fungible module * [zetacored query gov](zetacored_query_gov.md) - Querying commands for the governance module * [zetacored query group](zetacored_query_group.md) - Querying commands for the group module +* [zetacored query ibc](zetacored_query_ibc.md) - Querying commands for the IBC module +* [zetacored query ibc-transfer](zetacored_query_ibc-transfer.md) - IBC fungible token transfer query subcommands * [zetacored query lightclient](zetacored_query_lightclient.md) - Querying commands for the lightclient module * [zetacored query observer](zetacored_query_observer.md) - Querying commands for the observer module * [zetacored query params](zetacored_query_params.md) - Querying commands for the params module diff --git a/docs/cli/zetacored/zetacored_query_ibc-transfer.md b/docs/cli/zetacored/zetacored_query_ibc-transfer.md new file mode 100644 index 0000000000..e3fb1dbb41 --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc-transfer.md @@ -0,0 +1,31 @@ +# query ibc-transfer + +IBC fungible token transfer query subcommands + +### Options + +``` + -h, --help help for ibc-transfer +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query](zetacored_query.md) - Querying subcommands +* [zetacored query ibc-transfer denom-hash](zetacored_query_ibc-transfer_denom-hash.md) - Query the denom hash info from a given denom trace +* [zetacored query ibc-transfer denom-trace](zetacored_query_ibc-transfer_denom-trace.md) - Query the denom trace info from a given trace hash or ibc denom +* [zetacored query ibc-transfer denom-traces](zetacored_query_ibc-transfer_denom-traces.md) - Query the trace info for all token denominations +* [zetacored query ibc-transfer escrow-address](zetacored_query_ibc-transfer_escrow-address.md) - Get the escrow address for a channel +* [zetacored query ibc-transfer params](zetacored_query_ibc-transfer_params.md) - Query the current ibc-transfer parameters +* [zetacored query ibc-transfer total-escrow](zetacored_query_ibc-transfer_total-escrow.md) - Query the total amount of tokens in escrow for a denom + diff --git a/docs/cli/zetacored/zetacored_query_ibc-transfer_denom-hash.md b/docs/cli/zetacored/zetacored_query_ibc-transfer_denom-hash.md new file mode 100644 index 0000000000..412f868a77 --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc-transfer_denom-hash.md @@ -0,0 +1,44 @@ +# query ibc-transfer denom-hash + +Query the denom hash info from a given denom trace + +### Synopsis + +Query the denom hash info from a given denom trace + +``` +zetacored query ibc-transfer denom-hash [trace] [flags] +``` + +### Examples + +``` +zetacored query ibc-transfer denom-hash transfer/channel-0/uatom +``` + +### Options + +``` + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for denom-hash + --node string [host]:[port] to Tendermint RPC interface for this chain + -o, --output string Output format (text|json) +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc-transfer](zetacored_query_ibc-transfer.md) - IBC fungible token transfer query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc-transfer_denom-trace.md b/docs/cli/zetacored/zetacored_query_ibc-transfer_denom-trace.md new file mode 100644 index 0000000000..a204a4c3a5 --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc-transfer_denom-trace.md @@ -0,0 +1,44 @@ +# query ibc-transfer denom-trace + +Query the denom trace info from a given trace hash or ibc denom + +### Synopsis + +Query the denom trace info from a given trace hash or ibc denom + +``` +zetacored query ibc-transfer denom-trace [hash/denom] [flags] +``` + +### Examples + +``` +zetacored query ibc-transfer denom-trace 27A6394C3F9FF9C9DCF5DFFADF9BB5FE9A37C7E92B006199894CF1824DF9AC7C +``` + +### Options + +``` + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for denom-trace + --node string [host]:[port] to Tendermint RPC interface for this chain + -o, --output string Output format (text|json) +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc-transfer](zetacored_query_ibc-transfer.md) - IBC fungible token transfer query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc-transfer_denom-traces.md b/docs/cli/zetacored/zetacored_query_ibc-transfer_denom-traces.md new file mode 100644 index 0000000000..9600ade940 --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc-transfer_denom-traces.md @@ -0,0 +1,50 @@ +# query ibc-transfer denom-traces + +Query the trace info for all token denominations + +### Synopsis + +Query the trace info for all token denominations + +``` +zetacored query ibc-transfer denom-traces [flags] +``` + +### Examples + +``` +zetacored query ibc-transfer denom-traces +``` + +### Options + +``` + --count-total count total number of records in denominations trace to query for + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for denom-traces + --limit uint pagination limit of denominations trace to query for (default 100) + --node string [host]:[port] to Tendermint RPC interface for this chain + --offset uint pagination offset of denominations trace to query for + -o, --output string Output format (text|json) + --page uint pagination page of denominations trace to query for. This sets offset to a multiple of limit (default 1) + --page-key string pagination page-key of denominations trace to query for + --reverse results are sorted in descending order +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc-transfer](zetacored_query_ibc-transfer.md) - IBC fungible token transfer query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc-transfer_escrow-address.md b/docs/cli/zetacored/zetacored_query_ibc-transfer_escrow-address.md new file mode 100644 index 0000000000..3916a2a88f --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc-transfer_escrow-address.md @@ -0,0 +1,44 @@ +# query ibc-transfer escrow-address + +Get the escrow address for a channel + +### Synopsis + +Get the escrow address for a channel + +``` +zetacored query ibc-transfer escrow-address [flags] +``` + +### Examples + +``` +zetacored query ibc-transfer escrow-address [port] [channel-id] +``` + +### Options + +``` + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for escrow-address + --node string [host]:[port] to Tendermint RPC interface for this chain + -o, --output string Output format (text|json) +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc-transfer](zetacored_query_ibc-transfer.md) - IBC fungible token transfer query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc-transfer_params.md b/docs/cli/zetacored/zetacored_query_ibc-transfer_params.md new file mode 100644 index 0000000000..83b681f581 --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc-transfer_params.md @@ -0,0 +1,44 @@ +# query ibc-transfer params + +Query the current ibc-transfer parameters + +### Synopsis + +Query the current ibc-transfer parameters + +``` +zetacored query ibc-transfer params [flags] +``` + +### Examples + +``` +zetacored query ibc-transfer params +``` + +### Options + +``` + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for params + --node string [host]:[port] to Tendermint RPC interface for this chain + -o, --output string Output format (text|json) +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc-transfer](zetacored_query_ibc-transfer.md) - IBC fungible token transfer query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc-transfer_total-escrow.md b/docs/cli/zetacored/zetacored_query_ibc-transfer_total-escrow.md new file mode 100644 index 0000000000..1b5ac75ea5 --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc-transfer_total-escrow.md @@ -0,0 +1,44 @@ +# query ibc-transfer total-escrow + +Query the total amount of tokens in escrow for a denom + +### Synopsis + +Query the total amount of tokens in escrow for a denom + +``` +zetacored query ibc-transfer total-escrow [denom] [flags] +``` + +### Examples + +``` +zetacored query ibc-transfer total-escrow uosmo +``` + +### Options + +``` + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for total-escrow + --node string [host]:[port] to Tendermint RPC interface for this chain + -o, --output string Output format (text|json) +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc-transfer](zetacored_query_ibc-transfer.md) - IBC fungible token transfer query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc.md b/docs/cli/zetacored/zetacored_query_ibc.md new file mode 100644 index 0000000000..8ea0dcdd1f --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc.md @@ -0,0 +1,32 @@ +# query ibc + +Querying commands for the IBC module + +``` +zetacored query ibc [flags] +``` + +### Options + +``` + -h, --help help for ibc +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query](zetacored_query.md) - Querying subcommands +* [zetacored query ibc channel](zetacored_query_ibc_channel.md) - IBC channel query subcommands +* [zetacored query ibc client](zetacored_query_ibc_client.md) - IBC client query subcommands +* [zetacored query ibc connection](zetacored_query_ibc_connection.md) - IBC connection query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_channel.md b/docs/cli/zetacored/zetacored_query_ibc_channel.md new file mode 100644 index 0000000000..fdc14531af --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_channel.md @@ -0,0 +1,40 @@ +# query ibc channel + +IBC channel query subcommands + +``` +zetacored query ibc channel [flags] +``` + +### Options + +``` + -h, --help help for channel +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc](zetacored_query_ibc.md) - Querying commands for the IBC module +* [zetacored query ibc channel channels](zetacored_query_ibc_channel_channels.md) - Query all channels +* [zetacored query ibc channel client-state](zetacored_query_ibc_channel_client-state.md) - Query the client state associated with a channel +* [zetacored query ibc channel connections](zetacored_query_ibc_channel_connections.md) - Query all channels associated with a connection +* [zetacored query ibc channel end](zetacored_query_ibc_channel_end.md) - Query a channel end +* [zetacored query ibc channel next-sequence-receive](zetacored_query_ibc_channel_next-sequence-receive.md) - Query a next receive sequence +* [zetacored query ibc channel packet-ack](zetacored_query_ibc_channel_packet-ack.md) - Query a packet acknowledgement +* [zetacored query ibc channel packet-commitment](zetacored_query_ibc_channel_packet-commitment.md) - Query a packet commitment +* [zetacored query ibc channel packet-commitments](zetacored_query_ibc_channel_packet-commitments.md) - Query all packet commitments associated with a channel +* [zetacored query ibc channel packet-receipt](zetacored_query_ibc_channel_packet-receipt.md) - Query a packet receipt +* [zetacored query ibc channel unreceived-acks](zetacored_query_ibc_channel_unreceived-acks.md) - Query all the unreceived acks associated with a channel +* [zetacored query ibc channel unreceived-packets](zetacored_query_ibc_channel_unreceived-packets.md) - Query all the unreceived packets associated with a channel + diff --git a/docs/cli/zetacored/zetacored_query_ibc_channel_channels.md b/docs/cli/zetacored/zetacored_query_ibc_channel_channels.md new file mode 100644 index 0000000000..3e028b716f --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_channel_channels.md @@ -0,0 +1,50 @@ +# query ibc channel channels + +Query all channels + +### Synopsis + +Query all channels from a chain + +``` +zetacored query ibc channel channels [flags] +``` + +### Examples + +``` +zetacored query ibc channel channels +``` + +### Options + +``` + --count-total count total number of records in channels to query for + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for channels + --limit uint pagination limit of channels to query for (default 100) + --node string [host]:[port] to Tendermint RPC interface for this chain + --offset uint pagination offset of channels to query for + -o, --output string Output format (text|json) + --page uint pagination page of channels to query for. This sets offset to a multiple of limit (default 1) + --page-key string pagination page-key of channels to query for + --reverse results are sorted in descending order +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc channel](zetacored_query_ibc_channel.md) - IBC channel query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_channel_client-state.md b/docs/cli/zetacored/zetacored_query_ibc_channel_client-state.md new file mode 100644 index 0000000000..c8c289276f --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_channel_client-state.md @@ -0,0 +1,44 @@ +# query ibc channel client-state + +Query the client state associated with a channel + +### Synopsis + +Query the client state associated with a channel, by providing its port and channel identifiers. + +``` +zetacored query ibc channel client-state [port-id] [channel-id] [flags] +``` + +### Examples + +``` +zetacored query ibc channel client-state [port-id] [channel-id] +``` + +### Options + +``` + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for client-state + --node string [host]:[port] to Tendermint RPC interface for this chain + -o, --output string Output format (text|json) +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc channel](zetacored_query_ibc_channel.md) - IBC channel query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_channel_connections.md b/docs/cli/zetacored/zetacored_query_ibc_channel_connections.md new file mode 100644 index 0000000000..d6aa4cdf05 --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_channel_connections.md @@ -0,0 +1,50 @@ +# query ibc channel connections + +Query all channels associated with a connection + +### Synopsis + +Query all channels associated with a connection + +``` +zetacored query ibc channel connections [connection-id] [flags] +``` + +### Examples + +``` +zetacored query ibc channel connections [connection-id] +``` + +### Options + +``` + --count-total count total number of records in channels associated with a connection to query for + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for connections + --limit uint pagination limit of channels associated with a connection to query for (default 100) + --node string [host]:[port] to Tendermint RPC interface for this chain + --offset uint pagination offset of channels associated with a connection to query for + -o, --output string Output format (text|json) + --page uint pagination page of channels associated with a connection to query for. This sets offset to a multiple of limit (default 1) + --page-key string pagination page-key of channels associated with a connection to query for + --reverse results are sorted in descending order +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc channel](zetacored_query_ibc_channel.md) - IBC channel query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_channel_end.md b/docs/cli/zetacored/zetacored_query_ibc_channel_end.md new file mode 100644 index 0000000000..2eb0d532c6 --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_channel_end.md @@ -0,0 +1,45 @@ +# query ibc channel end + +Query a channel end + +### Synopsis + +Query an IBC channel end from a port and channel identifiers + +``` +zetacored query ibc channel end [port-id] [channel-id] [flags] +``` + +### Examples + +``` +zetacored query ibc channel end [port-id] [channel-id] +``` + +### Options + +``` + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for end + --node string [host]:[port] to Tendermint RPC interface for this chain + -o, --output string Output format (text|json) + --prove show proofs for the query results (default true) +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc channel](zetacored_query_ibc_channel.md) - IBC channel query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_channel_next-sequence-receive.md b/docs/cli/zetacored/zetacored_query_ibc_channel_next-sequence-receive.md new file mode 100644 index 0000000000..95d87b452b --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_channel_next-sequence-receive.md @@ -0,0 +1,45 @@ +# query ibc channel next-sequence-receive + +Query a next receive sequence + +### Synopsis + +Query the next receive sequence for a given channel + +``` +zetacored query ibc channel next-sequence-receive [port-id] [channel-id] [flags] +``` + +### Examples + +``` +zetacored query ibc channel next-sequence-receive [port-id] [channel-id] +``` + +### Options + +``` + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for next-sequence-receive + --node string [host]:[port] to Tendermint RPC interface for this chain + -o, --output string Output format (text|json) + --prove show proofs for the query results (default true) +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc channel](zetacored_query_ibc_channel.md) - IBC channel query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_channel_packet-ack.md b/docs/cli/zetacored/zetacored_query_ibc_channel_packet-ack.md new file mode 100644 index 0000000000..15108f9c7c --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_channel_packet-ack.md @@ -0,0 +1,45 @@ +# query ibc channel packet-ack + +Query a packet acknowledgement + +### Synopsis + +Query a packet acknowledgement + +``` +zetacored query ibc channel packet-ack [port-id] [channel-id] [sequence] [flags] +``` + +### Examples + +``` +zetacored query ibc channel packet-ack [port-id] [channel-id] [sequence] +``` + +### Options + +``` + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for packet-ack + --node string [host]:[port] to Tendermint RPC interface for this chain + -o, --output string Output format (text|json) + --prove show proofs for the query results (default true) +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc channel](zetacored_query_ibc_channel.md) - IBC channel query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_channel_packet-commitment.md b/docs/cli/zetacored/zetacored_query_ibc_channel_packet-commitment.md new file mode 100644 index 0000000000..a10156a519 --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_channel_packet-commitment.md @@ -0,0 +1,45 @@ +# query ibc channel packet-commitment + +Query a packet commitment + +### Synopsis + +Query a packet commitment + +``` +zetacored query ibc channel packet-commitment [port-id] [channel-id] [sequence] [flags] +``` + +### Examples + +``` +zetacored query ibc channel packet-commitment [port-id] [channel-id] [sequence] +``` + +### Options + +``` + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for packet-commitment + --node string [host]:[port] to Tendermint RPC interface for this chain + -o, --output string Output format (text|json) + --prove show proofs for the query results (default true) +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc channel](zetacored_query_ibc_channel.md) - IBC channel query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_channel_packet-commitments.md b/docs/cli/zetacored/zetacored_query_ibc_channel_packet-commitments.md new file mode 100644 index 0000000000..e1b9455d1e --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_channel_packet-commitments.md @@ -0,0 +1,50 @@ +# query ibc channel packet-commitments + +Query all packet commitments associated with a channel + +### Synopsis + +Query all packet commitments associated with a channel + +``` +zetacored query ibc channel packet-commitments [port-id] [channel-id] [flags] +``` + +### Examples + +``` +zetacored query ibc channel packet-commitments [port-id] [channel-id] +``` + +### Options + +``` + --count-total count total number of records in packet commitments associated with a channel to query for + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for packet-commitments + --limit uint pagination limit of packet commitments associated with a channel to query for (default 100) + --node string [host]:[port] to Tendermint RPC interface for this chain + --offset uint pagination offset of packet commitments associated with a channel to query for + -o, --output string Output format (text|json) + --page uint pagination page of packet commitments associated with a channel to query for. This sets offset to a multiple of limit (default 1) + --page-key string pagination page-key of packet commitments associated with a channel to query for + --reverse results are sorted in descending order +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc channel](zetacored_query_ibc_channel.md) - IBC channel query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_channel_packet-receipt.md b/docs/cli/zetacored/zetacored_query_ibc_channel_packet-receipt.md new file mode 100644 index 0000000000..25520dd26c --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_channel_packet-receipt.md @@ -0,0 +1,45 @@ +# query ibc channel packet-receipt + +Query a packet receipt + +### Synopsis + +Query a packet receipt + +``` +zetacored query ibc channel packet-receipt [port-id] [channel-id] [sequence] [flags] +``` + +### Examples + +``` +zetacored query ibc channel packet-receipt [port-id] [channel-id] [sequence] +``` + +### Options + +``` + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for packet-receipt + --node string [host]:[port] to Tendermint RPC interface for this chain + -o, --output string Output format (text|json) + --prove show proofs for the query results (default true) +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc channel](zetacored_query_ibc_channel.md) - IBC channel query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_channel_unreceived-acks.md b/docs/cli/zetacored/zetacored_query_ibc_channel_unreceived-acks.md new file mode 100644 index 0000000000..b8cf3f5470 --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_channel_unreceived-acks.md @@ -0,0 +1,49 @@ +# query ibc channel unreceived-acks + +Query all the unreceived acks associated with a channel + +### Synopsis + +Given a list of acknowledgement sequences from counterparty, determine if an ack on the counterparty chain has been received on the executing chain. + +The return value represents: +- Unreceived packet acknowledgement: packet commitment exists on original sending (executing) chain and ack exists on receiving chain. + + +``` +zetacored query ibc channel unreceived-acks [port-id] [channel-id] [flags] +``` + +### Examples + +``` +zetacored query ibc channel unreceived-acks [port-id] [channel-id] --sequences=1,2,3 +``` + +### Options + +``` + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for unreceived-acks + --node string [host]:[port] to Tendermint RPC interface for this chain + -o, --output string Output format (text|json) + --sequences int64Slice comma separated list of packet sequence numbers (default []) +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc channel](zetacored_query_ibc_channel.md) - IBC channel query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_channel_unreceived-packets.md b/docs/cli/zetacored/zetacored_query_ibc_channel_unreceived-packets.md new file mode 100644 index 0000000000..99eb79daf7 --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_channel_unreceived-packets.md @@ -0,0 +1,49 @@ +# query ibc channel unreceived-packets + +Query all the unreceived packets associated with a channel + +### Synopsis + +Determine if a packet, given a list of packet commitment sequences, is unreceived. + +The return value represents: +- Unreceived packet commitments: no acknowledgement exists on receiving chain for the given packet commitment sequence on sending chain. + + +``` +zetacored query ibc channel unreceived-packets [port-id] [channel-id] [flags] +``` + +### Examples + +``` +zetacored query ibc channel unreceived-packets [port-id] [channel-id] --sequences=1,2,3 +``` + +### Options + +``` + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for unreceived-packets + --node string [host]:[port] to Tendermint RPC interface for this chain + -o, --output string Output format (text|json) + --sequences int64Slice comma separated list of packet sequence numbers (default []) +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc channel](zetacored_query_ibc_channel.md) - IBC channel query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_client.md b/docs/cli/zetacored/zetacored_query_ibc_client.md new file mode 100644 index 0000000000..7aa524b8d8 --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_client.md @@ -0,0 +1,38 @@ +# query ibc client + +IBC client query subcommands + +``` +zetacored query ibc client [flags] +``` + +### Options + +``` + -h, --help help for client +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc](zetacored_query_ibc.md) - Querying commands for the IBC module +* [zetacored query ibc client consensus-state](zetacored_query_ibc_client_consensus-state.md) - Query the consensus state of a client at a given height +* [zetacored query ibc client consensus-state-heights](zetacored_query_ibc_client_consensus-state-heights.md) - Query the heights of all consensus states of a client. +* [zetacored query ibc client consensus-states](zetacored_query_ibc_client_consensus-states.md) - Query all the consensus states of a client. +* [zetacored query ibc client header](zetacored_query_ibc_client_header.md) - Query the latest header of the running chain +* [zetacored query ibc client params](zetacored_query_ibc_client_params.md) - Query the current ibc client parameters +* [zetacored query ibc client self-consensus-state](zetacored_query_ibc_client_self-consensus-state.md) - Query the self consensus state for this chain +* [zetacored query ibc client state](zetacored_query_ibc_client_state.md) - Query a client state +* [zetacored query ibc client states](zetacored_query_ibc_client_states.md) - Query all available light clients +* [zetacored query ibc client status](zetacored_query_ibc_client_status.md) - Query client status + diff --git a/docs/cli/zetacored/zetacored_query_ibc_client_consensus-state-heights.md b/docs/cli/zetacored/zetacored_query_ibc_client_consensus-state-heights.md new file mode 100644 index 0000000000..a801f8fd00 --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_client_consensus-state-heights.md @@ -0,0 +1,50 @@ +# query ibc client consensus-state-heights + +Query the heights of all consensus states of a client. + +### Synopsis + +Query the heights of all consensus states associated with the provided client ID. + +``` +zetacored query ibc client consensus-state-heights [client-id] [flags] +``` + +### Examples + +``` +zetacored query ibc client consensus-state-heights [client-id] +``` + +### Options + +``` + --count-total count total number of records in consensus state heights to query for + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for consensus-state-heights + --limit uint pagination limit of consensus state heights to query for (default 100) + --node string [host]:[port] to Tendermint RPC interface for this chain + --offset uint pagination offset of consensus state heights to query for + -o, --output string Output format (text|json) + --page uint pagination page of consensus state heights to query for. This sets offset to a multiple of limit (default 1) + --page-key string pagination page-key of consensus state heights to query for + --reverse results are sorted in descending order +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc client](zetacored_query_ibc_client.md) - IBC client query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_client_consensus-state.md b/docs/cli/zetacored/zetacored_query_ibc_client_consensus-state.md new file mode 100644 index 0000000000..9817f1cae0 --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_client_consensus-state.md @@ -0,0 +1,47 @@ +# query ibc client consensus-state + +Query the consensus state of a client at a given height + +### Synopsis + +Query the consensus state for a particular light client at a given height. +If the '--latest' flag is included, the query returns the latest consensus state, overriding the height argument. + +``` +zetacored query ibc client consensus-state [client-id] [height] [flags] +``` + +### Examples + +``` +zetacored query ibc client consensus-state [client-id] [height] +``` + +### Options + +``` + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for consensus-state + --latest-height return latest stored consensus state + --node string [host]:[port] to Tendermint RPC interface for this chain + -o, --output string Output format (text|json) + --prove show proofs for the query results (default true) +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc client](zetacored_query_ibc_client.md) - IBC client query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_client_consensus-states.md b/docs/cli/zetacored/zetacored_query_ibc_client_consensus-states.md new file mode 100644 index 0000000000..a8beef3110 --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_client_consensus-states.md @@ -0,0 +1,50 @@ +# query ibc client consensus-states + +Query all the consensus states of a client. + +### Synopsis + +Query all the consensus states from a given client state. + +``` +zetacored query ibc client consensus-states [client-id] [flags] +``` + +### Examples + +``` +zetacored query ibc client consensus-states [client-id] +``` + +### Options + +``` + --count-total count total number of records in consensus states to query for + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for consensus-states + --limit uint pagination limit of consensus states to query for (default 100) + --node string [host]:[port] to Tendermint RPC interface for this chain + --offset uint pagination offset of consensus states to query for + -o, --output string Output format (text|json) + --page uint pagination page of consensus states to query for. This sets offset to a multiple of limit (default 1) + --page-key string pagination page-key of consensus states to query for + --reverse results are sorted in descending order +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc client](zetacored_query_ibc_client.md) - IBC client query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_client_header.md b/docs/cli/zetacored/zetacored_query_ibc_client_header.md new file mode 100644 index 0000000000..a281dd87f0 --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_client_header.md @@ -0,0 +1,44 @@ +# query ibc client header + +Query the latest header of the running chain + +### Synopsis + +Query the latest Tendermint header of the running chain + +``` +zetacored query ibc client header [flags] +``` + +### Examples + +``` +zetacored query ibc client header +``` + +### Options + +``` + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for header + --node string [host]:[port] to Tendermint RPC interface for this chain + -o, --output string Output format (text|json) +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc client](zetacored_query_ibc_client.md) - IBC client query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_client_params.md b/docs/cli/zetacored/zetacored_query_ibc_client_params.md new file mode 100644 index 0000000000..2e72c7d0ee --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_client_params.md @@ -0,0 +1,44 @@ +# query ibc client params + +Query the current ibc client parameters + +### Synopsis + +Query the current ibc client parameters + +``` +zetacored query ibc client params [flags] +``` + +### Examples + +``` +zetacored query ibc client params +``` + +### Options + +``` + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for params + --node string [host]:[port] to Tendermint RPC interface for this chain + -o, --output string Output format (text|json) +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc client](zetacored_query_ibc_client.md) - IBC client query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_client_self-consensus-state.md b/docs/cli/zetacored/zetacored_query_ibc_client_self-consensus-state.md new file mode 100644 index 0000000000..a7088c2d76 --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_client_self-consensus-state.md @@ -0,0 +1,44 @@ +# query ibc client self-consensus-state + +Query the self consensus state for this chain + +### Synopsis + +Query the self consensus state for this chain. This result may be used for verifying IBC clients representing this chain which are hosted on counterparty chains. + +``` +zetacored query ibc client self-consensus-state [flags] +``` + +### Examples + +``` +zetacored query ibc client self-consensus-state +``` + +### Options + +``` + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for self-consensus-state + --node string [host]:[port] to Tendermint RPC interface for this chain + -o, --output string Output format (text|json) +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc client](zetacored_query_ibc_client.md) - IBC client query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_client_state.md b/docs/cli/zetacored/zetacored_query_ibc_client_state.md new file mode 100644 index 0000000000..61f6d49a00 --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_client_state.md @@ -0,0 +1,45 @@ +# query ibc client state + +Query a client state + +### Synopsis + +Query stored client state + +``` +zetacored query ibc client state [client-id] [flags] +``` + +### Examples + +``` +zetacored query ibc client state [client-id] +``` + +### Options + +``` + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for state + --node string [host]:[port] to Tendermint RPC interface for this chain + -o, --output string Output format (text|json) + --prove show proofs for the query results (default true) +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc client](zetacored_query_ibc_client.md) - IBC client query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_client_states.md b/docs/cli/zetacored/zetacored_query_ibc_client_states.md new file mode 100644 index 0000000000..bfe4ee55f7 --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_client_states.md @@ -0,0 +1,50 @@ +# query ibc client states + +Query all available light clients + +### Synopsis + +Query all available light clients + +``` +zetacored query ibc client states [flags] +``` + +### Examples + +``` +zetacored query ibc client states +``` + +### Options + +``` + --count-total count total number of records in client states to query for + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for states + --limit uint pagination limit of client states to query for (default 100) + --node string [host]:[port] to Tendermint RPC interface for this chain + --offset uint pagination offset of client states to query for + -o, --output string Output format (text|json) + --page uint pagination page of client states to query for. This sets offset to a multiple of limit (default 1) + --page-key string pagination page-key of client states to query for + --reverse results are sorted in descending order +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc client](zetacored_query_ibc_client.md) - IBC client query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_client_status.md b/docs/cli/zetacored/zetacored_query_ibc_client_status.md new file mode 100644 index 0000000000..2074f02cbf --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_client_status.md @@ -0,0 +1,44 @@ +# query ibc client status + +Query client status + +### Synopsis + +Query client activity status. Any client without an 'Active' status is considered inactive + +``` +zetacored query ibc client status [client-id] [flags] +``` + +### Examples + +``` +zetacored query ibc client status [client-id] +``` + +### Options + +``` + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for status + --node string [host]:[port] to Tendermint RPC interface for this chain + -o, --output string Output format (text|json) +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc client](zetacored_query_ibc_client.md) - IBC client query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_connection.md b/docs/cli/zetacored/zetacored_query_ibc_connection.md new file mode 100644 index 0000000000..c3c8d581ed --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_connection.md @@ -0,0 +1,29 @@ +# query ibc connection + +IBC connection query subcommands + +### Options + +``` + -h, --help help for connection +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc](zetacored_query_ibc.md) - Querying commands for the IBC module +* [zetacored query ibc connection connections](zetacored_query_ibc_connection_connections.md) - Query all connections +* [zetacored query ibc connection end](zetacored_query_ibc_connection_end.md) - Query stored connection end +* [zetacored query ibc connection params](zetacored_query_ibc_connection_params.md) - Query the current ibc connection parameters +* [zetacored query ibc connection path](zetacored_query_ibc_connection_path.md) - Query stored client connection paths + diff --git a/docs/cli/zetacored/zetacored_query_ibc_connection_connections.md b/docs/cli/zetacored/zetacored_query_ibc_connection_connections.md new file mode 100644 index 0000000000..b534911978 --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_connection_connections.md @@ -0,0 +1,50 @@ +# query ibc connection connections + +Query all connections + +### Synopsis + +Query all connections ends from a chain + +``` +zetacored query ibc connection connections [flags] +``` + +### Examples + +``` +zetacored query ibc connection connections +``` + +### Options + +``` + --count-total count total number of records in connection ends to query for + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for connections + --limit uint pagination limit of connection ends to query for (default 100) + --node string [host]:[port] to Tendermint RPC interface for this chain + --offset uint pagination offset of connection ends to query for + -o, --output string Output format (text|json) + --page uint pagination page of connection ends to query for. This sets offset to a multiple of limit (default 1) + --page-key string pagination page-key of connection ends to query for + --reverse results are sorted in descending order +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc connection](zetacored_query_ibc_connection.md) - IBC connection query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_connection_end.md b/docs/cli/zetacored/zetacored_query_ibc_connection_end.md new file mode 100644 index 0000000000..771b41d819 --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_connection_end.md @@ -0,0 +1,45 @@ +# query ibc connection end + +Query stored connection end + +### Synopsis + +Query stored connection end + +``` +zetacored query ibc connection end [connection-id] [flags] +``` + +### Examples + +``` +zetacored query ibc connection end [connection-id] +``` + +### Options + +``` + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for end + --node string [host]:[port] to Tendermint RPC interface for this chain + -o, --output string Output format (text|json) + --prove show proofs for the query results (default true) +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc connection](zetacored_query_ibc_connection.md) - IBC connection query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_connection_params.md b/docs/cli/zetacored/zetacored_query_ibc_connection_params.md new file mode 100644 index 0000000000..d183b83d75 --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_connection_params.md @@ -0,0 +1,44 @@ +# query ibc connection params + +Query the current ibc connection parameters + +### Synopsis + +Query the current ibc connection parameters + +``` +zetacored query ibc connection params [flags] +``` + +### Examples + +``` +zetacored query ibc connection params +``` + +### Options + +``` + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for params + --node string [host]:[port] to Tendermint RPC interface for this chain + -o, --output string Output format (text|json) +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc connection](zetacored_query_ibc_connection.md) - IBC connection query subcommands + diff --git a/docs/cli/zetacored/zetacored_query_ibc_connection_path.md b/docs/cli/zetacored/zetacored_query_ibc_connection_path.md new file mode 100644 index 0000000000..f276852f7a --- /dev/null +++ b/docs/cli/zetacored/zetacored_query_ibc_connection_path.md @@ -0,0 +1,45 @@ +# query ibc connection path + +Query stored client connection paths + +### Synopsis + +Query stored client connection paths + +``` +zetacored query ibc connection path [client-id] [flags] +``` + +### Examples + +``` +zetacored query ibc connection path [client-id] +``` + +### Options + +``` + --grpc-addr string the gRPC endpoint to use for this chain + --grpc-insecure allow gRPC over insecure channels, if not TLS the server must use TLS + --height int Use a specific height to query state at (this can error if the node is pruning state) + -h, --help help for path + --node string [host]:[port] to Tendermint RPC interface for this chain + -o, --output string Output format (text|json) + --prove show proofs for the query results (default true) +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored query ibc connection](zetacored_query_ibc_connection.md) - IBC connection query subcommands + diff --git a/docs/cli/zetacored/zetacored_tx.md b/docs/cli/zetacored/zetacored_tx.md index feb3f8eaf9..baa70fa53e 100644 --- a/docs/cli/zetacored/zetacored_tx.md +++ b/docs/cli/zetacored/zetacored_tx.md @@ -41,6 +41,8 @@ zetacored tx [flags] * [zetacored tx fungible](zetacored_tx_fungible.md) - fungible transactions subcommands * [zetacored tx gov](zetacored_tx_gov.md) - Governance transactions subcommands * [zetacored tx group](zetacored_tx_group.md) - Group transaction subcommands +* [zetacored tx ibc](zetacored_tx_ibc.md) - IBC transaction subcommands +* [zetacored tx ibc-transfer](zetacored_tx_ibc-transfer.md) - IBC fungible token transfer transaction subcommands * [zetacored tx lightclient](zetacored_tx_lightclient.md) - lightclient transactions subcommands * [zetacored tx multi-sign](zetacored_tx_multi-sign.md) - Generate multisig signatures for transactions generated offline * [zetacored tx multisign-batch](zetacored_tx_multisign-batch.md) - Assemble multisig transactions in batch from batch signatures diff --git a/docs/cli/zetacored/zetacored_tx_gov_submit-legacy-proposal.md b/docs/cli/zetacored/zetacored_tx_gov_submit-legacy-proposal.md index 6c1065d9c1..57e05ab46d 100644 --- a/docs/cli/zetacored/zetacored_tx_gov_submit-legacy-proposal.md +++ b/docs/cli/zetacored/zetacored_tx_gov_submit-legacy-proposal.md @@ -77,6 +77,8 @@ zetacored tx gov submit-legacy-proposal [flags] * [zetacored tx gov](zetacored_tx_gov.md) - Governance transactions subcommands * [zetacored tx gov submit-legacy-proposal cancel-software-upgrade](zetacored_tx_gov_submit-legacy-proposal_cancel-software-upgrade.md) - Cancel the current software upgrade proposal +* [zetacored tx gov submit-legacy-proposal ibc-upgrade](zetacored_tx_gov_submit-legacy-proposal_ibc-upgrade.md) - Submit an IBC upgrade proposal * [zetacored tx gov submit-legacy-proposal param-change](zetacored_tx_gov_submit-legacy-proposal_param-change.md) - Submit a parameter change proposal * [zetacored tx gov submit-legacy-proposal software-upgrade](zetacored_tx_gov_submit-legacy-proposal_software-upgrade.md) - Submit a software upgrade proposal +* [zetacored tx gov submit-legacy-proposal update-client](zetacored_tx_gov_submit-legacy-proposal_update-client.md) - Submit an update IBC client proposal diff --git a/docs/cli/zetacored/zetacored_tx_gov_submit-legacy-proposal_ibc-upgrade.md b/docs/cli/zetacored/zetacored_tx_gov_submit-legacy-proposal_ibc-upgrade.md new file mode 100644 index 0000000000..f002e28f42 --- /dev/null +++ b/docs/cli/zetacored/zetacored_tx_gov_submit-legacy-proposal_ibc-upgrade.md @@ -0,0 +1,71 @@ +# tx gov submit-legacy-proposal ibc-upgrade + +Submit an IBC upgrade proposal + +### Synopsis + +Submit an IBC client breaking upgrade proposal along with an initial deposit. +The client state specified is the upgraded client state representing the upgraded chain +Example Upgraded Client State JSON: +{ + "@type":"/ibc.lightclients.tendermint.v1.ClientState", + "chain_id":"testchain1", + "unbonding_period":"1814400s", + "latest_height":{"revision_number":"0","revision_height":"2"}, + "proof_specs":[{"leaf_spec":{"hash":"SHA256","prehash_key":"NO_HASH","prehash_value":"SHA256","length":"VAR_PROTO","prefix":"AA=="},"inner_spec":{"child_order":[0,1],"child_size":33,"min_prefix_length":4,"max_prefix_length":12,"empty_child":null,"hash":"SHA256"},"max_depth":0,"min_depth":0},{"leaf_spec":{"hash":"SHA256","prehash_key":"NO_HASH","prehash_value":"SHA256","length":"VAR_PROTO","prefix":"AA=="},"inner_spec":{"child_order":[0,1],"child_size":32,"min_prefix_length":1,"max_prefix_length":1,"empty_child":null,"hash":"SHA256"},"max_depth":0,"min_depth":0}], + "upgrade_path":["upgrade","upgradedIBCState"], +} + + +``` +zetacored tx gov submit-legacy-proposal ibc-upgrade [name] [height] [path/to/upgraded_client_state.json] [flags] +``` + +### Options + +``` + -a, --account-number uint The account number of the signing account (offline mode only) + --aux Generate aux signer data instead of sending a tx + -b, --broadcast-mode string Transaction broadcasting mode (sync|async) + --chain-id string The network chain ID + --deposit string deposit of proposal + --description string description of proposal + --dry-run ignore the --gas flag and perform a simulation of a transaction, but don't broadcast it (when enabled, the local Keybase is not accessible) + --fee-granter string Fee granter grants fees for the transaction + --fee-payer string Fee payer pays fees for the transaction instead of deducting from the signer + --fees string Fees to pay along with transaction; eg: 10uatom + --from string Name or address of private key with which to sign + --gas string gas limit to set per-transaction; set to "auto" to calculate sufficient gas automatically. Note: "auto" option doesn't always report accurate results. Set a valid coin value to adjust the result. Can be used instead of "fees". (default 200000) + --gas-adjustment float adjustment factor to be multiplied against the estimate returned by the tx simulation; if the gas limit is set manually this flag is ignored (default 1) + --gas-prices string Gas prices in decimal format to determine the transaction fee (e.g. 0.1uatom) + --generate-only Build an unsigned transaction and write it to STDOUT (when enabled, the local Keybase only accessed when providing a key name) + -h, --help help for ibc-upgrade + --keyring-backend string Select keyring's backend (os|file|kwallet|pass|test|memory) + --keyring-dir string The client Keyring directory; if omitted, the default 'home' directory will be used + --ledger Use a connected Ledger device + --node string [host]:[port] to tendermint rpc interface for this chain + --note string Note to add a description to the transaction (previously --memo) + --offline Offline mode (does not allow any online functionality) + -o, --output string Output format (text|json) + -s, --sequence uint The sequence number of the signing account (offline mode only) + --sign-mode string Choose sign mode (direct|amino-json|direct-aux), this is an advanced feature + --timeout-height uint Set a block timeout height to prevent the tx from being committed past a certain height + --tip string Tip is the amount that is going to be transferred to the fee payer on the target chain. This flag is only valid when used with --aux, and is ignored if the target chain didn't enable the TipDecorator + --title string title of proposal + -y, --yes Skip tx broadcasting prompt confirmation +``` + +### Options inherited from parent commands + +``` + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored tx gov submit-legacy-proposal](zetacored_tx_gov_submit-legacy-proposal.md) - Submit a legacy proposal along with an initial deposit + diff --git a/docs/cli/zetacored/zetacored_tx_gov_submit-legacy-proposal_update-client.md b/docs/cli/zetacored/zetacored_tx_gov_submit-legacy-proposal_update-client.md new file mode 100644 index 0000000000..fd637e75e2 --- /dev/null +++ b/docs/cli/zetacored/zetacored_tx_gov_submit-legacy-proposal_update-client.md @@ -0,0 +1,62 @@ +# tx gov submit-legacy-proposal update-client + +Submit an update IBC client proposal + +### Synopsis + +Submit an update IBC client proposal along with an initial deposit. +Please specify a subject client identifier you want to update.. +Please specify the substitute client the subject client will be updated to. + +``` +zetacored tx gov submit-legacy-proposal update-client [subject-client-id] [substitute-client-id] [flags] +``` + +### Options + +``` + -a, --account-number uint The account number of the signing account (offline mode only) + --aux Generate aux signer data instead of sending a tx + -b, --broadcast-mode string Transaction broadcasting mode (sync|async) + --chain-id string The network chain ID + --deposit string deposit of proposal + --description string description of proposal + --dry-run ignore the --gas flag and perform a simulation of a transaction, but don't broadcast it (when enabled, the local Keybase is not accessible) + --fee-granter string Fee granter grants fees for the transaction + --fee-payer string Fee payer pays fees for the transaction instead of deducting from the signer + --fees string Fees to pay along with transaction; eg: 10uatom + --from string Name or address of private key with which to sign + --gas string gas limit to set per-transaction; set to "auto" to calculate sufficient gas automatically. Note: "auto" option doesn't always report accurate results. Set a valid coin value to adjust the result. Can be used instead of "fees". (default 200000) + --gas-adjustment float adjustment factor to be multiplied against the estimate returned by the tx simulation; if the gas limit is set manually this flag is ignored (default 1) + --gas-prices string Gas prices in decimal format to determine the transaction fee (e.g. 0.1uatom) + --generate-only Build an unsigned transaction and write it to STDOUT (when enabled, the local Keybase only accessed when providing a key name) + -h, --help help for update-client + --keyring-backend string Select keyring's backend (os|file|kwallet|pass|test|memory) + --keyring-dir string The client Keyring directory; if omitted, the default 'home' directory will be used + --ledger Use a connected Ledger device + --node string [host]:[port] to tendermint rpc interface for this chain + --note string Note to add a description to the transaction (previously --memo) + --offline Offline mode (does not allow any online functionality) + -o, --output string Output format (text|json) + -s, --sequence uint The sequence number of the signing account (offline mode only) + --sign-mode string Choose sign mode (direct|amino-json|direct-aux), this is an advanced feature + --timeout-height uint Set a block timeout height to prevent the tx from being committed past a certain height + --tip string Tip is the amount that is going to be transferred to the fee payer on the target chain. This flag is only valid when used with --aux, and is ignored if the target chain didn't enable the TipDecorator + --title string title of proposal + -y, --yes Skip tx broadcasting prompt confirmation +``` + +### Options inherited from parent commands + +``` + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored tx gov submit-legacy-proposal](zetacored_tx_gov_submit-legacy-proposal.md) - Submit a legacy proposal along with an initial deposit + diff --git a/docs/cli/zetacored/zetacored_tx_ibc-transfer.md b/docs/cli/zetacored/zetacored_tx_ibc-transfer.md new file mode 100644 index 0000000000..3ec8b913c7 --- /dev/null +++ b/docs/cli/zetacored/zetacored_tx_ibc-transfer.md @@ -0,0 +1,30 @@ +# tx ibc-transfer + +IBC fungible token transfer transaction subcommands + +``` +zetacored tx ibc-transfer [flags] +``` + +### Options + +``` + -h, --help help for ibc-transfer +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored tx](zetacored_tx.md) - Transactions subcommands +* [zetacored tx ibc-transfer transfer](zetacored_tx_ibc-transfer_transfer.md) - Transfer a fungible token through IBC + diff --git a/docs/cli/zetacored/zetacored_tx_ibc-transfer_transfer.md b/docs/cli/zetacored/zetacored_tx_ibc-transfer_transfer.md new file mode 100644 index 0000000000..c8711188be --- /dev/null +++ b/docs/cli/zetacored/zetacored_tx_ibc-transfer_transfer.md @@ -0,0 +1,72 @@ +# tx ibc-transfer transfer + +Transfer a fungible token through IBC + +### Synopsis + +Transfer a fungible token through IBC. Timeouts can be specified +as absolute or relative using the "absolute-timeouts" flag. Timeout height can be set by passing in the height string +in the form {revision}-{height} using the "packet-timeout-height" flag. Relative timeout height is added to the block +height queried from the latest consensus state corresponding to the counterparty channel. Relative timeout timestamp +is added to the greater value of the local clock time and the block timestamp queried from the latest consensus state +corresponding to the counterparty channel. Any timeout set to 0 is disabled. + +``` +zetacored tx ibc-transfer transfer [src-port] [src-channel] [receiver] [amount] [flags] +``` + +### Examples + +``` +zetacored tx ibc-transfer transfer [src-port] [src-channel] [receiver] [amount] +``` + +### Options + +``` + --absolute-timeouts Timeout flags are used as absolute timeouts. + -a, --account-number uint The account number of the signing account (offline mode only) + --aux Generate aux signer data instead of sending a tx + -b, --broadcast-mode string Transaction broadcasting mode (sync|async) + --chain-id string The network chain ID + --dry-run ignore the --gas flag and perform a simulation of a transaction, but don't broadcast it (when enabled, the local Keybase is not accessible) + --fee-granter string Fee granter grants fees for the transaction + --fee-payer string Fee payer pays fees for the transaction instead of deducting from the signer + --fees string Fees to pay along with transaction; eg: 10uatom + --from string Name or address of private key with which to sign + --gas string gas limit to set per-transaction; set to "auto" to calculate sufficient gas automatically. Note: "auto" option doesn't always report accurate results. Set a valid coin value to adjust the result. Can be used instead of "fees". (default 200000) + --gas-adjustment float adjustment factor to be multiplied against the estimate returned by the tx simulation; if the gas limit is set manually this flag is ignored (default 1) + --gas-prices string Gas prices in decimal format to determine the transaction fee (e.g. 0.1uatom) + --generate-only Build an unsigned transaction and write it to STDOUT (when enabled, the local Keybase only accessed when providing a key name) + -h, --help help for transfer + --keyring-backend string Select keyring's backend (os|file|kwallet|pass|test|memory) + --keyring-dir string The client Keyring directory; if omitted, the default 'home' directory will be used + --ledger Use a connected Ledger device + --memo string Memo to be sent along with the packet. + --node string [host]:[port] to tendermint rpc interface for this chain + --note string Note to add a description to the transaction (previously --memo) + --offline Offline mode (does not allow any online functionality) + -o, --output string Output format (text|json) + --packet-timeout-height string Packet timeout block height. The timeout is disabled when set to 0-0. + --packet-timeout-timestamp uint Packet timeout timestamp in nanoseconds from now. Default is 10 minutes. The timeout is disabled when set to 0. (default 600000000000) + -s, --sequence uint The sequence number of the signing account (offline mode only) + --sign-mode string Choose sign mode (direct|amino-json|direct-aux), this is an advanced feature + --timeout-height uint Set a block timeout height to prevent the tx from being committed past a certain height + --tip string Tip is the amount that is going to be transferred to the fee payer on the target chain. This flag is only valid when used with --aux, and is ignored if the target chain didn't enable the TipDecorator + -y, --yes Skip tx broadcasting prompt confirmation +``` + +### Options inherited from parent commands + +``` + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored tx ibc-transfer](zetacored_tx_ibc-transfer.md) - IBC fungible token transfer transaction subcommands + diff --git a/docs/cli/zetacored/zetacored_tx_ibc.md b/docs/cli/zetacored/zetacored_tx_ibc.md new file mode 100644 index 0000000000..b9f3e3febc --- /dev/null +++ b/docs/cli/zetacored/zetacored_tx_ibc.md @@ -0,0 +1,31 @@ +# tx ibc + +IBC transaction subcommands + +``` +zetacored tx ibc [flags] +``` + +### Options + +``` + -h, --help help for ibc +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored tx](zetacored_tx.md) - Transactions subcommands +* [zetacored tx ibc channel](zetacored_tx_ibc_channel.md) - IBC channel transaction subcommands +* [zetacored tx ibc client](zetacored_tx_ibc_client.md) - IBC client transaction subcommands + diff --git a/docs/cli/zetacored/zetacored_tx_ibc_channel.md b/docs/cli/zetacored/zetacored_tx_ibc_channel.md new file mode 100644 index 0000000000..a109cb6387 --- /dev/null +++ b/docs/cli/zetacored/zetacored_tx_ibc_channel.md @@ -0,0 +1,29 @@ +# tx ibc channel + +IBC channel transaction subcommands + +``` +zetacored tx ibc channel [flags] +``` + +### Options + +``` + -h, --help help for channel +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored tx ibc](zetacored_tx_ibc.md) - IBC transaction subcommands + diff --git a/docs/cli/zetacored/zetacored_tx_ibc_client.md b/docs/cli/zetacored/zetacored_tx_ibc_client.md new file mode 100644 index 0000000000..d7953a1ac0 --- /dev/null +++ b/docs/cli/zetacored/zetacored_tx_ibc_client.md @@ -0,0 +1,33 @@ +# tx ibc client + +IBC client transaction subcommands + +``` +zetacored tx ibc client [flags] +``` + +### Options + +``` + -h, --help help for client +``` + +### Options inherited from parent commands + +``` + --chain-id string The network chain ID + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored tx ibc](zetacored_tx_ibc.md) - IBC transaction subcommands +* [zetacored tx ibc client create](zetacored_tx_ibc_client_create.md) - create new IBC client +* [zetacored tx ibc client misbehaviour](zetacored_tx_ibc_client_misbehaviour.md) - submit a client misbehaviour +* [zetacored tx ibc client update](zetacored_tx_ibc_client_update.md) - update existing client with a client message +* [zetacored tx ibc client upgrade](zetacored_tx_ibc_client_upgrade.md) - upgrade an IBC client + diff --git a/docs/cli/zetacored/zetacored_tx_ibc_client_create.md b/docs/cli/zetacored/zetacored_tx_ibc_client_create.md new file mode 100644 index 0000000000..b1a9f4f96a --- /dev/null +++ b/docs/cli/zetacored/zetacored_tx_ibc_client_create.md @@ -0,0 +1,65 @@ +# tx ibc client create + +create new IBC client + +### Synopsis + +create a new IBC client with the specified client state and consensus state + - ClientState JSON example: {"@type":"/ibc.lightclients.solomachine.v1.ClientState","sequence":"1","frozen_sequence":"0","consensus_state":{"public_key":{"@type":"/cosmos.crypto.secp256k1.PubKey","key":"AtK50+5pJOoaa04qqAqrnyAqsYrwrR/INnA6UPIaYZlp"},"diversifier":"testing","timestamp":"10"},"allow_update_after_proposal":false} + - ConsensusState JSON example: {"@type":"/ibc.lightclients.solomachine.v1.ConsensusState","public_key":{"@type":"/cosmos.crypto.secp256k1.PubKey","key":"AtK50+5pJOoaa04qqAqrnyAqsYrwrR/INnA6UPIaYZlp"},"diversifier":"testing","timestamp":"10"} + +``` +zetacored tx ibc client create [path/to/client_state.json] [path/to/consensus_state.json] [flags] +``` + +### Examples + +``` +zetacored tx ibc client create [path/to/client_state.json] [path/to/consensus_state.json] --from node0 --home ../node0/[app]cli --chain-id $CID +``` + +### Options + +``` + -a, --account-number uint The account number of the signing account (offline mode only) + --aux Generate aux signer data instead of sending a tx + -b, --broadcast-mode string Transaction broadcasting mode (sync|async) + --chain-id string The network chain ID + --dry-run ignore the --gas flag and perform a simulation of a transaction, but don't broadcast it (when enabled, the local Keybase is not accessible) + --fee-granter string Fee granter grants fees for the transaction + --fee-payer string Fee payer pays fees for the transaction instead of deducting from the signer + --fees string Fees to pay along with transaction; eg: 10uatom + --from string Name or address of private key with which to sign + --gas string gas limit to set per-transaction; set to "auto" to calculate sufficient gas automatically. Note: "auto" option doesn't always report accurate results. Set a valid coin value to adjust the result. Can be used instead of "fees". (default 200000) + --gas-adjustment float adjustment factor to be multiplied against the estimate returned by the tx simulation; if the gas limit is set manually this flag is ignored (default 1) + --gas-prices string Gas prices in decimal format to determine the transaction fee (e.g. 0.1uatom) + --generate-only Build an unsigned transaction and write it to STDOUT (when enabled, the local Keybase only accessed when providing a key name) + -h, --help help for create + --keyring-backend string Select keyring's backend (os|file|kwallet|pass|test|memory) + --keyring-dir string The client Keyring directory; if omitted, the default 'home' directory will be used + --ledger Use a connected Ledger device + --node string [host]:[port] to tendermint rpc interface for this chain + --note string Note to add a description to the transaction (previously --memo) + --offline Offline mode (does not allow any online functionality) + -o, --output string Output format (text|json) + -s, --sequence uint The sequence number of the signing account (offline mode only) + --sign-mode string Choose sign mode (direct|amino-json|direct-aux), this is an advanced feature + --timeout-height uint Set a block timeout height to prevent the tx from being committed past a certain height + --tip string Tip is the amount that is going to be transferred to the fee payer on the target chain. This flag is only valid when used with --aux, and is ignored if the target chain didn't enable the TipDecorator + -y, --yes Skip tx broadcasting prompt confirmation +``` + +### Options inherited from parent commands + +``` + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored tx ibc client](zetacored_tx_ibc_client.md) - IBC client transaction subcommands + diff --git a/docs/cli/zetacored/zetacored_tx_ibc_client_misbehaviour.md b/docs/cli/zetacored/zetacored_tx_ibc_client_misbehaviour.md new file mode 100644 index 0000000000..f0f69a7ca2 --- /dev/null +++ b/docs/cli/zetacored/zetacored_tx_ibc_client_misbehaviour.md @@ -0,0 +1,63 @@ +# tx ibc client misbehaviour + +submit a client misbehaviour + +### Synopsis + +submit a client misbehaviour to prevent future updates + +``` +zetacored tx ibc client misbehaviour [clientID] [path/to/misbehaviour.json] [flags] +``` + +### Examples + +``` +zetacored tx ibc client misbehaviour [clientID] [path/to/misbehaviour.json] --from node0 --home ../node0/[app]cli --chain-id $CID +``` + +### Options + +``` + -a, --account-number uint The account number of the signing account (offline mode only) + --aux Generate aux signer data instead of sending a tx + -b, --broadcast-mode string Transaction broadcasting mode (sync|async) + --chain-id string The network chain ID + --dry-run ignore the --gas flag and perform a simulation of a transaction, but don't broadcast it (when enabled, the local Keybase is not accessible) + --fee-granter string Fee granter grants fees for the transaction + --fee-payer string Fee payer pays fees for the transaction instead of deducting from the signer + --fees string Fees to pay along with transaction; eg: 10uatom + --from string Name or address of private key with which to sign + --gas string gas limit to set per-transaction; set to "auto" to calculate sufficient gas automatically. Note: "auto" option doesn't always report accurate results. Set a valid coin value to adjust the result. Can be used instead of "fees". (default 200000) + --gas-adjustment float adjustment factor to be multiplied against the estimate returned by the tx simulation; if the gas limit is set manually this flag is ignored (default 1) + --gas-prices string Gas prices in decimal format to determine the transaction fee (e.g. 0.1uatom) + --generate-only Build an unsigned transaction and write it to STDOUT (when enabled, the local Keybase only accessed when providing a key name) + -h, --help help for misbehaviour + --keyring-backend string Select keyring's backend (os|file|kwallet|pass|test|memory) + --keyring-dir string The client Keyring directory; if omitted, the default 'home' directory will be used + --ledger Use a connected Ledger device + --node string [host]:[port] to tendermint rpc interface for this chain + --note string Note to add a description to the transaction (previously --memo) + --offline Offline mode (does not allow any online functionality) + -o, --output string Output format (text|json) + -s, --sequence uint The sequence number of the signing account (offline mode only) + --sign-mode string Choose sign mode (direct|amino-json|direct-aux), this is an advanced feature + --timeout-height uint Set a block timeout height to prevent the tx from being committed past a certain height + --tip string Tip is the amount that is going to be transferred to the fee payer on the target chain. This flag is only valid when used with --aux, and is ignored if the target chain didn't enable the TipDecorator + -y, --yes Skip tx broadcasting prompt confirmation +``` + +### Options inherited from parent commands + +``` + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored tx ibc client](zetacored_tx_ibc_client.md) - IBC client transaction subcommands + diff --git a/docs/cli/zetacored/zetacored_tx_ibc_client_update.md b/docs/cli/zetacored/zetacored_tx_ibc_client_update.md new file mode 100644 index 0000000000..b9db70cc7f --- /dev/null +++ b/docs/cli/zetacored/zetacored_tx_ibc_client_update.md @@ -0,0 +1,63 @@ +# tx ibc client update + +update existing client with a client message + +### Synopsis + +update existing client with a client message, for example a header, misbehaviour or batch update + +``` +zetacored tx ibc client update [client-id] [path/to/client_msg.json] [flags] +``` + +### Examples + +``` +zetacored tx ibc client update [client-id] [path/to/client_msg.json] --from node0 --home ../node0/[app]cli --chain-id $CID +``` + +### Options + +``` + -a, --account-number uint The account number of the signing account (offline mode only) + --aux Generate aux signer data instead of sending a tx + -b, --broadcast-mode string Transaction broadcasting mode (sync|async) + --chain-id string The network chain ID + --dry-run ignore the --gas flag and perform a simulation of a transaction, but don't broadcast it (when enabled, the local Keybase is not accessible) + --fee-granter string Fee granter grants fees for the transaction + --fee-payer string Fee payer pays fees for the transaction instead of deducting from the signer + --fees string Fees to pay along with transaction; eg: 10uatom + --from string Name or address of private key with which to sign + --gas string gas limit to set per-transaction; set to "auto" to calculate sufficient gas automatically. Note: "auto" option doesn't always report accurate results. Set a valid coin value to adjust the result. Can be used instead of "fees". (default 200000) + --gas-adjustment float adjustment factor to be multiplied against the estimate returned by the tx simulation; if the gas limit is set manually this flag is ignored (default 1) + --gas-prices string Gas prices in decimal format to determine the transaction fee (e.g. 0.1uatom) + --generate-only Build an unsigned transaction and write it to STDOUT (when enabled, the local Keybase only accessed when providing a key name) + -h, --help help for update + --keyring-backend string Select keyring's backend (os|file|kwallet|pass|test|memory) + --keyring-dir string The client Keyring directory; if omitted, the default 'home' directory will be used + --ledger Use a connected Ledger device + --node string [host]:[port] to tendermint rpc interface for this chain + --note string Note to add a description to the transaction (previously --memo) + --offline Offline mode (does not allow any online functionality) + -o, --output string Output format (text|json) + -s, --sequence uint The sequence number of the signing account (offline mode only) + --sign-mode string Choose sign mode (direct|amino-json|direct-aux), this is an advanced feature + --timeout-height uint Set a block timeout height to prevent the tx from being committed past a certain height + --tip string Tip is the amount that is going to be transferred to the fee payer on the target chain. This flag is only valid when used with --aux, and is ignored if the target chain didn't enable the TipDecorator + -y, --yes Skip tx broadcasting prompt confirmation +``` + +### Options inherited from parent commands + +``` + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored tx ibc client](zetacored_tx_ibc_client.md) - IBC client transaction subcommands + diff --git a/docs/cli/zetacored/zetacored_tx_ibc_client_upgrade.md b/docs/cli/zetacored/zetacored_tx_ibc_client_upgrade.md new file mode 100644 index 0000000000..327df80552 --- /dev/null +++ b/docs/cli/zetacored/zetacored_tx_ibc_client_upgrade.md @@ -0,0 +1,65 @@ +# tx ibc client upgrade + +upgrade an IBC client + +### Synopsis + +upgrade the IBC client associated with the provided client identifier while providing proof committed by the counterparty chain to the new client and consensus states + - ClientState JSON example: {"@type":"/ibc.lightclients.solomachine.v1.ClientState","sequence":"1","frozen_sequence":"0","consensus_state":{"public_key":{"@type":"/cosmos.crypto.secp256k1.PubKey","key":"AtK50+5pJOoaa04qqAqrnyAqsYrwrR/INnA6UPIaYZlp"},"diversifier":"testing","timestamp":"10"},"allow_update_after_proposal":false} + - ConsensusState JSON example: {"@type":"/ibc.lightclients.solomachine.v1.ConsensusState","public_key":{"@type":"/cosmos.crypto.secp256k1.PubKey","key":"AtK50+5pJOoaa04qqAqrnyAqsYrwrR/INnA6UPIaYZlp"},"diversifier":"testing","timestamp":"10"} + +``` +zetacored tx ibc client upgrade [client-identifier] [path/to/client_state.json] [path/to/consensus_state.json] [upgrade-client-proof] [upgrade-consensus-state-proof] [flags] +``` + +### Examples + +``` +zetacored tx ibc client upgrade [client-identifier] [path/to/client_state.json] [path/to/consensus_state.json] [client-state-proof] [consensus-state-proof] --from node0 --home ../node0/[app]cli --chain-id $CID +``` + +### Options + +``` + -a, --account-number uint The account number of the signing account (offline mode only) + --aux Generate aux signer data instead of sending a tx + -b, --broadcast-mode string Transaction broadcasting mode (sync|async) + --chain-id string The network chain ID + --dry-run ignore the --gas flag and perform a simulation of a transaction, but don't broadcast it (when enabled, the local Keybase is not accessible) + --fee-granter string Fee granter grants fees for the transaction + --fee-payer string Fee payer pays fees for the transaction instead of deducting from the signer + --fees string Fees to pay along with transaction; eg: 10uatom + --from string Name or address of private key with which to sign + --gas string gas limit to set per-transaction; set to "auto" to calculate sufficient gas automatically. Note: "auto" option doesn't always report accurate results. Set a valid coin value to adjust the result. Can be used instead of "fees". (default 200000) + --gas-adjustment float adjustment factor to be multiplied against the estimate returned by the tx simulation; if the gas limit is set manually this flag is ignored (default 1) + --gas-prices string Gas prices in decimal format to determine the transaction fee (e.g. 0.1uatom) + --generate-only Build an unsigned transaction and write it to STDOUT (when enabled, the local Keybase only accessed when providing a key name) + -h, --help help for upgrade + --keyring-backend string Select keyring's backend (os|file|kwallet|pass|test|memory) + --keyring-dir string The client Keyring directory; if omitted, the default 'home' directory will be used + --ledger Use a connected Ledger device + --node string [host]:[port] to tendermint rpc interface for this chain + --note string Note to add a description to the transaction (previously --memo) + --offline Offline mode (does not allow any online functionality) + -o, --output string Output format (text|json) + -s, --sequence uint The sequence number of the signing account (offline mode only) + --sign-mode string Choose sign mode (direct|amino-json|direct-aux), this is an advanced feature + --timeout-height uint Set a block timeout height to prevent the tx from being committed past a certain height + --tip string Tip is the amount that is going to be transferred to the fee payer on the target chain. This flag is only valid when used with --aux, and is ignored if the target chain didn't enable the TipDecorator + -y, --yes Skip tx broadcasting prompt confirmation +``` + +### Options inherited from parent commands + +``` + --home string directory for config and data + --log_format string The logging format (json|plain) + --log_level string The logging level (trace|debug|info|warn|error|fatal|panic) + --log_no_color Disable colored logs + --trace print out full stack trace on errors +``` + +### SEE ALSO + +* [zetacored tx ibc client](zetacored_tx_ibc_client.md) - IBC client transaction subcommands +