Networks

The Startale App SDK supports two networks today.

Network	Chain ID	Use for
Soneium Mainnet	1868	Production
Soneium Minato	1946	Testing

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

Chain definitions

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

import { soneium, soneiumMinato } 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, soneiumMinato],
  transports: {
    [soneium.id]: http(),
    [soneiumMinato.id]: http(),
  },
  connectors: [startaleConnector({ /* ... */ })],
})

Switching networks

Use wagmi’s useSwitchChain() or the raw provider’s wallet_switchEthereumChain method. The popup confirms the switch with the user before the chain changes.

import { useSwitchChain } from 'wagmi'

const { switchChain } = useSwitchChain()
switchChain({ chainId: 1946 })

Inside a Mini App, wallet_switchEthereumChain is forwarded by the SDK but the host may reject the request. The Startale App host controls the active chain; treat a rejection as a host-enforced constraint. See Mini App wallet integration for the full constraint surface.

Stablecoin

USDSC is the canonical stablecoin on Soneium.

Network	USDSC contract
Soneium Mainnet	`0x3f99231dD03a9F0E7e3421c92B7b90fbe012985a`
Soneium Minato	`0xF2c10dC1beB13ee96036DE3F922eA871Ff2e0A7e`

See Pay with USDSC for full transfer examples.

Testnet ETH

For Soneium Minato testing, see the Soneium faucets list maintained by the Soneium team. It lists the current providers and their daily limits. If a faucet runs out, claim Sepolia ETH from any Ethereum testnet faucet and bridge it to Minato through the Soneium Bridge.

Testnet USDSC

There is no public USDSC faucet on Soneium Minato today. If you need to test token interaction, you can deploy your own token.

Introduction

Concepts

Public RPC endpoints

Block explorers

Chain definitions

Declaring supported chains

Switching networks

Stablecoin

Testnet ETH

Testnet USDSC

​Public RPC endpoints

​Block explorers

​Chain definitions

​Declaring supported chains

​Switching networks

​Stablecoin

​Testnet ETH

​Testnet USDSC

Public RPC endpoints

Block explorers

Chain definitions

Declaring supported chains

Switching networks

Stablecoin

Testnet ETH

Testnet USDSC