@reserve-protocol/dtf-sdk 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,546 @@
+import type { Address, Hex } from 'viem';
+export type SupportedChainId = 1 | 56 | 8453;
+export type PriceControl = 0 | 1 | 2;
+export type RebalanceControl = {
+    weightControl: boolean;
+    priceControl: PriceControl;
+};
+export type BasketToken = {
+    address: Address;
+    symbol: string;
+    decimals: number;
+};
+export type GovernanceConfig = {
+    address: Address;
+    timelockAddress: Address;
+    votingDelay: number;
+    votingPeriod: number;
+    executionDelay: number;
+};
+export type DtfOnchainConfig = {
+    tokens: BasketToken[];
+    auctionLength: number;
+    ownerGovernance: GovernanceConfig | null;
+    tradingGovernance: GovernanceConfig | null;
+    stTokenGovernance: GovernanceConfig | null;
+    stTokenAddress: Address | null;
+    mandate: string;
+    tvlFee: string;
+    mintingFee: string;
+    auctionLaunchers: Address[];
+    brandManagers: Address[];
+};
+export type DtfRoles = {
+    isAdmin: boolean;
+    isRebalanceManager: boolean;
+    isAuctionLauncher: boolean;
+    isBrandManager: boolean;
+};
+export type BasketInfo = {
+    tokens: BasketToken[];
+    balances: bigint[];
+    totalSupply: bigint;
+};
+export type DtfBasketAsset = {
+    address: string;
+    symbol?: string;
+    amount: number;
+    amountRaw: string;
+    decimals: number;
+    price: number;
+    weight: string;
+    priceSource?: string;
+};
+export type DtfBasketResponse = {
+    price: number;
+    marketCap: number;
+    totalSupply: number;
+    basket: DtfBasketAsset[];
+};
+export type DtfDiscoverItem = {
+    address: string;
+    name: string;
+    symbol: string;
+    price: number;
+    marketCap: number;
+    tvl?: number;
+    fee: number;
+    basket: {
+        address: string;
+        symbol: string;
+        name: string;
+        weight: string;
+    }[];
+    performance: {
+        value: number;
+        timestamp: number;
+    }[];
+    chainId: number;
+    mandate?: string;
+    brand?: {
+        icon?: string;
+        cover?: string;
+        tags?: string[];
+        about?: string;
+    };
+};
+export type ProposalState = 'PENDING' | 'ACTIVE' | 'CANCELED' | 'DEFEATED' | 'QUORUM_NOT_REACHED' | 'SUCCEEDED' | 'QUEUED' | 'EXPIRED' | 'EXECUTED';
+export type ComputedProposalState = {
+    /** Computed state — may differ from subgraph state */
+    state: ProposalState;
+    /** Seconds until next state transition, or null if terminal */
+    deadline: number | null;
+    /** Whether quorum was reached (for + abstain >= quorumVotes) */
+    quorumReached: boolean;
+    /** Vote percentages (0-100) */
+    forPercent: number;
+    againstPercent: number;
+    abstainPercent: number;
+};
+export type ProposalInfo = {
+    proposalId: bigint;
+    state: ProposalState;
+    eta: bigint;
+    deadline: bigint;
+    snapshot: bigint;
+};
+export type ProposalActions = {
+    targets: Address[];
+    values: bigint[];
+    calldatas: Hex[];
+    description: string;
+};
+export type RebalanceInfo = {
+    nonce: bigint;
+    priceControl: PriceControl;
+    bidsEnabled: boolean;
+    isActive: boolean;
+    isInLauncherWindow: boolean;
+    isInCommunityWindow: boolean;
+    isExpired: boolean;
+    tokens: {
+        address: Address;
+        weight: {
+            low: bigint;
+            spot: bigint;
+            high: bigint;
+        };
+        price: {
+            low: bigint;
+            high: bigint;
+        };
+        maxAuctionSize: bigint;
+        inRebalance: boolean;
+    }[];
+    limits: {
+        low: bigint;
+        spot: bigint;
+        high: bigint;
+    };
+    timestamps: {
+        startedAt: bigint;
+        restrictedUntil: bigint;
+        availableUntil: bigint;
+    };
+};
+export type AuctionInfo = {
+    auctionId: bigint;
+    rebalanceNonce: bigint;
+    startTime: bigint;
+    endTime: bigint;
+    isActive: boolean;
+};
+export type TransactionRequest = {
+    to: Address;
+    data: Hex;
+    value?: bigint;
+};
+export type MintQuote = {
+    shares: bigint;
+    assets: Address[];
+    amounts: bigint[];
+    mintFee: bigint;
+    minSharesOut: bigint;
+};
+export type RedeemQuote = {
+    shares: bigint;
+    assets: Address[];
+    amounts: bigint[];
+};
+export type FeeRecipient = {
+    recipient: Address;
+    portion: bigint;
+};
+export type PendingFees = {
+    total: bigint;
+    folio: bigint;
+    dao: bigint;
+};
+export type VoteSupport = 0 | 1 | 2;
+export type ProposalVotes = {
+    againstVotes: bigint;
+    forVotes: bigint;
+    abstainVotes: bigint;
+};
+export type GovernanceSettings = {
+    votingDelay: bigint;
+    votingPeriod: bigint;
+    proposalThreshold: bigint;
+    quorumNumerator: bigint;
+    quorumDenominator: bigint;
+    timelockMinDelay: bigint;
+};
+export type VoteLockInfo = {
+    balance: bigint;
+    delegatee: Address;
+    votingPower: bigint;
+    unstakingDelay: bigint;
+};
+export type RebalanceHistoryItem = {
+    nonce: number;
+    timestamp: number;
+    availableUntil: number;
+    totalRebalancedUsd?: number;
+    rebalanceGainLossUsd?: number;
+    rebalanceAccuracy?: number;
+    isNative?: boolean;
+};
+export type RebalanceDetail = {
+    nonce: number;
+    timestamp: number;
+    auctions?: {
+        startTime: number;
+        endTime: number;
+        bids: {
+            bidder: string;
+            sellToken: {
+                address: string;
+                symbol: string;
+                decimals: number;
+            };
+            buyToken: {
+                address: string;
+                symbol: string;
+                decimals: number;
+            };
+            sellAmount: string;
+            buyAmount: string;
+            sellAmountUsd?: number;
+            buyAmountUsd?: number;
+            priceImpactUsd?: number;
+        }[];
+        totalSellAmountUsd?: number;
+        totalBuyAmountUsd?: number;
+    }[];
+    totalRebalancedUsd?: number;
+    rebalanceGainLossUsd?: number;
+    rebalanceGainLossPercent?: number;
+    marketCapAtStart?: number;
+    rebalanceAccuracy?: number;
+    isNative?: boolean;
+};
+export type HistoricalDtfPoint = {
+    timestamp: number;
+    price: number;
+    totalSupply: number;
+};
+export type HistoricalPricePoint = {
+    timestamp: number;
+    price: number;
+};
+export type DeployBasicDetails = {
+    name: string;
+    symbol: string;
+    assets: Address[];
+    amounts: bigint[];
+    initialShares: bigint;
+};
+export type DeployAdditionalDetails = {
+    auctionLength: bigint;
+    feeRecipients: {
+        recipient: Address;
+        portion: bigint;
+    }[];
+    tvlFee: bigint;
+    mintFee: bigint;
+    mandate: string;
+};
+export type DeployFlags = {
+    trustedFillerEnabled: boolean;
+    rebalanceControl: {
+        weightControl: boolean;
+        priceControl: PriceControl;
+    };
+    bidsEnabled: boolean;
+};
+export type DeployGovParams = {
+    votingDelay: number;
+    votingPeriod: number;
+    proposalThreshold: bigint;
+    quorumThreshold: bigint;
+    timelockDelay: bigint;
+    guardians: Address[];
+};
+export type DeployGovRoles = {
+    existingBasketManagers: Address[];
+    auctionLaunchers: Address[];
+    brandManagers: Address[];
+};
+export type ZapQuoteParams = {
+    tokenIn: Address;
+    tokenOut: Address;
+    amountIn: bigint;
+    slippage: number;
+    sender: Address;
+    recipient: Address;
+};
+export type ZapQuote = {
+    amountOut: bigint;
+    to: Address;
+    data: Hex;
+    value: bigint;
+};
+export type ZapDeployBasicDetails = {
+    assets: Address[];
+    amounts: string[];
+    name: string;
+    symbol: string;
+};
+export type ZapDeployAdditionalDetails = {
+    auctionLength: string;
+    feeRecipients: {
+        recipient: Address;
+        portion: string;
+    }[];
+    tvlFee: string;
+    mintFee: string;
+    mandate: string;
+};
+export type ZapDeployFlags = {
+    trustedFillerEnabled: boolean;
+    rebalanceControl: {
+        weightControl: boolean;
+        priceControl: PriceControl;
+    };
+    bidsEnabled: boolean;
+};
+export type ZapDeployGovParams = {
+    votingDelay: string;
+    votingPeriod: string;
+    proposalThreshold: string;
+    quorumThreshold: string;
+    timelockDelay: string;
+    guardians: Address[];
+};
+export type ZapDeployParams = {
+    chainId: SupportedChainId;
+    tokenIn: Address;
+    amountIn: string;
+    signer: Address;
+    slippage?: number;
+    basicDetails: ZapDeployBasicDetails;
+    additionalDetails: ZapDeployAdditionalDetails;
+    folioFlags: ZapDeployFlags;
+    stToken?: Address;
+    ownerGovParams?: ZapDeployGovParams;
+    tradingGovParams?: ZapDeployGovParams;
+    basketManagers?: Address[];
+    auctionLaunchers?: Address[];
+    brandManagers?: Address[];
+};
+export type ZapDeployResult = {
+    tokenOut: Address;
+    amountOut: string;
+    approvalAddress: Address;
+    approvalNeeded: boolean;
+    insufficientFunds: boolean;
+    tx: {
+        data: Hex;
+        to: Address;
+        value: string;
+    } | null;
+    priceImpact: number;
+    gas: string | null;
+};
+export type DecodedProposalAction = {
+    target: Address;
+    targetLabel: string;
+    functionName: string;
+    parameters: {
+        name: string;
+        type: string;
+        value: unknown;
+    }[];
+    rawCalldata: Hex;
+    value: bigint;
+    decoded: boolean;
+};
+export type ProposalPreview = {
+    actions: DecodedProposalAction[];
+    unknownTargets: Address[];
+};
+export type DtfAddressMap = {
+    folio: Address;
+    proxyAdmin?: Address;
+    ownerGovernor?: Address;
+    ownerTimelock?: Address;
+    tradingGovernor?: Address;
+    tradingTimelock?: Address;
+    stTokenGovernor?: Address;
+    stTokenTimelock?: Address;
+    stToken?: Address;
+};
+export type VoteLockPosition = {
+    chainId: number;
+    token: {
+        address: string;
+        name: string;
+        symbol: string;
+        decimals: number;
+        price: number;
+    };
+    underlying: {
+        token: {
+            address: string;
+            name: string;
+            symbol: string;
+            decimals: number;
+            price: number;
+        };
+    };
+    rewards: {
+        token: {
+            address: string;
+            name: string;
+            symbol: string;
+            decimals: number;
+            price: number;
+        };
+        amount: number;
+        amountUsd: number;
+    }[];
+    dtfs: {
+        address: string;
+        name: string;
+        symbol: string;
+        decimals: number;
+        price: number;
+    }[];
+    lockedAmount: number;
+    lockedAmountUsd: number;
+    totalRewardAmountUsd: number;
+    avgDailyRewardAmountUsd: number;
+    apr: number;
+};
+export type Volatility = 'low' | 'medium' | 'high' | 'degen';
+export type PriceRecord = {
+    roundId: string;
+    priceUsd: number;
+    timestamp: number;
+};
+export type DtfRevenueRaw = {
+    address: string;
+    chainId: number;
+    totalRevenue: string;
+    protocolRevenue: string;
+    governanceRevenue: string;
+    externalRevenue: string;
+    mintingFee: string;
+    tvlFee: string;
+    annualizedTvlFee: string;
+    token: {
+        decimals: number;
+        symbol: string;
+        totalSupply: string;
+    };
+    stToken?: {
+        id: string;
+        token: {
+            totalSupply: string;
+            decimals: number;
+        };
+        underlying: {
+            symbol: string;
+            address: string;
+            decimals: number;
+        };
+    };
+};
+export type DtfRevenueUsd = {
+    address: string;
+    chainId: number;
+    symbol: string;
+    totalUsd: number;
+    protocolUsd: number;
+    governanceUsd: number;
+    externalUsd: number;
+};
+export type EcosystemRevenue = {
+    totalUsd: number;
+    protocolUsd: number;
+    governanceUsd: number;
+    externalUsd: number;
+    protocolPercent: number;
+    governancePercent: number;
+    externalPercent: number;
+    dtfCount: number;
+    topDtfs: DtfRevenueUsd[];
+};
+export type FeeMetrics = {
+    weightedMintingFee: number;
+    weightedTvlFee: number;
+    averageMintingFee: number;
+    averageTvlFee: number;
+};
+export type RevenueSnapshot = {
+    timestamp: number;
+    totalRevenue: string;
+    protocolRevenue: string;
+    governanceRevenue: string;
+    externalRevenue: string;
+    period: 'daily' | 'monthly';
+};
+export type RsrBurnEvent = {
+    amount: string;
+    burner: string;
+    timestamp: number;
+    transactionHash: string;
+    chainId: number;
+};
+export type RsrBurnData = {
+    burns: RsrBurnEvent[];
+    totalBurned: string;
+    totalBurnCount: number;
+    monthlySnapshots: {
+        timestamp: number;
+        monthlyBurnAmount: string;
+        monthlyBurnCount: number;
+        cumulativeBurned: string;
+    }[];
+};
+export type RsrBurnProjection = {
+    trailing: {
+        monthlyBurnRsr: number;
+        monthlyBurnUsd: number;
+        annualBurnRsr: number;
+        annualBurnUsd: number;
+        monthsUsed: number;
+    };
+    theoretical: {
+        annualBurnUsd: number;
+        monthlyBurnUsd: number;
+        monthlyBurnRsr: number;
+        platformTierPercent: number;
+    };
+    effectiveBurnRate: number;
+    totalBurnedRsr: number;
+    totalBurnedUsd: number;
+};
+export type BurnAccuracy = {
+    trailingMonthlyRsr: number;
+    latestMonthlyRsr: number;
+    latestVsTrailingPct: number;
+    totalBurnedRsr: number;
+    totalBurnedUsd: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/assert.d.ts

@@ -0,0 +1,2 @@
+export declare function assert(condition: boolean, message: string): asserts condition;
+//# sourceMappingURL=assert.d.ts.map

package/dist/utils/assert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../src/utils/assert.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAE7E"}

package/dist/utils/assert.js

@@ -0,0 +1,5 @@
+export function assert(condition, message) {
+    if (!condition)
+        throw new Error(message);
+}
+//# sourceMappingURL=assert.js.map

package/dist/utils/assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../src/utils/assert.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,MAAM,CAAC,SAAkB,EAAE,OAAe;IACxD,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAA;AAC1C,CAAC"}

package/dist/utils/fetch-token-metadata.d.ts

@@ -0,0 +1,7 @@
+import type { Address, PublicClient } from 'viem';
+import type { BasketToken } from '../types';
+/**
+ * Batch-fetch symbol + decimals for multiple tokens in a single multicall.
+ */
+export declare function fetchTokenMetadata(publicClient: PublicClient, addresses: Address[]): Promise<BasketToken[]>;
+//# sourceMappingURL=fetch-token-metadata.d.ts.map

package/dist/utils/fetch-token-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-token-metadata.d.ts","sourceRoot":"","sources":["../../src/utils/fetch-token-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAEjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAE3C;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,OAAO,EAAE,GACnB,OAAO,CAAC,WAAW,EAAE,CAAC,CA+BxB"}

package/dist/utils/fetch-token-metadata.js

@@ -0,0 +1,29 @@
+import { ERC20_META_ABI } from '../abi/erc20';
+/**
+ * Batch-fetch symbol + decimals for multiple tokens in a single multicall.
+ */
+export async function fetchTokenMetadata(publicClient, addresses) {
+    if (addresses.length === 0)
+        return [];
+    const contracts = addresses.flatMap((addr) => [
+        { address: addr, abi: ERC20_META_ABI, functionName: 'symbol' },
+        { address: addr, abi: ERC20_META_ABI, functionName: 'decimals' },
+    ]);
+    const results = await publicClient.multicall({ contracts });
+    const tokens = [];
+    for (let i = 0; i < addresses.length; i++) {
+        const symbolResult = results[i * 2];
+        const decimalsResult = results[i * 2 + 1];
+        const symbol = symbolResult.status === 'success'
+            ? symbolResult.result
+            : 'UNKNOWN';
+        // WHY: Silently defaulting to 18 is dangerous — 6-decimal tokens (USDC, USDT) would be off by 1e12
+        if (decimalsResult.status !== 'success') {
+            throw new Error(`Failed to read decimals() for token ${addresses[i]} — cannot safely assume default`);
+        }
+        const decimals = Number(decimalsResult.result);
+        tokens.push({ address: addresses[i], symbol, decimals });
+    }
+    return tokens;
+}
+//# sourceMappingURL=fetch-token-metadata.js.map

package/dist/utils/fetch-token-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-token-metadata.js","sourceRoot":"","sources":["../../src/utils/fetch-token-metadata.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAG7C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,YAA0B,EAC1B,SAAoB;IAEpB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAErC,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5C,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,YAAY,EAAE,QAAiB,EAAE;QACvE,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,YAAY,EAAE,UAAmB,EAAE;KAC1E,CAAC,CAAA;IAEF,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC,CAAA;IAE3D,MAAM,MAAM,GAAkB,EAAE,CAAA;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,YAAY,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAE,CAAA;QACpC,MAAM,cAAc,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAE,CAAA;QAE1C,MAAM,MAAM,GACV,YAAY,CAAC,MAAM,KAAK,SAAS;YAC/B,CAAC,CAAE,YAAY,CAAC,MAAiB;YACjC,CAAC,CAAC,SAAS,CAAA;QACf,mGAAmG;QACnG,IAAI,cAAc,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CACb,uCAAuC,SAAS,CAAC,CAAC,CAAE,iCAAiC,CACtF,CAAA;QACH,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;QAE9C,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;IAC3D,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/utils/fetch-with-retry.d.ts

@@ -0,0 +1,7 @@
+export type FetchWithRetryOptions = {
+    retries?: number;
+    timeoutMs?: number;
+    backoffMs?: number;
+};
+export declare function fetchWithRetry(url: string, init?: RequestInit, opts?: FetchWithRetryOptions): Promise<Response>;
+//# sourceMappingURL=fetch-with-retry.d.ts.map

package/dist/utils/fetch-with-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-with-retry.d.ts","sourceRoot":"","sources":["../../src/utils/fetch-with-retry.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAQD,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,WAAW,EAClB,IAAI,CAAC,EAAE,qBAAqB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAsCnB"}

package/dist/utils/fetch-with-retry.js

@@ -0,0 +1,38 @@
+const DEFAULTS = {
+    retries: 2,
+    timeoutMs: 15_000,
+    backoffMs: 1_000,
+};
+export async function fetchWithRetry(url, init, opts) {
+    const { retries, timeoutMs, backoffMs } = { ...DEFAULTS, ...opts };
+    let lastError;
+    for (let attempt = 0; attempt <= retries; attempt++) {
+        let timer;
+        try {
+            const controller = new AbortController();
+            timer = setTimeout(() => controller.abort(), timeoutMs);
+            // WHY: Combine caller's signal with our timeout signal so both can abort.
+            const signal = init?.signal
+                ? AbortSignal.any([controller.signal, init.signal])
+                : controller.signal;
+            const response = await fetch(url, {
+                ...init,
+                signal,
+            });
+            clearTimeout(timer);
+            return response;
+        }
+        catch (err) {
+            clearTimeout(timer);
+            lastError = err instanceof Error ? err : new Error(String(err));
+            // Don't retry if caller explicitly aborted
+            if (init?.signal?.aborted)
+                throw lastError;
+            if (attempt < retries) {
+                await new Promise((r) => setTimeout(r, backoffMs * (attempt + 1)));
+            }
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=fetch-with-retry.js.map