@stacks/clarinet-sdk 3.23.1 → 3.24.0

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

@@ -0,0 +1,32 @@
+import { type CallFn, type CallReadOnlyFn, type DeployContract, type Execute, type GetDataVar, type GetMapEntry, type MineBlock, type TransferSTX } from "./sdkProxyHelpers.js";
+type WasmTransactionRes = {
+    result: string;
+    events: string;
+    costs: string;
+    performance?: string;
+};
+type ProxySdk = {
+    callReadOnlyFn(args: unknown): WasmTransactionRes;
+    callPublicFn(args: unknown): WasmTransactionRes;
+    callPrivateFn(args: unknown): WasmTransactionRes;
+    deployContract(args: unknown): WasmTransactionRes;
+    execute(snippet: string): WasmTransactionRes;
+    getDataVar(contract: string, varName: string): string;
+    getMapEntry(contract: string, mapName: string, mapKey: Uint8Array): string;
+    mineBlock(txs: unknown[]): WasmTransactionRes[];
+    runSnippet(snippet: string): string;
+    transferSTX(args: unknown): WasmTransactionRes;
+};
+/** @deprecated use `simnet.execute(command)` instead */
+type RunSnippet<S extends ProxySdk> = S["runSnippet"];
+export type ProxiedSimnet<S extends ProxySdk> = {
+    [K in keyof S]: K extends "callReadOnlyFn" ? CallReadOnlyFn : K extends "callPublicFn" | "callPrivateFn" ? CallFn : K extends "execute" ? Execute : K extends "runSnippet" ? RunSnippet<S> : K extends "deployContract" ? DeployContract : K extends "transferSTX" ? TransferSTX : K extends "mineBlock" ? MineBlock : K extends "getDataVar" ? GetDataVar : K extends "getMapEntry" ? GetMapEntry : S[K];
+};
+type ProxyBindings<ContractOptions> = {
+    CallFnArgs: new (contract: string, method: string, args: Uint8Array[], sender: string, postConditions?: string[], postConditionMode?: string) => unknown;
+    ContractOptions: new (clarityVersion?: number) => ContractOptions;
+    DeployContractArgs: new (name: string, content: string, options: ContractOptions, sender: string, postConditions?: string[], postConditionMode?: string) => unknown;
+    TransferSTXArgs: new (amount: bigint, recipient: string, sender: string, postConditions?: string[], postConditionMode?: string) => unknown;
+};
+export declare function createSessionProxy<S extends ProxySdk, ContractOptions>(bindings: ProxyBindings<ContractOptions>): ProxyHandler<S>;
+export {};

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

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSessionProxy = createSessionProxy;
+const transactions_1 = require("@stacks/transactions");
+const sdkProxyHelpers_js_1 = require("./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,
+    };
+}
+function createSessionProxy(bindings) {
+    const { CallFnArgs, ContractOptions, DeployContractArgs, TransferSTXArgs } = bindings;
+    return {
+        get(session, prop, receiver) {
+            const sdk = session;
+            if (prop === "callReadOnlyFn" || prop === "callPublicFn" || prop === "callPrivateFn") {
+                const callFn = (contract, method, args, sender, options) => {
+                    const { postConditions, postConditionMode } = (0, sdkProxyHelpers_js_1.serializePostConditions)(options);
+                    const response = sdk[prop](new CallFnArgs(contract, method, args.map(transactions_1.serializeCVBytes), sender, postConditions, postConditionMode));
+                    return parseTxResponse(response);
+                };
+                return callFn;
+            }
+            if (prop === "execute") {
+                const execute = (snippet) => parseTxResponse(sdk.execute(snippet));
+                return execute;
+            }
+            if (prop === "deployContract") {
+                const deployContract = (name, content, options, sender, postConditionOptions) => {
+                    const rustOptions = options
+                        ? new ContractOptions(options.clarityVersion)
+                        : new ContractOptions();
+                    const { postConditions, postConditionMode } = (0, sdkProxyHelpers_js_1.serializePostConditions)(postConditionOptions);
+                    return parseTxResponse(sdk.deployContract(new DeployContractArgs(name, content, rustOptions, sender, postConditions, postConditionMode)));
+                };
+                return deployContract;
+            }
+            if (prop === "transferSTX") {
+                const transferSTX = (amount, recipient, sender, options) => {
+                    const { postConditions, postConditionMode } = (0, sdkProxyHelpers_js_1.serializePostConditions)(options);
+                    return parseTxResponse(sdk.transferSTX(new TransferSTXArgs(BigInt(amount), recipient, sender, postConditions, postConditionMode)));
+                };
+                return transferSTX;
+            }
+            if (prop === "mineBlock") {
+                const mineBlock = (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;
+                    });
+                    return sdk.mineBlock(serializedTxs).map(parseTxResponse);
+                };
+                return mineBlock;
+            }
+            if (prop === "getDataVar") {
+                const getDataVar = (...args) => transactions_1.Cl.deserialize(sdk.getDataVar(...args));
+                return getDataVar;
+            }
+            if (prop === "getMapEntry") {
+                const getMapEntry = (contract, mapName, mapKey) => transactions_1.Cl.deserialize(sdk.getMapEntry(contract, mapName, (0, transactions_1.serializeCVBytes)(mapKey)));
+                return getMapEntry;
+            }
+            return Reflect.get(session, prop, receiver);
+        },
+    };
+}
+//# sourceMappingURL=sdkProxy.js.map

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

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

package/dist/cjs/common/src/sdkProxyHelpers.d.ts

@@ -1,4 +1,4 @@
-import { ClarityValue, ClarityVersion } from "@stacks/transactions";
+import { ClarityValue, ClarityVersion, ContractCallOptions, PostConditionModeName } from "@stacks/transactions";
 export type ClarityEvent = {
     event: string;
     data: {
@@ -26,19 +26,41 @@ export type ParsedTransactionResult = {
     costs: ClarityCosts | null;
     performance: string | undefined;
 };
-export type CallFn = (contract: string, method: string, args: ClarityValue[], sender: string) => ParsedTransactionResult;
+/**
+ * Post-conditions to enforce on a simnet transaction.
+ *
+ * Conditions use the same builder, wire, and hex formats as stacks.js. Hex is
+ * also the escape hatch for conditions that stacks.js cannot build yet.
+ *
+ * Passing neither field preserves the SDK's unchecked behavior. Passing either
+ * enables enforcement; `postConditionMode` defaults to `"deny"`.
+ */
+export type PostConditionOptions = Pick<ContractCallOptions, "postConditions" | "postConditionMode">;
+/** `PostConditionOptions` as the Wasm SDK takes it: conditions already encoded. */
+export type SerializedPostConditions = {
+    postConditions?: string[];
+    postConditionMode?: PostConditionModeName;
+};
+export declare function serializePostConditions(options?: PostConditionOptions): SerializedPostConditions;
+export type CallFn = (contract: string, method: string, args: ClarityValue[], sender: string, options?: PostConditionOptions) => ParsedTransactionResult;
+/** A read-only call moves no assets, so it takes no post-conditions. */
+export type CallReadOnlyFn = (contract: string, method: string, args: ClarityValue[], sender: string) => ParsedTransactionResult;
 export type DeployContractOptions = {
     clarityVersion: ClarityVersion;
 };
-export type DeployContract = (name: string, content: string, options: DeployContractOptions | null, sender: string) => ParsedTransactionResult;
-export type TransferSTX = (amount: number | bigint, recipient: string, sender: string) => ParsedTransactionResult;
+export type DeployContract = (name: string, content: string, options: DeployContractOptions | null, sender: string, postConditionOptions?: PostConditionOptions) => ParsedTransactionResult;
+export type TransferSTX = (amount: number | bigint, recipient: string, sender: string, options?: PostConditionOptions) => ParsedTransactionResult;
+/**
+ * A transaction in a `mineBlock` batch. Post-conditions are already encoded,
+ * because the batch is handed to Wasm as plain JSON.
+ */
 export type Tx = {
     callPublicFn: {
         contract: string;
         method: string;
         args: ClarityValue[];
         sender: string;
-    };
+    } & SerializedPostConditions;
     callPrivateFn?: never;
     deployContract?: never;
     transferSTX?: never;
@@ -49,7 +71,7 @@ export type Tx = {
         method: string;
         args: ClarityValue[];
         sender: string;
-    };
+    } & SerializedPostConditions;
     deployContract?: never;
     transferSTX?: never;
 } | {
@@ -60,7 +82,7 @@ export type Tx = {
         content: string;
         options: DeployContractOptions | null;
         sender: string;
-    };
+    } & SerializedPostConditions;
     transferSTX?: never;
 } | {
     callPublicFn?: never;
@@ -70,13 +92,13 @@ export type Tx = {
         amount: number;
         recipient: string;
         sender: string;
-    };
+    } & SerializedPostConditions;
 };
 export declare const tx: {
-    callPublicFn: (contract: string, method: string, args: ClarityValue[], sender: string) => Tx;
-    callPrivateFn: (contract: string, method: string, args: ClarityValue[], sender: string) => Tx;
-    deployContract: (name: string, content: string, options: DeployContractOptions | null, sender: string) => Tx;
-    transferSTX: (amount: number, recipient: string, sender: string) => Tx;
+    callPublicFn: (contract: string, method: string, args: ClarityValue[], sender: string, options?: PostConditionOptions) => Tx;
+    callPrivateFn: (contract: string, method: string, args: ClarityValue[], sender: string, options?: PostConditionOptions) => Tx;
+    deployContract: (name: string, content: string, options: DeployContractOptions | null, sender: string, postConditionOptions?: PostConditionOptions) => Tx;
+    transferSTX: (amount: number, recipient: string, sender: string, options?: PostConditionOptions) => Tx;
 };
 export declare function parseEvents(events: string): ClarityEvent[];
 export declare function parseCosts(costs: string): ClarityCosts | null;

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

@@ -1,21 +1,53 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.tx = void 0;
+exports.serializePostConditions = serializePostConditions;
 exports.parseEvents = parseEvents;
 exports.parseCosts = parseCosts;
 const transactions_1 = require("@stacks/transactions");
+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"
+                    ? (0, transactions_1.postConditionToHex)(pc)
+                    : (0, transactions_1.serializePostConditionWire)(pc);
+            }),
+        }),
+        ...(mode !== undefined && {
+            postConditionMode: mode === transactions_1.PostConditionMode.Allow
+                ? "allow"
+                : mode === transactions_1.PostConditionMode.Deny
+                    ? "deny"
+                    : mode === transactions_1.PostConditionMode.Originator
+                        ? "originator"
+                        : mode,
+        }),
+    };
+}
 exports.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) },
     }),
 };
 function parseEvents(events) {

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

@@ -1 +1 @@
-{"version":3,"file":"sdkProxyHelpers.js","sourceRoot":"","sources":["../../../../../common/src/sdkProxyHelpers.ts"],"names":[],"mappings":";;;AAiHA,kCAiBC;AAED,gCAwBC;AA5JD,uDAAwE;AA6F3D,QAAA,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,SAAgB,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,iBAAE,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,SAAgB,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/cjs/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/cjs/node/src/debugClient.js

@@ -0,0 +1,242 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DebugClient = void 0;
+exports.startDebugServer = startDebugServer;
+const net = __importStar(require("net"));
+const child_process_1 = require("child_process");
+const transactions_1 = require("@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();
+ * ```
+ */
+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) => transactions_1.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: transactions_1.Cl.stringify(transactions_1.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: transactions_1.Cl.stringify(transactions_1.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
+            }
+        }
+    }
+}
+exports.DebugClient = DebugClient;
+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();
+ * ```
+ */
+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 = (0, child_process_1.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/cjs/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/cjs/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";