@stacks/clarinet-sdk 3.23.2 → 3.24.1

package/dist/esm/common/src/sdkProxyHelpers.js

@@ -1,16 +1,47 @@
-import { Cl } from "@stacks/transactions";
+import { Cl, PostConditionMode, postConditionToHex, serializePostConditionWire, } from "@stacks/transactions";
+export function serializePostConditions(options) {
+    const conditions = options?.postConditions;
+    const mode = options?.postConditionMode;
+    // Preserve the distinction between an omitted list and an explicit empty one.
+    return {
+        ...(conditions !== undefined && {
+            postConditions: conditions.map((pc) => {
+                if (typeof pc === "string")
+                    return pc;
+                return typeof pc.type === "string"
+                    ? postConditionToHex(pc)
+                    : serializePostConditionWire(pc);
+            }),
+        }),
+        ...(mode !== undefined && {
+            postConditionMode: mode === PostConditionMode.Allow
+                ? "allow"
+                : mode === PostConditionMode.Deny
+                    ? "deny"
+                    : mode === PostConditionMode.Originator
+                        ? "originator"
+                        : mode,
+        }),
+    };
+}
 export const tx = {
-    callPublicFn: (contract, method, args, sender) => ({
-        callPublicFn: { contract, method, args, sender },
+    callPublicFn: (contract, method, args, sender, options) => ({
+        callPublicFn: { contract, method, args, sender, ...serializePostConditions(options) },
     }),
-    callPrivateFn: (contract, method, args, sender) => ({
-        callPrivateFn: { contract, method, args, sender },
+    callPrivateFn: (contract, method, args, sender, options) => ({
+        callPrivateFn: { contract, method, args, sender, ...serializePostConditions(options) },
     }),
-    deployContract: (name, content, options, sender) => ({
-        deployContract: { name, content, options, sender },
+    deployContract: (name, content, options, sender, postConditionOptions) => ({
+        deployContract: {
+            name,
+            content,
+            options,
+            sender,
+            ...serializePostConditions(postConditionOptions),
+        },
     }),
-    transferSTX: (amount, recipient, sender) => ({
-        transferSTX: { amount, recipient, sender },
+    transferSTX: (amount, recipient, sender, options) => ({
+        transferSTX: { amount, recipient, sender, ...serializePostConditions(options) },
     }),
 };
 export function parseEvents(events) {

package/dist/esm/common/src/sdkProxyHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdkProxyHelpers.js","sourceRoot":"","sources":["../../../../../common/src/sdkProxyHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAgC,MAAM,sBAAsB,CAAC;AA6FxE,MAAM,CAAC,MAAM,EAAE,GAAG;IAChB,YAAY,EAAE,CAAC,QAAgB,EAAE,MAAc,EAAE,IAAoB,EAAE,MAAc,EAAM,EAAE,CAAC,CAAC;QAC7F,YAAY,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;KACjD,CAAC;IACF,aAAa,EAAE,CAAC,QAAgB,EAAE,MAAc,EAAE,IAAoB,EAAE,MAAc,EAAM,EAAE,CAAC,CAAC;QAC9F,aAAa,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;KAClD,CAAC;IACF,cAAc,EAAE,CACd,IAAY,EACZ,OAAe,EACf,OAAqC,EACrC,MAAc,EACV,EAAE,CAAC,CAAC;QACR,cAAc,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE;KACnD,CAAC;IACF,WAAW,EAAE,CAAC,MAAc,EAAE,SAAiB,EAAE,MAAc,EAAM,EAAE,CAAC,CAAC;QACvE,WAAW,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE;KAC3C,CAAC;CACH,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,IAAI,CAAC;QACH,6BAA6B;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE;YAC1C,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;gBACxB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC9C,CAAC;YACD,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,IAAI,EAAE,IAAI;aACX,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC;QAC5C,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,CAAC;QACH,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/D,OAAO;YACL,MAAM,EAAE,MAAM;YACd,YAAY,EAAE,YAAY;YAC1B,KAAK,EAAE;gBACL,WAAW,EAAE,KAAK,CAAC,YAAY;gBAC/B,UAAU,EAAE,KAAK,CAAC,WAAW;gBAC7B,UAAU,EAAE,KAAK,CAAC,WAAW;gBAC7B,SAAS,EAAE,KAAK,CAAC,UAAU;gBAC3B,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB;YACD,KAAK,EAAE;gBACL,WAAW,EAAE,KAAK,CAAC,YAAY;gBAC/B,UAAU,EAAE,KAAK,CAAC,WAAW;gBAC7B,UAAU,EAAE,KAAK,CAAC,WAAW;gBAC7B,SAAS,EAAE,KAAK,CAAC,UAAU;gBAC3B,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,EAAE,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"sdkProxyHelpers.js","sourceRoot":"","sources":["../../../../../common/src/sdkProxyHelpers.ts"],"names":[],"mappings":"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"}

package/dist/esm/node/src/debugClient.d.ts

@@ -0,0 +1,78 @@
+import * as net from "net";
+import { type ChildProcess } from "child_process";
+import { type ClarityValue } from "@stacks/transactions";
+export type DebugCallResult = {
+    /** The Clarity return value as a human-readable string, e.g. `"(ok u1)"`. */
+    value: string;
+};
+/**
+ * A client that connects to a `clarinet dap --dap-port … --sdk-port …` server
+ * and evaluates Clarity expressions under DAP debugger control.
+ *
+ * Breakpoints set in VSCode (or another DAP-capable editor) in `.clar` source
+ * files will be hit when the corresponding contract code is reached.
+ *
+ * @example
+ * ```ts
+ * const debugger = await startDebugServer();
+ * const result = await debugger.callPublicFn("counter", "increment", [], deployer);
+ * expect(result.value).toBe("(ok u1)");
+ * await debugger.disconnect();
+ * ```
+ */
+export declare class DebugClient {
+    private readonly socket;
+    private nextId;
+    private readonly pending;
+    private buffer;
+    /** Set when this client owns the `clarinet dap` process (via `startDebugServer`). */
+    private readonly _process?;
+    constructor(socket: net.Socket, process?: ChildProcess);
+    private send;
+    /**
+     * Call a public contract function through the debug server.
+     * Breakpoints in the contract source will pause execution.
+     */
+    callPublicFn(contract: string, method: string, args: ClarityValue[], sender: string): Promise<DebugCallResult>;
+    /**
+     * Evaluate an arbitrary Clarity snippet in the simnet session under the debugger.
+     */
+    execute(snippet: string): Promise<DebugCallResult>;
+    /** Gracefully disconnect from the debug server. */
+    disconnect(): Promise<void>;
+}
+/**
+ * Start or connect to a `clarinet dap` debug server and return a
+ * {@link DebugClient}.
+ *
+ * **Auto-spawn mode** (default): when no `port` is provided and
+ * `CLARINET_DEBUG_PORT` is not set, `clarinet dap` is spawned automatically.
+ * The returned client owns the process and kills it on
+ * {@link DebugClient.disconnect}.
+ *
+ * **Connect mode**: when `port` is provided (or `CLARINET_DEBUG_PORT` is set),
+ * the function connects to a server that is already running — for example one
+ * started by the VSCode extension's CodeLens button.
+ *
+ * @example
+ * ```ts
+ * // Zero-config — server is spawned automatically
+ * const client = await startDebugServer({ manifest: "./Clarinet.toml" });
+ * const result = await client.callPublicFn("counter", "increment", [], deployer);
+ * await client.disconnect();
+ * ```
+ */
+export declare function startDebugServer(options?: {
+    /** Path to Clarinet.toml. Defaults to `"./Clarinet.toml"`. */
+    manifest?: string;
+    /**
+     * Connect to this port instead of spawning a new server.
+     * Falls back to `CLARINET_DEBUG_PORT` env var, then auto-spawn.
+     */
+    port?: number;
+    /**
+     * When auto-spawning, also open a DAP port so a DAP client (e.g. VSCode)
+     * can attach and hit breakpoints. Ignored in connect mode.
+     */
+    dapPort?: number;
+}): Promise<DebugClient>;

package/dist/esm/node/src/debugClient.js

@@ -0,0 +1,204 @@
+import * as net from "net";
+import { spawn } from "child_process";
+import { Cl } from "@stacks/transactions";
+/**
+ * A client that connects to a `clarinet dap --dap-port … --sdk-port …` server
+ * and evaluates Clarity expressions under DAP debugger control.
+ *
+ * Breakpoints set in VSCode (or another DAP-capable editor) in `.clar` source
+ * files will be hit when the corresponding contract code is reached.
+ *
+ * @example
+ * ```ts
+ * const debugger = await startDebugServer();
+ * const result = await debugger.callPublicFn("counter", "increment", [], deployer);
+ * expect(result.value).toBe("(ok u1)");
+ * await debugger.disconnect();
+ * ```
+ */
+export class DebugClient {
+    socket;
+    nextId = 1;
+    pending = new Map();
+    buffer = "";
+    /** Set when this client owns the `clarinet dap` process (via `startDebugServer`). */
+    _process;
+    constructor(socket, process) {
+        this.socket = socket;
+        this._process = process;
+        socket.on("data", (chunk) => {
+            this.buffer += chunk.toString("utf8");
+            const lines = this.buffer.split("\n");
+            // Keep any incomplete line in the buffer
+            this.buffer = lines.pop() ?? "";
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    continue;
+                try {
+                    const response = JSON.parse(trimmed);
+                    const pending = this.pending.get(response.id);
+                    if (pending) {
+                        this.pending.delete(response.id);
+                        pending.resolve(response);
+                    }
+                }
+                catch {
+                    // Ignore malformed lines
+                }
+            }
+        });
+        const rejectPending = (err) => {
+            for (const { reject } of this.pending.values()) {
+                reject(err);
+            }
+            this.pending.clear();
+        };
+        socket.on("error", rejectPending);
+        socket.on("close", () => {
+            rejectPending(new Error("debug server connection closed"));
+        });
+    }
+    send(request) {
+        const id = this.nextId++;
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, { resolve, reject });
+            this.socket.write(JSON.stringify({ ...request, id }) + "\n");
+        });
+    }
+    /**
+     * Call a public contract function through the debug server.
+     * Breakpoints in the contract source will pause execution.
+     */
+    async callPublicFn(contract, method, args, sender) {
+        const argStrings = args.map((a) => Cl.stringify(a));
+        const response = await this.send({
+            method: "call",
+            contract,
+            function: method,
+            args: argStrings,
+            sender,
+        });
+        if (response.error)
+            throw new Error(response.error);
+        return { value: Cl.stringify(Cl.deserialize(response.result.result)) };
+    }
+    /**
+     * Evaluate an arbitrary Clarity snippet in the simnet session under the debugger.
+     */
+    async execute(snippet) {
+        const response = await this.send({ method: "eval", snippet });
+        if (response.error)
+            throw new Error(response.error);
+        return { value: Cl.stringify(Cl.deserialize(response.result.result)) };
+    }
+    /** Gracefully disconnect from the debug server. */
+    async disconnect() {
+        try {
+            await this.send({ method: "disconnect" });
+        }
+        finally {
+            this.socket.destroy();
+            try {
+                this._process?.kill();
+            }
+            catch {
+                // ignore: process may have already exited
+            }
+        }
+    }
+}
+function openSocket(port) {
+    return new Promise((resolve, reject) => {
+        const socket = net.createConnection({ port, host: "127.0.0.1" }, () => {
+            socket.removeListener("error", reject);
+            resolve(socket);
+        });
+        socket.once("error", reject);
+    });
+}
+/**
+ * Start or connect to a `clarinet dap` debug server and return a
+ * {@link DebugClient}.
+ *
+ * **Auto-spawn mode** (default): when no `port` is provided and
+ * `CLARINET_DEBUG_PORT` is not set, `clarinet dap` is spawned automatically.
+ * The returned client owns the process and kills it on
+ * {@link DebugClient.disconnect}.
+ *
+ * **Connect mode**: when `port` is provided (or `CLARINET_DEBUG_PORT` is set),
+ * the function connects to a server that is already running — for example one
+ * started by the VSCode extension's CodeLens button.
+ *
+ * @example
+ * ```ts
+ * // Zero-config — server is spawned automatically
+ * const client = await startDebugServer({ manifest: "./Clarinet.toml" });
+ * const result = await client.callPublicFn("counter", "increment", [], deployer);
+ * await client.disconnect();
+ * ```
+ */
+export async function startDebugServer(options) {
+    const envPort = process.env["CLARINET_DEBUG_PORT"]
+        ? Number(process.env["CLARINET_DEBUG_PORT"])
+        : undefined;
+    const connectPort = options?.port ?? envPort;
+    // Connect mode: server is already running externally.
+    if (connectPort != null) {
+        const socket = await openSocket(connectPort);
+        return new DebugClient(socket);
+    }
+    // Auto-spawn mode: launch clarinet dap ourselves. Ask the OS for a free SDK
+    // port so parallel test runs don't contend for a fixed port.
+    let sdkPort;
+    const manifest = options?.manifest ?? "./Clarinet.toml";
+    const args = ["dap", "--sdk-port", "0", "--manifest", manifest];
+    if (options?.dapPort != null) {
+        args.push("--dap-port", String(options.dapPort));
+    }
+    const child = spawn("clarinet", args, {
+        stdio: ["ignore", "ignore", "pipe"],
+    });
+    // Wait for the ready signal printed to stderr by run_dap_server.
+    await new Promise((resolve, reject) => {
+        const readyPattern = /CLARINET_DAP_SDK_READY:(\d+)/;
+        let stderrBuf = "";
+        const timeout = setTimeout(() => reject(new Error("clarinet dap server did not start within 15 s")), 15_000);
+        const cleanup = () => {
+            clearTimeout(timeout);
+            child.stderr.removeListener("data", onStderr);
+            child.removeListener("error", onError);
+            child.removeListener("exit", onExit);
+        };
+        const onStderr = (chunk) => {
+            stderrBuf += chunk.toString("utf8");
+            const match = readyPattern.exec(stderrBuf);
+            if (match) {
+                sdkPort = Number(match[1]);
+                cleanup();
+                // Keep draining stderr so the pipe doesn't fill and block the server,
+                // and so crash messages appear in the parent process output.
+                child.stderr.on("data", (c) => process.stderr.write(c));
+                resolve();
+            }
+        };
+        const onError = (err) => {
+            cleanup();
+            reject(new Error(`failed to spawn clarinet: ${err.message}`));
+        };
+        const onExit = (code) => {
+            cleanup();
+            reject(new Error(`clarinet dap exited unexpectedly with code ${code}`));
+        };
+        child.stderr.on("data", onStderr);
+        child.on("error", onError);
+        child.on("exit", onExit);
+    });
+    if (sdkPort == null) {
+        child.kill();
+        throw new Error("clarinet dap did not report an SDK port");
+    }
+    const socket = await openSocket(sdkPort);
+    return new DebugClient(socket, child);
+}
+//# sourceMappingURL=debugClient.js.map

package/dist/esm/node/src/debugClient.js.map

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

package/dist/esm/node/src/index.d.ts

@@ -1,4 +1,5 @@
 export { tx, type ClarityEvent, type ParsedTransactionResult, type DeployContractOptions, type Tx, type TransferSTX, } from "../../common/src/sdkProxyHelpers.js";
+import type { SDK } from "@stacks/clarinet-sdk-wasm";
 import { Simnet } from "./sdkProxy.js";
 export { type Simnet } from "./sdkProxy.js";
 type Options = {
@@ -14,4 +15,5 @@ export declare const initSimnet: (manifestPath?: string, noCache?: boolean, opti
     trackPerformance?: boolean;
     performanceCostField?: string;
     apiUrl?: string;
-}) => Promise<Simnet>;
+}) => Promise<import("../../common/src/sdkProxy.js").ProxiedSimnet<SDK>>;
+export { startDebugServer, DebugClient, type DebugCallResult, } from "./debugClient.js";

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

@@ -1,6 +1,8 @@
 export { tx, } from "../../common/src/sdkProxyHelpers.js";
 import { vfs } from "./vfs.js";
 import { getSessionProxy } from "./sdkProxy.js";
+import { connectSyncSocket } from "./syncDebugSocket.js";
+import { createSyncDebugSimnet } from "./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
@@ -28,7 +30,22 @@ export 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 connectSyncSocket(debugPort);
+            if (!debugSimnet || noCache) {
+                debugSimnet = 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);
         }
@@ -38,4 +55,5 @@ function memoizedInit() {
     };
 }
 export const initSimnet = memoizedInit();
+export { startDebugServer, DebugClient, } from "./debugClient.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,EAAE,GAMH,MAAM,qCAAqC,CAAC;AAI7C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAU,eAAe,EAAE,MAAM,eAAe,CAAC;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;AAQF,MAAM,CAAC,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,GAAG,EAAE,UAAU,CAAC,EAC/B,eAAe,EAAuB,CAClB,CAAC;IACvB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,0FAA0F;AAC1F,MAAM,CAAC,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;AAID,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/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/esm/node/src/sdkProxy.js

@@ -1,102 +1,11 @@
-import { Cl, serializeCVBytes } from "@stacks/transactions";
-import { CallFnArgs, DeployContractArgs, TransferSTXArgs, ContractOptions, } from "@stacks/clarinet-sdk-wasm";
-import { parseEvents, parseCosts, } from "../../common/src/sdkProxyHelpers.js";
-function parseTxResponse(response) {
-    return {
-        result: Cl.deserialize(response.result),
-        events: parseEvents(response.events),
-        costs: parseCosts(response.costs),
-        performance: response.performance,
-    };
-}
+import { CallFnArgs, ContractOptions, DeployContractArgs, TransferSTXArgs, } from "@stacks/clarinet-sdk-wasm";
+import { createSessionProxy } from "../../common/src/sdkProxy.js";
 export 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 CallFnArgs(contract, method, args.map(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 ContractOptions(options.clarityVersion)
-                        : new ContractOptions();
-                    const response = session.deployContract(new DeployContractArgs(name, content, rustOptions, sender));
-                    return parseTxResponse(response);
-                };
-                return callDeployContract;
-            }
-            if (prop === "transferSTX") {
-                const callTransferSTX = (amount, ...args) => {
-                    const response = session.transferSTX(new 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(serializeCVBytes),
-                                },
-                            };
-                        }
-                        if (tx.callPrivateFn) {
-                            return {
-                                callPrivateFn: {
-                                    ...tx.callPrivateFn,
-                                    args_maps: tx.callPrivateFn.args.map(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 = Cl.deserialize(response);
-                    return result;
-                };
-                return getDataVar;
-            }
-            if (prop === "getMapEntry") {
-                const getMapEntry = (contract, mapName, mapKey) => {
-                    const response = session.getMapEntry(contract, mapName, serializeCVBytes(mapKey));
-                    const result = Cl.deserialize(response);
-                    return result;
-                };
-                return getMapEntry;
-            }
-            return Reflect.get(session, prop, receiver);
-        },
-    };
+    return createSessionProxy({
+        CallFnArgs,
+        ContractOptions,
+        DeployContractArgs,
+        TransferSTXArgs,
+    });
 }
 //# sourceMappingURL=sdkProxy.js.map

package/dist/esm/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,OAAO,EACL,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,eAAe,GAEhB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,kBAAkB,EAAsB,MAAM,8BAA8B,CAAC;AAItF,MAAM,UAAU,eAAe;IAC7B,OAAO,kBAAkB,CAAuB;QAC9C,UAAU;QACV,eAAe;QACf,kBAAkB;QAClB,eAAe;KAChB,CAAC,CAAC;AACL,CAAC"}

package/dist/esm/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;