> 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/guides.md).

# Guides

These guides walk through the core interaction patterns in the Python SDK, from wallet setup to shielded transactions and private token operations.

## Available Guides

### [Shielded Write](/clients/python/guides/shielded-write.md)

Send encrypted transactions with `TxSeismic`. Covers the encryption lifecycle, security parameters, the low-level API, and debug mode.

### [Signed Reads](/clients/python/guides/signed-reads.md)

Execute encrypted `eth_call` reads that prove your identity via `msg.sender`. Covers when to use `.read` vs `.tread`, what gets encrypted, and the low-level API.

### [SRC20 Workflow](/clients/python/guides/src20-workflow.md)

End-to-end token workflow: read metadata, check balances, approve, and transfer using the SRC20 standard.

### [Async Patterns](/clients/python/guides/async-patterns.md)

Concurrent operations, resource cleanup, and async best practices.

## Before You Start

Both shielded writes and signed reads require a wallet client:

```python
import os
from seismic_web3 import PrivateKey, SEISMIC_TESTNET

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

# Sync
w3 = SEISMIC_TESTNET.wallet_client(pk)

# Async
w3 = await SEISMIC_TESTNET.async_wallet_client(pk)
```

To verify your connection:

```python
print(f"Chain ID: {w3.eth.chain_id}")
print(f"Block: {w3.eth.block_number}")
print(f"Address: {w3.eth.default_account}")
print(f"TEE public key: {w3.seismic.get_tee_public_key().to_0x_hex()}")
```

## See Also

* [Client Setup](/clients/python/client.md) — Full client configuration reference
* [Contract Interaction](/clients/python/contract.md) — Contract wrapper patterns
* [SRC20 Tokens](/clients/python/src20.md) — Token standard documentation
* [API Reference](/clients/python/api-reference.md) — Complete API documentation


---

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