@reserve-protocol/dtf-sdk 0.1.0

package/dist/prices/chainlink.d.ts

@@ -0,0 +1,8 @@
+import type { PublicClient } from 'viem';
+import type { PriceRecord } from '../types';
+export declare function readChainlinkPrice(priceClient: PublicClient, feedAddress?: string): Promise<{
+    record: PriceRecord;
+    isStale: boolean;
+} | null>;
+export declare function backfillChainlinkPrices(priceClient: PublicClient, days: number, batchSize?: number, feedAddress?: string): Promise<PriceRecord[]>;
+//# sourceMappingURL=chainlink.d.ts.map

package/dist/prices/chainlink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chainlink.d.ts","sourceRoot":"","sources":["../../src/prices/chainlink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAMxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AA4C3C,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,YAAY,EACzB,WAAW,GAAE,MAA0B,GACtC,OAAO,CAAC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC,CAkB3D;AAED,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,YAAY,EACzB,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,MAAW,EACtB,WAAW,GAAE,MAA0B,GACtC,OAAO,CAAC,WAAW,EAAE,CAAC,CAsExB"}

package/dist/prices/chainlink.js

@@ -0,0 +1,116 @@
+import { CHAINLINK_BTC_USD, CHAINLINK_DECIMALS, STALE_PRICE_THRESHOLD_S, } from '../constants';
+const AGGREGATOR_V3_ABI = [
+    {
+        name: 'latestRoundData',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [
+            { name: 'roundId', type: 'uint80' },
+            { name: 'answer', type: 'int256' },
+            { name: 'startedAt', type: 'uint256' },
+            { name: 'updatedAt', type: 'uint256' },
+            { name: 'answeredInRound', type: 'uint80' },
+        ],
+    },
+    {
+        name: 'getRoundData',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [{ name: '_roundId', type: 'uint80' }],
+        outputs: [
+            { name: 'roundId', type: 'uint80' },
+            { name: 'answer', type: 'int256' },
+            { name: 'startedAt', type: 'uint256' },
+            { name: 'updatedAt', type: 'uint256' },
+            { name: 'answeredInRound', type: 'uint80' },
+        ],
+    },
+];
+function parseRoundData(result) {
+    const [roundId, answer, , updatedAt] = result;
+    if (updatedAt === 0n || answer <= 0n)
+        return null;
+    return {
+        roundId: roundId.toString(),
+        priceUsd: Number(answer) / 10 ** CHAINLINK_DECIMALS,
+        timestamp: Number(updatedAt),
+    };
+}
+export async function readChainlinkPrice(priceClient, feedAddress = CHAINLINK_BTC_USD) {
+    if (!feedAddress.startsWith('0x') || feedAddress.length !== 42) {
+        throw new Error(`Invalid Chainlink feed address: ${feedAddress}`);
+    }
+    const result = (await priceClient.readContract({
+        address: feedAddress,
+        abi: AGGREGATOR_V3_ABI,
+        functionName: 'latestRoundData',
+    }));
+    const record = parseRoundData(result);
+    if (!record)
+        return null;
+    const now = Math.floor(Date.now() / 1000);
+    const isStale = now - record.timestamp > STALE_PRICE_THRESHOLD_S;
+    return { record, isStale };
+}
+export async function backfillChainlinkPrices(priceClient, days, batchSize = 50, feedAddress = CHAINLINK_BTC_USD) {
+    if (days <= 0)
+        throw new Error(`backfillChainlinkPrices: days must be > 0, got ${days}`);
+    if (batchSize <= 0)
+        throw new Error(`backfillChainlinkPrices: batchSize must be > 0, got ${batchSize}`);
+    if (!feedAddress.startsWith('0x') || feedAddress.length !== 42) {
+        throw new Error(`Invalid Chainlink feed address: ${feedAddress}`);
+    }
+    const latest = (await priceClient.readContract({
+        address: feedAddress,
+        abi: AGGREGATOR_V3_ABI,
+        functionName: 'latestRoundData',
+    }));
+    const latestRoundId = latest[0];
+    const phaseId = latestRoundId >> 64n;
+    const mask = (1n << 64n) - 1n;
+    let aggRoundId = latestRoundId & mask;
+    const targetTimestamp = Math.floor(Date.now() / 1000) - days * 86400;
+    const records = [];
+    let consecutiveErrors = 0;
+    const latestRecord = parseRoundData(latest);
+    if (latestRecord)
+        records.push(latestRecord);
+    while (aggRoundId > 1n && consecutiveErrors < 5) {
+        const currentBatchSize = Math.min(batchSize, Number(aggRoundId));
+        const roundIds = [];
+        for (let i = 1; i <= currentBatchSize; i++) {
+            const rid = (phaseId << 64n) | (aggRoundId - BigInt(i));
+            roundIds.push(rid);
+        }
+        const results = await priceClient.multicall({
+            contracts: roundIds.map((rid) => ({
+                address: feedAddress,
+                abi: AGGREGATOR_V3_ABI,
+                functionName: 'getRoundData',
+                args: [rid],
+            })),
+        });
+        let reachedTarget = false;
+        for (const res of results) {
+            if (res.status === 'failure') {
+                consecutiveErrors++;
+                continue;
+            }
+            consecutiveErrors = 0;
+            const record = parseRoundData(res.result);
+            if (!record)
+                continue;
+            if (record.timestamp < targetTimestamp) {
+                reachedTarget = true;
+                break;
+            }
+            records.push(record);
+        }
+        if (reachedTarget)
+            break;
+        aggRoundId -= BigInt(currentBatchSize);
+    }
+    return records;
+}
+//# sourceMappingURL=chainlink.js.map

package/dist/prices/chainlink.js.map

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

package/dist/prices/reserve-api.d.ts

@@ -0,0 +1,7 @@
+import type { Address } from 'viem';
+import type { Volatility } from '../types';
+export declare function volatilityToPriceError(volatility: Volatility | string): number;
+export declare function proposalVolatilityToPriceError(volatility: Volatility | string): number;
+export declare function fetchTokenPrices(chainId: number, tokenAddresses: (Address | string)[], baseUrl?: string): Promise<Record<string, number>>;
+export declare function fetchTokenVolatility(chainId: number, baseUrl?: string): Promise<Record<string, Volatility>>;
+//# sourceMappingURL=reserve-api.d.ts.map

package/dist/prices/reserve-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reserve-api.d.ts","sourceRoot":"","sources":["../../src/prices/reserve-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAOnC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AA6B1C,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAI9E;AAED,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,UAAU,GAAG,MAAM,GAC9B,MAAM,CAIR;AAID,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,CAAC,OAAO,GAAG,MAAM,CAAC,EAAE,EACpC,OAAO,GAAE,MAA6B,GACrC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAqBjC;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,MAA6B,GACrC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAwBrC"}

package/dist/prices/reserve-api.js

@@ -0,0 +1,47 @@
+import { RESERVE_API_BASE_URL, VOLATILITY_TO_PRICE_ERROR, PROPOSAL_VOLATILITY_TO_PRICE_ERROR, } from '../constants';
+import { fetchWithRetry } from '../utils/fetch-with-retry';
+const VALID_VOLATILITIES = new Set(['low', 'medium', 'high', 'degen']);
+// -- Volatility mapping --
+export function volatilityToPriceError(volatility) {
+    return (VOLATILITY_TO_PRICE_ERROR[volatility] ?? 0.10);
+}
+export function proposalVolatilityToPriceError(volatility) {
+    return (PROPOSAL_VOLATILITY_TO_PRICE_ERROR[volatility] ?? 0.75);
+}
+// -- API functions --
+export async function fetchTokenPrices(chainId, tokenAddresses, baseUrl = RESERVE_API_BASE_URL) {
+    const tokens = tokenAddresses.map((a) => a.toLowerCase()).join(',');
+    const url = `${baseUrl}/current/prices?chainId=${chainId}&tokens=${tokens}`;
+    const response = await fetchWithRetry(url);
+    if (!response.ok) {
+        throw new Error(`Reserve API prices failed: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    const prices = {};
+    for (const item of data) {
+        if (item.price > 0) {
+            prices[item.address.toLowerCase()] = item.price;
+        }
+    }
+    return prices;
+}
+export async function fetchTokenVolatility(chainId, baseUrl = RESERVE_API_BASE_URL) {
+    const url = `${baseUrl}/zapper/tokens?chainId=${chainId}`;
+    const response = await fetchWithRetry(url);
+    if (!response.ok) {
+        throw new Error(`Reserve API tokens failed: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    const volatility = {};
+    const tokens = Array.isArray(data) ? data : data.tokens;
+    for (const token of tokens) {
+        // WHY: Default unknown volatility values to 'high' for safety.
+        // If the API adds new volatility tiers, we use conservative bounds.
+        const vol = VALID_VOLATILITIES.has(token.volatility)
+            ? token.volatility
+            : 'high';
+        volatility[token.address.toLowerCase()] = vol;
+    }
+    return volatility;
+}
+//# sourceMappingURL=reserve-api.js.map

package/dist/prices/reserve-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reserve-api.js","sourceRoot":"","sources":["../../src/prices/reserve-api.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,kCAAkC,GACnC,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAG1D,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAyB9E,2BAA2B;AAE3B,MAAM,UAAU,sBAAsB,CAAC,UAA+B;IACpE,OAAO,CACL,yBAAyB,CAAC,UAAwB,CAAC,IAAI,IAAI,CAC5D,CAAA;AACH,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,UAA+B;IAE/B,OAAO,CACL,kCAAkC,CAAC,UAAwB,CAAC,IAAI,IAAI,CACrE,CAAA;AACH,CAAC;AAED,sBAAsB;AAEtB,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAe,EACf,cAAoC,EACpC,UAAkB,oBAAoB;IAEtC,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACnE,MAAM,GAAG,GAAG,GAAG,OAAO,2BAA2B,OAAO,WAAW,MAAM,EAAE,CAAA;IAE3E,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,CAAA;IAC1C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,8BAA8B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CACvE,CAAA;IACH,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAkB,CAAA;IACrD,MAAM,MAAM,GAA2B,EAAE,CAAA;IAEzC,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAA;QACjD,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAe,EACf,UAAkB,oBAAoB;IAEtC,MAAM,GAAG,GAAG,GAAG,OAAO,0BAA0B,OAAO,EAAE,CAAA;IAEzD,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,CAAA;IAC1C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,8BAA8B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CACvE,CAAA;IACH,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAmB,CAAA;IACtD,MAAM,UAAU,GAA+B,EAAE,CAAA;IAEjD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAA;IACvD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,+DAA+D;QAC/D,oEAAoE;QACpE,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC;YAClD,CAAC,CAAE,KAAK,CAAC,UAAyB;YAClC,CAAC,CAAC,MAAM,CAAA;QACV,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,GAAG,GAAG,CAAA;IAC/C,CAAC;IAED,OAAO,UAAU,CAAA;AACnB,CAAC"}

package/dist/rebalance/build-auction.d.ts

@@ -0,0 +1,25 @@
+import { type Address, type Hex } from 'viem';
+import type { Rebalance, OpenAuctionArgs, AuctionMetrics, WeightRange } from '@reserve-protocol/dtf-rebalance-lib/dist/types';
+import type { TransactionRequest } from '../types';
+export type ComputeOpenAuctionInput = {
+    rebalance: Rebalance;
+    supply: bigint;
+    initialSupply: bigint;
+    initialAssets: bigint[] | undefined;
+    assets: bigint[];
+    decimals: number[];
+    prices: number[];
+    priceError: number[];
+    finalStageAt: number;
+};
+export declare function computeTargetBasket(weights: WeightRange[], prices: number[], decimals: number[]): bigint[];
+export declare function computeOpenAuctionParams(input: ComputeOpenAuctionInput): {
+    args: OpenAuctionArgs;
+    metrics: AuctionMetrics;
+};
+export declare function buildOpenAuctionCalldata(folioAddress: Address, args: OpenAuctionArgs): TransactionRequest;
+export declare function buildOpenAuctionUnrestrictedCalldata(folioAddress: Address, nonce: bigint): TransactionRequest;
+export declare function buildCloseAuctionCalldata(folioAddress: Address, auctionId: bigint): TransactionRequest;
+export declare function buildBidCalldata(folioAddress: Address, auctionId: bigint, sellToken: Address, buyToken: Address, sellAmount: bigint, maxBuyAmount: bigint, withCallback?: boolean, data?: Hex): TransactionRequest;
+export type { OpenAuctionArgs, AuctionMetrics, Rebalance, WeightRange };
+//# sourceMappingURL=build-auction.d.ts.map

package/dist/rebalance/build-auction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-auction.d.ts","sourceRoot":"","sources":["../../src/rebalance/build-auction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAA;AAOjE,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,cAAc,EACd,WAAW,EACZ,MAAM,gDAAgD,CAAA;AAEvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAElD,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,EAAE,SAAS,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IACnC,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EAAE,EACtB,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,EAAE,MAAM,EAAE,GACjB,MAAM,EAAE,CAIV;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,uBAAuB,GAC7B;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,CAsBpD;AAED,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,OAAO,EACrB,IAAI,EAAE,eAAe,GACpB,kBAAkB,CAepB;AAED,wBAAgB,oCAAoC,CAClD,YAAY,EAAE,OAAO,EACrB,KAAK,EAAE,MAAM,GACZ,kBAAkB,CASpB;AAED,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,OAAO,EACrB,SAAS,EAAE,MAAM,GAChB,kBAAkB,CASpB;AAED,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,OAAO,EACrB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,OAAO,EAClB,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,YAAY,GAAE,OAAe,EAC7B,IAAI,GAAE,GAAU,GACf,kBAAkB,CAkBpB;AAED,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,CAAA"}

package/dist/rebalance/build-auction.js

@@ -0,0 +1,73 @@
+import { encodeFunctionData } from 'viem';
+import { assert } from '../utils/assert';
+import { getOpenAuction, getTargetBasket, FolioVersion, } from '@reserve-protocol/dtf-rebalance-lib';
+import folioAbi from '../abi/folio';
+export function computeTargetBasket(weights, prices, decimals) {
+    // WHY: dtf-rebalance-lib expects decimals as bigint[], SDK accepts number[] for ergonomics
+    const decimalsBigInt = decimals.map((d) => BigInt(d));
+    return getTargetBasket(weights, prices, decimalsBigInt);
+}
+export function computeOpenAuctionParams(input) {
+    const decimalsBigInt = input.decimals.map((d) => BigInt(d));
+    // WHY: target basket is derived from current weights + prices, not stored on-chain
+    const weights = input.rebalance.tokens.map((t) => t.weight);
+    const targetBasket = getTargetBasket(weights, input.prices, decimalsBigInt);
+    const [args, metrics] = getOpenAuction(FolioVersion.V5, input.rebalance, input.supply, input.initialSupply, input.initialAssets, targetBasket, input.assets, decimalsBigInt, input.prices, input.priceError, input.finalStageAt);
+    return { args, metrics };
+}
+export function buildOpenAuctionCalldata(folioAddress, args) {
+    return {
+        to: folioAddress,
+        data: encodeFunctionData({
+            abi: folioAbi,
+            functionName: 'openAuction',
+            args: [
+                args.rebalanceNonce,
+                args.tokens,
+                args.newWeights,
+                args.newPrices,
+                args.newLimits,
+            ],
+        }),
+    };
+}
+export function buildOpenAuctionUnrestrictedCalldata(folioAddress, nonce) {
+    return {
+        to: folioAddress,
+        data: encodeFunctionData({
+            abi: folioAbi,
+            functionName: 'openAuctionUnrestricted',
+            args: [nonce],
+        }),
+    };
+}
+export function buildCloseAuctionCalldata(folioAddress, auctionId) {
+    return {
+        to: folioAddress,
+        data: encodeFunctionData({
+            abi: folioAbi,
+            functionName: 'closeAuction',
+            args: [auctionId],
+        }),
+    };
+}
+export function buildBidCalldata(folioAddress, auctionId, sellToken, buyToken, sellAmount, maxBuyAmount, withCallback = false, data = '0x') {
+    assert(sellAmount > 0n, 'sellAmount must be greater than 0');
+    return {
+        to: folioAddress,
+        data: encodeFunctionData({
+            abi: folioAbi,
+            functionName: 'bid',
+            args: [
+                auctionId,
+                sellToken,
+                buyToken,
+                sellAmount,
+                maxBuyAmount,
+                withCallback,
+                data,
+            ],
+        }),
+    };
+}
+//# sourceMappingURL=build-auction.js.map

package/dist/rebalance/build-auction.js.map

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

package/dist/rebalance/build-rebalance.d.ts

@@ -0,0 +1,22 @@
+import { type Address } from 'viem';
+import { FolioVersion } from '@reserve-protocol/dtf-rebalance-lib';
+import type { StartRebalanceArgsPartial } from '@reserve-protocol/dtf-rebalance-lib/dist/types';
+import type { TransactionRequest } from '../types';
+export type ComputeStartRebalanceInput = {
+    supply: bigint;
+    tokens: string[];
+    assets: bigint[];
+    decimals: number[];
+    targetBasket: bigint[];
+    prices: number[];
+    priceError: number[];
+    maxAuctionSizes: number[];
+    weightControl: boolean;
+    deferWeights: boolean;
+};
+export declare function computeStartRebalanceParams(input: ComputeStartRebalanceInput): StartRebalanceArgsPartial;
+export declare function buildStartRebalanceCalldata(folioAddress: Address, params: StartRebalanceArgsPartial, launcherWindow: bigint, ttl: bigint): TransactionRequest;
+export declare function buildEndRebalanceCalldata(folioAddress: Address): TransactionRequest;
+export { FolioVersion };
+export type { StartRebalanceArgsPartial };
+//# sourceMappingURL=build-rebalance.d.ts.map

package/dist/rebalance/build-rebalance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-rebalance.d.ts","sourceRoot":"","sources":["../../src/rebalance/build-rebalance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,OAAO,EAAE,MAAM,MAAM,CAAA;AACvD,OAAO,EAEL,YAAY,EACb,MAAM,qCAAqC,CAAA;AAC5C,OAAO,KAAK,EACV,yBAAyB,EAC1B,MAAM,gDAAgD,CAAA;AAEvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAElD,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,aAAa,EAAE,OAAO,CAAA;IACtB,YAAY,EAAE,OAAO,CAAA;CACtB,CAAA;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,0BAA0B,GAChC,yBAAyB,CAiB3B;AAED,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,OAAO,EACrB,MAAM,EAAE,yBAAyB,EACjC,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,MAAM,GACV,kBAAkB,CAUpB;AAED,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,OAAO,GACpB,kBAAkB,CAQpB;AAED,OAAO,EAAE,YAAY,EAAE,CAAA;AACvB,YAAY,EAAE,yBAAyB,EAAE,CAAA"}

package/dist/rebalance/build-rebalance.js

@@ -0,0 +1,30 @@
+import { encodeFunctionData } from 'viem';
+import { getStartRebalance, FolioVersion, } from '@reserve-protocol/dtf-rebalance-lib';
+import folioAbi from '../abi/folio';
+export function computeStartRebalanceParams(input) {
+    // WHY: dtf-rebalance-lib expects decimals as bigint[], not number[]
+    const decimalsBigInt = input.decimals.map((d) => BigInt(d));
+    return getStartRebalance(FolioVersion.V5, input.supply, input.tokens, input.assets, decimalsBigInt, input.targetBasket, input.prices, input.priceError, input.maxAuctionSizes, input.weightControl, input.deferWeights);
+}
+export function buildStartRebalanceCalldata(folioAddress, params, launcherWindow, ttl) {
+    return {
+        to: folioAddress,
+        data: encodeFunctionData({
+            abi: folioAbi,
+            functionName: 'startRebalance',
+            // WHY: rebalance-lib returns token as string, ABI expects `0x${string}`
+            args: [params.tokens, params.limits, launcherWindow, ttl],
+        }),
+    };
+}
+export function buildEndRebalanceCalldata(folioAddress) {
+    return {
+        to: folioAddress,
+        data: encodeFunctionData({
+            abi: folioAbi,
+            functionName: 'endRebalance',
+        }),
+    };
+}
+export { FolioVersion };
+//# sourceMappingURL=build-rebalance.js.map

package/dist/rebalance/build-rebalance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-rebalance.js","sourceRoot":"","sources":["../../src/rebalance/build-rebalance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAgB,MAAM,MAAM,CAAA;AACvD,OAAO,EACL,iBAAiB,EACjB,YAAY,GACb,MAAM,qCAAqC,CAAA;AAI5C,OAAO,QAAQ,MAAM,cAAc,CAAA;AAgBnC,MAAM,UAAU,2BAA2B,CACzC,KAAiC;IAEjC,oEAAoE;IACpE,MAAM,cAAc,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IAE3D,OAAO,iBAAiB,CACtB,YAAY,CAAC,EAAE,EACf,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,MAAM,EACZ,cAAc,EACd,KAAK,CAAC,YAAY,EAClB,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,eAAe,EACrB,KAAK,CAAC,aAAa,EACnB,KAAK,CAAC,YAAY,CACU,CAAA;AAChC,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,YAAqB,EACrB,MAAiC,EACjC,cAAsB,EACtB,GAAW;IAEX,OAAO;QACL,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,kBAAkB,CAAC;YACvB,GAAG,EAAE,QAAQ;YACb,YAAY,EAAE,gBAAgB;YAC9B,wEAAwE;YACxE,IAAI,EAAE,CAAC,MAAM,CAAC,MAAgL,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,CAAC;SACpO,CAAC;KACH,CAAA;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,YAAqB;IAErB,OAAO;QACL,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,kBAAkB,CAAC;YACvB,GAAG,EAAE,QAAQ;YACb,YAAY,EAAE,cAAc;SAC7B,CAAC;KACH,CAAA;AACH,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,CAAA"}

package/dist/rebalance/read-auction.d.ts

@@ -0,0 +1,4 @@
+import type { Address, PublicClient } from 'viem';
+import type { AuctionInfo } from '../types';
+export declare function readActiveAuction(publicClient: PublicClient, folioAddress: Address): Promise<AuctionInfo | null>;
+//# sourceMappingURL=read-auction.d.ts.map

package/dist/rebalance/read-auction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-auction.d.ts","sourceRoot":"","sources":["../../src/rebalance/read-auction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAEjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAE3C,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA+B7B"}

package/dist/rebalance/read-auction.js

@@ -0,0 +1,31 @@
+import folioAbi from '../abi/folio';
+export async function readActiveAuction(publicClient, folioAddress) {
+    const nextAuctionId = (await publicClient.readContract({
+        address: folioAddress,
+        abi: folioAbi,
+        functionName: 'nextAuctionId',
+    }));
+    if (nextAuctionId === 0n)
+        return null;
+    const lastAuctionId = nextAuctionId - 1n;
+    const auction = (await publicClient.readContract({
+        address: folioAddress,
+        abi: folioAbi,
+        functionName: 'auctions',
+        args: [lastAuctionId],
+    }));
+    const [rebalanceNonce, startTime, endTime] = auction;
+    // WHY: Uses client clock (Date.now()), not block.timestamp. Clock skew on the user's machine
+    // could make isActive wrong by seconds. An extra getBlock() call would be canonical but adds
+    // latency. Acceptable tradeoff for a display-only field. Same pattern as readRebalanceState.
+    const now = BigInt(Math.floor(Date.now() / 1000));
+    const isActive = now < endTime;
+    return {
+        auctionId: lastAuctionId,
+        rebalanceNonce,
+        startTime,
+        endTime,
+        isActive,
+    };
+}
+//# sourceMappingURL=read-auction.js.map

package/dist/rebalance/read-auction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-auction.js","sourceRoot":"","sources":["../../src/rebalance/read-auction.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,cAAc,CAAA;AAGnC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,YAA0B,EAC1B,YAAqB;IAErB,MAAM,aAAa,GAAG,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC;QACrD,OAAO,EAAE,YAAY;QACrB,GAAG,EAAE,QAAQ;QACb,YAAY,EAAE,eAAe;KAC9B,CAAC,CAAW,CAAA;IAEb,IAAI,aAAa,KAAK,EAAE;QAAE,OAAO,IAAI,CAAA;IAErC,MAAM,aAAa,GAAG,aAAa,GAAG,EAAE,CAAA;IACxC,MAAM,OAAO,GAAG,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC;QAC/C,OAAO,EAAE,YAAY;QACrB,GAAG,EAAE,QAAQ;QACb,YAAY,EAAE,UAAU;QACxB,IAAI,EAAE,CAAC,aAAa,CAAC;KACtB,CAAC,CAA6B,CAAA;IAE/B,MAAM,CAAC,cAAc,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,OAAO,CAAA;IACpD,6FAA6F;IAC7F,6FAA6F;IAC7F,6FAA6F;IAC7F,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAA;IACjD,MAAM,QAAQ,GAAG,GAAG,GAAG,OAAO,CAAA;IAE9B,OAAO;QACL,SAAS,EAAE,aAAa;QACxB,cAAc;QACd,SAAS;QACT,OAAO;QACP,QAAQ;KACT,CAAA;AACH,CAAC"}

package/dist/rebalance/read-rebalance.d.ts

@@ -0,0 +1,4 @@
+import type { Address, PublicClient } from 'viem';
+import type { RebalanceInfo } from '../types';
+export declare function readRebalanceState(publicClient: PublicClient, folioAddress: Address): Promise<RebalanceInfo | null>;
+//# sourceMappingURL=read-rebalance.d.ts.map

package/dist/rebalance/read-rebalance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-rebalance.d.ts","sourceRoot":"","sources":["../../src/rebalance/read-rebalance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAGjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAG7C,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA6D/B"}

package/dist/rebalance/read-rebalance.js

@@ -0,0 +1,50 @@
+import { ContractFunctionExecutionError } from 'viem';
+import folioAbi from '../abi/folio';
+import { validatePriceControl } from '../utils/validate-price-control';
+export async function readRebalanceState(publicClient, folioAddress) {
+    let raw;
+    try {
+        raw = (await publicClient.readContract({
+            address: folioAddress,
+            abi: folioAbi,
+            functionName: 'getRebalance',
+        }));
+    }
+    catch (err) {
+        // WHY: getRebalance() reverts when there's no active rebalance (nonce 0, never started).
+        // Only swallow contract reverts — rethrow network/transport errors.
+        if (err instanceof ContractFunctionExecutionError)
+            return null;
+        throw err;
+    }
+    const [nonce, priceControl, tokenParams, limits, timestamps, bidsEnabled] = raw;
+    const now = BigInt(Math.floor(Date.now() / 1000));
+    // WHY: Check availableUntil, not nonce. Nonce 0 can be an active rebalance.
+    const isActive = timestamps.availableUntil > now;
+    const isInLauncherWindow = isActive && now < timestamps.restrictedUntil;
+    const isInCommunityWindow = isActive && now >= timestamps.restrictedUntil;
+    const isExpired = timestamps.availableUntil > 0n && now >= timestamps.availableUntil;
+    return {
+        nonce,
+        priceControl: validatePriceControl(priceControl),
+        bidsEnabled,
+        isActive,
+        isInLauncherWindow,
+        isInCommunityWindow,
+        isExpired,
+        tokens: tokenParams.map((t) => ({
+            address: t.token,
+            weight: { low: t.weight.low, spot: t.weight.spot, high: t.weight.high },
+            price: { low: t.price.low, high: t.price.high },
+            maxAuctionSize: t.maxAuctionSize,
+            inRebalance: t.inRebalance,
+        })),
+        limits: { low: limits.low, spot: limits.spot, high: limits.high },
+        timestamps: {
+            startedAt: timestamps.startedAt,
+            restrictedUntil: timestamps.restrictedUntil,
+            availableUntil: timestamps.availableUntil,
+        },
+    };
+}
+//# sourceMappingURL=read-rebalance.js.map

package/dist/rebalance/read-rebalance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-rebalance.js","sourceRoot":"","sources":["../../src/rebalance/read-rebalance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,MAAM,CAAA;AACrD,OAAO,QAAQ,MAAM,cAAc,CAAA;AAEnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AAEtE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,YAA0B,EAC1B,YAAqB;IAErB,IAAI,GAAuB,CAAA;IAC3B,IAAI,CAAC;QACH,GAAG,GAAG,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC;YACrC,OAAO,EAAE,YAAY;YACrB,GAAG,EAAE,QAAQ;YACb,YAAY,EAAE,cAAc;SAC7B,CAAC,CAAuB,CAAA;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,yFAAyF;QACzF,oEAAoE;QACpE,IAAI,GAAG,YAAY,8BAA8B;YAAE,OAAO,IAAI,CAAA;QAC9D,MAAM,GAAG,CAAA;IACX,CAAC;IAED,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,GACvE,GAaC,CAAA;IAEH,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAA;IACjD,4EAA4E;IAC5E,MAAM,QAAQ,GAAG,UAAU,CAAC,cAAc,GAAG,GAAG,CAAA;IAChD,MAAM,kBAAkB,GAAG,QAAQ,IAAI,GAAG,GAAG,UAAU,CAAC,eAAe,CAAA;IACvE,MAAM,mBAAmB,GACvB,QAAQ,IAAI,GAAG,IAAI,UAAU,CAAC,eAAe,CAAA;IAC/C,MAAM,SAAS,GAAG,UAAU,CAAC,cAAc,GAAG,EAAE,IAAI,GAAG,IAAI,UAAU,CAAC,cAAc,CAAA;IAEpF,OAAO;QACL,KAAK;QACL,YAAY,EAAE,oBAAoB,CAAC,YAAY,CAAC;QAChD,WAAW;QACX,QAAQ;QACR,kBAAkB;QAClB,mBAAmB;QACnB,SAAS;QACT,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9B,OAAO,EAAE,CAAC,CAAC,KAAK;YAChB,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;YACvE,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE;YAC/C,cAAc,EAAE,CAAC,CAAC,cAAc;YAChC,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC;QACH,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;QACjE,UAAU,EAAE;YACV,SAAS,EAAE,UAAU,CAAC,SAAS;YAC/B,eAAe,EAAE,UAAU,CAAC,eAAe;YAC3C,cAAc,EAAE,UAAU,CAAC,cAAc;SAC1C;KACF,CAAA;AACH,CAAC"}

package/dist/rebalance/transform.d.ts

@@ -0,0 +1,22 @@
+import { type Address } from 'viem';
+import type { Rebalance } from '@reserve-protocol/dtf-rebalance-lib/dist/types';
+/**
+ * Transform raw getRebalance() V5 return value into the Rebalance type
+ * expected by dtf-rebalance-lib.
+ */
+export declare function transformV5Rebalance(raw: readonly unknown[]): Rebalance;
+/**
+ * Map token addresses to balances for easy lookup.
+ */
+export declare function mapAssets(addresses: readonly Address[], balances: readonly bigint[]): Map<string, bigint>;
+/**
+ * Calculate USD price per whole token from on-chain D27 price range.
+ * WHY: On-chain prices are D27{USD/smallestUnit}. formatUnits(x, 36) = x / 10^36.
+ * This gives USD per (10^9 smallest units). Multiplying by 10^tokenDecimals converts
+ * to USD per whole token. Net effect: price = x / 10^(36 - tokenDecimals).
+ */
+export declare function calculatePriceFromRange(priceRange: {
+    low: bigint;
+    high: bigint;
+}, tokenDecimals: number): number;
+//# sourceMappingURL=transform.d.ts.map

package/dist/rebalance/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/rebalance/transform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,MAAM,CAAA;AAChD,OAAO,KAAK,EACV,SAAS,EAMV,MAAM,gDAAgD,CAAA;AAEvD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,SAAS,OAAO,EAAE,GACtB,SAAS,CAiCX;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,SAAS,EAAE,SAAS,OAAO,EAAE,EAC7B,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAMrB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACzC,aAAa,EAAE,MAAM,GACpB,MAAM,CAIR"}

package/dist/rebalance/transform.js

@@ -0,0 +1,47 @@
+import { formatUnits } from 'viem';
+/**
+ * Transform raw getRebalance() V5 return value into the Rebalance type
+ * expected by dtf-rebalance-lib.
+ */
+export function transformV5Rebalance(raw) {
+    const [nonce, priceControl, tokenParams, limits, timestamps] = raw;
+    return {
+        nonce,
+        priceControl: priceControl,
+        tokens: tokenParams.map((t) => ({
+            token: t.token,
+            weight: { low: t.weight.low, spot: t.weight.spot, high: t.weight.high },
+            price: { low: t.price.low, high: t.price.high },
+            maxAuctionSize: t.maxAuctionSize,
+            inRebalance: t.inRebalance,
+        })),
+        limits: { low: limits.low, spot: limits.spot, high: limits.high },
+        timestamps: {
+            startedAt: timestamps.startedAt,
+            restrictedUntil: timestamps.restrictedUntil,
+            availableUntil: timestamps.availableUntil,
+        },
+    };
+}
+/**
+ * Map token addresses to balances for easy lookup.
+ */
+export function mapAssets(addresses, balances) {
+    const map = new Map();
+    for (let i = 0; i < addresses.length; i++) {
+        map.set(addresses[i].toLowerCase(), balances[i]);
+    }
+    return map;
+}
+/**
+ * Calculate USD price per whole token from on-chain D27 price range.
+ * WHY: On-chain prices are D27{USD/smallestUnit}. formatUnits(x, 36) = x / 10^36.
+ * This gives USD per (10^9 smallest units). Multiplying by 10^tokenDecimals converts
+ * to USD per whole token. Net effect: price = x / 10^(36 - tokenDecimals).
+ */
+export function calculatePriceFromRange(priceRange, tokenDecimals) {
+    const lowPrice = Number(formatUnits(priceRange.low, 36));
+    const highPrice = Number(formatUnits(priceRange.high, 36));
+    return Math.sqrt(lowPrice * highPrice) * Math.pow(10, tokenDecimals);
+}
+//# sourceMappingURL=transform.js.map

package/dist/rebalance/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../src/rebalance/transform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,MAAM,CAAA;AAUhD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAuB;IAEvB,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,GAAG,GAa9D,CAAA;IAED,OAAO;QACL,KAAK;QACL,YAAY,EAAE,YAAuC;QACrD,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9B,KAAK,EAAE,CAAC,CAAC,KAAe;YACxB,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;YACvE,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE;YAC/C,cAAc,EAAE,CAAC,CAAC,cAAc;YAChC,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC;QACH,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;QACjE,UAAU,EAAE;YACV,SAAS,EAAE,UAAU,CAAC,SAAS;YAC/B,eAAe,EAAE,UAAU,CAAC,eAAe;YAC3C,cAAc,EAAE,UAAU,CAAC,cAAc;SAC1C;KACF,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,SAA6B,EAC7B,QAA2B;IAE3B,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAA;IACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAA;IACpD,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,UAAyC,EACzC,aAAqB;IAErB,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAA;IACxD,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAA;IAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,aAAa,CAAC,CAAA;AACtE,CAAC"}

package/dist/revenue/compute-revenue.d.ts

@@ -0,0 +1,45 @@
+import type { BurnAccuracy, DtfRevenueRaw, DtfRevenueUsd, EcosystemRevenue, FeeMetrics, PriceRecord, RsrBurnData, RsrBurnEvent, RsrBurnProjection } from '../types';
+/**
+ * Convert raw revenue (BigDecimal in DTF shares) to USD.
+ * WHY: Subgraph BigDecimal is in wei-scale (e.g. "6277028174388650175775" for 6277 shares).
+ * Must divide by 10^decimals before multiplying by price.
+ */
+export declare function computeRevenueUsd(raw: DtfRevenueRaw, price: number): DtfRevenueUsd;
+export declare function aggregateEcosystemRevenue(items: DtfRevenueUsd[]): EcosystemRevenue;
+/**
+ * Compute weighted (by TVL) and simple average fee metrics.
+ * Fees are D18 in subgraph — divide by 1e18 for decimal.
+ */
+export declare function computeFeeMetrics(raws: DtfRevenueRaw[], prices: Record<string, number>): FeeMetrics;
+/**
+ * Compute RSR burn projection from actual burn history + theoretical model.
+ *
+ * WHY: The theoretical "5% of TVL" formula overestimates by ~5x.
+ * Trailing average from actual monthly snapshots is the primary signal.
+ * Theoretical is kept as "Protocol Target" for context.
+ */
+export declare function computeRsrBurnProjection(burnData: RsrBurnData, rsrPrice: number, totalTvl: number): RsrBurnProjection;
+/**
+ * Compare latest month's burn vs trailing average.
+ * WHY: "Accuracy" against a broken theoretical was meaningless.
+ * Comparing latest vs trailing shows whether burns are accelerating or decelerating.
+ */
+export declare function computeBurnAccuracy(projection: RsrBurnProjection, burnData: RsrBurnData, rsrPrice: number): BurnAccuracy;
+/**
+ * Calculate total RSR locked in DTF stTokens.
+ * Checks each DTF's stToken.underlying.address against known RSR addresses.
+ */
+export declare function computeLockedRsr(raws: DtfRevenueRaw[], rsrAddresses: string[]): number;
+/**
+ * Binary search for the closest price record to a given timestamp.
+ * Expects prices sorted by timestamp ascending.
+ * Returns 0 if empty.
+ */
+export declare function nearestPrice(timestamp: number, prices: PriceRecord[]): number;
+/**
+ * Compute total historical USD value of burns using time-matched prices.
+ */
+export declare function computeHistoricalBurnTotals(burns: RsrBurnEvent[], prices: PriceRecord[]): {
+    totalBurnedUsdHistorical: number;
+};
+//# sourceMappingURL=compute-revenue.d.ts.map

package/dist/revenue/compute-revenue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-revenue.d.ts","sourceRoot":"","sources":["../../src/revenue/compute-revenue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,iBAAiB,EAClB,MAAM,UAAU,CAAA;AAEjB;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,MAAM,GACZ,aAAa,CAaf;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,aAAa,EAAE,GACrB,gBAAgB,CA0BlB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,aAAa,EAAE,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,UAAU,CA+BZ;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,iBAAiB,CAiDnB;AAUD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,iBAAiB,EAC7B,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,MAAM,GACf,YAAY,CAoBd;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,EAAE,EACrB,YAAY,EAAE,MAAM,EAAE,GACrB,MAAM,CAiBR;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,EAAE,GACpB,MAAM,CAsBR;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,YAAY,EAAE,EACrB,MAAM,EAAE,WAAW,EAAE,GACpB;IAAE,wBAAwB,EAAE,MAAM,CAAA;CAAE,CAUtC"}