Galactic SDK

Collection of SDK(s) crafted to ease Hydration chain integration. This monorepo contains everything you need to build on Hydration — from low-level pool math to high-level trading SDKs and cross-chain transfer tooling.

Note: The previous @polkadot/api-based toolkit (sdk, xcm-core, xcm-cfg, xcm-sdk) has been moved to galacticcouncil/sdk-legacy.

Table of Contents

• Overview
• Getting Started
• Quick Start — factories for sdk-next & xc
• General — common, descriptors, sdk-next
• XC (Cross-Chain) — xc, xc-core, xc-cfg, xc-sdk, xc-scan
• Math — WASM pool math modules
• Examples
• Contributing

Overview

┌────────────────────────────────────────────────────────────┐
│                         Your dApp                          │
├────────────────────────────────┬───────────────────────────┤
│         « sdk-next »           │         « xc »            │
│         ··············         │         ·······           │
│         Trade routing          │         Cross-chain       │
│         Pool queries           │         Transfers         │
│               │                │                           │
│          ┌────┴──────┐         │                           │
│          │  math-*   │         │                           │
│          │ Pool math │         │                           │
│          │ (WASM)    │         │                           │
│          └───────────┘         │                           │
├───────────────────┬────────────┴───────────────────────────┤
│  « common »       │  « descriptors »                       │
│  ···········      │  ················                      │
│  Shared utils     │  Chain metadata                        │
├───────────────────┴────────────────────────────────────────┤
│                      polkadot-api                          │
│                    Substrate SDK                           │
└────────────────────────────────────────────────────────────┘

All packages are built on the modern Polkadot API (papi).

Getting Started

Prerequisites

• Node.js 25+
• npm 11+

Installation

Pick the packages you need:

# Trading SDK
npm i @galacticcouncil/sdk-next

# Cross-chain transfers
npm i @galacticcouncil/xc

Quick Start

Solo Trading (sdk-next)

import { api, createSdkContext } from '@galacticcouncil/sdk-next';
import { createClient } from 'polkadot-api';

const provider = api.getWs('wss://hydradx-rpc.dwellir.com');
const client = createClient(provider);
const sdk = await createSdkContext(client);

Full docs & API reference →

Solo Cross-Chain (xc)

import { createXcContext } from '@galacticcouncil/xc';

const xc = await createXcContext();

Full docs & API reference →

Combo (sdk-next + xc)

import { api, createSdkContext } from '@galacticcouncil/sdk-next';
import { createXcContext } from '@galacticcouncil/xc';
import { createClient } from 'polkadot-api';

const provider = api.getWs('wss://hydradx-rpc.dwellir.com');
const client = createClient(provider);
const sdk = await createSdkContext(client);
// Shared pool context
const xc = await createXcContext(sdk.ctx.pool);

General

Core packages providing shared utilities, chain metadata, and trading functionality.

Package	Version	Changelog	Description
@galacticcouncil/common		changelog	Shared utilities (helpers, evm, xcm)
@galacticcouncil/descriptors		changelog	Hydration papi type-safe metadata descriptors
@galacticcouncil/sdk-next		changelog	Trade router & pool utilities (polkadot-api)

XC (Cross-Chain)

Cross-chain transfer toolkit built on polkadot-api. Modular architecture with clean separation between core types, configuration, and wallet interface.

Package	Version	Changelog	Description
@galacticcouncil/xc		changelog	High-level context factory (batteries-included)
@galacticcouncil/xc-core		changelog	Core types, asset & chain definitions
@galacticcouncil/xc-cfg		changelog	Pre-built route configs & DEX integrations
@galacticcouncil/xc-sdk		changelog	Wallet interface for multi-platform transfers
@galacticcouncil/xc-scan		changelog	Cross-chain transaction scanning

Architecture

@galacticcouncil/xc          <- Start here (context factory, DEX factory)
├── @galacticcouncil/xc-sdk  <- Wallet, transfers, fee swaps
├── @galacticcouncil/xc-cfg  <- Route configs, DEX implementations
└── @galacticcouncil/xc-core <- Core types, chain & asset definitions

Math

WebAssembly math modules compiled from Rust. Each module provides high-performance, deterministic calculations for a specific Hydration pool type. These are standalone packages with zero JS dependencies.

Package	Version	Changelog	Pool Type
@galacticcouncil/math-omnipool		changelog	Omnipool — single-sided unified liquidity
@galacticcouncil/math-stableswap		changelog	Stableswap — low-slippage stable asset trading
@galacticcouncil/math-xyk		changelog	XYK — constant product AMM
@galacticcouncil/math-lbp		changelog	LBP — liquidity bootstrapping pool
@galacticcouncil/math-hsm		changelog	HSM — isolated multi-pool
@galacticcouncil/math-ema		changelog	EMA — exponential moving average oracle
@galacticcouncil/math-staking		changelog	Staking reward calculations
@galacticcouncil/math-liquidity-mining		changelog	Liquidity mining reward calculations

Note: You typically don't need to install math packages directly — they are dependencies of sdk-next.

Examples

Ready-to-run examples are available in the examples/ directory:

Example	Description
sdk-next-cjs	SDK-Next usage with CommonJS
sdk-next-esm	SDK-Next usage with ES Modules
xc-transfer	XC cross-chain transfer

Contributing

Everything about building, setting up development environment & releasing can be found in CONTRIBUTING.md.

Issue Reporting

In case of unexpected SDK behaviour, please create a well-written issue here. It makes it easier to find & fix the problem accordingly.

Legal

This file is part of https://github.com/galacticcouncil/*

               $$$$$$$      Licensed under the Apache License, Version 2.0 (the "License")
            $$$$$$$$$$$$$        you may only use this file in compliance with the License
         $$$$$$$$$$$$$$$$$$$
                     $$$$$$$$$       Copyright (C) 2021-2024  Intergalactic, Limited (GIB)
        $$$$$$$$$$$   $$$$$$$$$$                       SPDX-License-Identifier: Apache-2.0
     $$$$$$$$$$$$$$$$$$$$$$$$$$
  $$$$$$$$$$$$$$$$$$$$$$$        $                      Built with <3 for decentralisation
 $$$$$$$$$$$$$$$$$$$        $$$$$$$
 $$$$$$$         $$$$$$$$$$$$$$$$$$      Unless required by applicable law or agreed to in
  $       $$$$$$$$$$$$$$$$$$$$$$$       writing, software distributed under the License is
     $$$$$$$$$$$$$$$$$$$$$$$$$$        distributed on an "AS IS" BASIS, WITHOUT WARRANTIES
     $$$$$$$$$   $$$$$$$$$$$         OR CONDITIONS OF ANY KIND, either express or implied.
       $$$$$$$$
         $$$$$$$$$$$$$$$$$$            See the License for the specific language governing
            $$$$$$$$$$$$$                   permissions and limitations under the License.
               $$$$$$$
                                                                $$
 $$$$$   $$$$$                    $$                      $$
  $$$     $$$  $$$     $$   $$$$$ $$  $$$ $$$$  $$$$$$$  $$$$  $$$    $$$$$$   $$ $$$$$$
  $$$     $$$   $$$   $$  $$$    $$$   $$$  $  $$     $$  $$    $$  $$     $$$  $$$   $$$
  $$$$$$$$$$$    $$  $$   $$$     $$   $$        $$$$$$$  $$    $$  $$     $$$  $$     $$
  $$$     $$$     $$$$    $$$     $$   $$     $$$     $$  $$    $$  $$$     $$  $$     $$
 $$$$$   $$$$$     $$      $$$   $$$   $$     $$$$   $$$  $$    $$   $$$   $$   $$    $$$
                  $$         $$$$$               $$$$$     $$          $$$$
                $$$

For more details read LICENSE.md