📇 PoolTogether V4 CLI

The @mmasood/v4-cli node module package is a NODE command line interface (CLI) to interact with the PoolTogether V4 protocol. The CLI uses the v4-client-js and v4-utils-js modules to fetch and run calculations/computations for essential PoolTogether V4 tasks.

Primary CLI Commands (help)

npx @mmasood/v4-cli help compute drawPrizes
npx @mmasood/v4-cli help compute poolPrizes
npx @mmasood/v4-cli help compute networkPrizes

⌨️ CLI Installation

$ npm install -g @mmasood/v4-cli
$ ptv4 COMMAND
running command...
$ ptv4 (--version)
@mmasood/v4-cli/0.1.11-beta.1 linux-x64 node-v18.20.2
$ ptv4 --help [COMMAND]
USAGE
  $ ptv4 COMMAND
...

$ npm install -g @mmasood/v4-cli
$ ptv4 COMMAND
running command...
$ ptv4 (--version)
@mmasood/v4-cli/0.1.11-beta.1 linux-x64 node-v16.15.1
$ ptv4 --help [COMMAND]
USAGE
  $ ptv4 COMMAND
...

Commands

Compute Draw Prizes

ptv4 compute drawPrizes

Computes single Draw prizes for a PrizePool to a target output directory.

Simply pass a chainId, ticket drawId and outDir to compute and locally save the results.

USAGE
  $ ptv4 compute drawPrizes --chainId 1 --drawId 65 --outDir ./temp --ticket '0xdd4d117723C257CEe402285D3aCF218E9A8236E1'

DESCRIPTION
  Computes single Draw prizes for a PrizePool to a target output directory.

EXAMPLES
  $ ptv4 compute drawPrizes --chainId 1 --drawId 1 --ticket 0x0000000000000000000000000000000000000000 --outDir ./temp
    Running compute:drawPrizes on chainId: 1 using drawID: 1

Status File (status.json)

{
  "status": "LOADING",
  "createdAt": "11"
}

Success

{
  "status": "SUCCESS",
  "createdAt": "11",
  "updatedAt": "33",
  "runtime": "22",
  "meta": {
    "prizeLength": "10",
    "amountsTotal": "5000000"
  }
}

Failure

{
  "status": "FAILURE",
  "createdAt": "11",
  "updatedAt": "33",
  "runtime": "22",
  "error": "ErrorCode"
}

Compute PrizePool Prizes

Computes all historical Draw prizes for a PrizePool to a target output directory.

ptv4 compute poolPrizes

USAGE
  $ ptv4 compute poolPrizes --chainId 1 --outDir ./temp --ticket '0xdd4d117723C257CEe402285D3aCF218E9A8236E1'

DESCRIPTION
  Computes all historical Draw prizes for a PrizePool to a target output directory.

EXAMPLES
  $ ptv4 compute poolPrizes --chainId 1--ticket 0x0000000000000000000000000000000000000000 --outDir ./temp
    Running compute:drawPrizes on chainId: 1 using drawID: 1

Compute Network of PrizePool Prizes

Computes Draw prizes for all PoolTogether V4 network PrizePools to a target output directory.

ptv4 compute networkPrizes

USAGE
  $ ptv4 compute networkPrizes --outDir ./temp

DESCRIPTION
  Computes Draw prizes for all PoolTogether V4 network PrizePools to a target output directory.

EXAMPLES
  $ ptv4 compute poolPrizes --chainId 1 --ticket 0x0000000000000000000000000000000000000000 --outDir ./temp
    Running compute:drawPrizes on chainId: 1 using drawID: 1

Help

ptv4 help [COMMAND]

Display help for ptv4.

USAGE
  $ ptv4 help [COMMAND] [-n]

ARGUMENTS
  COMMAND  Command to show help for.

FLAGS
  -n, --nested-commands  Include all nested commands in the output.

DESCRIPTION
  Display help for ptv4.