@guardian-network/policy-cli 0.3.2

package/README.md

@@ -0,0 +1,32 @@
+# CLI for Policy SDK
+Policy SDK has a bunch of tools and subsystems. Some of them are exposed as a command line utilites.
+
+------------
+
+## LacLang compiler
+The compiler of Lacero Policy Markup language (LacLang).
+Can be invoked via `compile` command.
+Has options:
+* `-p` or `--sourcePath` \
+Defines path to LacLang (`.lac`) sources. __Mandatory option__.
+
+* `-w` or ` --write` \
+Defines path to output file (`.json`). Otherwise the result will be printed to *stdout*.
+
+* `--type-onchain` \
+Checks typings against onchain declarations. Works only if `--rpc` provided or `$RPC` environment variable set.
+
+* `--type-dsl` \
+Checks typings against dsl declarations. Works only if `--rpc` provided or `$RPC` environment variable set.
+
+* `--rpc` \
+Defines `JSON-RPC URL` of the provider to the target blockchain. 
+Can be substituted with `$RPC` environment variable.
+
+Usage example:
+
+As a project:
+> pnpm cli compile --sourcePath ./dsl-sources-sample/DummyValid.lac
+
+As a package:
+> npx @guardian-network/policy-cli compile --sourcePath ./dsl-sources-sample/DummyValid.lac

package/dist/package.json

@@ -0,0 +1,83 @@
+{
+    "name": "@guardian-network/policy-cli",
+    "author": "vpriadko@lacero.io, v.grabovski@lacero.io",
+    "description": "CLI for Policy SDK",
+    "version": "0.3.1",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "files": [
+        "dist",
+        "src"
+    ],
+    "engines": {
+        "node": ">=18.20.4"
+    },
+    "bin": {
+        "policy-cli": "./dist/src/index.js"
+    },
+    "publishConfig": {
+        "registry": "https://npmjs.org",
+        "access": "public"
+    },
+    "scripts": {
+        "build": "pnpm format:all:fix && tsc -p tsconfig-prod.json && pnpm copy-dts",
+        "check": "pnpm lint:ts && pnpm check:ts",
+        "check:ts": "tsc -p tsconfig-prod.json --noEmit",
+        "check:ts:dev": "tsc -p tsconfig.json --noEmit",
+        "clean": "pnpm remove:dist",
+        "cli": "ts-node ./src/index.ts",
+        "copy-dts": "copyfiles -u 1 \"src/**/*.d.ts\" dist",
+        "format:all:fix": "pnpm format:ts:fix",
+        "format:ts:fix": "prettier -w -c \"src/**/*.ts\" \"test/**/*.ts\"",
+        "lint:ts": "eslint",
+        "lint:ts:fix": "eslint --fix",
+        "publish-package": "pnpm publish --no-git-checks",
+        "remove:dist": "npx rimraf dist",
+        "test": "mocha",
+        "tests:coverage:ts": "nyc pnpm test",
+        "version": "pnpm version"
+    },
+    "keywords": [
+        "cli",
+        "policy",
+        "laclang",
+        "sdk",
+        "blockchain"
+    ],
+    "devDependencies": {
+        "@eslint/eslintrc": "^3.1.0",
+        "@eslint/js": "^9.13.0",
+        "@istanbuljs/nyc-config-typescript": "^1.0.2",
+        "@types/chai": "4.3.3",
+        "@types/mocha": "^10.0.9",
+        "@types/node": "^22.8.0",
+        "@typescript-eslint/eslint-plugin": "^8.61.1",
+        "@typescript-eslint/parser": "^8.8.0",
+        "chai": "^4.5.0",
+        "copyfiles": "^2.4.1",
+        "dotenv": "^16.4.5",
+        "eslint": "^9.11.1",
+        "eslint-config-prettier": "^9.1.0",
+        "eslint-import-resolver-typescript": "^3.6.3",
+        "eslint-plugin-import": "^2.31.0",
+        "eslint-plugin-mocha": "^10.5.0",
+        "eslint-plugin-n": "^17.10.3",
+        "eslint-plugin-prettier": "^5.2.1",
+        "eslint-plugin-promise": "^7.1.0",
+        "eslint-plugin-unused-imports": "^4.1.4",
+        "globals": "^15.11.0",
+        "mocha": "^10.8.2",
+        "nyc": "^18.0.0",
+        "prettier": "^3.3.3",
+        "prettier-plugin-organize-imports": "^4.1.0",
+        "rimraf": "^6.0.1",
+        "ts-node": "^10.9.2"
+    },
+    "dependencies": {
+        "@guardian-network/policy-compiler": "workspace:*",
+        "@guardian-network/shared": "workspace:*",
+        "commander": "^12.1.0",
+        "ethers": "^6.16.0",
+        "typescript": "^5.6.2"
+    }
+}

package/dist/src/compiler-module/handler/compile-command.helper.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const compileCommand: (program: Command) => Command;
+//# sourceMappingURL=compile-command.helper.d.ts.map

package/dist/src/compiler-module/handler/compile-command.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-command.helper.d.ts","sourceRoot":"","sources":["../../../../src/compiler-module/handler/compile-command.helper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkDpC,eAAO,MAAM,cAAc,YAAa,OAAO,YAW9C,CAAC"}

package/dist/src/compiler-module/handler/compile-command.helper.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileCommand = void 0;
+const policy_compiler_1 = require("@guardian-network/policy-compiler");
+const ethers_1 = require("ethers");
+const constants_1 = require("../../constants");
+const errors_1 = require("../../errors");
+const options_1 = require("../options");
+const utils_helper_1 = require("./utils.helper");
+const retrieveCompilerOptions = (options) => {
+    let config = {};
+    const { typeDsl, typeOnchain, rpc } = options;
+    if (!!typeOnchain || !!typeDsl) {
+        const rpcEndpoint = rpc || process.env.RPC;
+        if (!rpcEndpoint)
+            throw new errors_1.NoRpcUrlConfiguredError();
+        config = {
+            checkTypesAgainstOnchainDescriptors: !!typeOnchain,
+            checkTypesAgainstDslDeclarations: !!typeDsl,
+            provider: new ethers_1.JsonRpcProvider(rpcEndpoint),
+        };
+    }
+    return config;
+};
+const compile = async (options) => {
+    const compilerOptions = retrieveCompilerOptions(options);
+    const compiler = await policy_compiler_1.LacLangCompiler.fromFile(options.sourcePath, compilerOptions);
+    const compilationOutput = await compiler.compile();
+    if (!!options.write) {
+        (0, utils_helper_1.writeJsonToFile)(options.write, compilationOutput);
+        return;
+    }
+    console.log(`Compilation result: \r\n ${JSON.stringify(compilationOutput, null, 2)}`);
+};
+const compileCommand = (program) => {
+    program
+        .command(constants_1.COMPILE)
+        .requiredOption(...options_1.sourcePathOptions)
+        .option(...options_1.typeOnchainOption)
+        .option(...options_1.typeDslOption)
+        .option(...options_1.rpcEndpointOption)
+        .option(...options_1.writeCompilationResultOption)
+        .action(compile);
+    return program;
+};
+exports.compileCommand = compileCommand;
+//# sourceMappingURL=compile-command.helper.js.map

package/dist/src/compiler-module/handler/compile-command.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-command.helper.js","sourceRoot":"","sources":["../../../../src/compiler-module/handler/compile-command.helper.ts"],"names":[],"mappings":";;;AAAA,uEAAoE;AAGpE,mCAAyC;AACzC,+CAA0C;AAC1C,yCAAuD;AACvD,wCAMoB;AAEpB,iDAAiD;AAEjD,MAAM,uBAAuB,GAAG,CAAC,OAA0B,EAAE,EAAE;IAC7D,IAAI,MAAM,GAA2B,EAAE,CAAC;IACxC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IAE9C,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;QAC3C,IAAI,CAAC,WAAW;YAAE,MAAM,IAAI,gCAAuB,EAAE,CAAC;QAEtD,MAAM,GAAG;YACP,mCAAmC,EAAE,CAAC,CAAC,WAAW;YAClD,gCAAgC,EAAE,CAAC,CAAC,OAAO;YAC3C,QAAQ,EAAE,IAAI,wBAAe,CAAC,WAAW,CAAC;SAC3C,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,OAAO,GAAG,KAAK,EAAE,OAA0B,EAAE,EAAE;IACnD,MAAM,eAAe,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAc,MAAM,iCAAe,CAAC,QAAQ,CACxD,OAAO,CAAC,UAAU,EAClB,eAAe,CAChB,CAAC;IACF,MAAM,iBAAiB,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;IAEnD,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACpB,IAAA,8BAAe,EAAC,OAAO,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;QAClD,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CACT,4BAA4B,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CACzE,CAAC;AACJ,CAAC,CAAC;AAEK,MAAM,cAAc,GAAG,CAAC,OAAgB,EAAE,EAAE;IACjD,OAAO;SACJ,OAAO,CAAC,mBAAO,CAAC;SAChB,cAAc,CAAC,GAAG,2BAAiB,CAAC;SACpC,MAAM,CAAC,GAAG,2BAAiB,CAAC;SAC5B,MAAM,CAAC,GAAG,uBAAa,CAAC;SACxB,MAAM,CAAC,GAAG,2BAAiB,CAAC;SAC5B,MAAM,CAAC,GAAG,sCAA4B,CAAC;SACvC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEnB,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAXW,QAAA,cAAc,kBAWzB"}

package/dist/src/compiler-module/handler/index.d.ts

@@ -0,0 +1,2 @@
+export { compileCommand } from './compile-command.helper';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/compiler-module/handler/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/compiler-module/handler/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/src/compiler-module/handler/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileCommand = void 0;
+var compile_command_helper_1 = require("./compile-command.helper");
+Object.defineProperty(exports, "compileCommand", { enumerable: true, get: function () { return compile_command_helper_1.compileCommand; } });
+//# sourceMappingURL=index.js.map

package/dist/src/compiler-module/handler/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/compiler-module/handler/index.ts"],"names":[],"mappings":";;;AAAA,mEAA0D;AAAjD,wHAAA,cAAc,OAAA"}

package/dist/src/compiler-module/handler/utils.helper.d.ts

@@ -0,0 +1,2 @@
+export declare const writeJsonToFile: (filePath: string, data: object) => void;
+//# sourceMappingURL=utils.helper.d.ts.map

package/dist/src/compiler-module/handler/utils.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.helper.d.ts","sourceRoot":"","sources":["../../../../src/compiler-module/handler/utils.helper.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,eAAe,aAAc,MAAM,QAAQ,MAAM,KAAG,IAKhE,CAAC"}

package/dist/src/compiler-module/handler/utils.helper.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeJsonToFile = void 0;
+const node_fs_1 = require("node:fs");
+const writeJsonToFile = (filePath, data) => {
+    const jsonData = JSON.stringify(data, null, 2);
+    (0, node_fs_1.writeFileSync)(filePath, jsonData, { flag: 'w' });
+    console.log(`Compilation result is successfully written to "${filePath}"`);
+};
+exports.writeJsonToFile = writeJsonToFile;
+//# sourceMappingURL=utils.helper.js.map

package/dist/src/compiler-module/handler/utils.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.helper.js","sourceRoot":"","sources":["../../../../src/compiler-module/handler/utils.helper.ts"],"names":[],"mappings":";;;AACA,qCAAwC;AAEjC,MAAM,eAAe,GAAG,CAAC,QAAgB,EAAE,IAAY,EAAQ,EAAE;IACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAE/C,IAAA,uBAAa,EAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,CAAC,kDAAkD,QAAQ,GAAG,CAAC,CAAC;AAC7E,CAAC,CAAC;AALW,QAAA,eAAe,mBAK1B"}

package/dist/src/compiler-module/index.d.ts

@@ -0,0 +1,2 @@
+export { compileCommand } from './handler';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/compiler-module/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/compiler-module/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/src/compiler-module/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileCommand = void 0;
+var handler_1 = require("./handler");
+Object.defineProperty(exports, "compileCommand", { enumerable: true, get: function () { return handler_1.compileCommand; } });
+//# sourceMappingURL=index.js.map

package/dist/src/compiler-module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/compiler-module/index.ts"],"names":[],"mappings":";;;AAAA,qCAA2C;AAAlC,yGAAA,cAAc,OAAA"}

package/dist/src/compiler-module/options/index.d.ts

@@ -0,0 +1,2 @@
+export * from './options';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/compiler-module/options/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/compiler-module/options/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}

package/dist/src/compiler-module/options/index.js

@@ -0,0 +1,18 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./options"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/compiler-module/options/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/compiler-module/options/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B"}

package/dist/src/compiler-module/options/options.d.ts

@@ -0,0 +1,6 @@
+export declare const typeOnchainOption: [string, string];
+export declare const typeDslOption: [string, string];
+export declare const rpcEndpointOption: [string, string];
+export declare const writeCompilationResultOption: [string, string];
+export declare const sourcePathOptions: [string, string];
+//# sourceMappingURL=options.d.ts.map

package/dist/src/compiler-module/options/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../../src/compiler-module/options/options.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,CAG9C,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,CAG1C,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,CAG9C,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,CAAC,MAAM,EAAE,MAAM,CAGzD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,CAG9C,CAAC"}

package/dist/src/compiler-module/options/options.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sourcePathOptions = exports.writeCompilationResultOption = exports.rpcEndpointOption = exports.typeDslOption = exports.typeOnchainOption = void 0;
+exports.typeOnchainOption = [
+    '--type-onchain',
+    '[OPTIONAL] Triggers types checking via onchain artifacts description, equivalent to checkTypesAgainstOnchain = true',
+];
+exports.typeDslOption = [
+    '--type-dsl',
+    '[OPTIONAL] Triggers types checking via dsl definitions, equivalent to checkTypesAgainstDeclaration = true',
+];
+exports.rpcEndpointOption = [
+    '--rpc <URL>',
+    '[OPTIONAL, if --type-*] JSON RPC URL is required for type checking communication. Otherwise the value from $RPC env variable is consumed',
+];
+exports.writeCompilationResultOption = [
+    '-w, --write <outputPath>',
+    '[OPTIONAL] Writes compilation output as JSON to dedicated file',
+];
+exports.sourcePathOptions = [
+    '-p, --sourcePath <lacFilePath>',
+    'Path to LacLang (*.lac) sources',
+];
+//# sourceMappingURL=options.js.map

package/dist/src/compiler-module/options/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../../src/compiler-module/options/options.ts"],"names":[],"mappings":";;;AAAa,QAAA,iBAAiB,GAAqB;IACjD,gBAAgB;IAChB,qHAAqH;CACtH,CAAC;AAEW,QAAA,aAAa,GAAqB;IAC7C,YAAY;IACZ,2GAA2G;CAC5G,CAAC;AAEW,QAAA,iBAAiB,GAAqB;IACjD,aAAa;IACb,0IAA0I;CAC3I,CAAC;AAEW,QAAA,4BAA4B,GAAqB;IAC5D,0BAA0B;IAC1B,gEAAgE;CACjE,CAAC;AAEW,QAAA,iBAAiB,GAAqB;IACjD,gCAAgC;IAChC,iCAAiC;CAClC,CAAC"}

package/dist/src/compiler-module/options/types.d.ts

@@ -0,0 +1,12 @@
+type CompileOptionsBase = {
+    typeDsl: string;
+    typeOnchain: string;
+    rpc: string;
+    write: string;
+    sourcePath: string;
+};
+export type CliCompileOptions = Partial<CompileOptionsBase> & {
+    sourcePath: string;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/compiler-module/options/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/compiler-module/options/types.ts"],"names":[],"mappings":"AAAA,KAAK,kBAAkB,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,GAAG;IAC5D,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC"}

package/dist/src/compiler-module/options/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/src/compiler-module/options/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/compiler-module/options/types.ts"],"names":[],"mappings":""}

package/dist/src/constants/commands.d.ts

@@ -0,0 +1,2 @@
+export declare const COMPILE = "compile";
+//# sourceMappingURL=commands.d.ts.map

package/dist/src/constants/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/constants/commands.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,YAAY,CAAC"}

package/dist/src/constants/commands.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMPILE = void 0;
+exports.COMPILE = 'compile';
+//# sourceMappingURL=commands.js.map

package/dist/src/constants/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/constants/commands.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,SAAS,CAAC"}

package/dist/src/constants/index.d.ts

@@ -0,0 +1,2 @@
+export * from './commands';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/constants/index.d.ts.map

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

package/dist/src/constants/index.js

@@ -0,0 +1,18 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./commands"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/constants/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B"}

package/dist/src/errors/cli-errors.d.ts

@@ -0,0 +1,4 @@
+export declare class NoRpcUrlConfiguredError extends Error {
+    constructor();
+}
+//# sourceMappingURL=cli-errors.d.ts.map

package/dist/src/errors/cli-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-errors.d.ts","sourceRoot":"","sources":["../../../src/errors/cli-errors.ts"],"names":[],"mappings":"AAAA,qBAAa,uBAAwB,SAAQ,KAAK;;CAMjD"}

package/dist/src/errors/cli-errors.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoRpcUrlConfiguredError = void 0;
+class NoRpcUrlConfiguredError extends Error {
+    constructor() {
+        const msg = `Need to provide JSON RPC URL to use typing validations`;
+        super(msg);
+    }
+}
+exports.NoRpcUrlConfiguredError = NoRpcUrlConfiguredError;
+//# sourceMappingURL=cli-errors.js.map

package/dist/src/errors/cli-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-errors.js","sourceRoot":"","sources":["../../../src/errors/cli-errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,uBAAwB,SAAQ,KAAK;IAChD;QACE,MAAM,GAAG,GAAG,wDAAwD,CAAC;QAErE,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;CACF;AAND,0DAMC"}

package/dist/src/errors/index.d.ts

@@ -0,0 +1,2 @@
+export * from './cli-errors';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/errors/index.d.ts.map

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

package/dist/src/errors/index.js

@@ -0,0 +1,18 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./cli-errors"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B"}

package/dist/src/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":""}

package/dist/src/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const dotenv_1 = require("dotenv");
+const package_json_1 = require("../package.json");
+const compiler_module_1 = require("./compiler-module");
+(0, dotenv_1.config)();
+const program = new commander_1.Command();
+program
+    .name('Guardian-network Policy CLI')
+    .description('CLI tools for a LacLang Policy composition language')
+    .version(package_json_1.version);
+(0, compiler_module_1.compileCommand)(program);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;AAIA,yCAAoC;AACpC,mCAAgC;AAChC,kDAA0C;AAC1C,uDAAmD;AAEnD,IAAA,eAAM,GAAE,CAAC;AAET,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,6BAA6B,CAAC;KACnC,WAAW,CAAC,qDAAqD,CAAC;KAClE,OAAO,CAAC,sBAAO,CAAC,CAAC;AAEpB,IAAA,gCAAc,EAAC,OAAO,CAAC,CAAC;AAExB,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@guardian-network/policy-cli",
+  "author": "vpriadko@lacero.io, v.grabovski@lacero.io",
+  "description": "CLI for Policy SDK",
+  "version": "0.3.2",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "engines": {
+    "node": ">=18.20.4"
+  },
+  "bin": {
+    "policy-cli": "./dist/src/index.js"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "keywords": [
+    "cli",
+    "policy",
+    "laclang",
+    "sdk",
+    "blockchain"
+  ],
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.1.0",
+    "@eslint/js": "^9.13.0",
+    "@istanbuljs/nyc-config-typescript": "^1.0.2",
+    "@types/chai": "4.3.3",
+    "@types/mocha": "^10.0.9",
+    "@types/node": "^22.8.0",
+    "@typescript-eslint/eslint-plugin": "^8.61.1",
+    "@typescript-eslint/parser": "^8.8.0",
+    "chai": "^4.5.0",
+    "copyfiles": "^2.4.1",
+    "dotenv": "^16.4.5",
+    "eslint": "^9.11.1",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-import-resolver-typescript": "^3.6.3",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-mocha": "^10.5.0",
+    "eslint-plugin-n": "^17.10.3",
+    "eslint-plugin-prettier": "^5.2.1",
+    "eslint-plugin-promise": "^7.1.0",
+    "eslint-plugin-unused-imports": "^4.1.4",
+    "globals": "^15.11.0",
+    "mocha": "^10.8.2",
+    "nyc": "^18.0.0",
+    "prettier": "^3.3.3",
+    "prettier-plugin-organize-imports": "^4.1.0",
+    "rimraf": "^6.0.1",
+    "ts-node": "^10.9.2"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "ethers": "^6.16.0",
+    "typescript": "^5.6.2",
+    "@guardian-network/policy-compiler": "0.3.2",
+    "@guardian-network/shared": "0.3.2"
+  },
+  "scripts": {
+    "build": "pnpm format:all:fix && tsc -p tsconfig-prod.json && pnpm copy-dts",
+    "check": "pnpm lint:ts && pnpm check:ts",
+    "check:ts": "tsc -p tsconfig-prod.json --noEmit",
+    "check:ts:dev": "tsc -p tsconfig.json --noEmit",
+    "clean": "pnpm remove:dist",
+    "cli": "ts-node ./src/index.ts",
+    "copy-dts": "copyfiles -u 1 \"src/**/*.d.ts\" dist",
+    "format:all:fix": "pnpm format:ts:fix",
+    "format:ts:fix": "prettier -w -c \"src/**/*.ts\" \"test/**/*.ts\"",
+    "lint:ts": "eslint",
+    "lint:ts:fix": "eslint --fix",
+    "publish-package": "pnpm publish --no-git-checks",
+    "remove:dist": "npx rimraf dist",
+    "test": "mocha",
+    "tests:coverage:ts": "nyc pnpm test",
+    "version": "pnpm version"
+  }
+}

package/src/compiler-module/handler/compile-command.helper.ts

@@ -0,0 +1,64 @@
+import { LacLangCompiler } from '@guardian-network/policy-compiler';
+import { ICompiler, LacLangCompilerOptions } from '@guardian-network/shared';
+import { Command } from 'commander';
+import { JsonRpcProvider } from 'ethers';
+import { COMPILE } from '../../constants';
+import { NoRpcUrlConfiguredError } from '../../errors';
+import {
+  rpcEndpointOption,
+  sourcePathOptions,
+  typeDslOption,
+  typeOnchainOption,
+  writeCompilationResultOption,
+} from '../options';
+import { CliCompileOptions } from '../options/types';
+import { writeJsonToFile } from './utils.helper';
+
+const retrieveCompilerOptions = (options: CliCompileOptions) => {
+  let config: LacLangCompilerOptions = {};
+  const { typeDsl, typeOnchain, rpc } = options;
+
+  if (!!typeOnchain || !!typeDsl) {
+    const rpcEndpoint = rpc || process.env.RPC;
+    if (!rpcEndpoint) throw new NoRpcUrlConfiguredError();
+
+    config = {
+      checkTypesAgainstOnchainDescriptors: !!typeOnchain,
+      checkTypesAgainstDslDeclarations: !!typeDsl,
+      provider: new JsonRpcProvider(rpcEndpoint),
+    };
+  }
+
+  return config;
+};
+
+const compile = async (options: CliCompileOptions) => {
+  const compilerOptions = retrieveCompilerOptions(options);
+  const compiler: ICompiler = await LacLangCompiler.fromFile(
+    options.sourcePath,
+    compilerOptions,
+  );
+  const compilationOutput = await compiler.compile();
+
+  if (!!options.write) {
+    writeJsonToFile(options.write, compilationOutput);
+    return;
+  }
+
+  console.log(
+    `Compilation result: \r\n ${JSON.stringify(compilationOutput, null, 2)}`,
+  );
+};
+
+export const compileCommand = (program: Command) => {
+  program
+    .command(COMPILE)
+    .requiredOption(...sourcePathOptions)
+    .option(...typeOnchainOption)
+    .option(...typeDslOption)
+    .option(...rpcEndpointOption)
+    .option(...writeCompilationResultOption)
+    .action(compile);
+
+  return program;
+};

package/src/compiler-module/handler/index.ts

@@ -0,0 +1 @@
+export { compileCommand } from './compile-command.helper';

package/src/compiler-module/handler/utils.helper.ts

@@ -0,0 +1,9 @@
+// eslint-disable-next-line import/no-nodejs-modules
+import { writeFileSync } from 'node:fs';
+
+export const writeJsonToFile = (filePath: string, data: object): void => {
+  const jsonData = JSON.stringify(data, null, 2);
+
+  writeFileSync(filePath, jsonData, { flag: 'w' });
+  console.log(`Compilation result is successfully written to "${filePath}"`);
+};

package/src/compiler-module/index.ts

@@ -0,0 +1 @@
+export { compileCommand } from './handler';

package/src/compiler-module/options/index.ts

@@ -0,0 +1 @@
+export * from './options';

package/src/compiler-module/options/options.ts

@@ -0,0 +1,24 @@
+export const typeOnchainOption: [string, string] = [
+  '--type-onchain',
+  '[OPTIONAL] Triggers types checking via onchain artifacts description, equivalent to checkTypesAgainstOnchain = true',
+];
+
+export const typeDslOption: [string, string] = [
+  '--type-dsl',
+  '[OPTIONAL] Triggers types checking via dsl definitions, equivalent to checkTypesAgainstDeclaration = true',
+];
+
+export const rpcEndpointOption: [string, string] = [
+  '--rpc <URL>',
+  '[OPTIONAL, if --type-*] JSON RPC URL is required for type checking communication. Otherwise the value from $RPC env variable is consumed',
+];
+
+export const writeCompilationResultOption: [string, string] = [
+  '-w, --write <outputPath>',
+  '[OPTIONAL] Writes compilation output as JSON to dedicated file',
+];
+
+export const sourcePathOptions: [string, string] = [
+  '-p, --sourcePath <lacFilePath>',
+  'Path to LacLang (*.lac) sources',
+];

package/src/compiler-module/options/types.ts

@@ -0,0 +1,11 @@
+type CompileOptionsBase = {
+  typeDsl: string;
+  typeOnchain: string;
+  rpc: string;
+  write: string;
+  sourcePath: string;
+};
+
+export type CliCompileOptions = Partial<CompileOptionsBase> & {
+  sourcePath: string;
+};

package/src/constants/commands.ts

@@ -0,0 +1 @@
+export const COMPILE = 'compile';

package/src/constants/index.ts

@@ -0,0 +1 @@
+export * from './commands';

package/src/errors/cli-errors.ts

@@ -0,0 +1,7 @@
+export class NoRpcUrlConfiguredError extends Error {
+  constructor() {
+    const msg = `Need to provide JSON RPC URL to use typing validations`;
+
+    super(msg);
+  }
+}

package/src/errors/index.ts

@@ -0,0 +1 @@
+export * from './cli-errors';

package/src/index.ts

@@ -0,0 +1,21 @@
+// note: the hashbang is required when 'node --harmony' is applied (which is support for es6);
+// otherwise it is redundant
+/* #!/usr/bin/env node */
+
+import { Command } from 'commander';
+import { config } from 'dotenv';
+import { version } from '../package.json';
+import { compileCommand } from './compiler-module';
+
+config();
+
+const program = new Command();
+
+program
+  .name('Guardian-network Policy CLI')
+  .description('CLI tools for a LacLang Policy composition language')
+  .version(version);
+
+compileCommand(program);
+
+program.parse();