Skip to main content

​
Queries

All read operations use the XYZClient returned by createClient(). No wallet connection is needed for queries.

​
Setup

import { createClient } from "@xyz-chain/sdk";

const client = await createClient({
  rpcEndpoint: "http://67.205.164.156:26657",
});

​
Native Balance

import { getBalance, getAllBalances, formatXYZ } from "@xyz-chain/sdk";

// Get XYZ balance
const balance = await getBalance(client, "xyz1...");
console.log(balance.denom);              // "uxyz"
console.log(balance.amount);             // "1500000000" (raw)
console.log(formatXYZ(balance.amount));  // "1500" (human-readable)

// Get all token balances
const allBalances = await getAllBalances(client, "xyz1...");
for (const coin of allBalances) {
  console.log(coin.denom, coin.amount);
}

​
CW20 Token Balance

import { getTokenBalance } from "@xyz-chain/sdk";

const balance = await getTokenBalance(
  client,
  "xyz1...contract",  // CW20 token contract address
  "xyz1...owner"       // Wallet address to check
);
console.log(balance);  // "5000000" (in micro-units)

​
CW20 Token Info

import { getTokenInfo, getFormattedTokenInfo } from "@xyz-chain/sdk";

// Raw token info
const info = await getTokenInfo(client, "xyz1...contract");
console.log(info.name);          // "My Token"
console.log(info.symbol);        // "MTK"
console.log(info.decimals);      // 6
console.log(info.total_supply);  // "100000000000000"

// Formatted with human-readable values
const formatted = await getFormattedTokenInfo(client, "xyz1...contract");
console.log(formatted);  // includes human-readable supply, etc.

​
Token Marketing Info

import { getTokenMarketingInfo } from "@xyz-chain/sdk";

const marketing = await getTokenMarketingInfo(client, "xyz1...contract");
if (marketing) {
  console.log(marketing.project);      // Project name
  console.log(marketing.description);  // Token description
  console.log(marketing.logo);         // Logo URL or embedded data
}

​
Generic Contract Queries

Query any CosmWasm contract with arbitrary messages: 
import { queryContract } from "@xyz-chain/sdk";

// Query a launchpad contract
const curve = await queryContract(client, launchpadAddress, {
  curve: { token_address: "xyz1...token" },
});
console.log(curve.current_price);
console.log(curve.tokens_sold);

// Query an AMM contract
const pool = await queryContract(client, ammAddress, {
  pool: { token_address: "xyz1...token" },
});
console.log(pool.xyz_reserve);
console.log(pool.price);

​
Contract Info

import { getContractInfo } from "@xyz-chain/sdk";

const info = await getContractInfo(client, "xyz1...contract");
console.log(info.codeId);    // Code ID the contract was instantiated from
console.log(info.creator);   // Address that deployed the contract
console.log(info.admin);     // Admin address (if set)
console.log(info.label);     // Human-readable label

​
Chain Info

// These methods are on the client directly
const chainId = await client.getChainId();  // "xyz-1"
const height = await client.getHeight();    // Current block height

​
CW20 Allowance

import { getCW20Allowance } from "@xyz-chain/sdk";

const allowance = await getCW20Allowance(
  client,
  "xyz1...token",    // CW20 contract
  "xyz1...owner",    // Token owner
  "xyz1...spender"   // Authorized spender
);
console.log(allowance.allowance);  // "1000000"
console.log(allowance.expires);    // Expiration info

​
Next Steps

Transactions

Send tokens and execute contracts

Wallets

Connect Keplr, Leap, or XYZ Wallet