@floorlaunchpad/sdk-evm 0.0.0-stage → 0.1.0

package/dist/reads.d.ts.map

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

package/dist/reads.js

@@ -0,0 +1,201 @@
+/**
+ * Reading FLOOR launches off an EVM chain with viem.
+ *
+ * - `poolState` is one `eth_call`, decoded at one width (`decodePoolState` refuses any other).
+ * - The pool id comes from `hook.poolForAccount(launch)` — THE HOOK IS THE SOURCE OF THE ID, never the registry entry or a
+ *   derived key. The pool's own FLOOR Platform fee is read off `poolState.teamFeeBps` and cap-checked.
+ * - The sale's getters are read in one batch; its `teamFeeBps()` only on a set whose row names a team vault.
+ * - The deployer is `factory.creatorOf(launch)` on the entry's registrar; the published floor is `1.0001^-floorTick`.
+ *
+ * ⛔ Nothing here lists by draining a chain. `listLaunches` reads ONE registry page per call (newest first) and hands back a
+ *    cursor; `getLaunch` resolves a token by its own `launch()` and the registry's `isRegistered`, then finds its entry in a
+ *    BOUNDED newest-first scan (`maxRegistryScan`), remembering every entry it has seen.
+ */
+import { BaseError, ContractFunctionRevertedError, decodeFunctionResult, encodeFunctionData, getAddress, zeroAddress, zeroHash } from 'viem';
+import { HOOK_ABI, LAUNCH_ABI, POOL_ABI, POOL_STATE_ABI, POOL_STATE_WORDS, REGISTRY_ABI, TOKEN_ABI, FACTORY_ABI, WALLET_SCAN_ABI } from './abi/index.js';
+import { EVM_NETWORKS, setHasTeamFee } from './deployments.js';
+import { FloorEvmError } from './errors.js';
+import { MAX_POOL_TEAM_FEE_BPS, MAX_SALE_TEAM_FEE_BPS, rateWithinCap } from './fees.js';
+import { decodeSlot0, poolIdOfKey, poolKey, poolStateSlot, priceX18AtTick, quoteAtCurrency1 } from './pool.js';
+import { saleReadsFrom } from './sale.js';
+/** The registry's page size. */
+export const REGISTRY_PAGE_MAX = 500n;
+/** `poolState(id)` calldata. */
+export function poolStateCalldata(id) {
+    return encodeFunctionData({ abi: HOOK_ABI, functionName: 'poolState', args: [id] });
+}
+/** The raw `poolState` return → the named tuple. ⛔ A return of any width but `POOL_STATE_WORDS` is refused by name; viem
+ *  itself would decode a longer one without complaint. */
+export function decodePoolState(data) {
+    const hex = data.length >= 2 ? data.slice(2) : '';
+    const words = hex.length / 64;
+    if (hex.length > 0 && words !== POOL_STATE_WORDS) {
+        throw new FloorEvmError('contract_mismatch', `poolState returned ${words} words; the engine's layout has ${POOL_STATE_WORDS}`);
+    }
+    return decodeFunctionResult({ abi: HOOK_ABI, functionName: 'poolState', data });
+}
+/** ONE `eth_call` of `poolState(id)`, decoded through `decodePoolState`. */
+export async function readPoolState(client, hook, id) {
+    const { data } = await client.call({ to: hook, data: poolStateCalldata(id) });
+    if (!data || data === '0x')
+        throw new FloorEvmError('contract_mismatch', `poolState(${id}) at ${hook} returned no data`);
+    return decodePoolState(data);
+}
+/** A pool's rates off its state, the FLOOR Platform fee checked against its cap (`RateAboveCap` past it). */
+export function poolRatesOf(st) {
+    const n = (v, what) => {
+        if (v > 10000n)
+            throw new FloorEvmError('contract_mismatch', `poolState.${what} = ${v} is not a bps rate`);
+        return Number(v);
+    };
+    return {
+        skimBuyFarBps: n(st.skimBuyFarBps, 'skimBuyFarBps'),
+        skimSellFarBps: n(st.skimSellFarBps, 'skimSellFarBps'),
+        skimBuyAtFloorBps: n(st.skimBuyAtFloorBps, 'skimBuyAtFloorBps'),
+        skimSellAtFloorBps: n(st.skimSellAtFloorBps, 'skimSellAtFloorBps'),
+        creatorBuyBps: n(st.creatorBuyBps, 'creatorBuyBps'),
+        creatorSellBps: n(st.creatorSellBps, 'creatorSellBps'),
+        holderBuyBps: n(st.holderBuyBps, 'holderBuyBps'),
+        holderSellBps: n(st.holderSellBps, 'holderSellBps'),
+        teamFeeBps: rateWithinCap(Number(st.teamFeeBps), MAX_POOL_TEAM_FEE_BPS, 'the pool\'s FLOOR Platform fee (PoolState.teamFeeBps)'),
+    };
+}
+/** The pool's `Slot0` off the PoolManager (`extsload` of the pool's state slot). */
+export async function readSlot0(client, poolManager, poolId) {
+    const word = await client.readContract({ address: poolManager, abi: POOL_STATE_ABI, functionName: 'extsload', args: [poolStateSlot(poolId)] });
+    return decodeSlot0(word);
+}
+/** Whether a viem error is a contract REVERT (an answer: "no"), as opposed to a transport failure (not an answer). */
+export function isRevert(e) {
+    return e instanceof BaseError && e.walk((x) => x instanceof ContractFunctionRevertedError) instanceof ContractFunctionRevertedError;
+}
+export async function readRegistryCount(client, d) {
+    return client.readContract({ address: d.registry, abi: REGISTRY_ABI, functionName: 'count' });
+}
+export async function readRegistryPage(client, d, start, n) {
+    return client.readContract({ address: d.registry, abi: REGISTRY_ABI, functionName: 'page', args: [start, n] });
+}
+/**
+ * The launch contract behind a token, checked against THIS chain's registry. A token whose `launch()` reverts, is zero, or is
+ * not registered here is not a FLOOR launch on this chain: `FloorEvmError('not_a_launch')`.
+ */
+export async function launchOfToken(client, d, token) {
+    let launch;
+    try {
+        launch = await client.readContract({ address: token, abi: WALLET_SCAN_ABI, functionName: 'launch' });
+    }
+    catch (e) {
+        if (isRevert(e))
+            throw new FloorEvmError('not_a_launch', `${token} answers no launch() — not a FLOOR token`, { cause: e });
+        throw e;
+    }
+    if (BigInt(launch) === 0n)
+        throw new FloorEvmError('not_a_launch', `${token}'s launch() is zero`);
+    const registered = await client.readContract({ address: d.registry, abi: REGISTRY_ABI, functionName: 'isRegistered', args: [launch] });
+    if (!registered)
+        throw new FloorEvmError('not_a_launch', `${token}'s launch ${launch} is not registered on chain ${d.chainId}'s registry ${d.registry}`);
+    return getAddress(launch);
+}
+/** A quote asset's address, symbol and decimals. Native: the chain's symbol and 18. */
+export async function readQuoteAsset(client, chainId, quote, nativeSymbol) {
+    if (quote === null)
+        return { address: null, symbol: nativeSymbol ?? EVM_NETWORKS[chainId]?.nativeSymbol ?? 'native', decimals: 18 };
+    const [symbol, decimals] = await Promise.all([
+        client.readContract({ address: quote, abi: TOKEN_ABI, functionName: 'symbol' }),
+        client.readContract({ address: quote, abi: TOKEN_ABI, functionName: 'decimals' }),
+    ]);
+    return { address: quote, symbol, decimals };
+}
+/** The sale's getters in one batch, checked (`saleReadsFrom`). The fee is asked only on a set that carries it. */
+export async function readSale(client, d, launch) {
+    const r = (functionName) => client.readContract({ address: launch, abi: LAUNCH_ABI, functionName });
+    const [funded, saleTokens, sold, raised, p0, p1, tranches, graduated, teamFeeBps] = await Promise.all([
+        r('funded'), r('saleTokens'), r('sold'), r('raised'), r('p0'), r('p1'), r('tranches'), r('graduated'),
+        setHasTeamFee(d) ? client.readContract({ address: launch, abi: LAUNCH_ABI, functionName: 'teamFeeBps' }).then((v) => rateWithinCap(Number(v), MAX_SALE_TEAM_FEE_BPS, `the sale ${launch}'s FLOOR Platform fee`)) : Promise.resolve(0),
+    ]);
+    return saleReadsFrom({ funded, saleTokens, sold, raised, p0, p1, tranches, graduated, teamFeeBps });
+}
+/** The hook's id for the launch's pool. A revert or a zero id is "not a launch this hook serves". */
+export async function readPoolId(client, hook, launch) {
+    let id;
+    try {
+        id = await client.readContract({ address: hook, abi: HOOK_ABI, functionName: 'poolForAccount', args: [launch] });
+    }
+    catch (e) {
+        if (isRevert(e))
+            throw new FloorEvmError('not_a_launch', `hook ${hook} reverted poolForAccount(${launch})`, { cause: e });
+        throw e;
+    }
+    if (id === zeroHash)
+        throw new FloorEvmError('not_a_launch', `hook ${hook} has no pool for launch ${launch}`);
+    return id;
+}
+/**
+ * A launch, read whole from its registry entry: the token, the sale or the pool, the rates, the floor. Every rate is read
+ * off this launch's own contracts; nothing is assumed.
+ */
+export async function readLaunchFromEntry(client, d, e, opts = {}) {
+    const token = getAddress(e.token), hook = getAddress(e.hook), launch = getAddress(e.launch);
+    const poolId = await readPoolId(client, hook, launch);
+    const [st, name, symbol, decimals, totalSupply, graduated, creator] = await Promise.all([
+        readPoolState(client, hook, poolId),
+        client.readContract({ address: token, abi: TOKEN_ABI, functionName: 'name' }),
+        client.readContract({ address: token, abi: TOKEN_ABI, functionName: 'symbol' }),
+        client.readContract({ address: token, abi: TOKEN_ABI, functionName: 'decimals' }),
+        client.readContract({ address: token, abi: TOKEN_ABI, functionName: 'totalSupply' }),
+        client.readContract({ address: launch, abi: LAUNCH_ABI, functionName: 'graduated' }),
+        client.readContract({ address: e.registrar, abi: FACTORY_ABI, functionName: 'creatorOf', args: [launch] }).then((a) => (BigInt(a) === 0n ? null : getAddress(a)), () => null),
+    ]);
+    if (st.token.toLowerCase() !== token.toLowerCase())
+        throw new FloorEvmError('contract_mismatch', `pool ${poolId} names token ${st.token}, not ${token}`);
+    const quoteToken = BigInt(st.quoteToken) === 0n ? null : getAddress(st.quoteToken);
+    const key = poolKey(token, hook, quoteToken ?? zeroAddress);
+    /* ⛔ The key this SDK will sign must hash to the hook's id for the launch. */
+    if (poolIdOfKey(key).toLowerCase() !== poolId.toLowerCase())
+        throw new FloorEvmError('contract_mismatch', `pool ${poolId}: the key of ${token} / ${quoteToken ?? 'native'} on hook ${hook} hashes to ${poolIdOfKey(key)}, not the hook's id`);
+    const orient = quoteAtCurrency1(key, quoteToken ?? zeroAddress);
+    if (orient === null || orient !== st.quoteIsCurrency1)
+        throw new FloorEvmError('contract_mismatch', `pool ${poolId}'s quote orientation disagrees with its key`);
+    const [quote, sale] = await Promise.all([
+        readQuoteAsset(client, d.chainId, quoteToken, opts.nativeSymbol),
+        graduated ? Promise.resolve(null) : readSale(client, d, launch),
+    ]);
+    const poolRates = poolRatesOf(st);
+    const bidWidth = st.bidWidth === 0 ? st.tickSpacing : st.bidWidth;
+    return {
+        ref: { chain: { family: 'evm', chainId: d.chainId }, token },
+        name, symbol, decimals, totalSupply, quote,
+        /* An unfunded sale takes no buy yet (`FloorLaunch._buy` reverts `NotFunded`): 'pending'. */
+        phase: graduated ? 'graduated' : sale?.funded ? 'bonding' : 'pending',
+        mode: e.mode,
+        creator,
+        floorPriceX18: graduated ? priceX18AtTick(st.floorTick, decimals, quote.decimals) : null,
+        raw: {
+            chainId: d.chainId, launch, token, hook, poolId, poolKey: key, rewards: getAddress(e.rewards), registrar: getAddress(e.registrar),
+            registeredAt: e.at, quoteToken, quoteIsCurrency1: st.quoteIsCurrency1, creator,
+            sale, saleTeamFeeBps: sale ? sale.teamFeeBps : null, poolRates, floorTick: st.floorTick, bidWidth, poolState: st,
+        },
+    };
+}
+/**
+ * The pool's staircase cushion edge (`stairs()` through `hook.execute(poolId, …)`): what the gap buy skim reads.
+ * `cushionLiq` 0 = no cushion standing.
+ */
+export async function readCushion(client, hook, poolId) {
+    const inner = encodeFunctionData({ abi: POOL_ABI, functionName: 'stairs' });
+    const { data } = await client.call({ to: hook, data: encodeFunctionData({ abi: HOOK_ABI, functionName: 'execute', args: [poolId, inner] }) });
+    if (!data || data === '0x')
+        throw new FloorEvmError('contract_mismatch', `stairs() of pool ${poolId} at ${hook} returned no data`);
+    const bytes = decodeFunctionResult({ abi: HOOK_ABI, functionName: 'execute', data });
+    const st = decodeFunctionResult({ abi: POOL_ABI, functionName: 'stairs', data: bytes });
+    return { cushionLower: st.cushionLower, cushionLiq: st.cushionLiq };
+}
+/** Reads a holder's sale position (`allocation`, `contributed`) — what a sell-back pays against. */
+export async function readSalePosition(client, launch, holder) {
+    const [allocation, contributed] = await Promise.all([
+        client.readContract({ address: launch, abi: LAUNCH_ABI, functionName: 'allocation', args: [holder] }),
+        client.readContract({ address: launch, abi: LAUNCH_ABI, functionName: 'contributed', args: [holder] }),
+    ]);
+    return { allocation, contributed };
+}
+//# sourceMappingURL=reads.js.map

package/dist/reads.js.map

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

package/dist/router.d.ts

@@ -0,0 +1,99 @@
+/**
+ * The UniversalRouter / v4 payloads a FLOOR pool swap is sent as.
+ *
+ * ⛔ No off-chain Permit2 signature anywhere: instead of a signed permit inside the swap (PERMIT2_PERMIT, 0x8a), Permit2's
+ *    on-chain `approve` goes in the same EIP-5792 batch as the trade, so the batch is one wallet prompt.
+ *
+ * ⛔ TWO byte tables overlap: 0x10 is V4_SWAP as a COMMAND and TAKE_PORTION as an ACTION.
+ * ⛔ TAKE_ALL's amount is the MINIMUM received: at zero it accepts any output. Every swap here carries a positive one.
+ * ⛔ The struct layout depends on the router's RELEASE (2.1.1 adds `minHopPriceX36`); a UniversalRouter with no recorded
+ *    release is refused before a byte is encoded.
+ */
+import { type Address, type Hex } from 'viem';
+import type { PoolKey } from './pool.js';
+import type { UrRelease } from './deployments.js';
+export type V4Layout = 'plain' | 'minHop';
+export declare function v4LayoutOf(kind: 'universal' | 'v4router', release: UrRelease | undefined): V4Layout;
+/** `IV4Router.ExactInputSingleParams` in the router's layout. There is NO price-limit field. */
+export declare function exactInSingleTuple(layout: V4Layout): {
+    readonly type: "tuple";
+    readonly components: readonly [{
+        readonly name: "poolKey";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "currency0";
+            readonly type: "address";
+        }, {
+            readonly name: "currency1";
+            readonly type: "address";
+        }, {
+            readonly name: "fee";
+            readonly type: "uint24";
+        }, {
+            readonly name: "tickSpacing";
+            readonly type: "int24";
+        }, {
+            readonly name: "hooks";
+            readonly type: "address";
+        }];
+    }, {
+        readonly name: "zeroForOne";
+        readonly type: "bool";
+    }, {
+        readonly name: "amountIn";
+        readonly type: "uint128";
+    }, {
+        readonly name: "amountOutMinimum";
+        readonly type: "uint128";
+    }, ...{
+        readonly name: "minHopPriceX36";
+        readonly type: "uint256";
+    }[], {
+        readonly name: "hookData";
+        readonly type: "bytes";
+    }];
+};
+export interface V4SingleIn {
+    key: PoolKey;
+    zeroForOne: boolean;
+    amountIn: bigint;
+    amountOutMinimum: bigint;
+    minHopPriceX36?: bigint;
+    hookData?: Hex;
+}
+export declare function encodeV4ExactInSingle(layout: V4Layout, p: V4SingleIn): Hex;
+export interface SwapPlan {
+    commands: Hex;
+    inputs: readonly Hex[];
+}
+export declare function encodeV4Actions(actions: Hex, params: readonly Hex[]): Hex;
+export interface V4SwapArgs {
+    layout: V4Layout;
+    key: PoolKey;
+    zeroForOne: boolean;
+    currencyIn: Address;
+    currencyOut: Address;
+    amountIn: bigint;
+    minOut: bigint;
+    /** `router`: the input is already in the router (a `FloorSwapRatchet` paid it there) — SETTLE from the router's balance. */
+    payer?: 'user' | 'router';
+}
+/**
+ * One exact-in single-hop v4 swap as UniversalRouter commands: V4_SWAP (SWAP_EXACT_IN_SINGLE, SETTLE_ALL, TAKE_ALL), plus a
+ * SWEEP of native back to the caller when the input is native (the router keeps no change).
+ */
+export declare function encodeV4Swap(a: V4SwapArgs): SwapPlan;
+/** `IV4Quoter.QuoteExactSingleParams` for the key and direction a swap will sign. */
+export declare function quoteParamsForKey(key: PoolKey, zeroForOne: boolean, exactAmount: bigint): {
+    poolKey: PoolKey;
+    zeroForOne: boolean;
+    exactAmount: bigint;
+    hookData: Hex;
+};
+/** A minimum received `slippageBps` under a quote, rounded DOWN; 0 for a quote of nothing (which callers refuse). 100 bps
+ *  is a 1% slippage allowance. */
+export declare function minOutFromBps(quoted: bigint, slippageBps: number): bigint;
+/** Permit2's largest grant (uint160) and expiration (uint48). */
+export declare const PERMIT2_MAX_AMOUNT: bigint;
+export declare const PERMIT2_MAX_EXPIRATION: bigint;
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAuB,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAYlD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE1C,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,EAAE,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAMnG;AAWD,gGAAgG;AAChG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYlD;AAWD,MAAM,WAAW,UAAU;IAAG,GAAG,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,GAAG,CAAA;CAAE;AAUtJ,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,GAAG,GAAG,CAI1E;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,GAAG,CAAC;IACd,MAAM,EAAE,SAAS,GAAG,EAAE,CAAC;CACxB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,GAAG,EAAE,GAAG,GAAG,CAEzE;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,QAAQ,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,4HAA4H;IAC5H,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,UAAU,GAAG,QAAQ,CA8BpD;AAED,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM;;;;cACc,GAAG;EACxG;AAED;kCACkC;AAClC,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAIzE;AAED,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,QAAoB,CAAC;AACpD,eAAO,MAAM,sBAAsB,QAAmB,CAAC"}

package/dist/router.js

@@ -0,0 +1,132 @@
+/**
+ * The UniversalRouter / v4 payloads a FLOOR pool swap is sent as.
+ *
+ * ⛔ No off-chain Permit2 signature anywhere: instead of a signed permit inside the swap (PERMIT2_PERMIT, 0x8a), Permit2's
+ *    on-chain `approve` goes in the same EIP-5792 batch as the trade, so the batch is one wallet prompt.
+ *
+ * ⛔ TWO byte tables overlap: 0x10 is V4_SWAP as a COMMAND and TAKE_PORTION as an ACTION.
+ * ⛔ TAKE_ALL's amount is the MINIMUM received: at zero it accepts any output. Every swap here carries a positive one.
+ * ⛔ The struct layout depends on the router's RELEASE (2.1.1 adds `minHopPriceX36`); a UniversalRouter with no recorded
+ *    release is refused before a byte is encoded.
+ */
+import { encodeAbiParameters } from 'viem';
+const CMD_SWEEP = '04';
+const CMD_V4_SWAP = '10';
+const ACT_SWAP_EXACT_IN_SINGLE = '06';
+const ACT_SETTLE = '0b';
+const ACT_SETTLE_ALL = '0c';
+const ACT_TAKE_ALL = '0f';
+/** `ActionConstants.MSG_SENDER`: the router maps address(1) to the real caller. */
+const MSG_SENDER = '0x0000000000000000000000000000000000000001';
+const NATIVE = '0x0000000000000000000000000000000000000000';
+export function v4LayoutOf(kind, release) {
+    if (kind === 'v4router')
+        return 'plain';
+    if (kind !== 'universal')
+        throw new Error(`v4 actions: ${String(kind)} is not an actions router`);
+    if (release === '2.1.1')
+        return 'minHop';
+    if (release === '2.0.0')
+        return 'plain';
+    throw new Error(`v4LayoutOf: a UniversalRouter needs its recorded release (got ${String(release)})`);
+}
+const POOL_KEY_TUPLE = {
+    type: 'tuple',
+    components: [
+        { name: 'currency0', type: 'address' }, { name: 'currency1', type: 'address' },
+        { name: 'fee', type: 'uint24' }, { name: 'tickSpacing', type: 'int24' },
+        { name: 'hooks', type: 'address' },
+    ],
+};
+/** `IV4Router.ExactInputSingleParams` in the router's layout. There is NO price-limit field. */
+export function exactInSingleTuple(layout) {
+    return {
+        type: 'tuple',
+        components: [
+            { ...POOL_KEY_TUPLE, name: 'poolKey' },
+            { name: 'zeroForOne', type: 'bool' },
+            { name: 'amountIn', type: 'uint128' },
+            { name: 'amountOutMinimum', type: 'uint128' },
+            ...(layout === 'minHop' ? [{ name: 'minHopPriceX36', type: 'uint256' }] : []),
+            { name: 'hookData', type: 'bytes' },
+        ],
+    };
+}
+const CURRENCY_AND_AMOUNT = [{ type: 'address' }, { type: 'uint256' }];
+const UINT128_MAX = (1n << 128n) - 1n;
+function u128(v, what) {
+    if (v < 0n)
+        throw new Error(`${what}: an amount cannot be negative`);
+    if (v > UINT128_MAX)
+        throw new Error(`${what}: ${v} does not fit uint128`);
+    return v;
+}
+function minHopFor(layout, v) {
+    if (layout === 'plain') {
+        if (v !== undefined)
+            throw new Error('minHopPriceX36: this router\'s release has no such field');
+        return null;
+    }
+    return v ?? 0n;
+}
+export function encodeV4ExactInSingle(layout, p) {
+    const minHop = minHopFor(layout, p.minHopPriceX36);
+    const base = { poolKey: p.key, zeroForOne: p.zeroForOne, amountIn: u128(p.amountIn, 'amountIn'), amountOutMinimum: u128(p.amountOutMinimum, 'amountOutMinimum'), hookData: p.hookData ?? '0x' };
+    return encodeAbiParameters([exactInSingleTuple(layout)], [minHop === null ? base : { ...base, minHopPriceX36: minHop }]);
+}
+export function encodeV4Actions(actions, params) {
+    return encodeAbiParameters([{ type: 'bytes' }, { type: 'bytes[]' }], [actions, params]);
+}
+/**
+ * One exact-in single-hop v4 swap as UniversalRouter commands: V4_SWAP (SWAP_EXACT_IN_SINGLE, SETTLE_ALL, TAKE_ALL), plus a
+ * SWEEP of native back to the caller when the input is native (the router keeps no change).
+ */
+export function encodeV4Swap(a) {
+    const key = a.key;
+    const amountIn = u128(a.amountIn, 'amountIn');
+    const minOut = u128(a.minOut, 'minOut');
+    if (amountIn === 0n)
+        throw new Error('amountIn: the amount must be greater than zero');
+    const [in0, in1] = a.zeroForOne ? [key.currency0, key.currency1] : [key.currency1, key.currency0];
+    if (a.currencyIn.toLowerCase() !== in0.toLowerCase() || a.currencyOut.toLowerCase() !== in1.toLowerCase()) {
+        throw new Error('v4 swap: currencyIn / currencyOut are not the key\'s currencies in this direction');
+    }
+    const { currencyIn, currencyOut } = a;
+    const fromRouter = a.payer === 'router' && currencyIn.toLowerCase() !== NATIVE;
+    const actions = ('0x' + ACT_SWAP_EXACT_IN_SINGLE + (fromRouter ? ACT_SETTLE : ACT_SETTLE_ALL) + ACT_TAKE_ALL);
+    const params = [
+        encodeV4ExactInSingle(a.layout, { key, zeroForOne: a.zeroForOne, amountIn, amountOutMinimum: minOut }),
+        fromRouter
+            ? encodeAbiParameters([{ type: 'address' }, { type: 'uint256' }, { type: 'bool' }], [currencyIn, 0n, false])
+            : encodeAbiParameters(CURRENCY_AND_AMOUNT, [currencyIn, amountIn]),
+        encodeAbiParameters(CURRENCY_AND_AMOUNT, [currencyOut, minOut]),
+    ];
+    const v4Input = encodeV4Actions(actions, params);
+    if (currencyIn.toLowerCase() !== NATIVE) {
+        return { commands: `0x${CMD_V4_SWAP}`, inputs: [v4Input] };
+    }
+    return {
+        commands: `0x${CMD_V4_SWAP}${CMD_SWEEP}`,
+        inputs: [
+            v4Input,
+            encodeAbiParameters([{ type: 'address' }, { type: 'address' }, { type: 'uint256' }], [NATIVE, MSG_SENDER, 0n]),
+        ],
+    };
+}
+/** `IV4Quoter.QuoteExactSingleParams` for the key and direction a swap will sign. */
+export function quoteParamsForKey(key, zeroForOne, exactAmount) {
+    return { poolKey: key, zeroForOne, exactAmount: u128(exactAmount, 'exactAmount'), hookData: '0x' };
+}
+/** A minimum received `slippageBps` under a quote, rounded DOWN; 0 for a quote of nothing (which callers refuse). 100 bps
+ *  is a 1% slippage allowance. */
+export function minOutFromBps(quoted, slippageBps) {
+    if (quoted <= 0n)
+        return 0n;
+    if (!Number.isInteger(slippageBps) || slippageBps < 0 || slippageBps > 9_900)
+        throw new RangeError(`slippage ${slippageBps} bps is not in 0..9900`);
+    return (quoted * BigInt(10_000 - slippageBps)) / 10000n;
+}
+/** Permit2's largest grant (uint160) and expiration (uint48). */
+export const PERMIT2_MAX_AMOUNT = (1n << 160n) - 1n;
+export const PERMIT2_MAX_EXPIRATION = (1n << 48n) - 1n;
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

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

package/dist/sale.d.ts

@@ -0,0 +1,79 @@
+/**
+ * The bonding sale's arithmetic: tranche prices, the buy walk and the sell-back payout, in bigint.
+ *
+ * Mirrors `FloorLaunch._buy` / `_walk` / `_sell`. A sale prices at one price (`p0 == p1`); `p1` is still read and walked.
+ *
+ * ⛔ The FLOOR Platform fee rides ON TOP of the sale price: a buy's `amountIn` is the GROSS cap, the walk spends at most
+ *    `saleNetOf(gross)`, the fee is `floor(spent × bps / 10_000)`, and the change comes back to the payer.
+ * ⛔ A buy never receives more than the sale has left: an overfill is filled to the end and the rest refunded.
+ * ⛔ ROUNDING is per contract version (`ContractRules.saleCost`, read off the deployment row): the current `FloorLaunch`
+ *   rounds a tranche's cost UP (`(tokens × price + 1e18 − 1) / 1e18`), older ones DOWN
+ *   (`tokens × price / 1e18`). Pass the row's rule; a quote in the other rounding is off by up to one base unit a tranche.
+ * ⛔ The SELL-BACK is per contract version too (`ContractRules.sellBack`): stateless at the sale price, or pro-rata.
+ */
+import type { ContractRules } from './deployments.js';
+export declare const MAX_TRANCHES = 255;
+/** A sale's book as its getters answer it. */
+export interface SaleBook {
+    saleTokens: bigint;
+    sold: bigint;
+    p0: bigint;
+    p1: bigint;
+    tranches: number;
+    /** The SALE's own FLOOR Platform fee, bps (`FloorLaunch.teamFeeBps()`), 0 on a set without the fee. */
+    teamFeeBps: number;
+}
+export interface SaleReads extends SaleBook {
+    funded: boolean;
+    raised: bigint;
+    graduated: boolean;
+}
+export declare function validTranches(n: unknown): n is number;
+/** The getters' answers, checked: tranches in 1..255, the fee a rate under the sale's cap. Throws `MalformedSale`. */
+export declare function saleReadsFrom(raw: Omit<SaleReads, 'tranches'> & {
+    tranches: number | bigint;
+}): SaleReads;
+export declare function trancheSize(s: SaleBook): bigint;
+/** Tranche `i`'s price: raw quote per WHOLE (1e18-unit) token, linear from `p0` to `p1`. */
+export declare function tranchePrice(s: SaleBook, i: number): bigint;
+export declare function currentTranche(s: SaleBook): number;
+/** How a tranche's cost is rounded (`ContractRules.saleCost`). */
+export type SaleCostRounding = ContractRules['saleCost'];
+/** A tranche slice's cost: `tokens × price / unit`, rounded as `rounding` says. */
+export declare function trancheCost(tokens: bigint, price: bigint, unit: bigint, rounding: SaleCostRounding): bigint;
+/** The whole raise: what buying every sale token costs (before the FLOOR Platform fee). */
+export declare function saleTargetWei(s: SaleBook, rounding?: SaleCostRounding): bigint;
+export interface SaleBuyQuote {
+    /** Tokens received. */
+    got: bigint;
+    /** Quote spent at the sale price (the raise grows by this). */
+    spent: bigint;
+    /** The sale's FLOOR Platform fee on `spent`. */
+    fee: bigint;
+    /** The most one buy can receive now (what is left). */
+    maxGot: bigint;
+    /** The least GROSS that buys everything left. */
+    fillWei: bigint;
+    /** True when `amountIn` exceeds `fillWei` (the rest is refunded). */
+    overfills: boolean;
+}
+/**
+ * A bonding buy of GROSS `amountInWei` (the fee rides on top). `tokenDecimals` is 18 on every EVM launch. `rounding` is the
+ * deployment's `ContractRules.saleCost` (default: the current contracts, `ceil`). `fillWei` is the least gross whose net
+ * walks to the end of the sale in that rounding.
+ */
+export declare function saleBuyQuote(s: SaleBook, amountInWei: bigint, tokenDecimals: number, rounding?: SaleCostRounding): SaleBuyQuote;
+/**
+ * A sell-back of `tokens` (`FloorLaunch._sell`), less the sale's FLOOR Platform fee (`floor(payout × bps / 10_000)`).
+ * - `stateless` (the current contracts, default): `payout = tokens × p0 / 1e18` — the tokens at the sale's one price,
+ *   rounded down — capped at the position's `contributed`.
+ * - `proRata` (older contracts): `payout = contributed × tokens / allocation`, rounded down.
+ * The position (`allocation` tokens bought for `contributed` quote) bounds both: `null` where the sale would revert
+ * (`tokens` zero or above the allocation).
+ */
+export declare function sellBackQuote(p0: bigint, contributed: bigint, allocation: bigint, tokens: bigint, teamFeeBps: number, rule?: ContractRules['sellBack']): {
+    payout: bigint;
+    fee: bigint;
+    paid: bigint;
+} | null;
+//# sourceMappingURL=sale.d.ts.map

package/dist/sale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sale.d.ts","sourceRoot":"","sources":["../src/sale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAItD,eAAO,MAAM,YAAY,MAAM,CAAC;AAEhC,8CAA8C;AAC9C,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,uGAAuG;IACvG,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAU,SAAQ,QAAQ;IACzC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAErD;AAED,sHAAsH;AACtH,wBAAgB,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG;IAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAAG,SAAS,CAOzG;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAE/C;AAED,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAIlD;AAED,kEAAkE;AAClE,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;AAEzD,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAG3G;AAED,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAE,gBAAyB,GAAG,MAAM,CAWtF;AA+BD,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,GAAE,gBAAyB,GAAG,YAAY,CAMvI;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,aAAa,CAAC,UAAU,CAAe,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAU1N"}