Overview

The InterwovenKit React API provides components, hooks, and utilities for integrating Initia wallet connections, transaction signing, and UI flows into React applications.

InterwovenKit is designed around a single provider (InterwovenKitProvider) that configures network and UI behavior, with hooks layered on top for state, UI control, and transactions. Most users start by configuring InterwovenKitProvider with a preset (MAINNET or TESTNET), then use hooks like useInterwovenKit or useAddress to read connection state and trigger UI flows. The API is organized into:

• Components: React providers and UI components (InterwovenKitProvider)
• Hooks: React hooks for connection state, transactions, and data (useInterwovenKit, useAddress, usePortfolio, etc.)
• Utilities: Helper functions (injectStyles)
• Errors: Error types thrown by the API (MoveError)
• Constants: Configuration presets and default values (MAINNET, TESTNET, gas constants, PRIVY_APP_ID)
• Social Login: Wagmi and RainbowKit helpers for social login (initiaPrivyWalletConnector, initiaPrivyWallet)

Common Starting Points

• Provider setup: See Provider Setup for complete configuration (basic setup or AutoSign)
• Initial setup: InterwovenKitProvider with MAINNET or TESTNET
• Inject styles: Call injectStyles before rendering InterwovenKit UI components
• Read connection state: useAddress or useInterwovenKit
• Open UI flows: useInterwovenKit (openConnect, openWallet, openBridge)
• Send transactions: useInterwovenKit (requestTxBlock, submitTxBlock)

If you are new to InterwovenKit, start with InterwovenKitProvider and useInterwovenKit. Everything else builds on top of those two APIs.