@kaspacom/kcc20-tx-builder 0.1.0

package/dist/cjs/deploy-operation.d.ts

@@ -0,0 +1,103 @@
+export interface Kcc20DeployTokenDraft {
+    ticker?: string;
+    tokenName?: string;
+    maxSupply: string;
+    premintSupply: string;
+    decimals?: number;
+    premintRecipient?: string;
+    mintPolicy: "fixed" | "controlled" | "public";
+    mintLaneCount?: number;
+    mintPricePerTokenSompi: string;
+    treasuryRecipient?: string;
+}
+export interface Kcc20DeployWalletInfo {
+    walletAddress: string;
+    kcc20Owner: string;
+}
+export interface Kcc20DeployOperationOptions {
+    network?: string;
+    protocolFeeRecipient?: string;
+    protocolFeeBps?: number | string | bigint;
+    createdAt?: string;
+    requestId?: string;
+}
+export interface Kcc20ValidatedDeployToken {
+    ticker: string;
+    tokenName: string;
+    maxSupply: bigint;
+    premintSupply: bigint;
+    decimals: number;
+    premintRecipient: string;
+    mintPricePerTokenSompi: bigint;
+    mintPolicy: number;
+    treasuryRecipient: string;
+    protocolFeeRecipient: string;
+    protocolFeeBps: number;
+    mintLaneCount?: number;
+}
+export declare function buildKcc20DeployTokenOperation(walletInfo: Kcc20DeployWalletInfo, draft: Kcc20DeployTokenDraft, options?: Kcc20DeployOperationOptions): {
+    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;
+    };
+};
+export declare function buildKcc20DeployTokenOperationFromValidated(walletInfo: Kcc20DeployWalletInfo, draft: Kcc20DeployTokenDraft, validated: Kcc20ValidatedDeployToken, options?: Kcc20DeployOperationOptions): {
+    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;
+    };
+};
+export declare function validateKcc20DeployToken(walletInfo: Kcc20DeployWalletInfo, draft: Kcc20DeployTokenDraft, options?: Kcc20DeployOperationOptions): Kcc20ValidatedDeployToken;
+export declare function normalizeKcc20Ticker(value: string | undefined): string;
+export declare function normalizeKcc20TokenName(value: string | undefined): string;
+export declare function parseKcc20U64(value: string, field: string): bigint;

package/dist/cjs/deploy-operation.js

@@ -0,0 +1,335 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildKcc20DeployTokenOperation = buildKcc20DeployTokenOperation;
+exports.buildKcc20DeployTokenOperationFromValidated = buildKcc20DeployTokenOperationFromValidated;
+exports.validateKcc20DeployToken = validateKcc20DeployToken;
+exports.normalizeKcc20Ticker = normalizeKcc20Ticker;
+exports.normalizeKcc20TokenName = normalizeKcc20TokenName;
+exports.parseKcc20U64 = parseKcc20U64;
+const protocol_js_1 = require("./protocol.js");
+const token_amount_js_1 = require("./token-amount.js");
+const paid_mint_amount_js_1 = require("./paid-mint-amount.js");
+const wallet_operation_js_1 = require("./wallet-operation.js");
+const HEX_64_RE = /^[a-fA-F0-9]{64}$/;
+const KASPA_ADDRESS_CHARSET = "qpzry9x8gf2tvdw0s3jn54khce6mua7l";
+const KASPA_ADDRESS_GENERATORS = [
+    0x98f2bc8e61n,
+    0x79b76d99e2n,
+    0xf33e5fb3c4n,
+    0xae2eabe2a8n,
+    0x1e4f43e470n,
+];
+function buildKcc20DeployTokenOperation(walletInfo, draft, options = {}) {
+    const validated = validateKcc20DeployToken(walletInfo, draft, options);
+    return buildKcc20DeployTokenOperationFromValidated(walletInfo, draft, validated, options);
+}
+function buildKcc20DeployTokenOperationFromValidated(walletInfo, draft, validated, options = {}) {
+    const requestId = options.requestId ?? `kcc20-deploy-token-${randomOperationId()}`;
+    const network = options.network ?? "testnet-10";
+    const builderKey = "kcc20.deploy-token";
+    const params = {
+        ticker: validated.ticker,
+        tokenName: validated.tokenName,
+        maxSupply: validated.maxSupply.toString(),
+        premintSupply: validated.premintSupply.toString(),
+        decimals: validated.decimals,
+        displayMaxSupply: draft.maxSupply,
+        displayPremintSupply: draft.premintSupply,
+        mintPolicy: draft.mintPolicy,
+        mintPolicyValue: validated.mintPolicy,
+        mintPricePerTokenSompi: validated.mintPricePerTokenSompi.toString(),
+        creator: walletInfo.kcc20Owner,
+        premintRecipient: validated.premintRecipient,
+        premintOwnerScheme: 0,
+        treasuryRecipient: validated.treasuryRecipient,
+        protocolFeeRecipient: validated.protocolFeeRecipient,
+        protocolFeeBps: validated.protocolFeeBps,
+        ...(validated.mintLaneCount == null
+            ? {}
+            : { mintLaneCount: validated.mintLaneCount }),
+        deployTemplate: deployTemplate(walletInfo, validated),
+    };
+    const sourceRequirements = [
+        {
+            type: "kaspa-funding-utxo",
+            ownerAddress: walletInfo.walletAddress,
+            purpose: "fund deploy outputs and network fee",
+        },
+    ];
+    const signerRequirements = [
+        {
+            type: "wallet-owner",
+            owner: walletInfo.kcc20Owner,
+            address: walletInfo.walletAddress,
+        },
+    ];
+    return (0, wallet_operation_js_1.buildKcc20WalletOperationFromPlan)(walletInfo, {
+        builderKey,
+        operation: "deploy-token",
+        contract: "KCC20",
+        action: "deploy",
+        description: "Build a KCC20 deploy transaction request.",
+        params,
+        sourceRequirements,
+        signerRequirements,
+        warnings: [
+            "The wallet must build the standard KCC20 transaction, attach genesis covenant bindings, sign, and broadcast.",
+            "Live submission remains wallet-side.",
+        ],
+    }, { ...options, requestId, network });
+}
+function validateKcc20DeployToken(walletInfo, draft, options = {}) {
+    const decimals = draft.decimals ?? protocol_js_1.DEFAULT_KCC20_TOKEN_DECIMALS;
+    const displayScale = (0, token_amount_js_1.kcc20DisplayScaleForDecimals)(decimals);
+    const ticker = normalizeKcc20Ticker(draft.ticker);
+    const tokenName = normalizeKcc20TokenName(draft.tokenName);
+    const maxSupply = BigInt((0, token_amount_js_1.parseKcc20DisplayAmountToBaseUnits)(draft.maxSupply, decimals, "maxSupply"));
+    const premintSupply = BigInt((0, token_amount_js_1.parseKcc20DisplayAmountToBaseUnits)(draft.premintSupply, decimals, "premintSupply", {
+        allowZero: true,
+    }));
+    const mintPricePerTokenSompi = parseKcc20U64(draft.mintPricePerTokenSompi, "mintPricePerTokenSompi");
+    const mintPolicy = { fixed: 0, controlled: 1, public: 2 }[draft.mintPolicy];
+    if (mintPolicy === undefined) {
+        throw new Error("mintPolicy is invalid");
+    }
+    const mintLaneCount = draft.mintLaneCount ?? 10;
+    if (!Number.isInteger(mintLaneCount) ||
+        mintLaneCount < 1 ||
+        mintLaneCount > 10) {
+        throw new Error("mintLaneCount must be 1..10");
+    }
+    if (!HEX_64_RE.test(walletInfo.kcc20Owner)) {
+        throw new Error("wallet owner must be 64 hex");
+    }
+    if (maxSupply <= 0n) {
+        throw new Error("maxSupply must be greater than zero");
+    }
+    if (premintSupply > maxSupply) {
+        throw new Error("premintSupply cannot exceed maxSupply");
+    }
+    if (mintPolicy === 0 && premintSupply !== maxSupply) {
+        throw new Error("fixed deploys must premint the full maxSupply");
+    }
+    if (mintPolicy !== 0 && premintSupply === maxSupply) {
+        throw new Error("controlled/public mint deploys must leave remaining mint supply");
+    }
+    if (mintPolicy !== 2 && mintPricePerTokenSompi > 0n) {
+        throw new Error("mintPricePerTokenSompi is only valid for public deploys");
+    }
+    if (mintPolicy === 2 &&
+        mintPricePerTokenSompi > 0n &&
+        !(0, paid_mint_amount_js_1.kcc20PaidMintCapacityMeetsMinimumGross)({
+            remainingTokenAmount: maxSupply - premintSupply,
+            unitPriceSompi: mintPricePerTokenSompi,
+            priceScale: displayScale,
+            minimumGrossSompi: protocol_js_1.DEFAULT_KCC20_MIN_PROTOCOL_FEE_SOMPI,
+        })) {
+        throw new Error("public deploys with a mint price must leave enough mintable supply to satisfy the minimum protocol fee");
+    }
+    if (mintPolicy !== 0 && maxSupply - premintSupply < BigInt(mintLaneCount)) {
+        throw new Error("remaining mint supply must cover every mint lane");
+    }
+    const premintRecipientInput = draft.premintRecipient?.trim();
+    if (premintRecipientInput && (mintPolicy === 0 || premintSupply === 0n)) {
+        throw new Error("premintRecipient is only valid when controlled/public mint deploys create a premint holder output");
+    }
+    const protocolFeeRecipient = normalizeOptionalOwner(options.protocolFeeRecipient, "protocolFeeRecipient") ?? protocol_js_1.KCC20_PLATFORM_PROTOCOL_FEE_RECIPIENT;
+    const protocolFeeBps = Number(options.protocolFeeBps ?? protocol_js_1.DEFAULT_KCC20_FEE_BPS);
+    if (!Number.isSafeInteger(protocolFeeBps) ||
+        protocolFeeBps < 0 ||
+        protocolFeeBps > 10_000) {
+        throw new Error("protocolFeeBps must be an integer between 0 and 10000");
+    }
+    return {
+        ticker,
+        tokenName,
+        maxSupply,
+        premintSupply,
+        decimals,
+        mintPolicy,
+        mintPricePerTokenSompi,
+        premintRecipient: normalizeOptionalOwner(premintRecipientInput, "premintRecipient") ??
+            walletInfo.kcc20Owner,
+        treasuryRecipient: normalizeOptionalOwner(draft.treasuryRecipient, "treasuryRecipient") ??
+            walletInfo.kcc20Owner,
+        protocolFeeRecipient,
+        protocolFeeBps,
+        mintLaneCount: mintPolicy === 0 ? 1 : mintLaneCount,
+    };
+}
+function deployTemplate(walletInfo, validated) {
+    return {
+        tmpl: "KCC20",
+        v: 1,
+        args: [
+            { name: "creator", type: "byte[32]", value: walletInfo.kcc20Owner },
+            { name: "maxSupply", type: "u64", value: validated.maxSupply.toString() },
+            {
+                name: "premintSupply",
+                type: "u64",
+                value: validated.premintSupply.toString(),
+            },
+            {
+                name: "premintRecipient",
+                type: "byte[32]",
+                value: validated.premintRecipient,
+            },
+            { name: "premintOwnerScheme", type: "u64", value: "0" },
+            { name: "mintPolicy", type: "u64", value: String(validated.mintPolicy) },
+            ...(validated.mintLaneCount == null
+                ? []
+                : [
+                    {
+                        name: "mintLaneCount",
+                        type: "u64",
+                        value: String(validated.mintLaneCount),
+                    },
+                ]),
+            {
+                name: "displayScale",
+                type: "u64",
+                value: (0, token_amount_js_1.kcc20DisplayScaleForDecimals)(validated.decimals).toString(),
+            },
+            {
+                name: "mintPriceSompi",
+                type: "u64",
+                value: validated.mintPricePerTokenSompi.toString(),
+            },
+            {
+                name: "treasury",
+                type: "byte[32]",
+                value: validated.treasuryRecipient,
+            },
+            {
+                name: "protocolFeeRecipient",
+                type: "byte[32]",
+                value: validated.protocolFeeRecipient,
+            },
+            {
+                name: "protocolFeeBps",
+                type: "u64",
+                value: String(validated.protocolFeeBps),
+            },
+            { name: "ticker", type: "string", value: validated.ticker },
+            { name: "name", type: "string", value: validated.tokenName },
+        ],
+    };
+}
+function normalizeKcc20Ticker(value) {
+    const normalized = String(value ?? "")
+        .trim()
+        .toUpperCase();
+    if (!normalized)
+        return "";
+    if (!new RegExp(`^[A-Z0-9]{1,${protocol_js_1.KCC20_TICKER_MAX_LENGTH}}$`).test(normalized)) {
+        throw new Error(`ticker must be 1-${protocol_js_1.KCC20_TICKER_MAX_LENGTH} uppercase alphanumeric characters`);
+    }
+    return normalized;
+}
+function normalizeKcc20TokenName(value) {
+    const normalized = String(value ?? "")
+        .trim()
+        .replace(/\s+/g, " ");
+    if (!normalized)
+        return "";
+    if (normalized.length > protocol_js_1.KCC20_TOKEN_NAME_MAX_LENGTH) {
+        throw new Error(`tokenName must be ${protocol_js_1.KCC20_TOKEN_NAME_MAX_LENGTH} characters or fewer`);
+    }
+    if (!/^[\x20-\x7E]+$/.test(normalized)) {
+        throw new Error("tokenName must be printable ASCII");
+    }
+    return normalized;
+}
+function parseKcc20U64(value, field) {
+    if (!/^\d+$/.test(value)) {
+        throw new Error(`${field} must be an unsigned integer`);
+    }
+    const parsed = BigInt(value);
+    if (parsed > token_amount_js_1.KCC20_U64_MAX) {
+        throw new Error(`${field} exceeds u64 max`);
+    }
+    return parsed;
+}
+function normalizeOptionalOwner(value, field) {
+    const normalized = value?.trim().toLowerCase();
+    if (!normalized)
+        return undefined;
+    if (HEX_64_RE.test(normalized))
+        return normalized;
+    const owner = ownerFromKaspaAddress(normalized);
+    if (owner)
+        return owner;
+    throw new Error(`${field} must be a 64 hex owner or Kaspa P2PK address`);
+}
+function ownerFromKaspaAddress(value) {
+    const [prefix, payload, extra] = value.split(":");
+    if (!prefix || !payload || extra !== undefined)
+        return undefined;
+    const data = [];
+    for (const char of payload) {
+        const index = KASPA_ADDRESS_CHARSET.indexOf(char);
+        if (index === -1)
+            return undefined;
+        data.push(index);
+    }
+    if (data.length <= 8 ||
+        kaspaAddressPolymod(kaspaAddressPrefixExpand(prefix).concat(data)) !== 1n) {
+        return undefined;
+    }
+    const bytes = convertBits(data.slice(0, -8), 5, 8, false);
+    if (!bytes || bytes.length !== 33)
+        return undefined;
+    const [version, ...ownerBytes] = bytes;
+    if (version !== 0 && version !== 1)
+        return undefined;
+    const owner = bytesToHex(ownerBytes);
+    return HEX_64_RE.test(owner) ? owner : undefined;
+}
+function kaspaAddressPrefixExpand(prefix) {
+    return [...prefix].map((char) => char.charCodeAt(0) & 0x1f).concat([0]);
+}
+function kaspaAddressPolymod(values) {
+    let checksum = 1n;
+    for (const value of values) {
+        const top = checksum >> 35n;
+        checksum = ((checksum & 0x07ffffffffn) << 5n) ^ BigInt(value);
+        for (let index = 0; index < KASPA_ADDRESS_GENERATORS.length; index += 1) {
+            if (((top >> BigInt(index)) & 1n) === 1n) {
+                checksum ^= KASPA_ADDRESS_GENERATORS[index];
+            }
+        }
+    }
+    return checksum;
+}
+function convertBits(data, fromBits, toBits, pad) {
+    let accumulator = 0;
+    let bits = 0;
+    const result = [];
+    const maxValue = (1 << toBits) - 1;
+    const maxAccumulator = (1 << (fromBits + toBits - 1)) - 1;
+    for (const value of data) {
+        if (value < 0 || value >> fromBits)
+            return undefined;
+        accumulator = ((accumulator << fromBits) | value) & maxAccumulator;
+        bits += fromBits;
+        while (bits >= toBits) {
+            bits -= toBits;
+            result.push((accumulator >> bits) & maxValue);
+        }
+    }
+    if (pad) {
+        if (bits > 0)
+            result.push((accumulator << (toBits - bits)) & maxValue);
+    }
+    else if (bits >= fromBits || (accumulator << (toBits - bits)) & maxValue) {
+        return undefined;
+    }
+    return result;
+}
+function bytesToHex(bytes) {
+    return bytes.map((byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+function randomOperationId() {
+    return globalThis.crypto?.randomUUID?.() ?? `${Date.now().toString(36)}`;
+}
+//# sourceMappingURL=deploy-operation.js.map

package/dist/cjs/deploy-operation.js.map

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

package/dist/cjs/encoding.d.ts

@@ -0,0 +1,5 @@
+export declare function hexToBytes(value: string, label?: string): Uint8Array;
+export declare function bytesToHex(bytes: Uint8Array): string;
+export declare function requireHex(value: string, byteLength: number, label: string): string;
+export declare function asciiToBytes32(value: string, label?: string): Uint8Array;
+export declare function concatByteArrays(...parts: Uint8Array[]): Uint8Array;

package/dist/cjs/encoding.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hexToBytes = hexToBytes;
+exports.bytesToHex = bytesToHex;
+exports.requireHex = requireHex;
+exports.asciiToBytes32 = asciiToBytes32;
+exports.concatByteArrays = concatByteArrays;
+const errors_js_1 = require("./errors.js");
+function hexToBytes(value, label = "hex value") {
+    const hex = value.trim().replace(/^0x/i, "");
+    if (!/^(?:[0-9a-f]{2})*$/i.test(hex)) {
+        throw new errors_js_1.Kcc20BuilderError("INVALID_INPUT", `${label} must be an even-length hexadecimal string`);
+    }
+    const bytes = new Uint8Array(hex.length / 2);
+    for (let index = 0; index < bytes.length; index += 1) {
+        bytes[index] = Number.parseInt(hex.slice(index * 2, index * 2 + 2), 16);
+    }
+    return bytes;
+}
+function bytesToHex(bytes) {
+    let result = "";
+    for (const byte of bytes)
+        result += byte.toString(16).padStart(2, "0");
+    return result;
+}
+function requireHex(value, byteLength, label) {
+    const bytes = hexToBytes(value, label);
+    if (bytes.length !== byteLength) {
+        throw new errors_js_1.Kcc20BuilderError("INVALID_INPUT", `${label} must be ${byteLength} bytes`);
+    }
+    return bytesToHex(bytes);
+}
+function asciiToBytes32(value, label = "value") {
+    const encoded = new TextEncoder().encode(value);
+    if (encoded.length > 32) {
+        throw new errors_js_1.Kcc20BuilderError("INVALID_INPUT", `${label} must be at most 32 UTF-8 bytes`);
+    }
+    const result = new Uint8Array(32);
+    result.set(encoded);
+    return result;
+}
+function concatByteArrays(...parts) {
+    const result = new Uint8Array(parts.reduce((length, part) => length + part.length, 0));
+    let offset = 0;
+    for (const part of parts) {
+        result.set(part, offset);
+        offset += part.length;
+    }
+    return result;
+}
+//# sourceMappingURL=encoding.js.map

package/dist/cjs/encoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.js","sourceRoot":"","sources":["../../src/encoding.ts"],"names":[],"mappings":";;AAEA,gCAaC;AAED,gCAIC;AAED,gCASC;AAED,wCAWC;AAED,4CAUC;AAzDD,2CAAgD;AAEhD,SAAgB,UAAU,CAAC,KAAa,EAAE,KAAK,GAAG,WAAW;IAC3D,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC7C,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,6BAAiB,CACzB,eAAe,EACf,GAAG,KAAK,4CAA4C,CACrD,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,KAAK,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,UAAU,CAAC,KAAiB;IAC1C,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,UAAU,CAAC,KAAa,EAAE,UAAkB,EAAE,KAAa;IACzE,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACvC,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAChC,MAAM,IAAI,6BAAiB,CACzB,eAAe,EACf,GAAG,KAAK,YAAY,UAAU,QAAQ,CACvC,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,SAAgB,cAAc,CAAC,KAAa,EAAE,KAAK,GAAG,OAAO;IAC3D,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,6BAAiB,CACzB,eAAe,EACf,GAAG,KAAK,iCAAiC,CAC1C,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IAClC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,gBAAgB,CAAC,GAAG,KAAmB;IACrD,MAAM,MAAM,GAAG,IAAI,UAAU,CAC3B,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CACxD,CAAC;IACF,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzB,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;IACxB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cjs/engine.d.ts

@@ -0,0 +1,40 @@
+import type { KaspaWasmRuntime } from "./runtime.js";
+export interface Kcc20PsktBuilderEngineOptions {
+    wasm: KaspaWasmRuntime;
+    artifacts: Record<string, unknown>;
+    artifactProvider?: (key: string) => Promise<unknown>;
+    config?: Record<string, any>;
+    sourceProvider?: {
+        getUtxosByAddresses(args: {
+            addresses: string[];
+        }): Promise<unknown>;
+    };
+    rpcClientFactory?: (config: unknown) => any;
+    allowBackendOnly?: boolean;
+}
+export interface FeeTicketBatchCreateCapability {
+    recognizedArtifact: boolean;
+    batchCreateSupported: boolean;
+    maxTicketBatchQuantity: number;
+}
+/**
+ * Low-level protocol helpers used by backend projections, operator adapters,
+ * and the package conformance suite. They live on the configured engine
+ * because several helpers require the host-supplied WASM runtime or artifacts.
+ */
+export interface Kcc20PsktProtocolApi {
+    readonly [name: string]: any;
+}
+export interface Kcc20PsktBuilderEngine {
+    build(input: unknown): Promise<Record<string, unknown>>;
+    buildInProcessPskt(input: unknown): Promise<Record<string, unknown>>;
+    resolveFeeTicketBatchCreateCapability(input: {
+        rootOwner: string;
+        utilityTokenId: string;
+        utilityTokenAmount: string;
+        rootAddress: string;
+        network?: string;
+    }): Promise<FeeTicketBatchCreateCapability>;
+    protocol: Kcc20PsktProtocolApi;
+}
+export declare function createKcc20PsktBuilderEngine(options: Kcc20PsktBuilderEngineOptions): Kcc20PsktBuilderEngine;