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.

Every contract the SDK talks to is open source and audited. Use this page as the canonical reference when you need an address, an ABI, or an audit report.
Source repositories: scs-aa-account-contracts, scs-aa-paymasters. The SDK that consumes them is at StartaleGroup/scs-aa-sdk.

Account contracts (v1.0.0)

These are the contracts deployed by toStartaleSmartAccount and referenced by the modular account.
ContractAddressWhat it does
Startale Account Implementation0x000000b8f5f723a680d3d7ee624fe0bc84a6e05aThe ERC-7579 modular account logic. Used as implementationAddress for EIP-7702.
Startale Account Factory0x0000003B3E7b530b4f981aE80d9350392Defef90CREATE2 factory used by the SDK to deploy accounts on first UserOperation.
Bootstrap0x000000552A5fAe3Db7a8F3917C435448F49BA6a9Initialiser contract that wires modules into a fresh account.
ECDSA Validator0x00000072F286204Bb934eD49D8969E86F7dEC7b1Default ERC-7579 validator. Validates signatures from a single ECDSA key.
The corresponding npm release is @startale-scs/aa-sdk ^1.0.x. When new account-contract versions ship, the SDK exposes them through new releases; pin the SDK version that matches the contract version you have audited.

Paymasters

Both paymaster modes from the Portal are implemented by the contracts below.
ContractAddressPurpose
Postpaid Sponsorship Paymaster0x00000095901E8AB695Dc24FA52B0Cce15E9896AdBacks the managed paymaster. SCS settles gas in fiat.
Prepaid Sponsorship Paymaster0x0000002deA684Ecd1979140746CF415AD46D8b16Backs the self-funded paymaster. Sponsor balance is debited per UserOp.
Startale Token Paymaster0x0000006C18daC1Ff8F50Df743F7587a8b7d8a8a7Accepts ERC-20 tokens as gas. See Supported networks.

ERC-7579 validator and module addresses

The SDK exposes typed helpers for the modules below. Their onchain addresses are stable across Soneium Minato and Mainnet.
ModuleAddressSDK helper
ECDSA Validator0x00000072F286204Bb934eD49D8969E86F7dEC7b1Installed automatically by toStartaleSmartAccount.
Smart Sessions Validator (V1)0x00000000008bDABA73cD9815d79069c247Eb4bDAgetSmartSessionsValidator, toSmartSessionsValidator from @startale-scs/aa-sdk.
Social Recovery ValidatorSee @rhinestone/module-sdkgetSocialRecoveryValidator (re-exported through @rhinestone/module-sdk).

Audit reports

RepositoryAudits
scs-aa-account-contractsaudit reports
scs-aa-paymastersaudit reports
If you are integrating the SDK into a production system, read the audit reports for the contract version that matches your SDK pin and confirm that the addresses above match the deployments referenced in those reports.

Verifying onchain

You can verify any address with the public Soneium block explorers:

Next steps

Supported networks

Chain IDs, EntryPoint version, and supported gas tokens.

EIP-7702 guide

Use the implementation address as the EIP-7702 delegation target.

Smart sessions

Install the Smart Sessions validator on top of the modular account.

Social recovery

Install the Social Recovery validator with a guardian set.