RUJI Product Integration Guides

Technical documentation for integrating Rujira Network products into your application.

Available Guides

Money Market

Integrate lending and borrowing functionality with native assets (BTC, ETH, XRP, DOGE, BCH, LTC and more) powered by Rujira and 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 monitors at-risk positions, calculates optimal liquidation routes, and executes liquidations to earn the 0.5% executor fee.

---

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://rpc.ninerealms.com
gRPC	https://grpc-thorchain.rorcual.xyz
REST	https://api-thorchain.rorcual.xyz/

THORChain Stagenet

Type	URL
RPC	https://stagenet-rpc.ninerealms.com
gRPC	stagenet-grpc.ninerealms.com:443

Rujira APIs

Environment	URL
Mainnet GraphQL	https://api.rujira.network/api/graphiql
Stagenet GraphQL	https://api-preview.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:

• 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