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 App SDK supports two networks today.
NetworkChain IDUse for
Soneium Mainnet1868Production
Soneium Minato1946Testing

Public RPC endpoints

NetworkRPC URL
Soneium Mainnethttps://rpc.soneium.org/
Soneium Minatohttps://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

NetworkExplorer
Soneium Mainnetsoneium.blockscout.com
Soneium Minatosoneium-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.
NetworkUSDSC contract
Soneium Mainnet0x3f99231dD03a9F0E7e3421c92B7b90fbe012985a
Soneium Minato0xF2c10dC1beB13ee96036DE3F922eA871Ff2e0A7e
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.