React

<VoizProvider
  chainId={chainId}
  publicClient={publicClient}
  walletClient={walletClient}
  sendCalls={sendCalls} // optional AA / Privy
>
  {children}
</VoizProvider>

// returns
JSX.Element

type VoizProviderProps = {
  chainId: number
  publicClient: PublicClient
  /** Full address map. If omitted, resolved via `getAddresses(chainId)`. */
  addresses?: ChainAddresses
  /** Optional EOA / injected wallet for the client and default `sendCalls`. */
  walletClient?: WalletClient
  /**
   * Optional custom sender (AA / Privy). Injected onto `VoizMarketsClient`.
   * May receive `{ requiredSigner }` for admin-gated writes (e.g. resolve).
   * If omitted and `walletClient` is set, defaults to sequential
   * `walletClient.sendTransaction`.
   */
  sendCalls?: VoizSendCalls
  children: ReactNode
}

const { client, addresses, chainId } = useVoiz()

// returns
{
  client: VoizMarketsClient
  addresses: {
    chainId: number
    marketFactory: Address
    adminOracle: Address
    multisigOracle: Address
    router: Address
    collateral: Address
    conditionalTokens: Address
    poolManager: Address
    positionManager: Address
    stateView: Address
    quoter: Address
    permit2: Address
    hook: Address
    seerV4Swap: Address
    fee: number
    tickSpacing: number
    hookFeeBips: number
  }
  chainId: number
  publicClient: PublicClient
  walletClient?: WalletClient<Transport, Chain | undefined, Account>
  sendCalls?: (
    calls: Call[],
    opts?: { requiredSigner?: Address }
  ) => Promise<unknown>
}

type VoizContextValue = {
  client: VoizMarketsClient
  addresses: ChainAddresses
  chainId: number
  publicClient: PublicClient
  walletClient?: WalletClient<Transport, Chain | undefined, Account>
  /** Prefer high-level client / market / pool methods. */
  sendCalls?: VoizSendCalls
}

type VoizSendCalls = (
  calls: Call[],
  opts?: SendCallsOptions
) => Promise<unknown>

type SendCallsOptions = {
  /**
   * Force a specific EOA / wallet to sign (e.g. marketAdmin for AdminOracle).
   * Apps with smart+EOA dual wallets should honor this when routing.
   */
  requiredSigner?: Address
}