@stacks/clarinet-sdk 3.23.1 → 3.24.0

package/dist/cjs/node/src/index.js

@@ -1,12 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.initSimnet = exports.tx = void 0;
+exports.DebugClient = exports.startDebugServer = exports.initSimnet = exports.tx = void 0;
 exports.getSDK = getSDK;
 exports.generateDeployement = generateDeployement;
 var sdkProxyHelpers_js_1 = require("../../common/src/sdkProxyHelpers.js");
 Object.defineProperty(exports, "tx", { enumerable: true, get: function () { return sdkProxyHelpers_js_1.tx; } });
 const vfs_js_1 = require("./vfs.js");
 const sdkProxy_js_1 = require("./sdkProxy.js");
+const syncDebugSocket_js_1 = require("./syncDebugSocket.js");
+const syncDebugSimnet_js_1 = require("./syncDebugSimnet.js");
 const wasmModule = import("@stacks/clarinet-sdk-wasm");
 // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt#use_within_json
 // @ts-ignore
@@ -34,7 +36,22 @@ async function generateDeployement(manifestPath = "./Clarinet.toml") {
 // load wasm only once and memoize it
 function memoizedInit() {
     let simnet = null;
+    // When CLARINET_DEBUG_PORT is set, a single debug proxy is shared across all calls.
+    let debugSimnet = null;
     return async (manifestPath = "./Clarinet.toml", noCache = false, options) => {
+        const debugPort = process.env["CLARINET_DEBUG_PORT"]
+            ? Number(process.env["CLARINET_DEBUG_PORT"])
+            : undefined;
+        if (debugPort != null) {
+            // Connect to the debug server (no-op if already connected).
+            await (0, syncDebugSocket_js_1.connectSyncSocket)(debugPort);
+            if (!debugSimnet || noCache) {
+                debugSimnet = (0, syncDebugSimnet_js_1.createSyncDebugSimnet)();
+            }
+            // Tell the server to reinitialise its session (mirrors initSession semantics).
+            await debugSimnet.initSession(process.cwd(), manifestPath, options);
+            return debugSimnet;
+        }
         if (noCache || !simnet) {
             simnet = await getSDK(options);
         }
@@ -44,4 +61,7 @@ function memoizedInit() {
     };
 }
 exports.initSimnet = memoizedInit();
+var debugClient_js_1 = require("./debugClient.js");
+Object.defineProperty(exports, "startDebugServer", { enumerable: true, get: function () { return debugClient_js_1.startDebugServer; } });
+Object.defineProperty(exports, "DebugClient", { enumerable: true, get: function () { return debugClient_js_1.DebugClient; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/node/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":";;;AA8BA,wBAaC;AAGD,kDAUC;AAxDD,0EAO6C;AAN3C,wGAAA,EAAE,OAAA;AAUJ,qCAA+B;AAC/B,+CAAwD;AAIxD,MAAM,UAAU,GAAG,MAAM,CAAC,2BAA2B,CAAC,CAAC;AAEvD,0GAA0G;AAC1G,aAAa;AACb,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG;IACxB,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;AACzB,CAAC,CAAC;AAQK,KAAK,UAAU,MAAM,CAAC,OAAiB;IAC5C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;IAChC,IAAI,UAAU,GAAG,IAAI,MAAM,CAAC,UAAU,CACpC,CAAC,CAAC,OAAO,EAAE,UAAU,EACrB,CAAC,CAAC,OAAO,EAAE,aAAa,EACxB,CAAC,CAAC,OAAO,EAAE,gBAAgB,CAC5B,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,KAAK,CACtB,IAAI,MAAM,CAAC,GAAG,CAAC,YAAG,EAAE,UAAU,CAAC,EAC/B,IAAA,6BAAe,GAAuB,CAClB,CAAC;IACvB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,0FAA0F;AACnF,KAAK,UAAU,mBAAmB,CAAC,YAAY,GAAG,iBAAiB;IACxE,MAAM,MAAM,GAAG,MAAM,MAAM,EAAE,CAAC;IAE9B,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,sBAAsB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACf,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,qCAAqC;AACrC,SAAS,YAAY;IACnB,IAAI,MAAM,GAAkB,IAAI,CAAC;IAEjC,OAAO,KAAK,EACV,YAAY,GAAG,iBAAiB,EAChC,OAAO,GAAG,KAAK,EACf,OAMC,EACD,EAAE;QACF,IAAI,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;QAED,6BAA6B;QAC7B,MAAM,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,IAAI,IAAI,CAAC,CAAC;QAC/E,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAIY,QAAA,UAAU,GAAG,YAAY,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":";;;;;AAAA,0EAO6C;AAN3C,wGAAA,EAAE,OAAA;AAUJ,qCAA+B;AAC/B,+CAAwD;AACxD,6DAAyD;AAEzD,6DAA6D;AAI7D,MAAM,UAAU,GAAG,MAAM,CAAC,2BAA2B,CAAC,CAAC;AAEvD,0GAA0G;AAC1G,aAAa;AACb,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG;IACxB,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;AACzB,CAAC,CAAC;AAQK,KAAK,iBAAiB,OAAiB;IAC5C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;IAChC,IAAI,UAAU,GAAG,IAAI,MAAM,CAAC,UAAU,CACpC,CAAC,CAAC,OAAO,EAAE,UAAU,EACrB,CAAC,CAAC,OAAO,EAAE,aAAa,EACxB,CAAC,CAAC,OAAO,EAAE,gBAAgB,CAC5B,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,KAAK,CACtB,IAAI,MAAM,CAAC,GAAG,CAAC,YAAG,EAAE,UAAU,CAAC,EAC/B,IAAA,6BAAe,GAAuB,CAClB,CAAC;IACvB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,0FAA0F;AACnF,KAAK,8BAA8B,YAAY,GAAG,iBAAiB;IACxE,MAAM,MAAM,GAAG,MAAM,MAAM,EAAE,CAAC;IAE9B,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,sBAAsB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACf,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,qCAAqC;AACrC,SAAS,YAAY;IACnB,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,oFAAoF;IACpF,IAAI,WAAW,GAA2B,IAAI,CAAC;IAE/C,OAAO,KAAK,EACV,YAAY,GAAG,iBAAiB,EAChC,OAAO,GAAG,KAAK,EACf,OAMC,EACD,EAAE;QACF,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;YAClD,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;YAC5C,CAAC,CAAC,SAAS,CAAC;QAEd,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;YACtB,4DAA4D;YAC5D,MAAM,IAAA,sCAAiB,EAAC,SAAS,CAAC,CAAC;YACnC,IAAI,CAAC,WAAW,IAAI,OAAO,EAAE,CAAC;gBAC5B,WAAW,GAAG,IAAA,0CAAqB,GAAE,CAAC;YACxC,CAAC;YACD,+EAA+E;YAC/E,MAAM,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;YACpE,OAAO,WAAgC,CAAC;QAC1C,CAAC;QAED,IAAI,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;QAED,6BAA6B;QAC7B,MAAM,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,IAAI,IAAI,CAAC,CAAC;QAC/E,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAEY,QAAA,UAAU,GAAG,YAAY,EAAE,CAAC;AAEzC,mDAI0B;AAHxB,kHAAA,gBAAgB,OAAA;AAChB,6GAAA,WAAW,OAAA"}

package/dist/cjs/node/src/sdkProxy.d.ts

@@ -1,11 +1,4 @@
 import { type SDK } from "@stacks/clarinet-sdk-wasm";
-import { type CallFn, type DeployContract, type GetDataVar, type GetMapEntry, type MineBlock, type Execute, type TransferSTX } from "../../common/src/sdkProxyHelpers.js";
-/** @deprecated use `simnet.execute(command)` instead */
-type RunSnippet = SDK["runSnippet"];
-export type Simnet = {
-    [K in keyof SDK]: K extends "callReadOnlyFn" | "callPublicFn" | "callPrivateFn" ? CallFn : K extends "execute" ? Execute : K extends "runSnippet" ? RunSnippet : K extends "deployContract" ? DeployContract : K extends "transferSTX" ? TransferSTX : K extends "mineBlock" ? MineBlock : K extends "getDataVar" ? GetDataVar : K extends "getMapEntry" ? GetMapEntry : SDK[K];
-};
-export declare function getSessionProxy(): {
-    get(session: SDK, prop: keyof SDK, receiver: any): string | number | CallFn | DeployContract | TransferSTX | MineBlock | GetMapEntry | ((include_boot_contracts: boolean, boot_contracts_path: string) => import("@stacks/clarinet-sdk-wasm").SessionReport) | ((cost_field: string) => void) | ((cwd: string, manifest_path: string, api_base_url: any) => Promise<void>) | ((count?: number | null) => number) | ((token: string, recipient: string, amount: bigint) => string) | ((recipient: string, amount: bigint) => string) | ((addresses: string[]) => void);
-};
-export {};
+import { type ProxiedSimnet } from "../../common/src/sdkProxy.js";
+export type Simnet = ProxiedSimnet<SDK>;
+export declare function getSessionProxy(): ProxyHandler<SDK>;

package/dist/cjs/node/src/sdkProxy.js

@@ -1,105 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getSessionProxy = getSessionProxy;
-const transactions_1 = require("@stacks/transactions");
 const clarinet_sdk_wasm_1 = require("@stacks/clarinet-sdk-wasm");
-const sdkProxyHelpers_js_1 = require("../../common/src/sdkProxyHelpers.js");
-function parseTxResponse(response) {
-    return {
-        result: transactions_1.Cl.deserialize(response.result),
-        events: (0, sdkProxyHelpers_js_1.parseEvents)(response.events),
-        costs: (0, sdkProxyHelpers_js_1.parseCosts)(response.costs),
-        performance: response.performance,
-    };
-}
+const sdkProxy_js_1 = require("../../common/src/sdkProxy.js");
 function getSessionProxy() {
-    return {
-        get(session, prop, receiver) {
-            // some of the WASM methods are proxied here to:
-            // - serialize clarity values input argument
-            // - deserialize output into clarity values
-            if (prop === "callReadOnlyFn" || prop === "callPublicFn" || prop === "callPrivateFn") {
-                const callFn = (contract, method, args, sender) => {
-                    const response = session[prop](new clarinet_sdk_wasm_1.CallFnArgs(contract, method, args.map(transactions_1.serializeCVBytes), sender));
-                    return parseTxResponse(response);
-                };
-                return callFn;
-            }
-            if (prop === "execute") {
-                const execute = (snippet) => {
-                    const response = session.execute(snippet);
-                    return parseTxResponse(response);
-                };
-                return execute;
-            }
-            if (prop === "deployContract") {
-                const callDeployContract = (name, content, options, sender) => {
-                    const rustOptions = options
-                        ? new clarinet_sdk_wasm_1.ContractOptions(options.clarityVersion)
-                        : new clarinet_sdk_wasm_1.ContractOptions();
-                    const response = session.deployContract(new clarinet_sdk_wasm_1.DeployContractArgs(name, content, rustOptions, sender));
-                    return parseTxResponse(response);
-                };
-                return callDeployContract;
-            }
-            if (prop === "transferSTX") {
-                const callTransferSTX = (amount, ...args) => {
-                    const response = session.transferSTX(new clarinet_sdk_wasm_1.TransferSTXArgs(BigInt(amount), ...args));
-                    return parseTxResponse(response);
-                };
-                return callTransferSTX;
-            }
-            if (prop === "mineBlock") {
-                const callMineBlock = (txs) => {
-                    const serializedTxs = txs.map((tx) => {
-                        if (tx.callPublicFn) {
-                            return {
-                                callPublicFn: {
-                                    ...tx.callPublicFn,
-                                    args_maps: tx.callPublicFn.args.map(transactions_1.serializeCVBytes),
-                                },
-                            };
-                        }
-                        if (tx.callPrivateFn) {
-                            return {
-                                callPrivateFn: {
-                                    ...tx.callPrivateFn,
-                                    args_maps: tx.callPrivateFn.args.map(transactions_1.serializeCVBytes),
-                                },
-                            };
-                        }
-                        if (tx.deployContract) {
-                            return {
-                                deployContract: {
-                                    ...tx.deployContract,
-                                },
-                            };
-                        }
-                        return tx;
-                    });
-                    const responses = session.mineBlock(serializedTxs);
-                    return responses.map(parseTxResponse);
-                };
-                return callMineBlock;
-            }
-            if (prop === "getDataVar") {
-                const getDataVar = (...args) => {
-                    const response = session.getDataVar(...args);
-                    const result = transactions_1.Cl.deserialize(response);
-                    return result;
-                };
-                return getDataVar;
-            }
-            if (prop === "getMapEntry") {
-                const getMapEntry = (contract, mapName, mapKey) => {
-                    const response = session.getMapEntry(contract, mapName, (0, transactions_1.serializeCVBytes)(mapKey));
-                    const result = transactions_1.Cl.deserialize(response);
-                    return result;
-                };
-                return getMapEntry;
-            }
-            return Reflect.get(session, prop, receiver);
-        },
-    };
+    return (0, sdkProxy_js_1.createSessionProxy)({
+        CallFnArgs: clarinet_sdk_wasm_1.CallFnArgs,
+        ContractOptions: clarinet_sdk_wasm_1.ContractOptions,
+        DeployContractArgs: clarinet_sdk_wasm_1.DeployContractArgs,
+        TransferSTXArgs: clarinet_sdk_wasm_1.TransferSTXArgs,
+    });
 }
 //# sourceMappingURL=sdkProxy.js.map

package/dist/cjs/node/src/sdkProxy.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdkProxy.js","sourceRoot":"","sources":["../../../../src/sdkProxy.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sdkProxy.js","sourceRoot":"","sources":["../../../../src/sdkProxy.ts"],"names":[],"mappings":";;;AAAA,iEAMmC;AAEnC,8DAAsF;AAItF;IACE,OAAO,IAAA,gCAAkB,EAAuB;QAC9C,UAAU,EAAV,8BAAU;QACV,eAAe,EAAf,mCAAe;QACf,kBAAkB,EAAlB,sCAAkB;QAClB,eAAe,EAAf,mCAAe;KAChB,CAAC,CAAC;AACL,CAAC"}

package/dist/cjs/node/src/syncDebugSimnet.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Synchronous simnet proxy that routes all calls to a `clarinet dap` debug server
+ * via a SharedArrayBuffer + Atomics.wait worker (see syncDebugSocket.ts).
+ *
+ * When CLARINET_DEBUG_PORT is set, initSimnet() returns one of these instead of
+ * the WASM simnet. The API surface is identical, so existing tests run unchanged
+ * while breakpoints in .clar files fire in VSCode (or any DAP-capable editor).
+ */
+import { type ClarityValue } from "@stacks/transactions";
+import { type ParsedTransactionResult, type Tx } from "../../common/src/sdkProxyHelpers.js";
+export type SyncDebugSimnet = {
+    readonly deployer: string;
+    readonly blockHeight: number;
+    readonly burnBlockHeight: number;
+    readonly stacksBlockHeight: number;
+    getAccounts(): Map<string, string>;
+    mineBlock(txs: Tx[]): ParsedTransactionResult[];
+    mineEmptyBlock(count?: number): number;
+    mineEmptyStacksBlock(): number;
+    callPublicFn(contract: string, method: string, args: ClarityValue[], sender: string): ParsedTransactionResult;
+    callReadOnlyFn(contract: string, method: string, args: ClarityValue[], sender: string): ParsedTransactionResult;
+    callPrivateFn(contract: string, method: string, args: ClarityValue[], sender: string): ParsedTransactionResult;
+    execute(snippet: string): ParsedTransactionResult;
+    runSnippet(snippet: string): string;
+    getAssetsMap(): Map<string, Map<string, bigint>>;
+    getLastContractCallTrace(): string | undefined;
+    setCurrentTestName(name: string): void;
+    collectReport(includeBootContracts: boolean, bootContractsPath: string): {
+        coverage: string;
+        costs: string;
+    };
+    initSession(cwd: string, manifestPath: string, options?: {
+        trackCosts: boolean;
+        trackCoverage: boolean;
+        trackPerformance?: boolean;
+        performanceCostField?: string;
+        apiUrl?: string;
+    }): Promise<void>;
+};
+/**
+ * Create a synchronous debug simnet proxy connected to the debug server at the
+ * given port. The caller must have already called `connectSyncSocket(port)`.
+ *
+ * `deployer` is fetched immediately (synchronously) from the server.
+ */
+export declare function createSyncDebugSimnet(): SyncDebugSimnet;

package/dist/cjs/node/src/syncDebugSimnet.js

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSyncDebugSimnet = createSyncDebugSimnet;
+/**
+ * Synchronous simnet proxy that routes all calls to a `clarinet dap` debug server
+ * via a SharedArrayBuffer + Atomics.wait worker (see syncDebugSocket.ts).
+ *
+ * When CLARINET_DEBUG_PORT is set, initSimnet() returns one of these instead of
+ * the WASM simnet. The API surface is identical, so existing tests run unchanged
+ * while breakpoints in .clar files fire in VSCode (or any DAP-capable editor).
+ */
+const transactions_1 = require("@stacks/transactions");
+const syncDebugSocket_js_1 = require("./syncDebugSocket.js");
+const sdkProxyHelpers_js_1 = require("../../common/src/sdkProxyHelpers.js");
+function parseTxResult(r) {
+    if (!r.result) {
+        throw new Error(r.error ?? "transaction failed with no result");
+    }
+    return {
+        result: transactions_1.Cl.deserialize(r.result),
+        events: (0, sdkProxyHelpers_js_1.parseEvents)(r.events),
+        costs: (0, sdkProxyHelpers_js_1.parseCosts)(r.costs),
+        performance: undefined,
+    };
+}
+/** Call syncSend and throw if the server responded with an error. */
+function send(request) {
+    const raw = (0, syncDebugSocket_js_1.syncSend)(request);
+    const resp = JSON.parse(raw);
+    if (resp.error)
+        throw new Error(resp.error);
+    return resp.result ?? {};
+}
+/** Serialize a ClarityValue to a Clarity syntax string for use in snippets. */
+function argString(v) {
+    return transactions_1.Cl.stringify(v);
+}
+/**
+ * Create a synchronous debug simnet proxy connected to the debug server at the
+ * given port. The caller must have already called `connectSyncSocket(port)`.
+ *
+ * `deployer` is fetched immediately (synchronously) from the server.
+ */
+function createSyncDebugSimnet() {
+    // Fetch deployer and accounts at construction time (sync, server is connected).
+    const initData = send({ method: "getAccounts" });
+    const accountsRecord = initData.accounts ?? {};
+    const deployer = accountsRecord["deployer"] ?? "";
+    return {
+        deployer,
+        get blockHeight() {
+            const resp = send({ method: "getBlockHeight" });
+            return resp.blockHeight;
+        },
+        get burnBlockHeight() {
+            const resp = send({ method: "getBurnBlockHeight" });
+            return resp.burnBlockHeight;
+        },
+        get stacksBlockHeight() {
+            const resp = send({ method: "getBlockHeight" });
+            return resp.blockHeight;
+        },
+        getAccounts() {
+            return new Map(Object.entries(accountsRecord));
+        },
+        mineEmptyBlock(count = 1) {
+            const resp = send({ method: "mineEmptyBlock", count });
+            return resp.blockHeight;
+        },
+        mineEmptyStacksBlock() {
+            const resp = send({ method: "mineEmptyBlock", count: 1 });
+            return resp.blockHeight;
+        },
+        setCurrentTestName(_name) {
+            // No-op in debug mode: coverage tracking is not supported.
+        },
+        collectReport(_includeBootContracts, _bootContractsPath) {
+            // Debug mode does not support coverage/cost reports.
+            throw new Error("collectReport: coverage and cost reports are not supported in debug mode");
+        },
+        runSnippet(snippet) {
+            const resp = send({ method: "execute", snippet });
+            return transactions_1.Cl.stringify(transactions_1.Cl.deserialize(resp.result));
+        },
+        mineBlock(txs) {
+            const serialized = txs.map((tx) => {
+                if (tx.callPublicFn) {
+                    return {
+                        type: "callPublicFn",
+                        contract: tx.callPublicFn.contract,
+                        function: tx.callPublicFn.method,
+                        args: tx.callPublicFn.args.map(argString),
+                        sender: tx.callPublicFn.sender,
+                    };
+                }
+                if (tx.callPrivateFn) {
+                    return {
+                        type: "callPrivateFn",
+                        contract: tx.callPrivateFn.contract,
+                        function: tx.callPrivateFn.method,
+                        args: tx.callPrivateFn.args.map(argString),
+                        sender: tx.callPrivateFn.sender,
+                    };
+                }
+                if (tx.deployContract) {
+                    return {
+                        type: "deployContract",
+                        name: tx.deployContract.name,
+                        content: tx.deployContract.content,
+                        sender: tx.deployContract.sender,
+                    };
+                }
+                if (tx.transferSTX) {
+                    return {
+                        type: "transferSTX",
+                        amount: tx.transferSTX.amount,
+                        recipient: tx.transferSTX.recipient,
+                        sender: tx.transferSTX.sender,
+                    };
+                }
+                return { type: "unknown" };
+            });
+            const resp = send({ method: "mineBlock", txs: serialized });
+            return (resp.results ?? []).map(parseTxResult);
+        },
+        callPublicFn(contract, method, args, sender) {
+            const resp = send({
+                method: "callPublicFn",
+                contract,
+                function: method,
+                args: args.map(argString),
+                sender,
+            });
+            return parseTxResult(resp);
+        },
+        callReadOnlyFn(contract, method, args, sender) {
+            const resp = send({
+                method: "callReadOnlyFn",
+                contract,
+                function: method,
+                args: args.map(argString),
+                sender,
+            });
+            return parseTxResult(resp);
+        },
+        callPrivateFn(contract, method, args, sender) {
+            const resp = send({
+                method: "callPrivateFn",
+                contract,
+                function: method,
+                args: args.map(argString),
+                sender,
+            });
+            return parseTxResult(resp);
+        },
+        execute(snippet) {
+            const resp = send({ method: "execute", snippet });
+            return parseTxResult(resp);
+        },
+        getAssetsMap() {
+            const resp = send({ method: "getAssetsMap" });
+            const outer = new Map();
+            for (const [asset, holders] of Object.entries(resp.assetsMap ?? {})) {
+                const inner = new Map();
+                for (const [addr, bal] of Object.entries(holders)) {
+                    inner.set(addr, BigInt(bal));
+                }
+                outer.set(asset, inner);
+            }
+            return outer;
+        },
+        getLastContractCallTrace() {
+            return undefined;
+        },
+        async initSession(cwd, manifestPath, options) {
+            send({ method: "initSession", cwd, manifestPath, options });
+        },
+    };
+}
+//# sourceMappingURL=syncDebugSimnet.js.map

package/dist/cjs/node/src/syncDebugSimnet.js.map

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

package/dist/cjs/node/src/syncDebugSocket.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Spawn the worker and wait for its TCP socket to connect.
+ * Must be called (and awaited) before any `syncSend` call.
+ */
+export declare function connectSyncSocket(port: number): Promise<void>;
+/**
+ * Send a JSON request to the debug server synchronously (blocks via Atomics.wait).
+ * Returns the raw JSON response string.
+ */
+export declare function syncSend(request: Record<string, unknown>): string;
+/** Terminate the worker and release the socket. */
+export declare function closeSyncSocket(): void;