Skip to content

A go command line utility providing a bunch of tools to use with a Vega network

License

Notifications You must be signed in to change notification settings

vegaprotocol/vegatools

Folders and files

NameName
Last commit message
Last commit date
Jan 3, 2024
May 30, 2024
Oct 21, 2022
Dec 19, 2023
Aug 15, 2023
Apr 12, 2024
Aug 15, 2023
Apr 19, 2023
Oct 21, 2022
Mar 7, 2023
Oct 21, 2022
Oct 21, 2022
Jan 3, 2024
Sep 23, 2024
Mar 13, 2023
Jan 10, 2023
Aug 15, 2023
Jan 6, 2023
Dec 29, 2021
Jun 1, 2023
Jan 11, 2024
Dec 7, 2021
Jan 3, 2024
Feb 22, 2021
May 15, 2021
Feb 28, 2022
Aug 15, 2023
May 20, 2024
May 20, 2024
Feb 22, 2021
Mar 23, 2021
Jun 7, 2021
Feb 1, 2022

Repository files navigation

Go Go coverage YAML lint

VEGATOOLS

This repo contains a suite of (sometimes) useful tools to use with the vega nodes API.

How to install

You can install this program by running the following go install command:

// To get the latest stable release version
go install code.vegaprotocol.io/vegatools@latest
// To get the version most in line with the core develop branch
go install code.vegaprotocol.io/vegatools@develop

Make sure that your CGO_ENABLED environment variable is set to 0. This can be checked using this command:

go env

It can be set correctly by:

go env -w CGO_ENABLED=0

Available tools

MarketDepthViewer

MarketDepthViewer is a utility that will display the market depth of a given market running on a node.

The basic command to run it is:

vegatools marketdepthviewer --address=n09.testnet.vega.xyz:3002

If there are multiple markets on a node it will display a list of them at startup and allow the user to select the one they wish to view. Pressing q will close the app.

LiquidityViewer

LiquidityViewer is a utility that displays the liquidity commitment of a user on a particular market.

The basic command to run it is:

vegatools liquidityviewer --address=n09.testnet.vega.xyz:3002

If there are multiple markets on the node it will list them and allow the user to select one. If there are multiple users on that market supplying liquidity then it will also list those and allow the user to select one. Pressing q will closer the app.

MarketStakeViewer

MarketStakeViewer is a utility that displays the current state of liquidity provision for all markets running on a node.

The basic command to run it is:

vegatools marketstakeviewer --address=n09.testnet.vega.xyz:3002

DelegationViewer

DelegationViewer displays the amount of stake delegated to each of the nodes in the network.

MarketStakeViewer

MarketStakeViewer displays the amount of stake committed to each market in terms of liquidity provision.

LiquidityCommitment

LiquidityCommitment displays all of the liquidity providers for a given market including the fee and commitment amount.

PerfTest

This creates a market and a set of users and then generates a consistent flow of transactions to the market over a given length of time to allow for performance testing and statistics recording.

EventRate

This listens to an unfiltered event bus stream and reports the number of events arriving per time bucket (default 1 second) and the amount of network bandwidth it used to receive them. The bucket length and the number of historic buckets it uses to generate the average values can be set on the commandline.

PoWRate

This runs a benchmark using the same proof of work algorithm used during the signing process to prevent spam. It reports back the number of transactions per second the machine can process and can be used to help set the proof of work difficulty value for a network. It will also allow uses to get a feel for the rate in which a wallet service will be able to process and forward on transactions if run on the same machine.

About

A go command line utility providing a bunch of tools to use with a Vega network

Topics

Resources

License

Stars

Watchers

Forks

Languages