@donezone/core 0.1.0

package/README.md

@@ -0,0 +1,34 @@
+# @donezone/core
+
+TypeScript helpers for working with the Done JS contract runtime from Node/Bun tooling.
+
+## Features
+
+- `WasmdClient` – thin wrapper around the `wasmd` binary with typed upload/instantiate helpers
+- `deployJsContract` – convenience function that uploads `cw_js.wasm` and instantiates it with a JS
+  script (as used by the Done runtime)
+- Command utilities for running child processes with predictable error handling
+
+## Example
+
+```ts
+import { deployJsContract } from "@donezone/core";
+
+const result = await deployJsContract({
+  scriptPath: "./packages/demo/contract/tokenSale.js",
+  from: "validator",
+  wasmd: {
+    chainId: "testing",
+    node: "http://127.0.0.1:26657",
+    keyringBackend: "test",
+  },
+});
+
+console.log("Contract address:", result.instantiate.contractAddress);
+```
+
+You can supply `instantiateMsg` or `instantiateMsgPath` to pass custom state, as well as override the
+`cw_js.wasm` path or admin/funds for the instantiate transaction.
+
+The module is used by `@donezone/cli` and can be embedded in custom scripts to automate Done contract
+operations.

package/dist/command.d.ts

@@ -0,0 +1,13 @@
+export interface CommandOptions {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    allowFail?: boolean;
+    stream?: boolean;
+}
+export interface CommandResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export declare function runCommand(cmd: string[], options?: CommandOptions): Promise<CommandResult>;
+//# sourceMappingURL=command.d.ts.map

package/dist/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CA2C9F"}

package/dist/command.js

@@ -0,0 +1,42 @@
+import { spawn } from "node:child_process";
+export function runCommand(cmd, options = {}) {
+    const { cwd, env, allowFail, stream } = options;
+    return new Promise((resolve, reject) => {
+        const child = spawn(cmd[0], cmd.slice(1), {
+            cwd,
+            env: { ...process.env, ...env },
+            stdio: stream ? "inherit" : "pipe",
+        });
+        if (stream) {
+            child.on("close", (exitCode) => {
+                const result = { stdout: "", stderr: "", exitCode: exitCode ?? 0 };
+                if (!allowFail && result.exitCode !== 0) {
+                    reject(new Error(`command failed (${cmd.join(" ")}) with exit code ${result.exitCode}`));
+                }
+                else {
+                    resolve(result);
+                }
+            });
+            child.on("error", reject);
+            return;
+        }
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        child.stdout?.on("data", (chunk) => stdoutChunks.push(Buffer.from(chunk)));
+        child.stderr?.on("data", (chunk) => stderrChunks.push(Buffer.from(chunk)));
+        child.on("close", (exitCode) => {
+            const result = {
+                stdout: Buffer.concat(stdoutChunks).toString("utf8"),
+                stderr: Buffer.concat(stderrChunks).toString("utf8"),
+                exitCode: exitCode ?? 0,
+            };
+            if (!allowFail && result.exitCode !== 0) {
+                reject(new Error(result.stderr || result.stdout || `command failed (${cmd.join(" ")})`));
+            }
+            else {
+                resolve(result);
+            }
+        });
+        child.on("error", reject);
+    });
+}

package/dist/deploy.d.ts

@@ -0,0 +1,20 @@
+import { type WasmdConfig } from "./wasmd.js";
+import type { InstantiateResult, UploadResult } from "./wasmd.js";
+export interface DeployJsContractOptions {
+    scriptPath: string;
+    wasmPath?: string;
+    instantiateMsgPath?: string;
+    instantiateMsg?: Record<string, unknown>;
+    label?: string;
+    from: string;
+    admin?: string;
+    funds?: string;
+    wasmd?: WasmdConfig;
+}
+export interface DeployJsContractResult {
+    upload: UploadResult;
+    instantiate: InstantiateResult;
+    scriptPath: string;
+}
+export declare function deployJsContract(options: DeployJsContractOptions): Promise<DeployJsContractResult>;
+//# sourceMappingURL=deploy.d.ts.map

package/dist/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../src/deploy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAElE,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA0BxG"}

package/dist/deploy.js

@@ -0,0 +1,16 @@
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { WasmdClient } from "./wasmd.js";
+export async function deployJsContract(options) {
+    const { scriptPath, wasmPath = resolve("artifacts", "cw_js.wasm"), instantiateMsgPath, instantiateMsg, label = `done-js-${Date.now()}`, from, admin, funds, wasmd, } = options;
+    const script = readFileSync(resolve(scriptPath), "utf8");
+    const message = instantiateMsg ?? (instantiateMsgPath ? JSON.parse(readFileSync(instantiateMsgPath, "utf8")) : {});
+    const instantiatePayload = {
+        script,
+        msg: message,
+    };
+    const client = new WasmdClient(wasmd);
+    const upload = await client.upload(resolve(wasmPath), from);
+    const instantiate = await client.instantiate(upload.codeId, instantiatePayload, from, label, { admin, funds });
+    return { upload, instantiate, scriptPath: resolve(scriptPath) };
+}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./command.js";
+export * from "./wasmd.js";
+export * from "./deploy.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from "./command.js";
+export * from "./wasmd.js";
+export * from "./deploy.js";

package/dist/wasmd.d.ts

@@ -0,0 +1,34 @@
+import { type CommandOptions } from "./command.js";
+export interface WasmdConfig {
+    binary?: string;
+    home?: string;
+    node?: string;
+    chainId?: string;
+    from?: string;
+    gas?: string;
+    gasPrices?: string;
+    gasAdjustment?: string;
+    broadcastMode?: "block" | "sync" | "async";
+    keyringBackend?: "os" | "file" | "test";
+}
+export interface UploadResult {
+    codeId: string;
+    transactionHash: string;
+}
+export interface InstantiateResult {
+    contractAddress: string;
+    transactionHash: string;
+}
+export declare class WasmdClient {
+    private readonly config;
+    constructor(config?: WasmdConfig);
+    private args;
+    run(base: string[], options?: CommandOptions): Promise<import("./command.js").CommandResult>;
+    upload(wasmPath: string, from: string): Promise<UploadResult>;
+    instantiate(codeId: string, msg: unknown, from: string, label: string, options?: {
+        admin?: string;
+        funds?: string;
+    }): Promise<InstantiateResult>;
+    protected waitForTx(hash: string, attempts?: number, delayMs?: number): Promise<any>;
+}
+//# sourceMappingURL=wasmd.d.ts.map

package/dist/wasmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasmd.d.ts","sourceRoot":"","sources":["../src/wasmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAE/D,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IAC3C,cAAc,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;CACzC;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,GAAE,WAAgB;IAErD,OAAO,CAAC,IAAI;IAoBN,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,cAAmB;IAIhD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA6B7D,WAAW,CACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAC/C,OAAO,CAAC,iBAAiB,CAAC;cA2Cb,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAK,EAAE,OAAO,SAAO,GAAG,OAAO,CAAC,GAAG,CAAC;CAgBrF"}

package/dist/wasmd.js

@@ -0,0 +1,163 @@
+import { runCommand } from "./command.js";
+export class WasmdClient {
+    config;
+    constructor(config = {}) {
+        this.config = config;
+    }
+    args(base) {
+        const binary = this.config.binary ?? "wasmd";
+        const args = [binary, ...base];
+        const command = base[0];
+        if (this.config.home)
+            args.push("--home", this.config.home);
+        if (this.config.node)
+            args.push("--node", this.config.node);
+        if (command === "tx") {
+            if (this.config.chainId)
+                args.push("--chain-id", this.config.chainId);
+            if (this.config.gas)
+                args.push("--gas", this.config.gas);
+            if (this.config.gasPrices)
+                args.push("--gas-prices", this.config.gasPrices);
+            if (this.config.gasAdjustment)
+                args.push("--gas-adjustment", this.config.gasAdjustment);
+            if (this.config.broadcastMode)
+                args.push("--broadcast-mode", this.config.broadcastMode);
+            if (this.config.keyringBackend)
+                args.push("--keyring-backend", this.config.keyringBackend);
+        }
+        return args;
+    }
+    async run(base, options = {}) {
+        return runCommand(this.args(base), options);
+    }
+    async upload(wasmPath, from) {
+        const result = await this.run([
+            "tx",
+            "wasm",
+            "store",
+            wasmPath,
+            "--from",
+            from,
+            "--yes",
+            "--output",
+            "json",
+        ], { allowFail: false });
+        const parsed = JSON.parse(result.stdout);
+        if (parsed.code && Number(parsed.code) !== 0) {
+            throw new Error(parsed.raw_log ?? "store contract failed");
+        }
+        const tx = await this.waitForTx(parsed.txhash);
+        const codeIdAttr = findAttribute([tx, parsed], "code_id", "store_code") ??
+            findAttribute([tx, parsed], "code_id");
+        if (!codeIdAttr?.value) {
+            throw new Error("failed to extract code_id from store_code event");
+        }
+        return { codeId: codeIdAttr.value, transactionHash: parsed.txhash };
+    }
+    async instantiate(codeId, msg, from, label, options = {}) {
+        const instantiateArgs = [
+            "tx",
+            "wasm",
+            "instantiate",
+            codeId,
+            JSON.stringify(msg),
+            "--from",
+            from,
+            "--label",
+            label,
+            "--yes",
+            "--output",
+            "json",
+        ];
+        if (options.admin) {
+            instantiateArgs.push("--admin", options.admin);
+        }
+        else {
+            instantiateArgs.push("--no-admin");
+        }
+        if (options.funds) {
+            instantiateArgs.push("--amount", options.funds);
+        }
+        const result = await this.run(instantiateArgs);
+        const parsed = JSON.parse(result.stdout);
+        if (parsed.code && Number(parsed.code) !== 0) {
+            throw new Error(parsed.raw_log ?? "instantiate failed");
+        }
+        const tx = await this.waitForTx(parsed.txhash);
+        const contractAttr = findAttribute([tx, parsed], "_contract_address", "instantiate") ??
+            findAttribute([tx, parsed], "contract_address", "instantiate") ??
+            findAttribute([tx, parsed], "address", "instantiate") ??
+            findAttribute([tx, parsed], "_contract_address") ??
+            findAttribute([tx, parsed], "contract_address") ??
+            findAttribute([tx, parsed], "address");
+        if (!contractAttr?.value) {
+            throw new Error("failed to extract contract address from instantiate logs");
+        }
+        return { contractAddress: contractAttr.value, transactionHash: parsed.txhash };
+    }
+    async waitForTx(hash, attempts = 30, delayMs = 1000) {
+        for (let i = 0; i < attempts; i++) {
+            const res = await this.run(["query", "tx", hash, "--output", "json"], {
+                allowFail: true,
+            });
+            if (res.exitCode === 0 && res.stdout.trim()) {
+                try {
+                    return JSON.parse(res.stdout);
+                }
+                catch {
+                    // ignore parse error and retry
+                }
+            }
+            await new Promise((resolve) => setTimeout(resolve, delayMs));
+        }
+        throw new Error(`tx (${hash}) not found after ${attempts} attempts`);
+    }
+}
+function findAttribute(source, key, type) {
+    if (!source)
+        return undefined;
+    if (Array.isArray(source)) {
+        for (const item of source) {
+            const match = findAttribute(item, key, type);
+            if (match)
+                return match;
+        }
+        return undefined;
+    }
+    const eventMatch = selectFromEvents(source.events, key, type);
+    if (eventMatch)
+        return eventMatch;
+    const logMatch = selectFromLogs(source.logs, key, type);
+    if (logMatch)
+        return logMatch;
+    if (source.tx_response) {
+        return findAttribute(source.tx_response, key, type);
+    }
+    return undefined;
+}
+function selectFromLogs(logs, key, type) {
+    if (!Array.isArray(logs))
+        return undefined;
+    for (const log of logs) {
+        const match = selectFromEvents(log?.events, key, type);
+        if (match)
+            return match;
+    }
+    return undefined;
+}
+function selectFromEvents(events, key, type) {
+    if (!Array.isArray(events))
+        return undefined;
+    for (const event of events) {
+        if (!event)
+            continue;
+        if (type && event.type !== type)
+            continue;
+        for (const attr of event.attributes ?? []) {
+            if (attr?.key === key)
+                return attr;
+        }
+    }
+    return undefined;
+}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@donezone/core",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "main": "dist/index.js",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rimraf dist",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@donezone/client": "^0.1.0"
+  },
+  "devDependencies": {
+    "rimraf": "^5.0.10",
+    "typescript": "^5.8.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}