@metalayer/sdk

MetaRouter SDK

A TypeScript SDK for cross-chain interoperability, providing seamless access to anything-to-anything swaps with composable routes, powered by Caldera's Metalayer.

Features

• 🔄 Cross-chain bridges
• 💰 Real-time price quotes
• 🔒 Type-safe with full TypeScript support
• 🌐 Support for multiple blockchain networks
• ⚛️ React hooks for easy frontend integration

Installation

Install the npm package:

pnpm add @metalayer/sdk
# or
npm install @metalayer/sdk
# or
yarn add @metalayer/sdk

Quick Start

import { MetaRouterClient } from '@metalayer/sdk';

const router = MetaRouterClient.init({
  apiKey: 'your-api-key',
  environment: 'development',
  defaultOptions: {
    quotePreference: 'bestReturn',
  },
});

// Get a quote
const quote = await router.quote({
  // ...quote params
});

React Hooks

The SDK provides React hooks for easy integration:

• useQuote
• useTokenRoutes
• useSupportedChains
• useOrderPolling
• useWalletOrders
• MetaRouterProvider (React context provider)

API Reference

MetaRouterClient

Configuration

interface MetaRouterConfig {
  apiKey: string;
  environment: 'production' | 'staging' | 'development';
  defaultOptions?: {
    quotePreference: 'bestReturn' | 'fastest';
  };
}

Methods

• static init(config: MetaRouterConfig): MetaRouterClient
• quote(params: QuotesParams): Promise<QuotesResponse>
• getTokenRoutes(params: TokenRoutesParams): Promise<TokenRoutesResponse>
• getSupportedChains(params: SupportedChainsParams): Promise<SupportedChainsResponse>
• getOrder(params: OrderParams): Promise<OrderResponse>
• getOrders(params: OrdersParams): Promise<OrdersResponse>

Examples

See the example/ directory for full React usage examples, including quotes, token routes, bridge status, and wallet history.

License

See the LICENSE file for details.