@reserve-protocol/dtf-sdk 0.1.0

package/dist/dtf/fetch-dtf.js

@@ -0,0 +1,39 @@
+import { RESERVE_API_BASE_URL } from '../constants';
+import { fetchWithRetry } from '../utils/fetch-with-retry';
+/**
+ * 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 async function fetchDtfPrice(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 for ${folioAddress}: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    return data.price;
+}
+export async function fetchZapQuote(chainId, params, baseUrl = RESERVE_API_BASE_URL) {
+    const url = `${baseUrl}/zapper/${chainId}/swap?tokenIn=${params.tokenIn.toLowerCase()}&tokenOut=${params.tokenOut.toLowerCase()}&amountIn=${params.amountIn.toString()}&slippage=${params.slippage}&sender=${params.sender.toLowerCase()}&recipient=${params.recipient.toLowerCase()}`;
+    const response = await fetchWithRetry(url);
+    if (!response.ok) {
+        throw new Error(`Reserve API /zapper/swap failed: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    return {
+        amountOut: BigInt(data.amountOut),
+        to: data.to,
+        data: data.data,
+        value: BigInt(data.value),
+    };
+}
+export async function fetchVoteLockPositions(baseUrl = RESERVE_API_BASE_URL) {
+    const url = `${baseUrl}/dtf/daos`;
+    const response = await fetchWithRetry(url);
+    if (!response.ok) {
+        throw new Error(`Reserve API /dtf/daos failed: ${response.status} ${response.statusText}`);
+    }
+    return (await response.json());
+}
+//# sourceMappingURL=fetch-dtf.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-dtf.js","sourceRoot":"","sources":["../../src/dtf/fetch-dtf.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAkB1D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,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,uCAAuC,YAAY,KAAK,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CACjG,CAAA;IACH,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAsB,CAAA;IACzD,OAAO,IAAI,CAAC,KAAK,CAAA;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAe,EACf,MAAsB,EACtB,UAAkB,oBAAoB;IAEtC,MAAM,GAAG,GAAG,GAAG,OAAO,WAAW,OAAO,iBAAiB,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,aAAa,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,aAAa,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,aAAa,MAAM,CAAC,QAAQ,WAAW,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,cAAc,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,CAAA;IAEtR,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,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAKlC,CAAA;IAED,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;QACjC,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;KAC1B,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,UAAkB,oBAAoB;IAEtC,MAAM,GAAG,GAAG,GAAG,OAAO,WAAW,CAAA;IACjC,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,CAAA;IAC1C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,iCAAiC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAC1E,CAAA;IACH,CAAC;IACD,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAuB,CAAA;AACtD,CAAC"}

package/dist/dtf/mint.d.ts

@@ -0,0 +1,9 @@
+import { type Address, type PublicClient } from 'viem';
+import type { MintQuote, TransactionRequest } from '../types';
+export declare function readMintQuote(publicClient: PublicClient, folioAddress: Address, shares: bigint): Promise<MintQuote>;
+export declare function readMintFee(publicClient: PublicClient, folioAddress: Address): Promise<bigint>;
+export declare function buildMintCalldata(folioAddress: Address, shares: bigint, receiver: Address, minSharesOut: bigint): TransactionRequest;
+export declare function buildApproveCalldata(token: Address, spender: Address, amount: bigint): TransactionRequest;
+export declare function readAllowances(publicClient: PublicClient, tokens: Address[], owner: Address, spender: Address): Promise<bigint[]>;
+export declare function applySlippage(amount: bigint, slippageBps: bigint): bigint;
+//# sourceMappingURL=mint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mint.d.ts","sourceRoot":"","sources":["../../src/dtf/mint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,MAAM,CAAA;AAI1E,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAG7D,wBAAsB,aAAa,CACjC,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,OAAO,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,CAAC,CA4BpB;AAED,wBAAsB,WAAW,CAC/B,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,OAAO,EACrB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,EACjB,YAAY,EAAE,MAAM,GACnB,kBAAkB,CAUpB;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GACb,kBAAkB,CASpB;AAED,wBAAsB,cAAc,CAClC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,OAAO,EAAE,EACjB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBnB;AAGD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAOzE"}

package/dist/dtf/mint.js

@@ -0,0 +1,82 @@
+import { encodeFunctionData } from 'viem';
+import folioAbi from '../abi/folio';
+import { ERC20_META_ABI } from '../abi/erc20';
+import { D18 } from '../constants';
+import { assert } from '../utils/assert';
+export async function readMintQuote(publicClient, folioAddress, shares) {
+    const results = await publicClient.multicall({
+        contracts: [
+            {
+                address: folioAddress,
+                abi: folioAbi,
+                functionName: 'toAssets',
+                // WHY: Ceil rounding (1) — user pays the rounded-up amount to prevent undercollateralization
+                args: [shares, 1],
+            },
+            {
+                address: folioAddress,
+                abi: folioAbi,
+                functionName: 'mintFee',
+            },
+        ],
+    });
+    if (results[0].status !== 'success')
+        throw new Error(`toAssets failed for ${folioAddress} with ${shares} shares`);
+    if (results[1].status !== 'success')
+        throw new Error(`mintFee failed for ${folioAddress}`);
+    const [assets, amounts] = results[0].result;
+    const mintFee = results[1].result;
+    const minSharesOut = shares - (shares * mintFee) / D18;
+    return { shares, assets, amounts, mintFee, minSharesOut };
+}
+export async function readMintFee(publicClient, folioAddress) {
+    return (await publicClient.readContract({
+        address: folioAddress,
+        abi: folioAbi,
+        functionName: 'mintFee',
+    }));
+}
+export function buildMintCalldata(folioAddress, shares, receiver, minSharesOut) {
+    assert(shares > 0n, 'shares must be greater than 0');
+    return {
+        to: folioAddress,
+        data: encodeFunctionData({
+            abi: folioAbi,
+            functionName: 'mint',
+            args: [shares, receiver, minSharesOut],
+        }),
+    };
+}
+export function buildApproveCalldata(token, spender, amount) {
+    return {
+        to: token,
+        data: encodeFunctionData({
+            abi: ERC20_META_ABI,
+            functionName: 'approve',
+            args: [spender, amount],
+        }),
+    };
+}
+export async function readAllowances(publicClient, tokens, owner, spender) {
+    if (tokens.length === 0)
+        return [];
+    const results = await publicClient.multicall({
+        contracts: tokens.map((token) => ({
+            address: token,
+            abi: ERC20_META_ABI,
+            functionName: 'allowance',
+            args: [owner, spender],
+        })),
+    });
+    // WHY: Defaulting failed allowance to 0n is conservative — it means "needs approval".
+    // This is safer than throwing, since the caller will just prompt an approve tx.
+    return results.map((r) => r.status === 'success' ? r.result : 0n);
+}
+// WHY: bps (basis points) not percentage — 100 bps = 1%, matches DeFi convention
+export function applySlippage(amount, slippageBps) {
+    if (slippageBps < 0n || slippageBps > 10000n) {
+        throw new Error(`slippageBps must be between 0 and 10000, got ${slippageBps}`);
+    }
+    return amount - (amount * slippageBps) / 10000n;
+}
+//# sourceMappingURL=mint.js.map

package/dist/dtf/mint.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-basket.d.ts","sourceRoot":"","sources":["../../src/dtf/read-basket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAGjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C,wBAAsB,UAAU,CAC9B,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,UAAU,CAAC,CAkBrB"}

package/dist/dtf/read-basket.js

@@ -0,0 +1,20 @@
+import folioAbi from '../abi/folio';
+import { fetchTokenMetadata } from '../utils/fetch-token-metadata';
+export async function readBasket(publicClient, folioAddress) {
+    const [assetsResult, totalSupply] = await Promise.all([
+        publicClient.readContract({
+            address: folioAddress,
+            abi: folioAbi,
+            functionName: 'totalAssets',
+        }),
+        publicClient.readContract({
+            address: folioAddress,
+            abi: folioAbi,
+            functionName: 'totalSupply',
+        }),
+    ]);
+    const [addresses, balances] = assetsResult;
+    const tokens = await fetchTokenMetadata(publicClient, addresses);
+    return { tokens, balances, totalSupply };
+}
+//# sourceMappingURL=read-basket.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-basket.js","sourceRoot":"","sources":["../../src/dtf/read-basket.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,cAAc,CAAA;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAGlE,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,YAA0B,EAC1B,YAAqB;IAErB,MAAM,CAAC,YAAY,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACpD,YAAY,CAAC,YAAY,CAAC;YACxB,OAAO,EAAE,YAAY;YACrB,GAAG,EAAE,QAAQ;YACb,YAAY,EAAE,aAAa;SAC5B,CAAmC;QACpC,YAAY,CAAC,YAAY,CAAC;YACxB,OAAO,EAAE,YAAY;YACrB,GAAG,EAAE,QAAQ;YACb,YAAY,EAAE,aAAa;SAC5B,CAAoB;KACtB,CAAC,CAAA;IAEF,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,YAAY,CAAA;IAC1C,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,YAAY,EAAE,SAAS,CAAC,CAAA;IAEhE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAA;AAC1C,CAAC"}

package/dist/dtf/read-config.d.ts

@@ -0,0 +1,4 @@
+import type { Address, PublicClient } from 'viem';
+import type { DtfOnchainConfig, SupportedChainId } from '../types';
+export declare function fetchDtfConfig(publicClient: PublicClient, chainId: SupportedChainId, folioAddress: Address): Promise<DtfOnchainConfig>;
+//# sourceMappingURL=read-config.d.ts.map

package/dist/dtf/read-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-config.d.ts","sourceRoot":"","sources":["../../src/dtf/read-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AACjD,OAAO,KAAK,EACV,gBAAgB,EAEhB,gBAAgB,EACjB,MAAM,UAAU,CAAA;AAmFjB,wBAAsB,cAAc,CAClC,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,gBAAgB,EACzB,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,gBAAgB,CAAC,CA+B3B"}

package/dist/dtf/read-config.js

@@ -0,0 +1,80 @@
+import { fetchTokenMetadata } from '../utils/fetch-token-metadata';
+import { querySubgraph } from '../utils/query-subgraph';
+import folioAbi from '../abi/folio';
+const GOV_FRAGMENT = `
+  id
+  votingDelay
+  votingPeriod
+  timelock {
+    id
+    executionDelay
+  }
+`;
+const DTF_QUERY = `
+  query getDTF($id: String!) {
+    dtf(id: $id) {
+      id
+      auctionLength
+      mandate
+      tvlFee
+      mintingFee
+      auctionLaunchers
+      brandManagers
+      ownerGovernance {
+        ${GOV_FRAGMENT}
+      }
+      tradingGovernance {
+        ${GOV_FRAGMENT}
+      }
+      stToken {
+        id
+        governance {
+          ${GOV_FRAGMENT}
+        }
+      }
+    }
+  }
+`;
+function parseGovernance(raw) {
+    if (!raw?.id)
+        return null;
+    // NOTE: If subgraph returns governor without timelock, we use zero address.
+    // This is defensive — in practice every deployed governor has a timelock.
+    return {
+        address: raw.id,
+        timelockAddress: (raw.timelock?.id ?? '0x0000000000000000000000000000000000000000'),
+        votingDelay: Number(raw.votingDelay ?? 0),
+        votingPeriod: Number(raw.votingPeriod ?? 0),
+        executionDelay: Number(raw.timelock?.executionDelay ?? 0),
+    };
+}
+export async function fetchDtfConfig(publicClient, chainId, folioAddress) {
+    const data = await querySubgraph(chainId, DTF_QUERY, {
+        id: folioAddress.toLowerCase(),
+    });
+    const dtf = data?.dtf;
+    if (!dtf)
+        throw new Error(`DTF not found: ${folioAddress}`);
+    // Read basket tokens on-chain (subgraph doesn't expose basket)
+    const [assets] = (await publicClient.readContract({
+        address: folioAddress,
+        abi: folioAbi,
+        functionName: 'totalAssets',
+    }));
+    const tokens = await fetchTokenMetadata(publicClient, assets);
+    return {
+        tokens,
+        // WHY: 300s is the protocol minimum auction length — safe fallback if subgraph omits it
+        auctionLength: Number(dtf.auctionLength ?? 300),
+        ownerGovernance: parseGovernance(dtf.ownerGovernance),
+        tradingGovernance: parseGovernance(dtf.tradingGovernance),
+        stTokenGovernance: parseGovernance(dtf.stToken?.governance),
+        stTokenAddress: (dtf.stToken?.id ?? null),
+        mandate: dtf.mandate ?? '',
+        tvlFee: dtf.tvlFee ?? '0',
+        mintingFee: dtf.mintingFee ?? '0',
+        auctionLaunchers: (dtf.auctionLaunchers ?? []),
+        brandManagers: (dtf.brandManagers ?? []),
+    };
+}
+//# sourceMappingURL=read-config.js.map

package/dist/dtf/read-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-config.js","sourceRoot":"","sources":["../../src/dtf/read-config.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,QAAQ,MAAM,cAAc,CAAA;AA+BnC,MAAM,YAAY,GAAG;;;;;;;;CAQpB,CAAA;AAED,MAAM,SAAS,GAAG;;;;;;;;;;;UAWR,YAAY;;;UAGZ,YAAY;;;;;YAKV,YAAY;;;;;CAKvB,CAAA;AAED,SAAS,eAAe,CAAC,GAA0C;IACjE,IAAI,CAAC,GAAG,EAAE,EAAE;QAAE,OAAO,IAAI,CAAA;IACzB,4EAA4E;IAC5E,0EAA0E;IAC1E,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,EAAa;QAC1B,eAAe,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,4CAA4C,CAAY;QAC9F,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,CAAC;QACzC,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,CAAC;QAC3C,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,cAAc,IAAI,CAAC,CAAC;KAC1D,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,YAA0B,EAC1B,OAAyB,EACzB,YAAqB;IAErB,MAAM,IAAI,GAAG,MAAM,aAAa,CAAmB,OAAO,EAAE,SAAS,EAAE;QACrE,EAAE,EAAE,YAAY,CAAC,WAAW,EAAE;KAC/B,CAAC,CAAA;IACF,MAAM,GAAG,GAAG,IAAI,EAAE,GAAG,CAAA;IAErB,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,YAAY,EAAE,CAAC,CAAA;IAE3D,+DAA+D;IAC/D,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC;QAChD,OAAO,EAAE,YAAY;QACrB,GAAG,EAAE,QAAQ;QACb,YAAY,EAAE,aAAa;KAC5B,CAAC,CAA0B,CAAA;IAE5B,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;IAE7D,OAAO;QACL,MAAM;QACN,wFAAwF;QACxF,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,aAAa,IAAI,GAAG,CAAC;QAC/C,eAAe,EAAE,eAAe,CAAC,GAAG,CAAC,eAAe,CAAC;QACrD,iBAAiB,EAAE,eAAe,CAAC,GAAG,CAAC,iBAAiB,CAAC;QACzD,iBAAiB,EAAE,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC;QAC3D,cAAc,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,IAAI,IAAI,CAAmB;QAC3D,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE;QAC1B,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,GAAG;QACzB,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,GAAG;QACjC,gBAAgB,EAAE,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAc;QAC3D,aAAa,EAAE,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAc;KACtD,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,6 @@
+import type { Address, PublicClient } from 'viem';
+export declare function readTotalSupply(publicClient: PublicClient, folioAddress: Address): Promise<bigint>;
+export declare function readBalanceOf(publicClient: PublicClient, tokenAddress: Address, account: Address): Promise<bigint>;
+export declare function readName(publicClient: PublicClient, folioAddress: Address): Promise<string>;
+export declare function readSymbol(publicClient: PublicClient, folioAddress: Address): Promise<string>;
+//# sourceMappingURL=read-dtf.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-dtf.d.ts","sourceRoot":"","sources":["../../src/dtf/read-dtf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAIjD,wBAAsB,eAAe,CACnC,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED,wBAAsB,aAAa,CACjC,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,OAAO,EACrB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,wBAAsB,QAAQ,CAC5B,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED,wBAAsB,UAAU,CAC9B,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,MAAM,CAAC,CAMjB"}

package/dist/dtf/read-dtf.js

@@ -0,0 +1,32 @@
+import folioAbi from '../abi/folio';
+import { ERC20_META_ABI } from '../abi/erc20';
+export async function readTotalSupply(publicClient, folioAddress) {
+    return (await publicClient.readContract({
+        address: folioAddress,
+        abi: folioAbi,
+        functionName: 'totalSupply',
+    }));
+}
+export async function readBalanceOf(publicClient, tokenAddress, account) {
+    return (await publicClient.readContract({
+        address: tokenAddress,
+        abi: ERC20_META_ABI,
+        functionName: 'balanceOf',
+        args: [account],
+    }));
+}
+export async function readName(publicClient, folioAddress) {
+    return (await publicClient.readContract({
+        address: folioAddress,
+        abi: folioAbi,
+        functionName: 'name',
+    }));
+}
+export async function readSymbol(publicClient, folioAddress) {
+    return (await publicClient.readContract({
+        address: folioAddress,
+        abi: folioAbi,
+        functionName: 'symbol',
+    }));
+}
+//# sourceMappingURL=read-dtf.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-dtf.js","sourceRoot":"","sources":["../../src/dtf/read-dtf.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,cAAc,CAAA;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE7C,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,YAA0B,EAC1B,YAAqB;IAErB,OAAO,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC;QACtC,OAAO,EAAE,YAAY;QACrB,GAAG,EAAE,QAAQ;QACb,YAAY,EAAE,aAAa;KAC5B,CAAC,CAAW,CAAA;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,YAA0B,EAC1B,YAAqB,EACrB,OAAgB;IAEhB,OAAO,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC;QACtC,OAAO,EAAE,YAAY;QACrB,GAAG,EAAE,cAAc;QACnB,YAAY,EAAE,WAAW;QACzB,IAAI,EAAE,CAAC,OAAO,CAAC;KAChB,CAAC,CAAW,CAAA;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,YAA0B,EAC1B,YAAqB;IAErB,OAAO,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC;QACtC,OAAO,EAAE,YAAY;QACrB,GAAG,EAAE,QAAQ;QACb,YAAY,EAAE,MAAM;KACrB,CAAC,CAAW,CAAA;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,YAA0B,EAC1B,YAAqB;IAErB,OAAO,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC;QACtC,OAAO,EAAE,YAAY;QACrB,GAAG,EAAE,QAAQ;QACb,YAAY,EAAE,QAAQ;KACvB,CAAC,CAAW,CAAA;AACf,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-rebalance-control.d.ts","sourceRoot":"","sources":["../../src/dtf/read-rebalance-control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAEjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAGhD,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,gBAAgB,CAAC,CAW3B"}

package/dist/dtf/read-rebalance-control.js

@@ -0,0 +1,14 @@
+import folioAbi from '../abi/folio';
+import { validatePriceControl } from '../utils/validate-price-control';
+export async function readRebalanceControl(publicClient, folioAddress) {
+    const [weightControl, priceControl] = (await publicClient.readContract({
+        address: folioAddress,
+        abi: folioAbi,
+        functionName: 'rebalanceControl',
+    }));
+    return {
+        weightControl,
+        priceControl: validatePriceControl(priceControl),
+    };
+}
+//# sourceMappingURL=read-rebalance-control.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-rebalance-control.js","sourceRoot":"","sources":["../../src/dtf/read-rebalance-control.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,cAAc,CAAA;AAEnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AAEtE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,YAA0B,EAC1B,YAAqB;IAErB,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,GAAG,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC;QACrE,OAAO,EAAE,YAAY;QACrB,GAAG,EAAE,QAAQ;QACb,YAAY,EAAE,kBAAkB;KACjC,CAAC,CAAsB,CAAA;IAExB,OAAO;QACL,aAAa;QACb,YAAY,EAAE,oBAAoB,CAAC,YAAY,CAAC;KACjD,CAAA;AACH,CAAC"}

package/dist/dtf/read-roles.d.ts

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

package/dist/dtf/read-roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-roles.d.ts","sourceRoot":"","sources":["../../src/dtf/read-roles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAGjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC,wBAAsB,YAAY,CAChC,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,OAAO,EACrB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,QAAQ,CAAC,CA+BnB"}

package/dist/dtf/read-roles.js

@@ -0,0 +1,29 @@
+import folioAbi from '../abi/folio';
+import { FOLIO_ROLES } from '../constants';
+export async function readDtfRoles(publicClient, folioAddress, account) {
+    // WHY: Explicit array instead of Object.values(FOLIO_ROLES) to avoid
+    // positional indexing that breaks silently if key order changes.
+    const roleChecks = [
+        { key: 'isAdmin', hash: FOLIO_ROLES.DEFAULT_ADMIN },
+        { key: 'isRebalanceManager', hash: FOLIO_ROLES.REBALANCE_MANAGER },
+        { key: 'isAuctionLauncher', hash: FOLIO_ROLES.AUCTION_LAUNCHER },
+        { key: 'isBrandManager', hash: FOLIO_ROLES.BRAND_MANAGER },
+    ];
+    const results = await publicClient.multicall({
+        contracts: roleChecks.map(({ hash }) => ({
+            address: folioAddress,
+            abi: folioAbi,
+            functionName: 'hasRole',
+            args: [hash, account],
+        })),
+    });
+    // WHY: Defaulting to false on failure is conservative — "no role" means the user
+    // won't see buttons/actions they can't execute. Safer than showing capabilities they don't have.
+    return {
+        isAdmin: results[0].status === 'success' ? results[0].result : false,
+        isRebalanceManager: results[1].status === 'success' ? results[1].result : false,
+        isAuctionLauncher: results[2].status === 'success' ? results[2].result : false,
+        isBrandManager: results[3].status === 'success' ? results[3].result : false,
+    };
+}
+//# sourceMappingURL=read-roles.js.map

package/dist/dtf/read-roles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-roles.js","sourceRoot":"","sources":["../../src/dtf/read-roles.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,cAAc,CAAA;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAG1C,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,YAA0B,EAC1B,YAAqB,EACrB,OAAgB;IAEhB,qEAAqE;IACrE,iEAAiE;IACjE,MAAM,UAAU,GAAG;QACjB,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,aAAa,EAAE;QACnD,EAAE,GAAG,EAAE,oBAAoB,EAAE,IAAI,EAAE,WAAW,CAAC,iBAAiB,EAAE;QAClE,EAAE,GAAG,EAAE,mBAAmB,EAAE,IAAI,EAAE,WAAW,CAAC,gBAAgB,EAAE;QAChE,EAAE,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,CAAC,aAAa,EAAE;KAClD,CAAA;IAEV,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,SAAS,CAAC;QAC3C,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YACvC,OAAO,EAAE,YAAY;YACrB,GAAG,EAAE,QAAQ;YACb,YAAY,EAAE,SAAkB;YAChC,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,CAAU;SAC/B,CAAC,CAAC;KACJ,CAAC,CAAA;IAEF,iFAAiF;IACjF,iGAAiG;IACjG,OAAO;QACL,OAAO,EACL,OAAO,CAAC,CAAC,CAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAE,OAAO,CAAC,CAAC,CAAE,CAAC,MAAkB,CAAC,CAAC,CAAC,KAAK;QAC5E,kBAAkB,EAChB,OAAO,CAAC,CAAC,CAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAE,OAAO,CAAC,CAAC,CAAE,CAAC,MAAkB,CAAC,CAAC,CAAC,KAAK;QAC5E,iBAAiB,EACf,OAAO,CAAC,CAAC,CAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAE,OAAO,CAAC,CAAC,CAAE,CAAC,MAAkB,CAAC,CAAC,CAAC,KAAK;QAC5E,cAAc,EACZ,OAAO,CAAC,CAAC,CAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAE,OAAO,CAAC,CAAC,CAAE,CAAC,MAAkB,CAAC,CAAC,CAAC,KAAK;KAC7E,CAAA;AACH,CAAC"}

package/dist/dtf/read-version.d.ts

@@ -0,0 +1,3 @@
+import type { Address, PublicClient } from 'viem';
+export declare function readDtfVersion(publicClient: PublicClient, folioAddress: Address): Promise<string>;
+//# sourceMappingURL=read-version.d.ts.map

package/dist/dtf/read-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-version.d.ts","sourceRoot":"","sources":["../../src/dtf/read-version.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAGjD,wBAAsB,cAAc,CAClC,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,MAAM,CAAC,CAMjB"}

package/dist/dtf/read-version.js

@@ -0,0 +1,9 @@
+import folioAbi from '../abi/folio';
+export async function readDtfVersion(publicClient, folioAddress) {
+    return (await publicClient.readContract({
+        address: folioAddress,
+        abi: folioAbi,
+        functionName: 'version',
+    }));
+}
+//# sourceMappingURL=read-version.js.map

package/dist/dtf/read-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-version.js","sourceRoot":"","sources":["../../src/dtf/read-version.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,cAAc,CAAA;AAEnC,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,YAA0B,EAC1B,YAAqB;IAErB,OAAO,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC;QACtC,OAAO,EAAE,YAAY;QACrB,GAAG,EAAE,QAAQ;QACb,YAAY,EAAE,SAAS;KACxB,CAAC,CAAW,CAAA;AACf,CAAC"}

package/dist/dtf/redeem.d.ts

@@ -0,0 +1,5 @@
+import { type Address, type PublicClient } from 'viem';
+import type { RedeemQuote, TransactionRequest } from '../types';
+export declare function readRedeemQuote(publicClient: PublicClient, folioAddress: Address, shares: bigint): Promise<RedeemQuote>;
+export declare function buildRedeemCalldata(folioAddress: Address, shares: bigint, receiver: Address, assets: Address[], minAmountsOut: bigint[]): TransactionRequest;
+//# sourceMappingURL=redeem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redeem.d.ts","sourceRoot":"","sources":["../../src/dtf/redeem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,MAAM,CAAA;AAE1E,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAG/D,wBAAsB,eAAe,CACnC,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,OAAO,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,CAAC,CAWtB;AAED,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,OAAO,EACrB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE,OAAO,EAAE,EACjB,aAAa,EAAE,MAAM,EAAE,GACtB,kBAAkB,CAcpB"}

package/dist/dtf/redeem.js

@@ -0,0 +1,27 @@
+import { encodeFunctionData } from 'viem';
+import folioAbi from '../abi/folio';
+import { assert } from '../utils/assert';
+export async function readRedeemQuote(publicClient, folioAddress, shares) {
+    const result = (await publicClient.readContract({
+        address: folioAddress,
+        abi: folioAbi,
+        functionName: 'toAssets',
+        // WHY: Floor rounding (0) — user receives the rounded-down amount to prevent overdrawing
+        args: [shares, 0],
+    }));
+    const [assets, amounts] = result;
+    return { shares, assets, amounts };
+}
+export function buildRedeemCalldata(folioAddress, shares, receiver, assets, minAmountsOut) {
+    assert(shares > 0n, 'shares must be greater than 0');
+    assert(assets.length === minAmountsOut.length, 'assets and minAmountsOut must have the same length');
+    return {
+        to: folioAddress,
+        data: encodeFunctionData({
+            abi: folioAbi,
+            functionName: 'redeem',
+            args: [shares, receiver, assets, minAmountsOut],
+        }),
+    };
+}
+//# sourceMappingURL=redeem.js.map

package/dist/dtf/redeem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redeem.js","sourceRoot":"","sources":["../../src/dtf/redeem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAmC,MAAM,MAAM,CAAA;AAC1E,OAAO,QAAQ,MAAM,cAAc,CAAA;AAEnC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAExC,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,YAA0B,EAC1B,YAAqB,EACrB,MAAc;IAEd,MAAM,MAAM,GAAG,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC;QAC9C,OAAO,EAAE,YAAY;QACrB,GAAG,EAAE,QAAQ;QACb,YAAY,EAAE,UAAU;QACxB,yFAAyF;QACzF,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;KAClB,CAAC,CAA0B,CAAA;IAE5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAA;IAChC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;AACpC,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,YAAqB,EACrB,MAAc,EACd,QAAiB,EACjB,MAAiB,EACjB,aAAuB;IAEvB,MAAM,CAAC,MAAM,GAAG,EAAE,EAAE,+BAA+B,CAAC,CAAA;IACpD,MAAM,CACJ,MAAM,CAAC,MAAM,KAAK,aAAa,CAAC,MAAM,EACtC,oDAAoD,CACrD,CAAA;IACD,OAAO;QACL,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,kBAAkB,CAAC;YACvB,GAAG,EAAE,QAAQ;YACb,YAAY,EAAE,QAAQ;YACtB,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC;SAChD,CAAC;KACH,CAAA;AACH,CAAC"}

package/dist/governance/build-proposal.d.ts

@@ -0,0 +1,11 @@
+import { type Address, type Hex } from 'viem';
+import type { TransactionRequest, VoteSupport } from '../types';
+export declare function hashDescription(description: string): Hex;
+export declare function buildProposeCalldata(governor: Address, targets: Address[], values: bigint[], calldatas: Hex[], description: string): TransactionRequest;
+export declare function buildCastVoteCalldata(governor: Address, proposalId: bigint, support: VoteSupport): TransactionRequest;
+export declare function buildCastVoteWithReasonCalldata(governor: Address, proposalId: bigint, support: VoteSupport, reason: string): TransactionRequest;
+export declare function buildQueueCalldata(governor: Address, targets: Address[], values: bigint[], calldatas: Hex[], descriptionHash: Hex): TransactionRequest;
+export declare function buildExecuteCalldata(governor: Address, targets: Address[], values: bigint[], calldatas: Hex[], descriptionHash: Hex): TransactionRequest;
+export declare function buildCancelCalldata(governor: Address, targets: Address[], values: bigint[], calldatas: Hex[], descriptionHash: Hex): TransactionRequest;
+export declare function wrapInProposal(governor: Address, target: Address, innerCalldata: Hex, description: string): TransactionRequest;
+//# sourceMappingURL=build-proposal.d.ts.map

package/dist/governance/build-proposal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-proposal.d.ts","sourceRoot":"","sources":["../../src/governance/build-proposal.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,OAAO,EACZ,KAAK,GAAG,EACT,MAAM,MAAM,CAAA;AAEb,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAc/D,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAExD;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,OAAO,EAAE,EAClB,MAAM,EAAE,MAAM,EAAE,EAChB,SAAS,EAAE,GAAG,EAAE,EAChB,WAAW,EAAE,MAAM,GAClB,kBAAkB,CAWpB;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,WAAW,GACnB,kBAAkB,CASpB;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,GACb,kBAAkB,CASpB;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,OAAO,EAAE,EAClB,MAAM,EAAE,MAAM,EAAE,EAChB,SAAS,EAAE,GAAG,EAAE,EAChB,eAAe,EAAE,GAAG,GACnB,kBAAkB,CAUpB;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,OAAO,EAAE,EAClB,MAAM,EAAE,MAAM,EAAE,EAChB,SAAS,EAAE,GAAG,EAAE,EAChB,eAAe,EAAE,GAAG,GACnB,kBAAkB,CAUpB;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,OAAO,EAAE,EAClB,MAAM,EAAE,MAAM,EAAE,EAChB,SAAS,EAAE,GAAG,EAAE,EAChB,eAAe,EAAE,GAAG,GACnB,kBAAkB,CAUpB;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE,OAAO,EACf,aAAa,EAAE,GAAG,EAClB,WAAW,EAAE,MAAM,GAClB,kBAAkB,CAQpB"}

package/dist/governance/build-proposal.js

@@ -0,0 +1,78 @@
+import { encodeFunctionData, keccak256, toBytes, } from 'viem';
+import governorAbi from '../abi/governor';
+import { assert } from '../utils/assert';
+function assertProposalArrays(targets, values, calldatas) {
+    assert(targets.length === values.length && targets.length === calldatas.length, 'targets, values, and calldatas must have the same length');
+}
+export function hashDescription(description) {
+    return keccak256(toBytes(description));
+}
+export function buildProposeCalldata(governor, targets, values, calldatas, description) {
+    assert(targets.length > 0, 'targets must not be empty');
+    assertProposalArrays(targets, values, calldatas);
+    return {
+        to: governor,
+        data: encodeFunctionData({
+            abi: governorAbi,
+            functionName: 'propose',
+            args: [targets, values, calldatas, description],
+        }),
+    };
+}
+export function buildCastVoteCalldata(governor, proposalId, support) {
+    return {
+        to: governor,
+        data: encodeFunctionData({
+            abi: governorAbi,
+            functionName: 'castVote',
+            args: [proposalId, support],
+        }),
+    };
+}
+export function buildCastVoteWithReasonCalldata(governor, proposalId, support, reason) {
+    return {
+        to: governor,
+        data: encodeFunctionData({
+            abi: governorAbi,
+            functionName: 'castVoteWithReason',
+            args: [proposalId, support, reason],
+        }),
+    };
+}
+export function buildQueueCalldata(governor, targets, values, calldatas, descriptionHash) {
+    assertProposalArrays(targets, values, calldatas);
+    return {
+        to: governor,
+        data: encodeFunctionData({
+            abi: governorAbi,
+            functionName: 'queue',
+            args: [targets, values, calldatas, descriptionHash],
+        }),
+    };
+}
+export function buildExecuteCalldata(governor, targets, values, calldatas, descriptionHash) {
+    assertProposalArrays(targets, values, calldatas);
+    return {
+        to: governor,
+        data: encodeFunctionData({
+            abi: governorAbi,
+            functionName: 'execute',
+            args: [targets, values, calldatas, descriptionHash],
+        }),
+    };
+}
+export function buildCancelCalldata(governor, targets, values, calldatas, descriptionHash) {
+    assertProposalArrays(targets, values, calldatas);
+    return {
+        to: governor,
+        data: encodeFunctionData({
+            abi: governorAbi,
+            functionName: 'cancel',
+            args: [targets, values, calldatas, descriptionHash],
+        }),
+    };
+}
+export function wrapInProposal(governor, target, innerCalldata, description) {
+    return buildProposeCalldata(governor, [target], [0n], [innerCalldata], description);
+}
+//# sourceMappingURL=build-proposal.js.map

package/dist/governance/build-proposal.js.map

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

package/dist/governance/build-settings-calldata.d.ts

@@ -0,0 +1,39 @@
+import { type Address, type Hex } from 'viem';
+import type { FeeRecipient, PriceControl } from '../types';
+export declare function encodeMintFee(fee: bigint): Hex;
+export declare function encodeTvlFee(fee: bigint): Hex;
+export declare function encodeFeeRecipients(recipients: FeeRecipient[]): Hex;
+export declare function encodeMandate(mandate: string): Hex;
+export declare function encodeAuctionLength(seconds: bigint): Hex;
+export declare function encodeRebalanceControl(weightControl: boolean, priceControl: PriceControl): Hex;
+export declare function encodeTrustedFillerRegistry(registry: Address, enabled: boolean): Hex;
+export declare function encodeGrantRole(role: Hex, account: Address): Hex;
+export declare function encodeRevokeRole(role: Hex, account: Address): Hex;
+export declare function encodeStartRebalance(tokens: {
+    token: Address;
+    weight: {
+        low: bigint;
+        spot: bigint;
+        high: bigint;
+    };
+    price: {
+        low: bigint;
+        high: bigint;
+    };
+    maxAuctionSize: bigint;
+    inRebalance: boolean;
+}[], limits: {
+    low: bigint;
+    spot: bigint;
+    high: bigint;
+}, launcherWindow: bigint, ttl: bigint): Hex;
+export declare function encodeAddToBasket(token: Address): Hex;
+export declare function encodeRemoveFromBasket(token: Address): Hex;
+export declare function encodeVotingDelay(delay: bigint): Hex;
+export declare function encodeVotingPeriod(period: bigint): Hex;
+export declare function encodeProposalThreshold(threshold: bigint): Hex;
+export declare function encodeQuorumNumerator(numerator: bigint): Hex;
+export declare function encodeTimelockDelay(delay: bigint): Hex;
+export declare function encodeTimelockGrantRole(role: Hex, account: Address): Hex;
+export declare function encodeTimelockRevokeRole(role: Hex, account: Address): Hex;
+//# sourceMappingURL=build-settings-calldata.d.ts.map

package/dist/governance/build-settings-calldata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-settings-calldata.d.ts","sourceRoot":"","sources":["../../src/governance/build-settings-calldata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAA;AAIjE,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAI1D,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAM9C;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAM7C;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,GAAG,CAMnE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAMlD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAMxD;AAED,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,OAAO,EACtB,YAAY,EAAE,YAAY,GACzB,GAAG,CAML;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,OAAO,GACf,GAAG,CAML;AAID,wBAAgB,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,GAAG,GAAG,CAMhE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,GAAG,GAAG,CAMjE;AAID,wBAAgB,oBAAoB,CAClC,MAAM,EAAE;IACN,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACnD,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACpC,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,OAAO,CAAA;CACrB,EAAE,EACH,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACnD,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,MAAM,GACV,GAAG,CAML;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,CAMrD;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,CAM1D;AAKD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAMpD;AAGD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAMtD;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAM9D;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAM5D;AAID,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAMtD;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,GAAG,GAAG,CAMxE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,GAAG,GAAG,CAMzE"}