@ickb/sdk 0.0.0

package/LICENSE

@@ -0,0 +1,19 @@
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,35 @@
+# iCKB/SDK
+
+iCKB SDK built on top of CCC
+
+## Dependencies
+
+```mermaid
+graph TD;
+    A["@ickb/utils"] --> B["@ckb-ccc/core"];
+    C["@ickb/dao"] --> A;
+    C --> B;
+    D["@ickb/core"] --> A;
+    D --> C;
+    E["@ickb/order"] --> A;
+    E --> B;
+    F["@ickb/sdk"] --> A;
+    F --> C;
+    F --> D;
+    F --> E;
+
+    click A "https://github.com/ickb/utils" "Go to @ickb/utils"
+    click B "https://github.com/ckb-devrel/ccc/tree/master/packages/core" "Go to @ckb-ccc/core"
+    click C "https://github.com/ickb/dao" "Go to @ickb/dao"
+    click D "https://github.com/ickb/core" "Go to @ickb/core"
+    click E "https://github.com/ickb/order" "Go to @ickb/order"
+    click F "https://github.com/ickb/sdk" "Go to @ickb/sdk"
+```
+
+## Epoch Semantic Versioning
+
+This repository follows [Epoch Semantic Versioning](https://antfu.me/posts/epoch-semver). In short ESV aims to provide a more nuanced and effective way to communicate software changes, allowing for better user understanding and smoother upgrades.
+
+## Licensing
+
+This source code, crafted with care by [Phroi](https://phroi.com/), is freely available on [GitHub](https://github.com/ickb/sdk) and it is released under the [MIT License](./LICENSE).

package/dist/cjs/index.d.ts

@@ -0,0 +1,36 @@
+import type { ccc } from "@ckb-ccc/core";
+import { type ScriptDeps } from "@ickb/utils";
+import { LogicManager, OwnedOwnerManager, type iCKBDepositCell, type ReceiptCell, type WithdrawalGroups } from "@ickb/core";
+import { OrderManager, Ratio, type OrderGroup } from "@ickb/order";
+export declare class IckbController {
+    logicManager: LogicManager;
+    ownedOwnerManager: OwnedOwnerManager;
+    orderManager: OrderManager;
+    constructor(logicManager: LogicManager, ownedOwnerManager: OwnedOwnerManager, orderManager: OrderManager);
+    static fromDeps({ xudt, dao, ickbLogic, ownedOwner, order, }: {
+        xudt: ScriptDeps;
+        dao: ScriptDeps;
+        ickbLogic: ScriptDeps;
+        ownedOwner: ScriptDeps;
+        order: ScriptDeps;
+    }): IckbController;
+    previewConversion(isCkb2Udt: boolean, amount: ccc.FixedPoint, options: ({
+        ratio: Ratio;
+    } | {
+        tip: ccc.ClientBlockHeader;
+    }) & {
+        fee?: {
+            numerator: ccc.Num;
+            denominator: ccc.Num;
+        };
+    }): ccc.FixedPoint;
+    fetchL1State(client: ccc.Client, locks: ccc.ScriptLike[]): Promise<L1State>;
+}
+export interface L1State {
+    tip: ccc.ClientBlockHeader;
+    depositPool: iCKBDepositCell[];
+    receipts: ReceiptCell[];
+    withdrawalGroups: WithdrawalGroups[];
+    orders: OrderGroup[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAGL,YAAY,EACZ,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEnE,qBAAa,cAAc;IAEhB,YAAY,EAAE,YAAY;IAC1B,iBAAiB,EAAE,iBAAiB;IACpC,YAAY,EAAE,YAAY;gBAF1B,YAAY,EAAE,YAAY,EAC1B,iBAAiB,EAAE,iBAAiB,EACpC,YAAY,EAAE,YAAY;IAGnC,MAAM,CAAC,QAAQ,CAAC,EACd,IAAI,EACJ,GAAG,EACH,SAAS,EACT,UAAU,EACV,KAAK,GACN,EAAE;QACD,IAAI,EAAE,UAAU,CAAC;QACjB,GAAG,EAAE,UAAU,CAAC;QAChB,SAAS,EAAE,UAAU,CAAC;QACtB,UAAU,EAAE,UAAU,CAAC;QACvB,KAAK,EAAE,UAAU,CAAC;KACnB,GAAG,cAAc;IAWlB,iBAAiB,CACf,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE,GAAG,CAAC,UAAU,EACtB,OAAO,EAAE,CAAC;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,GAAG;QAAE,GAAG,EAAE,GAAG,CAAC,iBAAiB,CAAA;KAAE,CAAC,GAAG;QAC7D,GAAG,CAAC,EAAE;YACJ,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC;YACnB,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC;SACtB,CAAC;KACH,GACA,GAAG,CAAC,UAAU;IAgBX,YAAY,CAChB,MAAM,EAAE,GAAG,CAAC,MAAM,EAClB,KAAK,EAAE,GAAG,CAAC,UAAU,EAAE,GACtB,OAAO,CAAC,OAAO,CAAC;CAqBpB;AAED,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,GAAG,CAAC,iBAAiB,CAAC;IAC3B,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;IACrC,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB"}

package/dist/cjs/index.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IckbController = void 0;
+const utils_1 = require("@ickb/utils");
+const core_1 = require("@ickb/core");
+const dao_1 = require("@ickb/dao");
+const order_1 = require("@ickb/order");
+class IckbController {
+    constructor(logicManager, ownedOwnerManager, orderManager) {
+        this.logicManager = logicManager;
+        this.ownedOwnerManager = ownedOwnerManager;
+        this.orderManager = orderManager;
+    }
+    static fromDeps({ xudt, dao, ickbLogic, ownedOwner, order, }) {
+        const daoManager = dao_1.DaoManager.fromDeps(dao);
+        const udtHandler = core_1.iCKBUdtHandler.fromDeps(xudt, daoManager);
+        return new IckbController(core_1.LogicManager.fromDeps(ickbLogic, daoManager, udtHandler), core_1.OwnedOwnerManager.fromDeps(ownedOwner, daoManager, udtHandler), order_1.OrderManager.fromDeps(order, udtHandler));
+    }
+    previewConversion(isCkb2Udt, amount, options) {
+        const { ckbScale, udtScale } = "ratio" in options ? options.ratio : (0, core_1.ickbExchangeRatio)(options.tip);
+        let convertedAmount = isCkb2Udt
+            ? (amount * ckbScale) / udtScale
+            : (amount * udtScale) / ckbScale;
+        if (options.fee) {
+            const { numerator, denominator } = options.fee;
+            convertedAmount -= (convertedAmount * numerator) / denominator;
+        }
+        return convertedAmount;
+    }
+    async fetchL1State(client, locks) {
+        const tip = await client.getTipHeader();
+        const onChain = true;
+        const options = {
+            tip,
+            onChain,
+        };
+        const [depositPool, receipts, withdrawalGroups, orders] = await Promise.all([
+            (0, utils_1.arrayFrom)(this.logicManager.findDeposits(client, options)),
+            (0, utils_1.arrayFrom)(this.logicManager.findReceipts(client, locks, options)),
+            (0, utils_1.arrayFrom)(this.ownedOwnerManager.findWithdrawalGroups(client, locks, options)),
+            this.orderManager.findOrders(client),
+        ]);
+        return { tip, depositPool, receipts, withdrawalGroups, orders };
+    }
+}
+exports.IckbController = IckbController;
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AACA,uCAAyD;AACzD,qCAQoB;AACpB,mCAAuC;AACvC,uCAAmE;AAEnE,MAAa,cAAc;IACzB,YACS,YAA0B,EAC1B,iBAAoC,EACpC,YAA0B;QAF1B,iBAAY,GAAZ,YAAY,CAAc;QAC1B,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,iBAAY,GAAZ,YAAY,CAAc;IAChC,CAAC;IAEJ,MAAM,CAAC,QAAQ,CAAC,EACd,IAAI,EACJ,GAAG,EACH,SAAS,EACT,UAAU,EACV,KAAK,GAON;QACC,MAAM,UAAU,GAAG,gBAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,UAAU,GAAG,qBAAc,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAE7D,OAAO,IAAI,cAAc,CACvB,mBAAY,CAAC,QAAQ,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,EACxD,wBAAiB,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,EAC9D,oBAAY,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,CACzC,CAAC;IACJ,CAAC;IAED,iBAAiB,CACf,SAAkB,EAClB,MAAsB,EACtB,OAKC;QAED,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAC1B,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAA,wBAAiB,EAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAEtE,IAAI,eAAe,GAAG,SAAS;YAC7B,CAAC,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,QAAQ;YAChC,CAAC,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,QAAQ,CAAC;QAEnC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;YAC/C,eAAe,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC,GAAG,WAAW,CAAC;QACjE,CAAC;QAED,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,MAAkB,EAClB,KAAuB;QAEvB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC;QACrB,MAAM,OAAO,GAAG;YACd,GAAG;YACH,OAAO;SACR,CAAC;QAEF,MAAM,CAAC,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CACzE;YACE,IAAA,iBAAS,EAAC,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC1D,IAAA,iBAAS,EAAC,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YACjE,IAAA,iBAAS,EACP,IAAI,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CACpE;YACD,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC;SACrC,CACF,CAAC;QAEF,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAClE,CAAC;CACF;AA/ED,wCA+EC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,36 @@
+import type { ccc } from "@ckb-ccc/core";
+import { type ScriptDeps } from "@ickb/utils";
+import { LogicManager, OwnedOwnerManager, type iCKBDepositCell, type ReceiptCell, type WithdrawalGroups } from "@ickb/core";
+import { OrderManager, Ratio, type OrderGroup } from "@ickb/order";
+export declare class IckbController {
+    logicManager: LogicManager;
+    ownedOwnerManager: OwnedOwnerManager;
+    orderManager: OrderManager;
+    constructor(logicManager: LogicManager, ownedOwnerManager: OwnedOwnerManager, orderManager: OrderManager);
+    static fromDeps({ xudt, dao, ickbLogic, ownedOwner, order, }: {
+        xudt: ScriptDeps;
+        dao: ScriptDeps;
+        ickbLogic: ScriptDeps;
+        ownedOwner: ScriptDeps;
+        order: ScriptDeps;
+    }): IckbController;
+    previewConversion(isCkb2Udt: boolean, amount: ccc.FixedPoint, options: ({
+        ratio: Ratio;
+    } | {
+        tip: ccc.ClientBlockHeader;
+    }) & {
+        fee?: {
+            numerator: ccc.Num;
+            denominator: ccc.Num;
+        };
+    }): ccc.FixedPoint;
+    fetchL1State(client: ccc.Client, locks: ccc.ScriptLike[]): Promise<L1State>;
+}
+export interface L1State {
+    tip: ccc.ClientBlockHeader;
+    depositPool: iCKBDepositCell[];
+    receipts: ReceiptCell[];
+    withdrawalGroups: WithdrawalGroups[];
+    orders: OrderGroup[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAGL,YAAY,EACZ,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEnE,qBAAa,cAAc;IAEhB,YAAY,EAAE,YAAY;IAC1B,iBAAiB,EAAE,iBAAiB;IACpC,YAAY,EAAE,YAAY;gBAF1B,YAAY,EAAE,YAAY,EAC1B,iBAAiB,EAAE,iBAAiB,EACpC,YAAY,EAAE,YAAY;IAGnC,MAAM,CAAC,QAAQ,CAAC,EACd,IAAI,EACJ,GAAG,EACH,SAAS,EACT,UAAU,EACV,KAAK,GACN,EAAE;QACD,IAAI,EAAE,UAAU,CAAC;QACjB,GAAG,EAAE,UAAU,CAAC;QAChB,SAAS,EAAE,UAAU,CAAC;QACtB,UAAU,EAAE,UAAU,CAAC;QACvB,KAAK,EAAE,UAAU,CAAC;KACnB,GAAG,cAAc;IAWlB,iBAAiB,CACf,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE,GAAG,CAAC,UAAU,EACtB,OAAO,EAAE,CAAC;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,GAAG;QAAE,GAAG,EAAE,GAAG,CAAC,iBAAiB,CAAA;KAAE,CAAC,GAAG;QAC7D,GAAG,CAAC,EAAE;YACJ,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC;YACnB,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC;SACtB,CAAC;KACH,GACA,GAAG,CAAC,UAAU;IAgBX,YAAY,CAChB,MAAM,EAAE,GAAG,CAAC,MAAM,EAClB,KAAK,EAAE,GAAG,CAAC,UAAU,EAAE,GACtB,OAAO,CAAC,OAAO,CAAC;CAqBpB;AAED,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,GAAG,CAAC,iBAAiB,CAAC;IAC3B,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;IACrC,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB"}

package/dist/esm/index.js

@@ -0,0 +1,43 @@
+import { arrayFrom } from "@ickb/utils";
+import { ickbExchangeRatio, iCKBUdtHandler, LogicManager, OwnedOwnerManager, } from "@ickb/core";
+import { DaoManager } from "@ickb/dao";
+import { OrderManager } from "@ickb/order";
+export class IckbController {
+    constructor(logicManager, ownedOwnerManager, orderManager) {
+        this.logicManager = logicManager;
+        this.ownedOwnerManager = ownedOwnerManager;
+        this.orderManager = orderManager;
+    }
+    static fromDeps({ xudt, dao, ickbLogic, ownedOwner, order, }) {
+        const daoManager = DaoManager.fromDeps(dao);
+        const udtHandler = iCKBUdtHandler.fromDeps(xudt, daoManager);
+        return new IckbController(LogicManager.fromDeps(ickbLogic, daoManager, udtHandler), OwnedOwnerManager.fromDeps(ownedOwner, daoManager, udtHandler), OrderManager.fromDeps(order, udtHandler));
+    }
+    previewConversion(isCkb2Udt, amount, options) {
+        const { ckbScale, udtScale } = "ratio" in options ? options.ratio : ickbExchangeRatio(options.tip);
+        let convertedAmount = isCkb2Udt
+            ? (amount * ckbScale) / udtScale
+            : (amount * udtScale) / ckbScale;
+        if (options.fee) {
+            const { numerator, denominator } = options.fee;
+            convertedAmount -= (convertedAmount * numerator) / denominator;
+        }
+        return convertedAmount;
+    }
+    async fetchL1State(client, locks) {
+        const tip = await client.getTipHeader();
+        const onChain = true;
+        const options = {
+            tip,
+            onChain,
+        };
+        const [depositPool, receipts, withdrawalGroups, orders] = await Promise.all([
+            arrayFrom(this.logicManager.findDeposits(client, options)),
+            arrayFrom(this.logicManager.findReceipts(client, locks, options)),
+            arrayFrom(this.ownedOwnerManager.findWithdrawalGroups(client, locks, options)),
+            this.orderManager.findOrders(client),
+        ]);
+        return { tip, depositPool, receipts, withdrawalGroups, orders };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAmB,MAAM,aAAa,CAAC;AACzD,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,iBAAiB,GAIlB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,YAAY,EAA0B,MAAM,aAAa,CAAC;AAEnE,MAAM,OAAO,cAAc;IACzB,YACS,YAA0B,EAC1B,iBAAoC,EACpC,YAA0B;QAF1B,iBAAY,GAAZ,YAAY,CAAc;QAC1B,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,iBAAY,GAAZ,YAAY,CAAc;IAChC,CAAC;IAEJ,MAAM,CAAC,QAAQ,CAAC,EACd,IAAI,EACJ,GAAG,EACH,SAAS,EACT,UAAU,EACV,KAAK,GAON;QACC,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,UAAU,GAAG,cAAc,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAE7D,OAAO,IAAI,cAAc,CACvB,YAAY,CAAC,QAAQ,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,EACxD,iBAAiB,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,EAC9D,YAAY,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,CACzC,CAAC;IACJ,CAAC;IAED,iBAAiB,CACf,SAAkB,EAClB,MAAsB,EACtB,OAKC;QAED,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAC1B,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAEtE,IAAI,eAAe,GAAG,SAAS;YAC7B,CAAC,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,QAAQ;YAChC,CAAC,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,QAAQ,CAAC;QAEnC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;YAC/C,eAAe,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC,GAAG,WAAW,CAAC;QACjE,CAAC;QAED,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,MAAkB,EAClB,KAAuB;QAEvB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC;QACrB,MAAM,OAAO,GAAG;YACd,GAAG;YACH,OAAO;SACR,CAAC;QAEF,MAAM,CAAC,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CACzE;YACE,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC1D,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YACjE,SAAS,CACP,IAAI,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CACpE;YACD,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC;SACrC,CACF,CAAC;QAEF,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAClE,CAAC;CACF"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@ickb/sdk",
+  "version": "0.0.0",
+  "description": "iCKB SDK built on top of CCC",
+  "author": "phroi",
+  "license": "MIT",
+  "private": false,
+  "homepage": "https://github.com/ickb/sdk",
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/ickb/sdk.git"
+  },
+  "sideEffects": false,
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "files": [
+    "/dist",
+    "/src"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.25.1",
+    "eslint": "^9.25.1",
+    "prettier": "^3.5.3",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.31.0"
+  },
+  "dependencies": {
+    "@ckb-ccc/core": "^1.8.0",
+    "@ickb/core": "^1000.0.19",
+    "@ickb/dao": "^1000.0.19",
+    "@ickb/order": "^1000.0.17",
+    "@ickb/utils": "^1000.0.15"
+  },
+  "scripts": {
+    "build": "pnpm run build:esm && pnpm run build:cjs && node dist/cjs/index.js",
+    "build:esm": "tsc",
+    "build:cjs": "tsc --module commonjs --outDir dist/cjs",
+    "lint": "eslint ./src",
+    "up2lint": "rm pnpm-lock.yaml && pnpm up && pnpm build && pnpm lint"
+  }
+}

package/src/index.ts

@@ -0,0 +1,102 @@
+import type { ccc } from "@ckb-ccc/core";
+import { arrayFrom, type ScriptDeps } from "@ickb/utils";
+import {
+  ickbExchangeRatio,
+  iCKBUdtHandler,
+  LogicManager,
+  OwnedOwnerManager,
+  type iCKBDepositCell,
+  type ReceiptCell,
+  type WithdrawalGroups,
+} from "@ickb/core";
+import { DaoManager } from "@ickb/dao";
+import { OrderManager, Ratio, type OrderGroup } from "@ickb/order";
+
+export class IckbController {
+  constructor(
+    public logicManager: LogicManager,
+    public ownedOwnerManager: OwnedOwnerManager,
+    public orderManager: OrderManager,
+  ) {}
+
+  static fromDeps({
+    xudt,
+    dao,
+    ickbLogic,
+    ownedOwner,
+    order,
+  }: {
+    xudt: ScriptDeps;
+    dao: ScriptDeps;
+    ickbLogic: ScriptDeps;
+    ownedOwner: ScriptDeps;
+    order: ScriptDeps;
+  }): IckbController {
+    const daoManager = DaoManager.fromDeps(dao);
+    const udtHandler = iCKBUdtHandler.fromDeps(xudt, daoManager);
+
+    return new IckbController(
+      LogicManager.fromDeps(ickbLogic, daoManager, udtHandler),
+      OwnedOwnerManager.fromDeps(ownedOwner, daoManager, udtHandler),
+      OrderManager.fromDeps(order, udtHandler),
+    );
+  }
+
+  previewConversion(
+    isCkb2Udt: boolean,
+    amount: ccc.FixedPoint,
+    options: ({ ratio: Ratio } | { tip: ccc.ClientBlockHeader }) & {
+      fee?: {
+        numerator: ccc.Num;
+        denominator: ccc.Num;
+      };
+    },
+  ): ccc.FixedPoint {
+    const { ckbScale, udtScale } =
+      "ratio" in options ? options.ratio : ickbExchangeRatio(options.tip);
+
+    let convertedAmount = isCkb2Udt
+      ? (amount * ckbScale) / udtScale
+      : (amount * udtScale) / ckbScale;
+
+    if (options.fee) {
+      const { numerator, denominator } = options.fee;
+      convertedAmount -= (convertedAmount * numerator) / denominator;
+    }
+
+    return convertedAmount;
+  }
+
+  async fetchL1State(
+    client: ccc.Client,
+    locks: ccc.ScriptLike[],
+  ): Promise<L1State> {
+    const tip = await client.getTipHeader();
+    const onChain = true;
+    const options = {
+      tip,
+      onChain,
+    };
+
+    const [depositPool, receipts, withdrawalGroups, orders] = await Promise.all(
+      [
+        arrayFrom(this.logicManager.findDeposits(client, options)),
+        arrayFrom(this.logicManager.findReceipts(client, locks, options)),
+        arrayFrom(
+          this.ownedOwnerManager.findWithdrawalGroups(client, locks, options),
+        ),
+        this.orderManager.findOrders(client),
+      ],
+    );
+
+    return { tip, depositPool, receipts, withdrawalGroups, orders };
+  }
+}
+
+export interface L1State {
+  tip: ccc.ClientBlockHeader;
+  depositPool: iCKBDepositCell[];
+  receipts: ReceiptCell[];
+  withdrawalGroups: WithdrawalGroups[];
+  orders: OrderGroup[];
+}