@stacks/clarinet-sdk 3.8.1

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

@@ -0,0 +1,61 @@
+import { Cl } from "@stacks/transactions";
+export const tx = {
+    callPublicFn: (contract, method, args, sender) => ({
+        callPublicFn: { contract, method, args, sender },
+    }),
+    callPrivateFn: (contract, method, args, sender) => ({
+        callPrivateFn: { contract, method, args, sender },
+    }),
+    deployContract: (name, content, options, sender) => ({
+        deployContract: { name, content, options, sender },
+    }),
+    transferSTX: (amount, recipient, sender) => ({
+        transferSTX: { amount, recipient, sender },
+    }),
+};
+export function parseEvents(events) {
+    try {
+        // @todo: improve type safety
+        return JSON.parse(events).map((e) => {
+            const { event, data } = JSON.parse(e);
+            if ("raw_value" in data) {
+                data.value = Cl.deserialize(data.raw_value);
+            }
+            return {
+                event: event,
+                data: data,
+            };
+        });
+    }
+    catch (e) {
+        console.error(`Fail to parse events: ${e}`);
+        return [];
+    }
+}
+export function parseCosts(costs) {
+    try {
+        let { memory, memory_limit, total, limit } = JSON.parse(costs);
+        return {
+            memory: memory,
+            memory_limit: memory_limit,
+            total: {
+                writeLength: total.write_length,
+                writeCount: total.write_count,
+                readLength: total.read_length,
+                readCount: total.read_count,
+                runtime: total.runtime,
+            },
+            limit: {
+                writeLength: limit.write_length,
+                writeCount: limit.write_count,
+                readLength: limit.read_length,
+                readCount: limit.read_count,
+                runtime: limit.runtime,
+            },
+        };
+    }
+    catch (_e) {
+        return null;
+    }
+}
+//# sourceMappingURL=sdkProxyHelpers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sdkProxyHelpers.js","sourceRoot":"","sources":["../../../../../common/src/sdkProxyHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAgB,MAAM,sBAAsB,CAAC;AA6FxD,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"}

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

@@ -0,0 +1,15 @@
+export { tx, type ClarityEvent, type ParsedTransactionResult, type DeployContractOptions, type Tx, type TransferSTX, } from "../../common/src/sdkProxyHelpers.js";
+import { Simnet } from "./sdkProxy.js";
+export { type Simnet } from "./sdkProxy.js";
+type Options = {
+    trackCosts: boolean;
+    trackCoverage: boolean;
+    trackPerformance?: boolean;
+};
+export declare function getSDK(options?: Options): Promise<Simnet>;
+export declare const initSimnet: (manifestPath?: string, noCache?: boolean, options?: {
+    trackCosts: boolean;
+    trackCoverage: boolean;
+    trackPerformance?: boolean;
+    performanceCostField?: string;
+}) => Promise<Simnet>;

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

@@ -0,0 +1,30 @@
+import { SDKOptions } from "@stacks/clarinet-sdk-wasm";
+export { tx, } from "../../common/src/sdkProxyHelpers.js";
+import { vfs } from "./vfs.js";
+import { getSessionProxy } from "./sdkProxy.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
+BigInt.prototype.toJSON = function () {
+    return this.toString();
+};
+export async function getSDK(options) {
+    const module = await wasmModule;
+    let sdkOptions = new SDKOptions(!!options?.trackCosts, !!options?.trackCoverage, !!options?.trackPerformance);
+    const simnet = new Proxy(new module.SDK(vfs, sdkOptions), getSessionProxy());
+    return simnet;
+}
+// load wasm only once and memoize it
+function memoizedInit() {
+    let simnet = null;
+    return async (manifestPath = "./Clarinet.toml", noCache = false, options) => {
+        if (noCache || !simnet) {
+            simnet = await getSDK(options);
+        }
+        // start a new simnet session
+        await simnet.initSession(process.cwd(), manifestPath);
+        return simnet;
+    };
+}
+export const initSimnet = memoizedInit();
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,OAAO,EACL,EAAE,GAMH,MAAM,qCAAqC,CAAC;AAE7C,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,UAAU,CAC7B,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,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,eAAe,EAAE,CAAsB,CAAC;IAClG,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,qCAAqC;AACrC,SAAS,YAAY;IACnB,IAAI,MAAM,GAAkB,IAAI,CAAC;IAEjC,OAAO,KAAK,EACV,YAAY,GAAG,iBAAiB,EAChC,OAAO,GAAG,KAAK,EACf,OAKC,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,CAAC,CAAC;QACtD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,EAAE,CAAC"}

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

@@ -0,0 +1,11 @@
+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 | ((cwd: string, manifest_path: string) => Promise<void>) | ((epoch: import("@stacks/clarinet-sdk-wasm").EpochString) => void) | ((count?: number | null) => number) | ((addresses: string[]) => void) | ((recipient: string, amount: bigint) => string) | ((include_boot_contracts: boolean, boot_contracts_path: string) => import("@stacks/clarinet-sdk-wasm").SessionReport);
+};
+export {};

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

@@ -0,0 +1,95 @@
+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,
+    };
+}
+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),
+                                },
+                            };
+                        }
+                        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);
+        },
+    };
+}
+//# sourceMappingURL=sdkProxy.js.map

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

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

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

@@ -0,0 +1,3 @@
+export declare function vfs(action: string, data: unknown): Promise<boolean> | Promise<string> | Promise<{
+    [k: string]: string;
+}> | Promise<void>;

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

@@ -0,0 +1,70 @@
+import * as fs from "node:fs/promises";
+import path from "node:path";
+function fileArrayToString(bufferArray) {
+    return Array.from(bufferArray)
+        .map((item) => String.fromCharCode(item))
+        .join("");
+}
+function isValidReadEvent(e) {
+    return typeof e?.path === "string";
+}
+function isValidReadManyEvent(e) {
+    return Array.isArray(e?.paths) && e.paths.every((s) => typeof s === "string");
+}
+function isValidWriteEvent(e) {
+    return typeof e?.path === "string" && Array.isArray(e?.content);
+}
+async function exists(event) {
+    if (!isValidReadEvent(event))
+        throw new Error("invalid read event");
+    try {
+        await fs.stat(event.path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function readFile(event) {
+    if (!isValidReadEvent(event))
+        throw new Error("invalid read event");
+    return fileArrayToString(await fs.readFile(event.path));
+}
+async function readFiles(event) {
+    if (!isValidReadManyEvent(event))
+        throw new Error("invalid read event");
+    const files = await Promise.all(event.paths.map(async (p) => {
+        try {
+            return fs.readFile(p);
+        }
+        catch (err) {
+            console.warn(err);
+            return null;
+        }
+    }));
+    return Object.fromEntries(files.reduce((acc, f, i) => {
+        if (f === null)
+            return acc;
+        return acc.concat([[event.paths[i], fileArrayToString(f)]]);
+    }, []));
+}
+async function writeFile(event) {
+    if (!isValidWriteEvent(event))
+        throw new Error("invalid write event");
+    const dir = path.dirname(event.path);
+    if (dir !== ".")
+        await fs.mkdir(dir, { recursive: true });
+    return fs.writeFile(event.path, Uint8Array.from(event.content));
+}
+export function vfs(action, data) {
+    if (action === "vfs/exists")
+        return exists(data);
+    if (action === "vfs/readFile")
+        return readFile(data);
+    if (action === "vfs/readFiles")
+        return readFiles(data);
+    if (action === "vfs/writeFile")
+        return writeFile(data);
+    throw new Error("invalid vfs action");
+}
+//# sourceMappingURL=vfs.js.map

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

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

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

@@ -0,0 +1,31 @@
+export declare function getClarinetVitestsArgv(): {
+    [x: string]: unknown;
+    "manifest-path": string;
+    manifestPath: string;
+    "init-before-each": boolean;
+    initBeforeEach: boolean;
+    coverage: boolean;
+    costs: boolean;
+    "coverage-filename": string;
+    coverageFilename: string;
+    "costs-filename": string;
+    costsFilename: string;
+    _: (string | number)[];
+    $0: string;
+} | Promise<{
+    [x: string]: unknown;
+    "manifest-path": string;
+    manifestPath: string;
+    "init-before-each": boolean;
+    initBeforeEach: boolean;
+    coverage: boolean;
+    costs: boolean;
+    "coverage-filename": string;
+    coverageFilename: string;
+    "costs-filename": string;
+    costsFilename: string;
+    _: (string | number)[];
+    $0: string;
+}>;
+export declare const vitestHelpersPath: string;
+export declare const vitestSetupFilePath: string;

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

@@ -0,0 +1,49 @@
+import path from "node:path";
+import url from "node:url";
+import yargs from "yargs";
+import { hideBin } from "yargs/helpers";
+export function getClarinetVitestsArgv() {
+    const argv = hideBin(process.argv);
+    const topLevel = yargs(argv).argv;
+    // @ts-ignore
+    return yargs(topLevel._)
+        .option("manifest-path", {
+        alias: "manifest",
+        type: "string",
+        default: "./Clarinet.toml",
+    })
+        .option("init-before-each", {
+        description: "Reinitialize the Clarinet state before each test",
+        type: "boolean",
+        default: true,
+    })
+        .option("coverage", {
+        alias: "cov",
+        type: "boolean",
+        default: false,
+    })
+        .option("costs", {
+        alias: "cost",
+        type: "boolean",
+        default: false,
+    })
+        .option("coverage-filename", {
+        alias: "cov-file",
+        type: "string",
+        default: "lcov.info",
+    })
+        .option("costs-filename", {
+        alias: "costs-file",
+        type: "string",
+        default: "costs-reports.json",
+    }).argv;
+}
+// ensure vitest helpers can be imported even in workspace setup
+// import.meta.resolve return an url like "file:///absolute/path/to/clarinet-sdk/dist/esm/index.js"
+const sdkURL = import.meta.resolve("@stacks/clarinet-sdk");
+const sdkPath = url.fileURLToPath(sdkURL);
+const sdkDir = path.dirname(sdkPath);
+// sdkDir is in /dist/esm/node/src, hence the ../../../../
+export const vitestHelpersPath = path.join(sdkDir, "../../../../vitest-helpers/src/");
+export const vitestSetupFilePath = path.join(vitestHelpersPath, "vitest.setup.ts");
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/vitest/index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,GAAG,MAAM,UAAU,CAAC;AAE3B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,UAAU,sBAAsB;IACpC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;IAElC,aAAa;IACb,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;SACrB,MAAM,CAAC,eAAe,EAAE;QACvB,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,iBAAiB;KAC3B,CAAC;SACD,MAAM,CAAC,kBAAkB,EAAE;QAC1B,WAAW,EAAE,kDAAkD;QAC/D,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,IAAI;KACd,CAAC;SACD,MAAM,CAAC,UAAU,EAAE;QAClB,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;KACf,CAAC;SACD,MAAM,CAAC,OAAO,EAAE;QACf,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;KACf,CAAC;SACD,MAAM,CAAC,mBAAmB,EAAE;QAC3B,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,WAAW;KACrB,CAAC;SACD,MAAM,CAAC,gBAAgB,EAAE;QACxB,KAAK,EAAE,YAAY;QACnB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,oBAAoB;KAC9B,CAAC,CAAC,IAAI,CAAC;AACZ,CAAC;AAED,gEAAgE;AAChE,mGAAmG;AACnG,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAC3D,MAAM,OAAO,GAAG,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;AAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAErC,0DAA0D;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,iCAAiC,CAAC,CAAC;AACtF,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC"}

package/dist/esm/node/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../../../src/index.ts","../../../src/sdkproxy.ts","../../../src/vfs.ts","../../../src/vitest/index.ts","../../../../common/src/sdkproxyhelpers.ts"],"version":"5.9.2"}

package/dist/esm/package.json

@@ -0,0 +1 @@
+{"type": "module"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@stacks/clarinet-sdk",
+  "version": "3.8.1",
+  "description": "A SDK to interact with Clarity Smart Contracts in node.js",
+  "homepage": "https://stackslabs.com/clarinet",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stx-labs/clarinet.git"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "vitest-helpers/src"
+  ],
+  "main": "./dist/cjs/node/src/index.js",
+  "module": "./dist/esm/node/src/index.js",
+  "types": "./dist/esm/node/src/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/node/src/index.d.ts",
+        "default": "./dist/esm/node/src/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/node/src/index.d.ts",
+        "default": "./dist/cjs/node/src/index.js"
+      }
+    },
+    "./vitest": {
+      "import": {
+        "types": "./dist/esm/node/src/vitest/index.d.ts",
+        "default": "./dist/esm/node/src/vitest/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/node/src/vitest/index.d.ts",
+        "default": "./dist/cjs/node/src/vitest/index.js"
+      }
+    }
+  },
+  "scripts": {
+    "clean": "rimraf dist",
+    "compile": "tsc -b ./tsconfig.json ./tsconfig.cjs.json",
+    "build": "npm run clean && npm run compile && node ./scripts/prepare-esm-package.js",
+    "prepare": "npm run build",
+    "pretest": "tsc -b ./tsconfig.json",
+    "test": "vitest run",
+    "test:no-mxs": "vitest run --exclude=tests/remote-data.test.ts"
+  },
+  "keywords": [
+    "stacks",
+    "clarity",
+    "clarinet",
+    "tests"
+  ],
+  "author": "stacks-labs",
+  "license": "GPL-3.0",
+  "readme": "./README.md",
+  "dependencies": {
+    "@stacks/clarinet-sdk-wasm": "3.8.1",
+    "@stacks/transactions": "^7.0.6",
+    "kolorist": "^1.8.0",
+    "prompts": "^2.4.2",
+    "yargs": "^18.0.0"
+  },
+  "devDependencies": {
+    "@stacks/encryption": "^7.0.0",
+    "@stacks/network": "^7.0.0",
+    "@stacks/stacking": "^7.0.0",
+    "vitest": "^3.0.5"
+  }
+}