Introducing Fairground

Introducing Vega Fairground

What is Fairground?

Fairground is Vega’s testnet. It’s built using the Vega protocol and gives people the chance to test how the protocol works, without using real money. Fairground will also offer the chance to win rewards, based on a running set of bounties (and coming soon - games). Found out more on fairground.wtf.

Note: You don’t need to take part in a bounty or incentivised game to try out Fairground. Download and run a Vega wallet, and start trading using Vega Console or the APIs.

We’d like your feedback!

What can you do on Vega right now?

In the latest version, you can:

Will the testnet be reset?

The 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 Fairground 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.

Fairground has 20 geo-distributed nodes, made up of 5 validators and 15 non-validators operating specifically for API client use.

  • REST and GraphQL: use https://lb.testnet.vega.xyz to connect to your nearest geographical node
  • gRPC: Connect directly to port 3002 on a node close to you:
    • Europe, Netherlands: n06.testnet.vega.xyz (also n11, n16)
    • Europe, Finland: n07.testnet.vega.xyz (also n12, n17)
    • Asia, Hong Kong: n08.testnet.vega.xyz (also n13, n18)
    • North America, USA (Virginia): n09.testnet.vega.xyz (also n14, n19)
    • Asia, Japan: n10.testnet.vega.xyz (also n15, n20)

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.

What’s on the roadmap?

Coming up soon we have:

  • Settlement at market expiry, based on oracles

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 message a Vega team member. 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.