These tutorials build on each other. If you follow them in order, you will end with a smart account, a sponsored or token-paid paymaster, batched contract calls, scoped session keys, and a guardian-based recovery flow, all wired through the sameDocumentation Index
Fetch the complete documentation index at: https://docs.startale.com/llms.txt
Use this file to discover all available pages before exploring further.
StartaleAccountClient.
Source:
StartaleGroup/scs-aa-sdk.Prerequisites
| You should have | Why |
|---|---|
| Node.js 18+ and a TypeScript project | The SDK ships ES2022 output and TypeScript types. |
| A signer (private key, browser wallet, or social-login provider) | Required by toStartaleSmartAccount. See Installation. |
| An SCS Portal API key and at least one paymaster | Issued from the SCS Portal; covered in Portal setup. |
Familiarity with viem basics | The SDK is viem-native (Address, Chain, Transport, PublicClient). |
Recommended path
Portal setup
Provision an API key, create a paymaster, and configure gas policies. → Portal setup
Installation and setup
Install dependencies and pick a signer (viem
LocalAccount, viem WalletClient, EIP-1193 provider, or ethers.Wallet). → Installation and setupSmart account setup
Build the smart account, the sponsored client, and (optionally) the token-paymaster client; persist them in your app state. → Smart account setup
Contract interactions
Encode calldata, send single and batched calls, handle errors. → Contract interactions
Pick a paymaster mode
Sponsored paymaster for gasless flows; ERC-20 paymaster to charge users in tokens.
Add advanced UX
Smart sessions for scoped, signature-free flows; Social recovery for guardian-based key rotation.
What each page leaves you with
| Page | Outcome |
|---|---|
| Portal setup | BUNDLER_URL, PAYMASTER_URL, paymasterId, gas policies. |
| Installation | @startale-scs/aa-sdk installed, signer chosen. |
| Smart account setup | A persisted StartaleAccountClient (sponsored and/or token). |
| Contract interactions | Single and batched calls with error handling. |
| Sponsored paymaster | UserOperations that pay gas via your paymaster. |
| ERC-20 paymaster | UserOperations paid in ASTR, USDC, or other supported tokens. |
| Smart sessions | Scoped session keys that skip the user prompt. |
| Social recovery | Guardian-based key rotation. |
Reference material
Auth providers
Plug Dynamic, Privy, or any EIP-1193 wallet into the signer slot.
EIP-7702
Upgrade existing EOAs to delegated smart accounts.
Networks and contracts
Chain IDs, deployed contract addresses, and supported tokens.