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 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
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.