Add contract.decodeMethodData(...) method to decode contract methods and to contract.deploy(...).decodeData(...) decode constructor parameters

packages/web3-eth-contract/src/contract.ts

@@ -1161,6 +1161,7 @@
 					}),
 
 				encodeABI: () => encodeMethodABI(methodAbi, abiParams),
+				decodeABI: (data?: string) => decodeMethodReturn(methodAbi, data),
 
 				createAccessList: async (
 					options?: PayableCallOptions | NonPayableCallOptions,

packages/web3-eth-contract/src/types.ts

@@ -211,6 +211,14 @@ export interface NonPayableMethodObject<Inputs = unknown[], Outputs = unknown[]>
 	 */
 	encodeABI(): string;
 
+	/**
+	 * Decode raw result of method call into readable value(s).
+	 *
+	 * @param data - The data to decode.
+	 * @returns - The decoded data.
+	 */
+	decodeABI<SpecialOutput = Outputs>(data?: string): SpecialOutput;
+
 	/**
 	 * This method generates an access list for a transaction. You must specify a `from` address and `gas` if it’s not specified in options.
 	 *
@@ -400,6 +408,14 @@ export interface PayableMethodObject<Inputs = unknown[], Outputs = unknown[]> {
 	 */
 	encodeABI(): HexString;
 
+	/**
+	 * Decode raw result of method call into readable value(s).
+	 *
+	 * @param data - The data to decode.
+	 * @returns - The decoded data.
+	 */
+	decodeABI<SpecialOutput = Outputs>(data?: HexString): SpecialOutput;
+
 	/**
 	 * This method generates an access list for a transaction. You must specify a `from` address and `gas` if it’s not specified in options.
 	 *