Skip to main content

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.

The Startale AA SDK is the developer-facing toolkit for building ERC-4337 account abstraction flows on Soneium. It pairs a TypeScript SDK with managed bundler and paymaster infrastructure, and ships with an ERC-7579 modular account so you can extend account behavior with validators, executors, hooks, and fallbacks.
Source of truth for the SDK lives at StartaleGroup/scs-aa-sdk. Every code sample in this tab maps to a symbol exported from the published package @startale-scs/aa-sdk.

Architecture at a glance

The SDK exposes three primitives that you wire together:

Smart account

toStartaleSmartAccount builds an ERC-7579 account from any signer and lets you attach validators, executors, hooks, and fallbacks.

Account client

createSmartAccountClient wraps the account with bundler, paymaster, and ERC-7579 module actions for sending UserOperations.

Paymaster client

createSCSPaymasterClient connects to the SCS Paymaster and supports both sponsored gas and ERC-20 token paymaster flows.

Where to start

Learn the basics

Understand UserOperations, modular accounts, and the SCS infrastructure stack before you write code.

Quickstart

Send your first sponsored UserOperation against a deployed contract on Soneium Minato in under five minutes.

Portal setup

Provision an API key, create a paymaster, and configure gas policies in the SCS Portal.

Tutorial path

Walk through installation, account setup, contract interactions, paymaster modes, sessions, and recovery in order.

Reference material

Auth providers

Pair the SDK with Dynamic, Privy, or any EIP-1193 provider you already trust.

EIP-7702

Upgrade existing EOAs into delegated smart accounts without changing addresses.

Networks and contracts

Chain IDs, deployed addresses, audit reports, and supported ERC-20 tokens for the token paymaster.