Galactic XC SDK

Wallet interface for executing cross-chain asset transfers. Supports Substrate, EVM, Sui, and Solana platforms, fee swaps, and bridge integrations.

Wallet does not perform any signing — it provides transfer data to maintain loose coupling & interoperability with 3rd party code.

For convenience, the SDK also ships built-in platform signers that can sign & submit the transfer calls.

| Platform | Signer | Wallet / Signer | | --- | --- | --- | | Substrate | SubstrateSigner | PolkadotSigner (polkadot-api) | | EVM | EvmSigner | WalletClient (viem) | | Solana | SolanaSigner | SolanaWallet or Keypair | | Sui | SuiSigner | SuiWallet or Ed25519Keypair |

import { SubstrateSigner } from '@galacticcouncil/xc-sdk';

const signer = new SubstrateSigner(chain, polkadotSigner);
signer.signAndSend(call, {
  onTransactionSend: (hash) => console.log('TxHash:', hash),
  onFinalized: (event) => console.log('Finalized:', event),
  onError: (error) => console.error(error),
});

Installation

Install with npm:

npm install @galacticcouncil/xc-sdk

API

transfer(
    asset: string | Asset,
    srcAddr: string,
    srcChain: string | AnyChain,
    dstAddr: string,
    dstChain: string | AnyChain
  ): Promise<Transfer>
subscribeBalance(
    address: string,
    chain: string | AnyChain,
    observer: (balances: AssetAmount[]) => void
  )

Usage

// Import
import {
  assetsMap,
  chainsMap,
  routesMap,
  dex,
  validations,
} from '@galacticcouncil/xc-cfg';
import { ConfigService, EvmParachain } from '@galacticcouncil/xc-core';
import { Wallet, Call } from '@galacticcouncil/xc-sdk';

// Initialize config service
const configService = new ConfigService({
  assets: assetsMap,
  chains: chainsMap,
  routes: routesMap,
});

// Initialize wallet
const wallet = new Wallet({
  configService: configService,
  transferValidations: validations,
});

Transfer

// Define transfer
const srcChain = configService.getChain('ethereum');
const destChain = configService.getChain('hydration');
const asset = configService.getAsset('eth');

// Define source & dest accounts
const srcAddr = 'INSERT_ADDRESS';
const destAddr = 'INSERT_ADDRESS';

// Subscribe source chain token balance
const balanceObserver = (balances: AssetAmount[]) => console.log(balances);
const balanceSubscription = await wallet.subscribeBalance(
  srcAddr,
  srcChain,
  balanceObserver
);

// Get transfer data
const transfer = await wallet.transfer(
  asset,
  srcAddr,
  srcChain,
  destAddr,
  destChain
);

// Validate transfer
const status = await transfer.validate();

// Estimate fee & construct calldata with transfer amount (1 ETH)
const fee: AssetAmount = await transfer.estimateFee('1');
const feeInfo = [
  'Estimated fee:',
  fee.toDecimal(fee.decimals),
  fee.originSymbol,
].join(' ');
const call: Call = await transfer.buildCall('1');

// Dump transfer info
console.log(transfer);
console.log(status);
console.log(feeInfo);
console.log(call);

// Unsubscribe source chain balance
balanceSubscription.unsubscribe();