ethers.js/packages/contracts/lib/index.d.ts

142 lines
5.6 KiB
TypeScript
Raw Permalink Normal View History

2020-01-07 19:58:04 -05:00
import { Fragment, Indexed, Interface, JsonFragment, Result } from "@ethersproject/abi";
2019-05-14 18:48:48 -04:00
import { Block, BlockTag, Listener, Log, Provider, TransactionReceipt, TransactionRequest, TransactionResponse } from "@ethersproject/abstract-provider";
import { Signer } from "@ethersproject/abstract-signer";
import { BigNumber, BigNumberish } from "@ethersproject/bignumber";
import { BytesLike } from "@ethersproject/bytes";
export interface Overrides {
gasLimit?: BigNumberish | Promise<BigNumberish>;
gasPrice?: BigNumberish | Promise<BigNumberish>;
nonce?: BigNumberish | Promise<BigNumberish>;
}
export interface PayableOverrides extends Overrides {
value?: BigNumberish | Promise<BigNumberish>;
}
export interface CallOverrides extends PayableOverrides {
blockTag?: BlockTag | Promise<BlockTag>;
from?: string | Promise<string>;
}
2020-06-01 05:04:12 -04:00
export interface PopulatedTransaction {
to?: string;
from?: string;
nonce?: number;
gasLimit?: BigNumber;
gasPrice?: BigNumber;
data?: string;
value?: BigNumber;
chainId?: number;
}
2019-05-14 18:48:48 -04:00
export declare type EventFilter = {
address?: string;
2020-05-29 21:27:59 -04:00
topics?: Array<string | Array<string>>;
2019-05-14 18:48:48 -04:00
};
2020-05-29 21:27:59 -04:00
export declare type ContractFunction<T = any> = (...args: Array<any>) => Promise<T>;
2019-05-14 18:48:48 -04:00
export interface Event extends Log {
event?: string;
eventSignature?: string;
2020-01-07 19:58:04 -05:00
args?: Result;
2020-04-16 21:59:53 -04:00
decodeError?: Error;
2019-05-14 18:48:48 -04:00
decode?: (data: string, topics?: Array<string>) => any;
removeListener: () => void;
getBlock: () => Promise<Block>;
getTransaction: () => Promise<TransactionResponse>;
getTransactionReceipt: () => Promise<TransactionReceipt>;
}
export interface ContractReceipt extends TransactionReceipt {
events?: Array<Event>;
}
export interface ContractTransaction extends TransactionResponse {
wait(confirmations?: number): Promise<ContractReceipt>;
}
2019-05-23 19:13:44 -04:00
declare class RunningEvent {
readonly tag: string;
readonly filter: EventFilter;
private _listeners;
constructor(tag: string, filter: EventFilter);
addListener(listener: Listener, once: boolean): void;
removeListener(listener: Listener): void;
removeAllListeners(): void;
listeners(): Array<Listener>;
listenerCount(): number;
run(args: Array<any>): number;
prepareEvent(event: Event): void;
2020-04-16 21:59:53 -04:00
getEmit(event: Event): Array<any>;
2019-05-23 19:13:44 -04:00
}
2019-05-14 18:48:48 -04:00
export declare type ContractInterface = string | Array<Fragment | JsonFragment | string> | Interface;
export declare class Contract {
readonly address: string;
readonly interface: Interface;
readonly signer: Signer;
readonly provider: Provider;
2020-05-29 21:27:59 -04:00
readonly functions: {
[name: string]: ContractFunction;
};
readonly callStatic: {
[name: string]: ContractFunction;
};
readonly estimateGas: {
[name: string]: ContractFunction<BigNumber>;
};
readonly populateTransaction: {
2020-06-01 05:04:12 -04:00
[name: string]: ContractFunction<PopulatedTransaction>;
2020-05-29 21:27:59 -04:00
};
readonly filters: {
[name: string]: (...args: Array<any>) => EventFilter;
};
readonly [key: string]: ContractFunction | any;
2020-03-12 19:14:50 +01:00
readonly resolvedAddress: Promise<string>;
2019-05-14 18:48:48 -04:00
readonly deployTransaction: TransactionResponse;
2020-05-29 21:27:59 -04:00
_deployedPromise: Promise<Contract>;
_runningEvents: {
[eventTag: string]: RunningEvent;
};
_wrappedEmits: {
[eventTag: string]: (...args: Array<any>) => void;
};
2020-06-01 05:04:12 -04:00
constructor(addressOrName: string, contractInterface: ContractInterface, signerOrProvider?: Signer | Provider);
2019-05-14 18:48:48 -04:00
static getContractAddress(transaction: {
from: string;
nonce: BigNumberish;
}): string;
static getInterface(contractInterface: ContractInterface): Interface;
deployed(): Promise<Contract>;
_deployed(blockTag?: BlockTag): Promise<Contract>;
fallback(overrides?: TransactionRequest): Promise<TransactionResponse>;
connect(signerOrProvider: Signer | Provider | string): Contract;
attach(addressOrName: string): Contract;
static isIndexed(value: any): value is Indexed;
2019-05-23 19:13:44 -04:00
private _normalizeRunningEvent;
private _getRunningEvent;
_checkRunningEvents(runningEvent: RunningEvent): void;
2020-04-16 21:59:53 -04:00
_wrapEvent(runningEvent: RunningEvent, log: Log, listener: Listener): Event;
2019-05-14 18:48:48 -04:00
private _addEventListener;
queryFilter(event: EventFilter, fromBlockOrBlockhash?: BlockTag | string, toBlock?: BlockTag): Promise<Array<Event>>;
2019-05-23 19:13:44 -04:00
on(event: EventFilter | string, listener: Listener): this;
once(event: EventFilter | string, listener: Listener): this;
2019-05-14 18:48:48 -04:00
emit(eventName: EventFilter | string, ...args: Array<any>): boolean;
listenerCount(eventName?: EventFilter | string): number;
listeners(eventName?: EventFilter | string): Array<Listener>;
2019-05-23 19:13:44 -04:00
removeAllListeners(eventName?: EventFilter | string): this;
off(eventName: EventFilter | string, listener: Listener): this;
removeListener(eventName: EventFilter | string, listener: Listener): this;
2019-05-14 18:48:48 -04:00
}
export declare class ContractFactory {
readonly interface: Interface;
readonly bytecode: string;
readonly signer: Signer;
constructor(contractInterface: ContractInterface, bytecode: BytesLike | {
object: string;
}, signer?: Signer);
2020-06-01 05:04:12 -04:00
getDeployTransaction(...args: Array<any>): TransactionRequest;
2019-05-14 18:48:48 -04:00
deploy(...args: Array<any>): Promise<Contract>;
attach(address: string): Contract;
connect(signer: Signer): ContractFactory;
static fromSolidity(compilerOutput: any, signer?: Signer): ContractFactory;
static getInterface(contractInterface: ContractInterface): Interface;
static getContractAddress(tx: {
from: string;
nonce: BytesLike | BigNumber | number;
}): string;
static getContract(address: string, contractInterface: ContractInterface, signer?: Signer): Contract;
}
export {};