Midnight Wallet Kit

Production-grade wallet integration kit for the Midnight Network. Supports ALL major wallets in the Midnight ecosystem with a unified, type-safe API.

🎯 Supported Wallets

| Wallet | Type | Dust-Free | Shielded Balances | Networks | Install | |--------|------|-----------|-------------------|----------|--------| | 1AM | Midnight-Native | ✅ | ✅ | preview, preprod, mainnet | Chrome | | Nocturne | Midnight-Native | ❌ | ✅ | preview, preprod, mainnet | GitHub | | NuFi | CIP-30 | ❌ | ❌ | preview, preprod, mainnet | Website | | GeroWallet | CIP-30 | ❌ | ❌ | preview, preprod, mainnet | Website | | VESPR | CIP-30 | ❌ | ❌ | preview, preprod, mainnet | Website | | Yoroi | CIP-30 | ❌ | ❌ | preview, preprod, mainnet | Website | | Ctrl | CIP-30 | ❌ | ❌ | preview, preprod, mainnet | Website | | SubWallet | CIP-30 | ❌ | ❌ | preview, preprod, mainnet | Website |

🚀 Key Features

• 🛡️ Resilient Probing: Exhaustively searches for working RPC methods across different provider standards
• 🔐 Dust-Free Execution: 1AM wallet + ProofStation sponsors all fees (zero dust needed)
• 🏗️ Safe Intent Builder: Automatic sanitization and Zod-backed validation
• ⚛️ First-Class React Support: Hooks (useWallet, useConnect, useIntent, useBalance)
• 📋 Wallet Registry: Pre-configured registry of all 8 supported wallets
• 🧪 Simplified Unit Testing: Mock adapter included

📦 Install

npm install midnight-wallet-kit

⚡ Quick Start (Easiest Way)

import { createMidnightWalletManager } from 'midnight-wallet-kit';

// Creates a manager with ALL 8 wallets pre-registered
const manager = createMidnightWalletManager({
  network: 'preprod', // default network for Midnight-native wallets
});

// Connect to the first available wallet (tries 1AM → Nocturne → NuFi → ...)
await manager.connectWithFallback([
  '1AM',        // Dust-free, best UX
  'Nocturne',   // Midnight-native
  'NuFi',       // Popular multi-chain
  'GeroWallet',
  'VESPR',
  'Yoroi',
  'Ctrl',
  'SubWallet',
]);

🔧 Advanced: Select Specific Wallets

import { createMidnightWalletManager } from 'midnight-wallet-kit';

// Only register specific wallets
const manager = createMidnightWalletManager({
  only: ['1AM', 'NuFi', 'Nocturne'],
});

// Or skip specific wallets
const manager = createMidnightWalletManager({
  skip: ['SubWallet', 'Ctrl'],
});

⚛️ React Integration

import { WalletProvider, useWallet, useConnect, useBalance } from 'midnight-wallet-kit';

function App() {
  return (
    <WalletProvider manager={manager} autoRestore={true}>
      <YourApp />
    </WalletProvider>
  );
}

function YourApp() {
  const { address, isConnected } = useWallet();
  const { connect, disconnect } = useConnect();
  const { balance } = useBalance();

  if (!isConnected) {
    return <button onClick={() => connect('1AM')}>Connect 1AM</button>;
  }

  return (
    <div>
      <p>Address: {address}</p>
      <p>Balance: {balance?.tDUST?.toString() || '0'} tDUST</p>
      <button onClick={disconnect}>Disconnect</button>
    </div>
  );
}

🏗️ 1AM-Specific: Dust-Free Contract Deployment

import { OneAMWalletAdapter, buildOneAMProviders, deployContract } from 'midnight-wallet-kit';

// Connect to 1AM (dust-free execution)
await manager.connect('1AM');
const adapter = manager.getActiveWallet() as OneAMWalletAdapter;

// Build providers (ProofStation sponsors fees)
const providers = await buildOneAMProviders(adapter, {
  zkConfigBaseUrl: 'https://your-app.com/contract/compiled/your-contract',
});

// Deploy contract (zero dust needed!)
const deployed = await deployContract(providers, {
  compiledContract: yourCompiledContract,
});
console.log('Contract deployed:', deployed.contractAddress);

📝 Available Adapters

import {
  OneAMWalletAdapter,      // 1AM - Dust-free
  NocturneWalletAdapter,   // Nocturne - Midnight-native
  NuFiWalletAdapter,        // NuFi
  GeroWalletAdapter,        // GeroWallet
  VesprWalletAdapter,       // VESPR
  YoroiWalletAdapter,       // Yoroi
  CtrlWalletAdapter,        // Ctrl
  SubWalletAdapter,         // SubWallet
  InjectedWalletAdapter,    // Generic CIP-30/Midnight
  MockWalletAdapter,         // Testing
} from 'midnight-wallet-kit';

🧪 Testing

import { MockWalletAdapter } from 'midnight-wallet-kit';

const mockAdapter = new MockWalletAdapter({
  name: 'TestWallet',
  shouldFail: false,
});

📚 Full API Reference

For complete documentation, see DOCS.md.

MIT © 2026 Tushar Pamnani