Skip to main content

/peggy/v1/module_state REST API Endpoint

Retrieves the entire Peggy module's genesis state, including parameters, validator sets, batches, confirmations, token mappings, attestations, and bridge-related metadata.

Updated on
Jun 23, 2025

Parameters

This method does not accept any parameters

Returns

state
object

GenesisState struct containing all persistent data related to the Peggy module

params
object

Configuration parameters that govern the behavior of the Peggy bridge

peggy_id
string

Unique identifier used to prevent replay attacks across Peggy instances

contract_source_hash
string

Hash of the Ethereum smart contract source code for validation purposes

bridge_ethereum_address
string

Ethereum address of the deployed Peggy bridge contract

bridge_chain_id
string

Ethereum chain ID where the bridge contract is deployed

signed_valsets_window
string

Number of blocks within which validators must sign valsets

signed_batches_window
string

Number of blocks within which validators must sign outgoing transaction batches

signed_claims_window
string

Number of blocks within which claims (attestations) must be signed

target_batch_timeout
string

Target timeout (in blocks) for outgoing batches to be submitted on Ethereum

average_block_time
string

Estimated average block time on the Cosmos chain (in milliseconds)

average_ethereum_block_time
string

Estimated average block time on Ethereum (in milliseconds)

slash_fraction_valset
string

Fraction of stake slashed for failing to sign valsets

slash_fraction_batch
string

Fraction of stake slashed for failing to sign outgoing batches

slash_fraction_claim
string

Fraction of stake slashed for failing to attest claims

slash_fraction_conflicting_claim
string

Fraction of stake slashed for submitting conflicting attestations

unbond_slashing_valsets_window
string

Window after unbonding during which missed valset signing can still be slashed

slash_fraction_bad_eth_signature
string

Fraction of stake slashed for submitting an invalid Ethereum signature

cosmos_coin_denom
string

Denomination of the native Cosmos-side token represented on Ethereum

cosmos_coin_erc20_contract
string

Ethereum address of the ERC20 contract representing the native Cosmos token

claim_slashing_enabled
boolean

Indicates whether slashing is enabled for missed or conflicting claims

bridge_contract_start_height
string

Block height when the bridge contract was first deployed on Ethereum

valset_reward
object

Reward paid to validators for relaying valset updates to Ethereum

denom
string

Denomination of the token used for rewards

amount
string

Amount of the reward

admins
array

List of addresses with admin privileges over the Peggy module

segregated_wallet_address
string

Ethereum address designated to receive funds from blacklisted addresses

last_observed_nonce
string

The most recent batch nonce observed and confirmed by the bridge

valsets
array

List of validator sets used to relay messages to Ethereum, each including power and Ethereum addresses

nonce
string

Unique identifier for the validator set

members
array

Members of the validator set

power
string

Voting power of the validator in the set

ethereum_address
string

Ethereum address associated with the validator

height
string

Block height at which this valset was created

reward_amount
string

Optional reward amount given for relaying this valset

reward_token
string

Ethereum address of the token used for valset rewards

valset_confirms
array

List of confirmations from validators for valset messages

nonce
string

Valset nonce being confirmed

orchestrator
string

Cosmos orchestrator address submitting the confirmation

eth_address
string

Ethereum address of the validator submitting the signature

signature
string

Ethereum signature over the valset message

batches
array

List of outgoing token transfer batches pending submission to Ethereum

batch_nonce
string

Unique identifier for the batch

batch_timeout
string

Block height or timestamp after which the batch becomes invalid

transactions
array

Array of token transfer transactions included in the batch

id
string

Unique identifier for the transaction

sender
string

Cosmos address initiating the transfer

dest_address
string

Ethereum address receiving the tokens

erc20_token
object

ERC20 token being transferred

contract
string

Ethereum contract address of the token

amount
string

Amount of tokens to transfer

erc20_fee
object

ERC20 token used as transaction fee

contract
string

Ethereum contract address of the fee token

amount
string

Fee amount paid for processing the transaction

token_contract
string

Ethereum contract address of the primary token for the batch

block
string

Cosmos block height when the batch was created

batch_confirms
array

Validator confirmations for outgoing transaction batches

nonce
string

Batch nonce being confirmed

token_contract
string

ERC20 token contract used in the batch

eth_signer
string

Ethereum address of the validator signing the batch

orchestrator
string

Cosmos orchestrator address submitting the batch confirmation

signature
string

Validator signature over the batch data

valsets
array

List of validator sets used to relay messages to Ethereum, each including power and Ethereum addresses

nonce
string

Unique identifier for the validator set

members
array

Members of the validator set

power
string

Voting power of the validator in the set

ethereum_address
string

Ethereum address associated with the validator

height
string

Block height at which this valset was created

reward_amount
string

Optional reward amount given for relaying this valset

reward_token
string

Ethereum address of the token used for valset rewards

valset_confirms
array

List of confirmations from validators for valset messages

nonce
string

Valset nonce being confirmed

orchestrator
string

Cosmos orchestrator address submitting the confirmation

eth_address
string

Ethereum address of the validator submitting the signature

signature
string

Ethereum signature over the valset message

batches
array

List of outgoing token transfer batches pending submission to Ethereum

batch_nonce
string

Unique identifier for the batch

batch_timeout
string

Block height or timestamp after which the batch becomes invalid

transactions
array

Array of token transfer transactions included in the batch

id
string

Unique identifier for the transaction

sender
string

Cosmos address initiating the transfer

dest_address
string

Ethereum address receiving the tokens

erc20_token
object

ERC20 token being transferred

contract
string

Ethereum contract address of the token

amount
string

Amount of tokens to transfer

erc20_fee
object

ERC20 token used as transaction fee

contract
string

Ethereum contract address of the fee token

amount
string

Fee amount paid for processing the transaction

token_contract
string

Ethereum contract address of the primary token for the batch

block
string

Cosmos block height when the batch was created

batch_confirms
array

Validator confirmations for outgoing transaction batches

nonce
string

Batch nonce being confirmed

token_contract
string

ERC20 token contract used in the batch

eth_signer
string

Ethereum address of the validator signing the batch

orchestrator
string

Cosmos orchestrator address submitting the batch confirmation

signature
string

Validator signature over the batch data

attestations
array

List of claims and voting results on observed events from Ethereum

observed
boolean

Indicates whether the claim has been successfully observed and processed

votes
array

Addresses of validators that voted to observe the event

height
string

Block height when the attestation was created

claim
object

Generic protobuf-encoded claim for the attestation

@type
string

Protobuf type identifier for the claim

event_nonce
string

Event nonce used to order claims correctly

valset_nonce
string

Unique nonce for this validator set

block_height
string

Block height at which this claim was created

members
array

List of validators in the updated validator set

power
string

Voting power of the validator

ethereum_address
string

Ethereum address of the validator

reward_amount
string

Amount of reward given for relaying this claim

reward_token
string

Token address used for the reward

orchestrator
string

Address of the orchestrator who submitted the claim

orchestrator_addresses
array

Mapping between Cosmos validator operator addresses and their associated orchestrator and Ethereum addresses

sender
string

Cosmos validator operator address

orchestrator
string

Cosmos address of the orchestrator process

eth_address
string

Ethereum address of the validator

erc20_to_denoms
array

List of ERC20-to-Cosmos denom mappings for bridged tokens

erc20
string

Ethereum contract address of the ERC20 token

denom
string

Corresponding Cosmos denomination for the token

unbatched_transfers
array

List of token transfers not yet grouped into an outgoing batch

id
string

Unique identifier for the transfer

sender
string

Cosmos address of the sender

dest_address
string

Ethereum address of the recipient

erc20_token
object

Token being transferred

contract
string

Ethereum address of the token contract

amount
string

Amount of tokens to transfer

erc20_fee
object

Fee applied to the transfer

contract
string

Ethereum address of the fee token contract

amount
string

Amount of fee in tokens

last_observed_ethereum_height
string

Most recent Ethereum block height observed by the bridge

last_outgoing_batch_id
string

Identifier of the most recently created outgoing batch

last_outgoing_pool_id
string

Identifier of the most recently used outgoing pool

last_observed_valset
object

Last validator set that was confirmed and submitted to Ethereum

nonce
string

Valset nonce

members
array

Members of the validator set

power
string

Voting power of the validator

ethereum_address
string

Ethereum address of the validator

height
string

Block height when the valset was created

reward_amount
string

Amount of reward paid to relay the valset

reward_token
string

Ethereum address of the reward token

ethereum_blacklist
array

List of Ethereum addresses blacklisted from receiving bridged tokens

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free