/peggy/v1/module_state REST API Endpoint

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

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

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

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

curl -X GET "https://docs-demo.injective-testnet.quiknode.pro/peggy/v1/module_state" \
    -H "accept: application/json"

const myHeaders = new Headers();
myHeaders.append("accept", "application/json");

const requestOptions = {
  method: "GET",
  headers: myHeaders,
  redirect: "follow"
};

fetch("https://docs-demo.injective-testnet.quiknode.pro/peggy/v1/module_state", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

import requests

url = "https://docs-demo.injective-testnet.quiknode.pro/peggy/v1/module_state"

payload = {}
headers = {
  'accept': 'application/json'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

require "uri"
require "net/http"

url = URI("https://docs-demo.injective-testnet.quiknode.pro/peggy/v1/module_state")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)
request["accept"] = "application/json"

response = https.request(request)
puts response.read_body

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free

/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.

Parameters

Returns