/******************************************************************************* * (c) 2023 unipackage * * Licensed under either the MIT License (the "MIT License") or the Apache License, Version 2.0 * (the "Apache License"). You may not use this file except in compliance with one of these * licenses. You may obtain a copy of the MIT License at * * https://opensource.org/licenses/MIT * * Or the Apache License, Version 2.0 at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the MIT License or the Apache License for the specific language governing permissions and * limitations under the respective licenses. ********************************************************************************/ import { InterfaceAbi, Contract, JsonFragment, ethers, TransactionReceipt } from "ethers"; import { EtherUnits } from "web3-utils"; import { Result } from "@unipackage/utils"; import { EvmEventArgs, EvmInput, EvmOutput, EvmTransactionOptions, EvmType, IEVMEngine } from "../../interface"; import { IWallet } from "../../interface/wallet"; /** * Define ethereum as an optional property. */ declare global { interface Window { ethereum?: any; } } /** * Class representing a EthersEvm instance. */ export declare class EthersEvmEngine implements IEVMEngine { private provider; private contract; private contractAddress; private contractABI; private providerUrl; wallet: IWallet | undefined; /** * Constructor for EthersEvm class. * * @TODO test window.ethereum * @param contractABI - The contract's ABI. * @param contractAddress - The contract's address. * @param providerUrl - The provider URL. */ constructor(contractABI: InterfaceAbi, contractAddress: string, providerUrl?: string, wallet?: IWallet); /** * Generates a value in Wei based on the provided number and unit. * * @param number - The number to convert to Wei. * @param unit - The unit to convert the number to (e.g., Ether, Gwei). * @returns The generated value in Wei as a string or bigint. */ generateWei(number: string, unit: EtherUnits): bigint; /** * Generates a transaction based on input and options. * * @param input - The EVM input. * @param options - The transaction options. * @returns A promise resolving to EvmOutput object with the transaction. */ private generateTransaction; /** * Calls a contract function. * * @param input - The EVM input. * @returns A promise resolving to EvmOutput object with the result of the contract call. */ call(input: EvmInput): Promise>; /** * Decode the transaction input on the EVM. * * @param txInput - The transaction input data. * @returns A promise that resolves to the decoded output. */ decodeTxInputToEvmInput(txInput: string): EvmOutput; /** * Encode EVM input to transaction input data. * * @param input - The input parameters for the EVM operation. * @returns A promise that resolves to the encoded transaction input. */ encodeEvmInputToTxinput(input: EvmInput): EvmOutput; /** * Encode function signature using the ABI. * * @param abi - The ABI function fragment. * @returns The encoded function signature or an error result. */ encodeFunctionSignatureByAbi(abi: JsonFragment): Result; /** * Encode function signature using the function name. * * @param name - The name of the function. * @returns A promise that resolves to the encoded function signature or an error result. */ encodeFunctionSignatureByFuntionName(name: string): EvmOutput; /** * Retrieve the wallet instance. * * This method returns the instance of the wallet that implements the IWallet interface. * Clients can use this method to access and manage the wallet's functionalities. * * @returns An instance of the wallet implementing the IWallet interface. */ getWallet(): IWallet; /** * Get the EVM contract. * * @returns The EVM contract object or null if not initialized. */ getContract(): Contract | null; /** * Get the EVM contract address. * * @returns The EVM contract address or null if not initialized. */ getContractAddress(): string; /** * Get the EVM contract abi. * * @returns The EVM contract abi or null if not initialized. */ getContractABI(): JsonFragment[]; /** * Extracts Ethereum Virtual Machine (EVM) event arguments from a transaction receipt. * * @param transactionReceipt - The transaction receipt containing event data. * @param name - The name of the event. * @returns An object representing the extracted EVM event arguments. */ getEvmEventArgs(transactionReceipt: TransactionReceipt, name: string): EvmOutput; /** * Get the EVM type. * * @returns The EVM type,Web3 or Ethers. */ getEvmType(): EvmType; /** * Get the EVM provider url. * * @returns The EVM provider url or undefined not initialized. */ getProviderUrl(): string | undefined; /** * Get the Ether Provider * * @returns Ether Provider object or null if not initialized. */ getEtherProvider(): ethers.AbstractProvider | null; /** * Get the Web3 object. * * @returns The Web3 object or null if not initialized. */ getWeb3(): null; /** * Send a transaction to the EVM contract. * * @param input - The input parameters for the transaction. * @param options - The transaction options. * @returns A promise that resolves to the transaction result. */ send(input: EvmInput, options?: EvmTransactionOptions): Promise>; /** * Send a signed transaction to the EVM. * * @param signed - The signed transaction data. * @returns A promise that resolves to the transaction result. */ sendSigned(signed: string): Promise>; /** * Sign a transaction on the EVM. * * @param input - The input parameters for the transaction. * @param options - The transaction options. * @returns A promise that resolves to the signed transaction or an error result. */ sign(input: EvmInput, options?: EvmTransactionOptions): Promise>; } //# sourceMappingURL=index.d.ts.map