> ## Documentation Index
> Fetch the complete documentation index at: https://docs.startale.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Account Abstraction toolkit

> Build smart account experiences on Soneium with the Startale AA SDK.

The Startale AA SDK is the developer-facing toolkit for building [ERC-4337](https://eips.ethereum.org/EIPS/eip-4337) account abstraction flows on Soneium. It pairs a TypeScript SDK with managed bundler and paymaster infrastructure, and ships with an [ERC-7579](https://eips.ethereum.org/EIPS/eip-7579) modular account so you can extend account behavior with validators, executors, hooks, and fallbacks.

<Note>
  Source of truth for the SDK lives at [`StartaleGroup/scs-aa-sdk`](https://github.com/StartaleGroup/scs-aa-sdk). Every code sample in this tab maps to a symbol exported from the published package `@startale-scs/aa-sdk`.
</Note>

## Architecture at a glance

```mermaid theme={null}
flowchart LR
  Signer["Signer<br/>(EOA / WalletClient /<br/>EIP-1193 provider)"]
  Account["Startale Smart Account<br/>(ERC-7579 modular)"]
  Bundler["SCS Bundler<br/>(ERC-4337)"]
  EntryPoint["EntryPoint v0.7"]
  Paymaster["SCS Paymaster<br/>(sponsored or ERC-20)"]
  Chain[(Soneium)]

  Paymaster -->|paymasterAndData| Account
  Signer -->|signs populated UserOp| Account
  Account -->|signed UserOperation| Bundler
  Bundler -->|handleOps tx| EntryPoint
  EntryPoint -->|executes| Chain
```

The SDK exposes three primitives that you wire together:

<CardGroup cols={3}>
  <Card title="Smart account" icon="wallet">
    `toStartaleSmartAccount` builds an ERC-7579 account from any signer and lets you attach validators, executors, hooks, and fallbacks.
  </Card>

  <Card title="Account client" icon="bolt">
    `createSmartAccountClient` wraps the account with bundler, paymaster, and ERC-7579 module actions for sending UserOperations.
  </Card>

  <Card title="Paymaster client" icon="gas-pump">
    `createSCSPaymasterClient` connects to the SCS Paymaster and supports both sponsored gas and ERC-20 token paymaster flows.
  </Card>
</CardGroup>

## Where to start

<CardGroup cols={2}>
  <Card title="Learn the basics" icon="book-open" href="/aa-sdk/getting-started/introduction">
    Understand UserOperations, modular accounts, and the SCS infrastructure stack before you write code.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/aa-sdk/getting-started/quick-start">
    Send your first sponsored UserOperation against a deployed contract on Soneium Minato in under five minutes.
  </Card>

  <Card title="Portal setup" icon="key" href="/aa-sdk/tutorials/portal">
    Provision an API key, create a paymaster, and configure gas policies in the SCS Portal.
  </Card>

  <Card title="Tutorial path" icon="graduation-cap" href="/aa-sdk/tutorials/overview">
    Walk through installation, account setup, contract interactions, paymaster modes, sessions, and recovery in order.
  </Card>
</CardGroup>

## Reference material

<CardGroup cols={3}>
  <Card title="Auth providers" icon="user-check" href="/aa-sdk/auth-providers/overview">
    Pair the SDK with Dynamic, Privy, or any EIP-1193 provider you already trust.
  </Card>

  <Card title="EIP-7702" icon="cpu" href="/aa-sdk/eip7702">
    Upgrade existing EOAs into delegated smart accounts without changing addresses.
  </Card>

  <Card title="Networks and contracts" icon="folder" href="/aa-sdk/resources/supported-networks">
    Chain IDs, deployed addresses, audit reports, and supported ERC-20 tokens for the token paymaster.
  </Card>
</CardGroup>