RUJI Product Integration Guides

Technical documentation for integrating Rujira Network products into your application.

Available Guides

RUJI Trade and CCL

Integrate RUJI Trade orderbook DEX with native assets (BTC, ETH, SOL, XRP, DOGE, BCH, LTC and more) secured by THORChain - fully decentralized and permissionless.

• Funding Requirement: Secured Assets

  • Deposit native assets into THORChain to get Secured Assets

  • Withdraw Secured Asset back to the source L1

• Trading on RUJI Trade (FIN)

  • Market orders (swap)

  • Limit orders

  • Tracking orders

• Custom Concentrated Liquidity (CCL) Positions

  • Create and manage ranges (fixed-range AMM strategies built directly into FIN)

Money Market

Integrate lending and borrowing functionality with native assets (BTC, ETH, SOL, XRP, DOGE, BCH, LTC and more) secured by THORChain.

• Lending (Ghost Vault)

  • Deposit assets to earn yield

  • Receive transferable receipt tokens

  • Dynamic interest rates based on utilization

• Borrowing (Ghost Credit)

  • Create isolated Credit Accounts

  • Deposit multi-asset collateral

  • Borrow against collateral with overcollateralized loans

Liquidations

• Bidding on Liquidations (for end users)

  • Integrate liquidation bidding into your application, allowing users to acquire collateral at discounted prices when CDP positions are liquidated.

• Build a Liquidation Solver (for developers)

  • Build liquidation bots that monitor at-risk positions, calculates optimal liquidation routes, and executes liquidations to earn the 0.5% executor fee.

Staking

Integrate staking markets powered by the Rujira staking contract, including RUJI, bRUNE and TCY. Allow users to stake and earn rewards from real economic activity. The staking contract supports both Account staking (claimable yield) and Liquid staking (auto-compounding).

---

Quick Reference

Main Supported Assets

Asset	Denom	Decimals
BTC	btc-btc	8
ETH	eth-eth	8
USDC	eth-usdc-0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48	8
USDT	eth-usdt-0xdac17f958d2ee523a2206206994597c13d831ec7	8
BCH	bch-bch	8
DOGE	doge-doge	8
LTC	ltc-ltc	8
XRP	xrp-xrp	8
BNB	bsc-bnb	8
AVAX	avax-avax	8
TRX	tron-trx	8
ATOM	gaia-atom	8

Note: For the full list of supported assets and chains, check THORChain active pools on https://thorchain.net/pools/main.

Network Endpoints

THORChain Mainnet

Type	URL
RPC	https://gateway.liquify.com/chain/thorchain_rpc
gRPC	https://grpc-thorchain.rorcual.xyz
REST	https://gateway.liquify.com/chain/thorchain_api

Rujira APIs

Environment	URL
Mainnet GraphQL	https://api.rujira.network/api/graphiql

---

Development Tools

Libraries

RUJI contracts are standard CosmWasm. Use any Cosmos SDK compatible library:

Language	Library
TypeScript/JavaScript	CosmJS
Rust	cosmwasm-std
Go	Cosmos SDK
Python	cosmpy

Contract Schemas

JSON schemas for all message types are available in each contract's /schema directory:

• RUJI Trade (FIN) Schema

• Ghost Vault Schema

• Ghost Credit Schema

---

Common Patterns

Querying Contract State

import { CosmWasmClient } from "@cosmjs/cosmwasm-stargate";

const client = await CosmWasmClient.connect("https://rpc.ninerealms.com");

// Query any contract
const result = await client.queryContractSmart(
  CONTRACT_ADDRESS,
  { query_msg: { /* params */ } }
);

Executing Transactions

import { SigningCosmWasmClient } from "@cosmjs/cosmwasm-stargate";

const client = await SigningCosmWasmClient.connectWithSigner(
  "https://rpc.ninerealms.com",
  signer
);

// Execute with funds
const result = await client.execute(
  senderAddress,
  CONTRACT_ADDRESS,
  { execute_msg: { /* params */ } },
  "auto",  // gas
  "",      // memo
  [{ denom: "btc-btc", amount: "100000000" }]  // funds
);

Handling Decimals

All amounts use 8 decimal places:

// Convert human-readable to chain format
function toChainAmount(amount: number): string {
  return Math.floor(amount * 1e8).toString();
}

// Convert chain format to human-readable
function fromChainAmount(amount: string): number {
  return parseInt(amount) / 1e8;
}

// Examples:
toChainAmount(1.5);        // "150000000" (1.5 BTC)
fromChainAmount("100000000"); // 1.0 BTC

---

Support

• Documentation: docs.rujira.network

• Telegram: @Rujira_Community

• E-Mail: [email protected]

• Discord: Join