@alephium/web3 1.8.1 → 1.8.2

package/dist/src/address/address.js

@@ -16,6 +16,29 @@ GNU Lesser General Public License for more details.
 You should have received a copy of the GNU Lesser General Public License
 along with the library. If not, see <http://www.gnu.org/licenses/>.
 */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -25,11 +48,12 @@ const elliptic_1 = require("elliptic");
 const bn_js_1 = __importDefault(require("bn.js"));
 const constants_1 = require("../constants");
 const blakejs_1 = __importDefault(require("blakejs"));
-const bs58_1 = __importDefault(require("../utils/bs58"));
+const bs58_1 = __importStar(require("../utils/bs58"));
 const utils_1 = require("../utils");
 const lockup_script_codec_1 = require("../codec/lockup-script-codec");
 const codec_1 = require("../codec");
 const djb2_1 = __importDefault(require("../utils/djb2"));
+const error_1 = require("../error");
 const ec = new elliptic_1.ec('secp256k1');
 const PublicKeyHashSize = 32;
 var AddressType;
@@ -54,13 +78,7 @@ function isValidAddress(address) {
 }
 exports.isValidAddress = isValidAddress;
 function decodeAndValidateAddress(address) {
-    let decoded;
-    try {
-        decoded = bs58_1.default.decode(address);
-    }
-    catch (_) {
-        throw new Error('Invalid base58 string');
-    }
+    const decoded = (0, bs58_1.base58ToBytes)(address);
     if (decoded.length === 0)
         throw new Error('Address is empty');
     const addressType = decoded[0];
@@ -69,8 +87,8 @@ function decodeAndValidateAddress(address) {
         try {
             multisig = lockup_script_codec_1.lockupScriptCodec.decode(decoded).value;
         }
-        catch (_) {
-            throw new Error(`Invalid multisig address: ${address}`);
+        catch (error) {
+            throw new error_1.TraceableError(`Invalid multisig address: ${address}`, error);
         }
         const n = multisig.publicKeyHashes.length;
         const m = multisig.m;
@@ -141,7 +159,7 @@ function tokenIdFromAddress(address) {
 }
 exports.tokenIdFromAddress = tokenIdFromAddress;
 function idFromAddress(address) {
-    const decoded = bs58_1.default.decode(address);
+    const decoded = (0, bs58_1.base58ToBytes)(address);
     if (decoded.length == 0)
         throw new Error('Address string is empty');
     const addressType = decoded[0];

package/dist/src/api/types.js

@@ -20,6 +20,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.StdInterfaceIds = exports.request = exports.requestWithLog = exports.forwardRequests = exports.getDefaultPrimitiveValue = exports.decodeArrayType = exports.fromApiPrimitiveVal = exports.toApiVal = exports.toApiArray = exports.toApiAddress = exports.toApiByteVec = exports.fromApiNumber256 = exports.toApiNumber256Optional = exports.toApiNumber256 = exports.toApiBoolean = exports.fromApiTokens = exports.fromApiToken = exports.toApiTokens = exports.toApiToken = exports.PrimitiveTypes = void 0;
 const constants_1 = require("../constants");
 const debug_1 = require("../debug");
+const error_1 = require("../error");
 const utils_1 = require("../utils");
 exports.PrimitiveTypes = ['U256', 'I256', 'Bool', 'ByteVec', 'Address'];
 utils_1.assertType;
@@ -59,8 +60,8 @@ function toApiNumber256(v) {
                 return v;
             }
         }
-        catch (_) {
-            throw new Error(`Invalid value: ${v}, expected a 256 bit number`);
+        catch (error) {
+            throw new error_1.TraceableError(`Invalid value: ${v}, expected a 256 bit number`, error);
         }
     }
     throw new Error(`Invalid value: ${v}, expected a 256 bit number`);
@@ -82,14 +83,9 @@ function toApiByteVec(v) {
         return v;
     if ((0, utils_1.isBase58)(v)) {
         // try to convert from address to contract id
-        try {
-            const address = utils_1.bs58.decode(v);
-            if (address.length == 33 && address[0] == 3) {
-                return (0, utils_1.binToHex)(address.slice(1));
-            }
-        }
-        catch (_) {
-            throw new Error(`Invalid hex-string: ${v}`);
+        const address = (0, utils_1.base58ToBytes)(v);
+        if (address.length === 33 && address[0] === 3) {
+            return (0, utils_1.binToHex)(address.slice(1));
         }
     }
     throw new Error(`Invalid hex-string: ${v}`);
@@ -97,13 +93,10 @@ function toApiByteVec(v) {
 exports.toApiByteVec = toApiByteVec;
 function toApiAddress(v) {
     if (typeof v === 'string') {
-        try {
-            utils_1.bs58.decode(v);
+        if ((0, utils_1.isBase58)(v)) {
             return v;
         }
-        catch (error) {
-            throw new Error(`Invalid base58 string: ${v}`);
-        }
+        throw new Error(`Invalid base58 string: ${v}`);
     }
     else {
         throw new Error(`Invalid value: ${v}, expected a base58 string`);
@@ -200,7 +193,7 @@ async function call(args, handler) {
         if (debugModeEnabled) {
             console.error(`[ERROR] ${path} ${method} `, error);
         }
-        throw error;
+        throw new error_1.TraceableError(`Failed to request ${method}`, error);
     }
 }
 function forwardRequests(api, handler) {

package/dist/src/contract/contract.d.ts

@@ -78,6 +78,7 @@ export declare class Contract extends Artifact {
     static ContractCreatedEvent: EventSig;
     static ContractDestroyedEventIndex: number;
     static ContractDestroyedEvent: EventSig;
+    static DebugEventIndex: number;
     static fromApiEvent(event: node.ContractEventByTxId, codeHash: string | undefined, txId: string, getContractByCodeHash: (codeHash: string) => Contract): ContractEvent;
     fromApiTestContractResult(methodName: string, result: node.TestContractResult, txId: string, getContractByCodeHash: (codeHash: string) => Contract): TestContractResult<unknown>;
     txParamsForDeployment<P extends Fields>(signer: SignerProvider, params: DeployContractParams<P>): Promise<SignDeployContractTxParams>;
@@ -274,6 +275,11 @@ export declare function extractMapsFromApiResult(selfAddress: string, params: Op
     maps: Record<string, Map<Val, Val>>;
 }[];
 export declare function testMethod<I extends ContractInstance, F extends Fields, A extends Arguments, R, M extends Record<string, Map<Val, Val>> = Record<string, Map<Val, Val>>>(factory: ContractFactory<I, F>, methodName: string, params: Optional<TestContractParams<F, A, M>, 'testArgs' | 'initialFields'>, getContractByCodeHash: (codeHash: string) => Contract): Promise<TestContractResult<R, M>>;
+export declare function getDebugMessagesFromTx(txId: HexString, provider?: NodeProvider): Promise<{
+    contractAddress: string;
+    message: string;
+}[]>;
+export declare function printDebugMessagesFromTx(txId: HexString, provider?: NodeProvider): Promise<void>;
 export declare class RalphMap<K extends Val, V extends Val> {
     private readonly parentContract;
     private readonly parentContractId;

package/dist/src/contract/contract.js

@@ -40,7 +40,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getTokenIdFromUnsignedTx = exports.getContractIdFromUnsignedTx = exports.getContractEventsCurrentCount = exports.multicallMethods = exports.signExecuteMethod = exports.callMethod = exports.subscribeContractEvents = exports.subscribeContractEvent = exports.decodeEvent = exports.subscribeContractDestroyedEvent = exports.subscribeContractCreatedEvent = exports.fetchContractState = exports.ContractInstance = exports.getMapItem = exports.RalphMap = exports.testMethod = exports.extractMapsFromApiResult = exports.addStdIdToFields = exports.subscribeEventsFromContract = exports.decodeContractDestroyedEvent = exports.decodeContractCreatedEvent = exports.DestroyContractEventAddresses = exports.CreateContractEventAddresses = exports.ExecutableScript = exports.ContractFactory = exports.randomTxId = exports.fromApiEventFields = exports.fromApiArray = exports.getDefaultValue = exports.fromApiFields = exports.Script = exports.Contract = exports.Artifact = exports.Struct = exports.DEFAULT_COMPILER_OPTIONS = exports.DEFAULT_NODE_COMPILER_OPTIONS = exports.StdIdFieldName = void 0;
+exports.getTokenIdFromUnsignedTx = exports.getContractIdFromUnsignedTx = exports.getContractEventsCurrentCount = exports.multicallMethods = exports.signExecuteMethod = exports.callMethod = exports.subscribeContractEvents = exports.subscribeContractEvent = exports.decodeEvent = exports.subscribeContractDestroyedEvent = exports.subscribeContractCreatedEvent = exports.fetchContractState = exports.ContractInstance = exports.getMapItem = exports.RalphMap = exports.printDebugMessagesFromTx = exports.getDebugMessagesFromTx = exports.testMethod = exports.extractMapsFromApiResult = exports.addStdIdToFields = exports.subscribeEventsFromContract = exports.decodeContractDestroyedEvent = exports.decodeContractCreatedEvent = exports.DestroyContractEventAddresses = exports.CreateContractEventAddresses = exports.ExecutableScript = exports.ContractFactory = exports.randomTxId = exports.fromApiEventFields = exports.fromApiArray = exports.getDefaultValue = exports.fromApiFields = exports.Script = exports.Contract = exports.Artifact = exports.Struct = exports.DEFAULT_COMPILER_OPTIONS = exports.DEFAULT_NODE_COMPILER_OPTIONS = exports.StdIdFieldName = void 0;
 const fs_1 = require("fs");
 const api_1 = require("../api");
 const ralph = __importStar(require("./ralph"));
@@ -52,6 +52,7 @@ const constants_1 = require("../constants");
 const blake = __importStar(require("blakejs"));
 const debug_1 = require("../debug");
 const codec_1 = require("../codec");
+const error_1 = require("../error");
 const crypto = new utils_1.WebCrypto();
 exports.StdIdFieldName = '__stdInterfaceId';
 exports.DEFAULT_NODE_COMPILER_OPTIONS = {
@@ -247,7 +248,7 @@ class Contract extends Artifact {
     printDebugMessages(funcName, messages) {
         if ((0, debug_1.isContractDebugMessageEnabled)() && messages.length != 0) {
             console.log(`Testing ${this.name}.${funcName}:`);
-            messages.forEach((m) => console.log(`> Contract @ ${m.contractAddress} - ${m.message}`));
+            messages.forEach((m) => printDebugMessage(m));
         }
     }
     toApiFields(fields) {
@@ -391,7 +392,7 @@ class Contract extends Artifact {
             return ralph.buildContractByteCode(bytecode, initialFields, this.fieldsSig, this.structs);
         }
         catch (error) {
-            throw new Error(`Failed to build bytecode for contract ${this.name}, error: ${error}`);
+            throw new error_1.TraceableError(`Failed to build bytecode for contract ${this.name}`, error);
         }
     }
     static fromApiEvents(events, addressToCodeHash, txId, getContractByCodeHash) {
@@ -437,6 +438,7 @@ Contract.ContractDestroyedEvent = {
     fieldNames: ['address'],
     fieldTypes: ['Address']
 };
+Contract.DebugEventIndex = -3;
 function fromCallResult(callResult, txId, returnTypes, structs, getContractByCodeHash) {
     const rawReturn = fromApiArray(callResult.returns, returnTypes, structs);
     const returns = rawReturn.length === 0 ? null : rawReturn.length === 1 ? rawReturn[0] : rawReturn;
@@ -507,7 +509,7 @@ class Script extends Artifact {
             return ralph.buildScriptByteCode(this.bytecodeTemplate, initialFields, this.fieldsSig, this.structs);
         }
         catch (error) {
-            throw new Error(`Failed to build bytecode for script ${this.name}, error: ${error}`);
+            throw new error_1.TraceableError(`Failed to build bytecode for script ${this.name}`, error);
         }
     }
 }
@@ -943,6 +945,39 @@ async function testMethod(factory, methodName, params, getContractByCodeHash) {
     };
 }
 exports.testMethod = testMethod;
+function printDebugMessage(m) {
+    console.log(`> Contract @ ${m.contractAddress} - ${m.message}`);
+}
+async function getDebugMessagesFromTx(txId, provider) {
+    if ((0, utils_1.isHexString)(txId) && txId.length === 64) {
+        const nodeProvider = provider ?? (0, global_1.getCurrentNodeProvider)();
+        const events = await nodeProvider.events.getEventsTxIdTxid(txId);
+        return events.events
+            .filter((e) => e.eventIndex === Contract.DebugEventIndex)
+            .map((e) => {
+            if (e.fields.length === 1 && e.fields[0].type === 'ByteVec') {
+                return {
+                    contractAddress: e.contractAddress,
+                    message: (0, utils_1.hexToString)(e.fields[0].value)
+                };
+            }
+            else {
+                throw new Error(`Invalid debug log: ${JSON.stringify(e.fields)}`);
+            }
+        });
+    }
+    else {
+        throw new Error(`Invalid tx id: ${txId}`);
+    }
+}
+exports.getDebugMessagesFromTx = getDebugMessagesFromTx;
+async function printDebugMessagesFromTx(txId, provider) {
+    const messages = await getDebugMessagesFromTx(txId, provider);
+    if (messages.length > 0) {
+        messages.forEach((m) => printDebugMessage(m));
+    }
+}
+exports.printDebugMessagesFromTx = printDebugMessagesFromTx;
 class RalphMap {
     constructor(parentContract, parentContractId, mapName) {
         this.parentContract = parentContract;
@@ -985,7 +1020,7 @@ async function getMapItem(parentContract, parentContractId, groupIndex, mapName,
             // the map item contract does not exist
             return undefined;
         }
-        throw error;
+        throw new error_1.TraceableError(`Failed to get value from map ${mapName}, key: ${key}, parent contract id: ${parentContractId}`, error);
     }
 }
 exports.getMapItem = getMapItem;
@@ -1169,7 +1204,11 @@ async function signExecuteMethod(contract, instance, methodName, params) {
         gasAmount: params.gasAmount,
         gasPrice: params.gasPrice
     };
-    return await signer.signAndSubmitExecuteScriptTx(signerParams);
+    const result = await signer.signAndSubmitExecuteScriptTx(signerParams);
+    if ((0, debug_1.isContractDebugMessageEnabled)() && (await contract.contract.isDevnet(signer))) {
+        await printDebugMessagesFromTx(result.txId, signer.nodeProvider);
+    }
+    return result;
 }
 exports.signExecuteMethod = signExecuteMethod;
 function getBytecodeTemplate(methodIndex, methodUsePreapprovedAssets, functionSig, structs, attoAlphAmount, tokens) {
@@ -1363,7 +1402,7 @@ async function getContractEventsCurrentCount(contractAddress) {
         if (error instanceof Error && error.message.includes(`${contractAddress} not found`)) {
             return 0;
         }
-        throw error;
+        throw new error_1.TraceableError(`Failed to get the event count for the contract ${contractAddress}`, error);
     });
 }
 exports.getContractEventsCurrentCount = getContractEventsCurrentCount;

package/dist/src/contract/ralph.js

@@ -22,6 +22,7 @@ const api_1 = require("../api");
 const utils_1 = require("../utils");
 const codec_1 = require("../codec");
 const codec_2 = require("../codec/codec");
+const error_1 = require("../error");
 function encodeByteVec(hex) {
     if (!(0, utils_1.isHexString)(hex)) {
         throw Error(`Given value ${hex} is not a valid hex string`);
@@ -357,10 +358,7 @@ function _encodeField(fieldName, encodeFunc) {
         return encodeFunc();
     }
     catch (error) {
-        if (error instanceof Error) {
-            throw new Error(`Invalid ${fieldName}, error: ${error.message}`);
-        }
-        throw error;
+        throw new error_1.TraceableError(`Failed to encode the field ${fieldName}`, error);
     }
 }
 function encodeFields(fields) {

package/dist/src/error.d.ts

@@ -0,0 +1,4 @@
+export declare class TraceableError extends Error {
+    trace: any | undefined;
+    constructor(message?: string, innerError?: any);
+}

package/dist/src/error.js

@@ -0,0 +1,36 @@
+"use strict";
+/*
+Copyright 2018 - 2022 The Alephium Authors
+This file is part of the alephium project.
+
+The library is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+The library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with the library. If not, see <http://www.gnu.org/licenses/>.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TraceableError = void 0;
+class TraceableError extends Error {
+    constructor(message, innerError) {
+        const innerErrorMessage = innerError === undefined ? undefined : innerError instanceof Error ? innerError.message : `${innerError}`;
+        super(innerErrorMessage ? `${message}, error: ${innerErrorMessage}` : message);
+        this.trace = innerError;
+        const actualProto = new.target.prototype;
+        if (Object.setPrototypeOf) {
+            Object.setPrototypeOf(this, actualProto);
+        }
+        else {
+            const object = this;
+            object.__proto__ = actualProto;
+        }
+    }
+}
+exports.TraceableError = TraceableError;

package/dist/src/exchange/exchange.js

@@ -22,14 +22,9 @@ const address_1 = require("../address");
 const utils_1 = require("../utils");
 const unlock_script_codec_1 = require("../codec/unlock-script-codec");
 const script_codec_1 = require("../codec/script-codec");
+const error_1 = require("../error");
 function validateExchangeAddress(address) {
-    let decoded;
-    try {
-        decoded = utils_1.bs58.decode(address);
-    }
-    catch (_) {
-        throw new Error('Invalid base58 string');
-    }
+    const decoded = (0, utils_1.base58ToBytes)(address);
     if (decoded.length === 0)
         throw new Error('Address is empty');
     const addressType = decoded[0];
@@ -108,8 +103,8 @@ function getAddressFromUnlockScript(unlockScript) {
         try {
             p2sh = unlock_script_codec_1.unlockScriptCodec.decode(decoded).value;
         }
-        catch (_) {
-            throw new Error(`Invalid p2sh unlock script: ${unlockScript}`);
+        catch (e) {
+            throw new error_1.TraceableError(`Invalid p2sh unlock script: ${unlockScript}`, e);
         }
         return (0, address_1.addressFromScript)(script_codec_1.scriptCodec.encode(p2sh.script));
     }

package/dist/src/index.d.ts

@@ -12,3 +12,4 @@ export * from './debug';
 export * from './block';
 export * from './address';
 export * from './exchange';
+export * from './error';

package/dist/src/index.js

@@ -61,3 +61,4 @@ __exportStar(require("./debug"), exports);
 __exportStar(require("./block"), exports);
 __exportStar(require("./address"), exports);
 __exportStar(require("./exchange"), exports);
+__exportStar(require("./error"), exports);

package/dist/src/token/nft.js

@@ -21,6 +21,7 @@ exports.validateNFTBaseUri = exports.validateNFTCollectionUriMetaData = exports.
 // JSON Schema for the NFT metadata, which is pointed to by the value
 // returned from the `getTokenUri` method of the NFT contract
 require("cross-fetch/polyfill");
+const error_1 = require("../error");
 exports.validNFTTokenUriMetaDataFields = ['name', 'description', 'image', 'attributes'];
 exports.validNFTTokenUriMetaDataAttributesFields = ['trait_type', 'value'];
 exports.validNFTUriMetaDataAttributeTypes = ['string', 'number', 'boolean'];
@@ -111,7 +112,7 @@ async function fetchNFTMetadata(nftBaseUri, index) {
         return await (await fetch(`${nftBaseUri}${index}`)).json();
     }
     catch (e) {
-        throw new Error(`Error fetching NFT metadata from ${nftBaseUri}${index}: ${e}`);
+        throw new error_1.TraceableError(`Error fetching NFT metadata from ${nftBaseUri}${index}`, e);
     }
 }
 function isInteger(num) {

package/dist/src/utils/bs58.d.ts

@@ -2,4 +2,5 @@
 import basex from 'base-x';
 export declare const bs58: basex.BaseConverter;
 export declare function isBase58(s: string): boolean;
+export declare function base58ToBytes(s: string): Uint8Array;
 export default bs58;

package/dist/src/utils/bs58.js

@@ -20,9 +20,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isBase58 = exports.bs58 = void 0;
+exports.base58ToBytes = exports.isBase58 = exports.bs58 = void 0;
 /** This source is under MIT License and come originally from https://github.com/cryptocoinjs/bs58 **/
 const base_x_1 = __importDefault(require("base-x"));
+const error_1 = require("../error");
 const ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
 exports.bs58 = (0, base_x_1.default)(ALPHABET);
 function isBase58(s) {
@@ -37,4 +38,13 @@ function isBase58(s) {
     }
 }
 exports.isBase58 = isBase58;
+function base58ToBytes(s) {
+    try {
+        return exports.bs58.decode(s);
+    }
+    catch (e) {
+        throw new error_1.TraceableError(`Invalid base58 string ${s}`, e);
+    }
+}
+exports.base58ToBytes = base58ToBytes;
 exports.default = exports.bs58;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alephium/web3",
-  "version": "1.8.1",
+  "version": "1.8.2",
   "description": "A JS/TS library to interact with the Alephium platform",
   "license": "GPL",
   "main": "dist/src/index.js",

package/src/address/address.ts

@@ -20,13 +20,14 @@ import { ec as EC } from 'elliptic'
 import BN from 'bn.js'
 import { TOTAL_NUMBER_OF_GROUPS } from '../constants'
 import blake from 'blakejs'
-import bs58 from '../utils/bs58'
+import bs58, { base58ToBytes } from '../utils/bs58'
 import { binToHex, concatBytes, hexToBinUnsafe, isHexString, xorByte } from '../utils'
 import { KeyType } from '../signer'
 import { P2MPKH, lockupScriptCodec } from '../codec/lockup-script-codec'
 import { i32Codec } from '../codec'
 import { LockupScript } from '../codec/lockup-script-codec'
 import djb2 from '../utils/djb2'
+import { TraceableError } from '../error'
 
 const ec = new EC('secp256k1')
 const PublicKeyHashSize = 32
@@ -52,21 +53,15 @@ export function isValidAddress(address: string): boolean {
 }
 
 function decodeAndValidateAddress(address: string): Uint8Array {
-  let decoded: Uint8Array
-  try {
-    decoded = bs58.decode(address)
-  } catch (_) {
-    throw new Error('Invalid base58 string')
-  }
-
+  const decoded = base58ToBytes(address)
   if (decoded.length === 0) throw new Error('Address is empty')
   const addressType = decoded[0]
   if (addressType === AddressType.P2MPKH) {
     let multisig: P2MPKH
     try {
       multisig = lockupScriptCodec.decode(decoded).value as P2MPKH
-    } catch (_) {
-      throw new Error(`Invalid multisig address: ${address}`)
+    } catch (error) {
+      throw new TraceableError(`Invalid multisig address: ${address}`, error)
     }
     const n = multisig.publicKeyHashes.length
     const m = multisig.m
@@ -137,8 +132,7 @@ export function tokenIdFromAddress(address: string): Uint8Array {
 }
 
 function idFromAddress(address: string): Uint8Array {
-  const decoded = bs58.decode(address)
-
+  const decoded = base58ToBytes(address)
   if (decoded.length == 0) throw new Error('Address string is empty')
   const addressType = decoded[0]
   const addressBody = decoded.slice(1)

package/src/api/types.ts

@@ -18,7 +18,8 @@ along with the library. If not, see <http://www.gnu.org/licenses/>.
 
 import { ZERO_ADDRESS } from '../constants'
 import { isDebugModeEnabled } from '../debug'
-import { assertType, binToHex, bs58, Eq, isBase58, isHexString } from '../utils'
+import { TraceableError } from '../error'
+import { assertType, base58ToBytes, binToHex, bs58, Eq, isBase58, isHexString } from '../utils'
 import * as node from './api-alephium'
 
 export type Number256 = bigint | string
@@ -68,8 +69,8 @@ export function toApiNumber256(v: Val): string {
       if (BigInt(v).toString() === v) {
         return v
       }
-    } catch (_) {
-      throw new Error(`Invalid value: ${v}, expected a 256 bit number`)
+    } catch (error) {
+      throw new TraceableError(`Invalid value: ${v}, expected a 256 bit number`, error)
     }
   }
   throw new Error(`Invalid value: ${v}, expected a 256 bit number`)
@@ -90,13 +91,9 @@ export function toApiByteVec(v: Val): string {
   if (isHexString(v)) return v
   if (isBase58(v)) {
     // try to convert from address to contract id
-    try {
-      const address = bs58.decode(v)
-      if (address.length == 33 && address[0] == 3) {
-        return binToHex(address.slice(1))
-      }
-    } catch (_) {
-      throw new Error(`Invalid hex-string: ${v}`)
+    const address = base58ToBytes(v)
+    if (address.length === 33 && address[0] === 3) {
+      return binToHex(address.slice(1))
     }
   }
   throw new Error(`Invalid hex-string: ${v}`)
@@ -104,12 +101,10 @@ export function toApiByteVec(v: Val): string {
 
 export function toApiAddress(v: Val): string {
   if (typeof v === 'string') {
-    try {
-      bs58.decode(v)
-      return v as string
-    } catch (error) {
-      throw new Error(`Invalid base58 string: ${v}`)
+    if (isBase58(v)) {
+      return v
     }
+    throw new Error(`Invalid base58 string: ${v}`)
   } else {
     throw new Error(`Invalid value: ${v}, expected a base58 string`)
   }
@@ -201,7 +196,7 @@ async function call(args: ApiRequestArguments, handler: ApiRequestHandler): Prom
     if (debugModeEnabled) {
       console.error(`[ERROR] ${path} ${method} `, error)
     }
-    throw error
+    throw new TraceableError(`Failed to request ${method}`, error)
   }
 }
 

package/src/codec/transaction-codec.ts

@@ -26,7 +26,7 @@ import { FixedAssetOutput, Transaction as ApiTransaction } from '../api/api-alep
 import { binToHex, hexToBinUnsafe } from '../utils'
 import { ContractOutput as ApiContractOutput } from '../api/api-alephium'
 import { byteCodec, ObjectCodec } from './codec'
-import { Output, outputCodec, outputsCodec } from './output-codec'
+import { Output, outputsCodec } from './output-codec'
 
 export interface Transaction {
   unsigned: UnsignedTx