> For the complete documentation index, see [llms.txt](https://docs.seismic.systems/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.seismic.systems/clients/python/chains/seismic-testnet.md).

# SEISMIC\_TESTNET

Pre-defined [`ChainConfig`](/clients/python/chains/chain-config.md) 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

```python
SEISMIC_TESTNET: ChainConfig = make_seismic_testnet(1)
```

Internally, this is equivalent to:

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

## Configuration

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

## Usage

### Import and Access Properties

```python
from seismic_web3 import SEISMIC_TESTNET

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

### Create Wallet Client (Sync)

```python
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)

```python
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://testnet-1.seismictest.net/ws)
w3 = await SEISMIC_TESTNET.async_wallet_client(pk, ws=True)
```

### Create Public Client

```python
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

```python
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

```python
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

```python
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)`](/clients/python/chains/make-seismic-testnet.md)

## Chain ID Constant

The chain ID is also available as a standalone constant:

```python
from seismic_web3 import SEISMIC_TESTNET_CHAIN_ID

SEISMIC_TESTNET_CHAIN_ID  # 5124
```

## See Also

* [ChainConfig](/clients/python/chains/chain-config.md) - Chain configuration dataclass
* [make\_seismic\_testnet](/clients/python/chains/make-seismic-testnet.md) - Factory for alternate testnet instances
* [SANVIL](/clients/python/chains/sanvil.md) - Local development network
* [create\_wallet\_client](/clients/python/client/create-wallet-client.md) - Direct client creation
* [PrivateKey](/clients/python/api-reference/types/private-key.md) - Private key type


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.seismic.systems/clients/python/chains/seismic-testnet.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.