# 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: 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:

```
GET https://docs.seismic.systems/clients/python/guides.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.