@kaspacom/kcc20-tx-builder 0.1.0

package/dist/cjs/paid-mint-amount.js

@@ -0,0 +1,281 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KCC20_MIN_PAID_MINT_TREASURY_OUTPUT_SOMPI = exports.KCC20_RECOMMENDED_PAID_MINT_MIN_GROSS_SOMPI = exports.KCC20_VERIFY_PAID_MINT_MIN_GROSS_SOMPI = exports.KCC20_PAID_MINT_MIN_GROSS_SOMPI = void 0;
+exports.kcc20PaidMintCapacityMeetsMinimumGross = kcc20PaidMintCapacityMeetsMinimumGross;
+exports.kcc20PaidMintExactGrossSompi = kcc20PaidMintExactGrossSompi;
+exports.kcc20PaidMintAmountStep = kcc20PaidMintAmountStep;
+exports.kcc20SnapPaidMintAmountUp = kcc20SnapPaidMintAmountUp;
+exports.kcc20MinimumPaidMintAmount = kcc20MinimumPaidMintAmount;
+exports.kcc20ValidatePaidMintAmount = kcc20ValidatePaidMintAmount;
+exports.kcc20PaidMintFeeSplit = kcc20PaidMintFeeSplit;
+exports.buildKcc20PaidMintAmountQuote = buildKcc20PaidMintAmountQuote;
+exports.kcc20MinimumSafePaidMintAmount = kcc20MinimumSafePaidMintAmount;
+exports.isKcc20SafePaidMintGross = isKcc20SafePaidMintGross;
+exports.KCC20_PAID_MINT_MIN_GROSS_SOMPI = 50000000n;
+exports.KCC20_VERIFY_PAID_MINT_MIN_GROSS_SOMPI = 100000000n;
+exports.KCC20_RECOMMENDED_PAID_MINT_MIN_GROSS_SOMPI = 55000000n;
+exports.KCC20_MIN_PAID_MINT_TREASURY_OUTPUT_SOMPI = 2003085n;
+const KCC20_FEE_DENOMINATOR_BPS = 10000n;
+const KCC20_PAID_MINT_GROSS_SEARCH_MAX_DOUBLINGS = 64;
+/**
+ * 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.
+ */
+function kcc20PaidMintCapacityMeetsMinimumGross(input) {
+    assertPositivePriceScale(input.priceScale);
+    if (input.unitPriceSompi <= 0n)
+        return true;
+    if (input.remainingTokenAmount <= 0n)
+        return false;
+    const minimumGrossSompi = input.minimumGrossSompi ?? exports.KCC20_PAID_MINT_MIN_GROSS_SOMPI;
+    if (minimumGrossSompi < 0n) {
+        throw new Error("minimumGrossSompi must not be negative");
+    }
+    return (input.remainingTokenAmount * input.unitPriceSompi >=
+        minimumGrossSompi * input.priceScale);
+}
+function kcc20PaidMintExactGrossSompi(input) {
+    if (input.unitPriceSompi <= 0n) {
+        return 0n;
+    }
+    assertPositivePriceScale(input.priceScale);
+    const numerator = input.tokenAmount * input.unitPriceSompi;
+    const remainder = numerator % input.priceScale;
+    if (remainder !== 0n) {
+        throw new Error(`paid mint amount is not valid for token decimals: tokenAmount=${input.tokenAmount} unitPriceSompi=${input.unitPriceSompi} priceScale=${input.priceScale}`);
+    }
+    return numerator / input.priceScale;
+}
+function kcc20PaidMintAmountStep(unitPriceSompi, priceScale) {
+    if (unitPriceSompi <= 0n) {
+        return 1n;
+    }
+    assertPositivePriceScale(priceScale);
+    return priceScale / gcd(priceScale, unitPriceSompi);
+}
+function kcc20SnapPaidMintAmountUp(input) {
+    const step = kcc20PaidMintAmountStep(input.unitPriceSompi, input.priceScale);
+    const remainder = input.tokenAmount % step;
+    return remainder === 0n
+        ? input.tokenAmount
+        : input.tokenAmount + step - remainder;
+}
+function kcc20MinimumPaidMintAmount(input) {
+    if (input.unitPriceSompi <= 0n) {
+        return input.priceScale;
+    }
+    const minGrossSompi = input.minGrossSompi ?? exports.KCC20_PAID_MINT_MIN_GROSS_SOMPI;
+    const minimumAmountAtProtocolFloor = kcc20SnapPaidMintAmountUp({
+        tokenAmount: ceilDiv(minGrossSompi * input.priceScale, input.unitPriceSompi),
+        unitPriceSompi: input.unitPriceSompi,
+        priceScale: input.priceScale,
+    });
+    if (normalizeFeeBps(input.protocolFeeBps) >= Number(KCC20_FEE_DENOMINATOR_BPS)) {
+        return minimumAmountAtProtocolFloor;
+    }
+    const wholeDisplayTokens = ceilDiv(minimumAmountAtProtocolFloor, input.priceScale);
+    return kcc20SnapPaidMintAmountUp({
+        tokenAmount: wholeDisplayTokens * input.priceScale,
+        unitPriceSompi: input.unitPriceSompi,
+        priceScale: input.priceScale,
+    });
+}
+function kcc20ValidatePaidMintAmount(input) {
+    const grossSompi = kcc20PaidMintExactGrossSompi(input);
+    const minGrossSompi = input.minGrossSompi ?? exports.KCC20_PAID_MINT_MIN_GROSS_SOMPI;
+    if (grossSompi > 0n && grossSompi < minGrossSompi) {
+        throw new Error(`paid mint gross ${formatSompiAsKas(grossSompi)} KAS is below ${input.minimumGrossLabel ?? "minimum protocol fee"} ${formatSompiAsKas(minGrossSompi)} KAS`);
+    }
+}
+function kcc20PaidMintFeeSplit(grossSompi, protocolFeeBps, minGrossSompi = exports.KCC20_PAID_MINT_MIN_GROSS_SOMPI) {
+    if (grossSompi <= 0n) {
+        return { fee: 0n, net: 0n };
+    }
+    const bps = normalizeFeeBps(protocolFeeBps);
+    const percentageFee = (grossSompi * BigInt(bps)) / KCC20_FEE_DENOMINATOR_BPS;
+    const fee = percentageFee < minGrossSompi ? minGrossSompi : percentageFee;
+    return { fee, net: grossSompi - fee };
+}
+/**
+ * Produces a transaction-safe paid-mint amount. It enforces exact sompi,
+ * protocol-fee, and non-zero treasury-output dust constraints in one place.
+ */
+function buildKcc20PaidMintAmountQuote(input) {
+    if (input.tokenAmount <= 0n || input.unitPriceSompi < 0n)
+        return undefined;
+    assertPositivePriceScale(input.priceScale);
+    if (input.unitPriceSompi === 0n) {
+        return {
+            tokenAmount: input.tokenAmount,
+            adjustedTokenAmount: input.tokenAmount,
+            grossSompi: 0n,
+            adjusted: false,
+            belowMinimumGross: false,
+        };
+    }
+    const minimumGrossSompi = input.minimumGrossSompi ?? exports.KCC20_RECOMMENDED_PAID_MINT_MIN_GROSS_SOMPI;
+    const step = kcc20PaidMintAmountStep(input.unitPriceSompi, input.priceScale);
+    let adjustedTokenAmount = roundUpToStep(input.tokenAmount, step);
+    const typedGrossSompi = kcc20PaidMintExactGrossSompi({
+        ...input,
+        tokenAmount: adjustedTokenAmount,
+    });
+    if (typedGrossSompi < minimumGrossSompi) {
+        return {
+            tokenAmount: input.tokenAmount,
+            adjustedTokenAmount,
+            grossSompi: typedGrossSompi,
+            adjusted: adjustedTokenAmount !== input.tokenAmount,
+            belowMinimumGross: true,
+        };
+    }
+    const feeBps = normalizeUiFeeBps(input.protocolFeeBps);
+    if (!isKcc20SafePaidMintGross(typedGrossSompi, feeBps)) {
+        const safeTokenAmount = feeBps < Number(KCC20_FEE_DENOMINATOR_BPS)
+            ? snapPaidMintToSafeWholeTokens(adjustedTokenAmount, input.unitPriceSompi, input.priceScale, step, feeBps)
+            : snapPaidMintToSafeExact(adjustedTokenAmount, input.unitPriceSompi, input.priceScale, step, feeBps);
+        if (safeTokenAmount === undefined)
+            return undefined;
+        adjustedTokenAmount = safeTokenAmount;
+    }
+    const grossSompi = kcc20PaidMintExactGrossSompi({
+        ...input,
+        tokenAmount: adjustedTokenAmount,
+    });
+    if (!isKcc20SafePaidMintGross(grossSompi, feeBps))
+        return undefined;
+    return {
+        tokenAmount: input.tokenAmount,
+        adjustedTokenAmount,
+        grossSompi,
+        adjusted: adjustedTokenAmount !== input.tokenAmount,
+        belowMinimumGross: false,
+    };
+}
+function kcc20MinimumSafePaidMintAmount(input) {
+    if (input.unitPriceSompi <= 0n)
+        return undefined;
+    const minimumGrossSompi = input.minimumGrossSompi ?? exports.KCC20_RECOMMENDED_PAID_MINT_MIN_GROSS_SOMPI;
+    const minimum = kcc20SnapPaidMintAmountUp({
+        tokenAmount: ceilDiv(minimumGrossSompi * input.priceScale, input.unitPriceSompi),
+        unitPriceSompi: input.unitPriceSompi,
+        priceScale: input.priceScale,
+    });
+    const quote = buildKcc20PaidMintAmountQuote({
+        ...input,
+        tokenAmount: minimum,
+        minimumGrossSompi,
+    });
+    return quote?.adjustedTokenAmount ?? minimum;
+}
+function isKcc20SafePaidMintGross(grossSompi, protocolFeeBps) {
+    if (grossSompi < exports.KCC20_PAID_MINT_MIN_GROSS_SOMPI)
+        return false;
+    const split = kcc20PaidMintFeeSplit(grossSompi, normalizeUiFeeBps(protocolFeeBps));
+    return (split.net >= 0n &&
+        (split.net === 0n || split.net >= exports.KCC20_MIN_PAID_MINT_TREASURY_OUTPUT_SOMPI));
+}
+function snapPaidMintToSafeExact(start, price, scale, step, feeBps) {
+    let amount = start;
+    for (let index = 0; index < KCC20_PAID_MINT_GROSS_SEARCH_MAX_DOUBLINGS; index += 1) {
+        const gross = kcc20PaidMintExactGrossSompi({
+            tokenAmount: amount,
+            unitPriceSompi: price,
+            priceScale: scale,
+        });
+        if (isKcc20SafePaidMintGross(gross, feeBps))
+            return amount;
+        const nextGross = smallestSafePaidMintGrossSompi(gross + 1n, feeBps);
+        if (nextGross === undefined)
+            return undefined;
+        const next = roundUpToStep(ceilDiv(nextGross * scale, price), step);
+        amount = next > amount ? next : amount + step;
+    }
+    return undefined;
+}
+function snapPaidMintToSafeWholeTokens(start, price, scale, step, feeBps) {
+    let amount = roundUpToStep(ceilDiv(start, scale) * scale, step);
+    for (let index = 0; index < KCC20_PAID_MINT_GROSS_SEARCH_MAX_DOUBLINGS; index += 1) {
+        const gross = kcc20PaidMintExactGrossSompi({
+            tokenAmount: amount,
+            unitPriceSompi: price,
+            priceScale: scale,
+        });
+        if (isKcc20SafePaidMintGross(gross, feeBps))
+            return amount;
+        const nextGross = smallestSafePaidMintGrossSompi(gross + 1n, feeBps);
+        if (nextGross === undefined)
+            return undefined;
+        let next = roundUpToStep(ceilDiv(nextGross * scale, price), step);
+        next = roundUpToStep(ceilDiv(next, scale) * scale, step);
+        amount = next > amount ? next : roundUpToStep(amount + scale, step);
+    }
+    return undefined;
+}
+function smallestSafePaidMintGrossSompi(minimum, feeBps) {
+    let low = minimum < exports.KCC20_PAID_MINT_MIN_GROSS_SOMPI
+        ? exports.KCC20_PAID_MINT_MIN_GROSS_SOMPI
+        : minimum;
+    if (isKcc20SafePaidMintGross(low, feeBps))
+        return low;
+    let high = low + 1n;
+    for (let index = 0; index < KCC20_PAID_MINT_GROSS_SEARCH_MAX_DOUBLINGS; index += 1) {
+        if (isKcc20SafePaidMintGross(high, feeBps)) {
+            while (low + 1n < high) {
+                const middle = low + (high - low) / 2n;
+                if (isKcc20SafePaidMintGross(middle, feeBps))
+                    high = middle;
+                else
+                    low = middle;
+            }
+            return high;
+        }
+        high += high - low + 1n;
+    }
+    return undefined;
+}
+function normalizeUiFeeBps(value) {
+    return Number.isInteger(value) && value !== null && value !== undefined
+        ? Math.min(10_000, Math.max(0, value))
+        : 200;
+}
+function roundUpToStep(value, step) {
+    const remainder = value % step;
+    return remainder === 0n ? value : value + step - remainder;
+}
+function normalizeFeeBps(value) {
+    if (value === null || value === undefined) {
+        return 200;
+    }
+    if (!Number.isInteger(value) || value < 0 || value > 10_000) {
+        throw new Error("protocolFeeBps must be 0..10000");
+    }
+    return value;
+}
+function ceilDiv(left, right) {
+    return (left + right - 1n) / right;
+}
+function assertPositivePriceScale(priceScale) {
+    if (priceScale <= 0n) {
+        throw new Error("paid mint priceScale must be greater than zero");
+    }
+}
+function formatSompiAsKas(value) {
+    const whole = value / 100000000n;
+    const fractional = value % 100000000n;
+    if (fractional === 0n)
+        return whole.toString();
+    return `${whole}.${fractional.toString().padStart(8, "0").replace(/0+$/, "")}`;
+}
+function gcd(left, right) {
+    let a = left < 0n ? -left : left;
+    let b = right < 0n ? -right : right;
+    while (b !== 0n) {
+        const remainder = a % b;
+        a = b;
+        b = remainder;
+    }
+    return a;
+}
+//# sourceMappingURL=paid-mint-amount.js.map

package/dist/cjs/paid-mint-amount.js.map

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

package/dist/cjs/protocol.d.ts

@@ -0,0 +1,21 @@
+export declare const SUBNETWORK_ID_NATIVE: "0000000000000000000000000000000000000000";
+export declare const ZERO_HASH: "0000000000000000000000000000000000000000000000000000000000000000";
+export declare const SOMPI_PER_TKAS = 100000000n;
+export declare const DEFAULT_TOKEN_OUTPUT_SOMPI = 50000000n;
+export declare const DEFAULT_COMPUTE_BUDGET = 200;
+export declare const DEFAULT_KCC20_FEE_BPS = 200n;
+export declare const DEFAULT_KCC20_MIN_PROTOCOL_FEE_SOMPI = 50000000n;
+export declare const DEFAULT_KCC20_TOKEN_DECIMALS = 8;
+export declare const KCC20_PUBLIC_MINT_MAX_DISPLAY_TOKENS = 100000n;
+export declare const KCC20_PUBLIC_MINT_MAX_DISPLAY_TOKENS_LABEL = "100,000";
+export declare const KCC20_TICKER_MAX_LENGTH = 12;
+export declare const KCC20_TOKEN_NAME_MAX_LENGTH = 32;
+export declare const KCC20_ORDERBOOK_MAX_SWEEP_BID_LEGS = 3;
+export declare const KCC20_ORDERBOOK_MAX_EXPANDED_SWEEP_BID_LEGS = 10;
+export declare const KCC20_ORDERBOOK_EXPANDED_SWEEP_OUTPUT_SOMPI = 200000000n;
+export declare const DEFAULT_KCC20_PRICE_SCALE: bigint;
+export declare const KCC20_MIN_PROTOCOL_FEE_SOMPI = 50000000n;
+export declare const KCC20_DEFAULT_PROTOCOL_FEE_BPS = 200n;
+export declare const KCC20_DEFAULT_PRICE_SCALE: bigint;
+export declare const KCC20_PLATFORM_PROTOCOL_FEE_RECIPIENT: "ce2100e68197c8e695bd781d07e2bd5de7ed77f5a97668884190531bdc632c01";
+export declare const KCC20_ORDERBOOK_PROTOCOL_FEE_RECIPIENT: "ce2100e68197c8e695bd781d07e2bd5de7ed77f5a97668884190531bdc632c01";

package/dist/cjs/protocol.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KCC20_ORDERBOOK_PROTOCOL_FEE_RECIPIENT = exports.KCC20_PLATFORM_PROTOCOL_FEE_RECIPIENT = exports.KCC20_DEFAULT_PRICE_SCALE = exports.KCC20_DEFAULT_PROTOCOL_FEE_BPS = exports.KCC20_MIN_PROTOCOL_FEE_SOMPI = exports.DEFAULT_KCC20_PRICE_SCALE = exports.KCC20_ORDERBOOK_EXPANDED_SWEEP_OUTPUT_SOMPI = exports.KCC20_ORDERBOOK_MAX_EXPANDED_SWEEP_BID_LEGS = exports.KCC20_ORDERBOOK_MAX_SWEEP_BID_LEGS = exports.KCC20_TOKEN_NAME_MAX_LENGTH = exports.KCC20_TICKER_MAX_LENGTH = exports.KCC20_PUBLIC_MINT_MAX_DISPLAY_TOKENS_LABEL = exports.KCC20_PUBLIC_MINT_MAX_DISPLAY_TOKENS = exports.DEFAULT_KCC20_TOKEN_DECIMALS = exports.DEFAULT_KCC20_MIN_PROTOCOL_FEE_SOMPI = exports.DEFAULT_KCC20_FEE_BPS = exports.DEFAULT_COMPUTE_BUDGET = exports.DEFAULT_TOKEN_OUTPUT_SOMPI = exports.SOMPI_PER_TKAS = exports.ZERO_HASH = exports.SUBNETWORK_ID_NATIVE = void 0;
+exports.SUBNETWORK_ID_NATIVE = "0000000000000000000000000000000000000000";
+exports.ZERO_HASH = "0000000000000000000000000000000000000000000000000000000000000000";
+exports.SOMPI_PER_TKAS = 100000000n;
+exports.DEFAULT_TOKEN_OUTPUT_SOMPI = 50000000n;
+exports.DEFAULT_COMPUTE_BUDGET = 200;
+exports.DEFAULT_KCC20_FEE_BPS = 200n;
+exports.DEFAULT_KCC20_MIN_PROTOCOL_FEE_SOMPI = 50000000n;
+exports.DEFAULT_KCC20_TOKEN_DECIMALS = 8;
+exports.KCC20_PUBLIC_MINT_MAX_DISPLAY_TOKENS = 100000n;
+exports.KCC20_PUBLIC_MINT_MAX_DISPLAY_TOKENS_LABEL = "100,000";
+exports.KCC20_TICKER_MAX_LENGTH = 12;
+exports.KCC20_TOKEN_NAME_MAX_LENGTH = 32;
+exports.KCC20_ORDERBOOK_MAX_SWEEP_BID_LEGS = 3;
+exports.KCC20_ORDERBOOK_MAX_EXPANDED_SWEEP_BID_LEGS = 10;
+exports.KCC20_ORDERBOOK_EXPANDED_SWEEP_OUTPUT_SOMPI = 200000000n;
+exports.DEFAULT_KCC20_PRICE_SCALE = 10n ** BigInt(exports.DEFAULT_KCC20_TOKEN_DECIMALS);
+exports.KCC20_MIN_PROTOCOL_FEE_SOMPI = exports.DEFAULT_KCC20_MIN_PROTOCOL_FEE_SOMPI;
+exports.KCC20_DEFAULT_PROTOCOL_FEE_BPS = exports.DEFAULT_KCC20_FEE_BPS;
+exports.KCC20_DEFAULT_PRICE_SCALE = exports.DEFAULT_KCC20_PRICE_SCALE;
+exports.KCC20_PLATFORM_PROTOCOL_FEE_RECIPIENT = "ce2100e68197c8e695bd781d07e2bd5de7ed77f5a97668884190531bdc632c01";
+exports.KCC20_ORDERBOOK_PROTOCOL_FEE_RECIPIENT = exports.KCC20_PLATFORM_PROTOCOL_FEE_RECIPIENT;
+//# sourceMappingURL=protocol.js.map

package/dist/cjs/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/protocol.ts"],"names":[],"mappings":";;;AAAa,QAAA,oBAAoB,GAC/B,0CAAmD,CAAC;AACzC,QAAA,SAAS,GACpB,kEAA2E,CAAC;AACjE,QAAA,cAAc,GAAG,UAAY,CAAC;AAC9B,QAAA,0BAA0B,GAAG,SAAW,CAAC;AACzC,QAAA,sBAAsB,GAAG,GAAG,CAAC;AAC7B,QAAA,qBAAqB,GAAG,IAAI,CAAC;AAC7B,QAAA,oCAAoC,GAAG,SAAW,CAAC;AACnD,QAAA,4BAA4B,GAAG,CAAC,CAAC;AACjC,QAAA,oCAAoC,GAAG,OAAQ,CAAC;AAChD,QAAA,0CAA0C,GAAG,SAAS,CAAC;AACvD,QAAA,uBAAuB,GAAG,EAAE,CAAC;AAC7B,QAAA,2BAA2B,GAAG,EAAE,CAAC;AACjC,QAAA,kCAAkC,GAAG,CAAC,CAAC;AACvC,QAAA,2CAA2C,GAAG,EAAE,CAAC;AACjD,QAAA,2CAA2C,GAAG,UAAY,CAAC;AAC3D,QAAA,yBAAyB,GACpC,GAAG,IAAI,MAAM,CAAC,oCAA4B,CAAC,CAAC;AACjC,QAAA,4BAA4B,GACvC,4CAAoC,CAAC;AAC1B,QAAA,8BAA8B,GAAG,6BAAqB,CAAC;AACvD,QAAA,yBAAyB,GAAG,iCAAyB,CAAC;AAEtD,QAAA,qCAAqC,GAChD,kEAA2E,CAAC;AACjE,QAAA,sCAAsC,GACjD,6CAAqC,CAAC"}

package/dist/cjs/runtime.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The shared package receives a runtime from its host application.
+ *
+ * Do not replace this with an import from either Kaspa WASM build. The browser
+ * and Node applications initialize different binaries and use different asset
+ * loading mechanisms.
+ */
+/**
+ * A loaded Kaspa module supplied by the host application. The shared package
+ * intentionally does not prescribe the exact generated-WASM TypeScript
+ * declarations. Operation modules should narrow the capabilities they use.
+ */
+export interface KaspaWasmRuntime {
+    readonly [capability: string]: unknown;
+}
+export interface CoreKaspaWasmCapabilities extends KaspaWasmRuntime {
+    readonly addressFromScriptPublicKey: (...args: any[]) => any;
+    readonly payToScriptHashScript: (...args: any[]) => any;
+    readonly payToAddressScript: (...args: any[]) => any;
+    readonly ScriptBuilder: any;
+    readonly Transaction: any;
+    readonly TransactionInput: any;
+    readonly TransactionOutput: any;
+}
+export interface KaspaWasmProvider {
+    getRuntime(): Promise<KaspaWasmRuntime>;
+}

package/dist/cjs/runtime.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=runtime.js.map

package/dist/cjs/runtime.js.map

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