@kaspacom/kcc20-tx-builder 0.1.0

package/dist/cjs/ladder-limit-orders.d.ts

@@ -0,0 +1,41 @@
+export declare const KCC20_LADDER_MAX_ORDERS = 20;
+export type Kcc20LadderDirection = "increment" | "decrement";
+export interface Kcc20LadderLimitPlan {
+    unitPriceSompi: string[];
+    notionalsSompi: bigint[];
+    minNotionalSompi: bigint;
+    totalNotionalSompi: bigint;
+    totalProtocolFeeSompi: bigint;
+    totalBuySettlementSompi: bigint;
+}
+/**
+ * Builds compounded unit prices for a same-amount resting limit-order ladder.
+ */
+export declare function kcc20LadderUnitPricesSompi(input: {
+    baseUnitPriceSompi: bigint;
+    count: number;
+    direction: Kcc20LadderDirection;
+    percent: number;
+}): bigint[];
+export declare function parseKcc20LadderPercent(value: string): number | undefined;
+export declare function planKcc20LadderLimitOrders(input: {
+    tokenAmount: string;
+    baseUnitPriceSompi: string;
+    decimals: number;
+    count: number;
+    direction: Kcc20LadderDirection;
+    percent: number;
+    protocolFeeBps: number;
+}): Kcc20LadderLimitPlan | undefined;
+export declare function kcc20LadderMeetsMinOrderValue(plan: Kcc20LadderLimitPlan, minSompi?: bigint): boolean;
+export declare function maxAffordableKcc20LadderCount(input: {
+    side: "buy" | "sell";
+    tokenAmount: string;
+    baseUnitPriceSompi: string;
+    decimals: number;
+    direction: Kcc20LadderDirection;
+    percent: number;
+    protocolFeeBps: number;
+    availableTokenBaseUnits?: bigint;
+    availableKasSompi?: bigint;
+}): number;

package/dist/cjs/ladder-limit-orders.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KCC20_LADDER_MAX_ORDERS = void 0;
+exports.kcc20LadderUnitPricesSompi = kcc20LadderUnitPricesSompi;
+exports.parseKcc20LadderPercent = parseKcc20LadderPercent;
+exports.planKcc20LadderLimitOrders = planKcc20LadderLimitOrders;
+exports.kcc20LadderMeetsMinOrderValue = kcc20LadderMeetsMinOrderValue;
+exports.maxAffordableKcc20LadderCount = maxAffordableKcc20LadderCount;
+const token_amount_js_1 = require("./token-amount.js");
+const trade_fee_js_1 = require("./trade-fee.js");
+exports.KCC20_LADDER_MAX_ORDERS = 20;
+/**
+ * Builds compounded unit prices for a same-amount resting limit-order ladder.
+ */
+function kcc20LadderUnitPricesSompi(input) {
+    const count = Math.min(exports.KCC20_LADDER_MAX_ORDERS, Math.max(1, Math.floor(input.count)));
+    if (input.baseUnitPriceSompi <= 0n)
+        return [];
+    const percent = Number.isFinite(input.percent)
+        ? Math.max(0, input.percent)
+        : 0;
+    const stepPpm = BigInt(Math.round(percent * 10_000));
+    const million = 1000000n;
+    const sign = input.direction === "increment" ? 1n : -1n;
+    const prices = [];
+    let current = input.baseUnitPriceSompi;
+    for (let index = 0; index < count; index += 1) {
+        if (current <= 0n)
+            break;
+        prices.push(current);
+        if (index === count - 1 || stepPpm === 0n)
+            continue;
+        const factor = million + sign * stepPpm;
+        if (factor <= 0n)
+            break;
+        const next = (current * factor + million / 2n) / million;
+        current =
+            next === current
+                ? input.direction === "increment"
+                    ? current + 1n
+                    : current - 1n
+                : next;
+    }
+    return prices;
+}
+function parseKcc20LadderPercent(value) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        return undefined;
+    const parsed = Number(trimmed);
+    return Number.isFinite(parsed) && parsed >= 0 && parsed <= 100
+        ? parsed
+        : undefined;
+}
+function planKcc20LadderLimitOrders(input) {
+    let base;
+    try {
+        base = BigInt(input.baseUnitPriceSompi.trim());
+    }
+    catch {
+        return undefined;
+    }
+    if (base <= 0n)
+        return undefined;
+    const prices = kcc20LadderUnitPricesSompi({
+        baseUnitPriceSompi: base,
+        count: input.count,
+        direction: input.direction,
+        percent: input.percent,
+    });
+    const requested = Math.min(exports.KCC20_LADDER_MAX_ORDERS, Math.max(1, Math.floor(input.count)));
+    if (prices.length !== requested)
+        return undefined;
+    const notionalsSompi = [];
+    let totalBuySettlementSompi = 0n;
+    for (const price of prices) {
+        const total = (0, token_amount_js_1.calculateKcc20OrderTotalSompi)(input.tokenAmount, price.toString(), input.decimals);
+        if (!total)
+            return undefined;
+        const notional = BigInt(total.totalSompi);
+        notionalsSompi.push(notional);
+        totalBuySettlementSompi +=
+            notional + (0, trade_fee_js_1.calculateKcc20ProtocolFeeSompi)(notional, input.protocolFeeBps);
+    }
+    const totalNotionalSompi = notionalsSompi.reduce((sum, value) => sum + value, 0n);
+    const minNotionalSompi = notionalsSompi.reduce((min, value) => (value < min ? value : min), notionalsSompi[0]);
+    return {
+        unitPriceSompi: prices.map((price) => price.toString()),
+        notionalsSompi,
+        minNotionalSompi,
+        totalNotionalSompi,
+        totalProtocolFeeSompi: totalBuySettlementSompi - totalNotionalSompi,
+        totalBuySettlementSompi,
+    };
+}
+function kcc20LadderMeetsMinOrderValue(plan, minSompi = trade_fee_js_1.KCC20_MIN_PROTOCOL_FEE_SOMPI) {
+    return plan.minNotionalSompi >= minSompi;
+}
+function maxAffordableKcc20LadderCount(input) {
+    if (input.side === "sell") {
+        if (input.availableTokenBaseUnits === undefined)
+            return exports.KCC20_LADDER_MAX_ORDERS;
+        let amount;
+        try {
+            amount = BigInt((0, token_amount_js_1.parseKcc20DisplayAmountToBaseUnits)(input.tokenAmount, input.decimals, "token amount"));
+        }
+        catch {
+            return exports.KCC20_LADDER_MAX_ORDERS;
+        }
+        if (amount <= 0n)
+            return exports.KCC20_LADDER_MAX_ORDERS;
+        const affordable = input.availableTokenBaseUnits / amount;
+        if (affordable < 1n)
+            return 1;
+        const asNumber = Number(affordable);
+        return Number.isSafeInteger(asNumber)
+            ? Math.min(exports.KCC20_LADDER_MAX_ORDERS, asNumber)
+            : exports.KCC20_LADDER_MAX_ORDERS;
+    }
+    if (input.availableKasSompi === undefined)
+        return exports.KCC20_LADDER_MAX_ORDERS;
+    for (let count = exports.KCC20_LADDER_MAX_ORDERS; count >= 1; count -= 1) {
+        const plan = planKcc20LadderLimitOrders({ ...input, count });
+        if (plan && plan.totalBuySettlementSompi <= input.availableKasSompi)
+            return count;
+    }
+    return 1;
+}
+//# sourceMappingURL=ladder-limit-orders.js.map

package/dist/cjs/ladder-limit-orders.js.map

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

package/dist/cjs/mint-availability-operation.d.ts

@@ -0,0 +1,56 @@
+import type { Kcc20IndexedCovenantUtxo } from "./action-source-resolver.js";
+export interface Kcc20MintAvailabilityWalletInfo {
+    walletAddress: string;
+    kcc20Owner: string;
+}
+export interface Kcc20BuildMintAvailabilityOperationInput {
+    covenantId: string;
+    active: boolean;
+    activeMinterUtxo: Record<string, unknown>;
+    activeMinterUtxos: Record<string, unknown>[];
+}
+export interface Kcc20MintAvailabilityOperationOptions {
+    network?: string;
+    createdAt?: string;
+    requestId?: string;
+}
+export declare function resolveKcc20MintAvailabilitySources(input: {
+    publicMintControlSupported: boolean;
+    activeUtxos: readonly Kcc20IndexedCovenantUtxo[];
+    owner: string;
+    active: boolean;
+}): {
+    activeMinterUtxo: Kcc20IndexedCovenantUtxo;
+    activeMinterUtxos: Kcc20IndexedCovenantUtxo[];
+};
+export declare function buildKcc20MintAvailabilityOperation(walletInfo: Kcc20MintAvailabilityWalletInfo, input: Kcc20BuildMintAvailabilityOperationInput, options?: Kcc20MintAvailabilityOperationOptions): {
+    requestId: string;
+    description: string;
+    payload: {
+        params: Record<string, unknown>;
+        signing: {
+            standard: string;
+            walletAction: string;
+            status: string;
+            builderKey: string;
+            builderStatus: string;
+            submitTransactionSupported: boolean;
+            missingDependencies: string[];
+            missingSources: never[];
+        };
+        sourceRequirements: Record<string, unknown>[];
+        signerRequirements: Record<string, unknown>[];
+        warnings: string[];
+        tokenIdentity?: Record<string, unknown> | undefined;
+        schema: string;
+        status: string;
+        requestId: string;
+        chain: string;
+        network: string;
+        createdAt: string;
+        owner: import("./wallet-operation.js").Kcc20WalletOperationOwner;
+        operation: string;
+        contract: string;
+        action: string;
+    };
+};

package/dist/cjs/mint-availability-operation.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveKcc20MintAvailabilitySources = resolveKcc20MintAvailabilitySources;
+exports.buildKcc20MintAvailabilityOperation = buildKcc20MintAvailabilityOperation;
+const wallet_operation_js_1 = require("./wallet-operation.js");
+const HEX_64_RE = /^[a-f0-9]{64}$/;
+function resolveKcc20MintAvailabilitySources(input) {
+    if (!input.publicMintControlSupported) {
+        throw new Error("This KCC20 token does not support public mint availability updates");
+    }
+    const activeMinterUtxos = input.activeUtxos.filter((utxo) => utxo.state?.["isMintAuthority"] === true &&
+        Number(utxo.state?.["mintPolicy"]) === 2);
+    const activeMinterUtxo = activeMinterUtxos[0];
+    if (!activeMinterUtxo?.state)
+        throw new Error("Active public minter UTXO not found");
+    const state = activeMinterUtxo.state;
+    const owner = String(state["owner"] ?? state["ownerIdentifier"] ?? "").toLowerCase();
+    const ownerScheme = Number(state["ownerScheme"] ?? state["identifierType"]);
+    if (ownerScheme !== 0 || owner !== input.owner.toLowerCase()) {
+        throw new Error("Public mint availability updates require the active minter owner");
+    }
+    const currentActive = state["publicMintActive"] === true;
+    if (currentActive === input.active) {
+        throw new Error(input.active
+            ? "Public mint is already active"
+            : "Public mint is already paused");
+    }
+    return { activeMinterUtxo, activeMinterUtxos };
+}
+function buildKcc20MintAvailabilityOperation(walletInfo, input, options = {}) {
+    const covenantId = requireHex64(input.covenantId, "covenantId");
+    if (typeof input.active !== "boolean") {
+        throw new Error("active must be a boolean");
+    }
+    if (!input.activeMinterUtxo || typeof input.activeMinterUtxo !== "object") {
+        throw new Error("activeMinterUtxo is required");
+    }
+    if (!Array.isArray(input.activeMinterUtxos) ||
+        !input.activeMinterUtxos.length) {
+        throw new Error("activeMinterUtxos must contain at least one source");
+    }
+    const outpoints = input.activeMinterUtxos.map((utxo) => utxoOutpoint(utxo));
+    const selectedOutpoint = utxoOutpoint(input.activeMinterUtxo);
+    return (0, wallet_operation_js_1.buildKcc20WalletOperationFromPlan)(walletInfo, {
+        builderKey: "kcc20.set-public-mint-active",
+        operation: "set-mint-availability",
+        contract: "KCC20",
+        action: "setPublicMintActive",
+        description: "Build a public mint availability update request.",
+        params: {
+            covenantId,
+            active: input.active,
+            activeMinterUtxo: input.activeMinterUtxo,
+            activeMinterUtxos: input.activeMinterUtxos,
+        },
+        sourceRequirements: [
+            {
+                type: "kcc20-mint-authority-utxo",
+                covenantId,
+                outpoint: selectedOutpoint,
+                outpoints,
+                purpose: "preserve remaining supply while updating public mint availability",
+            },
+            {
+                type: "kaspa-funding-utxo",
+                ownerAddress: walletInfo.walletAddress,
+                purpose: "fund network fee",
+            },
+        ],
+        warnings: [],
+        tokenIdentity: {
+            canonicalCovenantId: covenantId,
+            deployCandidateId: covenantId,
+        },
+    }, options);
+}
+function utxoOutpoint(utxo) {
+    const txidHex = requireHex64(utxo["txidHex"], "minter txid");
+    const vout = Number(utxo["vout"]);
+    if (!Number.isInteger(vout) || vout < 0) {
+        throw new Error("minter vout must be a non-negative integer");
+    }
+    return `${txidHex}:${vout}`;
+}
+function requireHex64(value, field) {
+    if (typeof value !== "string") {
+        throw new Error(`${field} must be 64 hex characters`);
+    }
+    const normalized = value.trim().toLowerCase().replace(/^0x/, "");
+    if (!HEX_64_RE.test(normalized)) {
+        throw new Error(`${field} must be 64 hex characters`);
+    }
+    return normalized;
+}
+//# sourceMappingURL=mint-availability-operation.js.map

package/dist/cjs/mint-availability-operation.js.map

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

package/dist/cjs/models.d.ts

@@ -0,0 +1,90 @@
+import type { KaspaWasmRuntime } from "./runtime.js";
+export declare const KCC20_BUILDER_INPUT_SCHEMA: "kcc20-shared-pskt-builder-input/v1";
+export declare const KCC20_BUILDER_OUTPUT_SCHEMA: "kcc20-shared-pskt-builder-output/v1";
+export type Hex64 = string;
+export interface TransactionOutpoint {
+    txidHex: Hex64;
+    vout: number;
+}
+export interface CovenantUtxo extends TransactionOutpoint {
+    address: string;
+    amountSompi: string;
+    /** Decoded state required by the selected operation. */
+    state: Record<string, unknown>;
+    /** Optional script/artifact data supplied by the source resolver. */
+    scriptHex?: string;
+    artifactKey?: string;
+}
+export interface FundingUtxo extends TransactionOutpoint {
+    address: string;
+    amountSompi: string;
+    scriptPublicKeyHex?: string;
+}
+export interface BuildSources {
+    covenantUtxos?: CovenantUtxo[];
+    walletUtxos: FundingUtxo[];
+    optionalFeeTicketUtxos?: CovenantUtxo[];
+}
+export interface ArtifactDescriptor {
+    key: string;
+    version: string;
+    hash: Hex64;
+    abi?: unknown;
+    script?: unknown;
+}
+export interface BuildContext {
+    network: string;
+    walletAddress: string;
+    ownerIdentifier: string;
+    protocolVersion: string;
+    artifacts: Record<string, ArtifactDescriptor>;
+    /** Values normally controlled by backend configuration. */
+    protocolFeeBps?: string;
+    priorityFeeSompi?: string;
+}
+export interface Kcc20PsktBuildRequest {
+    schema: typeof KCC20_BUILDER_INPUT_SCHEMA;
+    builderKey: string;
+    operation: string;
+    action: string;
+    params: Record<string, unknown>;
+    context: BuildContext;
+    sources: BuildSources;
+}
+export interface SignInput {
+    index: number;
+    sighashType?: number;
+}
+export interface CovenantSigningScript {
+    inputIndex: number;
+    scriptHex: string;
+    signType?: string;
+    signatureScriptHex?: string;
+}
+export interface Kcc20PsktBuildResult {
+    schema: typeof KCC20_BUILDER_OUTPUT_SCHEMA;
+    psktTransactionJson: string;
+    signInputs: SignInput[];
+    scripts?: CovenantSigningScript[];
+    sourceOutpoints: string[];
+    artifactHashes: Record<string, Hex64>;
+    operationDigest: Hex64;
+    metadata?: Record<string, unknown>;
+}
+export interface Kcc20PsktBuilderDependencies {
+    wasm: KaspaWasmRuntime;
+    artifacts?: Record<string, unknown>;
+    artifactProvider?: (key: string) => Promise<unknown>;
+    config?: Record<string, unknown>;
+    /**
+     * Host-owned source transport. When supplied, the builder does not create,
+     * connect, or disconnect an RPC client; the host may therefore back this
+     * provider with one long-lived browser or server connection.
+     */
+    sourceProvider?: {
+        getUtxosByAddresses(args: {
+            addresses: string[];
+        }): Promise<unknown>;
+    };
+    rpcClientFactory?: (config: unknown) => any;
+}

package/dist/cjs/models.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KCC20_BUILDER_OUTPUT_SCHEMA = exports.KCC20_BUILDER_INPUT_SCHEMA = void 0;
+exports.KCC20_BUILDER_INPUT_SCHEMA = "kcc20-shared-pskt-builder-input/v1";
+exports.KCC20_BUILDER_OUTPUT_SCHEMA = "kcc20-shared-pskt-builder-output/v1";
+//# sourceMappingURL=models.js.map

package/dist/cjs/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/models.ts"],"names":[],"mappings":";;;AAEa,QAAA,0BAA0B,GACrC,oCAA6C,CAAC;AACnC,QAAA,2BAA2B,GACtC,qCAA8C,CAAC"}

package/dist/cjs/operations.d.ts

@@ -0,0 +1,6 @@
+export declare const KCC20_BUILDER_KEYS: readonly ["kcc20.deploy-token", "kcc20.mint", "kcc20.set-public-mint-active", "kcc20.transfer", "kcc20.consolidate-holders", "kcc20.reveal-token", "kcc20wrapper.deploy-market", "kcc20wrapper.wrap", "kcc20wrapper.unwrap", "kcc20orderbook.create-bid", "kcc20orderbook.create-ask", "kcc20orderbook.fill-ask", "kcc20orderbook.fill-bid", "kcc20orderbook.sweep-asks", "kcc20orderbook.sweep-bids", "kcc20orderbook.consolidate-holders", "kcc20orderbook.cancel-ask", "kcc20orderbook.cancel-bid", "fee-ticket.deploy-root", "fee-ticket.update-denomination", "fee-ticket.create-from-utility-burn", "fee-ticket.burn", "fee-ticket.transfer"];
+export type Kcc20BuilderKey = (typeof KCC20_BUILDER_KEYS)[number];
+export declare function isKcc20BuilderKey(value: string): value is Kcc20BuilderKey;
+export declare const BACKEND_ONLY_BUILDER_KEYS: readonly ["kcc20orderbook.matcher-settle-crossed"];
+export type BackendOnlyBuilderKey = (typeof BACKEND_ONLY_BUILDER_KEYS)[number];
+export declare function isBackendOnlyBuilderKey(value: unknown): value is BackendOnlyBuilderKey;

package/dist/cjs/operations.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BACKEND_ONLY_BUILDER_KEYS = exports.KCC20_BUILDER_KEYS = void 0;
+exports.isKcc20BuilderKey = isKcc20BuilderKey;
+exports.isBackendOnlyBuilderKey = isBackendOnlyBuilderKey;
+exports.KCC20_BUILDER_KEYS = [
+    "kcc20.deploy-token",
+    "kcc20.mint",
+    "kcc20.set-public-mint-active",
+    "kcc20.transfer",
+    "kcc20.consolidate-holders",
+    "kcc20.reveal-token",
+    "kcc20wrapper.deploy-market",
+    "kcc20wrapper.wrap",
+    "kcc20wrapper.unwrap",
+    "kcc20orderbook.create-bid",
+    "kcc20orderbook.create-ask",
+    "kcc20orderbook.fill-ask",
+    "kcc20orderbook.fill-bid",
+    "kcc20orderbook.sweep-asks",
+    "kcc20orderbook.sweep-bids",
+    "kcc20orderbook.consolidate-holders",
+    "kcc20orderbook.cancel-ask",
+    "kcc20orderbook.cancel-bid",
+    "fee-ticket.deploy-root",
+    "fee-ticket.update-denomination",
+    "fee-ticket.create-from-utility-burn",
+    "fee-ticket.burn",
+    "fee-ticket.transfer",
+];
+function isKcc20BuilderKey(value) {
+    return exports.KCC20_BUILDER_KEYS.includes(value);
+}
+exports.BACKEND_ONLY_BUILDER_KEYS = [
+    "kcc20orderbook.matcher-settle-crossed",
+];
+function isBackendOnlyBuilderKey(value) {
+    return (typeof value === "string" &&
+        exports.BACKEND_ONLY_BUILDER_KEYS.includes(value));
+}
+//# sourceMappingURL=operations.js.map

package/dist/cjs/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../src/operations.ts"],"names":[],"mappings":";;;AA4BA,8CAEC;AAQD,0DAOC;AA7CY,QAAA,kBAAkB,GAAG;IAChC,oBAAoB;IACpB,YAAY;IACZ,8BAA8B;IAC9B,gBAAgB;IAChB,2BAA2B;IAC3B,oBAAoB;IACpB,4BAA4B;IAC5B,mBAAmB;IACnB,qBAAqB;IACrB,2BAA2B;IAC3B,2BAA2B;IAC3B,yBAAyB;IACzB,yBAAyB;IACzB,2BAA2B;IAC3B,2BAA2B;IAC3B,oCAAoC;IACpC,2BAA2B;IAC3B,2BAA2B;IAC3B,wBAAwB;IACxB,gCAAgC;IAChC,qCAAqC;IACrC,iBAAiB;IACjB,qBAAqB;CACb,CAAC;AAIX,SAAgB,iBAAiB,CAAC,KAAa;IAC7C,OAAQ,0BAAwC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAEY,QAAA,yBAAyB,GAAG;IACvC,uCAAuC;CAC/B,CAAC;AAIX,SAAgB,uBAAuB,CACrC,KAAc;IAEd,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACxB,iCAA+C,CAAC,QAAQ,CAAC,KAAK,CAAC,CACjE,CAAC;AACJ,CAAC"}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/cjs/paid-mint-amount.d.ts

@@ -0,0 +1,69 @@
+export declare const KCC20_PAID_MINT_MIN_GROSS_SOMPI = 50000000n;
+export declare const KCC20_VERIFY_PAID_MINT_MIN_GROSS_SOMPI = 100000000n;
+export declare const KCC20_RECOMMENDED_PAID_MINT_MIN_GROSS_SOMPI = 55000000n;
+export declare const KCC20_MIN_PAID_MINT_TREASURY_OUTPUT_SOMPI = 2003085n;
+export interface Kcc20PaidMintAmountQuote {
+    tokenAmount: bigint;
+    adjustedTokenAmount: bigint;
+    grossSompi: bigint;
+    adjusted: boolean;
+    belowMinimumGross: boolean;
+}
+/**
+ * Checks whether all remaining paid-mint supply can produce at least the
+ * required gross amount. The comparison is cross-multiplied so fractional
+ * display scales are handled without rounding or floating-point arithmetic.
+ */
+export declare function kcc20PaidMintCapacityMeetsMinimumGross(input: {
+    remainingTokenAmount: bigint;
+    unitPriceSompi: bigint;
+    priceScale: bigint;
+    minimumGrossSompi?: bigint;
+}): boolean;
+export declare function kcc20PaidMintExactGrossSompi(input: {
+    tokenAmount: bigint;
+    unitPriceSompi: bigint;
+    priceScale: bigint;
+}): bigint;
+export declare function kcc20PaidMintAmountStep(unitPriceSompi: bigint, priceScale: bigint): bigint;
+export declare function kcc20SnapPaidMintAmountUp(input: {
+    tokenAmount: bigint;
+    unitPriceSompi: bigint;
+    priceScale: bigint;
+}): bigint;
+export declare function kcc20MinimumPaidMintAmount(input: {
+    unitPriceSompi: bigint;
+    priceScale: bigint;
+    minGrossSompi?: bigint;
+    protocolFeeBps?: number | null;
+}): bigint;
+export declare function kcc20ValidatePaidMintAmount(input: {
+    tokenAmount: bigint;
+    unitPriceSompi: bigint;
+    priceScale: bigint;
+    minGrossSompi?: bigint;
+    protocolFeeBps?: number | null;
+    minimumGrossLabel?: string;
+}): void;
+export declare function kcc20PaidMintFeeSplit(grossSompi: bigint, protocolFeeBps: number | null | undefined, minGrossSompi?: bigint): {
+    fee: bigint;
+    net: bigint;
+};
+/**
+ * Produces a transaction-safe paid-mint amount. It enforces exact sompi,
+ * protocol-fee, and non-zero treasury-output dust constraints in one place.
+ */
+export declare function buildKcc20PaidMintAmountQuote(input: {
+    tokenAmount: bigint;
+    unitPriceSompi: bigint;
+    priceScale: bigint;
+    protocolFeeBps?: number | null;
+    minimumGrossSompi?: bigint;
+}): Kcc20PaidMintAmountQuote | undefined;
+export declare function kcc20MinimumSafePaidMintAmount(input: {
+    unitPriceSompi: bigint;
+    priceScale: bigint;
+    protocolFeeBps?: number | null;
+    minimumGrossSompi?: bigint;
+}): bigint | undefined;
+export declare function isKcc20SafePaidMintGross(grossSompi: bigint, protocolFeeBps?: number | null): boolean;