Introducing Testnet

Introducing Vega Testnet

What is the Vega Testnet?

Testnet is an early version of the Vega protocol that allows people to test how the protocol works, without using real money.

This is a work-in-progress, and not all the functionality that we plan to support is available. However, we’d like your feedback on what you think of it so far! You can share your feedback in a few ways:

What can you do on Vega right now?

In the latest testnet, you can:

Will the testnet be reset?

Testnet is reset every 14-21 days on Mondays at 10 am GMT (UTC), so all of your positions and collateral will also be cleared and reset. Resets may include new software releases or hotfixes for bugs, and we may need to reset more frequently for essential changes. Please see the community forums or Discord for regular updates on resets and releases.

Note: After each reset, you will need to create and deposit more testnet collateral to be able to trade.

How do the testnet nodes work?

For this version we have two types of nodes, validator nodes and non-validator nodes.

Validator nodes take care of the core trading, and provide a minimal set of APIs. Non-validator nodes provide enriched APIs, which are the ones used to send orders.

How many nodes are there and what are their URLs?

At present all nodes that make up the test network are run and maintained by Vega. When we open up the network to new participants, this documentation will be updated with requirements, instructions, and a general set of guidelines for bandwidth usage.

The Vega Testnet has nine geo-distributed nodes, with several nodes operating specifically for API client use:

  • (Europe, Netherlands)
  • (Europe, Finland)
  • (Asia, Hong Kong)
  • (North America, USA, Virginia)
  • (Connect to your nearest geographical node for REST and GraphQL. For gRPC, choose your preferred geo-distributed node.)

What isn’t yet available, and what is likely to change?

Likely to change:

  • The margin calculations are subject to change as we are working on controlling/reducing margin volatility.
  • While automated margin calculation and close-outs are implemented, not all market protections that are described in the protocol whitepaper have been included in the testnet.

Not yet supported or available:

  • Order types like stop orders and trailing stops are not yet available.

What’s to come in future releases?

  • There will be discrete trading via frequent batch auctions along with matched and block trades.
  • Vega Console will be a fully customisable user interface.

Coming up soon:

  • Amending liquidity provision orders
  • Settlement at market expiry, based on oracles, will be enabled.

What should I do if everything breaks? Where can I report issues?

Thanks in advance for sharing your feedback, it’s an essential part of this process, and will help us get closer to mainnet. You can share your feedback, bug reports, and questions on Vega’s Nolt feedback board.

How can I access the APIs and what can I use them for?

See the Using Vega’s APIs section for an introduction to the APIs and links to API documentation. We provide REST, GraphQL and gRPC interfaces that can be used to build anything from bots to full trading clients.

How do I request removal of my public/private keys from testnet?

If you have credentials supplied via Vega’s hosted wallet server, and you’d like us to delete any personal information associated with your public key and remove the key pair from the hosted wallet server, please email your contact at Vega. Please note that your transactions will still exist on the blockchain. If you use the local wallet, then Vega has no access to your login information or details, as it is pseudonymous.