InterwovenKitProvider

The InterwovenKitProvider is the root component that enables wallet connectivity and transaction signing.

All applications using InterwovenKit must be wrapped with InterwovenKitProvider at the root level to enable wallet functionality.

Basic Configuration

Chain Connection

defaultChainId · string · default: "interwoven-1"

Sets the primary blockchain network that InterwovenKit uses as its default throughout the application. This chain is used for transactions, balance queries, appears first in asset displays, and serves as a fallback when no specific chain is provided.

The defaultChainId parameter accepts chain ID strings that correspond to chains in the Initia registry. Common values include:

Mainnet:

• "interwoven-1" - The main Initia network (default for mainnet)

Testnet:

• "initiation-2" - The Initia testnet (default for testnet)

When no defaultChainId is provided, the system automatically defaults to "interwoven-1" (mainnet). For testnet development, use the TESTNET configuration which includes defaultChainId: "initiation-2".

// Explicitly set to mainnet
export default function Providers() {
  return (
    <InterwovenKitProvider defaultChainId="interwoven-1">
      {children}
    </InterwovenKitProvider>
  )
}

// Use testnet configuration (includes defaultChainId: "initiation-2")
export default function Providers() {
  return (
    <InterwovenKitProvider {...TESTNET}>
      {children}
    </InterwovenKitProvider>
  )
}

The defaultChainId affects transaction defaults, portfolio sorting, balance queries, and bridge operations. Assets from the default chain will appear first in lists, and all operations will use this chain unless explicitly overridden.

Custom Chain Support

customChain · Chain

Custom chain configuration for chains not registered in the initia-registry. Use this when connecting to private or development chains.

import { Chain } from "@initia/initia-registry-types"
import { ChainSchema } from "@initia/initia-registry-types/zod"
import { InterwovenKit } from "@initia/interwovenkit-react"

const customChain: Chain = ChainSchema.parse({
  chain_id: "YOUR_CHAIN_ID",
  chain_name: "YOUR_CHAIN_NAME",
  apis: {
    rpc: [{ address: "YOUR_RPC_URL" }],
    rest: [{ address: "YOUR_LCD_URL" }],
  },
  fees: {
    fee_tokens: [{ denom: "YOUR_FEE_DENOM", fixed_min_gas_price: 0.015 }],
  },
  bech32_prefix: "init",
  network_type: "mainnet",
})

export default function Providers() {
  return (
    <InterwovenKitProvider defaultChainId="YOUR_CHAIN_ID" customChain={customChain}>
      {children}
    </InterwovenKitProvider>
  )
}

UI Theme

theme · "light" | "dark" · default: "dark"

Controls the visual theme of wallet modals and components.

export default function Providers() {
  return (
    <InterwovenKitProvider theme="light">
      {children}
    </InterwovenKitProvider>
  )
}

Advanced Configuration

Custom Message Types

For applications that use custom transaction types beyond the standard Cosmos and Initia modules, you’ll need to configure protobuf types and amino converters.

protoTypes · Iterable<[string, GeneratedType]>

Protobuf message types for custom transaction signing. Only required when using message types not included in default modules.

import type { GeneratedType } from "@cosmjs/proto-signing"
import { MsgCustomAction } from "./codec/myapp/tx"

const protoTypes = [
  ["/myapp.MsgCustomAction", MsgCustomAction],
] as const

export default function Providers() {
  return (
    <InterwovenKitProvider protoTypes={protoTypes}>
      {children}
    </InterwovenKitProvider>
  )
}

aminoConverters · AminoConverters

Amino converters for encoding/decoding custom messages. Required for Amino-compatible messages not covered by default converters.

import type { AminoConverters } from "@cosmjs/stargate"

const aminoConverters: AminoConverters = {
  "/myapp.MsgCustomAction": {
    aminoType: "myapp/MsgCustomAction",
    toAmino: (msg) => ({
      creator: msg.creator,
      data: msg.data,
    }),
    fromAmino: (amino) => ({
      creator: amino.creator,
      data: amino.data,
    }),
  },
}

export default function Providers() {
  return (
    <InterwovenKitProvider aminoConverters={aminoConverters}>
      {children}
    </InterwovenKitProvider>
  )
}

Testnet Configuration

Infrastructure Endpoints

The following props are automatically configured for Initia’s mainnet infrastructure and typically don’t need to be set for rollup configurations:

registryUrl · string

URL for the chain registry service

routerApiUrl · string

URL for the router API service

usernamesModuleAddress · string

Contract address for the usernames module

Testnet Setup

For testnet development, use the exported TESTNET constant which automatically configures all required endpoints:

// providers.tsx
import { InterwovenKitProvider, TESTNET } from "@initia/interwovenkit-react"

export default function Providers() {
  return (
    <InterwovenKitProvider {...TESTNET}>
      {children}
    </InterwovenKitProvider>
  )
}