Imports

All public clients can be imported from the main SDK package.

import {
  createInfoClient,
  createExchangeClient,
  createDepositClient,
  createExchangeWebSocketClient,
  createOracleWebSocketClient,
} from "@gammaswap/v2-exchange-sdk";

Client imports

InfoClient

import { createInfoClient } from "@gammaswap/v2-exchange-sdk";

Use InfoClient for unsigned, read-only HTTP requests.

const info = createInfoClient({
  apiUrl: "https://exchange-api.gammaswap.com/api",
});

ExchangeClient

import { createExchangeClient } from "@gammaswap/v2-exchange-sdk";
import { Wallet } from "ethers";

Use ExchangeClient for wallet-signed exchange actions.

const wallet = new Wallet(process.env.PRIVATE_KEY!);

const exchange = createExchangeClient({
  apiUrl: "https://exchange-api.gammaswap.com/api",
  wallet,
  chainId: "84532",
});

DepositClient

import { createDepositClient } from "@gammaswap/v2-exchange-sdk";
import { Wallet } from "ethers";

Use DepositClient for on-chain deposit reads and transactions.

const wallet = new Wallet(process.env.PRIVATE_KEY!);

const deposit = createDepositClient({
  rpcUrl: process.env.RPC_URL!,
  wallet,
  chainId: "84532",
});

ExchangeWebSocketClient

import {
  createExchangeWebSocketClient,
} from "@gammaswap/v2-exchange-sdk";

Use ExchangeWebSocketClient for live market updates.

const marketStream = createExchangeWebSocketClient({
  websocketUrl: "wss://exchange-api.gammaswap.com/ws/",
  onError: (error) => console.error(error),
});

OracleWebSocketClient

import {
  createOracleWebSocketClient,
} from "@gammaswap/v2-exchange-sdk";

Use OracleWebSocketClient for live oracle prices.

const oracleStream = createOracleWebSocketClient({
  websocketUrl: "wss://exchange-api.gammaswap.com/oracle-ws/",
  onError: (error) => console.error(error),
});

Submodule imports

WebSocket clients can also be imported from their dedicated submodules.

import {
  createExchangeWebSocketClient,
} from "@gammaswap/v2-exchange-sdk/websocket";

import {
  createOracleWebSocketClient,
} from "@gammaswap/v2-exchange-sdk/oracle-websocket";

Input utilities

Integer-input helpers are exported from:

import {
  parseUnsignedInteger,
} from "@gammaswap/v2-exchange-sdk/integer-inputs";

These helpers validate canonical unsigned decimal strings and bigint values.

They reject JavaScript numbers unless a helper explicitly supports safe JSON or runtime integers.

String utilities

Address and hexadecimal-string helpers are exported from:

import {
  parseAddress,
} from "@gammaswap/v2-exchange-sdk/string-inputs";

The string utility module includes validation for:

• EVM addresses

• Non-zero addresses

• Hexadecimal data

• bytes32 values

• Case-insensitive address comparison

Constants

Protocol constants such as time-in-force values can be imported from:

import {
  TimeInForce,
} from "@gammaswap/v2-exchange-sdk/constants";

Example:

await exchange.placeOrder({
  assetId: "261336857817713630688382311349658711122006440411137",
  epoch: "12",
  side: false,
  price: "99.9",
  size: "10.25",
  timeInForce: TimeInForce.GTC,
});