1 unstable release

0.1.0 Aug 19, 2023

#9 in #estimator

MIT license

19KB
193 lines

woodcock

Woodcock is a blocktime estimator for Starknet written in Rust. Made by learning purpose. This project is inspired by (snipe).

Features

Convert blocknumber to time.

This feature relies on the starknet_getBlockWithTxHashes endpoint. Get timestamp from blocknumber through this endpoint. If you want to return in unix format, add -f unix command.

Convert time to blocknumber.

This feature is using binary search algorithm to search for the nearest blocknumber with given target timestamp.

Select network want to query.

You can use options to choose. -n mainnet will allow you to query from Starkent mainnet, -n goerli will allow you to query from Starkent goerli, -n goerli2 will allow you to query from Starkent goerli2.

Usage

Usage: woodcock [OPTIONS] [COMMAND]

Commands:
  --to-time   Convert blocknumber to time. [aliases: btt]
  --to-block  Convert time to blocknumber. [aliases: ttb]
  help        Print this message or the help of the given subcommand(s)

Options:
  -t, --timezone <TIME_ZONE>  Timezone
  -n, --network <NETWORK>     Network: [mainnet/goerli/goerli2]
  -f, --format <TIME_FORMAT>  The format to use time
  -h, --help                  Print help

--to-block

Convert time to blocknumber.

Usage: woodcock --to-block <TIME>

Arguments:
  <TIME>  The time to convert

Options:
  -h, --help  Print help

--to-time

Convert blocknumber to time.

Usage: woodcock --to-time <BLOCK_NUMBER>

Arguments:
  <BLOCK_NUMBER>  The blocknumber to convert

Options:
  -h, --help  Print help

Improvement

  • timezone support
  • RPC support ( gateway will be deprecated )
  • algorithm upgrade?

Dependencies

~17–30MB
~456K SLoC