|
|
import type {
|
|
|
TestClient,
|
|
|
TestClientMode,
|
|
|
} from '../../clients/createTestClient.js'
|
|
|
import type { Transport } from '../../clients/transports/createTransport.js'
|
|
|
import type { ErrorType } from '../../errors/utils.js'
|
|
|
import type { Account } from '../../types/account.js'
|
|
|
import type { Chain } from '../../types/chain.js'
|
|
|
import type { RequestErrorType } from '../../utils/buildRequest.js'
|
|
|
import { numberToHex } from '../../utils/encoding/toHex.js'
|
|
|
|
|
|
export type IncreaseTimeParameters = {
|
|
|
/** The amount of seconds to jump forward in time. */
|
|
|
seconds: number
|
|
|
}
|
|
|
|
|
|
export type IncreaseTimeErrorType = RequestErrorType | ErrorType
|
|
|
|
|
|
/**
|
|
|
* Jump forward in time by the given amount of time, in seconds.
|
|
|
*
|
|
|
* - Docs: https://viem.sh/docs/actions/test/increaseTime
|
|
|
*
|
|
|
* @param client - Client to use
|
|
|
* @param parameters – {@link IncreaseTimeParameters}
|
|
|
*
|
|
|
* @example
|
|
|
* import { createTestClient, http } from 'viem'
|
|
|
* import { foundry } from 'viem/chains'
|
|
|
* import { increaseTime } from 'viem/test'
|
|
|
*
|
|
|
* const client = createTestClient({
|
|
|
* mode: 'anvil',
|
|
|
* chain: 'foundry',
|
|
|
* transport: http(),
|
|
|
* })
|
|
|
* await increaseTime(client, {
|
|
|
* seconds: 420,
|
|
|
* })
|
|
|
*/
|
|
|
export async function increaseTime<
|
|
|
chain extends Chain | undefined,
|
|
|
account extends Account | undefined,
|
|
|
>(
|
|
|
client: TestClient<TestClientMode, Transport, chain, account, false>,
|
|
|
{ seconds }: IncreaseTimeParameters,
|
|
|
) {
|
|
|
return await client.request({
|
|
|
method: 'evm_increaseTime',
|
|
|
params: [numberToHex(seconds)],
|
|
|
})
|
|
|
}
|
