Skip to main content
MoonKey provides comprehensive wallet infrastructure for two major blockchain ecosystems: Ethereum and Solana. These chains receive full native support with complete functionality across all MoonKey features.

Fully supported chains

MoonKey offers complete, production-ready support for the following blockchain ecosystems:

What “fully supported” means

Chains with full MoonKey support include:

Complete wallet functionality

  • Create and manage embedded wallets
  • Automatic wallet creation on user login
  • Manual wallet creation when needed
  • Private key export for maximum portability

Transaction capabilities

  • Sign messages for authentication and verification
  • Sign transactions without broadcasting
  • Send transactions with automatic broadcasting
  • Full support for smart contract interactions

User experience features

  • Pre-built, customizable UI components
  • Headless APIs for custom interfaces
  • Real-time transaction status
  • Clear error messages and handling

Developer tools

  • React SDK with TypeScript support
  • REST API for server-side operations
  • Comprehensive documentation
  • Code examples and guides

Ethereum ecosystem

MoonKey provides native support for Ethereum and the entire EVM ecosystem:

Mainnet networks

  • Ethereum - Ethereum mainnet
  • Base - Coinbase’s L2 solution
  • Arbitrum - Optimistic rollup L2
  • Optimism - Another optimistic rollup
  • Polygon - Fast and low-cost EVM sidechain
  • And more - Any EVM-compatible network

Testnets

  • Sepolia - Ethereum testnet
  • Base Sepolia - Base testnet
  • Arbitrum Sepolia - Arbitrum testnet
  • Other testnets - All major EVM testnets

Configuration

Configure EVM networks in your MoonKey provider:
import { MoonKeyProvider } from '@moon-key/react-auth';
import { base, arbitrum, polygon } from 'viem/chains';

<MoonKeyProvider
  publishableKey="your_publishable_key"
  config={{
    supportedChains: [base, arbitrum, polygon]
  }}
>
  {children}
</MoonKeyProvider>
Learn more about configuring EVM networks.

Solana ecosystem

MoonKey offers complete support for Solana and SVM-compatible networks:

Networks

  • Mainnet Beta - Solana production network
  • Devnet - Development and testing network
  • Testnet - Public testing network
  • Custom SVM - Other SVM-compatible chains

Configuration

Configure Solana networks with custom RPC endpoints:
import { MoonKeyProvider } from '@moon-key/react-auth';

<MoonKeyProvider
  publishableKey="your_publishable_key"
  config={{
    solana: {
      rpcs: {
        'solana:mainnet': {
          rpc: 'https://api.mainnet-beta.solana.com',
          rpcSubscriptions: 'wss://api.mainnet-beta.solana.com'
        },
        'solana:devnet': {
          rpc: 'https://api.devnet.solana.com',
          rpcSubscriptions: 'wss://api.devnet.solana.com'
        }
      }
    }
  }}
>
  {children}
</MoonKeyProvider>
Learn more about configuring Solana networks.

Features by chain

Both Ethereum and Solana ecosystems receive identical feature support:
FeatureEthereum/EVMSolana/SVM
Embedded wallets
Automatic creation
Sign messages
Sign transactions
Send transactions
Export private key
UI components
REST API
Custom RPC

Custom networks

Both Ethereum and Solana support custom networks:

Custom EVM networks

Add any EVM-compatible network using viem’s defineChain:
import { defineChain } from 'viem';

const customChain = defineChain({
  id: 12345,
  name: 'Custom Chain',
  network: 'custom',
  nativeCurrency: {
    decimals: 18,
    name: 'Custom Token',
    symbol: 'CTK',
  },
  rpcUrls: {
    default: {
      http: ['https://custom-rpc-url.com'],
    },
  },
  blockExplorers: {
    default: {
      name: 'Explorer',
      url: 'https://explorer.custom-chain.com',
    },
  },
});

Custom SVM networks

Connect to custom SVM-compatible networks with custom RPC endpoints:
import { Connection } from '@solana/web3.js';

const connection = new Connection('https://custom-svm-rpc.com');

Choosing your blockchain

When building with MoonKey, consider these factors:
  • DeFi applications - Largest DeFi ecosystem
  • NFT marketplaces - Most NFT activity
  • Smart contracts - Mature tooling and libraries
  • Institutional adoption - Widely recognized
  • L2 solutions - Fast and cheap with Base, Arbitrum, etc.
  • High performance - Fast transaction speeds
  • Low costs - Minimal transaction fees
  • Gaming - Real-time blockchain gaming
  • NFT minting - Fast and affordable minting
  • Payment applications - Micropayments and instant transfers

Future chain support

MoonKey’s architecture is designed to support additional blockchains in the future. We’re continuously evaluating new chains and ecosystems to add to our platform.
Interested in support for a specific blockchain? Contact us to discuss your requirements.

Best practices

  • Develop on testnets (Sepolia, Devnet)
  • Test thoroughly before mainnet deployment
  • Use separate API keys for test and production
  • Use reliable RPC providers (Alchemy, QuickNode, etc.)
  • Consider rate limits for free RPC endpoints
  • Set up fallback RPC URLs for reliability
  • Allow users to switch chains easily
  • Show current chain clearly in your UI
  • Handle transactions for the correct chain
  • Test wallets on both Ethereum and Solana
  • Verify proper chain isolation
  • Test network switching flows

Getting started