@ickb/sdk 1000.0.82 → 9000.0.1

package/dist/conversion/maturity.js

@@ -0,0 +1,112 @@
+import { BOT_LOCK_UP, depositMaturity } from "../dao.js";
+import { fillsWhole } from "../order/fill.js";
+import { convert, ICKB_DEPOSIT_CAP } from "../udt.js";
+import { compareBigInt } from "../utils/utils.js";
+/**
+ * Assumed turn duration, allowing for restart delay, confirmation and slow reads.
+ * This is a modeling interval, not a bound on the runtime; see sdk/docs/pool_maturity_estimates.md.
+ */
+export const BOT_TURN_MS = 10n * 60n * 1000n;
+/**
+ * The estimated fill time of an order on the book or about to be placed, zero when it is
+ * already fulfilled. `takenDeposits` are the pool deposits the same plan withdraws
+ * directly, which cannot fill its order leg too. Dual-ratio orders never reach here: the
+ * scan drops them.
+ */
+export function maturity(o, system, takenDeposits = []) {
+    const { info, amounts, self } = maturityOrderParts(o);
+    const isCkb2Udt = info.isCkb2Udt();
+    const amount = isCkb2Udt ? amounts.ckbValue : amounts.udtValue;
+    if (amount === 0n) {
+        return 0n;
+    }
+    return isCkb2Udt
+        ? ckbToIckbOrderMaturity(info, amount, system, self)
+        : ickbToCkbOrderMaturity(info, amount, system, takenDeposits, self);
+}
+/** The order's terms, and its own out point when it is already on the book. */
+function maturityOrderParts(o) {
+    if ("info" in o) {
+        return { ...o, self: undefined };
+    }
+    return {
+        info: o.data.info,
+        amounts: { ckbValue: o.ckbUnoccupied, udtValue: o.udtValue },
+        self: o.cell.outPoint,
+    };
+}
+/**
+ * A buyer waits for the bot to mint: the bot mints one cap-sized deposit per turn once its
+ * iCKB inventory is spent, and the inventory is unknown here, so the wait is one turn plus
+ * one per whole cap of positive net CKB demand (this request and buyers priced at least
+ * as well, less the iCKB sellers bring in). The model does not measure the bot's funds.
+ */
+function ckbToIckbOrderMaturity(info, amount, system, self) {
+    // An equal price counts as ahead: the bot fills ties in an order of its own choosing.
+    const buyersAhead = fillableOrders(system, true, self)
+        .filter((group) => group.order.data.info.ckbToUdt.compare(info.ckbToUdt) <= 0)
+        .reduce((ckb, group) => ckb + group.order.ckbUnoccupied, 0n);
+    const sellers = fillableOrders(system, false, self).reduce((udt, group) => udt + group.udtValue, 0n);
+    const demand = amount + buyersAhead - convert(false, sellers, system.exchangeRatio);
+    const capCkb = convert(false, ICKB_DEPOSIT_CAP, system.exchangeRatio);
+    const turns = demand > 0n ? 1n + demand / capCkb : 1n;
+    return system.tip.timestamp + BOT_TURN_MS * turns;
+}
+/**
+ * A seller waits for CKB: one deposit's worth of assumed working capital, zeroed when
+ * another fillable seller has sat beyond the threshold, plus dated pool supply. Return
+ * the first date covering demand, plus a turn. Insufficient supply falls back to the last
+ * date; this can understate an above-par ask's wait for further DAO growth.
+ */
+function ickbToCkbOrderMaturity(info, amount, system, takenDeposits, self) {
+    const sellers = fillableOrders(system, false, self);
+    const sellersAhead = sellers
+        .filter((group) => info.udtToCkb.compare(group.order.data.info.udtToCkb) <= 0)
+        .reduce((udt, group) => udt + group.udtValue, 0n);
+    // The CKB an order has already received belongs to its earlier fills; what it still
+    // needs is the remaining iCKB at its price.
+    const needed = info.udtToCkb.convert(false, amount, true) +
+        convert(false, sellersAhead, system.exchangeRatio);
+    const taken = new Set(takenDeposits.map((deposit) => deposit.cell.outPoint.toHex()));
+    const steps = [
+        {
+            ckbValue: sellers.some((group) => sits(group, system))
+                ? 0n
+                : convert(false, ICKB_DEPOSIT_CAP, system.exchangeRatio),
+            at: system.tip.timestamp,
+        },
+        // A claim the bot can no longer request in time rolls a cycle: the bot's rule, not the
+        // caller's, since the bot is the one making the requests.
+        ...system.poolDeposits
+            .filter((deposit) => !taken.has(deposit.cell.outPoint.toHex()))
+            .map((deposit) => ({
+            ckbValue: deposit.ckbValue,
+            at: depositMaturity(deposit.claimEpoch, system.tip, BOT_LOCK_UP).maturity.toUnix(system.tip),
+        }))
+            .toSorted((left, right) => compareBigInt(left.at, right.at)),
+    ];
+    let supply = 0n;
+    let at = system.tip.timestamp;
+    for (const step of steps) {
+        supply += step.ckbValue;
+        at = step.at;
+        if (supply >= needed) {
+            break;
+        }
+    }
+    return at + BOT_TURN_MS;
+}
+/** The book orders the bot would take whole in the given direction, this one aside. */
+function fillableOrders(system, isCkb2Udt, self) {
+    return system.orderPool.filter((group) => (self === undefined || !group.order.cell.outPoint.eq(self)) &&
+        fillsWhole(group, isCkb2Udt, system.exchangeRatio, system.feeRate));
+}
+/**
+ * Whether the order has been on the book for more than a turn, a twenty-fourth of an
+ * epoch in blocks: the bot has seen it and left it. An uncommitted origin is fresh.
+ */
+function sits(group, { tip }) {
+    return (group.blockNumber !== undefined &&
+        tip.number - group.blockNumber > tip.epoch.denominator / 24n);
+}
+//# sourceMappingURL=maturity.js.map

package/dist/conversion/maturity.js.map

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

package/dist/conversion/plans.d.ts

@@ -0,0 +1,20 @@
+import { type IckbDepositCell } from "../logic.js";
+import type { CkbToIckbConversionPlan, ConversionTransactionOptions, IckbToCkbConversionPlan } from "./types.js";
+/**
+ * Plans every deposit count from the most the amount covers down to zero, skipping
+ * unrepresentable remainders. Cap-sized deposits plus an order for the rest is the cheapest
+ * shape at every amount: a deposit's 82 CKB of occupied capacity goes to its withdrawer
+ * (0.082% at the cap, 8.2% at the contract's 1,000 CKB minimum), the excess above the cap
+ * is discounted 10%, and an order costs 0.01% at any size; the cap's CKB value grows with
+ * the DAO rate, so the order stays cheaper until the cap is worth 820,000 CKB.
+ */
+export declare function ckbToIckbConversionPlans(options: ConversionTransactionOptions): CkbToIckbConversionPlan[];
+/**
+ * Plans every prefix of the greedy ready-deposit selection, longest first, the remainder as
+ * an order: direct withdrawals are free and their claim date certain, an order pays a fee
+ * and waits for the bot, so the completion walk takes the most direct plan it can fund.
+ * The prefix shape keeps ring classification frozen: a prefix of surplus deposits stays
+ * surplus with the same anchors pinned.
+ */
+export declare function ickbToCkbConversionPlans(options: ConversionTransactionOptions, poolDeposits: readonly IckbDepositCell[]): IckbToCkbConversionPlan[];
+//# sourceMappingURL=plans.d.ts.map

package/dist/conversion/plans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plans.d.ts","sourceRoot":"","sources":["../../src/conversion/plans.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAUlE,OAAO,KAAK,EACV,uBAAuB,EAEvB,4BAA4B,EAC5B,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAWpB;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,4BAA4B,GACpC,uBAAuB,EAAE,CAgB3B;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,4BAA4B,EACrC,YAAY,EAAE,SAAS,eAAe,EAAE,GACvC,uBAAuB,EAAE,CAc3B"}

package/dist/conversion/plans.js

@@ -0,0 +1,106 @@
+import { DAO_OUTPUT_LIMIT } from "../dao.js";
+import { readyDeposits } from "../logic.js";
+import { ICKB_DEPOSIT_CAP, convert } from "../udt.js";
+import { maxBigInt } from "../utils/utils.js";
+import { DEFAULT_ORDER_FEE, DEFAULT_ORDER_FEE_BASE, estimateConversionOrder, estimateIckbToCkbOrder, } from "./estimate.js";
+import { sumUdt } from "./projection.js";
+import { fitWithdrawalDeposits, ringSurplusDepositFilter, sortByClaim, } from "./withdrawal_ring.js";
+// The planner starts at the most `DAO_OUTPUT_LIMIT` can hold, one change output beside the
+// deposits, and the completion walk steps down from there when change and fees need more room.
+const MAX_PLANNED_DEPOSITS = DAO_OUTPUT_LIMIT - 1;
+/**
+ * Plans every deposit count from the most the amount covers down to zero, skipping
+ * unrepresentable remainders. Cap-sized deposits plus an order for the rest is the cheapest
+ * shape at every amount: a deposit's 82 CKB of occupied capacity goes to its withdrawer
+ * (0.082% at the cap, 8.2% at the contract's 1,000 CKB minimum), the excess above the cap
+ * is discounted 10%, and an order costs 0.01% at any size; the cap's CKB value grows with
+ * the DAO rate, so the order stays cheaper until the cap is worth 820,000 CKB.
+ */
+export function ckbToIckbConversionPlans(options) {
+    const { amount, context } = options;
+    const depositCapacity = convert(false, ICKB_DEPOSIT_CAP, context.system.exchangeRatio);
+    const depositQuotient = depositCapacity === 0n ? 0n : amount / depositCapacity;
+    const maxDeposits = depositQuotient > BigInt(MAX_PLANNED_DEPOSITS)
+        ? MAX_PLANNED_DEPOSITS
+        : Number(depositQuotient);
+    const plans = [];
+    for (let depositCount = maxDeposits; depositCount >= 0; depositCount -= 1) {
+        const plan = ckbToIckbConversionPlan(options, depositCapacity, depositCount);
+        if (plan !== undefined) {
+            plans.push(plan);
+        }
+    }
+    return plans;
+}
+/**
+ * Plans every prefix of the greedy ready-deposit selection, longest first, the remainder as
+ * an order: direct withdrawals are free and their claim date certain, an order pays a fee
+ * and waits for the bot, so the completion walk takes the most direct plan it can fund.
+ * The prefix shape keeps ring classification frozen: a prefix of surplus deposits stays
+ * surplus with the same anchors pinned.
+ */
+export function ickbToCkbConversionPlans(options, poolDeposits) {
+    const { amount, context } = options;
+    const { tip, lockUp } = context.system;
+    const ready = readyDeposits(poolDeposits, tip, lockUp);
+    const isSurplus = ringSurplusDepositFilter(poolDeposits, ready);
+    const deposits = fitWithdrawalDeposits(sortByClaim(ready.filter(isSurplus)), amount);
+    const plans = [];
+    for (let count = deposits.length; count >= 0; count -= 1) {
+        const plan = ickbToCkbConversionPlan(options, deposits.slice(0, count));
+        if (plan !== undefined) {
+            plans.push(plan);
+        }
+    }
+    return plans;
+}
+function ckbToIckbConversionPlan(options, depositCapacity, depositCount) {
+    const { amount, context } = options;
+    const remainder = amount - depositCapacity * BigInt(depositCount);
+    let estimatedMaturity = context.estimatedMaturity;
+    let order;
+    if (remainder > 0n) {
+        const amounts = { ckbValue: remainder, udtValue: 0n };
+        const estimate = estimateConversionOrder(true, amounts, context.system, {
+            fee: DEFAULT_ORDER_FEE,
+            feeBase: DEFAULT_ORDER_FEE_BASE,
+        });
+        if (estimate?.maturity === undefined) {
+            return undefined;
+        }
+        estimatedMaturity = maxBigInt(estimatedMaturity, estimate.maturity);
+        order = { amounts, estimate };
+    }
+    return {
+        depositCapacity,
+        depositCount,
+        estimatedMaturity,
+        ...(order === undefined ? {} : { order }),
+    };
+}
+function ickbToCkbConversionPlan(options, selectedDeposits) {
+    const { amount, context } = options;
+    let estimatedMaturity = context.estimatedMaturity;
+    // Selected deposits are ready, so their sampled claim is their date.
+    for (const deposit of selectedDeposits) {
+        estimatedMaturity = maxBigInt(estimatedMaturity, deposit.claimEpoch.toUnix(context.system.tip));
+    }
+    const remainder = amount - sumUdt(selectedDeposits);
+    let order;
+    if (remainder > 0n) {
+        const amounts = { ckbValue: 0n, udtValue: remainder };
+        // The deposits this plan withdraws directly cannot fill its order leg too.
+        const estimate = estimateIckbToCkbOrder(amounts, context.system, selectedDeposits);
+        if (estimate === undefined) {
+            return undefined;
+        }
+        estimatedMaturity = maxBigInt(estimatedMaturity, estimate.maturity);
+        order = { amounts, estimate };
+    }
+    return {
+        estimatedMaturity,
+        ...(order === undefined ? {} : { order }),
+        selectedDeposits,
+    };
+}
+//# sourceMappingURL=plans.js.map

package/dist/conversion/plans.js.map

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

package/dist/conversion/projection.d.ts

@@ -0,0 +1,22 @@
+import type { OrderGroup } from "../order/cells.js";
+import type { AccountAvailabilityProjection, AccountState, ConversionTransactionContextProjection, SystemState } from "./types.js";
+/**
+ * Builds the conversion planner context from account state and the caller's own orders,
+ * split by what it will melt: `available` orders are collected and budgeted as account
+ * value, `pending` ones stay on the book.
+ */
+export declare function projectConversionTransactionContext(system: SystemState, account: AccountState, orders: {
+    available: OrderGroup[];
+    pending: OrderGroup[];
+}): ConversionTransactionContextProjection;
+/**
+ * Splits wallet-owned CKB and iCKB into immediately available and pending value.
+ */
+export declare function projectAccountAvailability(account: AccountState, { available: availableOrders, pending: pendingOrders, }: {
+    available: OrderGroup[];
+    pending: OrderGroup[];
+}): AccountAvailabilityProjection;
+export declare function sumUdt(items: ReadonlyArray<{
+    udtValue: bigint;
+}>): bigint;
+//# sourceMappingURL=projection.d.ts.map

package/dist/conversion/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../src/conversion/projection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIpD,OAAO,KAAK,EACV,6BAA6B,EAC7B,YAAY,EACZ,sCAAsC,EACtC,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE;IAAE,SAAS,EAAE,UAAU,EAAE,CAAC;IAAC,OAAO,EAAE,UAAU,EAAE,CAAA;CAAE,GACzD,sCAAsC,CAsBxC;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,YAAY,EACrB,EACE,SAAS,EAAE,eAAe,EAC1B,OAAO,EAAE,aAAa,GACvB,EAAE;IAAE,SAAS,EAAE,UAAU,EAAE,CAAC;IAAC,OAAO,EAAE,UAAU,EAAE,CAAA;CAAE,GACpD,6BAA6B,CAmC/B;AA2BD,wBAAgB,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,CAEzE"}

package/dist/conversion/projection.js

@@ -0,0 +1,91 @@
+import { ccc } from "@ckb-ccc/core";
+import { DAO_HEADER_INDEX_LIMIT } from "../dao.js";
+import { maxBigInt } from "../utils/utils.js";
+import { maturity } from "./maturity.js";
+/**
+ * Builds the conversion planner context from account state and the caller's own orders,
+ * split by what it will melt: `available` orders are collected and budgeted as account
+ * value, `pending` ones stay on the book.
+ */
+export function projectConversionTransactionContext(system, account, orders) {
+    const projection = projectAccountAvailability(account, orders);
+    const estimatedMaturity = [
+        ...projection.pendingWithdrawals.map((group) => group.owned.maturity.toUnix(system.tip)),
+        ...projection.pendingOrders.map((group) => maturity(group.order, system)),
+    ].reduce(maxBigInt, system.tip.timestamp);
+    return {
+        projection,
+        context: {
+            system,
+            receipts: account.receipts,
+            readyWithdrawals: projection.readyWithdrawals,
+            availableOrders: projection.availableOrders,
+            cells: [...account.capacityCells, ...account.nativeUdtCells],
+            ckbAvailable: projection.ckbAvailable,
+            ickbAvailable: projection.ickbAvailable,
+            estimatedMaturity,
+        },
+    };
+}
+/**
+ * Splits wallet-owned CKB and iCKB into immediately available and pending value.
+ */
+export function projectAccountAvailability(account, { available: availableOrders, pending: pendingOrders, }) {
+    const { readyWithdrawals, pendingWithdrawals } = splitWithdrawals(account.withdrawalGroups);
+    // An iCKB cell's capacity is the owner's CKB too: completion spends it like a plain cell.
+    const ckbNative = sumValues([...account.capacityCells, ...account.nativeUdtCells], (cell) => cell.cellOutput.capacity);
+    const ickbNative = sumValues(account.nativeUdtCells, (cell) => ccc.udtBalanceFrom(cell.outputData));
+    const ckbAvailable = ckbNative +
+        sumCkb(account.receipts) +
+        sumCkb(readyWithdrawals) +
+        sumCkb(availableOrders);
+    const ickbAvailable = ickbNative + sumUdt(account.receipts) + sumUdt(availableOrders);
+    const ckbPending = sumCkb(pendingWithdrawals) + sumCkb(pendingOrders);
+    const ickbPending = sumUdt(pendingOrders);
+    return {
+        ckbNative,
+        ickbNative,
+        ckbAvailable,
+        ickbAvailable,
+        ckbPending,
+        ickbPending,
+        ckbBalance: ckbAvailable + ckbPending,
+        ickbBalance: ickbAvailable + ickbPending,
+        readyWithdrawals,
+        pendingWithdrawals,
+        availableOrders,
+        pendingOrders,
+    };
+}
+/**
+ * `ready` is the batch one transaction can complete: the deployed DAO script addresses a
+ * withdrawal's deposit header only below `DAO_HEADER_INDEX_LIMIT`, and the builder puts
+ * those headers first, so matured withdrawals past that count wait a turn.
+ */
+function splitWithdrawals(withdrawalGroups) {
+    const readyWithdrawals = [];
+    const pendingWithdrawals = [];
+    for (const group of withdrawalGroups) {
+        if (group.owned.isReady && readyWithdrawals.length < DAO_HEADER_INDEX_LIMIT) {
+            readyWithdrawals.push(group);
+        }
+        else {
+            pendingWithdrawals.push(group);
+        }
+    }
+    return { readyWithdrawals, pendingWithdrawals };
+}
+function sumCkb(items) {
+    return sumValues(items, (item) => item.ckbValue);
+}
+export function sumUdt(items) {
+    return sumValues(items, (item) => item.udtValue);
+}
+function sumValues(items, project) {
+    let total = 0n;
+    for (const item of items) {
+        total += project(item);
+    }
+    return total;
+}
+//# sourceMappingURL=projection.js.map

package/dist/conversion/projection.js.map

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

package/dist/conversion/types.d.ts

@@ -0,0 +1,252 @@
+import type { ccc } from "@ckb-ccc/core";
+import type { LockUpPolicy } from "../dao.js";
+import type { IckbDepositCell, LogicManager, ReceiptCell } from "../logic.js";
+import type { OrderCell, OrderGroup } from "../order/cells.js";
+import type { Info } from "../order/info.js";
+import type { OrderManager } from "../order/order.js";
+import type { Ratio } from "../order/ratio.js";
+import type { OwnedOwnerManager, WithdrawalGroup } from "../owned_owner.js";
+import type { IckbUdt } from "../udt.js";
+import type { ValueComponents } from "../utils/utils.js";
+/**
+ * Direction requested by a conversion transaction.
+ */
+export type ConversionDirection = "ckb-to-ickb" | "ickb-to-ckb";
+/**
+ * Snapshot used to plan one wallet conversion transaction.
+ */
+export interface ConversionTransactionContext {
+    /** Public system state sampled for conversion planning. */
+    system: SystemState;
+    /** User receipt cells available for deposit completion. */
+    receipts: ReceiptCell[];
+    /** User withdrawal groups ready to complete. */
+    readyWithdrawals: WithdrawalGroup[];
+    /** Order groups available for collection or budgeting as account value. */
+    availableOrders: OrderGroup[];
+    /** The wallet's liquid cells, plain CKB and iCKB, that completion funds from and sweeps. */
+    cells: ccc.Cell[];
+    /** Projected CKB available to the wallet after pending state is considered. */
+    ckbAvailable: bigint;
+    /** Projected iCKB available to the wallet after pending state is considered. */
+    ickbAvailable: bigint;
+    /**
+     * The latest date at which everything the wallet has converting, plus this request, is
+     * collectable; an amount of zero is the collection itself.
+     */
+    estimatedMaturity: bigint;
+}
+/**
+ * Inputs and policy limits for building one conversion transaction.
+ */
+export interface ConversionTransactionOptions {
+    /** Conversion direction to build. */
+    direction: ConversionDirection;
+    /** Requested input amount in the source asset. */
+    amount: bigint;
+    /**
+     * Lock that owns every cell the transaction creates for the user, the conversion outputs
+     * and the change; the signer's recommended lock by default. Completion sweeps the liquid
+     * cells along within its input limit, so a foreign lock redirects those funds too.
+     */
+    lock?: ccc.Script;
+    /** Signer whose committed cells fund the completed transaction. */
+    signer: ccc.Signer;
+    /** Sampled state used to plan this conversion. */
+    context: ConversionTransactionContext;
+}
+/**
+ * Reason a conversion transaction could not be built without throwing.
+ */
+export type ConversionTransactionFailureReason = "amount-negative" | "insufficient-ckb" | "insufficient-ickb" | "amount-too-small" | "nothing-to-do";
+/**
+ * A dust iCKB-to-CKB order: too small for the default fee to clear the estimate threshold,
+ * so it pays the smallest fee that does. For callers to surface in UI or logs.
+ */
+export interface ConversionNotice {
+    /** iCKB input amount that triggered the notice. */
+    inputIckb: bigint;
+    /** CKB output estimate for the noticed path. */
+    outputCkb: bigint;
+    /** CKB incentive associated with the noticed path. */
+    incentiveCkb: bigint;
+}
+/**
+ * High-level conversion composition used by a built transaction.
+ */
+export interface ConversionMetadata {
+    /** Composition category selected for the built conversion. */
+    kind: "direct" | "order" | "direct-plus-order" | "collect-only";
+}
+/**
+ * Result of attempting to build a conversion transaction.
+ */
+export type ConversionTransactionResult = {
+    ok: true;
+    /** Completed transaction, funded from the signer's committed cells. Callers own signing and send. */
+    tx: ccc.Transaction;
+    /** Estimated maturity timestamp for the conversion result. */
+    estimatedMaturity: bigint;
+    /** Composition of the selected conversion path. */
+    conversion: ConversionMetadata;
+    /** Optional notice about the selected path. */
+    conversionNotice?: ConversionNotice;
+    /**
+     * True when every liquid cell of the context is an input. False when the input limit
+     * left some behind: a move to another lock then needs another transaction.
+     */
+    isSweepComplete: boolean;
+    /**
+     * The epoch the transaction must be broadcast before for its withdrawal requests to
+     * claim at their sampled dates (`system.lockUp`); absent when it requests none.
+     */
+    broadcastBefore?: ccc.Epoch;
+} | {
+    ok: false;
+    /** Machine-readable failure reason. */
+    reason: ConversionTransactionFailureReason;
+    /** Best available maturity estimate from the input context. */
+    estimatedMaturity: bigint;
+    /**
+     * For `amount-too-small`: the smallest amount this direction accepts at the current fee
+     * rate, in the request's unit (CKB shannons or iCKB), so a caller can name it.
+     */
+    minimum?: bigint;
+};
+/**
+ * Options for completing a partial iCKB transaction before signing and sending.
+ */
+export interface CompleteIckbTransactionOptions {
+    /** Signer that prepares the transaction; its recommended lock owns the change by default. */
+    signer: ccc.Signer;
+    /** Lock that owns the change, iCKB and plain, when not the signer's recommended lock. */
+    lock?: ccc.Script;
+    /** Fee rate passed to CCC fee completion. */
+    feeRate: ccc.Num;
+    /** The signer's known liquid cells, plain CKB and iCKB, from the account state already read. */
+    cells: ccc.Cell[];
+}
+/**
+ * Quote details for one order-based conversion path.
+ */
+export interface ConversionOrderEstimate {
+    /** Output amount after applying the order ratio and fee. */
+    convertedAmount: ccc.FixedPoint;
+    /** CKB fee component embedded in the order conversion. */
+    ckbFee: ccc.FixedPoint;
+    /** Order info that should be encoded into a created order. */
+    info: Info;
+    /** Estimated maturity timestamp, or `undefined` when it cannot be estimated. */
+    maturity: ccc.Num | undefined;
+    /** A non-fatal notice about the path this estimate took, for the caller to surface. */
+    notice?: ConversionNotice;
+}
+/**
+ * Input accepted by maturity estimation, either a live order cell or raw order data plus values.
+ */
+export type MaturityOrderInput = OrderCell | {
+    info: Info;
+    amounts: ValueComponents;
+};
+/**
+ * Raw wallet-owned cells and grouped iCKB state sampled from L1.
+ */
+export interface AccountState {
+    /** Plain capacity cells owned by the account locks. */
+    capacityCells: ccc.Cell[];
+    /** Native iCKB xUDT cells owned by the account locks. */
+    nativeUdtCells: ccc.Cell[];
+    /** Receipt cells owned by the account. */
+    receipts: ReceiptCell[];
+    /** Withdrawal groups owned by the account. */
+    withdrawalGroups: WithdrawalGroup[];
+}
+/**
+ * Account balances split into available, pending, and order/withdrawal buckets.
+ */
+export interface AccountAvailabilityProjection {
+    /**
+     * CKB in the account's liquid cells, plain and iCKB alike: what the wallet shows and what
+     * the next transaction spends, before the change cells, an order's master cell and the
+     * fee it must fund on top.
+     */
+    ckbNative: bigint;
+    /** iCKB in the account's native iCKB cells. */
+    ickbNative: bigint;
+    /** `ckbNative` plus the CKB the receipts, ready withdrawals and collectable orders return. */
+    ckbAvailable: bigint;
+    /** `ickbNative` plus the iCKB the receipts and collectable orders return. */
+    ickbAvailable: bigint;
+    /** CKB pending in withdrawals or orders. */
+    ckbPending: bigint;
+    /** iCKB pending in withdrawals or orders. */
+    ickbPending: bigint;
+    /** Total CKB balance including pending positions. */
+    ckbBalance: bigint;
+    /** Total iCKB balance including pending positions. */
+    ickbBalance: bigint;
+    /**
+     * Matured withdrawal groups one transaction can complete: at most the deposit-header slots
+     * the DAO script addresses (`DAO_HEADER_INDEX_LIMIT`), which the deposit headers hold alone.
+     */
+    readyWithdrawals: WithdrawalGroup[];
+    /** Withdrawal groups still waiting for DAO maturity or for a header slot in a later turn. */
+    pendingWithdrawals: WithdrawalGroup[];
+    /** Order groups available for collection or budgeting as account value. */
+    availableOrders: OrderGroup[];
+    /** Order groups that are owned but unavailable or unresolved. */
+    pendingOrders: OrderGroup[];
+}
+/**
+ * Combined projection and transaction-planning context for one sampled account state.
+ */
+export interface ConversionTransactionContextProjection {
+    /** User-facing availability projection. */
+    projection: AccountAvailabilityProjection;
+    /** Builder-facing transaction context derived from the same sampled state. */
+    context: ConversionTransactionContext;
+}
+/**
+ * Public sampled system state used for quotes, maturity, and conversion planning.
+ */
+export interface SystemState {
+    /** The fee rate for transactions. */
+    feeRate: ccc.Num;
+    /** Sampled tip used for this L1 scan. It may be stale after scans complete. */
+    tip: ccc.ClientBlockHeader;
+    /** The exchange ratio between CKB and UDT. */
+    exchangeRatio: Ratio;
+    /** Every order past par on the book, the wallet's own included: what the bot can fill. */
+    orderPool: OrderGroup[];
+    /** Every iCKB pool deposit with its claim epoch at this tip: the CKB supply. */
+    poolDeposits: IckbDepositCell[];
+    /** The caller's withdrawal timing rules, which every builder and the sender follow. */
+    lockUp: LockUpPolicy;
+}
+/** Manager set that builds one iCKB SDK instance. */
+export interface SdkManagers {
+    /** iCKB xUDT manager with receipt and DAO deposit aware completion. */
+    ickbUdt: IckbUdt;
+    /** Owned-owner manager for withdrawal request and claim cells. */
+    ownedOwner: OwnedOwnerManager;
+    /** iCKB Logic manager for deposits and receipts. */
+    ickbLogic: LogicManager;
+    /** Limit order manager. */
+    order: OrderManager;
+}
+export interface ConversionOrder {
+    amounts: ValueComponents;
+    estimate: ConversionOrderEstimate;
+}
+export interface CkbToIckbConversionPlan {
+    depositCapacity: bigint;
+    depositCount: number;
+    estimatedMaturity: bigint;
+    order?: ConversionOrder;
+}
+export interface IckbToCkbConversionPlan {
+    estimatedMaturity: bigint;
+    order?: ConversionOrder;
+    selectedDeposits: IckbDepositCell[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/conversion/types.d.ts.map

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

package/dist/conversion/types.js

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