@interest-protocol/blast-core 0.1.0 → 0.2.0

package/dist/effects.js

@@ -0,0 +1,143 @@
+import { normalizeStructTag, normalizeSuiAddress, normalizeSuiObjectId, parseStructTag, SUI_FRAMEWORK_ADDRESS, } from "@mysten/sui/utils";
+import { normalizeSharedObjectIdentity } from "./sui.js";
+/** `sui::object::sui_coin_registry_address()`. */
+export const COIN_REGISTRY_ID = normalizeSuiObjectId("0xc");
+/** The objects a successful transaction created. */
+export function createdObjects(result) {
+    if (!result.effects.status.success) {
+        throw new TypeError("transaction did not succeed");
+    }
+    return result.effects.changedObjects.filter((object) => object.idOperation === "Created");
+}
+/** The one package a publication created. */
+export function readPublishedPackage(created) {
+    const packages = created.filter((object) => object.outputState === "PackageWrite");
+    if (packages.length !== 1) {
+        throw new TypeError("publication must create exactly one package");
+    }
+    return normalizeSuiObjectId(packages[0].objectId);
+}
+/** The parsed type of a touched object, or undefined for a package. */
+export function typeOf(result, objectId) {
+    const type = result.objectTypes[normalizeSuiObjectId(objectId)] ??
+        result.objectTypes[objectId];
+    return type === undefined || type === "package"
+        ? undefined
+        : parseStructTag(type);
+}
+/** Whether the object is `0x2::coin_registry::Currency<coinType>`. */
+export function isCurrencyOf(result, objectId, coinType) {
+    const tag = typeOf(result, objectId);
+    const parameter = tag?.typeParams[0];
+    return (tag?.address === normalizeSuiAddress(SUI_FRAMEWORK_ADDRESS) &&
+        tag.module === "coin_registry" &&
+        tag.name === "Currency" &&
+        tag.typeParams.length === 1 &&
+        parameter !== undefined &&
+        normalizeStructTag(parameter) === coinType);
+}
+/**
+ * The `<core>::sealed_treasury_cap::SealedTreasuryCap<Coin>` objects a
+ * publication created, each with its sealed coin type, in effects order.
+ */
+export function sealedTreasuryCaps(result, created, coreOriginalPackageId) {
+    const core = normalizeSuiAddress(coreOriginalPackageId);
+    return created.flatMap((object) => {
+        const tag = typeOf(result, object.objectId);
+        const parameter = tag?.typeParams[0];
+        return tag?.address === core &&
+            tag.module === "sealed_treasury_cap" &&
+            tag.name === "SealedTreasuryCap" &&
+            parameter !== undefined &&
+            typeof parameter !== "string"
+            ? [{ object, coinType: normalizeStructTag(parameter) }]
+            : [];
+    });
+}
+/**
+ * The one sealed `TreasuryCap<coinType>` a publication sent to `owner`;
+ * `where` names the expectation in the error.
+ */
+export function readSealedTreasuryCap(result, created, coreOriginalPackageId, coinType, owner, where) {
+    const caps = sealedTreasuryCaps(result, created, coreOriginalPackageId)
+        .filter((cap) => cap.coinType === coinType &&
+        cap.object.outputOwner?.$kind === "AddressOwner" &&
+        normalizeSuiAddress(cap.object.outputOwner.AddressOwner) === owner)
+        .map(({ object }) => object);
+    const [cap] = caps;
+    if (caps.length !== 1 || !cap) {
+        throw new TypeError(`publication must send exactly one SealedTreasuryCap<Coin> ${where}`);
+    }
+    return { ...versionReference(cap), owner };
+}
+/** The one `Currency<coinType>` a publication sent to the Coin Registry address. */
+export function readPendingCurrency(result, created, coinType) {
+    const currencies = created.filter((object) => isCurrencyOf(result, object.objectId, coinType) &&
+        object.outputOwner?.$kind === "AddressOwner" &&
+        normalizeSuiAddress(object.outputOwner.AddressOwner) === COIN_REGISTRY_ID);
+    if (currencies.length !== 1) {
+        throw new TypeError("publication must send exactly one Currency<Coin> to the Coin Registry");
+    }
+    return versionReference(currencies[0]);
+}
+/**
+ * Reads the shared `Currency<coinType>` that
+ * `coin_registry::finalize_registration` created at its derived address;
+ * mutable for the product's `finalize`.
+ */
+export function readCurrencyRegistration(result, coinType) {
+    const coin = normalizeStructTag(coinType);
+    const currencies = createdObjects(result).filter((object) => object.outputOwner?.$kind === "Shared" &&
+        isCurrencyOf(result, object.objectId, coin));
+    if (currencies.length !== 1) {
+        throw new TypeError("registration must share exactly one Currency<Coin>");
+    }
+    return sharedReference(currencies[0]);
+}
+/**
+ * `0x2::coin_registry::finalize_registration<Coin>(registry, currency)`:
+ * shares a published coin's pending `Currency` from the Coin Registry
+ * address (`readPendingCurrency`). Anyone may run it; `coinRegistry` is the
+ * shared registry `0xc` with its initial shared version, so it builds
+ * offline.
+ */
+export function finalizeCurrencyRegistration(options) {
+    const coinType = normalizeStructTag(options.coinType);
+    const currency = {
+        objectId: normalizeSuiObjectId(options.currency.objectId),
+        version: options.currency.version,
+        digest: options.currency.digest,
+    };
+    const coinRegistry = normalizeSharedObjectIdentity("coinRegistry", options.coinRegistry);
+    return (tx) => tx.moveCall({
+        target: `${SUI_FRAMEWORK_ADDRESS}::coin_registry::finalize_registration`,
+        typeArguments: [coinType],
+        arguments: [
+            tx.sharedObjectRef({ ...coinRegistry, mutable: true }),
+            tx.receivingRef(currency),
+        ],
+    });
+}
+/** An owned object's ID, output version and digest. */
+export function versionReference(object) {
+    if (object.outputVersion === null || object.outputDigest === null) {
+        throw new TypeError(`object ${object.objectId} has no output version`);
+    }
+    return {
+        objectId: normalizeSuiObjectId(object.objectId),
+        version: object.outputVersion,
+        digest: object.outputDigest,
+    };
+}
+/** A shared object's identity, borrowed mutably. */
+export function sharedReference(object) {
+    if (object.outputOwner?.$kind !== "Shared") {
+        throw new TypeError(`object ${object.objectId} is not shared`);
+    }
+    return {
+        objectId: normalizeSuiObjectId(object.objectId),
+        initialSharedVersion: object.outputOwner.Shared.initialSharedVersion,
+        mutable: true,
+    };
+}
+//# sourceMappingURL=effects.js.map

package/dist/effects.js.map

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

package/dist/fee-split.d.ts

@@ -0,0 +1,55 @@
+/**
+ * `blast_core::fee_split::Destination`: where one route's part of each
+ * LP-fee collection goes. The vault decides what each special kind does.
+ */
+export type Destination = {
+    kind: "Address";
+    address: string;
+} | {
+    kind: "Owner";
+} | {
+    kind: "AutoLp";
+} | {
+    kind: "HolderRewards";
+} | {
+    kind: "Burn";
+};
+/** `blast_core::fee_split::Route`: one destination and its positive share. */
+export type Route = {
+    destination: Destination;
+    bps: bigint;
+};
+/** `blast_core::fee_split::FeeSplit`: routes summing to exactly 10,000. */
+export type FeeSplit = {
+    routes: Route[];
+};
+/** BCS of `Destination`, in Move variant order. */
+export declare const destinationBcs: import("@mysten/sui/bcs").BcsType<Destination, Destination, "Destination">;
+export declare const routeBcs: import("@mysten/sui/bcs").BcsStruct<{
+    destination: import("@mysten/sui/bcs").BcsType<Destination, Destination, "Destination">;
+    bps: import("@mysten/sui/bcs").BcsType<bigint, bigint, string>;
+}, string>;
+export declare const feeSplitBcs: import("@mysten/sui/bcs").BcsStruct<{
+    routes: import("@mysten/sui/bcs").BcsType<{
+        destination: Destination;
+        bps: bigint;
+    }[], Iterable<{
+        destination: Destination;
+        bps: bigint;
+    }> & {
+        length: number;
+    }, string>;
+}, string>;
+/**
+ * Checks `split` as far as `fee_split::new` would reject it: at most 20
+ * routes, each positive (and an address route nonzero), no destination
+ * twice, summing to exactly 10,000. Returns the routes with normalized
+ * addresses, in the given order (the order `apportion` pays them).
+ */
+export declare function normalizeFeeSplit(split: FeeSplit): FeeSplit;
+/**
+ * Mirrors `fee_split::apportion`: `total` atoms split across the routes
+ * exactly, in route order, by `bps::apportion` with no rounded-up part.
+ */
+export declare function apportionFeeSplit(split: FeeSplit, total: bigint): bigint[];
+//# sourceMappingURL=fee-split.d.ts.map

package/dist/fee-split.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fee-split.d.ts","sourceRoot":"","sources":["../src/fee-split.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB,8EAA8E;AAC9E,MAAM,MAAM,KAAK,GAAG;IAAE,WAAW,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,2EAA2E;AAC3E,MAAM,MAAM,QAAQ,GAAG;IAAE,MAAM,EAAE,KAAK,EAAE,CAAA;CAAE,CAAC;AAE3C,mDAAmD;AACnD,eAAO,MAAM,cAAc,4EAqBvB,CAAC;AAEL,eAAO,MAAM,QAAQ;;;UAGnB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;UAEtB,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,CA4B3D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAM1E"}

package/dist/fee-split.js

@@ -0,0 +1,69 @@
+import { bcs } from "@mysten/sui/bcs";
+import { normalizeSuiAddress } from "@mysten/sui/utils";
+import { addressBcs } from "./bcs.js";
+import { apportionBps, bpsBcs, MAX_ROUTES, requireBps } from "./bps.js";
+import { BASIS_POINTS_DENOMINATOR } from "./integers.js";
+/** BCS of `Destination`, in Move variant order. */
+export const destinationBcs = bcs
+    .enum("Destination", {
+    Address: addressBcs,
+    Owner: null,
+    AutoLp: null,
+    HolderRewards: null,
+    Burn: null,
+})
+    .transform({
+    input: (destination) => destination.kind === "Address"
+        ? { Address: destination.address }
+        : { [destination.kind]: true },
+    output: (destination) => destination.$kind === "Address"
+        ? { kind: "Address", address: destination.Address }
+        : { kind: destination.$kind },
+});
+export const routeBcs = bcs.struct("Route", {
+    destination: destinationBcs,
+    bps: bpsBcs,
+});
+export const feeSplitBcs = bcs.struct("FeeSplit", {
+    routes: bcs.vector(routeBcs),
+});
+/**
+ * Checks `split` as far as `fee_split::new` would reject it: at most 20
+ * routes, each positive (and an address route nonzero), no destination
+ * twice, summing to exactly 10,000. Returns the routes with normalized
+ * addresses, in the given order (the order `apportion` pays them).
+ */
+export function normalizeFeeSplit(split) {
+    if (split.routes.length > MAX_ROUTES) {
+        throw new RangeError(`a fee split holds at most ${MAX_ROUTES} routes`);
+    }
+    const routes = split.routes.map(({ destination, bps }) => {
+        if (requireBps(bps) === 0n) {
+            throw new RangeError("a fee-split route needs a positive share");
+        }
+        if (destination.kind !== "Address")
+            return { destination, bps };
+        const address = normalizeSuiAddress(destination.address);
+        if (address === normalizeSuiAddress("0x0")) {
+            throw new RangeError("a fee-split route cannot pay the zero address");
+        }
+        return { destination: { kind: "Address", address }, bps };
+    });
+    const keys = routes.map(({ destination }) => destination.kind === "Address" ? destination.address : destination.kind);
+    if (new Set(keys).size !== keys.length) {
+        throw new RangeError("a fee split names each destination at most once");
+    }
+    if (routes.reduce((sum, route) => sum + route.bps, 0n) !==
+        BASIS_POINTS_DENOMINATOR) {
+        throw new RangeError("fee-split routes must sum to 10,000 basis points");
+    }
+    return { routes };
+}
+/**
+ * Mirrors `fee_split::apportion`: `total` atoms split across the routes
+ * exactly, in route order, by `bps::apportion` with no rounded-up part.
+ */
+export function apportionFeeSplit(split, total) {
+    return apportionBps(split.routes.map(({ bps }) => bps), total, null);
+}
+//# sourceMappingURL=fee-split.js.map

package/dist/fee-split.js.map

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

package/dist/index.d.ts

@@ -1,14 +1,23 @@
+export * from "./aborts.ts";
 export * from "./arrays.ts";
 export * from "./bcs.ts";
+export * from "./bps.ts";
 export * from "./bytecode-template.ts";
 export * from "./cetus.ts";
 export * from "./coins.ts";
+export * from "./deployment.ts";
+export * from "./effects.ts";
 export * from "./events.ts";
+export * from "./fee-split.ts";
 export * from "./gas.ts";
 export * from "./integers.ts";
 export * from "./merkle.ts";
+export * from "./migration.ts";
 export * from "./migration-math.ts";
+export * from "./payout.ts";
+export * from "./protocol-fees.ts";
 export * from "./ptb.ts";
+export * from "./roles.ts";
 export * from "./sui.ts";
-export * from "./timelock.ts";
+export * from "./treasury.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -1,14 +1,23 @@
+export * from "./aborts.js";
 export * from "./arrays.js";
 export * from "./bcs.js";
+export * from "./bps.js";
 export * from "./bytecode-template.js";
 export * from "./cetus.js";
 export * from "./coins.js";
+export * from "./deployment.js";
+export * from "./effects.js";
 export * from "./events.js";
+export * from "./fee-split.js";
 export * from "./gas.js";
 export * from "./integers.js";
 export * from "./merkle.js";
+export * from "./migration.js";
 export * from "./migration-math.js";
+export * from "./payout.js";
+export * from "./protocol-fees.js";
 export * from "./ptb.js";
+export * from "./roles.js";
 export * from "./sui.js";
-export * from "./timelock.js";
+export * from "./treasury.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC"}

package/dist/integers.d.ts

@@ -24,6 +24,8 @@ export declare function requirePositiveU64(name: string, value: bigint): U64;
 export declare function requireU128(name: string, value: bigint): U128;
 /** Requires a basis-point value in the inclusive range 0 through 10,000. */
 export declare function requireBasisPoints(name: string, value: bigint): BasisPoints;
+/** Requires a basis-point value no greater than a contract's compiled maximum. */
+export declare function requireBasisPointsAtMost(name: string, value: bigint, maximum: bigint): BasisPoints;
 /** Adds two values and requires the result to remain a Move `u64`. */
 export declare function checkedAddU64(name: string, left: bigint, right: bigint): U64;
 /** Multiplies before dividing, rounding the non-negative result down. */

package/dist/integers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"integers.d.ts","sourceRoot":"","sources":["../src/integers.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,SAAS,EAAE,OAAO,MAAM,CAAC;AACvC,OAAO,CAAC,MAAM,UAAU,EAAE,OAAO,MAAM,CAAC;AACxC,OAAO,CAAC,MAAM,kBAAkB,EAAE,OAAO,MAAM,CAAC;AAEhD,6DAA6D;AAC7D,MAAM,MAAM,GAAG,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,SAAS,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAC1D,8DAA8D;AAC9D,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAC5D,gFAAgF;AAChF,MAAM,MAAM,WAAW,GAAG,GAAG,GAAG;IAAE,QAAQ,CAAC,CAAC,kBAAkB,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAExE,eAAO,MAAM,OAAO,QAAmB,CAAC;AACxC,eAAO,MAAM,QAAQ,QAAoB,CAAC;AAC1C,eAAO,MAAM,wBAAwB,SAAU,CAAC;AAEhD,6CAA6C;AAC7C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,CAK3D;AAED,qDAAqD;AACrD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,CAKnE;AAED,8CAA8C;AAC9C,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAK7D;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAK3E;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,CAE5E;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CACxB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,MAAM,CAGR;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CACtB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,MAAM,CAIR;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GAAG,MAAM,GACrB,MAAM,CAYR"}
+{"version":3,"file":"integers.d.ts","sourceRoot":"","sources":["../src/integers.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,SAAS,EAAE,OAAO,MAAM,CAAC;AACvC,OAAO,CAAC,MAAM,UAAU,EAAE,OAAO,MAAM,CAAC;AACxC,OAAO,CAAC,MAAM,kBAAkB,EAAE,OAAO,MAAM,CAAC;AAEhD,6DAA6D;AAC7D,MAAM,MAAM,GAAG,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,SAAS,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAC1D,8DAA8D;AAC9D,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAC5D,gFAAgF;AAChF,MAAM,MAAM,WAAW,GAAG,GAAG,GAAG;IAAE,QAAQ,CAAC,CAAC,kBAAkB,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAExE,eAAO,MAAM,OAAO,QAAmB,CAAC;AACxC,eAAO,MAAM,QAAQ,QAAoB,CAAC;AAC1C,eAAO,MAAM,wBAAwB,SAAU,CAAC;AAEhD,6CAA6C;AAC7C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,CAK3D;AAED,qDAAqD;AACrD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,CAKnE;AAED,8CAA8C;AAC9C,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAK7D;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAK3E;AAED,kFAAkF;AAClF,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,WAAW,CAQb;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,CAE5E;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CACxB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,MAAM,CAGR;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CACtB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,MAAM,CAIR;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GAAG,MAAM,GACrB,MAAM,CAYR"}

package/dist/integers.js

@@ -29,6 +29,14 @@ export function requireBasisPoints(name, value) {
     }
     return value;
 }
+/** Requires a basis-point value no greater than a contract's compiled maximum. */
+export function requireBasisPointsAtMost(name, value, maximum) {
+    const bps = requireBasisPoints(name, value);
+    if (bps > maximum) {
+        throw new RangeError(`${name} exceeds ${maximum.toLocaleString("en-US")} basis points`);
+    }
+    return bps;
+}
 /** Adds two values and requires the result to remain a Move `u64`. */
 export function checkedAddU64(name, left, right) {
     return requireU64(name, left + right);

package/dist/integers.js.map

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

package/dist/merkle.d.ts

@@ -1,5 +1,10 @@
 export declare function blake2b256(bytes: Uint8Array): Uint8Array;
-/** Mirrors the contracts' Merkle `node`: `blake2b256(0x01 || left || right)`. */
+/**
+ * Mirrors `blast_core::merkle::leaf`: `blake2b256(0x00 || domain || payload)`,
+ * `domain` naming the tree's purpose (UTF-8) and `payload` the leaf's BCS.
+ */
+export declare function merkleLeaf(domain: string, payload: Uint8Array): Uint8Array;
+/** Mirrors `blast_core::merkle::node`: `blake2b256(0x01 || left || right)`. */
 export declare function merkleNode(left: Uint8Array, right: Uint8Array): Uint8Array;
 /**
  * Every layer of the positional tree the contracts verify, leaves first and

package/dist/merkle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merkle.d.ts","sourceRoot":"","sources":["../src/merkle.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAExD;AAED,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,UAAU,CAE1E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,EAAE,EAAE,CAY1E;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,EAAE,GAAG,UAAU,CAItE;AAED,0CAA0C;AAC1C,wBAAgB,WAAW,CACzB,MAAM,EAAE,SAAS,UAAU,EAAE,EAAE,EAC/B,KAAK,EAAE,MAAM,GACZ,UAAU,EAAE,CAOd"}
+{"version":3,"file":"merkle.d.ts","sourceRoot":"","sources":["../src/merkle.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAExD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,UAAU,CAI1E;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,UAAU,CAE1E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,EAAE,EAAE,CAY1E;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,EAAE,GAAG,UAAU,CAItE;AAED,0CAA0C;AAC1C,wBAAgB,WAAW,CACzB,MAAM,EAAE,SAAS,UAAU,EAAE,EAAE,EAC/B,KAAK,EAAE,MAAM,GACZ,UAAU,EAAE,CAOd"}

package/dist/merkle.js

@@ -2,7 +2,14 @@ import { blake2b } from "@noble/hashes/blake2.js";
 export function blake2b256(bytes) {
     return blake2b(bytes, { dkLen: 32 });
 }
-/** Mirrors the contracts' Merkle `node`: `blake2b256(0x01 || left || right)`. */
+/**
+ * Mirrors `blast_core::merkle::leaf`: `blake2b256(0x00 || domain || payload)`,
+ * `domain` naming the tree's purpose (UTF-8) and `payload` the leaf's BCS.
+ */
+export function merkleLeaf(domain, payload) {
+    return blake2b256(new Uint8Array([0, ...new TextEncoder().encode(domain), ...payload]));
+}
+/** Mirrors `blast_core::merkle::node`: `blake2b256(0x01 || left || right)`. */
 export function merkleNode(left, right) {
     return blake2b256(new Uint8Array([1, ...left, ...right]));
 }

package/dist/merkle.js.map

@@ -1 +1 @@
-{"version":3,"file":"merkle.js","sourceRoot":"","sources":["../src/merkle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD,MAAM,UAAU,UAAU,CAAC,KAAiB;IAC1C,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,UAAU,CAAC,IAAgB,EAAE,KAAiB;IAC5D,OAAO,UAAU,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAA6B;IACxD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,4BAA4B,CAAC,CAAC;IAC5E,IAAI,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IACxB,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC;IACvB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,KAAK,CAAC;QACpB,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAChC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAC5D,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAA+B;IACxD,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,UAAU,CAAC,4BAA4B,CAAC,CAAC;IAC9D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,WAAW,CACzB,MAA+B,EAC/B,KAAa;IAEb,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC9C,MAAM,QAAQ,GAAG,KAAK,IAAI,KAAK,CAAC;QAChC,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;QACvD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,UAAU,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;QACvE,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"merkle.js","sourceRoot":"","sources":["../src/merkle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD,MAAM,UAAU,UAAU,CAAC,KAAiB;IAC1C,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,OAAmB;IAC5D,OAAO,UAAU,CACf,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,CACrE,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,UAAU,CAAC,IAAgB,EAAE,KAAiB;IAC5D,OAAO,UAAU,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAA6B;IACxD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,4BAA4B,CAAC,CAAC;IAC5E,IAAI,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IACxB,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC;IACvB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,KAAK,CAAC;QACpB,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAChC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAC5D,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAA+B;IACxD,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,UAAU,CAAC,4BAA4B,CAAC,CAAC;IAC9D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,WAAW,CACzB,MAA+B,EAC/B,KAAa;IAEb,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC9C,MAAM,QAAQ,GAAG,KAAK,IAAI,KAAK,CAAC;QAChC,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;QACvD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,UAAU,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;QACvE,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/migration-math.d.ts

@@ -1,9 +1,20 @@
 /** Atoms of the other asset `auto_lp_fixed_side` keeps beyond its estimate. */
 export declare const AUTO_LP_MARGIN = 2n;
-/** Mirrors `blast_fun_migrators::migration_math::sqrt_price_x64` over atomic Meme/Quote units. */
+/**
+ * Mirrors `blast_core::migration::sqrt_price_x64` over atomic Meme/Quote
+ * units: `floor(sqrt(B / A) * 2^64)`, B / A being Quote / Meme when Meme is
+ * coin A and Meme / Quote otherwise.
+ */
 export declare function sqrtPriceX64(memeAmount: bigint, quoteAmount: bigint, memeIsCoinA: boolean): bigint;
 /**
- * Mirrors `migration_math::auto_lp_fixed_side`, which Bluefin auto-LP uses to
+ * Mirrors `migration::is_seedable_price`: whether Cetus and Bluefin can both
+ * seed a full-range pool at `sqrtPriceX64`, within
+ * `[2 * MIN_SQRT_PRICE_X64, MAX_SQRT_PRICE_X64 / 2]` (the upper bound rounds
+ * down).
+ */
+export declare function isSeedablePrice(sqrtPriceX64: bigint): boolean;
+/**
+ * Mirrors `blast_migrators::bluefin`'s `auto_lp_fixed_side`, which Bluefin auto-LP uses to
  * choose the fixed side from the pool's and the position's Q64.64 sqrt prices.
  * Returns `{ fixA, amount }`; a zero amount means nothing is added now.
  * Divisions round down except the other side's requirement, which rounds up.

package/dist/migration-math.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migration-math.d.ts","sourceRoot":"","sources":["../src/migration-math.ts"],"names":[],"mappings":"AAIA,+EAA+E;AAC/E,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,kGAAkG;AAClG,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,OAAO,GACnB,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAyBnC"}
+{"version":3,"file":"migration-math.d.ts","sourceRoot":"","sources":["../src/migration-math.ts"],"names":[],"mappings":"AAIA,+EAA+E;AAC/E,eAAO,MAAM,cAAc,KAAK,CAAC;AASjC;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,OAAO,GACnB,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAM7D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAyBnC"}

package/dist/migration-math.js

@@ -3,12 +3,33 @@ const Q64 = 1n << 64n;
 const Q128 = 1n << 128n;
 /** Atoms of the other asset `auto_lp_fixed_side` keeps beyond its estimate. */
 export const AUTO_LP_MARGIN = 2n;
-/** Mirrors `blast_fun_migrators::migration_math::sqrt_price_x64` over atomic Meme/Quote units. */
+/**
+ * `tick_math` sqrt-price bounds, Q64.64, shared by Cetus and Bluefin
+ * (`blast_core::constants::{min,max}_sqrt_price_x64`).
+ */
+const MIN_SQRT_PRICE_X64 = 4295048016n;
+const MAX_SQRT_PRICE_X64 = 79226673515401279992447579055n;
+/**
+ * Mirrors `blast_core::migration::sqrt_price_x64` over atomic Meme/Quote
+ * units: `floor(sqrt(B / A) * 2^64)`, B / A being Quote / Meme when Meme is
+ * coin A and Meme / Quote otherwise.
+ */
 export function sqrtPriceX64(memeAmount, quoteAmount, memeIsCoinA) {
     return integerSqrt(ratioQ128(memeAmount, quoteAmount, memeIsCoinA));
 }
 /**
- * Mirrors `migration_math::auto_lp_fixed_side`, which Bluefin auto-LP uses to
+ * Mirrors `migration::is_seedable_price`: whether Cetus and Bluefin can both
+ * seed a full-range pool at `sqrtPriceX64`, within
+ * `[2 * MIN_SQRT_PRICE_X64, MAX_SQRT_PRICE_X64 / 2]` (the upper bound rounds
+ * down).
+ */
+export function isSeedablePrice(sqrtPriceX64) {
+    requireU128("sqrtPriceX64", sqrtPriceX64);
+    return (sqrtPriceX64 >= MIN_SQRT_PRICE_X64 * 2n &&
+        sqrtPriceX64 <= MAX_SQRT_PRICE_X64 / 2n);
+}
+/**
+ * Mirrors `blast_migrators::bluefin`'s `auto_lp_fixed_side`, which Bluefin auto-LP uses to
  * choose the fixed side from the pool's and the position's Q64.64 sqrt prices.
  * Returns `{ fixA, amount }`; a zero amount means nothing is added now.
  * Divisions round down except the other side's requirement, which rounds up.
@@ -40,10 +61,17 @@ export function autoLpFixedSide(sqrtLower, sqrtPrice, sqrtUpper, amountA, amount
     return { fixA: true, amount: 0n };
 }
 function ratioQ128(memeAmount, quoteAmount, memeIsCoinA) {
-    requirePositiveU64("memeAmount", memeAmount);
-    requirePositiveU64("quoteAmount", quoteAmount);
-    const numerator = memeIsCoinA ? quoteAmount : memeAmount;
-    const denominator = memeIsCoinA ? memeAmount : quoteAmount;
+    // Move divides by the coin-A side (it aborts at zero) and allows a zero
+    // numerator, whose price is 0 and not seedable.
+    const [numerator, denominator] = memeIsCoinA
+        ? [
+            requireU64("quoteAmount", quoteAmount),
+            requirePositiveU64("memeAmount", memeAmount),
+        ]
+        : [
+            requireU64("memeAmount", memeAmount),
+            requirePositiveU64("quoteAmount", quoteAmount),
+        ];
     return (numerator << 128n) / denominator;
 }
 function integerSqrt(value) {

package/dist/migration-math.js.map

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

package/dist/migration.d.ts

@@ -0,0 +1,25 @@
+import type { FeeSplit } from "./fee-split.ts";
+/**
+ * `blast_core::migration::ResidualPolicy`: migration residuals the pool does
+ * not take are paid to Blast (`Protocol`) or held for the owner (`Owner`).
+ * `VenueTicket`, `Migration` and `OwnerProof` have no abilities: they exist
+ * only inside one PTB, as transaction results, and have no BCS here.
+ */
+export type ResidualPolicy = "Protocol" | "Owner";
+export declare const residualPolicyBcs: import("@mysten/sui/bcs").BcsType<ResidualPolicy, ResidualPolicy, "ResidualPolicy">;
+/**
+ * `blast_core::migration::VaultTerms`: what a vault snapshots from the sale
+ * that sealed its terms. `origin` is the launch or presale ID and
+ * `packageWitness` the original type of the product's package witness.
+ */
+export type VaultTerms = {
+    origin: string;
+    packageWitness: string;
+    feeSplit: FeeSplit;
+    protocolMemeBps: bigint;
+    protocolQuoteBps: bigint;
+    partnerId: string | null;
+    residuals: ResidualPolicy;
+};
+export declare const vaultTermsBcs: import("@mysten/sui/bcs").BcsType<VaultTerms, VaultTerms, string>;
+//# sourceMappingURL=migration.d.ts.map

package/dist/migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../src/migration.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,OAAO,CAAC;AAElD,eAAO,MAAM,iBAAiB,qFAQ1B,CAAC;AAEL;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,cAAc,CAAC;CAC3B,CAAC;AAEF,eAAO,MAAM,aAAa,mEA6BtB,CAAC"}

package/dist/migration.js

@@ -0,0 +1,43 @@
+import { bcs } from "@mysten/sui/bcs";
+import { moveTypeNameBcs, suiObjectIdBcs } from "./bcs.js";
+import { bpsBcs } from "./bps.js";
+import { feeSplitBcs } from "./fee-split.js";
+export const residualPolicyBcs = bcs
+    .enum("ResidualPolicy", { Protocol: null, Owner: null })
+    .transform({
+    input: (policy) => policy === "Protocol"
+        ? { Protocol: true }
+        : { Owner: true },
+    output: (policy) => policy.$kind,
+});
+export const vaultTermsBcs = bcs
+    .struct("VaultTerms", {
+    origin: suiObjectIdBcs,
+    package_witness: moveTypeNameBcs,
+    fee_split: feeSplitBcs,
+    protocol_meme_bps: bpsBcs,
+    protocol_quote_bps: bpsBcs,
+    partner_id: bcs.option(suiObjectIdBcs),
+    residuals: residualPolicyBcs,
+})
+    .transform({
+    input: (terms) => ({
+        origin: terms.origin,
+        package_witness: terms.packageWitness,
+        fee_split: terms.feeSplit,
+        protocol_meme_bps: terms.protocolMemeBps,
+        protocol_quote_bps: terms.protocolQuoteBps,
+        partner_id: terms.partnerId,
+        residuals: terms.residuals,
+    }),
+    output: (terms) => ({
+        origin: terms.origin,
+        packageWitness: terms.package_witness,
+        feeSplit: terms.fee_split,
+        protocolMemeBps: terms.protocol_meme_bps,
+        protocolQuoteBps: terms.protocol_quote_bps,
+        partnerId: terms.partner_id,
+        residuals: terms.residuals,
+    }),
+});
+//# sourceMappingURL=migration.js.map