CROSSx Wagmi SDK

wagmi v2 compatible CROSSx connector package for seamless integration with the wagmi ecosystem.

What you can do

• Connect CROSSx embedded wallet via standard wagmi connector
• Use all wagmi hooks (useAccount, useBalance, useSendTransaction, etc.)
• Integrate with viem for low-level EVM interactions
• Combine with other wagmi connectors (MetaMask, WalletConnect, etc.)

Quick start path

1. Getting Started Install packages and configure wagmi with CROSSx connector.
2. Authentication Connect / disconnect wallet using wagmi hooks.
3. Wallet Send transactions and sign messages with wagmi hooks.
4. EIP-1193 Provider Understand how wagmi wraps the CROSSx provider.
5. API Reference Check connector options and exported types.

Minimum integration example

import { createConfig, http } from 'wagmi'
import { crossxConnector } from '@nexus-cross/crossx-sdk-wagmi'

export const config = createConfig({
  connectors: [crossxConnector({ projectId: 'YOUR_PROJECT_ID' })],
  chains: [crossMainnet],
  transports: { [crossMainnet.id]: http() },
})

Notes

• Requires wagmi >=2.0.0 and viem >=2.0.0 as peer dependencies.
• The CROSSx connector handles OAuth sign-in and wallet creation internally when connect() is called (via signInWithCreate()).
• All signing/sending operations display a user confirmation modal.