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 supports Soneium Minato (testnet) and Soneium Mainnet. Both run EntryPoint v0.7 so the SDK call sites are identical across networks; only the chain object and bundler URL change.

Soneium Minato (testnet)

ParameterValue
Network nameSoneium Minato
Chain ID1946
Native tokenETH (18 decimals)
Block explorersoneium-minato.blockscout.com
Bundler URL patternhttps://soneium-minato.bundler.scs.startale.com?apikey=YOUR_API_KEY
Paymaster URLhttps://paymaster.scs.startale.com/v1?apikey=YOUR_API_KEY
EntryPoint versionv0.7
viem chain exportsoneiumMinato (viem/chains)

Soneium Mainnet

ParameterValue
Network nameSoneium Mainnet
Chain ID1868
Native tokenETH (18 decimals)
Block explorersoneium.blockscout.com
Bundler URL patternhttps://soneium.bundler.scs.startale.com?apikey=YOUR_API_KEY
Paymaster URLhttps://paymaster.scs.startale.com/v1?apikey=YOUR_API_KEY
EntryPoint versionv0.7
viem chain exportsoneium (viem/chains)

What “EntryPoint v0.7” means for you

The EntryPoint contract is the onchain singleton that validates and executes UserOperations. Version v0.7 is the current spec; the practical implications are:
  • The SDK encodes UserOperations in the v0.7 layout (paymasterAndData is split into paymaster, paymasterVerificationGasLimit, and paymasterPostOpGasLimit).
  • The bundler accepts the eth_sendUserOperation JSON-RPC method with the v0.7 schema.
  • ERC-7579 module actions reference EntryPoint v0.7 selectors when building installation calldata.
You do not need to set the EntryPoint version manually; the SDK targets v0.7 throughout.

Token paymaster supported tokens

The Startale Token Paymaster accepts the tokens below as gas. Pass the token address as paymasterContext.token in createSmartAccountClient.

Soneium Minato

TokenAddressNotes
ASTR0x26e6f7c7047252DdE3dcBF26AA492e6a264Db655Bridge from Sepolia or contact the team for testnet allocations.
USDC0xfF0CBFbA43a1Ce2B8d72B2f3121558BcBd4B03a6Bridge USDC from Sepolia.
USDC.e0xE9A198d38483aD727ABC8b0B1e16B2d338CF0391Canonical bridged USDC variant.

Soneium Mainnet

TokenAddress
ASTR0x2CAE934a1e84F693fbb78CA5ED3B0A6893259441
SolvBTC0x541fd749419ca806a8bc7da8ac23d346f2df8b77
WBTC0x0555e30da8f98308edb960aa94c0db47230d2b9c
USDC.e0xba9986d2381edf1da03b0b9c1f8b00dc4aacc369
The list above is updated whenever a new token is whitelisted; verify the latest addresses against the SCS Portal before shipping.

Network selection in code

import { http, createPublicClient } from "viem"
import { soneium, soneiumMinato } from "viem/chains"
import { toStartaleSmartAccount } from "@startale-scs/aa-sdk"

const chain = process.env.NETWORK === "mainnet" ? soneium : soneiumMinato

const account = await toStartaleSmartAccount({
  signer,
  chain,
  transport: http(),
  index: 0n,
})
SymbolSourceRole
soneium, soneiumMinatoviem/chainsPre-baked viem Chain definitions. Use them anywhere the SDK or viem asks for a chain.
httpviemHTTP transport. Defaults to the chain’s public RPC unless you pass an override.

Next steps

Contracts and audits

Deployed account, factory, paymaster, and validator addresses per network.

ERC-20 paymaster

Charge users in any of the supported tokens above.