Reserve DTF SDK

TypeScript monorepo for Reserve DTF SDK packages.

Packages

• @reserve-protocol/sdk: Core environment-agnostic SDK for Node and browser/React consumers.
• @reserve-protocol/react-sdk: React Query hooks and providers on top of the core SDK.
• @reserve-protocol/dtf-catalog: Curated Yield DTF and Index DTF catalog, exported as chain maps like the old @reserve-protocol/rtokens package.

Design Goal

This SDK is intentionally more opinionated than low-level libraries like viem. It should make common DTF workflows easy for apps, bots, scripts, and server code while still allowing advanced callers to prioritize custom RPC URLs, pass explicit viem clients, override subgraph URLs, and replace the few API-backed providers that need replacement.

Implemented SDK product surface:

• Index DTFs on Ethereum mainnet, Base, and BSC: discovery, live/historical reads, issuance, rebalances and auctions, governance, vote-lock, deploy/proposal/transaction builders, and React Query hooks.
• Yield DTFs on Ethereum mainnet and Base: reads, issuance, staking, governance, auctions/revenue, APY, proposal builders, and React Query hooks.
• Account portfolio API reads: current portfolio, historical portfolio, and transactions.
• Curated Index/Yield DTF catalog and token lists.

The core rule is:

Namespace methods are the public SDK surface. The client holds runtime configuration. Transports stay small. Defaults make the SDK easy to use.

Read docs/sdk/architecture.md before adding large features. The current codebase audit and Register integration order live in docs/SDK_AUDIT_2026-07-09.md.

Commands

pnpm install
pnpm build
pnpm typecheck
pnpm test
pnpm docs:links
pnpm release:ci

pnpm release:ci runs typecheck, lint/format, live-schema GraphQL codegen freshness, tests, builds (including the docs site and SDK bundle budget), documentation/catalog checks, and package dry-runs for all publishable packages.

Quick Example

import { createDtfSdk } from "@reserve-protocol/sdk";

const sdk = createDtfSdk();

const index = await sdk.index.get({
  address: "0x...",
  chainId: 8453,
});

const proposals = await sdk.index.getProposals({
  address: "0x...",
  chainId: 8453,
});

Advanced callers can create a client to prioritize custom RPC URLs and override API defaults:

import { createDtfSdk } from "@reserve-protocol/sdk";

const sdk = createDtfSdk({
  apiBaseUrl: "https://api.reserve.org",
  chains: {
    1: {
      rpcUrls: ["https://eth-mainnet.example"],
    },
  },
});

const dtfs = await sdk.index.list({ chainId: 1 });