Optional indexing

// Default: on-chain features, no indexer requests.
const ctoken = new CTokenClient({ network: "baseSepolia", publicClient, walletClient });

// Opt in to Inco's hosted Base Sepolia service.
const withHistory = new CTokenClient({
  network: "baseSepolia", publicClient, walletClient, indexer: true,
});

// Opt in to your compatible service. The URL is a base prefix, not a route.
const custom = new CTokenClient({
  network: "baseSepolia", publicClient, walletClient,
  indexer: { url: "https://your-indexer.example/api", timeoutMs: 15_000 },
});

<CTokenProvider network="baseSepolia" publicClient={publicClient} indexer>
  <ConfidentialWallet />
</CTokenProvider>

<CTokenProvider network="baseSepolia" publicClient={publicClient}
  indexer={{ url: "https://your-indexer.example/api" }}>
  <ConfidentialWallet />
</CTokenProvider>

const controller = new AbortController();
const page = await ctoken.history({
  address: owner, page: 2, limit: 20, signal: controller.signal,
});
const prices = await ctoken.prices([USDC], { signal: controller.signal });
const usd = prices.prices[USDC.toLowerCase()]?.usd;
// controller.abort() cancels outstanding requests using this signal.

type TxPage = {
  items: Tx[];
  total: number;
  page: number;
  pages: number;
  limit: number;
};

type Tx = {
  type: "transfer" | "flow";
  token: string;             // cToken
  symbol: string;
  decimals: number;
  kind: string;
  from_addr: string | null;
  to_addr: string | null;
  handle: string | null;
  amount: string | null;     // integer base units, public flow only
  block_number: string;
  block_time?: string;      // Unix seconds; raw API null becomes undefined
  log_index?: number;
  tx_hash: string;
};

type Prices = {
  chainId: number;
  ttl: number;               // seconds
  count: number;
  prices: Record<string, {
    usd: number;
    confidence: number | null;
    source: string;
    updated_at: number;     // Unix seconds
    stale: boolean;
  }>;
};