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 integration modes. Pick the one that matches your codebase. 
import { startaleConnector } from '@startale/app-sdk'
import { http, createConfig } from 'wagmi'
import { soneium, soneiumMinato } from 'wagmi/chains'

export const config = createConfig({
  chains: [soneium, soneiumMinato],
  connectors: [
    startaleConnector({
      appName: 'My App',
      appLogoUrl: 'https://my-app.com/logo.png',
    }),
  ],
  transports: {
    [soneium.id]: http(),
    [soneiumMinato.id]: http(),
  },
})

declare module 'wagmi' {
  interface Register {
    config: typeof config
  }
}
Wrap your app with WagmiProvider and QueryClientProvider. See the Quickstart for a complete example.

​
With the raw provider

For non-React apps, custom state management, or server-side wallet code: 
import { createStartaleAccountSDK } from '@startale/app-sdk'

const sdk = createStartaleAccountSDK({
  appName: 'My App',
  appLogoUrl: 'https://my-app.com/logo.png',
  appChainIds: [1868, 1946],
})

const provider = sdk.getProvider()
const accounts = await provider.request({ method: 'eth_requestAccounts' })

​
Options

​
appName
string
The display name shown in the connection popup. Defaults to 'App' if omitted; recommended to set.
​
appLogoUrl
string
An HTTPS URL to a square logo. Shown in the connection popup.
​
appChainIds
number[]
Chain IDs your app supports. Defaults to [] if omitted; recommended to pass at minimum 1868 (Mainnet) or 1946 (Minato).
​
preference
Preference
Optional preferences. See createStartaleAccountSDK for the full type.
​
paymasterOptions
Record<chainId, { url, id }>
Optional. Wire an ERC-7677 paymaster service per chain. Standalone dapps need this to sponsor gas; without it, users pay from their smart account ETH balance. Mini Apps inside the Startale App ignore this field and use the host paymaster. See Custom paymaster and Gas sponsorship.