@eosrio/node-abieos 3.3.4-a9d3362 → 4.0.1-2039717

package/dist/abieos.js

@@ -1,91 +1,230 @@
-// lib/abieos.ts
-import { createRequire } from "module";
-var abieos = createRequire(import.meta.url)("./abieos.node");
-var Abieos = class _Abieos {
-  static instance;
-  static native;
-  constructor() {
-    if (_Abieos.instance) {
-      throw new Error("This class is a Singleton!");
-    }
-    _Abieos.native = abieos;
-  }
-  static getInstance() {
-    if (!_Abieos.instance) {
-      _Abieos.instance = new _Abieos();
-    }
-    return _Abieos.instance;
-  }
-  stringToName(nameString) {
-    return _Abieos.native.string_to_name(nameString);
-  }
-  jsonToHex(contractName, type, json) {
-    const jsonData = typeof json === "object" ? JSON.stringify(json) : json;
-    const data = _Abieos.native.json_to_hex(contractName, type, jsonData);
-    if (data === "PARSING_ERROR") {
-      throw new Error("failed to parse data");
-    } else {
-      return data;
-    }
-  }
-  hexToJson(contractName, type, hex) {
-    const data = _Abieos.native.hex_to_json(contractName, type, hex);
-    if (data) {
-      try {
-        return JSON.parse(data);
-      } catch (e) {
-        throw new Error("failed to parse json string: " + data);
-      }
-    } else {
-      throw new Error("failed to parse hex data");
-    }
-  }
-  binToJson(contractName, type, buffer) {
-    const data = _Abieos.native.bin_to_json(contractName, type, buffer);
-    if (data[0] === "{" || data[0] === "[") {
-      try {
-        return JSON.parse(data);
-      } catch (e) {
-        throw new Error("json parse error");
-      }
-    } else {
-      throw new Error(data);
-    }
-  }
-  loadAbi(contractName, abi) {
-    if (typeof abi === "string") {
-      return _Abieos.native.load_abi(contractName, abi);
-    } else {
-      if (typeof abi === "object") {
-        return _Abieos.native.load_abi(contractName, JSON.stringify(abi));
-      } else {
-        throw new Error("ABI must be a String or Object");
-      }
-    }
-  }
-  loadAbiHex(contractName, abihex) {
-    return _Abieos.native.load_abi_hex(contractName, abihex);
-  }
-  getTypeForAction(contractName, actionName) {
-    const result = _Abieos.native.get_type_for_action(contractName, actionName);
-    if (result === "NOT_FOUND") {
-      throw new Error(`[node-abieos] action ` + actionName + " not found on contract " + contractName);
-    } else {
-      return result;
-    }
-  }
-  getTypeForTable(contractName, table_name) {
-    const result = _Abieos.native.get_type_for_table(contractName, table_name);
-    if (result === "NOT_FOUND") {
-      throw new Error(`[node-abieos] table ` + table_name + " not found on contract " + contractName);
-    } else {
-      return result;
-    }
-  }
-  deleteContract(contractName) {
-    return _Abieos.native.delete_contract(contractName);
-  }
-};
-export {
-  Abieos
-};
+// lib/abieos.ts
+import { createRequire } from "module";
+var abieos = createRequire(import.meta.url)("./abieos.node");
+var Abieos = class _Abieos {
+  static logTag = "[node-abieos]";
+  static instance;
+  static native;
+  static loadedContracts = /* @__PURE__ */ new Map();
+  static debug = false;
+  /**
+   * Private constructor to enforce the Singleton pattern.
+   * Throws an error if an attempt is made to create a second instance.
+   */
+  constructor() {
+    if (_Abieos.instance) {
+      throw new Error(`${_Abieos.logTag} Abieos is a Singleton class. Use Abieos.getInstance() to get the instance.`);
+    }
+    _Abieos.native = abieos;
+  }
+  /**
+   * Returns the singleton instance of the Abieos class.
+   * If an instance does not already exist, it creates one.
+   * @returns {Abieos} The singleton instance of Abieos.
+   */
+  static getInstance() {
+    if (!_Abieos.instance) {
+      _Abieos.instance = new _Abieos();
+    }
+    return _Abieos.instance;
+  }
+  getLoadedAbis() {
+    return Array.from(_Abieos.loadedContracts.keys());
+  }
+  /**
+   * Cleans up all loaded contracts by deleting them from the native context.
+   * This is useful for freeing up resources and ensuring a clean state.
+   */
+  cleanup() {
+    const errors = [];
+    _Abieos.loadedContracts.forEach((_, contractName) => {
+      try {
+        if (_Abieos.debug) {
+          console.log(`${_Abieos.logTag} Cleaning up contract '${contractName}'...`);
+        }
+        _Abieos.native.delete_contract(contractName);
+        _Abieos.loadedContracts.delete(contractName);
+      } catch (e) {
+        errors.push({ contractName, error: e.message });
+        console.error(`${_Abieos.logTag} Failed to delete contract '${contractName}' during cleanup: ${e.message}`);
+      }
+    });
+    if (errors.length > 0) {
+      throw new Error(`${_Abieos.logTag} Errors during cleanup: ${JSON.stringify(errors)}`);
+    }
+  }
+  /**
+   * Converts a string name to its corresponding 64-bit unsigned integer representation (BigInt).
+   * @param {string} nameString The string name to convert.
+   * @returns {BigInt} The BigInt representation of the name.
+   */
+  stringToName(nameString) {
+    try {
+      return _Abieos.native.string_to_name(nameString);
+    } catch (e) {
+      throw new Error(`${_Abieos.logTag} Failed to convert string to name '${nameString}': ${e.message}`);
+    }
+  }
+  /**
+   * Converts a JSON string or object to its hexadecimal binary representation.
+   * @param {string} contractName The name of the contract.
+   * @param {string} type The type within the ABI to use for conversion.
+   * @param {string | object} json The JSON data as a string or object.
+   * @returns {string} The hexadecimal string representation of the binary data.
+   * @throws {Error} If parsing fails or an error occurs in the native module.
+   */
+  jsonToHex(contractName, type, json) {
+    const jsonData = typeof json === "object" ? JSON.stringify(json) : json;
+    try {
+      return _Abieos.native.json_to_hex(contractName, type, jsonData);
+    } catch (e) {
+      throw new Error(`${_Abieos.logTag} Failed to convert JSON to hex for contract '${contractName}', type '${type}': ${e.message}`);
+    }
+  }
+  /**
+   * Converts a hexadecimal binary string to its JSON representation.
+   * @param {string} contractName The name of the contract.
+   * @param {string} type The type within the ABI to use for conversion.
+   * @param {string} hex The hexadecimal string to convert.
+   * @returns {any} The parsed JSON object.
+   * @throws {Error} If parsing fails or an error occurs in the native module.
+   */
+  hexToJson(contractName, type, hex) {
+    try {
+      const data = _Abieos.native.hex_to_json(contractName, type, hex);
+      try {
+        return JSON.parse(data);
+      } catch (parseError) {
+        throw new Error(`${_Abieos.logTag} Failed to parse JSON string from hex for contract '${contractName}', type '${type}'. Received: ${data}. Parse error: ${parseError.message}`);
+      }
+    } catch (e) {
+      throw new Error(`${_Abieos.logTag} Native error when converting hex to JSON for contract '${contractName}', type '${type}': ${e.message}`);
+    }
+  }
+  /**
+   * Converts a binary buffer to its JSON representation.
+   * @param {string} contractName The name of the contract.
+   * @param {string} type The type within the ABI to use for conversion.
+   * @param {Buffer} buffer The binary data as a Buffer.
+   * @returns {any} The parsed JSON object.
+   * @throws {Error} If parsing fails or an error occurs in the native module.
+   */
+  binToJson(contractName, type, buffer) {
+    try {
+      const data = _Abieos.native.bin_to_json(contractName, type, buffer);
+      try {
+        return JSON.parse(data);
+      } catch (parseError) {
+        throw new Error(`${_Abieos.logTag} Failed to parse JSON string from binary for contract '${contractName}', type '${type}'. Received: ${data}. Parse error: ${parseError.message}`);
+      }
+    } catch (e) {
+      throw new Error(`${_Abieos.logTag} Native error when converting binary to JSON for contract '${contractName}', type '${type}': ${e.message}`);
+    }
+  }
+  /**
+   * Loads an ABI for a given contract.
+   * @param {string} contractName The name of the contract for which to load the ABI.
+   * @param {string | object} abi The ABI as a JSON string or object.
+   * @returns {boolean} True if the ABI was loaded successfully, false otherwise.
+   * @throws {Error} If the ABI format is invalid or loading fails.
+   */
+  loadAbi(contractName, abi) {
+    if (_Abieos.debug && _Abieos.loadedContracts.has(contractName)) {
+      console.info(`${_Abieos.logTag} Contract '${contractName}' is already loaded. Updating ABI...`);
+    }
+    const abiString = typeof abi === "object" ? JSON.stringify(abi) : abi;
+    if (typeof abiString !== "string") {
+      throw new Error(`${_Abieos.logTag} ABI must be a String or Object.`);
+    }
+    try {
+      const loaded = _Abieos.native.load_abi(contractName, abiString);
+      if (loaded) {
+        _Abieos.loadedContracts.set(contractName, Date.now());
+        if (_Abieos.debug) {
+          console.log(`${_Abieos.logTag} Loaded ABI for contract '${contractName}'.`);
+        }
+      }
+      return loaded;
+    } catch (e) {
+      throw new Error(`${_Abieos.logTag} Failed to load ABI for contract '${contractName}': ${e.message}`);
+    }
+  }
+  /**
+   * Loads an ABI for a given contract from its hexadecimal representation.
+   * @param {string} contractName The name of the contract for which to load the ABI.
+   * @param {string} abihex The ABI as a hexadecimal string.
+   * @returns {boolean} True if the ABI was loaded successfully, false otherwise.
+   * @throws {Error} If loading fails.
+   */
+  loadAbiHex(contractName, abihex) {
+    if (typeof abihex !== "string") {
+      throw new Error(`${_Abieos.logTag} ABI hex must be a String.`);
+    }
+    if (_Abieos.debug && _Abieos.loadedContracts.has(contractName)) {
+      console.info(`${_Abieos.logTag} Contract '${contractName}' is already loaded. Updating ABI...`);
+    }
+    try {
+      const loaded = _Abieos.native.load_abi_hex(contractName, abihex);
+      if (loaded) {
+        _Abieos.loadedContracts.set(contractName, Date.now());
+        if (_Abieos.debug) {
+          console.log(`${_Abieos.logTag} Loaded ABI hex for contract '${contractName}'.`);
+        }
+      }
+      return loaded;
+    } catch (e) {
+      throw new Error(`${_Abieos.logTag} Failed to load ABI hex for contract '${contractName}': ${e.message}`);
+    }
+  }
+  /**
+   * Retrieves the type name for a specific action within a contract's ABI.
+   * @param {string} contractName The name of the contract.
+   * @param {string} actionName The name of the action.
+   * @returns {string} The type name associated with the action.
+   * @throws {Error} If the contract or action is not found or another error occurs.
+   */
+  getTypeForAction(contractName, actionName) {
+    try {
+      return _Abieos.native.get_type_for_action(contractName, actionName);
+    } catch (e) {
+      throw new Error(`${_Abieos.logTag} Failed to get type for action '${actionName}' in contract '${contractName}': ${e.message}`);
+    }
+  }
+  /**
+   * Retrieves the type name for a specific table within a contract's ABI.
+   * @param {string} contractName The name of the contract.
+   * @param {string} table_name The name of the table.
+   * @returns {string} The type name associated with the table.
+   * @throws {Error} If the contract or table is not found or another error occurs.
+   */
+  getTypeForTable(contractName, table_name) {
+    try {
+      return _Abieos.native.get_type_for_table(contractName, table_name);
+    } catch (e) {
+      throw new Error(`${_Abieos.logTag} Failed to get type for table '${table_name}' in contract '${contractName}': ${e.message}`);
+    }
+  }
+  /**
+   * Deletes a contract's ABI from the abieos context.
+   * @param {string} contractName The name of the contract to delete.
+   * @returns {boolean} True if the contract was successfully deleted, false otherwise.
+   * @throws {Error} If deletion fails.
+   */
+  deleteContract(contractName) {
+    try {
+      const deleted = _Abieos.native.delete_contract(contractName);
+      if (deleted) {
+        _Abieos.loadedContracts.delete(contractName);
+        if (_Abieos.debug) {
+          console.log(`${_Abieos.logTag} Deleted contract '${contractName}' from abieos context.`);
+        }
+      }
+      return deleted;
+    } catch (e) {
+      throw new Error(`${_Abieos.logTag} Failed to delete contract '${contractName}': ${e.message}`);
+    }
+  }
+};
+export {
+  Abieos
+};

package/dist/abieos.ts

@@ -1,18 +1,35 @@
 import { createRequire } from "module";
 const abieos = createRequire(import.meta.url)('./abieos.node');
 
+/**
+ * Abieos class provides a singleton instance for interacting with the native abieos module.
+ * This pattern is used to ensure a single global context for the underlying C++ abieos library,
+ * which manages internal state and resources.
+ */
 export class Abieos {
-    
+
+    public static logTag: string = '[node-abieos]';
     private static instance: Abieos;
     public static native: typeof abieos;
+    private static loadedContracts: Map<string, number> = new Map();
+    public static debug: boolean = false;
 
+    /**
+     * Private constructor to enforce the Singleton pattern.
+     * Throws an error if an attempt is made to create a second instance.
+     */
     private constructor() {
         if (Abieos.instance) {
-            throw new Error("This class is a Singleton!");
+            throw new Error(`${Abieos.logTag} Abieos is a Singleton class. Use Abieos.getInstance() to get the instance.`);
         }
         Abieos.native = abieos;
     }
 
+    /**
+     * Returns the singleton instance of the Abieos class.
+     * If an instance does not already exist, it creates one.
+     * @returns {Abieos} The singleton instance of Abieos.
+     */
     public static getInstance(): Abieos {
         if (!Abieos.instance) {
             Abieos.instance = new Abieos();
@@ -20,81 +37,232 @@ export class Abieos {
         return Abieos.instance;
     }
 
-    public stringToName(nameString: string): BigInteger {
-        return Abieos.native.string_to_name(nameString) as BigInteger;
+    public getLoadedAbis(): string[] {
+        return Array.from(Abieos.loadedContracts.keys());
+    }
+
+    /**
+     * Cleans up all loaded contracts by deleting them from the native context.
+     * This is useful for freeing up resources and ensuring a clean state.
+     */
+    public cleanup(): void {
+        /* node:coverage disable */
+        const errors: any[] = [];
+        Abieos.loadedContracts.forEach((_, contractName) => {
+            try {
+                if (Abieos.debug) {
+                    console.log(`${Abieos.logTag} Cleaning up contract '${contractName}'...`);
+                }
+                Abieos.native.delete_contract(contractName);
+                Abieos.loadedContracts.delete(contractName);
+            } catch (e: any) {
+                errors.push({ contractName, error: e.message });
+                console.error(`${Abieos.logTag} Failed to delete contract '${contractName}' during cleanup: ${e.message}`);
+            }
+        });
+        if (errors.length > 0) {
+            throw new Error(`${Abieos.logTag} Errors during cleanup: ${JSON.stringify(errors)}`);
+        }
+        /* node:coverage enable */
     }
 
+    /**
+     * Converts a string name to its corresponding 64-bit unsigned integer representation (BigInt).
+     * @param {string} nameString The string name to convert.
+     * @returns {BigInt} The BigInt representation of the name.
+     */
+    public stringToName(nameString: string): BigInt {
+        // The native C++ function returns a JavaScript BigInt.
+        try {
+            return Abieos.native.string_to_name(nameString) as BigInt;
+        } catch (e: any) {
+            throw new Error(`${Abieos.logTag} Failed to convert string to name '${nameString}': ${e.message}`);
+        }
+    }
+
+    /**
+     * Converts a JSON string or object to its hexadecimal binary representation.
+     * @param {string} contractName The name of the contract.
+     * @param {string} type The type within the ABI to use for conversion.
+     * @param {string | object} json The JSON data as a string or object.
+     * @returns {string} The hexadecimal string representation of the binary data.
+     * @throws {Error} If parsing fails or an error occurs in the native module.
+     */
     public jsonToHex(contractName: string, type: string, json: string | object): string {
-        const jsonData = typeof json === 'object' ? JSON.stringify(json) : json
-        const data: string = Abieos.native.json_to_hex(contractName, type, jsonData);
-        if (data === 'PARSING_ERROR') {
-            throw new Error('failed to parse data');
-        } else {
-            return data;
+        const jsonData = typeof json === 'object' ? JSON.stringify(json) : json;
+        try {
+            return Abieos.native.json_to_hex(contractName, type, jsonData) as string;
+        } catch (e: any) {
+            throw new Error(`${Abieos.logTag} Failed to convert JSON to hex for contract '${contractName}', type '${type}': ${e.message}`);
         }
     }
 
+    /**
+     * Converts a hexadecimal binary string to its JSON representation.
+     * @param {string} contractName The name of the contract.
+     * @param {string} type The type within the ABI to use for conversion.
+     * @param {string} hex The hexadecimal string to convert.
+     * @returns {any} The parsed JSON object.
+     * @throws {Error} If parsing fails or an error occurs in the native module.
+     */
     public hexToJson(contractName: string, type: string, hex: string): any {
-        const data = Abieos.native.hex_to_json(contractName, type, hex);
-        if (data) {
+        try {
+            const data = Abieos.native.hex_to_json(contractName, type, hex) as string;
+            // Attempt to parse the string data as JSON.
+            // This is still necessary as the native module returns a string.
+            /* node:coverage disable */
             try {
                 return JSON.parse(data);
-            } catch (e) {
-                throw new Error('failed to parse json string: ' + data);
+            } catch (parseError: any) {
+                // If JSON.parse fails, it means the string returned by native module was not valid JSON.
+                // This could be an error message string from C++ if it didn't throw an N-API error,
+                // or just malformed JSON.
+                throw new Error(`${Abieos.logTag} Failed to parse JSON string from hex for contract '${contractName}', type '${type}'. Received: ${data}. Parse error: ${parseError.message}`);
             }
-        } else {
-            throw new Error('failed to parse hex data');
+            /* node:coverage enable */
+        } catch (e: any) {
+            // This catches errors thrown by the N-API layer itself.
+            throw new Error(`${Abieos.logTag} Native error when converting hex to JSON for contract '${contractName}', type '${type}': ${e.message}`);
         }
     }
 
+    /**
+     * Converts a binary buffer to its JSON representation.
+     * @param {string} contractName The name of the contract.
+     * @param {string} type The type within the ABI to use for conversion.
+     * @param {Buffer} buffer The binary data as a Buffer.
+     * @returns {any} The parsed JSON object.
+     * @throws {Error} If parsing fails or an error occurs in the native module.
+     */
     public binToJson(contractName: string, type: string, buffer: Buffer): any {
-        const data = Abieos.native.bin_to_json(contractName, type, buffer);
-        if (data[0] === '{' || data[0] === '[') {
+        try {
+            const data = Abieos.native.bin_to_json(contractName, type, buffer) as string;
+            // Attempt to parse the string data as JSON.
+            /* node:coverage disable */
             try {
                 return JSON.parse(data);
-            } catch (e) {
-                throw new Error('json parse error');
+            } catch (parseError: any) {
+                throw new Error(`${Abieos.logTag} Failed to parse JSON string from binary for contract '${contractName}', type '${type}'. Received: ${data}. Parse error: ${parseError.message}`);
             }
-        } else {
-            throw new Error(data);
+            /* node:coverage enable */
+        } catch (e: any) {
+            // This catches errors thrown by the N-API layer itself.
+            throw new Error(`${Abieos.logTag} Native error when converting binary to JSON for contract '${contractName}', type '${type}': ${e.message}`);
         }
     }
 
+    /**
+     * Loads an ABI for a given contract.
+     * @param {string} contractName The name of the contract for which to load the ABI.
+     * @param {string | object} abi The ABI as a JSON string or object.
+     * @returns {boolean} True if the ABI was loaded successfully, false otherwise.
+     * @throws {Error} If the ABI format is invalid or loading fails.
+     */
     public loadAbi(contractName: string, abi: string | object): boolean {
-        if (typeof abi === 'string') {
-            return Abieos.native.load_abi(contractName, abi) as boolean;
-        } else {
-            if (typeof abi === 'object') {
-                return Abieos.native.load_abi(contractName, JSON.stringify(abi)) as boolean;
-            } else {
-                throw new Error('ABI must be a String or Object');
+
+        if (Abieos.debug && Abieos.loadedContracts.has(contractName)) {
+            console.info(`${Abieos.logTag} Contract '${contractName}' is already loaded. Updating ABI...`);
+        }
+
+        const abiString = typeof abi === 'object' ? JSON.stringify(abi) : abi;
+        if (typeof abiString !== 'string') { // Should be caught by TS but good runtime check
+            throw new Error(`${Abieos.logTag} ABI must be a String or Object.`);
+        }
+        try {
+            const loaded = Abieos.native.load_abi(contractName, abiString) as boolean;
+            if (loaded) {
+                Abieos.loadedContracts.set(contractName, Date.now());
+                if (Abieos.debug) {
+                    console.log(`${Abieos.logTag} Loaded ABI for contract '${contractName}'.`);
+                }
             }
+            return loaded;
+        } catch (e: any) {
+            throw new Error(`${Abieos.logTag} Failed to load ABI for contract '${contractName}': ${e.message}`);
         }
     }
 
+    /**
+     * Loads an ABI for a given contract from its hexadecimal representation.
+     * @param {string} contractName The name of the contract for which to load the ABI.
+     * @param {string} abihex The ABI as a hexadecimal string.
+     * @returns {boolean} True if the ABI was loaded successfully, false otherwise.
+     * @throws {Error} If loading fails.
+     */
     public loadAbiHex(contractName: string, abihex: string): boolean {
-        return Abieos.native.load_abi_hex(contractName, abihex) as boolean;
+
+        if (typeof abihex !== 'string') {
+            throw new Error(`${Abieos.logTag} ABI hex must be a String.`);
+        }
+
+        /* node:coverage disable */
+        if (Abieos.debug && Abieos.loadedContracts.has(contractName)) {
+            console.info(`${Abieos.logTag} Contract '${contractName}' is already loaded. Updating ABI...`);
+        }
+        /* node:coverage enable */
+
+        try {
+            const loaded = Abieos.native.load_abi_hex(contractName, abihex);
+            if (loaded) {
+                Abieos.loadedContracts.set(contractName, Date.now());
+                if (Abieos.debug) {
+                    console.log(`${Abieos.logTag} Loaded ABI hex for contract '${contractName}'.`);
+                }
+            }
+            return loaded;
+        } catch (e: any) {
+            throw new Error(`${Abieos.logTag} Failed to load ABI hex for contract '${contractName}': ${e.message}`);
+        }
     }
 
+    /**
+     * Retrieves the type name for a specific action within a contract's ABI.
+     * @param {string} contractName The name of the contract.
+     * @param {string} actionName The name of the action.
+     * @returns {string} The type name associated with the action.
+     * @throws {Error} If the contract or action is not found or another error occurs.
+     */
     public getTypeForAction(contractName: string, actionName: string): string {
-        const result = Abieos.native.get_type_for_action(contractName, actionName);
-        if (result === 'NOT_FOUND') {
-            throw new Error(`[node-abieos] action ` + actionName + ' not found on contract ' + contractName);
-        } else {
-            return result;
+        try {
+            return Abieos.native.get_type_for_action(contractName, actionName) as string;
+        } catch (e: any) {
+            throw new Error(`${Abieos.logTag} Failed to get type for action '${actionName}' in contract '${contractName}': ${e.message}`);
         }
     }
 
+    /**
+     * Retrieves the type name for a specific table within a contract's ABI.
+     * @param {string} contractName The name of the contract.
+     * @param {string} table_name The name of the table.
+     * @returns {string} The type name associated with the table.
+     * @throws {Error} If the contract or table is not found or another error occurs.
+     */
     public getTypeForTable(contractName: string, table_name: string): string {
-        const result = Abieos.native.get_type_for_table(contractName, table_name);
-        if (result === 'NOT_FOUND') {
-            throw new Error(`[node-abieos] table ` + table_name + ' not found on contract ' + contractName);
-        } else {
-            return result;
+        try {
+            return Abieos.native.get_type_for_table(contractName, table_name) as string;
+        } catch (e: any) {
+            throw new Error(`${Abieos.logTag} Failed to get type for table '${table_name}' in contract '${contractName}': ${e.message}`);
         }
     }
 
+    /**
+     * Deletes a contract's ABI from the abieos context.
+     * @param {string} contractName The name of the contract to delete.
+     * @returns {boolean} True if the contract was successfully deleted, false otherwise.
+     * @throws {Error} If deletion fails.
+     */
     public deleteContract(contractName: string): boolean {
-        return Abieos.native.delete_contract(contractName) as boolean;
+        try {
+            const deleted = Abieos.native.delete_contract(contractName);
+            if (deleted) {
+                Abieos.loadedContracts.delete(contractName);
+                if (Abieos.debug) {
+                    console.log(`${Abieos.logTag} Deleted contract '${contractName}' from abieos context.`);
+                }
+            }
+            return deleted;
+        } catch (e: any) {
+            throw new Error(`${Abieos.logTag} Failed to delete contract '${contractName}': ${e.message}`);
+        }
     }
-}
+}