@interest-protocol/blast-core 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,9 @@
-# Temporary Holding Version
+# @interest-protocol/blast-core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The core package in the [Blast SDK monorepo](https://github.com/interest-protocol/blast-v2-sdk).
+
+```sh
+npm install @interest-protocol/blast-core
+```
+
+See the repository README and docs for usage, development, and release guidance.

package/dist/arrays.d.ts

@@ -0,0 +1,3 @@
+/** `values.at(index)`, throwing instead of returning `undefined`. */
+export declare function itemAt<T>(values: readonly T[], index: number): T;
+//# sourceMappingURL=arrays.d.ts.map

package/dist/arrays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrays.d.ts","sourceRoot":"","sources":["../src/arrays.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAMhE"}

package/dist/arrays.js

@@ -0,0 +1,9 @@
+/** `values.at(index)`, throwing instead of returning `undefined`. */
+export function itemAt(values, index) {
+    const value = values.at(index);
+    if (value === undefined) {
+        throw new RangeError(`index ${index} is outside ${values.length} items`);
+    }
+    return value;
+}
+//# sourceMappingURL=arrays.js.map

package/dist/arrays.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrays.js","sourceRoot":"","sources":["../src/arrays.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,UAAU,MAAM,CAAI,MAAoB,EAAE,KAAa;IAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,UAAU,CAAC,SAAS,KAAK,eAAe,MAAM,CAAC,MAAM,QAAQ,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/bcs.d.ts

@@ -0,0 +1,16 @@
+export declare const suiIdBcs: import("@mysten/sui/bcs").BcsStruct<{
+    bytes: import("@mysten/sui/bcs").BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+}, string>;
+export declare const suiUidBcs: import("@mysten/sui/bcs").BcsStruct<{
+    id: import("@mysten/sui/bcs").BcsStruct<{
+        bytes: import("@mysten/sui/bcs").BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+    }, string>;
+}, string>;
+export declare const suiBalanceBcs: import("@mysten/sui/bcs").BcsStruct<{
+    value: import("@mysten/sui/bcs").BcsType<string, string | number | bigint, "u64">;
+}, string>;
+export declare const suiObjectIdBcs: import("@mysten/sui/bcs").BcsType<string, string, string>;
+export declare const moveTypeNameBcs: import("@mysten/sui/bcs").BcsType<string, string, string>;
+export declare const u64Bcs: import("@mysten/sui/bcs").BcsType<bigint, bigint, "u64">;
+export declare const addressBcs: import("@mysten/sui/bcs").BcsType<string, string, "bytes[32]">;
+//# sourceMappingURL=bcs.d.ts.map

package/dist/bcs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bcs.d.ts","sourceRoot":"","sources":["../src/bcs.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,QAAQ;;UAA2C,CAAC;AACjE,eAAO,MAAM,SAAS;;;;UAAsC,CAAC;AAC7D,eAAO,MAAM,aAAa;;UAA8C,CAAC;AAEzE,eAAO,MAAM,cAAc,2DAGzB,CAAC;AAMH,eAAO,MAAM,eAAe,2DAUxB,CAAC;AAEL,eAAO,MAAM,MAAM,0DAGjB,CAAC;AAEH,eAAO,MAAM,UAAU,gEAGrB,CAAC"}

package/dist/bcs.js

@@ -0,0 +1,29 @@
+import { bcs } from "@mysten/sui/bcs";
+import { normalizeStructTag, normalizeSuiAddress, normalizeSuiObjectId, } from "@mysten/sui/utils";
+export const suiIdBcs = bcs.struct("ID", { bytes: bcs.Address });
+export const suiUidBcs = bcs.struct("UID", { id: suiIdBcs });
+export const suiBalanceBcs = bcs.struct("Balance", { value: bcs.u64() });
+export const suiObjectIdBcs = suiIdBcs.transform({
+    input: (value) => ({ bytes: normalizeSuiObjectId(value) }),
+    output: (value) => normalizeSuiObjectId(value.bytes),
+});
+const asciiStringBcs = bcs.struct("AsciiString", {
+    bytes: bcs.vector(bcs.u8()),
+});
+export const moveTypeNameBcs = bcs
+    .struct("TypeName", { name: asciiStringBcs })
+    .transform({
+    input: (value) => ({
+        name: { bytes: Array.from(new TextEncoder().encode(value)) },
+    }),
+    output: (value) => normalizeStructTag(new TextDecoder().decode(Uint8Array.from(value.name.bytes))),
+});
+export const u64Bcs = bcs.u64().transform({
+    input: (value) => value,
+    output: (value) => BigInt(value),
+});
+export const addressBcs = bcs.Address.transform({
+    input: (value) => normalizeSuiAddress(value),
+    output: (value) => normalizeSuiAddress(value),
+});
+//# sourceMappingURL=bcs.js.map

package/dist/bcs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bcs.js","sourceRoot":"","sources":["../src/bcs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAEzE,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC,SAAS,CAAC;IAC/C,KAAK,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;IAClE,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,KAAK,CAAC;CACrD,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE;IAC/C,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;CAC5B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG;KAC/B,MAAM,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;KAC5C,SAAS,CAAC;IACT,KAAK,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC;QACzB,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE;KAC7D,CAAC;IACF,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAChB,kBAAkB,CAChB,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAC5D;CACJ,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;IACxC,KAAK,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK;IAC/B,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC;IAC9C,KAAK,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC;IACpD,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC;CAC9C,CAAC,CAAC"}

package/dist/bytecode-template.d.ts

@@ -0,0 +1,67 @@
+export type CompiledConstant = {
+    type_: unknown;
+    data: number[];
+};
+export type CompiledModule = Record<string, unknown> & {
+    address_identifiers: string[];
+    constant_pool: CompiledConstant[];
+    function_handles: {
+        module: number;
+        name: number;
+    }[];
+    identifiers: string[];
+    module_handles: {
+        address: number;
+        name: number;
+    }[];
+    function_defs: {
+        code: {
+            code: unknown[];
+        } | null;
+    }[];
+};
+/** One constant the template patches: its pool type, compiled default, and new value. */
+export type ConstantPatch = {
+    name: string;
+    type: string;
+    expected: Uint8Array;
+    replacement: Uint8Array;
+};
+export type BytecodeTemplateInitOptions = {
+    module_or_path?: unknown;
+};
+/**
+ * Initializes the bytecode-template WASM helper once for every template. A
+ * browser can supply its WASM URL when the bundler cannot discover the package
+ * asset automatically.
+ */
+export declare function initializeBytecodeTemplate(options?: BytecodeTemplateInitOptions): Promise<void>;
+/** Deserializes a template module and checks the tables patching reads. */
+export declare function deserializeTemplate(label: string, bytecode: Uint8Array): CompiledModule;
+/**
+ * Replaces each patch's one constant, found by pool type and compiled default,
+ * then merges any constants the replacements made equal. Every slot is resolved
+ * before any is written, so replacements may swap values between slots of the
+ * same type.
+ */
+export declare function patchConstantSlots(label: string, compiled: CompiledModule, patches: readonly ConstantPatch[]): void;
+/**
+ * Rejects a module or witness name that another identifier of the template
+ * already uses, other than the placeholders it replaces.
+ */
+export declare function assertIdentifierSlots(label: string, compiled: CompiledModule, placeholders: readonly string[], identifiers: {
+    moduleName: string;
+    witnessName: string;
+}): void;
+/**
+ * Derives the module and one-time-witness names from a symbol, the same
+ * transformation as Blast V1: the witness is the uppercased symbol and the
+ * module its lowercase form, spaces becoming underscores.
+ */
+export declare function deriveTemplateIdentifiers(symbol: string, requestedModuleName?: string): {
+    moduleName: string;
+    witnessName: string;
+};
+export declare function requireString(name: string, value: string): string;
+export declare function requireNonEmptyString(name: string, value: string): string;
+//# sourceMappingURL=bytecode-template.d.ts.map

package/dist/bytecode-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytecode-template.d.ts","sourceRoot":"","sources":["../src/bytecode-template.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACrD,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,aAAa,EAAE,gBAAgB,EAAE,CAAC;IAClC,gBAAgB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpD,aAAa,EAAE;QAAE,IAAI,EAAE;YAAE,IAAI,EAAE,OAAO,EAAE,CAAA;SAAE,GAAG,IAAI,CAAA;KAAE,EAAE,CAAC;CACvD,CAAC;AAEF,yFAAyF;AACzF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,UAAU,CAAC;IACrB,WAAW,EAAE,UAAU,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,UAAU,GACnB,cAAc,CAchB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,SAAS,aAAa,EAAE,GAChC,IAAI,CAyBN;AAuDD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,cAAc,EACxB,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,WAAW,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACvD,IAAI,CAgBN;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,mBAAmB,CAAC,EAAE,MAAM,GAC3B;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAiB7C;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIzE"}

package/dist/bytecode-template.js

@@ -0,0 +1,175 @@
+import initBytecodeTemplate, { deserialize, } from "@mysten/move-bytecode-template";
+import { bcs } from "@mysten/sui/bcs";
+let initialization;
+/**
+ * Initializes the bytecode-template WASM helper once for every template. A
+ * browser can supply its WASM URL when the bundler cannot discover the package
+ * asset automatically.
+ */
+export function initializeBytecodeTemplate(options) {
+    if (initialization)
+        return initialization;
+    const pending = Promise.resolve(initBytecodeTemplate(options)).then(() => undefined);
+    initialization = pending.catch((error) => {
+        initialization = undefined;
+        throw error;
+    });
+    return initialization;
+}
+/** Deserializes a template module and checks the tables patching reads. */
+export function deserializeTemplate(label, bytecode) {
+    const value = deserialize(bytecode);
+    if (!isRecord(value))
+        throw new TypeError(`${label} is not a module`);
+    if (!isStringArray(value.address_identifiers) ||
+        !Array.isArray(value.constant_pool) ||
+        !Array.isArray(value.function_handles) ||
+        !isStringArray(value.identifiers) ||
+        !Array.isArray(value.module_handles) ||
+        !Array.isArray(value.function_defs)) {
+        throw new TypeError(`${label} has invalid module tables`);
+    }
+    return value;
+}
+/**
+ * Replaces each patch's one constant, found by pool type and compiled default,
+ * then merges any constants the replacements made equal. Every slot is resolved
+ * before any is written, so replacements may swap values between slots of the
+ * same type.
+ */
+export function patchConstantSlots(label, compiled, patches) {
+    const targets = patches.map((patch) => {
+        const matches = compiled.constant_pool.flatMap((constant, index) => constantTypeName(constant.type_) === patch.type &&
+            bytesEqual(constant.data, patch.expected)
+            ? [index]
+            : []);
+        if (matches.length !== 1) {
+            throw new TypeError(`${label} must have one ${patch.name} constant slot`);
+        }
+        return matches[0];
+    });
+    if (new Set(targets).size !== targets.length) {
+        throw new TypeError(`${label} constant slots must be distinct`);
+    }
+    patches.forEach((patch, patchIndex) => {
+        const target = targets[patchIndex];
+        if (target === undefined)
+            throw new TypeError("Missing constant slot");
+        const constant = compiled.constant_pool[target];
+        if (!constant)
+            throw new TypeError("Missing constant");
+        constant.data = Array.from(patch.replacement);
+    });
+    mergeDuplicateConstants(compiled);
+}
+/**
+ * The bytecode verifier rejects a module whose constant pool holds the same
+ * type and value twice (`DUPLICATE_ELEMENT`), which patching produces whenever
+ * two slots of one type receive equal values: one recipient for every
+ * capability, a name equal to the symbol, or two false flags. Each duplicate's
+ * loads move to the last copy, which keeps a module's error constants, declared
+ * after its settings, at their indices for clever-error decoding. The freed
+ * slot becomes a unique `vector<u8>` that nothing loads, so no other index
+ * shifts.
+ */
+function mergeDuplicateConstants(compiled) {
+    const pool = compiled.constant_pool;
+    const lastIndex = new Map(pool.map((constant, index) => [constantKey(constant), index]));
+    const redirects = new Map();
+    pool.forEach((constant, index) => {
+        const kept = lastIndex.get(constantKey(constant));
+        if (kept !== undefined && kept !== index)
+            redirects.set(index, kept);
+    });
+    if (redirects.size === 0)
+        return;
+    for (const definition of compiled.function_defs) {
+        for (const instruction of definition.code?.code ?? []) {
+            if (isRecord(instruction) && typeof instruction.LdConst === "number") {
+                instruction.LdConst =
+                    redirects.get(instruction.LdConst) ?? instruction.LdConst;
+            }
+        }
+    }
+    for (const index of redirects.keys()) {
+        let attempt = 0;
+        let unused;
+        do {
+            unused = {
+                type_: { Vector: "U8" },
+                data: Array.from(bcs
+                    .string()
+                    .serialize(`\u0000unused-constant-${index}-${attempt++}`)
+                    .toBytes()),
+            };
+        } while (lastIndex.has(constantKey(unused)));
+        pool[index] = unused;
+        lastIndex.set(constantKey(unused), index);
+    }
+}
+function constantKey(constant) {
+    return `${constantTypeName(constant.type_)}:${constant.data.join(",")}`;
+}
+/**
+ * Rejects a module or witness name that another identifier of the template
+ * already uses, other than the placeholders it replaces.
+ */
+export function assertIdentifierSlots(label, compiled, placeholders, identifiers) {
+    const occupied = new Set(compiled.identifiers.filter((identifier) => !placeholders.includes(identifier)));
+    if (occupied.has(identifiers.moduleName)) {
+        throw new RangeError(`moduleName ${identifiers.moduleName} collides with the ${label}`);
+    }
+    if (occupied.has(identifiers.witnessName)) {
+        throw new RangeError(`witnessName ${identifiers.witnessName} collides with the ${label}`);
+    }
+}
+/**
+ * Derives the module and one-time-witness names from a symbol, the same
+ * transformation as Blast V1: the witness is the uppercased symbol and the
+ * module its lowercase form, spaces becoming underscores.
+ */
+export function deriveTemplateIdentifiers(symbol, requestedModuleName) {
+    const normalizedSymbol = requireNonEmptyString("symbol", symbol);
+    const witnessName = normalizedSymbol.toUpperCase().replaceAll(" ", "_");
+    const moduleName = requestedModuleName ?? normalizedSymbol.toLowerCase().replaceAll(" ", "_");
+    if (!/^[A-Z][A-Z0-9_]*$/.test(witnessName)) {
+        throw new RangeError("symbol must produce an uppercase Move witness identifier");
+    }
+    if (!/^[a-z][a-z0-9_]*$/.test(moduleName)) {
+        throw new RangeError("moduleName must start with a lowercase letter and contain only lowercase letters, digits, or underscores");
+    }
+    return { moduleName, witnessName };
+}
+export function requireString(name, value) {
+    if (typeof value !== "string") {
+        throw new TypeError(`${name} must be a string`);
+    }
+    return value;
+}
+export function requireNonEmptyString(name, value) {
+    const normalized = requireString(name, value).trim();
+    if (!normalized)
+        throw new RangeError(`${name} must not be empty`);
+    return normalized;
+}
+function constantTypeName(value) {
+    if (typeof value === "string")
+        return value;
+    if (!isRecord(value))
+        return "";
+    const entries = Object.entries(value);
+    if (entries.length !== 1 || !entries[0])
+        return "";
+    return `${entries[0][0]}(${constantTypeName(entries[0][1])})`;
+}
+function bytesEqual(left, right) {
+    return (left.length === right.length &&
+        left.every((value, index) => value === right[index]));
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function isStringArray(value) {
+    return (Array.isArray(value) && value.every((item) => typeof item === "string"));
+}
+//# sourceMappingURL=bytecode-template.js.map

package/dist/bytecode-template.js.map

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

package/dist/cetus.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Cetus orders a pool's coin types by type name. `a` means Meme is coin A
+ * (`Pool<Meme, Quote>`); `b` means Quote is coin A (`Pool<Quote, Meme>`).
+ * Every Cetus route after `new` takes `<Meme, Quote, CoinA, CoinB>`
+ * (contracts ADR 0100); the SDK derives `CoinA` and `CoinB` from this side.
+ */
+export type CetusMemeSide = "a" | "b";
+/**
+ * Cetus orders a pool's coins by `type_name::with_defining_ids` text (64 hex
+ * digits, no `0x`); Meme is coin A exactly when its name sorts after Quote's.
+ * Pass original (defining) type addresses.
+ */
+export declare function cetusMemeSide(memeType: string, quoteType: string): CetusMemeSide;
+//# sourceMappingURL=cetus.d.ts.map

package/dist/cetus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cetus.d.ts","sourceRoot":"","sources":["../src/cetus.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,GAAG,GAAG,GAAG,CAAC;AAEtC;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,aAAa,CAEf"}

package/dist/cetus.js

@@ -0,0 +1,13 @@
+import { normalizeStructTag, parseStructTag } from "@mysten/sui/utils";
+/**
+ * Cetus orders a pool's coins by `type_name::with_defining_ids` text (64 hex
+ * digits, no `0x`); Meme is coin A exactly when its name sorts after Quote's.
+ * Pass original (defining) type addresses.
+ */
+export function cetusMemeSide(memeType, quoteType) {
+    return cetusTypeName(memeType) > cetusTypeName(quoteType) ? "a" : "b";
+}
+function cetusTypeName(type) {
+    return normalizeStructTag(parseStructTag(type)).replace(/0x([0-9a-f]{64})/g, "$1");
+}
+//# sourceMappingURL=cetus.js.map

package/dist/cetus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cetus.js","sourceRoot":"","sources":["../src/cetus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAUvE;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAgB,EAChB,SAAiB;IAEjB,OAAO,aAAa,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AACxE,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,kBAAkB,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CACrD,mBAAmB,EACnB,IAAI,CACL,CAAC;AACJ,CAAC"}

package/dist/coins.d.ts

@@ -0,0 +1,20 @@
+/**
+ * How a transaction builder sources the SUI the transaction itself spends: a
+ * fee, a deposit, or a SUI-quoted purchase. Other coin types always come from
+ * the sender's coins and address balance.
+ *
+ * `useGasCoin` is passed to `@mysten/sui`'s `tx.coin`, whose default (`true`)
+ * withdraws from the sender's address balance when it covers the amount and
+ * otherwise splits the gas coin. Pass `false` when someone else pays gas: a
+ * sponsored transaction's gas coin belongs to the sponsor, who may reject a
+ * transaction that uses it as an argument or end up paying the sender's SUI.
+ * With `false`, the SUI comes from the sender's coins and address balance, so
+ * a self-paying sender needs SUI beyond what gas selection takes.
+ *
+ * Builders take it at construction and per call; the per-call value wins,
+ * and both default to `true`, `@mysten/sui`'s own default.
+ */
+export type CoinSourceOptions = Readonly<{
+    useGasCoin?: boolean;
+}>;
+//# sourceMappingURL=coins.d.ts.map

package/dist/coins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coins.d.ts","sourceRoot":"","sources":["../src/coins.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC,CAAC"}

package/dist/coins.js

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

package/dist/coins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coins.js","sourceRoot":"","sources":["../src/coins.ts"],"names":[],"mappings":""}

package/dist/events.d.ts

@@ -0,0 +1,14 @@
+export type SuiEventPosition = {
+    checkpoint: bigint;
+    transactionDigest: string;
+    eventIndex: number;
+};
+export type NativeTransactionPosition = Pick<SuiEventPosition, "checkpoint" | "transactionDigest">;
+export declare function normalizeSuiEventPosition(input: {
+    checkpoint: bigint | number | string | null;
+    transactionDigest: string;
+    eventIndex: number;
+}): SuiEventPosition;
+export declare function normalizeNativeTransactionPosition(input: NativeTransactionPosition, label?: string): NativeTransactionPosition;
+export declare function suiEventId(position: SuiEventPosition): string;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,gBAAgB,EAChB,YAAY,GAAG,mBAAmB,CACnC,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC5C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,gBAAgB,CA4BnB;AAED,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,yBAAyB,EAChC,KAAK,GAAE,MAA6B,GACnC,yBAAyB,CAS3B;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAE7D"}

package/dist/events.js

@@ -0,0 +1,43 @@
+import { requireU64 } from "./integers.js";
+export function normalizeSuiEventPosition(input) {
+    if (input.checkpoint === null) {
+        throw new TypeError("event requires checkpoint metadata");
+    }
+    if (typeof input.checkpoint === "number" &&
+        !Number.isSafeInteger(input.checkpoint)) {
+        throw new TypeError("event checkpoint must be a u64");
+    }
+    let checkpoint;
+    try {
+        checkpoint = BigInt(input.checkpoint);
+    }
+    catch {
+        throw new TypeError("event checkpoint must be a u64");
+    }
+    requireU64("event checkpoint", checkpoint);
+    if (!input.transactionDigest) {
+        throw new TypeError("event transaction digest is required");
+    }
+    if (!Number.isSafeInteger(input.eventIndex) || input.eventIndex < 0) {
+        throw new RangeError("event index must be a non-negative integer");
+    }
+    return {
+        checkpoint,
+        transactionDigest: input.transactionDigest,
+        eventIndex: input.eventIndex,
+    };
+}
+export function normalizeNativeTransactionPosition(input, label = "native transaction") {
+    requireU64(`${label} checkpoint`, input.checkpoint);
+    if (!input.transactionDigest) {
+        throw new TypeError(`${label} transaction digest is required`);
+    }
+    return {
+        checkpoint: input.checkpoint,
+        transactionDigest: input.transactionDigest,
+    };
+}
+export function suiEventId(position) {
+    return `${position.transactionDigest}:${position.eventIndex}`;
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAa3C,MAAM,UAAU,yBAAyB,CAAC,KAIzC;IACC,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAC;IAC5D,CAAC;IACD,IACE,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;QACpC,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,EACvC,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,gCAAgC,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACH,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,SAAS,CAAC,gCAAgC,CAAC,CAAC;IACxD,CAAC;IACD,UAAU,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC7B,MAAM,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,UAAU,CAAC,4CAA4C,CAAC,CAAC;IACrE,CAAC;IACD,OAAO;QACL,UAAU;QACV,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,KAAgC,EAChC,KAAK,GAAW,oBAAoB;IAEpC,UAAU,CAAC,GAAG,KAAK,aAAa,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC7B,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,iCAAiC,CAAC,CAAC;IACjE,CAAC;IACD,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;KAC3C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAA0B;IACnD,OAAO,GAAG,QAAQ,CAAC,iBAAiB,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;AAChE,CAAC"}

package/dist/gas.d.ts

@@ -0,0 +1,26 @@
+import type { TransactionPlugin } from "@mysten/sui/transactions";
+/**
+ * A build plugin that budgets a transaction at its gross cost plus headroom
+ * when the caller has not set a budget.
+ *
+ * `@mysten/sui` and the fullnode budget the simulated net cost (computation
+ * plus storage less rebate) plus 1,000 gas units, about 13 bytes of storage.
+ * Execution fails with `InsufficientGas` once `budget - computation < storage
+ * - rebate`, so a transaction whose execution writes more storage than its
+ * simulation runs out of gas. Cetus seeds a new pool's tick skip list from the
+ * clock, so creating a pool writes up to 18 more bytes in about one execution
+ * in four: a presale's Cetus migration ran out of gas that way on 2026-10-05.
+ * The SDK attaches this plugin to its Cetus migration and pool-creation calls;
+ * other transactions keep the default budget.
+ *
+ * The plugin probes once more and budgets the simulated computation plus all
+ * storage, ignoring the rebate, plus a fifth and 10,000 gas units. The charge
+ * is unchanged, since the rebate is still credited; only the ceiling rises. A
+ * payer that cannot cover that ceiling, given how `@mysten/sui` then picks its
+ * gas payment, keeps the default net budget. A transaction-kind build, a
+ * budget already set, no client, or a failing probe also leave the default
+ * resolver in charge, with its own errors. A plugin does not survive JSON
+ * serialization: add it again after `Transaction.from(json)`.
+ */
+export declare function grossGasBudget(): TransactionPlugin;
+//# sourceMappingURL=gas.d.ts.map

package/dist/gas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gas.d.ts","sourceRoot":"","sources":["../src/gas.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAoBlE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,IAAI,iBAAiB,CA6BlD"}