@arks-labs/sdk

Internal development SDK for ARKS Labs — shared utilities for Cygnus protocol integration.

Features

• Multi-chain protocol stats (multicall batched)
• Batch token balance queries
• Exchange rate tracking (cgUSD/share)
• USD formatting utilities
• Pre-configured contract addresses & ABIs
• Fallback RPC endpoints per chain

Installation

npm install @arks-labs/sdk viem

Usage

import { CygnusProtocol, ADDRESSES, CHAINS } from '@arks-labs/sdk'

// Protocol overview
const protocol = new CygnusProtocol()
const stats = await protocol.getProtocolStats()
console.log(stats)
// { totalSupply: '$76,202,633.81', totalPooledAssets: '$76,202,633.81', ... }

// User balances (multicall batched)
const balances = await protocol.getUserBalances('0x...')
balances.forEach(b => console.log(`${b.symbol}: ${b.formatted}`))

// Exchange rate
const rate = await protocol.getExchangeRate()
console.log(`1 share = ${rate.toFixed(6)} cgUSD`)

Configuration

import { ADDRESSES, CHAINS, RPC_ENDPOINTS, TOKENS } from '@arks-labs/sdk'

// Contract addresses
console.log(ADDRESSES.base.cgUSD) // 0xCa72...

// Chain configs
console.log(CHAINS.base.rpcUrl) // https://mainnet.base.org

// Fallback RPCs
console.log(RPC_ENDPOINTS.base) // ['https://mainnet.base.org', ...]

License

MIT