Quickstart — Smart-account mode (Python)

ERC-4337 v0.7 trading via SimpleAccount + bundler from Python. Same surface as the TS SDK.

Smart-account mode in Python mirrors the TypeScript surface exactly. Use it for Python AA-stack integrations, paymaster sponsorship, batched approve+trade flows, or any case where the trading address should be a SimpleAccount derived from an external signer.

Construct the client

import asyncio
import os

from eth_account import Account
from kashdao_protocol_sdk import (
    BundlerOptions,
    create_smart_account_client,
    viem_account_signer,
)


async def main() -> None:
    account = Account.from_key(os.environ["KASH_PRIVATE_KEY"])

    async with create_smart_account_client(
        chain_id=84532,
        rpc=os.environ["BASE_SEPOLIA_RPC"],
        signer=viem_account_signer(account),
        bundler=BundlerOptions(
            provider="pimlico",
            url=os.environ["KASH_BUNDLER_URL"],
        ),
    ) as client:
        sa = await client.account.compute_address(client.signer.owner_address)
        print(f"SmartAccount: {sa}")
        health = await client.bundler.health()
        print(f"bundler health: {health}")


asyncio.run(main())

BundlerOptions(provider=..., url=..., api_key=...) accepts alchemy, pimlico, flashbots, or generic. The provider value is informational; the actual vendor preset is chosen by the consumer when wiring the client.

Place a trade

from kashdao_protocol_sdk import BuildBuyParams, usdc

sa = await client.account.compute_address(client.signer.owner_address)

result = await client.trades.send.buy(
    os.environ["KASH_MARKET"],
    BuildBuyParams(
        account=sa,
        outcome=0,
        amount_usdc=usdc(10),
        max_slippage_bps=50,
    ),
)
print(
    result.user_op_hash,
    result.receipt.receipt.get("transactionHash"),
    result.receipt.success,
)

The user_op_hash is what the signer signed — useful for log correlation across the bundler RPC and the EntryPoint contract. The smart-account send.buy result carries only user_op_hash and the bundler-returned receipt; the on-chain transaction hash is nested at result.receipt.receipt["transactionHash"] and success at result.receipt.success. External monitoring typically wants both views.

First-trade-with-deployment

Same auto-deploy story as the TypeScript SDK: the first UserOp from a fresh SmartAccount carries factory + factory_data so the EntryPoint deploys the account in the same op. The Python SDK auto-detects the undeployed state and populates these fields; you don’t pass anything special. Verification gas is ~5x higher on the deployment op, and the bundler’s gas estimate accounts for this automatically.

Run the bundled examples

# Read-only by default: derives the SA via CREATE2, prints deploy/balance state and a quote
python examples/smart_account/buy_with_simple_account.py

# --confirm opts in to broadcasting: submits a real SA BUY UserOp on Base Sepolia
python examples/smart_account/quote_and_buy.py --confirm

What’s next

EOA quickstart

Vanilla EIP-1559, no bundler.

Hummingbot integration

Full strategy walkthrough.