Skip to main content
Version: 0.0.7

Starknet time

Block and state timestamp can be manipulated by setting the exact time or setting the time offset. By default, timestamp methods /set_time and /increase_time generate a new block. This can be changed for /set_time by setting the optional parameter generate_block to false. This skips immediate new block generation, but will use the specified timestamp whenever the next block is supposed to be generated.

All values should be set in Unix time seconds.

Set time​

Sets the exact time and generates a new block.

POST /set_time
{
    "time": TIME_IN_SECONDS
}

Doesn't generate a new block, but sets the exact time for the next generated block.

POST /set_time
{
    "time": TIME_IN_SECONDS,
    "generate_block": false
}

Warning: block time can be set in the past which might lead to unexpected behavior!

Increase time​

Increases the block timestamp by the provided amount and generates a new block. All subsequent blocks will keep this increment.

POST /increase_time
{
    "time": TIME_IN_SECONDS
}

Start time argument​

Devnet can be started with --start-time CLI argument, where START_TIME_IN_SECONDS should be greater than 0.

$ starknet-devnet --start-time <START_TIME_IN_SECONDS>