@kaspacom/kcc20-tx-builder 0.2.5 → 0.5.0

package/artifacts/snapshot-standards.lock.json

@@ -0,0 +1,56 @@
+{
+  "schema": "kaspacom-contract-standards-lock/v1",
+  "reviewedAt": "2026-09-10",
+  "kccs": {
+    "repository": "https://github.com/kaspanet/kccs",
+    "commit": "54f4f9c2730f77ec5b1ee8bc746d7f94d83b8ee6",
+    "documents": [
+      "kcc-0001.md",
+      "kcc-0002.md",
+      "kcc-0020.md",
+      "kcc-0020/borrowed-receive-authorization.md"
+    ]
+  },
+  "kip20": {
+    "repository": "https://github.com/kaspanet/kips",
+    "document": "kip-0020.md"
+  },
+  "silverscript": {
+    "repository": "https://github.com/kaspanet/silverscript",
+    "baseCommit": "140bf184fd03dc0f5c29155f89e9e5d733a1152f",
+    "requiredPullRequests": [164, 217],
+    "requiredCommits": [
+      "97e5d7930aa7760bf9323f6f7011dce338ac38a7",
+      "7cf57773a2818675022a65374c602dcc141ea491"
+    ],
+    "requiredPatches": [
+      {
+        "path": "compiler-patches/0001-fix-debugger-preserve-explicit-covenant-witnesses.patch.gz",
+        "sha256": "6090d20a7f12333f1850d5a93c53ffcfc52dedfb6d193527287ec0efe7b04867"
+      },
+      {
+        "path": "compiler-patches/0002-test-compiler-cover-KCC1-dispatch-with-ECDSA.patch.gz",
+        "sha256": "29b2a7f476387e73242966bf31c87c769d1d1daba5ba376da9c6eaa239b6f485"
+      }
+    ],
+    "integrationTree": "d59eaab16114957c16de7c7198b7080e6db0126b"
+  },
+  "silverscriptKcc20": {
+    "repository": "https://github.com/kaspanet/silverscript",
+    "tag": "v1.0.0",
+    "commit": "3ed973335b59269293564805cc2c58a14595ec03",
+    "tree": "2a30f522768d9b4cae6fe30014326c689a25bd41",
+    "releaseAsset": "silverc-linux-x86_64.tar.gz",
+    "releaseAssetSha256": "058ffa17a390526f27280752f864b1bd680217cded14dfc5b7fd168d7e943fb5",
+    "releaseAssets": {
+      "linux-x64": {
+        "name": "silverc-linux-x86_64.tar.gz",
+        "sha256": "058ffa17a390526f27280752f864b1bd680217cded14dfc5b7fd168d7e943fb5"
+      },
+      "win32-x64": {
+        "name": "silverc-windows-x86_64.zip",
+        "sha256": "3e0d660c15a9e7ac90f3960da24d348b076b1891481bfe758db18accc8a102e1"
+      }
+    }
+  }
+}

package/dist/artifacts.d.ts

@@ -2,12 +2,43 @@ import type { ArtifactDescriptor, BuildContext } from "./models.js";
 /** The only native KCC20 artifact used to build new transactions. */
 export declare const KCC20_CURRENT_NATIVE_ARTIFACT_KEY: "KCC20.placeholder.json";
 export declare const KCC20_ARTIFACT_SCRIPT_SHA256: Readonly<{
+    "KCC20SnapshotBootstrap.placeholder.json": "85edea7401eb415c447e6a0d0a45e1667802a269dde9fbe33d5881c4a4de51e2";
+    "KCC20SnapshotController.placeholder.json": "8f90525afcc1c23240f1d18eed30b3b377a72a323e8b48925dfac53bd5aab0ae";
     "KCC20.placeholder.json": "4633b082f26adbf14600b767d6e2146e36ce67d63d8202c0281857922c05ac41";
     "KCC20FeeTicket.placeholder.json": "ed81365466ee4c44db1210b3360783af8145f74e49e847848195e09c71ad6930";
     "KCC20Orderbook.placeholder.json": "ef9fe81ff7aa2dc2df118d8d7cc126aca6f2f9c181b9c2d15727a538b23c6f71";
     "KCC20Wrapper.placeholder.json": "f3bdf09be9aa258708a306283a4278a93cfb64f35fc50ed7d316b9b189ef9030";
     "KCC20Vesting.placeholder.json": "1b84d74aa01b6a50edbff5bf1f9e988a5a6a00ec645458dfd3912ac532b77c33";
 }>;
+/**
+ * Canonical raw artifact pins and structural metadata for signerless snapshot
+ * migrations. Consumers must use these values instead of maintaining their
+ * own copies; the raw SHA-256 pins cover the exact packaged JSON bytes.
+ */
+export declare const KCC20_SNAPSHOT_ARTIFACT_PINS: Readonly<{
+    bootstrap: Readonly<{
+        key: "KCC20SnapshotBootstrap.placeholder.json";
+        contractName: "KCC20SnapshotBootstrap";
+        artifactSha256: "bc566a964b5feb1c2055d5130af25951142d695472287b888c5537e9a56ee3d2";
+        scriptLength: 33718;
+        stateStart: 1;
+        stateLength: 405;
+    }>;
+    controller: Readonly<{
+        key: "KCC20SnapshotController.placeholder.json";
+        contractName: "KCC20SnapshotController";
+        artifactSha256: "f0d7b082e0680a90736948cd6658ccbc8600e097d9b4d5568013acdaafb39bf5";
+        scriptLength: 15297;
+        stateStart: 1;
+        stateLength: 432;
+    }>;
+}>;
+/** Canonical KCC20 template committed by both snapshot contracts. */
+export declare const KCC20_SNAPSHOT_TOKEN_TEMPLATE_PIN: Readonly<{
+    hash: "911f0638ccb7368bf36d117f1725073ae7ee487ce8b58ca3e8375051c2d40f6c";
+    prefixLength: 1;
+    suffixLength: 25439;
+}>;
 export type Kcc20ArtifactKey = keyof typeof KCC20_ARTIFACT_SCRIPT_SHA256;
 export declare function isKcc20ArtifactKey(value: string): value is Kcc20ArtifactKey;
 export declare function assertKcc20ArtifactScriptHash(key: Kcc20ArtifactKey, artifact: unknown): void;

package/dist/artifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../src/artifacts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGpE,qEAAqE;AACrE,eAAO,MAAM,iCAAiC,EAC5C,wBAAiC,CAAC;AAEpC,eAAO,MAAM,4BAA4B;;;;;;EAWvC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,4BAA4B,CAAC;AAEzE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,gBAAgB,CAK3E;AAED,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,OAAO,GAChB,IAAI,CA6BN;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,MAAM,GACV,kBAAkB,CAUpB;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,kBAAkB,EAC5B,YAAY,EAAE,MAAM,GACnB,IAAI,CAQN"}
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../src/artifacts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGpE,qEAAqE;AACrE,eAAO,MAAM,iCAAiC,EAC5C,wBAAiC,CAAC;AAEpC,eAAO,MAAM,4BAA4B;;;;;;;;EAavC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;EAmBvC,CAAC;AAEH,qEAAqE;AACrE,eAAO,MAAM,iCAAiC;;;;EAI5C,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,4BAA4B,CAAC;AAEzE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,gBAAgB,CAK3E;AAED,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,OAAO,GAChB,IAAI,CA6BN;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,MAAM,GACV,kBAAkB,CAUpB;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,kBAAkB,EAC5B,YAAY,EAAE,MAAM,GACnB,IAAI,CAQN"}

package/dist/artifacts.js

@@ -3,12 +3,43 @@ 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";
 export const KCC20_ARTIFACT_SCRIPT_SHA256 = Object.freeze({
+    "KCC20SnapshotBootstrap.placeholder.json": "85edea7401eb415c447e6a0d0a45e1667802a269dde9fbe33d5881c4a4de51e2",
+    "KCC20SnapshotController.placeholder.json": "8f90525afcc1c23240f1d18eed30b3b377a72a323e8b48925dfac53bd5aab0ae",
     [KCC20_CURRENT_NATIVE_ARTIFACT_KEY]: "4633b082f26adbf14600b767d6e2146e36ce67d63d8202c0281857922c05ac41",
     "KCC20FeeTicket.placeholder.json": "ed81365466ee4c44db1210b3360783af8145f74e49e847848195e09c71ad6930",
     "KCC20Orderbook.placeholder.json": "ef9fe81ff7aa2dc2df118d8d7cc126aca6f2f9c181b9c2d15727a538b23c6f71",
     "KCC20Wrapper.placeholder.json": "f3bdf09be9aa258708a306283a4278a93cfb64f35fc50ed7d316b9b189ef9030",
     "KCC20Vesting.placeholder.json": "1b84d74aa01b6a50edbff5bf1f9e988a5a6a00ec645458dfd3912ac532b77c33",
 });
+/**
+ * Canonical raw artifact pins and structural metadata for signerless snapshot
+ * migrations. Consumers must use these values instead of maintaining their
+ * own copies; the raw SHA-256 pins cover the exact packaged JSON bytes.
+ */
+export const KCC20_SNAPSHOT_ARTIFACT_PINS = Object.freeze({
+    bootstrap: Object.freeze({
+        key: "KCC20SnapshotBootstrap.placeholder.json",
+        contractName: "KCC20SnapshotBootstrap",
+        artifactSha256: "bc566a964b5feb1c2055d5130af25951142d695472287b888c5537e9a56ee3d2",
+        scriptLength: 33718,
+        stateStart: 1,
+        stateLength: 405,
+    }),
+    controller: Object.freeze({
+        key: "KCC20SnapshotController.placeholder.json",
+        contractName: "KCC20SnapshotController",
+        artifactSha256: "f0d7b082e0680a90736948cd6658ccbc8600e097d9b4d5568013acdaafb39bf5",
+        scriptLength: 15297,
+        stateStart: 1,
+        stateLength: 432,
+    }),
+});
+/** Canonical KCC20 template committed by both snapshot contracts. */
+export const KCC20_SNAPSHOT_TOKEN_TEMPLATE_PIN = Object.freeze({
+    hash: "911f0638ccb7368bf36d117f1725073ae7ee487ce8b58ca3e8375051c2d40f6c",
+    prefixLength: 1,
+    suffixLength: 25439,
+});
 export function isKcc20ArtifactKey(value) {
     return Object.prototype.hasOwnProperty.call(KCC20_ARTIFACT_SCRIPT_SHA256, value);
 }

package/dist/artifacts.js.map

@@ -1 +1 @@
-{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../src/artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,qEAAqE;AACrE,MAAM,CAAC,MAAM,iCAAiC,GAC5C,wBAAiC,CAAC;AAEpC,MAAM,CAAC,MAAM,4BAA4B,GAAG,MAAM,CAAC,MAAM,CAAC;IACxD,CAAC,iCAAiC,CAAC,EACjC,kEAAkE;IACpE,iCAAiC,EAC/B,kEAAkE;IACpE,iCAAiC,EAC/B,kEAAkE;IACpE,+BAA+B,EAC7B,kEAAkE;IACpE,+BAA+B,EAC7B,kEAAkE;CACrE,CAAC,CAAC;AAIH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CACzC,4BAA4B,EAC5B,KAAK,CACN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,GAAqB,EACrB,QAAiB;IAEjB,MAAM,MAAM,GAAI,QAAwC,EAAE,MAAM,CAAC;IACjE,MAAM,KAAK,GACT,MAAM,YAAY,UAAU;QAC1B,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YACnB,MAAM,CAAC,KAAK,CACV,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,CAC9D;YACH,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;YACzB,CAAC,CAAC,IAAI,CAAC;IACb,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,iBAAiB,CACzB,mBAAmB,EACnB,2CAA2C,GAAG,EAAE,EAChD,EAAE,WAAW,EAAE,GAAG,EAAE,CACrB,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;SAClC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SACjD,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,MAAM,YAAY,GAAG,4BAA4B,CAAC,GAAG,CAAC,CAAC;IACvD,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;QAChC,MAAM,IAAI,iBAAiB,CACzB,mBAAmB,EACnB,uCAAuC,GAAG,EAAE,EAC5C,EAAE,WAAW,EAAE,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,CAC/C,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,OAAqB,EACrB,GAAW;IAEX,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,iBAAiB,CACzB,mBAAmB,EACnB,0CAA0C,GAAG,EAAE,EAC/C,EAAE,WAAW,EAAE,GAAG,EAAE,CACrB,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,QAA4B,EAC5B,YAAoB;IAEpB,IAAI,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,WAAW,EAAE,EAAE,CAAC;QAC/D,MAAM,IAAI,iBAAiB,CACzB,mBAAmB,EACnB,uCAAuC,QAAQ,CAAC,GAAG,EAAE,EACrD,EAAE,WAAW,EAAE,QAAQ,CAAC,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,CAAC,IAAI,EAAE,CACvE,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../src/artifacts.ts"],"names":[],"mappings":"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"}

package/dist/cjs/artifacts.d.ts

@@ -2,12 +2,43 @@ import type { ArtifactDescriptor, BuildContext } from "./models.js";
 /** The only native KCC20 artifact used to build new transactions. */
 export declare const KCC20_CURRENT_NATIVE_ARTIFACT_KEY: "KCC20.placeholder.json";
 export declare const KCC20_ARTIFACT_SCRIPT_SHA256: Readonly<{
+    "KCC20SnapshotBootstrap.placeholder.json": "85edea7401eb415c447e6a0d0a45e1667802a269dde9fbe33d5881c4a4de51e2";
+    "KCC20SnapshotController.placeholder.json": "8f90525afcc1c23240f1d18eed30b3b377a72a323e8b48925dfac53bd5aab0ae";
     "KCC20.placeholder.json": "4633b082f26adbf14600b767d6e2146e36ce67d63d8202c0281857922c05ac41";
     "KCC20FeeTicket.placeholder.json": "ed81365466ee4c44db1210b3360783af8145f74e49e847848195e09c71ad6930";
     "KCC20Orderbook.placeholder.json": "ef9fe81ff7aa2dc2df118d8d7cc126aca6f2f9c181b9c2d15727a538b23c6f71";
     "KCC20Wrapper.placeholder.json": "f3bdf09be9aa258708a306283a4278a93cfb64f35fc50ed7d316b9b189ef9030";
     "KCC20Vesting.placeholder.json": "1b84d74aa01b6a50edbff5bf1f9e988a5a6a00ec645458dfd3912ac532b77c33";
 }>;
+/**
+ * Canonical raw artifact pins and structural metadata for signerless snapshot
+ * migrations. Consumers must use these values instead of maintaining their
+ * own copies; the raw SHA-256 pins cover the exact packaged JSON bytes.
+ */
+export declare const KCC20_SNAPSHOT_ARTIFACT_PINS: Readonly<{
+    bootstrap: Readonly<{
+        key: "KCC20SnapshotBootstrap.placeholder.json";
+        contractName: "KCC20SnapshotBootstrap";
+        artifactSha256: "bc566a964b5feb1c2055d5130af25951142d695472287b888c5537e9a56ee3d2";
+        scriptLength: 33718;
+        stateStart: 1;
+        stateLength: 405;
+    }>;
+    controller: Readonly<{
+        key: "KCC20SnapshotController.placeholder.json";
+        contractName: "KCC20SnapshotController";
+        artifactSha256: "f0d7b082e0680a90736948cd6658ccbc8600e097d9b4d5568013acdaafb39bf5";
+        scriptLength: 15297;
+        stateStart: 1;
+        stateLength: 432;
+    }>;
+}>;
+/** Canonical KCC20 template committed by both snapshot contracts. */
+export declare const KCC20_SNAPSHOT_TOKEN_TEMPLATE_PIN: Readonly<{
+    hash: "911f0638ccb7368bf36d117f1725073ae7ee487ce8b58ca3e8375051c2d40f6c";
+    prefixLength: 1;
+    suffixLength: 25439;
+}>;
 export type Kcc20ArtifactKey = keyof typeof KCC20_ARTIFACT_SCRIPT_SHA256;
 export declare function isKcc20ArtifactKey(value: string): value is Kcc20ArtifactKey;
 export declare function assertKcc20ArtifactScriptHash(key: Kcc20ArtifactKey, artifact: unknown): void;

package/dist/cjs/artifacts.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.KCC20_ARTIFACT_SCRIPT_SHA256 = exports.KCC20_CURRENT_NATIVE_ARTIFACT_KEY = void 0;
+exports.KCC20_SNAPSHOT_TOKEN_TEMPLATE_PIN = exports.KCC20_SNAPSHOT_ARTIFACT_PINS = exports.KCC20_ARTIFACT_SCRIPT_SHA256 = exports.KCC20_CURRENT_NATIVE_ARTIFACT_KEY = void 0;
 exports.isKcc20ArtifactKey = isKcc20ArtifactKey;
 exports.assertKcc20ArtifactScriptHash = assertKcc20ArtifactScriptHash;
 exports.requireArtifact = requireArtifact;
@@ -10,12 +10,43 @@ const sha256_1 = require("@noble/hashes/sha256");
 /** The only native KCC20 artifact used to build new transactions. */
 exports.KCC20_CURRENT_NATIVE_ARTIFACT_KEY = "KCC20.placeholder.json";
 exports.KCC20_ARTIFACT_SCRIPT_SHA256 = Object.freeze({
+    "KCC20SnapshotBootstrap.placeholder.json": "85edea7401eb415c447e6a0d0a45e1667802a269dde9fbe33d5881c4a4de51e2",
+    "KCC20SnapshotController.placeholder.json": "8f90525afcc1c23240f1d18eed30b3b377a72a323e8b48925dfac53bd5aab0ae",
     [exports.KCC20_CURRENT_NATIVE_ARTIFACT_KEY]: "4633b082f26adbf14600b767d6e2146e36ce67d63d8202c0281857922c05ac41",
     "KCC20FeeTicket.placeholder.json": "ed81365466ee4c44db1210b3360783af8145f74e49e847848195e09c71ad6930",
     "KCC20Orderbook.placeholder.json": "ef9fe81ff7aa2dc2df118d8d7cc126aca6f2f9c181b9c2d15727a538b23c6f71",
     "KCC20Wrapper.placeholder.json": "f3bdf09be9aa258708a306283a4278a93cfb64f35fc50ed7d316b9b189ef9030",
     "KCC20Vesting.placeholder.json": "1b84d74aa01b6a50edbff5bf1f9e988a5a6a00ec645458dfd3912ac532b77c33",
 });
+/**
+ * Canonical raw artifact pins and structural metadata for signerless snapshot
+ * migrations. Consumers must use these values instead of maintaining their
+ * own copies; the raw SHA-256 pins cover the exact packaged JSON bytes.
+ */
+exports.KCC20_SNAPSHOT_ARTIFACT_PINS = Object.freeze({
+    bootstrap: Object.freeze({
+        key: "KCC20SnapshotBootstrap.placeholder.json",
+        contractName: "KCC20SnapshotBootstrap",
+        artifactSha256: "bc566a964b5feb1c2055d5130af25951142d695472287b888c5537e9a56ee3d2",
+        scriptLength: 33718,
+        stateStart: 1,
+        stateLength: 405,
+    }),
+    controller: Object.freeze({
+        key: "KCC20SnapshotController.placeholder.json",
+        contractName: "KCC20SnapshotController",
+        artifactSha256: "f0d7b082e0680a90736948cd6658ccbc8600e097d9b4d5568013acdaafb39bf5",
+        scriptLength: 15297,
+        stateStart: 1,
+        stateLength: 432,
+    }),
+});
+/** Canonical KCC20 template committed by both snapshot contracts. */
+exports.KCC20_SNAPSHOT_TOKEN_TEMPLATE_PIN = Object.freeze({
+    hash: "911f0638ccb7368bf36d117f1725073ae7ee487ce8b58ca3e8375051c2d40f6c",
+    prefixLength: 1,
+    suffixLength: 25439,
+});
 function isKcc20ArtifactKey(value) {
     return Object.prototype.hasOwnProperty.call(exports.KCC20_ARTIFACT_SCRIPT_SHA256, value);
 }

package/dist/cjs/artifacts.js.map

@@ -1 +1 @@
-{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/artifacts.ts"],"names":[],"mappings":";;;AAuBA,gDAKC;AAED,sEAgCC;AAED,0CAaC;AAED,gDAWC;AA1FD,2CAAgD;AAEhD,iDAA8C;AAE9C,qEAAqE;AACxD,QAAA,iCAAiC,GAC5C,wBAAiC,CAAC;AAEvB,QAAA,4BAA4B,GAAG,MAAM,CAAC,MAAM,CAAC;IACxD,CAAC,yCAAiC,CAAC,EACjC,kEAAkE;IACpE,iCAAiC,EAC/B,kEAAkE;IACpE,iCAAiC,EAC/B,kEAAkE;IACpE,+BAA+B,EAC7B,kEAAkE;IACpE,+BAA+B,EAC7B,kEAAkE;CACrE,CAAC,CAAC;AAIH,SAAgB,kBAAkB,CAAC,KAAa;IAC9C,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CACzC,oCAA4B,EAC5B,KAAK,CACN,CAAC;AACJ,CAAC;AAED,SAAgB,6BAA6B,CAC3C,GAAqB,EACrB,QAAiB;IAEjB,MAAM,MAAM,GAAI,QAAwC,EAAE,MAAM,CAAC;IACjE,MAAM,KAAK,GACT,MAAM,YAAY,UAAU;QAC1B,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YACnB,MAAM,CAAC,KAAK,CACV,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,CAC9D;YACH,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;YACzB,CAAC,CAAC,IAAI,CAAC;IACb,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,6BAAiB,CACzB,mBAAmB,EACnB,2CAA2C,GAAG,EAAE,EAChD,EAAE,WAAW,EAAE,GAAG,EAAE,CACrB,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GAAG,CAAC,GAAG,IAAA,eAAM,EAAC,KAAK,CAAC,CAAC;SAClC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SACjD,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,MAAM,YAAY,GAAG,oCAA4B,CAAC,GAAG,CAAC,CAAC;IACvD,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;QAChC,MAAM,IAAI,6BAAiB,CACzB,mBAAmB,EACnB,uCAAuC,GAAG,EAAE,EAC5C,EAAE,WAAW,EAAE,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,CAC/C,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAgB,eAAe,CAC7B,OAAqB,EACrB,GAAW;IAEX,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,6BAAiB,CACzB,mBAAmB,EACnB,0CAA0C,GAAG,EAAE,EAC/C,EAAE,WAAW,EAAE,GAAG,EAAE,CACrB,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAgB,kBAAkB,CAChC,QAA4B,EAC5B,YAAoB;IAEpB,IAAI,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,WAAW,EAAE,EAAE,CAAC;QAC/D,MAAM,IAAI,6BAAiB,CACzB,mBAAmB,EACnB,uCAAuC,QAAQ,CAAC,GAAG,EAAE,EACrD,EAAE,WAAW,EAAE,QAAQ,CAAC,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,CAAC,IAAI,EAAE,CACvE,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/artifacts.ts"],"names":[],"mappings":"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"}

package/dist/cjs/engine.js

@@ -6,6 +6,7 @@ const sha256_1 = require("@noble/hashes/sha256");
 const sale_common_js_1 = require("./sale-common.js");
 const abi_js_1 = require("./abi.js");
 const operations_js_1 = require("./operations.js");
+const snapshot_operation_js_1 = require("./snapshot-operation.js");
 const protocol_js_1 = require("./protocol.js");
 const deploy_receipt_js_1 = require("./deploy-receipt.js");
 const artifacts_js_1 = require("./artifacts.js");
@@ -40,20 +41,16 @@ function createKcc20PsktBuilderEngine(options) {
             throw new Error("No source provider or RPC client was supplied to the KCC20 builder");
         }
     }
-    const kaspaWasm = new Proxy(options.wasm, {
-        get(target, property, receiver) {
-            if (property === "RpcClient")
-                return InjectedRpcClient;
-            return Reflect.get(target, property, receiver);
-        },
-    });
+    // Bundlers can freeze module namespace exports. A Proxy cannot replace a
+    // non-configurable RpcClient property; copy the host exports before adapting it.
+    const kaspaWasm = { ...options.wasm, RpcClient: InjectedRpcClient };
     const INPUT_SCHEMA = "kcc20-in-process-pskt-builder-input/v1";
     const OUTPUT_SCHEMA = "kcc20-in-process-pskt-builder-output/v1";
     const DEFAULT_DEPLOY_TKAS = 1;
     const DEFAULT_PRIORITY_FEE = 10000n;
     const DEFAULT_MATCHER_PRIORITY_FEE = 30000000n;
     const DEFAULT_WRAPPER_DEPLOY_PRIORITY_FEE = 10000000n;
-    const DEFAULT_WRPC_URL = "ws://65.108.107.30:17210";
+    const DEFAULT_WRPC_URL = "wss://tn10-node.kaspa.com/testnet-10";
     const MIN_FILL_GROSS_SOMPI = 50000000n;
     const MIN_RELAY_FEE_PER_MASS_SOMPI = 100n;
     const TOCCATA_COMPUTE_BUDGET_MASS_PER_UNIT = 100n;
@@ -116,7 +113,10 @@ function createKcc20PsktBuilderEngine(options) {
                 .then((artifact) => {
                 if (!artifact)
                     throw new Error(`Missing supplied KCC20 artifact: ${path}`);
-                const normalized = (0, abi_js_1.normalizeSilverScriptArtifact)(artifact);
+                const artifactValue = artifact && typeof artifact === "object" && !Array.isArray(artifact)
+                    ? (artifact.artifact ?? artifact)
+                    : artifact;
+                const normalized = (0, abi_js_1.normalizeSilverScriptArtifact)(artifactValue);
                 (0, artifacts_js_1.assertKcc20ArtifactScriptHash)(path, normalized);
                 return normalized;
             })
@@ -294,6 +294,15 @@ function createKcc20PsktBuilderEngine(options) {
     function covenantScriptBuilder(kw) {
         return new kw.ScriptBuilder({ flags: { covenantsEnabled: true } });
     }
+    const buildSnapshotMigrationPskt = (0, snapshot_operation_js_1.createKcc20SnapshotPsktBuilder)({
+        wasm: options.wasm,
+        artifacts: options.artifacts,
+        artifactProvider: options.artifactProvider,
+        config: options.config,
+        sourceProvider: options.sourceProvider,
+        rpcClientFactory: options.rpcClientFactory,
+        transactionWithCalculatedFeeChange,
+    });
     const psktBuilderByKey = Object.freeze({
         "kcc20.deploy-token": buildKcc20DeployPskt,
         "kcc20.mint": buildKcc20MintPskt,
@@ -319,6 +328,10 @@ function createKcc20PsktBuilderEngine(options) {
         "kcc20orderbook.cancel-ask": buildWrappedCancelPskt,
         "kcc20orderbook.cancel-bid": buildWrappedCancelPskt,
         "kcc20orderbook.matcher-settle-crossed": buildWrappedCrossMatchPskt,
+        "kcc20-snapshot.deploy-bootstrap": buildSnapshotMigrationPskt,
+        "kcc20-snapshot.deploy-controller": buildSnapshotMigrationPskt,
+        "kcc20-snapshot.start": buildSnapshotMigrationPskt,
+        "kcc20-snapshot.claim": buildSnapshotMigrationPskt,
     });
     const missingBuilderKeys = operations_js_1.KCC20_BUILDER_KEYS.filter((builderKey) => !psktBuilderByKey[builderKey]);
     if (missingBuilderKeys.length) {
@@ -1851,8 +1864,7 @@ function createKcc20PsktBuilderEngine(options) {
         const rpcUrl = env.KASPA_WRPC_URL || DEFAULT_WRPC_URL;
         const tokenOutputSompi = parseU64(env.KCC20_WRAP_TOKEN_OUTPUT_SOMPI ||
             sale_common_js_1.DEFAULT_TOKEN_OUTPUT_SOMPI.toString(), "tokenOutputSompi");
-        const priorityFee = parseU64(env.KCC20_WRAP_PRIORITY_FEE_SOMPI ||
-            DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
+        const priorityFee = parseU64(env.KCC20_WRAP_PRIORITY_FEE_SOMPI || DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
         const computeBudget = parsePositiveNumber(env.KCC20_WRAP_COMPUTE_BUDGET || 700, "computeBudget");
         const [wrapperArtifacts, wrappedArtifacts] = await Promise.all([
             readWrapperArtifacts(),
@@ -2122,8 +2134,7 @@ function createKcc20PsktBuilderEngine(options) {
         const rpcUrl = env.KASPA_WRPC_URL || DEFAULT_WRPC_URL;
         const tokenOutputSompi = parseU64(env.KCC20_UNWRAP_TOKEN_OUTPUT_SOMPI ||
             sale_common_js_1.DEFAULT_TOKEN_OUTPUT_SOMPI.toString(), "tokenOutputSompi");
-        const priorityFee = parseU64(env.KCC20_UNWRAP_PRIORITY_FEE_SOMPI ||
-            DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
+        const priorityFee = parseU64(env.KCC20_UNWRAP_PRIORITY_FEE_SOMPI || DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
         const computeBudget = parsePositiveNumber(env.KCC20_UNWRAP_COMPUTE_BUDGET || 700, "computeBudget");
         const [wrapperArtifacts, wrappedArtifacts] = await Promise.all([
             readWrapperArtifacts(),
@@ -2451,8 +2462,7 @@ function createKcc20PsktBuilderEngine(options) {
         const rpcUrl = env.KASPA_WRPC_URL || DEFAULT_WRPC_URL;
         const tokenOutputSompi = parseU64(env.KCC20_ORDER_TOKEN_OUTPUT_SOMPI ||
             sale_common_js_1.DEFAULT_TOKEN_OUTPUT_SOMPI.toString(), "tokenOutputSompi");
-        const priorityFee = parseU64(env.KCC20_ORDER_PRIORITY_FEE_SOMPI ||
-            DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
+        const priorityFee = parseU64(env.KCC20_ORDER_PRIORITY_FEE_SOMPI || DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
         const computeBudget = parsePositiveNumber(env.KCC20_ORDER_COMPUTE_BUDGET || 700, "computeBudget");
         const wrappedArtifacts = await readWrappedArtifacts();
         const activeUtxo = isBid ? rootUtxo : holderUtxo;
@@ -2698,8 +2708,7 @@ function createKcc20PsktBuilderEngine(options) {
         const rpcUrl = env.KASPA_WRPC_URL || DEFAULT_WRPC_URL;
         const tokenOutputSompi = parseU64(env.KCC20_FILL_TOKEN_OUTPUT_SOMPI ||
             sale_common_js_1.DEFAULT_TOKEN_OUTPUT_SOMPI.toString(), "tokenOutputSompi");
-        const priorityFee = parseU64(env.KCC20_FILL_PRIORITY_FEE_SOMPI ||
-            DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
+        const priorityFee = parseU64(env.KCC20_FILL_PRIORITY_FEE_SOMPI || DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
         const computeBudget = parsePositiveNumber(env.KCC20_FILL_COMPUTE_BUDGET || 800, "computeBudget");
         const wrappedArtifacts = await readWrappedArtifacts();
         const ticketArtifacts = ticketUtxo ? await readFeeTicketArtifacts() : null;
@@ -2983,8 +2992,7 @@ function createKcc20PsktBuilderEngine(options) {
         const rpcUrl = env.KASPA_WRPC_URL || DEFAULT_WRPC_URL;
         const tokenOutputSompi = parseU64(env.KCC20_FILL_TOKEN_OUTPUT_SOMPI ||
             sale_common_js_1.DEFAULT_TOKEN_OUTPUT_SOMPI.toString(), "tokenOutputSompi");
-        const priorityFee = parseU64(env.KCC20_FILL_PRIORITY_FEE_SOMPI ||
-            DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
+        const priorityFee = parseU64(env.KCC20_FILL_PRIORITY_FEE_SOMPI || DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
         const computeBudget = parsePositiveNumber(env.KCC20_FILL_COMPUTE_BUDGET || 800, "computeBudget");
         const wrappedArtifacts = await readWrappedArtifacts();
         const ticketArtifacts = ticketUtxo ? await readFeeTicketArtifacts() : null;
@@ -3389,8 +3397,7 @@ function createKcc20PsktBuilderEngine(options) {
         const rpcUrl = env.KASPA_WRPC_URL || DEFAULT_WRPC_URL;
         const tokenOutputSompi = parseU64(env.KCC20_FILL_TOKEN_OUTPUT_SOMPI ||
             sale_common_js_1.DEFAULT_TOKEN_OUTPUT_SOMPI.toString(), "tokenOutputSompi");
-        const priorityFee = parseU64(env.KCC20_FILL_PRIORITY_FEE_SOMPI ||
-            DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
+        const priorityFee = parseU64(env.KCC20_FILL_PRIORITY_FEE_SOMPI || DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
         const wrappedArtifacts = await readWrappedArtifacts();
         const ticketArtifacts = params.feeTicketId
             ? await readFeeTicketArtifacts()
@@ -3752,8 +3759,7 @@ function createKcc20PsktBuilderEngine(options) {
         const rpcUrl = env.KASPA_WRPC_URL || DEFAULT_WRPC_URL;
         const tokenOutputSompi = parseU64(env.KCC20_FILL_TOKEN_OUTPUT_SOMPI ||
             sale_common_js_1.DEFAULT_TOKEN_OUTPUT_SOMPI.toString(), "tokenOutputSompi");
-        const priorityFee = parseU64(env.KCC20_FILL_PRIORITY_FEE_SOMPI ||
-            DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
+        const priorityFee = parseU64(env.KCC20_FILL_PRIORITY_FEE_SOMPI || DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
         const wrappedArtifacts = await readWrappedArtifacts();
         const wrappedArtifact = wrappedArtifacts[0].artifact;
         const ticketArtifacts = params.feeTicketId
@@ -4249,8 +4255,7 @@ function createKcc20PsktBuilderEngine(options) {
         const rpcUrl = env.KASPA_WRPC_URL || DEFAULT_WRPC_URL;
         const configuredTokenOutputSompi = parseU64(env.KCC20_FILL_TOKEN_OUTPUT_SOMPI ||
             sale_common_js_1.DEFAULT_TOKEN_OUTPUT_SOMPI.toString(), "tokenOutputSompi");
-        const priorityFee = parseU64(env.KCC20_FILL_PRIORITY_FEE_SOMPI ||
-            DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
+        const priorityFee = parseU64(env.KCC20_FILL_PRIORITY_FEE_SOMPI || DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
         const wrappedArtifacts = await readWrappedArtifacts();
         const ticketArtifacts = params.feeTicketId
             ? await readFeeTicketArtifacts()
@@ -4984,9 +4989,7 @@ function createKcc20PsktBuilderEngine(options) {
             DEFAULT_MATCHER_PRIORITY_FEE.toString(), "priorityFee");
         const networkFeeReserve = parseU64(env.KCC20_MATCHER_NETWORK_FEE_RESERVE_SOMPI || "5000000", "networkFeeReserve");
         const transactionFeeReserve = priorityFee + networkFeeReserve;
-        const computeBudget = parsePositiveNumber(env.KCC20_MATCHER_COMPUTE_BUDGET ||
-            env.KCC20_FILL_COMPUTE_BUDGET ||
-            800, "computeBudget");
+        const computeBudget = parsePositiveNumber(env.KCC20_MATCHER_COMPUTE_BUDGET || env.KCC20_FILL_COMPUTE_BUDGET || 800, "computeBudget");
         const privateKeyHex = String(env.KCC20_WRAPPER_OPERATOR_PRIVATE_KEY || "")
             .trim()
             .replace(/^0x/i, "");
@@ -5436,8 +5439,7 @@ function createKcc20PsktBuilderEngine(options) {
         const network = request.network || env.KASPA_NETWORK || "testnet-10";
         const walletAddress = requireKaspaAddress(request.owner?.walletAddress);
         const rpcUrl = env.KASPA_WRPC_URL || DEFAULT_WRPC_URL;
-        const priorityFee = parseU64(env.KCC20_CANCEL_PRIORITY_FEE_SOMPI ||
-            DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
+        const priorityFee = parseU64(env.KCC20_CANCEL_PRIORITY_FEE_SOMPI || DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
         const computeBudget = parsePositiveNumber(env.KCC20_CANCEL_COMPUTE_BUDGET || 800, "computeBudget");
         const wrappedArtifacts = await readWrappedArtifacts();
         const orderState = kcc20V3WrappedStateFromUtxo(orderUtxo, canonicalTokenId, request.owner);
@@ -5655,8 +5657,7 @@ function createKcc20PsktBuilderEngine(options) {
         const rpcUrl = env.KASPA_WRPC_URL || DEFAULT_WRPC_URL;
         const tokenOutputSompi = assertKcc20TokenOutputSompi(parseU64(env.KCC20_MINT_TOKEN_OUTPUT_SOMPI ||
             sale_common_js_1.DEFAULT_TOKEN_OUTPUT_SOMPI.toString(), "tokenOutputSompi"), "mint");
-        const priorityFee = parseU64(env.KCC20_MINT_PRIORITY_FEE_SOMPI ||
-            DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
+        const priorityFee = parseU64(env.KCC20_MINT_PRIORITY_FEE_SOMPI || DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
         const computeBudget = parsePositiveNumber(env.KCC20_MINT_COMPUTE_BUDGET || sale_common_js_1.DEFAULT_COMPUTE_BUDGET, "computeBudget");
         const inputState = {
             amount: 0n,
@@ -5986,8 +5987,7 @@ function createKcc20PsktBuilderEngine(options) {
         }
         const priorityFee = parseU64(env.KCC20_MINT_AVAILABILITY_PRIORITY_FEE_SOMPI ||
             DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
-        const computeBudget = parsePositiveNumber(env.KCC20_MINT_AVAILABILITY_COMPUTE_BUDGET ||
-            sale_common_js_1.DEFAULT_COMPUTE_BUDGET, "computeBudget");
+        const computeBudget = parsePositiveNumber(env.KCC20_MINT_AVAILABILITY_COMPUTE_BUDGET || sale_common_js_1.DEFAULT_COMPUTE_BUDGET, "computeBudget");
         const rpc = new kaspaWasm.RpcClient({
             url: env.KASPA_WRPC_URL || DEFAULT_WRPC_URL,
             encoding: kaspaWasm.Encoding.Borsh,
@@ -6336,8 +6336,7 @@ function createKcc20PsktBuilderEngine(options) {
         const network = request.network || env.KASPA_NETWORK || "testnet-10";
         const walletAddress = requireKaspaAddress(request.owner?.walletAddress);
         const rpcUrl = env.KASPA_WRPC_URL || DEFAULT_WRPC_URL;
-        const priorityFee = parseU64(env.KCC20_REVEAL_PRIORITY_FEE_SOMPI ||
-            DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
+        const priorityFee = parseU64(env.KCC20_REVEAL_PRIORITY_FEE_SOMPI || DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
         const computeBudget = parsePositiveNumber(env.KCC20_REVEAL_COMPUTE_BUDGET || sale_common_js_1.DEFAULT_COMPUTE_BUDGET, "computeBudget");
         const inputState = kcc20StateFromUtxo(activeTokenUtxo, request.owner);
         if (inputState.isMintAuthority) {
@@ -6478,8 +6477,7 @@ function createKcc20PsktBuilderEngine(options) {
         const rpcUrl = env.KASPA_WRPC_URL || DEFAULT_WRPC_URL;
         const tokenOutputSompi = assertKcc20TokenOutputSompi(parseU64(env.KCC20_TRANSFER_TOKEN_OUTPUT_SOMPI ||
             sale_common_js_1.DEFAULT_TOKEN_OUTPUT_SOMPI.toString(), "tokenOutputSompi"), "transfer");
-        const priorityFee = parseU64(env.KCC20_TRANSFER_PRIORITY_FEE_SOMPI ||
-            DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
+        const priorityFee = parseU64(env.KCC20_TRANSFER_PRIORITY_FEE_SOMPI || DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
         const computeBudget = parsePositiveNumber(env.KCC20_TRANSFER_COMPUTE_BUDGET || sale_common_js_1.DEFAULT_COMPUTE_BUDGET, "computeBudget");
         const inputState = kcc20StateFromUtxo(activeHolderUtxo, request.owner);
         if (inputState.isMintAuthority || inputState.amount <= 0n) {
@@ -6529,7 +6527,18 @@ function createKcc20PsktBuilderEngine(options) {
             if (!tokenEntry) {
                 throw new Error(`active holder UTXO ${tokenTxid}:${tokenVout} not found`);
             }
-            const spendCovenantId = covenantIdFromUtxoEntry(tokenEntry) ?? covenantId;
+            const rpcScript = tokenEntry.scriptPublicKey ??
+                tokenEntry.entry?.scriptPublicKey ?? tokenEntry.utxoEntry?.scriptPublicKey;
+            if (!rpcScript || kw.addressFromScriptPublicKey(rpcScript, network)?.toString() !== tokenAddress) {
+                throw new Error("active holder RPC script does not match rebuilt covenant state");
+            }
+            if (activeHolderUtxo.amountSompi != null &&
+                BigInt(activeHolderUtxo.amountSompi) !== (0, sale_common_js_1.utxoAmountSompi)(tokenEntry)) {
+                throw new Error("active holder KAS amount does not match RPC");
+            }
+            const spendCovenantId = params.activeHolderNativeCovenantId
+                ? requireMatchingCovenantId(tokenEntry, covenantId, "active holder")
+                : covenantIdFromUtxoEntry(tokenEntry) ?? covenantId;
             let outputSompi = 0n;
             const recipientOutputIndex = 0;
             const outputs = [
@@ -6656,9 +6665,13 @@ function createKcc20PsktBuilderEngine(options) {
         const network = request.network || env.KASPA_NETWORK || "testnet-10";
         const walletAddress = requireKaspaAddress(request.owner?.walletAddress);
         const rpcUrl = env.KASPA_WRPC_URL || DEFAULT_WRPC_URL;
-        const amountTkas = parseAmountTkas(env.KCC20_DEPLOY_OUTPUT_TKAS || DEFAULT_DEPLOY_TKAS);
-        const priorityFee = parseU64(env.KCC20_DEPLOY_PRIORITY_FEE_SOMPI ||
-            DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
+        const requestedOutputSompi = params.outputSompi === undefined || params.outputSompi === null
+            ? undefined
+            : assertKcc20TokenOutputSompi(parseU64(params.outputSompi, "outputSompi"), "deploy");
+        const amountTkas = requestedOutputSompi === undefined
+            ? parseAmountTkas(env.KCC20_DEPLOY_OUTPUT_TKAS || DEFAULT_DEPLOY_TKAS)
+            : undefined;
+        const priorityFee = parseU64(env.KCC20_DEPLOY_PRIORITY_FEE_SOMPI || DEFAULT_PRIORITY_FEE.toString(), "priorityFee");
         const metadata = {
             ticker: normalizeTicker(params.ticker || ""),
             name: normalizeTokenName(params.tokenName || ""),
@@ -6757,7 +6770,8 @@ function createKcc20PsktBuilderEngine(options) {
         });
         const contractAddress = covenantOutputs[0].address;
         const canonicalCovenantId = (0, sale_common_js_1.p2shScriptHashHex)(kw, covenantOutputs[0].script);
-        const deploySompi = BigInt(Math.round(amountTkas * Number(sale_common_js_1.SOMPI_PER_TKAS)));
+        const deploySompi = requestedOutputSompi ??
+            BigInt(Math.round(amountTkas * Number(sale_common_js_1.SOMPI_PER_TKAS)));
         const premintOutputIndex = premintState ? covenantOutputs.length - 1 : null;
         const rpc = new RpcClient({
             url: rpcUrl,
@@ -6768,7 +6782,7 @@ function createKcc20PsktBuilderEngine(options) {
         try {
             const utxos = await getUtxosByAddresses(rpc, [walletAddress]);
             const outputSompi = deploySompi * BigInt(covenantOutputs.length);
-            const fundingEntry = (0, sale_common_js_1.selectFundingEntry)(utxos.entries, outputSompi + priorityFee + 10000000n);
+            const fundingEntry = (0, sale_common_js_1.selectFundingEntry)(utxos.entries, outputSompi + priorityFee + 10000000n, [], params.fundingOutpoint);
             const fundingChangeOutputIndex = covenantOutputs.length;
             const change = (0, sale_common_js_1.utxoAmountSompi)(fundingEntry) - outputSompi - priorityFee;
             if (change <= 10000n) {