Staking

Overview

The Staking precompile provides a Solidity interface to the Cosmos SDK x/staking module. Smart contracts can manage their own delegations and query staking state. createValidator and editValidator must be called directly by the validator operator’s account (an EOA or an EIP-7702 delegated account); calls from a smart contract revert. Precompile Address: 0x0000000000000000000000000000000000000800

Gas Costs

Method Type	Gas Cost
Transactions	`2000 + (30 x bytes of input)`
Queries	`1000 + (3 x bytes of input)`

Transaction Methods

Method	Description
`createValidator`	Create a new validator with description, commission, and self-delegation
`editValidator`	Update validator description and commission
`delegate`	Delegate tokens to a validator
`undelegate`	Undelegate tokens (begins unbonding period)
`redelegate`	Move delegation from one validator to another
`cancelUnbondingDelegation`	Cancel an in-progress unbonding

Query Methods

Method	Description
`delegation`	Get delegation details for a delegator-validator pair
`unbondingDelegation`	Get unbonding delegation details
`validator`	Get validator information
`validators`	List all validators with pagination
`redelegations`	Get redelegation entries

Example

// Pseudocode: import StakingI and Coin from the canonical interface.
StakingI constant staking = StakingI(0x0000000000000000000000000000000000000800);

// Delegate 1000 CTM (1000 * 10^18 ctm) from this contract to a validator
staking.delegate(address(this), "c8valoper1...", 1000 ether);

// Query delegation
(uint256 shares, Coin memory balance) = staking.delegation(msg.sender, "c8valoper1...");

In transaction methods, the delegator address must be the direct caller of the precompile. A contract delegates its own tokens by passing address(this); an EOA calls the precompile directly with its own address. Any other address reverts with msg.sender address ... does not match the requester address .... Queries such as delegation accept any address.

Cosmos module precompiles take amounts in the base denom ctm, the smallest unit of CTM: 1 CTM = 10^18 ctm, the same scale as wei. Do not convert to 6 decimals as on other Cosmos chains; check each precompile’s expected amount format before interacting with it.

For exact signatures, structs, return values, and events, see Precompile ABI Reference.

Learn

Core Concepts

Chain Architecture

Execution and EVM

Interoperability and IBC

Modules & Precompiles

Transaction Lifecycle

Overview

Gas Costs

Transaction Methods

Query Methods

Example

​Overview

​Gas Costs

​Transaction Methods

​Query Methods

​Example

Overview

Gas Costs

Transaction Methods

Query Methods

Example