/* This file is part of web3.js. web3.js 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. web3.js 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 web3.js. If not, see . */ /** * * @module ABI */ import { sha3Raw } from 'web3-utils'; import { AbiError } from 'web3-errors'; import { AbiEventFragment } from 'web3-types'; import { jsonInterfaceMethodToString, isAbiEventFragment } from '../utils.js'; /** * Encodes the event name to its ABI signature, which are the sha3 hash of the event name including input types. * @param functionName - The event name to encode, or the {@link AbiEventFragment} object of the event. If string, it has to be in the form of `eventName(param1Type,param2Type,...)`. eg: myEvent(uint256,bytes32). * @returns - The ABI signature of the event. * * @example * ```ts * const event = web3.eth.abi.encodeEventSignature({ * name: "myEvent", * type: "event", * inputs: [ * { * type: "uint256", * name: "myNumber", * }, * { * type: "bytes32", * name: "myBytes", * }, * ], * }); * console.log(event); * > 0xf2eeb729e636a8cb783be044acf6b7b1e2c5863735b60d6daae84c366ee87d97 * * const event = web3.eth.abi.encodeEventSignature({ * inputs: [ * { * indexed: true, * name: "from", * type: "address", * }, * { * indexed: true, * name: "to", * type: "address", * }, * { * indexed: false, * name: "value", * type: "uint256", * }, * ], * name: "Transfer", * type: "event", * }); * console.log(event); * > 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef * ``` */ export const encodeEventSignature = (functionName: string | AbiEventFragment): string => { if (typeof functionName !== 'string' && !isAbiEventFragment(functionName)) { throw new AbiError('Invalid parameter value in encodeEventSignature'); } let name: string; if (functionName && (typeof functionName === 'function' || typeof functionName === 'object')) { name = jsonInterfaceMethodToString(functionName); } else { name = functionName; } return sha3Raw(name); };