SEISMIC_TESTNET

Pre-configured Seismic public testnet

Pre-defined ChainConfig for the Seismic public testnet (GCP node 1).

Overview

SEISMIC_TESTNET is a ready-to-use chain configuration pointing to the primary Seismic testnet instance. It's the recommended starting point for developers building on Seismic.

Definition

SEISMIC_TESTNET: ChainConfig = make_seismic_testnet(1)

Internally, this is equivalent to:

ChainConfig(
    chain_id=5124,
    rpc_url="https://gcp-1.seismictest.net/rpc",
    ws_url="wss://gcp-1.seismictest.net/ws",
    name="Seismic Testnet",
)

Configuration

Property	Value
chain_id	5124
rpc_url	"https://gcp-1.seismictest.net/rpc"
ws_url	"wss://gcp-1.seismictest.net/ws"
name	"Seismic Testnet"

Usage

Import and Access Properties

from seismic_web3 import SEISMIC_TESTNET

# Access configuration
print(SEISMIC_TESTNET.rpc_url)   # "https://gcp-1.seismictest.net/rpc"
print(SEISMIC_TESTNET.ws_url)    # "wss://gcp-1.seismictest.net/ws"
print(SEISMIC_TESTNET.chain_id)  # 5124
print(SEISMIC_TESTNET.name)      # "Seismic Testnet"

Create Wallet Client (Sync)

import os
from seismic_web3 import SEISMIC_TESTNET, PrivateKey

pk = PrivateKey.from_hex_str(os.environ["PRIVATE_KEY"])
w3 = SEISMIC_TESTNET.wallet_client(pk)

# Now use w3.seismic methods
balance = w3.eth.get_balance("0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266")

Create Wallet Client (Async)

import os
from seismic_web3 import SEISMIC_TESTNET, PrivateKey

pk = PrivateKey.from_hex_str(os.environ["PRIVATE_KEY"])

# HTTP
w3 = await SEISMIC_TESTNET.async_wallet_client(pk)

# WebSocket (auto-selects wss://gcp-1.seismictest.net/ws)
w3 = await SEISMIC_TESTNET.async_wallet_client(pk, ws=True)

Create Public Client

from seismic_web3 import SEISMIC_TESTNET

# Sync
public_sync = SEISMIC_TESTNET.public_client()
block = public_sync.eth.get_block("latest")

# Async
public_async = SEISMIC_TESTNET.async_public_client()
block = await public_async.eth.get_block("latest")

Examples

Basic Shielded Transaction

import os
from seismic_web3 import SEISMIC_TESTNET, PrivateKey

pk = PrivateKey.from_hex_str(os.environ["PRIVATE_KEY"])
w3 = SEISMIC_TESTNET.wallet_client(pk)

# Get contract
contract = w3.seismic.contract(
    address="0x00000000219ab540356cBB839Cbe05303d7705Fa",
    abi=[...],
)

# Send shielded write
tx_hash = contract.swrite.your_function(arg1, arg2)
receipt = w3.eth.wait_for_transaction_receipt(tx_hash)

Using with Environment Variables

import os
from seismic_web3 import SEISMIC_TESTNET, PrivateKey

# Load private key from environment
pk = PrivateKey.from_hex_str(os.environ["PRIVATE_KEY"])

# Create client
w3 = SEISMIC_TESTNET.wallet_client(pk)

Checking Connection

from seismic_web3 import SEISMIC_TESTNET

public = SEISMIC_TESTNET.public_client()

# Verify connection
try:
    chain_id = public.eth.chain_id
    block_number = public.eth.block_number
    print(f"Connected to chain {chain_id} at block {block_number}")
except Exception as e:
    print(f"Connection failed: {e}")

Notes

• This is the primary public testnet instance

• Suitable for development and testing

• WebSocket endpoint is available for subscriptions

• For alternate testnet instances, use make_seismic_testnet(n)

Chain ID Constant

The chain ID is also available as a standalone constant:

from seismic_web3 import SEISMIC_TESTNET_CHAIN_ID

SEISMIC_TESTNET_CHAIN_ID  # 5124

See Also

• ChainConfig - Chain configuration dataclass

• make_seismic_testnet - Factory for alternate testnet instances

• SANVIL - Local development network

• create_wallet_client - Direct client creation

• PrivateKey - Private key type