@reserve-protocol/dtf-sdk 0.1.0

package/dist/deploy/permissionless-defaults.js

@@ -0,0 +1,76 @@
+import { D18 } from '../constants';
+// -- Vote-lock DAO address per chain --
+export const VOTE_LOCK_ADDRESS = {
+    // WHY: Only Base has a permissionless vote-lock DAO deployed.
+    // Ethereum and BSC use zeroAddress as sentinel for "not available".
+    8453: '0xeDAB3789D7D2283214d8F65A6E412B00b1cBfB7a',
+    1: '0x0000000000000000000000000000000000000000',
+    56: '0x0000000000000000000000000000000000000000',
+};
+// -- Default fees (0.15% = D18 * 15 / 10000) --
+export const DEFAULT_TVL_FEE = (D18 * 15n) / 10000n;
+export const DEFAULT_MINT_FEE = (D18 * 15n) / 10000n;
+// -- Auction length (30 min) --
+export const DEFAULT_AUCTION_LENGTH = 1800n;
+// -- Default flags --
+export const DEFAULT_FLAGS = {
+    trustedFillerEnabled: true,
+    rebalanceControl: { weightControl: true, priceControl: 1 },
+    bidsEnabled: true,
+};
+// -- Governance params --
+// WHY: Both owner and trading governance use identical params for permissionless deploys.
+// This matches Register's frontend. They CAN differ for custom deploys, but the default
+// is symmetric. See: register/src/views/deploy/utils/governance.ts
+export const DEFAULT_TRADING_GOV_PARAMS = {
+    votingDelay: '0',
+    votingPeriod: '86400', // 24h
+    proposalThreshold: (D18 / 100n).toString(), // 1%
+    quorumThreshold: ((D18 * 3n) / 100n).toString(), // 3%
+    timelockDelay: '86400', // 24h
+};
+export const DEFAULT_OWNER_GOV_PARAMS = {
+    votingDelay: '0',
+    votingPeriod: '86400', // 24h
+    proposalThreshold: (D18 / 100n).toString(), // 1%
+    quorumThreshold: ((D18 * 3n) / 100n).toString(), // 3%
+    timelockDelay: '86400', // 24h
+};
+// -- Guardians (multi-sig addresses that can cancel proposals) --
+export const DEFAULT_GUARDIANS = {
+    8453: ['0x7f7b3795E017389bCF44BeE9Ba1A63Fe9e019094'],
+    1: [],
+    56: [],
+};
+// -- Trusted auction launchers --
+export const DEFAULT_AUCTION_LAUNCHERS = {
+    8453: [
+        '0x7f7b3795E017389bCF44BeE9Ba1A63Fe9e019094',
+        '0xe2a7B44c3Ca35F1F04e4e14a64F40E42f4e20D04',
+        '0xaDa7D4Ef3CaDF49A87d4D3a8FF80bD4cE7F0f2E0',
+        '0xE6B0F91Be5e46d2fD42c4eC88220F5d4dF4F3B64',
+        '0x32e77125db4a78A0697f3DEe6D7CC8F2d66a5D3D',
+    ],
+    1: [],
+    56: [],
+};
+// -- Fee recipients --
+// WHY: Platform fee portion depends on chain. Reserve takes 50% on Eth/Base, 33% on BSC.
+const PLATFORM_FEE_RECIPIENT = '0xaE8a796Bd9437fCd009B3B3fB41bF2d17D1E08A0';
+const PLATFORM_PORTIONS = {
+    1: (D18 * 50n) / 100n,
+    8453: (D18 * 50n) / 100n,
+    56: (D18 * 33n) / 100n,
+};
+// WHY: Returns string portions (not bigint) because the Zapper API accepts string-encoded values.
+// The on-chain DeployAdditionalDetails uses bigint portions — use the SDK's `buildDeployDtfCalldata`
+// with `FeeRecipient` type for direct contract interaction instead.
+export function buildDefaultFeeRecipients(chainId, stTokenAddress) {
+    const platformPortion = PLATFORM_PORTIONS[chainId] ?? (D18 * 50n) / 100n;
+    const governancePortion = D18 - platformPortion;
+    return [
+        { recipient: stTokenAddress, portion: governancePortion.toString() },
+        { recipient: PLATFORM_FEE_RECIPIENT, portion: platformPortion.toString() },
+    ];
+}
+//# sourceMappingURL=permissionless-defaults.js.map

package/dist/deploy/permissionless-defaults.js.map

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

package/dist/deploy/token-registry.d.ts

@@ -0,0 +1,9 @@
+import type { Address } from 'viem';
+import type { SupportedChainId } from '../types';
+export type TokenEntry = {
+    address: Address;
+    decimals: number;
+};
+export declare function resolveToken(chainId: SupportedChainId, symbolOrAddress: string): TokenEntry | null;
+export declare function getTokenRegistry(chainId: SupportedChainId): Record<string, TokenEntry>;
+//# sourceMappingURL=token-registry.d.ts.map

package/dist/deploy/token-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-registry.d.ts","sourceRoot":"","sources":["../../src/deploy/token-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAEhD,MAAM,MAAM,UAAU,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAA;AAgE/D,wBAAgB,YAAY,CAC1B,OAAO,EAAE,gBAAgB,EACzB,eAAe,EAAE,MAAM,GACtB,UAAU,GAAG,IAAI,CAQnB;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAE5B"}

package/dist/deploy/token-registry.js

@@ -0,0 +1,68 @@
+const BASE_TOKENS = {
+    WETH: { address: '0x4200000000000000000000000000000000000006', decimals: 18 },
+    USDC: { address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', decimals: 6 },
+    USDbC: { address: '0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA', decimals: 6 },
+    cbBTC: { address: '0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf', decimals: 8 },
+    cbETH: { address: '0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22', decimals: 18 },
+    DAI: { address: '0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb', decimals: 18 },
+    AERO: { address: '0x940181a94A35A4569E4529A3CDfB74e38FD98631', decimals: 18 },
+    RSR: { address: '0xaB36452DbAC151bE02b16Ca17d8919826072f64a', decimals: 18 },
+    VIRTUAL: { address: '0x0b3e328455c4059EEb9e3f84b5543F74E24e7E1b', decimals: 18 },
+    DEGEN: { address: '0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed', decimals: 18 },
+    BRETT: { address: '0x532f27101965dd16442E59d40670FaF5eBB142E4', decimals: 18 },
+    TOSHI: { address: '0xAC1Bd2486aAf3B5C0fc3Fd868558b082a531B2B4', decimals: 18 },
+    EURC: { address: '0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42', decimals: 6 },
+    WELL: { address: '0xA88594D404727625A9437C3f886C7643872296AE', decimals: 18 },
+    MORPHO: { address: '0xBAa5CC21fd487B8Fcc2F632f3F4E8D37262a0842', decimals: 18 },
+};
+const ETH_TOKENS = {
+    WETH: { address: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2', decimals: 18 },
+    USDC: { address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', decimals: 6 },
+    USDT: { address: '0xdAC17F958D2ee523a2206206994597C13D831ec7', decimals: 6 },
+    WBTC: { address: '0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599', decimals: 8 },
+    DAI: { address: '0x6B175474E89094C44Da98b954EedeAC495271d0F', decimals: 18 },
+    RSR: { address: '0x320623b8E4fF03373931769A31Fc52A4E78B5D70', decimals: 18 },
+    stETH: { address: '0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84', decimals: 18 },
+    rETH: { address: '0xae78736Cd615f374D3085123A210448E74Fc6393', decimals: 18 },
+    LINK: { address: '0x514910771AF9Ca656af840dff83E8264EcF986CA', decimals: 18 },
+    UNI: { address: '0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984', decimals: 18 },
+};
+// WHY: BSC USDC and USDT are Binance-Peg tokens with 18 decimals, NOT 6 like Ethereum.
+// BTCB is also 18 decimals. Do not "fix" these to match Ethereum — they are correct.
+const BSC_TOKENS = {
+    WBNB: { address: '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c', decimals: 18 },
+    USDC: { address: '0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d', decimals: 18 },
+    USDT: { address: '0x55d398326f99059fF775485246999027B3197955', decimals: 18 },
+    BTCB: { address: '0x7130d2A12B9BCbFAe4f2634d864A1Ee1Ce3Ead9c', decimals: 18 },
+    ETH: { address: '0x2170Ed0880ac9A755fd29B2688956BD959F933F8', decimals: 18 },
+    RSR: { address: '0x23f72a3Db61D6CB8aBE5d9AF1Ac4B6c99327bFee', decimals: 18 },
+    CAKE: { address: '0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82', decimals: 18 },
+    XRP: { address: '0x1D2F0da169ceB9fC7B3144628dB156f3F6c60dBE', decimals: 18 },
+};
+const REGISTRIES = {
+    1: ETH_TOKENS,
+    56: BSC_TOKENS,
+    8453: BASE_TOKENS,
+};
+// WHY: Pre-build case-insensitive lookup maps to avoid O(n) scan on every call.
+const LOOKUP_MAPS = new Map();
+for (const [chainId, registry] of Object.entries(REGISTRIES)) {
+    const map = new Map();
+    for (const [sym, entry] of Object.entries(registry)) {
+        map.set(sym.toUpperCase(), entry);
+    }
+    LOOKUP_MAPS.set(Number(chainId), map);
+}
+export function resolveToken(chainId, symbolOrAddress) {
+    // Raw address — caller fetches decimals separately
+    if (symbolOrAddress.startsWith('0x'))
+        return null;
+    const map = LOOKUP_MAPS.get(chainId);
+    if (!map)
+        return null;
+    return map.get(symbolOrAddress.toUpperCase()) ?? null;
+}
+export function getTokenRegistry(chainId) {
+    return REGISTRIES[chainId] ?? {};
+}
+//# sourceMappingURL=token-registry.js.map

package/dist/deploy/token-registry.js.map

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

package/dist/deploy/zap-deploy.d.ts

@@ -0,0 +1,4 @@
+import type { ZapDeployParams, ZapDeployResult } from '../types';
+export declare function submitZapDeploy(params: ZapDeployParams, baseUrl?: string): Promise<ZapDeployResult>;
+export declare const DEFAULT_DEPLOY_SLIPPAGE = 0.001;
+//# sourceMappingURL=zap-deploy.d.ts.map

package/dist/deploy/zap-deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zap-deploy.d.ts","sourceRoot":"","sources":["../../src/deploy/zap-deploy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAEhE,wBAAsB,eAAe,CACnC,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,MAA6B,GACrC,OAAO,CAAC,eAAe,CAAC,CAwD1B;AAED,eAAO,MAAM,uBAAuB,QAAQ,CAAA"}

package/dist/deploy/zap-deploy.js

@@ -0,0 +1,50 @@
+import { RESERVE_API_BASE_URL } from '../constants';
+import { fetchWithRetry } from '../utils/fetch-with-retry';
+export async function submitZapDeploy(params, baseUrl = RESERVE_API_BASE_URL) {
+    // WHY: Governed vs ungoverned endpoint is determined by stToken presence.
+    // If stToken is set, we're deploying a governed DTF with DAO governance.
+    const endpoint = params.stToken
+        ? `${baseUrl}/zapper/${params.chainId}/deploy`
+        : `${baseUrl}/zapper/${params.chainId}/deploy-ungoverned`;
+    const body = {
+        tokenIn: params.tokenIn,
+        amountIn: params.amountIn,
+        signer: params.signer,
+        slippage: params.slippage ?? DEFAULT_DEPLOY_SLIPPAGE,
+        basicDetails: params.basicDetails,
+        additionalDetails: params.additionalDetails,
+        folioFlags: params.folioFlags,
+    };
+    if (params.stToken) {
+        body.stToken = params.stToken;
+    }
+    if (params.ownerGovParams) {
+        body.ownerGovParams = params.ownerGovParams;
+    }
+    if (params.tradingGovParams) {
+        body.tradingGovParams = params.tradingGovParams;
+    }
+    if (params.basketManagers) {
+        body.basketManagers = params.basketManagers;
+    }
+    if (params.auctionLaunchers) {
+        body.auctionLaunchers = params.auctionLaunchers;
+    }
+    if (params.brandManagers) {
+        body.brandManagers = params.brandManagers;
+    }
+    // WHY: POST is not idempotent — retrying could produce stale quotes or confusing errors.
+    // Use retries: 0 for deploy, unlike read-only endpoints.
+    const response = await fetchWithRetry(endpoint, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+    }, { retries: 0 });
+    if (!response.ok) {
+        const text = await response.text().catch(() => 'unknown error');
+        throw new Error(`Zapper deploy API failed (chain ${params.chainId}): ${response.status} — ${text}`);
+    }
+    return (await response.json());
+}
+export const DEFAULT_DEPLOY_SLIPPAGE = 0.001;
+//# sourceMappingURL=zap-deploy.js.map

package/dist/deploy/zap-deploy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zap-deploy.js","sourceRoot":"","sources":["../../src/deploy/zap-deploy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAG1D,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAuB,EACvB,UAAkB,oBAAoB;IAEtC,0EAA0E;IAC1E,yEAAyE;IACzE,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO;QAC7B,CAAC,CAAC,GAAG,OAAO,WAAW,MAAM,CAAC,OAAO,SAAS;QAC9C,CAAC,CAAC,GAAG,OAAO,WAAW,MAAM,CAAC,OAAO,oBAAoB,CAAA;IAE3D,MAAM,IAAI,GAA4B;QACpC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,uBAAuB;QACpD,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;QAC3C,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAA;IAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAA;IAC/B,CAAC;IACD,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC1B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAA;IAC7C,CAAC;IACD,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5B,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAA;IACjD,CAAC;IACD,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC1B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAA;IAC7C,CAAC;IACD,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5B,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAA;IACjD,CAAC;IACD,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACzB,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAA;IAC3C,CAAC;IAED,yFAAyF;IACzF,yDAAyD;IACzD,MAAM,QAAQ,GAAG,MAAM,cAAc,CACnC,QAAQ,EACR;QACE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;KAC3B,EACD,EAAE,OAAO,EAAE,CAAC,EAAE,CACf,CAAA;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,CAAA;QAC/D,MAAM,IAAI,KAAK,CACb,mCAAmC,MAAM,CAAC,OAAO,MAAM,QAAQ,CAAC,MAAM,MAAM,IAAI,EAAE,CACnF,CAAA;IACH,CAAC;IAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAoB,CAAA;AACnD,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAA"}

package/dist/dtf/fees.d.ts

@@ -0,0 +1,10 @@
+import { type Address, type PublicClient } from 'viem';
+import type { FeeRecipient, PendingFees, TransactionRequest } from '../types';
+export declare function readPendingFees(publicClient: PublicClient, folioAddress: Address): Promise<PendingFees>;
+export declare function readFeeRecipients(publicClient: PublicClient, folioAddress: Address): Promise<FeeRecipient[]>;
+export declare function parseFeeRecipients(str: string): FeeRecipient[];
+export declare function buildDistributeFeesCalldata(folioAddress: Address): TransactionRequest;
+export declare function buildSetMintFeeCalldata(folioAddress: Address, fee: bigint): TransactionRequest;
+export declare function buildSetTvlFeeCalldata(folioAddress: Address, fee: bigint): TransactionRequest;
+export declare function buildSetFeeRecipientsCalldata(folioAddress: Address, recipients: FeeRecipient[]): TransactionRequest;
+//# sourceMappingURL=fees.d.ts.map

package/dist/dtf/fees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fees.d.ts","sourceRoot":"","sources":["../../src/dtf/fees.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,MAAM,CAAA;AAE1E,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAE7E,wBAAsB,eAAe,CACnC,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,WAAW,CAAC,CA+BtB;AAED,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,YAAY,EAAE,CAAC,CAqBzB;AAID,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,EAAE,CAS9D;AAED,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,OAAO,GACpB,kBAAkB,CAQpB;AAED,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,OAAO,EACrB,GAAG,EAAE,MAAM,GACV,kBAAkB,CASpB;AAED,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,OAAO,EACrB,GAAG,EAAE,MAAM,GACV,kBAAkB,CASpB;AAED,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,OAAO,EACrB,UAAU,EAAE,YAAY,EAAE,GACzB,kBAAkB,CASpB"}

package/dist/dtf/fees.js

@@ -0,0 +1,103 @@
+import { encodeFunctionData } from 'viem';
+import folioAbi from '../abi/folio';
+export async function readPendingFees(publicClient, folioAddress) {
+    const results = await publicClient.multicall({
+        contracts: [
+            {
+                address: folioAddress,
+                abi: folioAbi,
+                functionName: 'getPendingFeeShares',
+            },
+            {
+                address: folioAddress,
+                abi: folioAbi,
+                functionName: 'feeRecipientsPendingFeeShares',
+            },
+            {
+                address: folioAddress,
+                abi: folioAbi,
+                functionName: 'daoPendingFeeShares',
+            },
+        ],
+    });
+    // WHY: Pending fees are display-only (advisory). Defaulting to 0n on failure is safe —
+    // it means "show no pending fees" rather than silently corrupting a transaction.
+    const total = results[0].status === 'success' ? results[0].result : 0n;
+    const folio = results[1].status === 'success' ? results[1].result : 0n;
+    const dao = results[2].status === 'success' ? results[2].result : 0n;
+    return { total, folio, dao };
+}
+export async function readFeeRecipients(publicClient, folioAddress) {
+    // WHY: feeRecipients(uint256) is indexed — no length getter. We try 0..9 and stop at the first
+    // revert. 10 is generous; real DTFs rarely have more than 3.
+    const indices = Array.from({ length: 10 }, (_, i) => i);
+    const results = await publicClient.multicall({
+        contracts: indices.map((i) => ({
+            address: folioAddress,
+            abi: folioAbi,
+            functionName: 'feeRecipients',
+            args: [BigInt(i)],
+        })),
+    });
+    const recipients = [];
+    for (const r of results) {
+        if (r.status !== 'success')
+            break;
+        const [recipient, portion] = r.result;
+        recipients.push({ recipient, portion });
+    }
+    return recipients;
+}
+// WHY: Subgraph stores fee recipients as "addr:portion,addr:portion" strings.
+// This parser bridges subgraph responses → typed FeeRecipient[].
+export function parseFeeRecipients(str) {
+    if (!str || str.trim() === '')
+        return [];
+    return str.split(',').map((entry) => {
+        const [recipient, portionStr] = entry.trim().split(':');
+        return {
+            recipient: recipient,
+            portion: BigInt(portionStr ?? '0'),
+        };
+    });
+}
+export function buildDistributeFeesCalldata(folioAddress) {
+    return {
+        to: folioAddress,
+        data: encodeFunctionData({
+            abi: folioAbi,
+            functionName: 'distributeFees',
+        }),
+    };
+}
+export function buildSetMintFeeCalldata(folioAddress, fee) {
+    return {
+        to: folioAddress,
+        data: encodeFunctionData({
+            abi: folioAbi,
+            functionName: 'setMintFee',
+            args: [fee],
+        }),
+    };
+}
+export function buildSetTvlFeeCalldata(folioAddress, fee) {
+    return {
+        to: folioAddress,
+        data: encodeFunctionData({
+            abi: folioAbi,
+            functionName: 'setTVLFee',
+            args: [fee],
+        }),
+    };
+}
+export function buildSetFeeRecipientsCalldata(folioAddress, recipients) {
+    return {
+        to: folioAddress,
+        data: encodeFunctionData({
+            abi: folioAbi,
+            functionName: 'setFeeRecipients',
+            args: [recipients],
+        }),
+    };
+}
+//# sourceMappingURL=fees.js.map

package/dist/dtf/fees.js.map

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

package/dist/dtf/fetch-analytics.d.ts

@@ -0,0 +1,27 @@
+import type { RebalanceHistoryItem, RebalanceDetail, HistoricalDtfPoint, HistoricalPricePoint } from '../types';
+export declare function fetchRebalanceHistory(chainId: number, folioAddress: string, opts?: {
+    skip?: number;
+    limit?: number;
+}, baseUrl?: string): Promise<RebalanceHistoryItem[]>;
+export declare function fetchRebalanceDetail(chainId: number, folioAddress: string, nonce: number, baseUrl?: string): Promise<RebalanceDetail>;
+/**
+ * Fetch historical DTF data (price, totalSupply, basket over time).
+ * WHY: API requires `from` + `to` unix timestamps + `interval`, not `days`.
+ * Register uses this pattern in use-dtf-price-history.ts.
+ */
+export declare function fetchHistoricalDtf(chainId: number, folioAddress: string, opts?: {
+    from?: number;
+    to?: number;
+    interval?: '1h' | '1d';
+}, baseUrl?: string): Promise<HistoricalDtfPoint[]>;
+/**
+ * Fetch historical token prices over time.
+ * WHY: API requires `from` + `to` unix timestamps + `interval`, not `days`.
+ * Register uses this in use-dtf-price-history.ts.
+ */
+export declare function fetchHistoricalPrices(chainId: number, tokenAddress: string, opts?: {
+    from?: number;
+    to?: number;
+    interval?: '1h' | '1d';
+}, baseUrl?: string): Promise<HistoricalPricePoint[]>;
+//# sourceMappingURL=fetch-analytics.d.ts.map

package/dist/dtf/fetch-analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-analytics.d.ts","sourceRoot":"","sources":["../../src/dtf/fetch-analytics.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,UAAU,CAAA;AAEjB,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EACxC,OAAO,GAAE,MAA6B,GACrC,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAajC;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,MAA6B,GACrC,OAAO,CAAC,eAAe,CAAC,CAW1B;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;CAAE,EAC7D,OAAO,GAAE,MAA6B,GACrC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAsB/B;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;CAAE,EAC7D,OAAO,GAAE,MAA6B,GACrC,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAoBjC"}

package/dist/dtf/fetch-analytics.js

@@ -0,0 +1,63 @@
+import { RESERVE_API_BASE_URL } from '../constants';
+import { fetchWithRetry } from '../utils/fetch-with-retry';
+export async function fetchRebalanceHistory(chainId, folioAddress, opts, baseUrl = RESERVE_API_BASE_URL) {
+    const skip = opts?.skip ?? 0;
+    const limit = opts?.limit ?? 50;
+    const url = `${baseUrl}/dtf/rebalance?address=${folioAddress.toLowerCase()}&chainId=${chainId}&skip=${skip}&limit=${limit}`;
+    const response = await fetchWithRetry(url);
+    if (!response.ok) {
+        throw new Error(`Reserve API /dtf/rebalance failed: ${response.status} ${response.statusText}`);
+    }
+    return (await response.json());
+}
+export async function fetchRebalanceDetail(chainId, folioAddress, nonce, baseUrl = RESERVE_API_BASE_URL) {
+    const url = `${baseUrl}/dtf/rebalance?address=${folioAddress.toLowerCase()}&chainId=${chainId}&nonce=${nonce}`;
+    const response = await fetchWithRetry(url);
+    if (!response.ok) {
+        throw new Error(`Reserve API /dtf/rebalance detail failed: ${response.status} ${response.statusText}`);
+    }
+    return (await response.json());
+}
+/**
+ * Fetch historical DTF data (price, totalSupply, basket over time).
+ * WHY: API requires `from` + `to` unix timestamps + `interval`, not `days`.
+ * Register uses this pattern in use-dtf-price-history.ts.
+ */
+export async function fetchHistoricalDtf(chainId, folioAddress, opts, baseUrl = RESERVE_API_BASE_URL) {
+    const now = Math.floor(Date.now() / 1000);
+    const to = opts?.to ?? now;
+    const from = opts?.from ?? to - 30 * 86400; // default: 30 days back
+    const interval = opts?.interval ?? '1h';
+    const url = `${baseUrl}/historical/dtf?address=${folioAddress.toLowerCase()}&chainId=${chainId}&from=${from}&to=${to}&interval=${interval}`;
+    const response = await fetchWithRetry(url);
+    if (!response.ok) {
+        throw new Error(`Reserve API /historical/dtf failed: ${response.status} ${response.statusText}`);
+    }
+    // WHY: API wraps timeseries in { address, timeseries: [...] }
+    const data = await response.json();
+    // Handle both wrapped and unwrapped response shapes
+    if (Array.isArray(data))
+        return data;
+    return data.timeseries ?? [];
+}
+/**
+ * Fetch historical token prices over time.
+ * WHY: API requires `from` + `to` unix timestamps + `interval`, not `days`.
+ * Register uses this in use-dtf-price-history.ts.
+ */
+export async function fetchHistoricalPrices(chainId, tokenAddress, opts, baseUrl = RESERVE_API_BASE_URL) {
+    const now = Math.floor(Date.now() / 1000);
+    const to = opts?.to ?? now;
+    const from = opts?.from ?? to - 30 * 86400;
+    const interval = opts?.interval ?? '1h';
+    const url = `${baseUrl}/historical/prices?address=${tokenAddress.toLowerCase()}&chainId=${chainId}&from=${from}&to=${to}&interval=${interval}`;
+    const response = await fetchWithRetry(url);
+    if (!response.ok) {
+        throw new Error(`Reserve API /historical/prices failed: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    if (Array.isArray(data))
+        return data;
+    return data.timeseries ?? [];
+}
+//# sourceMappingURL=fetch-analytics.js.map

package/dist/dtf/fetch-analytics.js.map

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

package/dist/dtf/fetch-basket.d.ts

@@ -0,0 +1,16 @@
+import type { DtfBasketResponse } from '../types';
+/**
+ * Fetch DTF basket composition with consensus prices, weights, and DTF price.
+ * Uses the Reserve API `/current/dtf` endpoint — one call instead of RPC + price API.
+ *
+ * For raw bigint balances (needed by dtf-rebalance-lib), use `readBasket()` instead.
+ */
+export declare function fetchDtfBasket(chainId: number, folioAddress: string, baseUrl?: string): Promise<DtfBasketResponse>;
+/**
+ * Batch fetch multiple DTF baskets in one call.
+ * Uses the Reserve API `/current/dtfs` endpoint.
+ */
+export declare function fetchDtfBaskets(chainId: number, folioAddresses: string[], baseUrl?: string): Promise<(DtfBasketResponse & {
+    address: string;
+})[]>;
+//# sourceMappingURL=fetch-basket.d.ts.map

package/dist/dtf/fetch-basket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-basket.d.ts","sourceRoot":"","sources":["../../src/dtf/fetch-basket.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAEjD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,MAA6B,GACrC,OAAO,CAAC,iBAAiB,CAAC,CAW5B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EAAE,EACxB,OAAO,GAAE,MAA6B,GACrC,OAAO,CAAC,CAAC,iBAAiB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,CAAC,CActD"}

package/dist/dtf/fetch-basket.js

@@ -0,0 +1,32 @@
+import { RESERVE_API_BASE_URL } from '../constants';
+import { fetchWithRetry } from '../utils/fetch-with-retry';
+/**
+ * Fetch DTF basket composition with consensus prices, weights, and DTF price.
+ * Uses the Reserve API `/current/dtf` endpoint — one call instead of RPC + price API.
+ *
+ * For raw bigint balances (needed by dtf-rebalance-lib), use `readBasket()` instead.
+ */
+export async function fetchDtfBasket(chainId, folioAddress, baseUrl = RESERVE_API_BASE_URL) {
+    const url = `${baseUrl}/current/dtf?address=${folioAddress.toLowerCase()}&chainId=${chainId}`;
+    const response = await fetchWithRetry(url);
+    if (!response.ok) {
+        throw new Error(`Reserve API /current/dtf failed: ${response.status} ${response.statusText}`);
+    }
+    return (await response.json());
+}
+/**
+ * Batch fetch multiple DTF baskets in one call.
+ * Uses the Reserve API `/current/dtfs` endpoint.
+ */
+export async function fetchDtfBaskets(chainId, folioAddresses, baseUrl = RESERVE_API_BASE_URL) {
+    const addresses = folioAddresses
+        .map((a) => a.toLowerCase())
+        .join(',');
+    const url = `${baseUrl}/current/dtfs?addresses=${addresses}&chainId=${chainId}`;
+    const response = await fetchWithRetry(url);
+    if (!response.ok) {
+        throw new Error(`Reserve API /current/dtfs failed: ${response.status} ${response.statusText}`);
+    }
+    return (await response.json());
+}
+//# sourceMappingURL=fetch-basket.js.map

package/dist/dtf/fetch-basket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-basket.js","sourceRoot":"","sources":["../../src/dtf/fetch-basket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAG1D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAe,EACf,YAAoB,EACpB,UAAkB,oBAAoB;IAEtC,MAAM,GAAG,GAAG,GAAG,OAAO,wBAAwB,YAAY,CAAC,WAAW,EAAE,YAAY,OAAO,EAAE,CAAA;IAE7F,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,CAAA;IAC1C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,oCAAoC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAC7E,CAAA;IACH,CAAC;IAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAsB,CAAA;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAe,EACf,cAAwB,EACxB,UAAkB,oBAAoB;IAEtC,MAAM,SAAS,GAAG,cAAc;SAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC3B,IAAI,CAAC,GAAG,CAAC,CAAA;IACZ,MAAM,GAAG,GAAG,GAAG,OAAO,2BAA2B,SAAS,YAAY,OAAO,EAAE,CAAA;IAE/E,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,CAAA;IAC1C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,qCAAqC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAC9E,CAAA;IACH,CAAC;IAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAgD,CAAA;AAC/E,CAAC"}

package/dist/dtf/fetch-discover.d.ts

@@ -0,0 +1,10 @@
+import type { DtfDiscoverItem } from '../types';
+/**
+ * Discover DTFs on a given chain.
+ * Returns paginated list sorted by market cap, with performance history and brand data.
+ */
+export declare function fetchDtfDiscover(chainId: number, opts?: {
+    skip?: number;
+    limit?: number;
+}, baseUrl?: string): Promise<DtfDiscoverItem[]>;
+//# sourceMappingURL=fetch-discover.d.ts.map

package/dist/dtf/fetch-discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-discover.d.ts","sourceRoot":"","sources":["../../src/dtf/fetch-discover.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE/C;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EACxC,OAAO,GAAE,MAA6B,GACrC,OAAO,CAAC,eAAe,EAAE,CAAC,CAa5B"}

package/dist/dtf/fetch-discover.js

@@ -0,0 +1,17 @@
+import { RESERVE_API_BASE_URL } from '../constants';
+import { fetchWithRetry } from '../utils/fetch-with-retry';
+/**
+ * Discover DTFs on a given chain.
+ * Returns paginated list sorted by market cap, with performance history and brand data.
+ */
+export async function fetchDtfDiscover(chainId, opts, baseUrl = RESERVE_API_BASE_URL) {
+    const skip = opts?.skip ?? 0;
+    const limit = opts?.limit ?? 25;
+    const url = `${baseUrl}/discover/dtf?chainId=${chainId}&skip=${skip}&limit=${limit}`;
+    const response = await fetchWithRetry(url);
+    if (!response.ok) {
+        throw new Error(`Reserve API /discover/dtf failed: ${response.status} ${response.statusText}`);
+    }
+    return (await response.json());
+}
+//# sourceMappingURL=fetch-discover.js.map

package/dist/dtf/fetch-discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-discover.js","sourceRoot":"","sources":["../../src/dtf/fetch-discover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAG1D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAe,EACf,IAAwC,EACxC,UAAkB,oBAAoB;IAEtC,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,CAAC,CAAA;IAC5B,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,EAAE,CAAA;IAC/B,MAAM,GAAG,GAAG,GAAG,OAAO,yBAAyB,OAAO,SAAS,IAAI,UAAU,KAAK,EAAE,CAAA;IAEpF,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,CAAA;IAC1C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,qCAAqC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAC9E,CAAA;IACH,CAAC;IAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAsB,CAAA;AACrD,CAAC"}

package/dist/dtf/fetch-dtf.d.ts

@@ -0,0 +1,25 @@
+import type { Address, Hex } from 'viem';
+import type { VoteLockPosition } from '../types';
+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;
+};
+/**
+ * Fetch the current price of a DTF from the Reserve API.
+ * WHY: Uses /current/dtf endpoint (not the dead /dtf/price).
+ * Register uses this same endpoint in use-dtf-price.ts.
+ */
+export declare function fetchDtfPrice(chainId: number, folioAddress: string, baseUrl?: string): Promise<number>;
+export declare function fetchZapQuote(chainId: number, params: ZapQuoteParams, baseUrl?: string): Promise<ZapQuote>;
+export declare function fetchVoteLockPositions(baseUrl?: string): Promise<VoteLockPosition[]>;
+//# sourceMappingURL=fetch-dtf.d.ts.map

package/dist/dtf/fetch-dtf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-dtf.d.ts","sourceRoot":"","sources":["../../src/dtf/fetch-dtf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAExC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAGhD,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;IACf,SAAS,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,EAAE,EAAE,OAAO,CAAA;IACX,IAAI,EAAE,GAAG,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,MAA6B,GACrC,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,MAA6B,GACrC,OAAO,CAAC,QAAQ,CAAC,CAuBnB;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,GAAE,MAA6B,GACrC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAS7B"}