readContract() — SocketFi Read-Only Contract Call

readContract(req: ReadContractRequest): Promise<unknown>

const balance = await socketfi.readContract({
  contractId: TOKEN_CONTRACT,
  method: 'balance',
  args: [walletAddress],
}) as bigint;

import { socketfi } from '@/lib/socketfi';

const balance = await socketfi.readContract({
  contractId: process.env.NEXT_PUBLIC_TOKEN_CONTRACT!,
  method: 'balance',
  args: ['GDZX_WALLET_ADDRESS_HERE'],
}) as bigint;

console.log('Balance (stroops):', balance.toString());

const metadata = await socketfi.readContract({
  contractId: process.env.NEXT_PUBLIC_TOKEN_CONTRACT!,
  method: 'token_metadata',
}) as { name: string; symbol: string; decimals: number };

console.log(`${metadata.name} (${metadata.symbol}), decimals: ${metadata.decimals}`);

interface PoolState {
  totalStaked: bigint;
  rewardRate: bigint;
  lastUpdated: number;
}

const pool = await socketfi.readContract({
  contractId: STAKING_CONTRACT,
  method: 'get_pool_state',
}) as PoolState;

console.log('Total staked:', pool.totalStaked.toString());

const allowance = await socketfi.readContract({
  contractId: TOKEN_CONTRACT,
  method: 'allowance',
  args: [ownerAddress, spenderAddress],
}) as bigint;

async function transferTokens(recipient: string, amount: bigint) {
  // Check balance before opening the transaction popup
  const balance = await socketfi.readContract({
    contractId: TOKEN_CONTRACT,
    method: 'balance',
    args: [userWalletAddress],
  }) as bigint;

  if (balance < amount) {
    throw new Error('Insufficient balance');
  }

  // Only now open the transaction approval popup
  return socketfi.requestTransaction({
    contractId: TOKEN_CONTRACT,
    method: 'transfer',
    args: [recipient, amount.toString()],
  });
}

interface ReadContractRequest {
  contractId: string;
  method: string;
  args?: unknown[];
}