Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
30 commits
Select commit Hold shift + click to select a range
7c53582
docs: The Gov precompile adds three new functions—grantVoteAuthorizat…
seidroid[bot] Nov 13, 2026
72c0b0a
docs: Adds a new standalone CLI tool `evmonly-loadtest` for feeding s…
seidroid[bot] Nov 13, 2026
04c5f8c
docs: Pagination limits/offsets for node-local LCD/gRPC queries are n…
seidroid[bot] Nov 13, 2026
62898fb
docs: The Interchain Accounts (ICA) proto definitions and REST/gRPC q…
seidroid[bot] Nov 13, 2026
2a38816
docs: The storage garbage collector gains a new LookbackWindow config…
seidroid[bot] Nov 13, 2026
8ce9b5a
docs: EVM RPC block endpoints (getBlockByHash, getBlockByNumber, GetB…
seidroid[bot] Nov 13, 2026
e31f767
docs: The entire sei2_* JSON-RPC namespace (seven block methods that …
seidroid[bot] Nov 13, 2026
8a48019
docs: Adds authorization (authz) grant/execute/revoke methods to the …
seidroid[bot] Nov 13, 2026
e4bf939
docs: The unsafe consensus timeout override config fields (unsafe-pro…
seidroid[bot] Nov 13, 2026
4ac33e6
docs: EVM trace RPC methods (debug_traceTransaction, debug_traceBlock…
seidroid[bot] Nov 13, 2026
89d7726
docs: A new v6.7 upgrade version adds several new EVM precompiles (au…
seidroid[bot] Nov 13, 2026
4548320
docs: Bank, gov, and staking modules now enforce recipient deliverabi…
seidroid[bot] Nov 13, 2026
23ad5f6
docs: The oracle module is now deprecated (all its messages and queri…
seidroid[bot] Nov 13, 2026
21c6f22
docs: The feegrant module is removed from Sei: feegrant execution, mo…
seidroid[bot] Nov 13, 2026
d918d18
docs: The state store (SS) can now roll back to a target version alon…
seidroid[bot] Nov 13, 2026
8556c03
docs: IBC transfer (ICS-20) support is removed in v6.7, including CLI…
seidroid[bot] Nov 13, 2026
51e026d
docs: Sei v6.7 removes all IBC query APIs (gRPC, REST, Protobuf, raw …
seidroid[bot] Nov 13, 2026
0027fb1
docs: IBC messages are now deprecated/retired on Sei — any transactio…
seidroid[bot] Nov 13, 2026
a3b3ec6
docs: A new internal config registry feature adds mode-aware resoluti…
seidroid[bot] Nov 13, 2026
160271b
docs: The IBC module has been fully retired/deprecated: IBC wiring, k…
seidroid[bot] Nov 13, 2026
ac8527d
docs: Adds a new frozen-rpc-router binary/command that routes EVM JSO…
seidroid[bot] Nov 13, 2026
0c67cad
docs: The release build now produces statically-linked seid binaries …
seidroid[bot] Nov 13, 2026
6ecc46f
docs: The wasmd precompile's execute_batch method has been disabled a…
seidroid[bot] Nov 13, 2026
9edb349
docs: The v6.7 changelog introduces numerous developer-facing changes…
seidroid[bot] Nov 13, 2026
f7aa8b1
docs: The seidb evm-logical-digest tool adds a --json flag for machin…
seidroid[bot] Nov 13, 2026
fd9138d
docs: A seidb CLI command gained JSON output support and new inspecti…
seidroid[bot] Nov 13, 2026
a7e5ff6
docs: Dynamic-gas precompiles now convert an executor's out-of-gas (g…
seidroid[bot] Nov 13, 2026
655182f
docs: Adds a 'pause-state-migration' hard fork handler that sets the …
seidroid[bot] Nov 13, 2026
b25f110
docs: Adds a new `seidb kvrepair-export` CLI command for generating K…
seidroid[bot] Nov 13, 2026
31c2515
docs: The seidb evm-logical-digest command gains a new `changelog` me…
seidroid[bot] Nov 14, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions cosmos-sdk/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,8 @@ In addition, [Proposal 115](https://seistream.app/proposals/115) disables CosmWa

**IBC is now disabled in both directions.** [Proposal 116](https://seistream.app/proposals/116) and [Proposal 120](https://seistream.app/proposals/120) set the `ibc` module's `InboundEnabled` parameter to `false`, and [Proposal 121](https://seistream.app/proposals/121) set `OutboundEnabled` to `false` on July 31, 2026. No asset can be bridged into or out of Sei over IBC. IBC assets already on Sei can no longer be redeemed on their origin chain. See the [SIP-03 Migration Guide](/learn/sip-03-migration) for the full explanation and the list of affected assets.

IBC messaging is now retired at the protocol level: the IBC module is no longer wired into the application at all, so IBC message types (those whose type URL begins with `/ibc.`) are no longer registered. Such messages can no longer be routed or executed, and queries against the retired IBC stores return an `ibc module is deprecated` error.

</Danger>

## Tokenfactory is not supported
Expand Down
3 changes: 2 additions & 1 deletion docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -204,7 +204,8 @@
"evm/precompiles/mint",
"evm/precompiles/params",
"evm/precompiles/slashing",
"evm/precompiles/upgrade"
"evm/precompiles/upgrade",
"evm/precompiles/feegrant"
]
}
]
Expand Down
4 changes: 3 additions & 1 deletion evm/evm-parity/gas-and-fees.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@
In practice, when your priority tip plus the base fee stays below `maxFeePerGas`, the receipt reports `baseFee + maxPriorityFeePerGas`, not `maxFeePerGas`. To compute what a transaction paid, use the receipt's `effectiveGasPrice`, not `maxFeePerGas`.


## SSTORE cost

Check warning on line 64 in evm/evm-parity/gas-and-fees.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/evm-parity/gas-and-fees.mdx#L64

Use sentence case for headings: 'SSTORE cost'.

On Sei, governance can adjust the gas cost of `SSTORE` (a write to contract storage). The current cost is **72,000 gas** on both Sei Mainnet and Sei Testnet. For details, see [Differences with Ethereum](/evm/differences-with-ethereum#sstore-gas-cost). Treat this number as the current value, not a constant. Do not hard-code storage write estimates in your application.

Expand Down Expand Up @@ -99,7 +99,9 @@
- Before a precompile decodes its arguments, it charges gas for the calldata. The charge grows with the calldata length and with the size of any `string` arguments. A call that cannot pay this charge reverts before the precompile runs.
- The JSON precompile also charges 100 gas per byte of JSON input.
- The pointer view precompile also charges for the state that each lookup reads.
- The P256 precompile also charges a fixed 3,450 gas per verification, the same as RIP-7212 `P256VERIFY`. If the call cannot pay it, the call fails with an out-of-gas error.
- The P256 precompile also charges a fixed 3,450 gas per verification, the same as RIP-7212 `P256VERIFY`. If the call cannot pay it, the call fails as out-of-gas.

When a dynamic-gas precompile runs out of gas mid-execution, the out-of-gas condition fails only that call frame with `vm.ErrOutOfGas` and zero remaining gas, just like an ordinary EVM out-of-gas. The surrounding transaction completes as a normal failed EVM execution: it produces a failed receipt that charges exactly the gas used at the effective gas price, and an enclosing call frame can continue afterward. The out-of-gas no longer escapes the EVM to fail the whole transaction at the Cosmos layer with a zero-gas receipt.

Because the cost depends on your calldata, do not hard-code gas limits for precompile calls. Use `eth_estimateGas`, as shown in the example above.

Expand Down
17 changes: 11 additions & 6 deletions evm/installing-seid-cli.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,12 +22,15 @@ To install `seid`, find the version that you want on the [sei-chain releases pag

<Tabs>
<Tab title="Prebuilt binary (recommended)">
Each release attaches a statically linked `seid` build for `linux/amd64` with no
runtime dependencies:
Each release attaches a statically linked `seid` build with no runtime
dependencies for both `linux/amd64` and `linux/arm64`:

```bash
VERSION=<version-tag> # e.g. v6.6.1 — see the version table above
FILE=sei-chain_${VERSION#v}_linux_x86_64.tar.gz # asset filenames omit the leading v

# Pick the asset matching your architecture (asset filenames omit the leading v):
FILE=sei-chain_${VERSION#v}_linux_x86_64.tar.gz # linux/amd64
# FILE=sei-chain_${VERSION#v}_linux_aarch64.tar.gz # linux/arm64

curl -fLO https://github.com/sei-protocol/sei-chain/releases/download/${VERSION}/${FILE}
curl -fLO https://github.com/sei-protocol/sei-chain/releases/download/${VERSION}/checksums.txt
Expand All @@ -39,9 +42,11 @@ To install `seid`, find the version that you want on the [sei-chain releases pag
```

<Info>
Prebuilt binaries are attached from `v6.6.1` onward. For earlier versions, build
from source. The binaries are `linux/amd64` only and omit hardware Ledger support.
On other architectures, or if you sign with a Ledger device, build from source.
Prebuilt binaries are attached from `v6.6.1` onward, and a statically-linked
`linux/arm64` (aarch64) binary is attached alongside the `linux/amd64` one. For
earlier versions, build from source. The binaries omit hardware Ledger support,
so if you sign with a Ledger device, build from source. On architectures other
than `linux/amd64` or `linux/arm64`, build from source.
</Info>

<Note>
Expand Down
6 changes: 5 additions & 1 deletion evm/precompiles/authz.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,11 @@ keywords: ['authz precompile', 'authorization grants', 'granter', 'grantee', 'se
---
**Address:** `0x000000000000000000000000000000000000100E`

The Authz precompile reads grants from the Cosmos `authz` module. A grant lets a grantee account send specific messages for a granter account. All methods are `view` functions. The precompile is available since v6.7.0.
The Authz precompile reads grants from the Cosmos `authz` module. A grant lets a grantee account send specific messages for a granter account. All methods on this precompile are `view` functions. The precompile is available since v6.7.0.

<Note>
While this precompile is read-only, `authz` grants can also be created and exercised from the EVM for delegated governance voting. The [Governance precompile](/evm/precompiles/gov) exposes `grantVoteAuthorization`, `voteWithAuthorization`, and `revokeVoteAuthorization`, which write a `MsgVote` grant, cast a vote on a granter's behalf, and revoke the grant respectively. These grants are limited to simple `MsgVote` and do not cover weighted votes; they appear here through the `grants` queries like any other `authz` grant.
</Note>

## Interface

Expand Down
4 changes: 3 additions & 1 deletion evm/precompiles/cosmwasm-precompiles/cosmwasm.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,10 +9,12 @@
<Danger>
**Deprecation notice (Prop 115)**

Under [governance Proposal 115](https://seistream.app/proposals/115), CosmWasm code uploads (`MsgStoreCode`) and contract instantiations (`MsgInstantiateContract`) are disabled chain-wide. The `instantiate()` function on this precompile **reverts** for all callers. Only calls to `execute()`, `execute_batch()`, and `query()` against pre-existing CosmWasm contracts still work. All CosmWasm functionality is deprecated in favor of EVM-only under [SIP-3](https://github.com/sei-protocol/sips/blob/main/sips/sip-3.md).
Under [governance Proposal 115](https://seistream.app/proposals/115), CosmWasm code uploads (`MsgStoreCode`) and contract instantiations (`MsgInstantiateContract`) are disabled chain-wide. The `instantiate()` function on this precompile **reverts** for all callers. Only calls to `execute()` and `query()` against pre-existing CosmWasm contracts still work. The `execute_batch()` function is **disabled** and reverts with `wasmd execute_batch is disabled` for all callers — batch execution of multiple CosmWasm contract calls through this precompile is no longer supported. Use a separate `execute()` call per message instead. The batch-related code and examples on this page are retained for reference only; `execute_batch()` calls fail on-chain. All CosmWasm functionality is deprecated in favor of EVM-only under [SIP-3](https://github.com/sei-protocol/sips/blob/main/sips/sip-3.md).

The examples on this page attach only native SEI. Do not use the `coins` field to build IBC or tokenfactory integrations. IBC is disabled in both directions. Tokenfactory is not a supported development path.

CosmWasm IBC support has been removed. Contracts can no longer open, connect, or close IBC channels or send, receive, acknowledge, or time out IBC packets. An IBC `SendPacket` message from a contract is rejected as unsupported, and the IBC channel and list-channels queries return `unsupported request: IBC` — only the contract's own `PortID` query remains.

For new smart contract development, use the EVM directly. See [Deploy a Smart Contract](/evm/evm-general).
</Danger>

Expand Down Expand Up @@ -442,7 +444,7 @@

## Advanced usage examples

### Cross-runtime DeFi integration

Check warning on line 447 in evm/precompiles/cosmwasm-precompiles/cosmwasm.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/precompiles/cosmwasm-precompiles/cosmwasm.mdx#L447

Use sentence case for headings: 'Cross-runtime DeFi integration'.

```typescript
async function crossRuntimeDeFiOperation(cosmwasmDexContract: string, evmTokenContract: string, amount: string) {
Expand Down
206 changes: 206 additions & 0 deletions evm/precompiles/distribution.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,80 @@
}
```


## Authorization (authz) methods

The distribution precompile supports Cosmos authz grants, so a granter can authorize another account (the grantee) to withdraw its delegation rewards and validator commission on its behalf. `grantWithdrawAuthorization` creates native generic grants for both `MsgWithdrawDelegatorReward` and `MsgWithdrawValidatorCommission`, and `revokeWithdrawAuthorization` removes them as a group.

```solidity
interface IDistr {
// Authorization methods
function grantWithdrawAuthorization(address grantee, int64 expiration) external returns (bool success);
function withdrawDelegationRewardsWithAuthorization(address delegator, string memory validator) external returns (bool success);
function withdrawValidatorCommissionWithAuthorization(address validatorOperator) external returns (bool success);
function revokeWithdrawAuthorization(address grantee) external returns (bool success);
}
```

### grantWithdrawAuthorization

Check warning on line 55 in evm/precompiles/distribution.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/precompiles/distribution.mdx#L55

Use sentence case for headings: 'grantWithdrawAuthorization'.

Check warning on line 55 in evm/precompiles/distribution.mdx

View workflow job for this annotation

GitHub Actions / vale

[vale] evm/precompiles/distribution.mdx#L55

[Sei.Headings] Use sentence case for headings: 'grantWithdrawAuthorization'.
Raw output
{"message": "[Sei.Headings] Use sentence case for headings: 'grantWithdrawAuthorization'.", "location": {"path": "evm/precompiles/distribution.mdx", "range": {"start": {"line": 55, "column": 5}}}, "severity": "WARNING"}

Authorizes `grantee` to withdraw the caller's delegation rewards and validator commission until `expiration`.

```solidity
function grantWithdrawAuthorization(address grantee, int64 expiration) external returns (bool success);
```

**Parameters:**

- `grantee`: The account receiving the withdrawal authorization
- `expiration`: Unix timestamp (seconds) after which the authorization is invalid

<Warning>The `expiration` must be after the current block time, otherwise the call reverts. The grant covers only `MsgWithdrawDelegatorReward` and `MsgWithdrawValidatorCommission`; it does not cover `setWithdrawAddress`.</Warning>

### withdrawDelegationRewardsWithAuthorization

Check warning on line 70 in evm/precompiles/distribution.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/precompiles/distribution.mdx#L70

Use sentence case for headings: 'withdrawDelegationRewardsWithAuthorization'.

Check warning on line 70 in evm/precompiles/distribution.mdx

View workflow job for this annotation

GitHub Actions / vale

[vale] evm/precompiles/distribution.mdx#L70

[Sei.Headings] Use sentence case for headings: 'withdrawDelegationRewardsWithAuthorization'.
Raw output
{"message": "[Sei.Headings] Use sentence case for headings: 'withdrawDelegationRewardsWithAuthorization'.", "location": {"path": "evm/precompiles/distribution.mdx", "range": {"start": {"line": 70, "column": 5}}}, "severity": "WARNING"}

Withdraws `delegator`'s delegation rewards from a validator using an authorization previously granted by `delegator`. The caller must be the grantee.

```solidity
function withdrawDelegationRewardsWithAuthorization(address delegator, string memory validator) external returns (bool success);
```

**Parameters:**

- `delegator`: The account whose delegation rewards are withdrawn
- `validator`: The Sei validator address (for example, "seivaloper1...")

Rewards are sent to the delegator's configured withdrawal address. A `DelegationRewardsWithdrawn` event is emitted with the delegator as the indexed address.

### withdrawValidatorCommissionWithAuthorization

Check warning on line 85 in evm/precompiles/distribution.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/precompiles/distribution.mdx#L85

Use sentence case for headings: 'withdrawValidatorCommissionWithAuthorization'.

Check warning on line 85 in evm/precompiles/distribution.mdx

View workflow job for this annotation

GitHub Actions / vale

[vale] evm/precompiles/distribution.mdx#L85

[Sei.Headings] Use sentence case for headings: 'withdrawValidatorCommissionWithAuthorization'.
Raw output
{"message": "[Sei.Headings] Use sentence case for headings: 'withdrawValidatorCommissionWithAuthorization'.", "location": {"path": "evm/precompiles/distribution.mdx", "range": {"start": {"line": 85, "column": 5}}}, "severity": "WARNING"}

Withdraws a validator's earned commission using an authorization previously granted by the validator operator. The caller must be the grantee.

```solidity
function withdrawValidatorCommissionWithAuthorization(address validatorOperator) external returns (bool success);
```

**Parameters:**

- `validatorOperator`: The validator operator whose commission is withdrawn

Commission is sent to the operator's configured withdrawal address. A `ValidatorCommissionWithdrawn` event is emitted.

### revokeWithdrawAuthorization

Check warning on line 99 in evm/precompiles/distribution.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/precompiles/distribution.mdx#L99

Use sentence case for headings: 'revokeWithdrawAuthorization'.

Check warning on line 99 in evm/precompiles/distribution.mdx

View workflow job for this annotation

GitHub Actions / vale

[vale] evm/precompiles/distribution.mdx#L99

[Sei.Headings] Use sentence case for headings: 'revokeWithdrawAuthorization'.
Raw output
{"message": "[Sei.Headings] Use sentence case for headings: 'revokeWithdrawAuthorization'.", "location": {"path": "evm/precompiles/distribution.mdx", "range": {"start": {"line": 99, "column": 5}}}, "severity": "WARNING"}

Revokes a grantee's reward and commission withdrawal authorization previously granted by the caller.

```solidity
function revokeWithdrawAuthorization(address grantee) external returns (bool success);
```

**Parameters:**

- `grantee`: The account whose withdrawal authorization is revoked

<Info>Both the granter (caller) and the grantee address arguments must be associated Sei addresses. These methods cannot be called from a `staticcall`.</Info>


## Setup

Install ethers and the Sei EVM bindings, which include the precompile address and ABI:
Expand All @@ -55,7 +129,7 @@

The distribution precompile emits events for all state-changing operations. Off-chain services can use these events to track reward distributions and configuration changes.

### WithdrawAddressSet

Check warning on line 132 in evm/precompiles/distribution.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/precompiles/distribution.mdx#L132

Use sentence case for headings: 'WithdrawAddressSet'.

Emitted when a delegator changes their reward withdrawal address.

Expand All @@ -77,7 +151,7 @@
});
```

### DelegationRewardsWithdrawn

Check warning on line 154 in evm/precompiles/distribution.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/precompiles/distribution.mdx#L154

Use sentence case for headings: 'DelegationRewardsWithdrawn'.

Emitted when a delegator withdraws rewards from a single validator.

Expand All @@ -101,7 +175,7 @@
});
```

### MultipleDelegationRewardsWithdrawn

Check warning on line 178 in evm/precompiles/distribution.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/precompiles/distribution.mdx#L178

Use sentence case for headings: 'MultipleDelegationRewardsWithdrawn'.

Emitted when a delegator withdraws rewards from multiple validators in a single transaction.

Expand All @@ -127,7 +201,7 @@
});
```

### ValidatorCommissionWithdrawn

Check warning on line 204 in evm/precompiles/distribution.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/precompiles/distribution.mdx#L204

Use sentence case for headings: 'ValidatorCommissionWithdrawn'.

Emitted when a validator operator withdraws their earned commission.

Expand All @@ -154,7 +228,7 @@

## Transaction methods

### setWithdrawAddress

Check warning on line 231 in evm/precompiles/distribution.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/precompiles/distribution.mdx#L231

Use sentence case for headings: 'setWithdrawAddress'.

Sets the withdrawal address for staking rewards. By default, rewards go to the delegator's address, but you can change it.

Expand Down Expand Up @@ -182,7 +256,7 @@
If a withdrawal address that was set earlier becomes invalid, reward withdrawals automatically fall back to the delegator's own address. An address is invalid when it is blocked or can no longer receive external funds.
</Warning>

### withdrawDelegationRewards

Check warning on line 259 in evm/precompiles/distribution.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/precompiles/distribution.mdx#L259

Use sentence case for headings: 'withdrawDelegationRewards'.

Withdraws accumulated rewards from a specific validator.

Expand All @@ -204,7 +278,7 @@
require(success, "Failed to withdraw rewards");
```

### withdrawMultipleDelegationRewards

Check warning on line 281 in evm/precompiles/distribution.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/precompiles/distribution.mdx#L281

Use sentence case for headings: 'withdrawMultipleDelegationRewards'.

Withdraws rewards from multiple validators in a single transaction.

Expand Down Expand Up @@ -232,7 +306,7 @@

<Info>**Batch efficiency**: One `withdrawMultipleDelegationRewards` call is significantly more gas-efficient than multiple individual calls, especially when you withdraw from 3 or more validators.</Info>

### withdrawValidatorCommission

Check warning on line 309 in evm/precompiles/distribution.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/precompiles/distribution.mdx#L309

Use sentence case for headings: 'withdrawValidatorCommission'.

Lets a validator withdraw its earned commission. Only the validator operator address can call this method.

Expand All @@ -256,7 +330,7 @@

## Query methods

### rewards

Check warning on line 333 in evm/precompiles/distribution.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/precompiles/distribution.mdx#L333

Use sentence case for headings: 'rewards'.

Returns the reward information for a delegator across all validators.

Expand All @@ -264,6 +338,138 @@
function rewards(address delegatorAddress) external view returns (Rewards rewards);
```



<Info>Since v6.7.0 (#new precompile upgrade), the distribution precompile also exposes additional query methods that mirror the Cosmos SDK distribution module queries. All of these are `view` methods and do not change distribution state.</Info>

```solidity
interface IDistr {
// Additional query methods
function params() external view returns (DistributionParams params);
function validatorOutstandingRewards(string memory validatorAddress) external view returns (Coin[] memory rewards);
function validatorCommission(string memory validatorAddress) external view returns (Coin[] memory commission);
function validatorSlashes(string memory validatorAddress, uint64 startingHeight, uint64 endingHeight, bytes memory pageKey) external view returns (Slash[] memory slashes, bytes memory nextKey);
function delegationRewards(address delegatorAddress, string memory validatorAddress) external view returns (Coin[] memory rewards);
function delegatorValidators(address delegatorAddress) external view returns (string[] memory validators);
function delegatorWithdrawAddress(address delegatorAddress) external view returns (string memory withdrawAddress);
function communityPool() external view returns (Coin[] memory pool);
}

struct DistributionParams {
string communityTax;
string baseProposerReward;
string bonusProposerReward;
bool withdrawAddrEnabled;
}

struct Slash {
uint64 validatorPeriod;
string fraction;
}
```

#### params

Check warning on line 371 in evm/precompiles/distribution.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/precompiles/distribution.mdx#L371

Use sentence case for headings: 'params'.

Check warning on line 371 in evm/precompiles/distribution.mdx

View workflow job for this annotation

GitHub Actions / vale

[vale] evm/precompiles/distribution.mdx#L371

[Sei.Headings] Use sentence case for headings: 'params'.
Raw output
{"message": "[Sei.Headings] Use sentence case for headings: 'params'.", "location": {"path": "evm/precompiles/distribution.mdx", "range": {"start": {"line": 371, "column": 6}}}, "severity": "WARNING"}

Returns the distribution module parameters.

```solidity
function params() external view returns (DistributionParams params);
```

The returned `communityTax`, `baseProposerReward`, and `bonusProposerReward` are decimal strings, and `withdrawAddrEnabled` reports whether delegators can set a custom withdrawal address.

#### validatorOutstandingRewards

Check warning on line 381 in evm/precompiles/distribution.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/precompiles/distribution.mdx#L381

Use sentence case for headings: 'validatorOutstandingRewards'.

Check warning on line 381 in evm/precompiles/distribution.mdx

View workflow job for this annotation

GitHub Actions / vale

[vale] evm/precompiles/distribution.mdx#L381

[Sei.Headings] Use sentence case for headings: 'validatorOutstandingRewards'.
Raw output
{"message": "[Sei.Headings] Use sentence case for headings: 'validatorOutstandingRewards'.", "location": {"path": "evm/precompiles/distribution.mdx", "range": {"start": {"line": 381, "column": 6}}}, "severity": "WARNING"}

Returns the outstanding (not-yet-withdrawn) rewards accrued by a validator.

```solidity
function validatorOutstandingRewards(string memory validatorAddress) external view returns (Coin[] memory rewards);
```

**Parameters:**

- `validatorAddress`: The Sei validator address (for example, "seivaloper1...")

Amounts use 18-decimal precision (`DecCoins`), like the `rewards()` query.

#### validatorCommission

Check warning on line 395 in evm/precompiles/distribution.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/precompiles/distribution.mdx#L395

Use sentence case for headings: 'validatorCommission'.

Check warning on line 395 in evm/precompiles/distribution.mdx

View workflow job for this annotation

GitHub Actions / vale

[vale] evm/precompiles/distribution.mdx#L395

[Sei.Headings] Use sentence case for headings: 'validatorCommission'.
Raw output
{"message": "[Sei.Headings] Use sentence case for headings: 'validatorCommission'.", "location": {"path": "evm/precompiles/distribution.mdx", "range": {"start": {"line": 395, "column": 6}}}, "severity": "WARNING"}

Returns the commission currently accrued by a validator.

```solidity
function validatorCommission(string memory validatorAddress) external view returns (Coin[] memory commission);
```

**Parameters:**

- `validatorAddress`: The Sei validator address

#### validatorSlashes

Check warning on line 407 in evm/precompiles/distribution.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/precompiles/distribution.mdx#L407

Use sentence case for headings: 'validatorSlashes'.

Check warning on line 407 in evm/precompiles/distribution.mdx

View workflow job for this annotation

GitHub Actions / vale

[vale] evm/precompiles/distribution.mdx#L407

[Sei.Headings] Use sentence case for headings: 'validatorSlashes'.
Raw output
{"message": "[Sei.Headings] Use sentence case for headings: 'validatorSlashes'.", "location": {"path": "evm/precompiles/distribution.mdx", "range": {"start": {"line": 407, "column": 6}}}, "severity": "WARNING"}

Returns the slashing events for a validator within a height range, with pagination.

```solidity
function validatorSlashes(string memory validatorAddress, uint64 startingHeight, uint64 endingHeight, bytes memory pageKey) external view returns (Slash[] memory slashes, bytes memory nextKey);
```

**Parameters:**

- `validatorAddress`: The Sei validator address
- `startingHeight`: The first block height to include
- `endingHeight`: The last block height to include
- `pageKey`: The pagination key (pass empty bytes for the first page)

Returns the matching `Slash` entries and the `nextKey` to pass in a subsequent call to fetch the next page.

#### delegationRewards

Check warning on line 424 in evm/precompiles/distribution.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/precompiles/distribution.mdx#L424

Use sentence case for headings: 'delegationRewards'.

Check warning on line 424 in evm/precompiles/distribution.mdx

View workflow job for this annotation

GitHub Actions / vale

[vale] evm/precompiles/distribution.mdx#L424

[Sei.Headings] Use sentence case for headings: 'delegationRewards'.
Raw output
{"message": "[Sei.Headings] Use sentence case for headings: 'delegationRewards'.", "location": {"path": "evm/precompiles/distribution.mdx", "range": {"start": {"line": 424, "column": 6}}}, "severity": "WARNING"}

Returns the pending rewards for a specific delegator/validator pair.

```solidity
function delegationRewards(address delegatorAddress, string memory validatorAddress) external view returns (Coin[] memory rewards);
```

**Parameters:**

- `delegatorAddress`: The delegator's EVM address (must be associated)
- `validatorAddress`: The Sei validator address

Amounts use 18-decimal precision (`DecCoins`).

#### delegatorValidators

Check warning on line 439 in evm/precompiles/distribution.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/precompiles/distribution.mdx#L439

Use sentence case for headings: 'delegatorValidators'.

Check warning on line 439 in evm/precompiles/distribution.mdx

View workflow job for this annotation

GitHub Actions / vale

[vale] evm/precompiles/distribution.mdx#L439

[Sei.Headings] Use sentence case for headings: 'delegatorValidators'.
Raw output
{"message": "[Sei.Headings] Use sentence case for headings: 'delegatorValidators'.", "location": {"path": "evm/precompiles/distribution.mdx", "range": {"start": {"line": 439, "column": 6}}}, "severity": "WARNING"}

Returns the list of validator addresses that a delegator currently delegates to.

```solidity
function delegatorValidators(address delegatorAddress) external view returns (string[] memory validators);
```

**Parameters:**

- `delegatorAddress`: The delegator's EVM address (must be associated)

#### delegatorWithdrawAddress

Check warning on line 451 in evm/precompiles/distribution.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/precompiles/distribution.mdx#L451

Use sentence case for headings: 'delegatorWithdrawAddress'.

Check warning on line 451 in evm/precompiles/distribution.mdx

View workflow job for this annotation

GitHub Actions / vale

[vale] evm/precompiles/distribution.mdx#L451

[Sei.Headings] Use sentence case for headings: 'delegatorWithdrawAddress'.
Raw output
{"message": "[Sei.Headings] Use sentence case for headings: 'delegatorWithdrawAddress'.", "location": {"path": "evm/precompiles/distribution.mdx", "range": {"start": {"line": 451, "column": 6}}}, "severity": "WARNING"}

Returns the configured withdrawal address for a delegator, as a Sei address string.

```solidity
function delegatorWithdrawAddress(address delegatorAddress) external view returns (string memory withdrawAddress);
```

**Parameters:**

- `delegatorAddress`: The delegator's EVM address (must be associated)

#### communityPool

Check warning on line 463 in evm/precompiles/distribution.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/precompiles/distribution.mdx#L463

Use sentence case for headings: 'communityPool'.

Check warning on line 463 in evm/precompiles/distribution.mdx

View workflow job for this annotation

GitHub Actions / vale

[vale] evm/precompiles/distribution.mdx#L463

[Sei.Headings] Use sentence case for headings: 'communityPool'.
Raw output
{"message": "[Sei.Headings] Use sentence case for headings: 'communityPool'.", "location": {"path": "evm/precompiles/distribution.mdx", "range": {"start": {"line": 463, "column": 6}}}, "severity": "WARNING"}

Returns the current community pool balance.

```solidity
function communityPool() external view returns (Coin[] memory pool);
```

Amounts use 18-decimal precision (`DecCoins`).

<Info>Since v6.7.0, `rewards()` and the matching gRPC queries (`DelegationRewards` and `DelegationTotalRewards`) do not change distribution state. Repeated calls return the same result. Before v6.7.0, each call incremented the validator period. `debug_trace*` keeps the old behavior when it replays blocks from before v6.7.0.</Info>

**Data structures:**
Expand Down Expand Up @@ -368,7 +574,7 @@

## Practical examples

### DeFi yield aggregator

Check warning on line 577 in evm/precompiles/distribution.mdx

View check run for this annotation

Mintlify / Mintlify Validation (seilabs) - vale-spellcheck

evm/precompiles/distribution.mdx#L577

Use sentence case for headings: 'DeFi yield aggregator'.

```solidity
contract YieldAggregator {
Expand Down
2 changes: 1 addition & 1 deletion evm/precompiles/example-usage.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Sei precompiles are special smart contracts deployed at fixed addresses. They ex
| Precompile | Address | Description |
| --- | --- | --- |
| Bank | `0x0000000000000000000000000000000000001001` | Query the native SEI bank balance |
| CosmWasm | `0x0000000000000000000000000000000000001002` | Query or execute existing CosmWasm contracts. `instantiate()` reverts (Proposal 115). |
| CosmWasm | `0x0000000000000000000000000000000000001002` | Query or execute existing CosmWasm contracts. `instantiate()` reverts (Proposal 115), and `execute_batch()` is disabled and reverts with `wasmd execute_batch is disabled`. |
| JSON | `0x0000000000000000000000000000000000001003` | Parse JSON data within contracts |
| Address | `0x0000000000000000000000000000000000001004` | Convert and associate EVM and Sei addresses |
| Staking | `0x0000000000000000000000000000000000001005` | Delegation and staking operations |
Expand Down
Loading
Loading