block-filler
    TypeScript icon, indicating that this package has built-in type declarations

    1.0.2 • Public • Published

    Block filler

    A simple command line tool for spamming ethereum nodes with block filling transactions using deployed smart contracts.

    Install

    npm install -g block-filler

    Quickstart

    > blockfiller --help
    Usage: blockfiller [options]
     
    Options:
      --help                 Show help                                     [boolean]
      --version              Show version number                           [boolean]
      --jobfilepath, -j, -f  Path to input file.                 [string] [required]
      --accountfilepath, -a  Path to an account file containing addresses and
                             private keys. These can be used as "from" accounts and
                             signing the transactions locally.              [string]
     

    Jobs

    The script works with jobs given as input. They are specified in a JSON file as objects in an array:

    • rpc (string): the rpc endpoint of an ethereum node,
    • batchNum (num): how many transactions are sent at once
    • tx (object): transaction object as in web3
      • The blocks will be filled up ~ the specified gas limit
      • Nonces are set in the script
    • slow (bool): whether to fill the blocks with more time consuming slow operations or relatively overpriced fast ones (default: fast)
    • once (bool) whether to execute job only once or run it in an infinite loop
    • noWaitForAll (bool) whether to wait until the whole batch is mined or not

    See an example below.

    Example

    blockfiller -f ./jobs.json -a ./accounts.json
    

    Example content of a jobs file (jobs.json):

    [
        {
            "rpc": "http://localhost:8545",
            "batchNum": 10,
            "tx": {
                "from": "0xb5ee8b57b0519a32b9c6d9689bc645f3edf51302",
                "gas": 7999000,
                "gasPrice": 61
            },
            "once": true
        },
        {
            "rpc": "https://volta-rpc.energyweb.org",
            "batchNum": 1,
            "tx": {
                "from": "0xb5125eb59b200e36cf06adb57ea948ac9e6202a0",
                "gas": 7999000,
                "gasPrice": 200
            },
            "slow": true
        },
        {
            "rpc": "https://tobalaba-rpc.energyweb.org",
            "batchNum": 1,
            "tx": {
                "from": "0xb5125eb59b200e36cf06adb57ea948ac9e6202a0",
                "gas": 1000000,
                "gasPrice": 1000000000
            },
            "noWaitForAll": true
        }
    ]

    Example content of accounts file (accounts.json). These are added to web3's software wallet and used for signing locally:

    [
        {
            "address": "0xb5ee8b57b0519a32b9c6d9689bc645f3edf51302",
            "privateKey": "0x..."
        },
        {
            "address": "0xb5125eb59b200e36cf06adb57ea948ac9e6202a0",
            "privateKey": "0x..."
        }
    ]

    Contributing

    Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests.

    Versioning

    SemVer is used for versioning. For the versions available, see the tags on this repository.

    License

    This project is licensed under the GPLv3.0 License - see the LICENSE.md file for details.

    Install

    npm i block-filler

    DownloadsWeekly Downloads

    3

    Version

    1.0.2

    License

    GPL-3.0

    Unpacked Size

    226 kB

    Total Files

    26

    Last publish

    Collaborators

    • aznagy