@cartesi/cli 2.0.0-alpha.2 → 2.0.0-alpha.21

package/dist/exec/cartesi-machine.d.ts

@@ -1,5 +1,5 @@
-import { Range, SemVer } from "semver";
-import { DockerFallbackOptions, ExecaOptionsDockerFallback } from "./util.js";
+import { Range, type SemVer } from "semver";
+import { type DockerFallbackOptions, type ExecaOptionsDockerFallback } from "./util.js";
 export declare const requiredVersion: Range;
 export declare const boot: (args: readonly string[], options: ExecaOptionsDockerFallback) => Promise<import("execa").Result<import("execa").Options & {
     image?: string;

package/dist/exec/cartesi-machine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cartesi-machine.d.ts","sourceRoot":"","sources":["../../src/exec/cartesi-machine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACH,qBAAqB,EAErB,0BAA0B,EAC7B,MAAM,WAAW,CAAC;AAEnB,eAAO,MAAM,eAAe,OAAuB,CAAC;AAEpD,eAAO,MAAM,IAAI,SACP,SAAS,MAAM,EAAE,WACd,0BAA0B;;;GAGtC,CAAC;AAEF,eAAO,MAAM,OAAO,aACN,qBAAqB,KAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAgBvB,CAAC"}
+{"version":3,"file":"cartesi-machine.d.ts","sourceRoot":"","sources":["../../src/exec/cartesi-machine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,EAAE,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,EAEH,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAClC,MAAM,WAAW,CAAC;AAEnB,eAAO,MAAM,eAAe,OAAuB,CAAC;AAEpD,eAAO,MAAM,IAAI,GACb,MAAM,SAAS,MAAM,EAAE,EACvB,SAAS,0BAA0B;;;GACmB,CAAC;AAE3D,eAAO,MAAM,OAAO,GAChB,UAAU,qBAAqB,KAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAgBvB,CAAC"}

package/dist/exec/cartesi-machine.js

@@ -1,9 +1,7 @@
 import { parse, Range } from "semver";
 import { execaDockerFallback, } from "./util.js";
-export const requiredVersion = new Range("^0.18.1");
-export const boot = async (args, options) => {
-    return execaDockerFallback("cartesi-machine", args, options);
-};
+export const requiredVersion = new Range("^0.19.0");
+export const boot = (args, options) => execaDockerFallback("cartesi-machine", args, options);
 export const version = async (options) => {
     const { image } = options || {};
     try {
@@ -14,7 +12,7 @@ export const version = async (options) => {
         }
         return null;
     }
-    catch (e) {
+    catch {
         return null;
     }
 };

package/dist/exec/genext2fs.d.ts

@@ -1,11 +1,14 @@
-import { Range, SemVer } from "semver";
-import { DockerFallbackOptions } from "./util.js";
+import { Range, type SemVer } from "semver";
+import { type DockerFallbackOptions } from "./util.js";
 export declare const requiredVersion: Range;
 export declare const empty: (options: {
     cwd?: string;
     size: number;
     output: string;
-} & DockerFallbackOptions) => Promise<void>;
+} & DockerFallbackOptions) => Promise<import("execa").Result<import("execa").Options & {
+    image?: string;
+    forceDocker?: false;
+}>>;
 export declare const fromDirectory: (options: {
     cwd?: string;
     extraSize: number;

package/dist/exec/genext2fs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"genext2fs.d.ts","sourceRoot":"","sources":["../../src/exec/genext2fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAuB,MAAM,WAAW,CAAC;AAIvE,eAAO,MAAM,eAAe,EAAE,KAA2B,CAAC;AAU1D,eAAO,MAAM,KAAK,YACL;IACL,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAClB,GAAG,qBAAqB,kBAgB5B,CAAC;AAEF,eAAO,MAAM,aAAa,YACb;IACL,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAClB,GAAG,qBAAqB;;;GAS5B,CAAC;AAEF,eAAO,MAAM,OAAO,YACP;IACL,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAClB,GAAG,qBAAqB;;;GAS5B,CAAC;AAEF,eAAO,MAAM,OAAO,aACN,qBAAqB,KAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAevB,CAAC"}
+{"version":3,"file":"genext2fs.d.ts","sourceRoot":"","sources":["../../src/exec/genext2fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,EAAE,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,EAAE,KAAK,qBAAqB,EAAuB,MAAM,WAAW,CAAC;AAI5E,eAAO,MAAM,eAAe,EAAE,KAA2B,CAAC;AAU1D,eAAO,MAAM,KAAK,GACd,SAAS;IACL,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAClB,GAAG,qBAAqB;;;GAgB5B,CAAC;AAEF,eAAO,MAAM,aAAa,GACtB,SAAS;IACL,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAClB,GAAG,qBAAqB;;;GAS5B,CAAC;AAEF,eAAO,MAAM,OAAO,GAChB,SAAS;IACL,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAClB,GAAG,qBAAqB;;;GAS5B,CAAC;AAEF,eAAO,MAAM,OAAO,GAChB,UAAU,qBAAqB,KAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAevB,CAAC"}

package/dist/exec/genext2fs.js

@@ -9,10 +9,10 @@ const baseArgs = (options) => [
     "--readjustment",
     `+${options.extraBlocks}`,
 ];
-export const empty = async (options) => {
+export const empty = (options) => {
     const { size, output } = options;
     const blocks = Math.ceil(size / BLOCK_SIZE); // size in blocks
-    await execaDockerFallback("xgenext2fs", [
+    return execaDockerFallback("xgenext2fs", [
         "--block-size",
         BLOCK_SIZE.toString(),
         "--faketime",
@@ -21,12 +21,12 @@ export const empty = async (options) => {
         output,
     ], options);
 };
-export const fromDirectory = async (options) => {
+export const fromDirectory = (options) => {
     const { cwd, extraSize, image, input, output } = options;
     const extraBlocks = Math.ceil(extraSize / BLOCK_SIZE);
     return execaDockerFallback("xgenext2fs", [...baseArgs({ extraBlocks }), "--root", input, output], { cwd, image });
 };
-export const fromTar = async (options) => {
+export const fromTar = (options) => {
     const { cwd, extraSize, image, input, output } = options;
     const extraBlocks = Math.ceil(extraSize / BLOCK_SIZE);
     return execaDockerFallback("xgenext2fs", [...baseArgs({ extraBlocks }), "--tarball", input, output], { cwd, image });
@@ -36,7 +36,7 @@ export const version = async (options) => {
     if (typeof stdout === "string") {
         const regex = /(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?/;
         const m = stdout.match(regex);
-        if (m && m[0]) {
+        if (m?.[0]) {
             return parse(m[0]);
         }
     }

package/dist/exec/index.d.ts

@@ -1,5 +1,4 @@
 export * as cartesiMachine from "./cartesi-machine.js";
-export * as crane from "./crane.js";
 export * as genext2fs from "./genext2fs.js";
 export * as mksquashfs from "./mksquashfs.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/exec/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/exec/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/exec/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC"}

package/dist/exec/index.js

@@ -1,4 +1,3 @@
 export * as cartesiMachine from "./cartesi-machine.js";
-export * as crane from "./crane.js";
 export * as genext2fs from "./genext2fs.js";
 export * as mksquashfs from "./mksquashfs.js";

package/dist/exec/mksquashfs.d.ts

@@ -1,5 +1,5 @@
-import { Range, SemVer } from "semver";
-import { DockerFallbackOptions } from "./util.js";
+import { Range, type SemVer } from "semver";
+import { type DockerFallbackOptions } from "./util.js";
 export declare const requiredVersion: Range;
 export declare const fromDirectory: (options: {
     cwd?: string;

package/dist/exec/mksquashfs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mksquashfs.d.ts","sourceRoot":"","sources":["../../src/exec/mksquashfs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAuB,MAAM,WAAW,CAAC;AAIvE,eAAO,MAAM,eAAe,EAAE,KAA2B,CAAC;AAY1D,eAAO,MAAM,aAAa,YACb;IACL,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAClB,GAAG,qBAAqB;;;GAO5B,CAAC;AAEF,eAAO,MAAM,OAAO,YACP;IACL,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAClB,GAAG,qBAAqB;;;GAY5B,CAAC;AAEF,eAAO,MAAM,OAAO,aACN,qBAAqB,KAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAoBvB,CAAC"}
+{"version":3,"file":"mksquashfs.d.ts","sourceRoot":"","sources":["../../src/exec/mksquashfs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,MAAM,EAAS,MAAM,QAAQ,CAAC;AACnD,OAAO,EAAE,KAAK,qBAAqB,EAAuB,MAAM,WAAW,CAAC;AAI5E,eAAO,MAAM,eAAe,EAAE,KAA2B,CAAC;AAc1D,eAAO,MAAM,aAAa,GACtB,SAAS;IACL,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAClB,GAAG,qBAAqB;;;GAO5B,CAAC;AAEF,eAAO,MAAM,OAAO,GAChB,SAAS;IACL,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAClB,GAAG,qBAAqB;;;GAY5B,CAAC;AAEF,eAAO,MAAM,OAAO,GAChB,UAAU,qBAAqB,KAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAoBvB,CAAC"}

package/dist/exec/mksquashfs.js

@@ -1,10 +1,12 @@
-import { parse, Range } from "semver";
+import { Range, parse } from "semver";
 import { execaDockerFallback } from "./util.js";
 const COMPRESSION = "lzo"; // make customizable? default is gzip
 export const requiredVersion = new Range("^4.5.1");
 const baseArgs = () => [
     "-all-time",
     "0",
+    "-mkfs-time",
+    "0",
     "-all-root", // XXX: should we use this?
     "-noappend",
     "-comp",
@@ -32,7 +34,7 @@ export const version = async (options) => {
         if (typeof stdout === "string") {
             const regex = /(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?/gm;
             const m = stdout.match(regex);
-            if (m && m[0]) {
+            if (m?.[0]) {
                 return parse(m[0]);
             }
         }

package/dist/exec/rollups.d.ts

@@ -0,0 +1,105 @@
+import { type Address, type Hash, type Hex } from "viem";
+export type RollupsDeployment = {
+    name: string;
+    address: Address;
+    consensus: Address;
+    templateHash: Hash;
+    epochLength: number;
+    state: "ENABLED" | "DISABLED";
+};
+type ComposeParams = {
+    projectName: string;
+};
+export declare const getDeployments: (options: ComposeParams) => Promise<RollupsDeployment[]>;
+export declare const getApplicationDeployment: (options: ComposeParams) => Promise<RollupsDeployment | undefined>;
+export declare const getApplicationAddress: (options: {
+    projectName?: string;
+}) => Promise<Address | undefined>;
+export declare const AVAILABLE_SERVICES: string[];
+export declare const startEnvironment: (options: {
+    blockTime: number;
+    cpus?: number;
+    defaultBlock: string;
+    dryRun: boolean;
+    memory?: number;
+    port: number;
+    projectName: string;
+    runtimeVersion: string;
+    services: string[];
+    verbose: boolean;
+}) => Promise<{
+    address: string;
+    config: string;
+} | {
+    address: string;
+    config?: undefined;
+}>;
+/**
+ * Wait for the environment to be healthy
+ * @param options
+ */
+export declare const waitHealthyEnvironment: (options: {
+    name?: string;
+    port: number;
+    projectName: string;
+    services: string[];
+}) => Promise<void>;
+/**
+ * Publish machine snapshot to rollups node by copying it to the rollups node container
+ * @param options
+ * @returns path to the snapshot in the rollups node
+ */
+export declare const publishMachine: (options: {
+    projectName: string;
+    templateHash: Hash;
+}) => Promise<string>;
+/**
+ * Stop an environment by removing the containers and volumes
+ * @param options
+ * @returns
+ */
+export declare const stopEnvironment: (options: {
+    projectName: string;
+}) => Promise<import("execa").Result<{}>>;
+/**
+ * Deploy application to rollups node
+ * @param options
+ * @returns address of the application
+ */
+export declare const deployAuthority: (options: {
+    epochLength: number;
+    projectName: string;
+}) => Promise<Address>;
+/**
+ * Deploy application to rollups node
+ * @param options
+ * @returns address of the application
+ */
+export declare const deployApplication: (options: {
+    consensus?: Address;
+    epochLength: number;
+    name: string;
+    projectName: string;
+    salt?: Hex;
+    snapshotPath: string;
+}) => Promise<RollupsDeployment>;
+/**
+ * Remove application from rollups node
+ * @param options
+ * @returns
+ */
+export declare const removeApplication: (options: {
+    application: string | Address;
+    force: boolean;
+    projectName: string;
+}) => Promise<import("execa").Result<{}>>;
+/**
+ * Get the host and port of the docker compose project entrypoint
+ * @param options
+ * @returns port of the proxy service
+ */
+export declare const getProjectPort: (options: {
+    projectName: string;
+}) => Promise<string>;
+export {};
+//# sourceMappingURL=rollups.d.ts.map

package/dist/exec/rollups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollups.d.ts","sourceRoot":"","sources":["../../src/exec/rollups.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,KAAK,OAAO,EACZ,KAAK,IAAI,EACT,KAAK,GAAG,EAGX,MAAM,MAAM,CAAC;AASd,MAAM,MAAM,iBAAiB,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,IAAI,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,GAAG,UAAU,CAAC;CACjC,CAAC;AAWF,KAAK,aAAa,GAAG;IACjB,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAaF,eAAO,MAAM,cAAc,GACvB,SAAS,aAAa,KACvB,OAAO,CAAC,iBAAiB,EAAE,CAgB7B,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACjC,SAAS,aAAa,KACvB,OAAO,CAAC,iBAAiB,GAAG,SAAS,CASvC,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAU,SAAS;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,KAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAI9B,CAAC;AA2FF,eAAO,MAAM,kBAAkB,UAA4C,CAAC;AAgC5E,eAAO,MAAM,gBAAgB,GAAU,SAAS;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CACpB;;;;;;EAkGA,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAU,SAAS;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB,kBA4BA,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAU,SAAS;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,IAAI,CAAC;CACtB,KAAG,OAAO,CAAC,MAAM,CAajB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAU,SAAS;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,wCASrE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAU,SAAS;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACvB,KAAG,OAAO,CAAC,OAAO,CAmBlB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAU,SAAS;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;CACxB,KAAG,OAAO,CAAC,iBAAiB,CAmC5B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAU,SAAS;IAC7C,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACvB,wCAkCA,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAU,SAAS;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,oBAWpE,CAAC"}

package/dist/exec/rollups.js

@@ -0,0 +1,375 @@
+import chalk from "chalk";
+import { execa } from "execa";
+import { Listr } from "listr2";
+import path from "node:path";
+import pRetry from "p-retry";
+import { getAddress, hexToNumber, } from "viem";
+import { getContextPath, getMachineHash, getProjectName, getServiceHealth, } from "../base.js";
+import { DEFAULT_SDK_IMAGE } from "../config.js";
+const parseDeployment = (deployment) => ({
+    address: deployment.iapplication_address,
+    consensus: deployment.iconsensus_address,
+    epochLength: hexToNumber(deployment.epoch_length),
+    name: deployment.name,
+    state: deployment.state,
+    templateHash: deployment.template_hash,
+});
+export const getDeployments = async (options) => {
+    try {
+        const { stdout } = await execa("docker", [
+            "compose",
+            "--project-name",
+            options.projectName,
+            "exec",
+            "rollups-node",
+            "cartesi-rollups-cli",
+            "app",
+            "list",
+        ]);
+        return JSON.parse(stdout).map(parseDeployment);
+    }
+    catch {
+        return [];
+    }
+};
+export const getApplicationDeployment = async (options) => {
+    const machineHash = getMachineHash();
+    if (!machineHash) {
+        return undefined;
+    }
+    const deployments = await getDeployments(options);
+    return deployments.find((deployment) => deployment.templateHash === machineHash);
+};
+export const getApplicationAddress = async (options) => {
+    const projectName = getProjectName(options ?? {});
+    const deployment = await getApplicationDeployment({ projectName });
+    return deployment?.address;
+};
+const host = "http://127.0.0.1";
+// services configuration
+const baseServices = [
+    {
+        name: "anvil",
+        file: "docker-compose-anvil.yaml",
+        healthySemaphore: "anvil",
+        healthyTitle: (port) => `${chalk.cyan("anvil")} service ready at ${chalk.cyan(`${host}:${port}/anvil`)}`,
+        waitTitle: `${chalk.cyan("anvil")} service starting...`,
+        errorTitle: `${chalk.red("anvil")} service failed`,
+    },
+    {
+        name: "proxy",
+        file: "docker-compose-proxy.yaml",
+    },
+    {
+        name: "database",
+        file: "docker-compose-database.yaml",
+    },
+    {
+        name: "rpc",
+        file: "docker-compose-node.yaml",
+        healthySemaphore: "rollups-node",
+        healthyTitle: (port) => `${chalk.cyan("rpc")} service ready at ${chalk.cyan(`${host}:${port}/rpc`)}`,
+        waitTitle: `${chalk.cyan("rpc")} service starting...`,
+        errorTitle: `${chalk.red("rpc")} service failed`,
+    },
+    {
+        name: "inspect",
+        file: "docker-compose-node.yaml",
+        healthySemaphore: "rollups-node",
+        healthyTitle: (port, name) => `${chalk.cyan("inspect")} service ready at ${chalk.cyan(`${host}:${port}/inspect/${name ?? "<application_address>"}`)}`,
+        waitTitle: `${chalk.cyan("inspect")} service starting...`,
+        errorTitle: `${chalk.red("inspect")} service failed`,
+    },
+];
+const availableServices = [
+    {
+        name: "bundler",
+        file: "docker-compose-bundler.yaml",
+        healthySemaphore: "bundler",
+        healthyTitle: (port) => `${chalk.cyan("bundler")} service ready at ${chalk.cyan(`${host}:${port}/bundler/rpc`)}`,
+        waitTitle: `${chalk.cyan("bundler")} service starting...`,
+        errorTitle: `${chalk.red("bundler")} service failed`,
+    },
+    {
+        name: "explorer",
+        file: "docker-compose-explorer.yaml",
+        healthySemaphore: "explorer_api",
+        healthyTitle: (port) => `${chalk.cyan("explorer")} service ready at ${chalk.cyan(`${host}:${port}/explorer`)}`,
+        waitTitle: `${chalk.cyan("explorer")} service starting...`,
+        errorTitle: `${chalk.red("explorer")} service failed`,
+    },
+    {
+        name: "paymaster",
+        file: "docker-compose-paymaster.yaml",
+        healthySemaphore: "paymaster",
+        healthyTitle: (port) => `${chalk.cyan("paymaster")} service ready at ${chalk.cyan(`${host}:${port}/paymaster`)}`,
+        waitTitle: `${chalk.cyan("paymaster")} service starting...`,
+        errorTitle: `${chalk.red("paymaster")} service failed`,
+    },
+    {
+        name: "passkey",
+        file: "docker-compose-passkey-server.yaml",
+        healthySemaphore: "passkey-server",
+        healthyTitle: (port) => `${chalk.cyan("passkey")} service ready at ${chalk.cyan(`${host}:${port}/passkey`)}`,
+        waitTitle: `${chalk.cyan("passkey")} service starting...`,
+        errorTitle: `${chalk.red("passkey")} service failed`,
+    },
+];
+export const AVAILABLE_SERVICES = availableServices.map(({ name }) => name);
+const serviceMonitorTask = (options) => {
+    const { errorTitle, healthyTitle, service, waitTitle } = options;
+    return {
+        task: async (_ctx, task) => {
+            await pRetry(async () => {
+                const health = await getServiceHealth(options);
+                if (health !== "healthy") {
+                    throw new Error(errorTitle ??
+                        `Service ${chalk.cyan(service)} is not healthy`);
+                }
+            }, { retries: 100, minTimeout: 500, factor: 1.1 });
+            task.title =
+                healthyTitle ?? `Service ${chalk.cyan(service)} is ready`;
+        },
+        title: waitTitle ?? `Starting ${chalk.cyan(service)}...`,
+    };
+};
+export const startEnvironment = async (options) => {
+    const { blockTime, cpus, defaultBlock, dryRun, memory, port, projectName, runtimeVersion, services, verbose, } = options;
+    const address = `${host}:${port}`;
+    // path of the tool instalation
+    const binPath = path.join(path.dirname(new URL(import.meta.url).pathname), "..");
+    // setup the environment variable used in docker compose
+    const env = {
+        CARTESI_BIN_PATH: binPath,
+        CARTESI_BLOCK_TIME: blockTime.toString(),
+        CARTESI_BLOCKCHAIN_DEFAULT_BLOCK: defaultBlock,
+        CARTESI_LISTEN_PORT: port.toString(),
+        CARTESI_LOG_LEVEL: verbose ? "debug" : "info",
+        CARTESI_ROLLUPS_NODE_CPUS: cpus?.toString(),
+        CARTESI_ROLLUPS_NODE_MEMORY: memory?.toString(),
+        CARTESI_SDK_IMAGE: `${DEFAULT_SDK_IMAGE}:${runtimeVersion}`,
+        CARTESI_SDK_VERSION: runtimeVersion,
+    };
+    // build a list of unique compose files
+    const composeFiles = [...new Set(baseServices.map(({ file }) => file))];
+    // cpu and memory limits, mostly for testing and debuggingpurposes
+    if (cpus) {
+        composeFiles.push("docker-compose-node-cpus.yaml");
+    }
+    if (memory) {
+        composeFiles.push("docker-compose-node-memory.yaml");
+    }
+    // select subset of optional services
+    const optionalServices = services.length === 1 && services[0] === "all"
+        ? availableServices
+        : availableServices.filter(({ name }) => services.includes(name));
+    // add to compose files list
+    composeFiles.push(...optionalServices.map(({ file }) => file));
+    // create the "--file <file>" list
+    const files = composeFiles.flatMap((f) => [
+        "--file",
+        path.join(binPath, "compose", f),
+    ]);
+    const composeArgs = [
+        "compose",
+        ...files,
+        "--project-directory",
+        ".",
+        "--project-name",
+        projectName,
+    ];
+    // run in detached mode (background)
+    const upArgs = ["--detach"];
+    // if only dry run, just return the config
+    if (dryRun) {
+        // parse, resolve and render compose file in canonical format
+        const { stdout: config } = await execa("docker", [...composeArgs, "config", "--format", "yaml"], { env });
+        return { address, config };
+    }
+    // pull images first
+    const pullArgs = ["--policy", "missing"];
+    await execa("docker", [...composeArgs, "pull", ...pullArgs], {
+        env,
+        stdio: "inherit",
+    });
+    // run compose
+    await execa("docker", [...composeArgs, "up", ...upArgs], {
+        env,
+    });
+    return { address };
+};
+/**
+ * Wait for the environment to be healthy
+ * @param options
+ */
+export const waitHealthyEnvironment = async (options) => {
+    const { name, port, projectName, services } = options;
+    // select subset of optional services
+    const optionalServices = services.length === 1 && services[0] === "all"
+        ? availableServices
+        : availableServices.filter(({ name }) => services.includes(name));
+    // create tasks to monitor services startup
+    const monitorTasks = [...baseServices, ...optionalServices]
+        .filter(({ healthySemaphore }) => !!healthySemaphore) // only services with a healthy semaphore
+        .map((service) => {
+        const healthyTitle = typeof service.healthyTitle === "function"
+            ? service.healthyTitle(port, name)
+            : service.healthyTitle;
+        return serviceMonitorTask({
+            projectName,
+            service: service.healthySemaphore,
+            errorTitle: service.errorTitle,
+            waitTitle: service.waitTitle,
+            healthyTitle,
+        });
+    });
+    const tasks = new Listr(monitorTasks, { concurrent: true });
+    await tasks.run();
+};
+/**
+ * Publish machine snapshot to rollups node by copying it to the rollups node container
+ * @param options
+ * @returns path to the snapshot in the rollups node
+ */
+export const publishMachine = async (options) => {
+    const { projectName, templateHash } = options;
+    const snapshotPath = getContextPath("image");
+    const containerSnapshotPath = `/var/lib/cartesi-rollups-node/snapshots/${templateHash}/`;
+    await execa("docker", [
+        "compose",
+        "--project-name",
+        projectName,
+        "cp",
+        snapshotPath,
+        `rollups-node:${containerSnapshotPath}`,
+    ]);
+    return containerSnapshotPath;
+};
+/**
+ * Stop an environment by removing the containers and volumes
+ * @param options
+ * @returns
+ */
+export const stopEnvironment = async (options) => {
+    const { projectName } = options;
+    return execa("docker", [
+        "compose",
+        "--project-name",
+        projectName,
+        "down",
+        "--volumes",
+    ]);
+};
+/**
+ * Deploy application to rollups node
+ * @param options
+ * @returns address of the application
+ */
+export const deployAuthority = async (options) => {
+    const { epochLength, projectName } = options;
+    // deploy application
+    const { stdout } = await execa("docker", [
+        "compose",
+        "--project-name",
+        projectName,
+        "exec",
+        "rollups-node",
+        "cartesi-rollups-cli",
+        "deploy",
+        "authority",
+        "--epoch-length",
+        epochLength.toString(),
+        "--json",
+    ]);
+    return getAddress(JSON.parse(stdout).address);
+};
+/**
+ * Deploy application to rollups node
+ * @param options
+ * @returns address of the application
+ */
+export const deployApplication = async (options) => {
+    const { consensus, epochLength, name, projectName, salt, snapshotPath } = options;
+    // app deploy args
+    const deployArgs = [name, snapshotPath];
+    if (consensus) {
+        deployArgs.push("--consensus", consensus);
+    }
+    else {
+        deployArgs.push("--epoch-length", epochLength.toString());
+    }
+    if (salt) {
+        deployArgs.push("--salt", salt);
+    }
+    deployArgs.push("--json");
+    // deploy application
+    const { stdout } = await execa("docker", [
+        "compose",
+        "--project-name",
+        projectName,
+        "exec",
+        "rollups-node",
+        "cartesi-rollups-cli",
+        "deploy",
+        "application",
+        ...deployArgs,
+    ]);
+    const deployment = stdout ? parseDeployment(JSON.parse(stdout)) : undefined;
+    if (deployment) {
+        return deployment;
+    }
+    throw new Error("Failed to deploy application");
+};
+/**
+ * Remove application from rollups node
+ * @param options
+ * @returns
+ */
+export const removeApplication = async (options) => {
+    const { application, force, projectName } = options;
+    // disable application first so we can remove it
+    await execa("docker", [
+        "compose",
+        "--project-name",
+        projectName,
+        "exec",
+        "rollups-node",
+        "cartesi-rollups-cli",
+        "app",
+        "status",
+        application,
+        "disabled",
+    ]);
+    const removeArgs = [application];
+    if (force) {
+        removeArgs.push("--force");
+    }
+    return execa("docker", [
+        "compose",
+        "--project-name",
+        projectName,
+        "exec",
+        "rollups-node",
+        "cartesi-rollups-cli",
+        "app",
+        "remove",
+        ...removeArgs,
+    ]);
+};
+/**
+ * Get the host and port of the docker compose project entrypoint
+ * @param options
+ * @returns port of the proxy service
+ */
+export const getProjectPort = async (options) => {
+    const { projectName } = options;
+    const { stdout } = await execa("docker", [
+        "compose",
+        "--project-name",
+        projectName,
+        "port",
+        "proxy",
+        "8088",
+    ]);
+    return stdout;
+};

package/dist/exec/util.d.ts

@@ -1,5 +1,4 @@
-import { SpawnSyncOptions } from "child_process";
-import { Options } from "execa";
+import { type Options } from "execa";
 export type DockerFallbackOptions = {
     image: string;
     forceDocker: true;
@@ -19,18 +18,4 @@ export declare const execaDockerFallback: (command: string, args: readonly strin
     image?: string;
     forceDocker?: false;
 }>>;
-/**
- * Calls spawnSync and falls back to docker run if command (on the host) fails
- * @param command command to be executed
- * @param args arguments to be passed to the command
- * @param options execution options
- * @returns return of execa
- */
-export type SpawnOptionsDockerFallback = SpawnSyncOptions & DockerFallbackOptions;
-export declare const spawnSyncDockerFallback: (command: string, args: readonly string[], options: SpawnOptionsDockerFallback) => import("child_process").SpawnSyncReturns<string | Buffer> | {
-    error: {
-        code: string;
-    };
-    stdout: string;
-};
 //# sourceMappingURL=util.d.ts.map

package/dist/exec/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/exec/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAqB,OAAO,EAAE,MAAM,OAAO,CAAC;AAGnD,MAAM,MAAM,qBAAqB,GAC3B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,IAAI,CAAA;CAAE,GACpC;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,MAAM,0BAA0B,GAAG,OAAO,GAAG,qBAAqB,CAAC;AACzE,eAAO,MAAM,mBAAmB,YACnB,MAAM,QACT,SAAS,MAAM,EAAE,WACd,0BAA0B;YAbvB,MAAM;kBAAgB,KAAK;GAmD1C,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,0BAA0B,GAAG,gBAAgB,GACrD,qBAAqB,CAAC;AAC1B,eAAO,MAAM,uBAAuB,YACvB,MAAM,QACT,SAAS,MAAM,EAAE,WACd,0BAA0B;;;;;CA6CtC,CAAC"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/exec/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AAGxD,MAAM,MAAM,qBAAqB,GAC3B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,IAAI,CAAA;CAAE,GACpC;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,MAAM,0BAA0B,GAAG,OAAO,GAAG,qBAAqB,CAAC;AACzE,eAAO,MAAM,mBAAmB,GAC5B,SAAS,MAAM,EACf,MAAM,SAAS,MAAM,EAAE,EACvB,SAAS,0BAA0B;YAbvB,MAAM;kBAAgB,KAAK;GA6C1C,CAAC"}