@riaskov/iohtee-abi-wrapper 2.0.0

package/README.md

@@ -0,0 +1,21 @@
+# IohTee ABI Wrapper
+
+[![Module type: ESM](https://img.shields.io/badge/module%20type-ESM-brightgreen)]()
+[![Target: Node20](https://img.shields.io/badge/Node.js->=20-brightgreen)]()
+[![Target: ES2022](https://img.shields.io/badge/target-ES2022-brightgreen)]()
+
+IohTee ABI Wrapper is a TypeScript wrapper for EVM-compatible ABI of Solidity smartcontract.
+It takes raw json artifact file and render ready-to-use TS-wrapper. Use viem v2 internally.
+
+## Run
+
+```bash
+ $ iohtee-abi-wrapper -o ./output ./abi 
+```
+
+## TODO
+- add postprocess with prettier
+- TS-wrapper docs autogen
+- add errors and library references handling
+- generate d.ts and min.js wrapper files
+- add solidity comments to wrapper

package/dist/abiWrapper.d.ts

@@ -0,0 +1,8 @@
+export declare class AbiWrapper {
+    templatesDir: string;
+    outputDir: string;
+    pattern: string;
+    minify: boolean;
+    constructor(pattern: string, outputDir: string, minify?: boolean);
+    run(): Promise<void>;
+}

package/dist/abiWrapper.js

@@ -0,0 +1,33 @@
+import fs from 'node:fs';
+import ContractTemplate from './contractTemplate.js';
+import { globSync } from 'glob';
+import { mkdirp } from 'mkdirp';
+import path from 'node:path';
+export class AbiWrapper {
+    templatesDir;
+    outputDir;
+    pattern;
+    minify;
+    constructor(pattern, outputDir, minify) {
+        this.pattern = pattern;
+        this.templatesDir = path.join(import.meta.dirname, '../templates');
+        this.outputDir = outputDir;
+        this.minify = !!minify;
+    }
+    async run() {
+        if (!fs.existsSync(this.outputDir)) {
+            mkdirp.sync(this.outputDir);
+        }
+        const fileNames = globSync(this.pattern);
+        if (fileNames.length) {
+            fileNames.forEach((fileName) => {
+                let transformer = new ContractTemplate(this.templatesDir, this.outputDir);
+                transformer.render(fileName, this.minify);
+            });
+        }
+        else {
+            throw new Error(`No Truffle Contract artifact found at ${this.pattern}`);
+        }
+    }
+}
+//# sourceMappingURL=abiWrapper.js.map

package/dist/abiWrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abiWrapper.js","sourceRoot":"src/","sources":["abiWrapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,gBAAgB,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAQ,QAAQ,EAAE,MAAM,MAAM,CAAA;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,MAAM,OAAO,UAAU;IACrB,YAAY,CAAQ;IACpB,SAAS,CAAQ;IACjB,OAAO,CAAQ;IACf,MAAM,CAAS;IAEf,YAAY,OAAe,EAAE,SAAiB,EAAE,MAAgB;QAC9D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAA;QAClE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAA;IACxB,CAAC;IAED,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAC7B,CAAC;QACD,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACxC,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;YACrB,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;gBAC7B,IAAI,WAAW,GAAG,IAAI,gBAAgB,CACpC,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,SAAS,CACf,CAAA;gBACD,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;YAC3C,CAAC,CAAC,CAAA;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,yCAAyC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;QAC1E,CAAC;IACH,CAAC;CACF"}

package/dist/bin/iohtee-abi-wrapper.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/iohtee-abi-wrapper.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import yargs from 'yargs';
+import { AbiWrapper } from '../index.js';
+let args = yargs(process.argv.slice(2))
+    .option('output', {
+    describe: 'Folder for generated files',
+    alias: 'o',
+})
+    .option('minify', {
+    describe: 'Also render minified JS-wrapper',
+    alias: 'm',
+}).argv;
+const pattern = args._[0];
+const outputDir = args['output'];
+const minify = args['minify'];
+let abiWrapper = new AbiWrapper(pattern, outputDir, minify);
+abiWrapper
+    .run()
+    .then(() => {
+    // Do Nothing
+})
+    .catch((error) => {
+    console.error(error);
+    process.exit(1);
+});
+//# sourceMappingURL=iohtee-abi-wrapper.js.map

package/dist/bin/iohtee-abi-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iohtee-abi-wrapper.js","sourceRoot":"src/","sources":["bin/iohtee-abi-wrapper.ts"],"names":[],"mappings":";AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,IAAI,IAAI,GAAQ,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KACzC,MAAM,CAAC,QAAQ,EAAE;IAChB,QAAQ,EAAE,4BAA4B;IACtC,KAAK,EAAE,GAAG;CACX,CAAC;KACD,MAAM,CAAC,QAAQ,EAAE;IAChB,QAAQ,EAAE,iCAAiC;IAC3C,KAAK,EAAE,GAAG;CACX,CAAC,CAAC,IAAI,CAAA;AAET,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACzB,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAA;AAChC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAA;AAE7B,IAAI,UAAU,GAAG,IAAI,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAA;AAC3D,UAAU;KACP,GAAG,EAAE;KACL,IAAI,CAAC,GAAG,EAAE;IACT,aAAa;AACf,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,KAAY,EAAE,EAAE;IACtB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/context.d.ts

@@ -0,0 +1,13 @@
+import { AbiEvent, AbiFunction } from 'viem';
+export interface MethodAbi extends AbiFunction {
+    singleReturnValue: boolean;
+}
+export default interface Context {
+    artifact: string;
+    abi: string;
+    contractName: string;
+    relativeArtifactPath: string;
+    getters: Array<AbiFunction>;
+    functions: Array<AbiFunction>;
+    events: Array<AbiEvent>;
+}

package/dist/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/contractTemplate.d.ts

@@ -0,0 +1,14 @@
+import Handlebars from 'handlebars';
+import Context from './context.js';
+export default class ContractTemplate {
+    handlebars: typeof Handlebars;
+    templatesDir: string;
+    outputDir: string;
+    private _template?;
+    constructor(templatesDir: string, outputDir: string);
+    get template(): Handlebars.TemplateDelegate<Context>;
+    registerPartials(): void;
+    registerHelpers(): void;
+    render(abiFilePath: string, minified?: boolean): void;
+    protected readTemplate(name: string): string;
+}

package/dist/contractTemplate.js

@@ -0,0 +1,117 @@
+import path from 'node:path';
+import fs from 'node:fs';
+import { build } from 'esbuild';
+import Handlebars from 'handlebars';
+import * as helpers from './helpers.js';
+const ABI_TYPE_FUNCTION = 'function';
+const ABI_TYPE_EVENT = 'event';
+function isAbiFunction(abi) {
+    return abi.type === ABI_TYPE_FUNCTION;
+}
+function isAbiEvent(abi) {
+    return abi.type === ABI_TYPE_EVENT;
+}
+export default class ContractTemplate {
+    handlebars;
+    templatesDir;
+    outputDir;
+    _template;
+    constructor(templatesDir, outputDir) {
+        this.handlebars = Handlebars.create();
+        this.templatesDir = templatesDir;
+        this.outputDir = outputDir;
+        this.registerPartials();
+        this.registerHelpers();
+    }
+    get template() {
+        if (this._template) {
+            return this._template;
+        }
+        else {
+            let contents = this.readTemplate('contract.mustache');
+            this._template = this.handlebars.compile(contents, {
+                noEscape: true,
+            });
+            return this._template;
+        }
+    }
+    registerPartials() {
+        fs.readdirSync(this.templatesDir).forEach((file) => {
+            let match = file.match(/^_(\w+)\.(handlebars|mustache)/);
+            if (match) {
+                this.handlebars.registerPartial(match[1], this.readTemplate(file));
+            }
+        });
+    }
+    registerHelpers() {
+        this.handlebars.registerHelper('inputType', helpers.inputType);
+        this.handlebars.registerHelper('outputType', helpers.outputType);
+    }
+    render(abiFilePath, minified) {
+        let artifact = JSON.parse(fs.readFileSync(abiFilePath).toString());
+        const sourceAbi = JSON.stringify(artifact.abi);
+        let abi = artifact.abi;
+        if (abi) {
+            let methods = abi.filter(isAbiFunction).map((abi) => {
+                if (abi.outputs.length === 1) {
+                    abi.singleReturnValue = true;
+                }
+                abi.inputs = abi.inputs.map((input, index) => {
+                    input.name = input.name ? input.name : `param${index}`;
+                    return input;
+                });
+                return abi;
+            });
+            const nameCount = {};
+            methods = methods.map((abi) => {
+                const originalName = abi.name;
+                if (nameCount[originalName] >= 0) {
+                    nameCount[originalName]++;
+                    abi['namePostfix'] = nameCount[originalName];
+                }
+                else {
+                    nameCount[originalName] = 0;
+                }
+                return abi;
+            });
+            let getters = methods.filter((abi) => abi.stateMutability === 'view' || abi.stateMutability === 'pure');
+            let functions = methods.filter((abi) => abi.stateMutability !== 'view' && abi.stateMutability !== 'pure');
+            let events = abi.filter(isAbiEvent);
+            let contractName = path.parse(abiFilePath).name;
+            const basename = path.basename(abiFilePath, path.extname(abiFilePath));
+            const filePath = `${this.outputDir}/${basename}Contract.ts`;
+            const relativeArtifactPath = path.relative(this.outputDir, abiFilePath);
+            let context = {
+                artifact: JSON.stringify(artifact, null, 2),
+                abi: JSON.stringify(sourceAbi),
+                contractName: contractName,
+                relativeArtifactPath: relativeArtifactPath,
+                getters: getters,
+                functions: functions,
+                events: events,
+            };
+            let code = this.template(context);
+            fs.writeFileSync(filePath, code);
+            if (minified) {
+                build({
+                    entryPoints: [filePath],
+                    outfile: `${filePath}.min.js`,
+                    bundle: false,
+                    minify: true,
+                    format: 'esm',
+                    platform: 'node',
+                    sourcemap: false,
+                    target: ['es2020'],
+                }).then();
+            }
+        }
+        else {
+            throw new Error(`No ABI found in ${abiFilePath}.`);
+        }
+    }
+    readTemplate(name) {
+        let file = path.resolve(this.templatesDir, name);
+        return fs.readFileSync(file).toString();
+    }
+}
+//# sourceMappingURL=contractTemplate.js.map

package/dist/contractTemplate.js.map

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

package/dist/helpers.d.ts

@@ -0,0 +1,2 @@
+export declare function inputType(solidityType: string, components?: Array<any>): string;
+export declare function outputType(solidityType: string): string;

package/dist/helpers.js

@@ -0,0 +1,43 @@
+const TYPE_MAPPING = [
+    { regex: '^string$', tsType: 'string' },
+    { regex: '^address$', tsType: '`0x${string}`' },
+    { regex: '^bool$', tsType: 'boolean' },
+    { regex: '^u?int\\d*$', tsType: 'bigint' },
+    { regex: '^bytes\\d*$', tsType: '`0x${string}`' },
+];
+const INPUT_TYPE_MAPPING = [
+    { regex: '^u?int(8|16|32|64|128|256)?$', tsType: 'bigint' },
+].concat(TYPE_MAPPING);
+const ARRAY_BRACES = /\[\d*]$/;
+function isArray(solidityType) {
+    return !!solidityType.match(ARRAY_BRACES);
+}
+function isTuple(solidityType) {
+    return !!solidityType.match('tuple');
+}
+function typeConversion(types, solidityType, components) {
+    if (isArray(solidityType)) {
+        const solidityItemType = solidityType.replace(ARRAY_BRACES, '');
+        const type = typeConversion(types, solidityItemType);
+        return `${type}[]`;
+    }
+    else if (isTuple(solidityType) && components) {
+        return `[${components.map((e) => inputType(e.type)).join(' ,')}]`;
+    }
+    else {
+        let mapping = types.find((mapping) => !!solidityType.match(mapping.regex));
+        if (mapping) {
+            return mapping.tsType;
+        }
+        else {
+            throw new Error(`Unknown Solidity type found: ${solidityType}`);
+        }
+    }
+}
+export function inputType(solidityType, components) {
+    return typeConversion(INPUT_TYPE_MAPPING, solidityType, components);
+}
+export function outputType(solidityType) {
+    return typeConversion(TYPE_MAPPING, solidityType);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"src/","sources":["helpers.ts"],"names":[],"mappings":"AAKA,MAAM,YAAY,GAAG;IACnB,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE;IACvC,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE;IAC/C,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE;IACtC,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE;IAC1C,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE;CAClD,CAAA;AAED,MAAM,kBAAkB,GAAG;IACzB,EAAE,KAAK,EAAE,8BAA8B,EAAE,MAAM,EAAE,QAAQ,EAAE;CAC5D,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;AAEtB,MAAM,YAAY,GAAG,SAAS,CAAA;AAE9B,SAAS,OAAO,CAAC,YAAoB;IACnC,OAAO,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;AAC3C,CAAC;AAED,SAAS,OAAO,CAAC,YAAoB;IACnC,OAAO,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;AACtC,CAAC;AAED,SAAS,cAAc,CACrB,KAAqB,EACrB,YAAoB,EACpB,UAAuB;IAEvB,IAAI,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAC1B,MAAM,gBAAgB,GAAG,YAAY,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAA;QAC/D,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAA;QACpD,OAAO,GAAG,IAAI,IAAI,CAAA;IACpB,CAAC;SAAM,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,UAAU,EAAE,CAAC;QAC/C,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAA;IACnE,CAAC;SAAM,CAAC;QACN,IAAI,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;QAC1E,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,OAAO,CAAC,MAAM,CAAA;QACvB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,gCAAgC,YAAY,EAAE,CAAC,CAAA;QACjE,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,YAAoB,EACpB,UAAuB;IAEvB,OAAO,cAAc,CAAC,kBAAkB,EAAE,YAAY,EAAE,UAAU,CAAC,CAAA;AACrE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,YAAoB;IAC7C,OAAO,cAAc,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;AACnD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { AbiWrapper } from './abiWrapper.js';

package/dist/index.js

@@ -0,0 +1,2 @@
+export { AbiWrapper } from './abiWrapper.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"src/","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@riaskov/iohtee-abi-wrapper",
+  "version": "2.0.0",
+  "description": "Generate TypeScript wrapper class for Solidity smart contract ABI",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/ARyaskov/iohtee#readme",
+  "bugs": {
+    "url": "https://github.com/ARyaskov/iohtee/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ARyaskov/iohtee.git"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": "dist/bin/iohtee-abi-wrapper.js",
+  "files": [
+    "dist/",
+    "templates/"
+  ],
+  "scripts": {
+    "demo": "tsx src/bin/iohtee-abi-wrapper.ts ./abi/* -m -o ../contracts/src/abi-wrapper/",
+    "build": "yarn format && yarn clean && tsc --project tsconfig.json",
+    "clean": "rimraf dist",
+    "test": "exit 0",
+    "coverage": "exit 0",
+    "format": "npx prettier --write \"src/**/*.ts\""
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "console.table": "^0.10.0",
+    "esbuild": "^0.21.5",
+    "glob": "^10.4.2",
+    "handlebars": "^4.7.8",
+    "mkdirp": "^3.0.1",
+    "viem": "*",
+    "yargs": "^17.7.2"
+  },
+  "devDependencies": {
+    "@types/yargs": "^17.0.32",
+    "rimraf": "*"
+  }
+}

package/templates/_event_enum.mustache

@@ -0,0 +1 @@
+{{this.name}} = "{{this.name}}"{{#unless @last}}, {{/unless}}

package/templates/_event_types.mustache

@@ -0,0 +1,10 @@
+export interface {{this.name}} {
+{{#if inputs}}
+  args: {
+    {{#each inputs}}
+    {{name}}: {{#inputType type}}{{/inputType}}
+    {{/each}}
+  }
+{{/if}}
+}
+

package/templates/_event_utils.mustache

@@ -0,0 +1,3 @@
+is{{this.name}}Event (something: AbiEvent): boolean {
+  return something.name === "{{this.name}}"
+}

package/templates/_filter.mustache

@@ -0,0 +1,3 @@
+{{this.name}}: {
+  ({{#if inputs}}filter: { {{#each inputs}}{{name}}?: {{#inputType type}}{{/inputType}}{{#unless @last}}, {{/unless}}{{/each}} }, {{/if}}options?: any): any
+}

package/templates/_function.mustache

@@ -0,0 +1,21 @@
+async {{this.name}}{{this.namePostfix}}({{> method_input inputs=inputs trailingComma=true}}options?: TxOptions): Promise<TransactionReceipt>{
+  const { request } = await this.publicClient().simulateContract({
+    chain: this.walletClient().chain,
+    address: this.address(),
+    abi: this.abi(),
+    functionName: "{{this.name}}",
+    args: [
+      {{> params inputs=inputs}}
+    ],
+    account: this.walletClient().account,
+    value: options?.value,
+  })
+  const txId = await this.walletClient().writeContract(request)
+
+  return await this.publicClient().waitForTransactionReceipt({
+      hash: txId,
+      confirmations: 3,
+      timeout: 45_000,
+    })
+}
+

package/templates/_getter.mustache

@@ -0,0 +1,10 @@
+async {{this.name}}{{this.namePostfix}}({{> method_input inputs=inputs}}): Promise<{{> method_output outputs=outputs}}> {
+  return (await this.publicClient().readContract({
+    address: this.address(),
+    abi: this.abi(),
+    functionName: "{{this.name}}",
+    args: [
+      {{> params inputs=inputs}}
+    ],
+  })) as never as {{> method_output outputs=outputs}}
+}

package/templates/_method_input.mustache

@@ -0,0 +1,4 @@
+{{~#if inputs~}}
+{{~#each inputs~}}{{name}}: {{#inputType type components}} {{/inputType}}{{#unless @last}}, {{/unless}}{{~/each~}}
+{{~#if trailingComma~}}, {{/if}}
+{{~/if~}}

package/templates/_method_output.mustache

@@ -0,0 +1,10 @@
+{{~#if outputs~}}
+{{~#singleReturnValue~}}
+  {{#outputType outputs.0.type}}{{/outputType}}
+{{~/singleReturnValue~}}
+{{~^singleReturnValue~}}
+  [{{#each outputs}}{{#outputType type}}{{/outputType}}{{#unless @last}}, {{/unless}}{{/each}}]
+{{~/singleReturnValue~}}
+{{~else~}}
+  void
+{{~/if~}}

package/templates/_params.mustache

@@ -0,0 +1 @@
+{{#each inputs}}{{name}}{{#unless @last}}, {{/unless}}{{/each}}

package/templates/contract.mustache

@@ -0,0 +1,209 @@
+import {
+  Abi,
+  AbiEvent,
+  createPublicClient,
+  createWalletClient,
+  getContract,
+  http,
+  PublicClient,
+  WalletClient,
+  GetContractReturnType,
+  TransactionReceipt,
+  parseEventLogs,
+  ParseEventLogsReturnType,
+  extractChain
+} from "viem"
+import { mnemonicToAccount } from "viem/accounts"
+import * as chains from "viem/chains"
+
+export interface TxOptions {
+  value?: bigint
+}
+
+export type CtorBaseParams = {
+  cachePeriod?: number
+}
+
+export type CtorAccountParamPure = CtorBaseParams & {
+  httpRpcUrl: string
+  networkId: number
+  mnemonic: string
+  hdPath: `m/44'/60'/${string}`
+}
+
+export type CtorAccountParamViem = CtorBaseParams & {
+  publicClientViem: PublicClient
+  walletClientViem: WalletClient
+}
+
+export function isCtorAccountParamPure(
+  params: CtorBaseParams,
+): params is CtorAccountParamPure {
+  return (
+    (params as CtorAccountParamPure).httpRpcUrl !== undefined &&
+    (params as CtorAccountParamPure).mnemonic !== undefined
+    )
+}
+
+export type CtorParams = CtorAccountParamPure | CtorAccountParamViem
+
+export interface {{contractName}}Event {
+  eventName: string
+  args: any
+  address: `0x${string}`
+  blockHash: `0x${string}`
+  blockNumber: bigint
+  data: `0x${string}`
+  logIndex: number
+  removed: boolean
+  topics: [] | [`0x${string}`, ...`0x${string}`[]]
+  transactionHash: `0x${string}`
+  transactionIndex: number
+}
+
+{{#each events}}
+{{> event_types contractName=../contractName}}
+{{/each}}
+
+export enum {{contractName}}EventName {
+{{#each events}}
+  {{> event_enum contractName=../contractName}}
+{{/each}}
+}
+
+const abi = JSON.parse(`{{abi}}`)
+
+export class {{contractName}}Contract {
+  private readonly _publicClient: PublicClient
+  private readonly _walletClient: WalletClient
+  private readonly _address: `0x${string}`
+  private readonly _contract: GetContractReturnType
+  private readonly _abi: any
+
+/// GETTERS
+{{#each getters}}
+  {{> getter contractName=../contractName}}
+
+{{/each}}
+
+/// SETTERS
+{{#each functions}}
+  {{> function contractName=../contractName}}
+
+{{/each}}
+
+/// EVENTS
+{{#each events}}
+  {{> event_utils contractName=../contractName}}
+
+{{/each}}
+
+  static parseLogs(receipt: TransactionReceipt): ParseEventLogsReturnType {
+    const logs = parseEventLogs({
+      abi: abi as any,
+      logs: receipt.logs,
+    })
+    return logs as any
+  }
+
+  static hasEvent(receipt: TransactionReceipt, eventName: {{contractName}}EventName): boolean {
+    return parseEventLogs({ abi: abi, logs: receipt.logs }).some((log: any) => log.eventName === eventName)
+  }
+
+  static extractEventFromReceipt<T>(receipt: TransactionReceipt, eventName: {{contractName}}EventName): T {
+    return parseEventLogs({ abi: abi, logs: receipt.logs }).find((log: any) => log.eventName === eventName) as T
+  }
+
+  static parseEvents(receipt: TransactionReceipt): {{contractName}}Event[] {
+    return parseEventLogs({ abi: abi, logs: receipt.logs }).map((log: any) => {
+      return {
+        eventName: log.eventName,
+        args: log.args,
+        address: log.address,
+        blockHash: log.blockHash,
+        blockNumber: log.blockNumber,
+        data: log.data,
+        logIndex: log.logIndex,
+        removed: log.removed,
+        topics: log.topics,
+        transactionHash: log.transactionHash,
+        transactionIndex: log.transactionIndex,
+      }
+    })
+  }
+
+  constructor(deployedContractAddress: `0x${string}`, params: CtorParams) {
+    this._address = deployedContractAddress
+
+    if (isCtorAccountParamPure(params)) {
+      let network = extractChain({
+        chains: Object.values(chains) as any,
+        id: params.networkId,
+      })
+      // @ts-ignore
+      this._publicClient = createPublicClient({
+        batch: {
+           multicall: true,
+        },
+        // @ts-ignore
+        chain: network as any,
+        transport: http(
+          params.httpRpcUrl,
+          {
+            batch: true,
+          }
+        ),
+      })
+      this._walletClient = createWalletClient({
+        // @ts-ignore
+        chain: network as any,
+        transport: http(
+          params.httpRpcUrl,
+          {
+             batch: true,
+          }
+        ),
+        account: mnemonicToAccount(params.mnemonic, { path: params.hdPath }),
+      })
+    } else {
+      this._publicClient = params.publicClientViem
+      this._walletClient = params.walletClientViem
+    }
+
+    this._abi = abi
+
+    this._contract = getContract({
+      address: this._address,
+      abi: this._abi,
+      client: {
+        public: this._publicClient as never,
+        wallet: this._walletClient as never,
+      },
+    })
+
+  }
+
+  publicClient(): PublicClient {
+    return this._publicClient
+  }
+
+  walletClient(): WalletClient {
+    return this._walletClient
+  }
+
+  contract(): GetContractReturnType {
+    return this._contract
+  }
+
+  address(): `0x${string}` {
+    return this._address
+  }
+
+  abi(): Abi {
+    return this._abi
+  }
+
+  events(): AbiEvent[] {
+    return this.abi().filter((e) => e.type === 'event') as AbiEvent[]
+  }
+}