@kaspacom/kcc20-tx-builder 0.1.0 → 0.2.5

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * from "./action-source-resolver.js";
 export * from "./abi.js";
 export * from "./builder.js";
 export * from "./deploy-operation.js";
+export * from "./deploy-receipt.js";
 export * from "./errors.js";
 export * from "./encoding.js";
 export * from "./engine.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -3,6 +3,7 @@ export * from "./action-source-resolver.js";
 export * from "./abi.js";
 export * from "./builder.js";
 export * from "./deploy-operation.js";
+export * from "./deploy-receipt.js";
 export * from "./errors.js";
 export * from "./encoding.js";
 export * from "./engine.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}

package/dist/protocol.d.ts

@@ -19,4 +19,5 @@ 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";
+export declare function splitKcc20MintSupply(remainingSupply: bigint, laneCount: bigint): bigint[];
 //# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,EAC/B,0CAAmD,CAAC;AACtD,eAAO,MAAM,SAAS,EACpB,kEAA2E,CAAC;AAC9E,eAAO,MAAM,cAAc,aAAe,CAAC;AAC3C,eAAO,MAAM,0BAA0B,YAAc,CAAC;AACtD,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAC1C,eAAO,MAAM,oCAAoC,YAAc,CAAC;AAChE,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,eAAO,MAAM,oCAAoC,UAAW,CAAC;AAC7D,eAAO,MAAM,0CAA0C,YAAY,CAAC;AACpE,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAC9C,eAAO,MAAM,kCAAkC,IAAI,CAAC;AACpD,eAAO,MAAM,2CAA2C,KAAK,CAAC;AAC9D,eAAO,MAAM,2CAA2C,aAAe,CAAC;AACxE,eAAO,MAAM,yBAAyB,QACO,CAAC;AAC9C,eAAO,MAAM,4BAA4B,YACH,CAAC;AACvC,eAAO,MAAM,8BAA8B,OAAwB,CAAC;AACpE,eAAO,MAAM,yBAAyB,QAA4B,CAAC;AAEnE,eAAO,MAAM,qCAAqC,EAChD,kEAA2E,CAAC;AAC9E,eAAO,MAAM,sCAAsC,oEACZ,CAAC"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,EAC/B,0CAAmD,CAAC;AACtD,eAAO,MAAM,SAAS,EACpB,kEAA2E,CAAC;AAC9E,eAAO,MAAM,cAAc,aAAe,CAAC;AAC3C,eAAO,MAAM,0BAA0B,YAAc,CAAC;AACtD,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAC1C,eAAO,MAAM,oCAAoC,YAAc,CAAC;AAChE,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,eAAO,MAAM,oCAAoC,UAAW,CAAC;AAC7D,eAAO,MAAM,0CAA0C,YAAY,CAAC;AACpE,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAC9C,eAAO,MAAM,kCAAkC,IAAI,CAAC;AACpD,eAAO,MAAM,2CAA2C,KAAK,CAAC;AAC9D,eAAO,MAAM,2CAA2C,aAAe,CAAC;AACxE,eAAO,MAAM,yBAAyB,QACO,CAAC;AAC9C,eAAO,MAAM,4BAA4B,YACH,CAAC;AACvC,eAAO,MAAM,8BAA8B,OAAwB,CAAC;AACpE,eAAO,MAAM,yBAAyB,QAA4B,CAAC;AAEnE,eAAO,MAAM,qCAAqC,EAChD,kEAA2E,CAAC;AAC9E,eAAO,MAAM,sCAAsC,oEACZ,CAAC;AAExC,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,GAChB,MAAM,EAAE,CAgBV"}

package/dist/protocol.js

@@ -19,4 +19,18 @@ export const KCC20_DEFAULT_PROTOCOL_FEE_BPS = DEFAULT_KCC20_FEE_BPS;
 export const KCC20_DEFAULT_PRICE_SCALE = DEFAULT_KCC20_PRICE_SCALE;
 export const KCC20_PLATFORM_PROTOCOL_FEE_RECIPIENT = "ce2100e68197c8e695bd781d07e2bd5de7ed77f5a97668884190531bdc632c01";
 export const KCC20_ORDERBOOK_PROTOCOL_FEE_RECIPIENT = KCC20_PLATFORM_PROTOCOL_FEE_RECIPIENT;
+export function splitKcc20MintSupply(remainingSupply, laneCount) {
+    if (remainingSupply <= 0n) {
+        throw new Error("remaining mint supply must be greater than zero");
+    }
+    if (laneCount < 1n || laneCount > 10n) {
+        throw new Error("mint lane count must be between 1 and 10");
+    }
+    if (remainingSupply < laneCount) {
+        throw new Error("remaining mint supply must cover every mint lane");
+    }
+    const base = remainingSupply / laneCount;
+    const remainder = remainingSupply % laneCount;
+    return Array.from({ length: Number(laneCount) }, (_, index) => base + (BigInt(index) < remainder ? 1n : 0n));
+}
 //# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAC/B,0CAAmD,CAAC;AACtD,MAAM,CAAC,MAAM,SAAS,GACpB,kEAA2E,CAAC;AAC9E,MAAM,CAAC,MAAM,cAAc,GAAG,UAAY,CAAC;AAC3C,MAAM,CAAC,MAAM,0BAA0B,GAAG,SAAW,CAAC;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAC1C,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAC1C,MAAM,CAAC,MAAM,oCAAoC,GAAG,SAAW,CAAC;AAChE,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAC9C,MAAM,CAAC,MAAM,oCAAoC,GAAG,OAAQ,CAAC;AAC7D,MAAM,CAAC,MAAM,0CAA0C,GAAG,SAAS,CAAC;AACpE,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAC1C,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,CAAC;AAC9C,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC;AACpD,MAAM,CAAC,MAAM,2CAA2C,GAAG,EAAE,CAAC;AAC9D,MAAM,CAAC,MAAM,2CAA2C,GAAG,UAAY,CAAC;AACxE,MAAM,CAAC,MAAM,yBAAyB,GACpC,GAAG,IAAI,MAAM,CAAC,4BAA4B,CAAC,CAAC;AAC9C,MAAM,CAAC,MAAM,4BAA4B,GACvC,oCAAoC,CAAC;AACvC,MAAM,CAAC,MAAM,8BAA8B,GAAG,qBAAqB,CAAC;AACpE,MAAM,CAAC,MAAM,yBAAyB,GAAG,yBAAyB,CAAC;AAEnE,MAAM,CAAC,MAAM,qCAAqC,GAChD,kEAA2E,CAAC;AAC9E,MAAM,CAAC,MAAM,sCAAsC,GACjD,qCAAqC,CAAC"}
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAC/B,0CAAmD,CAAC;AACtD,MAAM,CAAC,MAAM,SAAS,GACpB,kEAA2E,CAAC;AAC9E,MAAM,CAAC,MAAM,cAAc,GAAG,UAAY,CAAC;AAC3C,MAAM,CAAC,MAAM,0BAA0B,GAAG,SAAW,CAAC;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAC1C,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAC1C,MAAM,CAAC,MAAM,oCAAoC,GAAG,SAAW,CAAC;AAChE,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAC9C,MAAM,CAAC,MAAM,oCAAoC,GAAG,OAAQ,CAAC;AAC7D,MAAM,CAAC,MAAM,0CAA0C,GAAG,SAAS,CAAC;AACpE,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAC1C,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,CAAC;AAC9C,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC;AACpD,MAAM,CAAC,MAAM,2CAA2C,GAAG,EAAE,CAAC;AAC9D,MAAM,CAAC,MAAM,2CAA2C,GAAG,UAAY,CAAC;AACxE,MAAM,CAAC,MAAM,yBAAyB,GACpC,GAAG,IAAI,MAAM,CAAC,4BAA4B,CAAC,CAAC;AAC9C,MAAM,CAAC,MAAM,4BAA4B,GACvC,oCAAoC,CAAC;AACvC,MAAM,CAAC,MAAM,8BAA8B,GAAG,qBAAqB,CAAC;AACpE,MAAM,CAAC,MAAM,yBAAyB,GAAG,yBAAyB,CAAC;AAEnE,MAAM,CAAC,MAAM,qCAAqC,GAChD,kEAA2E,CAAC;AAC9E,MAAM,CAAC,MAAM,sCAAsC,GACjD,qCAAqC,CAAC;AAExC,MAAM,UAAU,oBAAoB,CAClC,eAAuB,EACvB,SAAiB;IAEjB,IAAI,eAAe,IAAI,EAAE,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,SAAS,GAAG,EAAE,IAAI,SAAS,GAAG,GAAG,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,eAAe,GAAG,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,IAAI,GAAG,eAAe,GAAG,SAAS,CAAC;IACzC,MAAM,SAAS,GAAG,eAAe,GAAG,SAAS,CAAC;IAC9C,OAAO,KAAK,CAAC,IAAI,CACf,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,EAC7B,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAC3D,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaspacom/kcc20-tx-builder",
-  "version": "0.1.0",
+  "version": "0.2.5",
   "description": "Runtime-independent KCC20 covenant transaction and PSKT construction primitives.",
   "license": "Apache-2.0",
   "author": "KaspaCom",

package/src/artifacts.ts

@@ -2,8 +2,12 @@ import { Kcc20BuilderError } from "./errors.js";
 import type { ArtifactDescriptor, BuildContext } from "./models.js";
 import { sha256 } from "@noble/hashes/sha256";
 
+/** The only native KCC20 artifact used to build new transactions. */
+export const KCC20_CURRENT_NATIVE_ARTIFACT_KEY =
+  "KCC20.placeholder.json" as const;
+
 export const KCC20_ARTIFACT_SCRIPT_SHA256 = Object.freeze({
-  "KCC20.placeholder.json":
+  [KCC20_CURRENT_NATIVE_ARTIFACT_KEY]:
     "4633b082f26adbf14600b767d6e2146e36ce67d63d8202c0281857922c05ac41",
   "KCC20FeeTicket.placeholder.json":
     "ed81365466ee4c44db1210b3360783af8145f74e49e847848195e09c71ad6930",

package/src/builder.ts

@@ -32,6 +32,3 @@ export interface Kcc20PsktBuilderInput {
   builder: Record<string, unknown>;
   request: Record<string, unknown>;
 }
-
-/** @deprecated Use Kcc20PsktBuilderInput. */
-export type Kcc20LegacyPsktBuilderInput = Kcc20PsktBuilderInput;

package/src/deploy-receipt.ts

@@ -0,0 +1,200 @@
+export interface Kcc20DeployReceiptOutput {
+  index: number;
+  revealScriptHex: string;
+  extensionCommitment: string;
+}
+
+export interface Kcc20DeployMinterReceiptOutput extends Kcc20DeployReceiptOutput {
+  remainingSupply: string | bigint;
+}
+
+export interface Kcc20DeployIntentOutput {
+  role: "fixed-supply-token" | "mint-authority" | "premint-holder";
+  index: number;
+  shard?: number;
+  mintLaneIndex?: number;
+  covenantId: string;
+  revealScriptHex: string;
+  owner: string;
+  ownerScheme: number;
+  borrowScheme: number;
+  borrowGuard: string;
+  extensionCommitment: string;
+  tokenAmount: string;
+  remainingSupply?: string;
+}
+
+export interface BuildKcc20DeployIntentOutputsInput {
+  mintPolicy: number;
+  covenantId: string;
+  creator: string;
+  premintRecipient: string;
+  premintOwnerScheme: number;
+  maxSupply: string | bigint;
+  premintSupply: string | bigint;
+  borrowGuard: string;
+  fixedOutput?: Kcc20DeployReceiptOutput | null;
+  minterOutputs?: readonly Kcc20DeployMinterReceiptOutput[];
+  premintOutput?: Kcc20DeployReceiptOutput | null;
+}
+
+/**
+ * Describes the covenant outputs created by a KCC20 deploy transaction.
+ *
+ * Fixed-supply deployments create one holder output. Mintable deployments
+ * create one or more mint-authority lanes and may append a premint holder.
+ * Keeping this mapping next to the transaction builder prevents receipts from
+ * claiming that output zero owns supply it does not actually contain.
+ */
+export function buildKcc20DeployIntentOutputs(
+  input: BuildKcc20DeployIntentOutputsInput,
+): Kcc20DeployIntentOutput[] {
+  const mintPolicy = requireMintPolicy(input.mintPolicy);
+  const maxSupply = unsignedInteger(input.maxSupply, "maxSupply");
+  const premintSupply = unsignedInteger(input.premintSupply, "premintSupply");
+  const minterOutputs = [...(input.minterOutputs ?? [])];
+
+  if (maxSupply === 0n) {
+    throw new Error("KCC20 deploy receipt maxSupply must be positive");
+  }
+  if (premintSupply > maxSupply) {
+    throw new Error(
+      "KCC20 deploy receipt premintSupply cannot exceed maxSupply",
+    );
+  }
+
+  if (mintPolicy === 0) {
+    if (!input.fixedOutput) {
+      throw new Error("fixed KCC20 deploy receipt output is required");
+    }
+    if (minterOutputs.length || input.premintOutput) {
+      throw new Error(
+        "fixed KCC20 deploy receipt cannot contain mint-authority or premint outputs",
+      );
+    }
+    if (premintSupply !== maxSupply) {
+      throw new Error(
+        "fixed KCC20 deploy receipt must assign the full supply to its holder",
+      );
+    }
+    assertUniqueOutputIndexes([input.fixedOutput]);
+    return [
+      holderIntent("fixed-supply-token", input.fixedOutput, input, maxSupply),
+    ];
+  }
+
+  if (!minterOutputs.length) {
+    throw new Error(
+      "mintable KCC20 deploy receipt requires at least one mint-authority lane",
+    );
+  }
+  if (input.fixedOutput) {
+    throw new Error(
+      "mintable KCC20 deploy receipt cannot contain a fixed-supply output",
+    );
+  }
+  const hasPremint = premintSupply > 0n;
+  if (hasPremint !== Boolean(input.premintOutput)) {
+    throw new Error(
+      "mintable KCC20 deploy receipt premint output does not match premintSupply",
+    );
+  }
+
+  const laneSupplies = minterOutputs.map((output, laneIndex) => {
+    const supply = unsignedInteger(
+      output.remainingSupply,
+      `mint lane ${laneIndex} remainingSupply`,
+    );
+    if (supply === 0n) {
+      throw new Error(
+        `mint lane ${laneIndex} remainingSupply must be positive`,
+      );
+    }
+    return supply;
+  });
+  const laneSupply = laneSupplies.reduce((sum, supply) => sum + supply, 0n);
+  if (laneSupply + premintSupply !== maxSupply) {
+    throw new Error(
+      "mintable KCC20 deploy receipt lane and premint supply must equal maxSupply",
+    );
+  }
+  assertUniqueOutputIndexes([
+    ...minterOutputs,
+    ...(input.premintOutput ? [input.premintOutput] : []),
+  ]);
+
+  const intents: Kcc20DeployIntentOutput[] = minterOutputs.map(
+    (output, laneIndex) => ({
+      role: "mint-authority",
+      shard: laneIndex,
+      mintLaneIndex: laneIndex,
+      index: output.index,
+      covenantId: input.covenantId,
+      revealScriptHex: output.revealScriptHex,
+      owner: input.creator,
+      ownerScheme: 0,
+      borrowScheme: 0,
+      borrowGuard: input.borrowGuard,
+      extensionCommitment: output.extensionCommitment,
+      tokenAmount: "0",
+      remainingSupply: laneSupplies[laneIndex].toString(),
+    }),
+  );
+
+  if (input.premintOutput) {
+    intents.push(
+      holderIntent("premint-holder", input.premintOutput, input, premintSupply),
+    );
+  }
+  return intents;
+}
+
+function holderIntent(
+  role: "fixed-supply-token" | "premint-holder",
+  output: Kcc20DeployReceiptOutput,
+  input: BuildKcc20DeployIntentOutputsInput,
+  tokenAmount: bigint,
+): Kcc20DeployIntentOutput {
+  return {
+    role,
+    index: output.index,
+    covenantId: input.covenantId,
+    revealScriptHex: output.revealScriptHex,
+    owner: input.premintRecipient,
+    ownerScheme: input.premintOwnerScheme,
+    borrowScheme: 0,
+    borrowGuard: input.borrowGuard,
+    extensionCommitment: output.extensionCommitment,
+    tokenAmount: tokenAmount.toString(),
+  };
+}
+
+function requireMintPolicy(value: number): number {
+  if (!Number.isInteger(value) || value < 0 || value > 2) {
+    throw new Error("KCC20 deploy receipt mintPolicy must be 0, 1, or 2");
+  }
+  return value;
+}
+
+function assertUniqueOutputIndexes(
+  outputs: readonly Kcc20DeployReceiptOutput[],
+): void {
+  const indexes = new Set<number>();
+  for (const output of outputs) {
+    if (!Number.isInteger(output.index) || output.index < 0) {
+      throw new Error("KCC20 deploy receipt output index must be nonnegative");
+    }
+    if (indexes.has(output.index)) {
+      throw new Error("KCC20 deploy receipt output indexes must be unique");
+    }
+    indexes.add(output.index);
+  }
+}
+
+function unsignedInteger(value: string | bigint, label: string): bigint {
+  const raw = String(value);
+  if (!/^(0|[1-9][0-9]*)$/.test(raw)) {
+    throw new Error(`${label} must be an unsigned integer`);
+  }
+  return BigInt(raw);
+}