getForkClient
getForkClient(
baseState
):object
Parameters
• baseState: BaseState
Returns
object
account
account:
undefined
The Account of the Client.
batch?
optional
batch:object
Flags for batch settings.
batch.multicall?
optional
batch.multicall:boolean
|object
Toggle to enable eth_call
multicall aggregation.
cacheTime
cacheTime:
number
Time (in ms) that cached data will remain in memory.
call()
call: (
parameters
) =>Promise
<CallReturnType
>
Parameters
• parameters: CallParameters
<undefined
| Chain
>
Returns
Promise
<CallReturnType
>
The call data. CallReturnType
ccipRead?
optional
ccipRead:false
|object
CCIP Read configuration.
chain
chain:
undefined
|Chain
Chain for the client.
createBlockFilter()
createBlockFilter: () =>
Promise
<object
>
Returns
Promise
<object
>
Filter. CreateBlockFilterReturnType
id
id: `0x${string}`
request
request:
EIP1193RequestFn
<readonly [object
,object
,object
]>
type
type:
"block"
createContractEventFilter()
createContractEventFilter: <
abi
,eventName
,args
,strict
,fromBlock
,toBlock
>(args
) =>Promise
<CreateContractEventFilterReturnType
<abi
,eventName
,args
,strict
,fromBlock
,toBlock
>>
Type Parameters
• abi extends Abi
| readonly unknown
[]
• eventName extends undefined
| string
• args extends undefined
| Record
<string
, unknown
> | readonly unknown
[]
• strict extends undefined
| boolean
= undefined
• fromBlock extends undefined
| bigint
| BlockTag
= undefined
• toBlock extends undefined
| bigint
| BlockTag
= undefined
Parameters
• args: CreateContractEventFilterParameters
<abi
, eventName
, args
, strict
, fromBlock
, toBlock
>
CreateContractEventFilterParameters
Returns
Promise
<CreateContractEventFilterReturnType
<abi
, eventName
, args
, strict
, fromBlock
, toBlock
>>
Filter
. CreateContractEventFilterReturnType
createEventFilter()
createEventFilter: <
abiEvent
,abiEvents
,strict
,fromBlock
,toBlock
,_EventName
,_Args
>(args
?) =>Promise
<{ [K in string | number | symbol]: Filter<“event”, abiEvents, _EventName, _Args, strict, fromBlock, toBlock>[K] }>
Type Parameters
• abiEvent extends undefined
| AbiEvent
= undefined
• abiEvents extends undefined
| readonly unknown
[] | readonly AbiEvent
[] = abiEvent
extends AbiEvent
? [abiEvent
<abiEvent
>] : undefined
• strict extends undefined
| boolean
= undefined
• fromBlock extends undefined
| bigint
| BlockTag
= undefined
• toBlock extends undefined
| bigint
| BlockTag
= undefined
• _EventName extends undefined
| string
= MaybeAbiEventName
<abiEvent
>
• _Args extends undefined
| Record
<string
, unknown
> | readonly unknown
[] = undefined
Parameters
• args?: CreateEventFilterParameters
<abiEvent
, abiEvents
, strict
, fromBlock
, toBlock
, _EventName
, _Args
>
Returns
Promise
<{ [K in string | number | symbol]: Filter<“event”, abiEvents, _EventName, _Args, strict, fromBlock, toBlock>[K] }>
Filter
. CreateEventFilterReturnType
createPendingTransactionFilter()
createPendingTransactionFilter: () =>
Promise
<object
>
Returns
Promise
<object
>
Filter
. CreateBlockFilterReturnType
id
id: `0x${string}`
request
request:
EIP1193RequestFn
<readonly [object
,object
,object
]>
type
type:
"transaction"
estimateContractGas()
estimateContractGas: <
chain
,abi
,functionName
,args
>(args
) =>Promise
<bigint
>
Type Parameters
• chain extends undefined
| Chain
• abi extends Abi
| readonly unknown
[]
• functionName extends string
• args extends unknown
Parameters
• args: EstimateContractGasParameters
<abi
, functionName
, args
, chain
>
EstimateContractGasParameters
Returns
Promise
<bigint
>
The gas estimate (in wei). EstimateContractGasReturnType
estimateFeesPerGas()
estimateFeesPerGas: <
chainOverride
,type
>(args
?) =>Promise
<EstimateFeesPerGasReturnType
<type
>>
Type Parameters
• chainOverride extends undefined
| Chain
= undefined
• type extends FeeValuesType
= "eip1559"
Parameters
• args?: EstimateFeesPerGasParameters
<undefined
| Chain
, chainOverride
, type
>
Returns
Promise
<EstimateFeesPerGasReturnType
<type
>>
An estimate (in wei) for the fees per gas. EstimateFeesPerGasReturnType
estimateGas()
estimateGas: (
args
) =>Promise
<bigint
>
Parameters
• args: EstimateGasParameters
<undefined
| Chain
>
EstimateGasParameters
Returns
Promise
<bigint
>
The gas estimate (in wei). EstimateGasReturnType
estimateMaxPriorityFeePerGas()
estimateMaxPriorityFeePerGas: <
chainOverride
>(args
?) =>Promise
<bigint
>
Type Parameters
• chainOverride extends undefined
| Chain
= undefined
Parameters
• args?
• args.chain?: null
| chainOverride
Returns
Promise
<bigint
>
An estimate (in wei) for the max priority fee per gas. EstimateMaxPriorityFeePerGasReturnType
extend()
extend: <
client
>(fn
) =>Client
<Transport
,undefined
|Chain
,undefined
,PublicRpcSchema
, { [K in string | number | symbol]: client[K] } &PublicActions
<Transport
,undefined
|Chain
>>
Type Parameters
• client extends object
& ExactPartial
<ExtendableProtectedActions
<Transport
, undefined
| Chain
, undefined
>>
Parameters
• fn
Returns
Client
<Transport
, undefined
| Chain
, undefined
, PublicRpcSchema
, { [K in string | number | symbol]: client[K] } & PublicActions
<Transport
, undefined
| Chain
>>
getBalance()
getBalance: (
args
) =>Promise
<bigint
>
Parameters
• args: GetBalanceParameters
GetBalanceParameters
Returns
Promise
<bigint
>
The balance of the address in wei. GetBalanceReturnType
getBlobBaseFee()
getBlobBaseFee: () =>
Promise
<bigint
>
Returns
Promise
<bigint
>
The blob base fee (in wei). GetBlobBaseFeeReturnType
getBlock()
getBlock: <
includeTransactions
,blockTag
>(args
?) =>Promise
<object
>
Type Parameters
• includeTransactions extends boolean
= false
• blockTag extends BlockTag
= "latest"
Parameters
• args?: GetBlockParameters
<includeTransactions
, blockTag
>
GetBlockParameters
Returns
Promise
<object
>
Information about the block. GetBlockReturnType
baseFeePerGas
baseFeePerGas:
null
|bigint
Base fee per gas
blobGasUsed
blobGasUsed:
bigint
Total used blob gas by all transactions in this block
difficulty
difficulty:
bigint
Difficulty for this block
excessBlobGas
excessBlobGas:
bigint
Excess blob gas
extraData
extraData: `0x${string}`
“Extra data” field of this block
gasLimit
gasLimit:
bigint
Maximum gas allowed in this block
gasUsed
gasUsed:
bigint
Total used gas by all transactions in this block
hash
hash:
blockTag
extends"pending"
?null
: `0x${string}`
Block hash or null
if pending
logsBloom
logsBloom:
blockTag
extends"pending"
?null
: `0x${string}`
Logs bloom filter or null
if pending
miner
miner: `0x${string}`
Address that received this block’s mining rewards
mixHash
mixHash: `0x${string}`
Unique identifier for the block.
nonce
nonce:
blockTag
extends"pending"
?null
: `0x${string}`
Proof-of-work hash or null
if pending
number
number:
blockTag
extends"pending"
?null
:bigint
Block number or null
if pending
parentHash
parentHash: `0x${string}`
Parent block hash
receiptsRoot
receiptsRoot: `0x${string}`
Root of the this block’s receipts trie
sealFields
sealFields: `0x${string}`[]
sha3Uncles
sha3Uncles: `0x${string}`
SHA3 of the uncles data in this block
size
size:
bigint
Size of this block in bytes
stateRoot
stateRoot: `0x${string}`
Root of this block’s final state trie
timestamp
timestamp:
bigint
Unix timestamp of when this block was collated
totalDifficulty
totalDifficulty:
null
|bigint
Total difficulty of the chain until this block
transactions
transactions:
includeTransactions
extendstrue
? (object
|object
|object
|object
|object
)[] : `0x${string}`[]
transactionsRoot
transactionsRoot: `0x${string}`
Root of this block’s transaction trie
uncles
uncles: `0x${string}`[]
List of uncle hashes
withdrawals?
optional
withdrawals:Withdrawal
[]
List of withdrawal objects
withdrawalsRoot?
optional
withdrawalsRoot: `0x${string}`
Root of the this block’s withdrawals trie
getBlockNumber()
getBlockNumber: (
args
?) =>Promise
<bigint
>
Parameters
• args?: GetBlockNumberParameters
GetBlockNumberParameters
Returns
Promise
<bigint
>
The number of the block. GetBlockNumberReturnType
getBlockTransactionCount()
getBlockTransactionCount: (
args
?) =>Promise
<number
>
Parameters
• args?: GetBlockTransactionCountParameters
GetBlockTransactionCountParameters
Returns
Promise
<number
>
The block transaction count. GetBlockTransactionCountReturnType
getBytecode()
getBytecode: (
args
) =>Promise
<GetCodeReturnType
>
Parameters
• args: GetCodeParameters
Returns
Promise
<GetCodeReturnType
>
getChainId()
getChainId: () =>
Promise
<number
>
Returns
Promise
<number
>
The current chain ID. GetChainIdReturnType
getCode()
getCode: (
args
) =>Promise
<GetCodeReturnType
>
Parameters
• args: GetCodeParameters
GetBytecodeParameters
Returns
Promise
<GetCodeReturnType
>
The contract’s bytecode. GetBytecodeReturnType
getContractEvents()
getContractEvents: <
abi
,eventName
,strict
,fromBlock
,toBlock
>(args
) =>Promise
<GetContractEventsReturnType
<abi
,eventName
,strict
,fromBlock
,toBlock
>>
Type Parameters
• abi extends Abi
| readonly unknown
[]
• eventName extends undefined
| string
= undefined
• strict extends undefined
| boolean
= undefined
• fromBlock extends undefined
| bigint
| BlockTag
= undefined
• toBlock extends undefined
| bigint
| BlockTag
= undefined
Parameters
• args: GetContractEventsParameters
<abi
, eventName
, strict
, fromBlock
, toBlock
>
Returns
Promise
<GetContractEventsReturnType
<abi
, eventName
, strict
, fromBlock
, toBlock
>>
A list of event logs. GetContractEventsReturnType
getEip712Domain()
getEip712Domain: (
args
) =>Promise
<GetEip712DomainReturnType
>
Parameters
• args: GetEip712DomainParameters
Returns
Promise
<GetEip712DomainReturnType
>
The EIP-712 domain, fields, and extensions. GetEip712DomainReturnType
getEnsAddress()
getEnsAddress: (
args
) =>Promise
<GetEnsAddressReturnType
>
Parameters
• args
GetEnsAddressParameters
• args.blockNumber?: bigint
The balance of the account at a block number.
• args.blockTag?: BlockTag
The balance of the account at a block tag.
Default
• args.coinType?: number
ENSIP-9 compliant coinType used to resolve addresses for other chains
• args.gatewayUrls?: string
[]
Universal Resolver gateway URLs to use for resolving CCIP-read requests.
• args.name: string
Name to get the address for.
• args.strict?: boolean
Whether or not to throw errors propagated from the ENS Universal Resolver Contract.
• args.universalResolverAddress?: `0x${string}`
Address of ENS Universal Resolver Contract.
Returns
Promise
<GetEnsAddressReturnType
>
Address for ENS name or null
if not found. GetEnsAddressReturnType
getEnsAvatar()
getEnsAvatar: (
args
) =>Promise
<GetEnsAvatarReturnType
>
Parameters
• args
GetEnsAvatarParameters
• args.assetGatewayUrls?: AssetGatewayUrls
Gateway urls to resolve IPFS and/or Arweave assets.
• args.blockNumber?: bigint
The balance of the account at a block number.
• args.blockTag?: BlockTag
The balance of the account at a block tag.
Default
• args.gatewayUrls?: string
[]
Universal Resolver gateway URLs to use for resolving CCIP-read requests.
• args.name: string
ENS name to get Text for.
• args.strict?: boolean
Whether or not to throw errors propagated from the ENS Universal Resolver Contract.
• args.universalResolverAddress?: `0x${string}`
Address of ENS Universal Resolver Contract.
Returns
Promise
<GetEnsAvatarReturnType
>
Avatar URI or null
if not found. GetEnsAvatarReturnType
getEnsName()
getEnsName: (
args
) =>Promise
<GetEnsNameReturnType
>
Parameters
• args
GetEnsNameParameters
• args.address: `0x${string}`
Address to get ENS name for.
• args.blockNumber?: bigint
The balance of the account at a block number.
• args.blockTag?: BlockTag
The balance of the account at a block tag.
Default
• args.gatewayUrls?: string
[]
Universal Resolver gateway URLs to use for resolving CCIP-read requests.
• args.strict?: boolean
Whether or not to throw errors propagated from the ENS Universal Resolver Contract.
• args.universalResolverAddress?: `0x${string}`
Address of ENS Universal Resolver Contract.
Returns
Promise
<GetEnsNameReturnType
>
Name or null
if not found. GetEnsNameReturnType
getEnsResolver()
getEnsResolver: (
args
) =>Promise
<`0x${string}`>
Parameters
• args
GetEnsResolverParameters
• args.blockNumber?: bigint
The balance of the account at a block number.
• args.blockTag?: BlockTag
The balance of the account at a block tag.
Default
• args.name: string
Name to get the address for.
• args.universalResolverAddress?: `0x${string}`
Address of ENS Universal Resolver Contract.
Returns
Promise
<`0x${string}`>
Address for ENS resolver. GetEnsResolverReturnType
getEnsText()
getEnsText: (
args
) =>Promise
<GetEnsTextReturnType
>
Parameters
• args
GetEnsTextParameters
• args.blockNumber?: bigint
The balance of the account at a block number.
• args.blockTag?: BlockTag
The balance of the account at a block tag.
Default
• args.gatewayUrls?: string
[]
Universal Resolver gateway URLs to use for resolving CCIP-read requests.
• args.key: string
Text record to retrieve.
• args.name: string
ENS name to get Text for.
• args.strict?: boolean
Whether or not to throw errors propagated from the ENS Universal Resolver Contract.
• args.universalResolverAddress?: `0x${string}`
Address of ENS Universal Resolver Contract.
Returns
Promise
<GetEnsTextReturnType
>
Address for ENS resolver. GetEnsTextReturnType
getFeeHistory()
getFeeHistory: (
args
) =>Promise
<GetFeeHistoryReturnType
>
Parameters
• args: GetFeeHistoryParameters
GetFeeHistoryParameters
Returns
Promise
<GetFeeHistoryReturnType
>
The gas estimate (in wei). GetFeeHistoryReturnType
getFilterChanges()
getFilterChanges: <
filterType
,abi
,eventName
,strict
,fromBlock
,toBlock
>(args
) =>Promise
<GetFilterChangesReturnType
<filterType
,abi
,eventName
,strict
,fromBlock
,toBlock
>>
Type Parameters
• filterType extends FilterType
• abi extends undefined
| Abi
| readonly unknown
[]
• eventName extends undefined
| string
• strict extends undefined
| boolean
= undefined
• fromBlock extends undefined
| bigint
| BlockTag
= undefined
• toBlock extends undefined
| bigint
| BlockTag
= undefined
Parameters
• args: GetFilterChangesParameters
<filterType
, abi
, eventName
, strict
, fromBlock
, toBlock
>
GetFilterChangesParameters
Returns
Promise
<GetFilterChangesReturnType
<filterType
, abi
, eventName
, strict
, fromBlock
, toBlock
>>
Logs or hashes. GetFilterChangesReturnType
getFilterLogs()
getFilterLogs: <
abi
,eventName
,strict
,fromBlock
,toBlock
>(args
) =>Promise
<GetFilterLogsReturnType
<abi
,eventName
,strict
,fromBlock
,toBlock
>>
Type Parameters
• abi extends undefined
| Abi
| readonly unknown
[]
• eventName extends undefined
| string
• strict extends undefined
| boolean
= undefined
• fromBlock extends undefined
| bigint
| BlockTag
= undefined
• toBlock extends undefined
| bigint
| BlockTag
= undefined
Parameters
• args: GetFilterLogsParameters
<abi
, eventName
, strict
, fromBlock
, toBlock
>
GetFilterLogsParameters
Returns
Promise
<GetFilterLogsReturnType
<abi
, eventName
, strict
, fromBlock
, toBlock
>>
A list of event logs. GetFilterLogsReturnType
getGasPrice()
getGasPrice: () =>
Promise
<bigint
>
Returns
Promise
<bigint
>
The gas price (in wei). GetGasPriceReturnType
getLogs()
getLogs: <
abiEvent
,abiEvents
,strict
,fromBlock
,toBlock
>(args
?) =>Promise
<GetLogsReturnType
<abiEvent
,abiEvents
,strict
,fromBlock
,toBlock
>>
Type Parameters
• abiEvent extends undefined
| AbiEvent
= undefined
• abiEvents extends undefined
| readonly unknown
[] | readonly AbiEvent
[] = abiEvent
extends AbiEvent
? [abiEvent
<abiEvent
>] : undefined
• strict extends undefined
| boolean
= undefined
• fromBlock extends undefined
| bigint
| BlockTag
= undefined
• toBlock extends undefined
| bigint
| BlockTag
= undefined
Parameters
• args?: GetLogsParameters
<abiEvent
, abiEvents
, strict
, fromBlock
, toBlock
>
GetLogsParameters
Returns
Promise
<GetLogsReturnType
<abiEvent
, abiEvents
, strict
, fromBlock
, toBlock
>>
A list of event logs. GetLogsReturnType
getProof()
getProof: (
args
) =>Promise
<GetProofReturnType
>
Parameters
• args: GetProofParameters
Returns
Promise
<GetProofReturnType
>
Proof data. GetProofReturnType
getStorageAt()
getStorageAt: (
args
) =>Promise
<GetStorageAtReturnType
>
Parameters
• args: GetStorageAtParameters
GetStorageAtParameters
Returns
Promise
<GetStorageAtReturnType
>
The value of the storage slot. GetStorageAtReturnType
getTransaction()
getTransaction: <
blockTag
>(args
) =>Promise
<object
|object
|object
|object
|object
>
Type Parameters
• blockTag extends BlockTag
= "latest"
Parameters
• args: GetTransactionParameters
<blockTag
>
GetTransactionParameters
Returns
Promise
<object
| object
| object
| object
| object
>
The transaction information. GetTransactionReturnType
getTransactionConfirmations()
getTransactionConfirmations: (
args
) =>Promise
<bigint
>
Parameters
• args: GetTransactionConfirmationsParameters
<undefined
| Chain
>
GetTransactionConfirmationsParameters
Returns
Promise
<bigint
>
The number of blocks passed since the transaction was processed. If confirmations is 0, then the Transaction has not been confirmed & processed yet. GetTransactionConfirmationsReturnType
getTransactionCount()
getTransactionCount: (
args
) =>Promise
<number
>
Parameters
• args: GetTransactionCountParameters
GetTransactionCountParameters
Returns
Promise
<number
>
The number of transactions an account has sent. GetTransactionCountReturnType
getTransactionReceipt()
getTransactionReceipt: (
args
) =>Promise
<TransactionReceipt
>
Parameters
• args: GetTransactionReceiptParameters
GetTransactionReceiptParameters
Returns
Promise
<TransactionReceipt
>
The transaction receipt. GetTransactionReceiptReturnType
key
key:
string
A key for the client.
multicall()
multicall: <
contracts
,allowFailure
>(args
) =>Promise
<MulticallReturnType
<contracts
,allowFailure
>>
Type Parameters
• contracts extends readonly unknown
[]
• allowFailure extends boolean
= true
Parameters
• args: MulticallParameters
<contracts
, allowFailure
>
MulticallParameters
Returns
Promise
<MulticallReturnType
<contracts
, allowFailure
>>
An array of results with accompanying status. MulticallReturnType
name
name:
string
A name for the client.
pollingInterval
pollingInterval:
number
Frequency (in ms) for polling enabled actions & events. Defaults to 4_000 milliseconds.
prepareTransactionRequest()
prepareTransactionRequest: <
request
,chainOverride
,accountOverride
>(args
) =>Promise
<{ [K in string | number | symbol]: (UnionRequiredBy<Extract<UnionOmit<(…), (…)> & ((…) extends (…) ? (…) : (…)) & ((…) extends (…) ? (…) : (…)), IsNever<(…)> extends true ? unknown : ExactPartial<(…)>> & Object, ParameterTypeToParameters<request[“parameters”] extends readonly PrepareTransactionRequestParameterType[] ? any[any][number] : “type” | “gas” | “nonce” | “blobVersionedHashes” | “fees” | “chainId”>> & (unknown extends request[“kzg”] ? Object : Pick<request, “kzg”>))[K] }>
Type Parameters
• request extends Omit
<object
, "from"
> | Omit
<object
, "from"
> | Omit
<object
, "from"
> | Omit
<object
, "from"
> | Omit
<object
, "from"
> & object
& object
• chainOverride extends undefined
| Chain
= undefined
• accountOverride extends undefined
| `0x${string}` | Account
= undefined
Parameters
• args: PrepareTransactionRequestParameters
<undefined
| Chain
, undefined
| Account
, chainOverride
, accountOverride
, request
>
PrepareTransactionRequestParameters
Returns
Promise
<{ [K in string | number | symbol]: (UnionRequiredBy<Extract<UnionOmit<(…), (…)> & ((…) extends (…) ? (…) : (…)) & ((…) extends (…) ? (…) : (…)), IsNever<(…)> extends true ? unknown : ExactPartial<(…)>> & Object, ParameterTypeToParameters<request[“parameters”] extends readonly PrepareTransactionRequestParameterType[] ? any[any][number] : “type” | “gas” | “nonce” | “blobVersionedHashes” | “fees” | “chainId”>> & (unknown extends request[“kzg”] ? Object : Pick<request, “kzg”>))[K] }>
The transaction request. PrepareTransactionRequestReturnType
readContract()
readContract: <
abi
,functionName
,args
>(args
) =>Promise
<ReadContractReturnType
<abi
,functionName
,args
>>
Type Parameters
• abi extends Abi
| readonly unknown
[]
• functionName extends string
• args extends unknown
Parameters
• args: ReadContractParameters
<abi
, functionName
, args
>
ReadContractParameters
Returns
Promise
<ReadContractReturnType
<abi
, functionName
, args
>>
The response from the contract. Type is inferred. ReadContractReturnType
request
request:
EIP1193RequestFn
<PublicRpcSchema
>
Request function wrapped with friendly error handling
sendRawTransaction()
sendRawTransaction: (
args
) =>Promise
<`0x${string}`>
Parameters
• args: SendRawTransactionParameters
Returns
Promise
<`0x${string}`>
The transaction hash. SendRawTransactionReturnType
simulateContract()
simulateContract: <
abi
,functionName
,args
,chainOverride
,accountOverride
>(args
) =>Promise
<SimulateContractReturnType
<abi
,functionName
,args
,undefined
|Chain
,undefined
|Account
,chainOverride
,accountOverride
>>
Type Parameters
• abi extends Abi
| readonly unknown
[]
• functionName extends string
• args extends unknown
• chainOverride extends undefined
| Chain
• accountOverride extends undefined
| `0x${string}` | Account
= undefined
Parameters
• args: SimulateContractParameters
<abi
, functionName
, args
, undefined
| Chain
, chainOverride
, accountOverride
>
SimulateContractParameters
Returns
Promise
<SimulateContractReturnType
<abi
, functionName
, args
, undefined
| Chain
, undefined
| Account
, chainOverride
, accountOverride
>>
The simulation result and write request. SimulateContractReturnType
transport
transport:
TransportConfig
<string
,EIP1193RequestFn
> &Record
<string
,any
>
The RPC transport
type
type:
string
The type of client.
uid
uid:
string
A unique ID for the client.
uninstallFilter()
uninstallFilter: (
args
) =>Promise
<boolean
>
Parameters
• args: UninstallFilterParameters
UninstallFilterParameters
Returns
Promise
<boolean
>
A boolean indicating if the Filter was successfully uninstalled. UninstallFilterReturnType
verifyMessage()
verifyMessage: (
args
) =>Promise
<boolean
>
Parameters
• args
• args.address: `0x${string}`
The address that signed the original message.
• args.blockNumber?: bigint
The balance of the account at a block number.
• args.blockTag?: BlockTag
The balance of the account at a block tag.
Default
• args.factory?: `0x${string}`
• args.factoryData?: `0x${string}`
• args.message: SignableMessage
The message to be verified.
• args.signature: `0x${string}` | Uint8Array
| Signature
The signature that was generated by signing the message with the address’s private key.
Returns
Promise
<boolean
>
Whether or not the signature is valid. VerifyMessageReturnType
verifySiweMessage()
verifySiweMessage: (
args
) =>Promise
<boolean
>
Parameters
• args
• args.address?: `0x${string}`
Ethereum address to check against.
• args.blockNumber?: bigint
The balance of the account at a block number.
• args.blockTag?: BlockTag
The balance of the account at a block tag.
Default
• args.domain?: string
RFC 3986 authority to check against.
• args.message: string
EIP-4361 formatted message.
• args.nonce?: string
Random string to check against.
• args.scheme?: string
RFC 3986 URI scheme to check against.
• args.signature: `0x${string}`
Signature to check against.
• args.time?: Date
Current time to check optional expirationTime
and notBefore
fields.
Default
Returns
Promise
<boolean
>
Whether or not the signature is valid. VerifySiweMessageReturnType
verifyTypedData()
verifyTypedData: (
args
) =>Promise
<boolean
>
Parameters
• args: VerifyTypedDataParameters
Returns
Promise
<boolean
>
Whether or not the signature is valid. VerifyTypedDataReturnType
waitForTransactionReceipt()
waitForTransactionReceipt: (
args
) =>Promise
<TransactionReceipt
>
Parameters
• args: WaitForTransactionReceiptParameters
<undefined
| Chain
>
WaitForTransactionReceiptParameters
Returns
Promise
<TransactionReceipt
>
The transaction receipt. WaitForTransactionReceiptReturnType
watchBlockNumber()
watchBlockNumber: (
args
) =>WatchBlockNumberReturnType
Parameters
• args: WatchBlockNumberParameters
WatchBlockNumberParameters
Returns
WatchBlockNumberReturnType
A function that can be invoked to stop watching for new block numbers. WatchBlockNumberReturnType
watchBlocks()
watchBlocks: <
includeTransactions
,blockTag
>(args
) =>WatchBlocksReturnType
Type Parameters
• includeTransactions extends boolean
= false
• blockTag extends BlockTag
= "latest"
Parameters
• args: WatchBlocksParameters
<Transport
, undefined
| Chain
, includeTransactions
, blockTag
>
WatchBlocksParameters
Returns
WatchBlocksReturnType
A function that can be invoked to stop watching for new block numbers. WatchBlocksReturnType
watchContractEvent()
watchContractEvent: <
abi
,eventName
,strict
>(args
) =>WatchContractEventReturnType
Type Parameters
• abi extends Abi
| readonly unknown
[]
• eventName extends string
• strict extends undefined
| boolean
= undefined
Parameters
• args: WatchContractEventParameters
<abi
, eventName
, strict
, Transport
>
WatchContractEventParameters
Returns
WatchContractEventReturnType
A function that can be invoked to stop watching for new event logs. WatchContractEventReturnType
watchEvent()
watchEvent: <
abiEvent
,abiEvents
,strict
>(args
) =>WatchEventReturnType
Type Parameters
• abiEvent extends undefined
| AbiEvent
= undefined
• abiEvents extends undefined
| readonly unknown
[] | readonly AbiEvent
[] = abiEvent
extends AbiEvent
? [abiEvent
<abiEvent
>] : undefined
• strict extends undefined
| boolean
= undefined
Parameters
• args: WatchEventParameters
<abiEvent
, abiEvents
, strict
, Transport
>
WatchEventParameters
Returns
WatchEventReturnType
A function that can be invoked to stop watching for new Event Logs. WatchEventReturnType
watchPendingTransactions()
watchPendingTransactions: (
args
) =>WatchPendingTransactionsReturnType
Parameters
• args: WatchPendingTransactionsParameters
<Transport
>
WatchPendingTransactionsParameters
Returns
WatchPendingTransactionsReturnType
A function that can be invoked to stop watching for new pending transaction hashes. WatchPendingTransactionsReturnType