Python — seismic-web3

Python SDK for Seismic, built on web3.py

Python SDK for Seismic, built on web3.py. Requires Python 3.10+.

pip install seismic-web3

Or with uv:

uv add seismic-web3

Quick Example

import os
from seismic_web3 import SEISMIC_TESTNET, PrivateKey

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

# Wallet client — full capabilities (requires private key)
w3 = SEISMIC_TESTNET.wallet_client(pk)

contract = w3.seismic.contract(address="0x...", abi=ABI)

# Shielded write — calldata is encrypted
tx_hash = contract.write.setNumber(42)
receipt = w3.eth.wait_for_transaction_receipt(tx_hash)

# Signed read — encrypted eth_call, proves your identity
result = contract.read.getNumber()

# Public client — read-only (no private key needed)
public = SEISMIC_TESTNET.public_client()

contract = public.seismic.contract(address="0x...", abi=ABI)
result = contract.tread.getNumber()

Documentation Navigation

Getting Started

Section	Description
Client	Create sync/async wallet and public clients
Chains	Chain configuration (SEISMIC_TESTNET, SANVIL)
Contract	Interact with shielded and public contracts

Guides & Examples

Section	Description
Guides	Step-by-step tutorials for common workflows
Examples	Complete runnable code examples

API Reference

Section	Description
API Reference	Complete API documentation for all types and functions
Types	Primitive types (Bytes32, PrivateKey, etc.)
Transaction Types	Seismic transaction dataclasses
EIP-712	EIP-712 typed data signing functions

Advanced Features

Section	Description
Namespaces	w3.seismic namespace methods
Precompiles	Privacy-preserving cryptographic functions
SRC20	SRC20 token standard support
ABIs	Built-in contract ABIs and helpers

Quick Links

By Task

• Send a shielded transaction → Shielded Write Guide

• Execute a signed read → Signed Reads Guide

• Work with SRC20 tokens → SRC20 Documentation

• Use async client → Client Documentation

• Configure custom chain → Chains Documentation

By Component

• Client factories → create_wallet_client, create_public_client

• Contract wrappers → ShieldedContract, PublicContract

• Encryption → EncryptionState, Precompiles

• Transaction types → UnsignedSeismicTx, SeismicElements

Features

• 🔒 Shielded Transactions - Encrypt calldata with TEE public key

• 📝 Signed Reads - Prove identity in eth_call

• 🪙 SRC20 Support - Built-in support for private tokens

• ⚡ Async/Await - Full async support with AsyncWeb3

• 🔑 EIP-712 - Structured typed data signing

• 🛠️ Precompiles - Access Mercury EVM cryptographic precompiles

• 🌐 Web3.py Compatible - Standard Web3 instance with Seismic extensions

Architecture

The SDK extends web3.py with a custom w3.seismic namespace:

Web3 (standard web3.py)
├── eth (standard)
├── net (standard)
└── seismic (Seismic-specific) ✨
    ├── send_shielded_transaction()
    ├── signed_call()
    ├── get_tee_public_key()
    ├── deposit()
    └── contract() → ShieldedContract
                     ├── .write (shielded)
                     ├── .read (signed)
                     ├── .twrite (transparent)
                     ├── .tread (transparent)
                     └── .dwrite (debug)

Next Steps

1. Install and setup a client - Get connected to Seismic

2. Send your first shielded transaction - Step-by-step guide

3. Explore the API reference - Deep dive into all types and functions

4. Check out examples - See complete runnable code