Networks

Signatures and transactions from the App SDK are handled by the Startale App, so the networks you can transact on are the ones the Startale App serves.

Network	Chain ID	Use for
Soneium Mainnet	1868	Production
Ethereum Mainnet	1	Deposits and transfers. Available to a Mini App only when it is enabled for Ethereum Mainnet.

For testing, the Mini App developer preview also serves two testnets. They are not available anywhere else in the Startale App, including the App SDK.

Network	Chain ID	Use for
Soneium Minato	1946	Testing a Mini App in the developer preview
Ethereum Sepolia	11155111	Testing a Mini App in the developer preview

Public RPC endpoints

Network	RPC URL
Soneium Mainnet	`https://rpc.soneium.org/`
Soneium Minato	`https://rpc.minato.soneium.org/`

These public endpoints are rate-limited and intended for development. For production traffic, run your own node or use an infrastructure partner. See the Soneium builder docs for the current options.

Block explorers

Network	Explorer
Soneium Mainnet	soneium.blockscout.com
Soneium Minato	soneium-minato.blockscout.com
Ethereum Sepolia	sepolia.etherscan.io

Chain definitions

Soneium chains are exported by viem/chains and wagmi/chains:

import { soneium } from 'wagmi/chains'

Declaring supported chains

For the wagmi connector, the chain list comes from wagmi’s createConfig({ chains }) array. startaleConnector() derives appChainIds from it automatically:

createConfig({
  chains: [soneium],
  transports: {
    [soneium.id]: http(),
  },
  connectors: [startaleConnector({ /* ... */ })],
})

Switching networks

Use wagmi’s useSwitchChain() or the raw provider’s wallet_switchEthereumChain method. Once connected, a switch to a network the Startale App serves happens in the SDK without a popup and emits chainChanged. See wallet_switchEthereumChain.

import { useSwitchChain } from 'wagmi'
import { soneium } from 'wagmi/chains'

const { switchChain } = useSwitchChain()
switchChain({ chainId: soneium.id })

Inside a Mini App, the host only switches to a chain your Mini App is enabled for, which is Soneium Mainnet only by default. See Mini App chains.

Stablecoin

USDSC is the canonical stablecoin on Soneium.

Network	USDSC contract
Soneium Mainnet	`0x3f99231dD03a9F0E7e3421c92B7b90fbe012985a`

See Pay with USDSC for full transfer examples.

Introduction

Concepts

Public RPC endpoints

Block explorers

Chain definitions

Declaring supported chains

Switching networks

Stablecoin

​Public RPC endpoints

​Block explorers

​Chain definitions

​Declaring supported chains

​Switching networks

​Stablecoin

Public RPC endpoints

Block explorers

Chain definitions

Declaring supported chains

Switching networks

Stablecoin