TypeScript SDK

The Monaco SDK requires a Viem wallet client and network configuration. This page covers installation, SDK initialization, configuration options, and best practices.

Installation

npm install @0xmonaco/core @0xmonaco/types

pnpm add @0xmonaco/core @0xmonaco/types

yarn add @0xmonaco/core @0xmonaco/types

Basic Initialization

Monaco needs a Viem walletClient configured for Sei mainnet. You can create that client from an injected browser wallet, WalletConnect, a local private key, or any other Viem-supported wallet setup. See the Viem Wallet Client docs for the full set of options.

import { MonacoSDK } from "@0xmonaco/core";
import { createWalletClient, custom } from "viem";
import { sei } from "viem/chains";

const [account] = await window.ethereum!.request({
  method: "eth_requestAccounts",
});

const walletClient = createWalletClient({
  account,
  chain: sei,
  transport: custom(window.ethereum!)
});

const sdk = new MonacoSDK({
  walletClient,
  network: "mainnet",
  seiRpcUrl: "https://evm-rpc.sei-apis.com", // Required: Your Sei RPC endpoint
});

import { MonacoSDK } from "@0xmonaco/core";
import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { sei } from "viem/chains";

const account = privateKeyToAccount("0x...");
const walletClient = createWalletClient({
  account,
  chain: sei,
  transport: http()
});

// Initialize SDK
const sdk = new MonacoSDK({
  walletClient,
  network: "mainnet",
  seiRpcUrl: "https://evm-rpc.sei-apis.com", // Required: Your Sei RPC endpoint
});

Configuration Options

WalletClient

required

Viem wallet client for signing transactions and messages. Must be configured with a valid account and chain.

string

required

Required (v0.4.0+): Sei blockchain RPC endpoint URL. Each application should configure their own RPC provider to avoid rate limits. The public Sei RPC is https://evm-rpc.sei-apis.com. For production traffic, use a dedicated RPC provider like Ankr, GetBlock, or AllThatNode.

Network

required

Set this to "mainnet". Selects the chain (Sei mainnet) and the default API and WebSocket URLs. Use "staging" for Testnet. The SDK type also supports internal presets, but public docs intentionally cover only public endpoints.

number

Optional. Poll interval, in milliseconds, for the SDK’s internal viem public client when it waits on transaction receipts. Defaults to 200ms, about half a Sei block (viem’s own default is 4000ms), so sdk.vault.deposit and sdk.waitForTransaction resolve within about half a block of mining. Must be a positive finite number, otherwise the SDK throws InvalidConfigError on construction. Set it to 750 to keep the previous SDK default.

RequestSigning

Optional. Which protocol signs authenticated REST requests: "legacy" (the default) sends the X-Monaco-* headers, "rfc9421" sends RFC 9421 HTTP message signatures. Both use the same session key, and WebSocket and gRPC authentication are unaffected either way. There is no automatic downgrade, so select "rfc9421" only against a gateway that verifies it. In RFC mode the SDK requires a string request body, disables redirect following on authenticated requests, and throws if the caller supplies a signature header itself. See HTTP message signatures.

Network Configurations

The SDK automatically configures API and WebSocket endpoints based on the network parameter:

Mainnet

const sdk = new MonacoSDK({
  walletClient,
  network: "mainnet",
  seiRpcUrl: "https://evm-rpc.sei-apis.com",
});

Chain: Sei mainnet (pacific-1)
Chain ID: 1329
API: https://apimonaco.xyz
WebSocket: Auto-resolved from network

RPC Provider Options

seiRpcUrl points the SDK at Sei for on-chain reads and transaction confirmation. In production code, source seiRpcUrl from an environment variable rather than hardcoding it.

SDK Instance Properties

Once initialized, the SDK exposes these APIs:

const sdk = new MonacoSDK({
  walletClient,
  network: "mainnet",
  seiRpcUrl: "https://evm-rpc.sei-apis.com",
});

// API instances
sdk.auth           // Authentication operations
sdk.applications   // Application config
sdk.fees           // Fee simulation and queries
sdk.vault          // Vault operations (deposits/withdrawals)
sdk.trading        // Trading operations (orders)
sdk.market         // Market data queries
sdk.profile        // User profile and account info
sdk.trades         // Trade history queries
sdk.orderbook      // Orderbook snapshots
sdk.withdrawals    // Low-level withdrawal calldata (no broadcast)
sdk.subAccounts    // Master-account sub-accounts

// WebSocket client (v0.5.0+)
sdk.ws             // Unified WebSocket client (auto-connects on init)
sdk.ws.orders()    // Subscribe to order events (requires auth)
sdk.ws.orderbook() // Subscribe to orderbook updates
sdk.ws.ohlcv()     // Subscribe to candlestick data
sdk.ws.trades()    // Subscribe to trade events
sdk.ws.movements() // Subscribe to balance movements (requires auth)

// Blockchain clients
sdk.walletClient   // Viem wallet client
sdk.publicClient   // Viem public client

// Utility methods
sdk.isConnected()       // Check if wallet is connected
sdk.isAuthenticated()   // Check if user is logged in
sdk.getAccountAddress() // Get current wallet address
sdk.getNetwork()        // Get current network name
sdk.getChainId()        // Get current chain ID
sdk.setWalletClient(walletClient) // Swap the wallet client; throws InvalidConfigError on a chain mismatch
sdk.waitForTransaction(hash) // Wait for tx confirmation

SDK Utility Methods

() => boolean

Check if the SDK has a valid wallet connection

() => boolean

Check if the user has a valid authentication session

() => string

Get the current wallet address. Throws InvalidStateError if no account is connected.Error Handling:

import { InvalidStateError } from "@0xmonaco/core";

try {
  const address = sdk.getAccountAddress();
  console.log("Wallet address:", address);
} catch (error) {
  if (error instanceof InvalidStateError) {
    console.error("No wallet connected");
    // Prompt user to connect wallet
  } else {
    throw error;
  }
}

Best Practice: Use isConnected() before calling:

if (sdk.isConnected()) {
  const address = sdk.getAccountAddress();
} else {
  console.warn("No wallet connected");
}

() => Network

Get the current network name, for example 'mainnet'

() => number

Get the current blockchain chain ID (1329 for Sei mainnet)

(hash: string, confirmations?: number, timeout?: number) => Promise<TransactionReceipt>

Wait for a transaction to be confirmed on-chainParameters:

hash: Transaction hash to wait for
confirmations?: Number of confirmations required (optional)
timeout?: Timeout in milliseconds (optional)

Returns: Viem TransactionReceipt

Learn

Build

Libraries

APIs

Resources

Installation

Basic Initialization

Configuration Options

Network Configurations

RPC Provider Options

SDK Instance Properties

SDK Utility Methods

​Installation

​Basic Initialization

​Configuration Options

​Network Configurations

​RPC Provider Options

​SDK Instance Properties

​SDK Utility Methods

Installation

Basic Initialization

Configuration Options

Network Configurations

RPC Provider Options

SDK Instance Properties

SDK Utility Methods