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

# Initialization

> Pick between the wagmi connector and the raw EIP-1193 provider.

The Startale App SDK supports two integration modes. Pick the one that matches your codebase.

## With wagmi (recommended for React)

```ts theme={null}
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](/quickstart) for a complete example.

## With the raw provider

For non-React apps, custom state management, or server-side wallet code:

```ts theme={null}
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

<ParamField path="appName" type="string">
  The display name shown in the connection popup. Defaults to `'App'` if omitted; recommended to set.
</ParamField>

<ParamField path="appLogoUrl" type="string">
  An HTTPS URL to a square logo. Shown in the connection popup.
</ParamField>

<ParamField path="appChainIds" type="number[]">
  Chain IDs your app supports. Defaults to `[]` if omitted; recommended to pass at minimum `1868` (Mainnet) or `1946` (Minato).
</ParamField>

<ParamField path="preference" type="Preference">
  Optional preferences. See [`createStartaleAccountSDK`](/api-reference/create-startale-account-sdk) for the full type.
</ParamField>

<ParamField path="paymasterOptions" type="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](/app-sdk/custom-paymaster) and [Gas sponsorship](/concepts/gasless).
</ParamField>