You are viewing an archive of the Piccadilly Circus Games Competition. Join our Discord for the latest information.
Develop Use Cases
Develop use cases for the Autonity community. Make use of Autonity as an L1 platform and lever its primitives in your application. Participate in pre-defined use case tasks for Round #6 or use your own inspiration to design and develop your own use case if you want! Just be guided by Autonity’s vision of decentralised infrastructure for borderless markets. You can make as many submissions as you can master…
Synopsis
You compete in this challenge by developing a use case application for Autonity.
There are multiple use case tasks for Round #6 in four categories:
- LNTN Market making and P2P trading (AirSwap)
- Fungible LNTN token
- Integrate new oracle price feeds for prices
- Develop your own use case
A roulette award is also run at the end of the round, giving game participants who have entered for a Develop Tooling task but not yet won an award an opportunity to win.
Entries can be submitted at any point between the start time of the Games and the end time of the final Game Round #6. Entries submitted between the start and end dates of a Game Round will be judged at the end of that round. Entries submitted between game rounds will be carried forward as an entry to the next round. A participant can submit multiple entries for Use case Tasks in a Round and throughout the Games.
Winners will be announced at round end with other award winners.
How to enter
How to submit entries to the Best use case award
Ready to take part? Complete the Games Registration Form if you haven’t done so already.
Develop Use case task entries are submitted in a simple process:
- Develop – Develop your submission in a repository of the GitHub account you provided at game registration and make the repo publicly accessible. Label your repo with topics
autonity
and other topics appropriate to the use case - Submit – Use Developer awards Form to submit an entry to the Games. Select the form’s option Best use case award and be sure to provide the url to the project’s repo.
Submitted entries must be in the public domain and open sourced if licensed. See Licensing for award submissions for accepted licenses.
Remember to publish your use case to the community so other game participants can make use of it?
Post your use case to Autonity’s Discord Server in the PICCADILLY CIRCUS GAMES / Developer
channel!
Awards
The develop use case challenge has 5 awards for Round #6:
Sub-task | Task award pool share | Award Tributes |
---|---|---|
LNTN Market making and P2P trading (AirSwap) | 44% |
40,000 |
Fungible LNTN token | 11% |
10,000 |
Integrate new oracle price feeds | 11% |
10,000 |
Develop your own use case | 28% |
25,000 |
Roulette Award | 6 % |
5,000 |
The Develop Use case tasks have multiple winners in each category. The Roulette Award randomly selects 5 participants who have entered for a develop tooling task during the game but have not been chosen as a winner.
Upon completion of Round #6, selected winners will win Award Tributes per the table beneath.
Task | Award Tributes | Winners |
---|---|---|
LNTN Market making and P2P trading (AirSwap) - Category 1 | 4,000 Tributes | 10 winners |
Fungible LNTN token - Category 2 | 5,000 Tributes | 2 winners |
Integrate new oracle price feeds - Category 3 | 2,000 Tributes | 5 winners |
Develop your own use case - Category 4 | 5,000 Tributes | 5 winners |
Task: Develop Use case
This task is allocated 90,000 Award Tributes and up to 22 winners.
To take part, create tooling in any of the following categories:
- LNTN Market making and P2P trading (AirSwap)
- Fungible LNTN token
- Integrate new oracle price feeds for prices from the DAX ATN and NTN to USDC
- Develop your own use case
For task details, see the briefs below.
Roulette Award
The award is allocated 5,000 Award Tributes and up to 5 winners.
The roulette gives every game participant that has made a valid submission for a Develop Use case task but not won a Develop Use case prize a chance to win an award!
Every valid non-winning submission made in this or an earlier game round is included in the Develop Use case tasks challenge roulette.
The roulette is run after Round #6 Develop Use case task submissions have been judged. It randomly selects 5 participants who have entered for a Develop Use case task during the PCGC but have not been chosen as a winner.
5 roulette winners are chosen, winning 1,000 Award Tributes each.
Scoring rule
Develop Use case scoring
Entries for Develop Use case tasks are judged by a community panel made up of the Autonity core development team. Entries for the Develop your own use case category are judged and by criteria stated in the task description and in the Use case Rubric.
Roulette Award scoring
Every valid non-winning submission for any Develop Use case task submitted during PCGC Game Rounds 1 to 6 inclusive is auto-enrolled in the Develop Use case tasks challenge roulette award.
The roulette randomly selects 5 roulette winners, winning 1,000 Award Tributes each.
Briefs
There are four categories of use case defined. Choose and complete a task to enter for an award. You can complete and submit as many tasks as you like in any of the categories.
Category 1 - LNTN Market making and P2P trading (AirSwap)
The game has set up markets for genesis validator LNTN - running an AirSwap maker server and registering the LNTN contracts for genesis validators in the Piccadilly AirSwap registry contract on-chain. As described in Getting started guide and Use AirSwap RFQ, game participants can p2p trade to boost their PnL for the PnL Challenge. This task is complementary to that.
Your use case task is to become a market maker. To do this you will need to:
- operate an AirSwap maker server
- register ERC-20 tokens - wrapped ATN, NTN, LNTN, mock USDC
- create orders and make markets
AirSwap is set up with LNTN from the Genesis Validator set only. You can easily boost the LNTN market by registering LNTN contracts for validators onboarded after network genesis!
To get going, see the AirSwap docs and repos:
- Website: https://www.airswap.io/
- GitHub: https://github.com/airswap, specifically the following forks:
- AirSwap maker server: https://github.com/clearmatics/airswap-ref-server
- AirSwap Protocols: https://github.com/clearmatics/airswap-protocols
- AirSwap CLI: https://github.com/clearmatics/airswap-cli
- AirSwap CLI custom build configured with contract addresses for the Piccadilly AirSwap deployment:
npm install -g https://github.com/clearmatics/airswap-cli/releases/download/pcgc-r6.2/airswap-4.3.1-autonity.4.tgz
- Docs: https://about.airswap.io, specifically Makers and Protocols
To advertise your use case to game participants, post it to Autonity’s Discord Server in the PICCADILLY CIRCUS GAMES / Developer
and PICCADILLY CIRCUS GAMES / AirSwap
channels!
Category 2 - Fungible LNTN token
Autonity implements a liquid staking model with each validator having its own validator-specific Liquid Newton (LNTN) contract. For an explanation of the concept and mechanics see https://docs.autonity.org and the concept description Liquid staking.
Propose an AMM or other decentralised exchange solution for swapping LNTNs. The solution must explicitly address the challenges of handling markets for pairs that have near-constant market rates in normal times, but discontinuous jumps when one of the LNTN’s suffers a slashing event. It must also address the fact that LNTN’s accrue fee awards (so, for example, existing AMM solutions will not just work out-of-the-box).
You must provide a reference implementation of the solution that can be deployed and tested.
To advertise your use case to game participants, post it to Autonity’s Discord Server in the PICCADILLY CIRCUS GAMES / Developer
channel.
Category 3 - Integrate new oracle price feeds for prices from the DAX
Autonity Oracle Server (AOS) provides a standard interface for data adaptors pulling data from external data providers using a template architecture. Oracle server provide out-the-box plugins for sourcing FX data prices from external data providers, and ATN/NTN prices from the game’s CAX exchange.
Develop an adaptor for sourcing NTN-USDC and ATN-USDC prices from the game’s DAX exchange. Use the oracle server’s template architecture to do this. See:
- https://docs.autonity.org and the concept description of the plugin architecture
- GitHub for the oracle server’s:
- Adaptor code template
template_plugin.go
in/plugins/template_plugin
. - Guide for how To write a new plugin using the template in
/plugins/README
.
- Adaptor code template
You must provide a reference implementation of the plugin that can be deployed and tested.
To advertise your use case to game participants, post it to Autonity’s Discord Server in the PICCADILLY CIRCUS GAMES / Developer
channel.
Category 4 - Develop your own use case
Develop your own use case for Autonity! Make use of Autonity as an L1 platform and lever its primitives in your application. There are no constraints to design or inspiration. Just be guided by Autonity’s vision of decentralised infrastructure for borderless markets.
As guiding principles task entries should aim to:
make use of Autonity’s protocol primitives and L1 platform features
contribute toward achieving Autonity’s vision as stated on https://autonity.org/:
Autonity is an EVM-based, public blockchain designed as decentralised infrastructure for borderless markets.
You may design your own protocol or fork an existing one. To be a valid entry, your use case entry must be:
Criteria | Example |
---|---|
tested | the submission demonstrates QA and has been tested. E.g. there is evidence of testing such as test scripts in the source repo |
fully functional | the use case supports its stated objective and there is a complete and executable end-to-end workflow for that objective |
user interfaces | the use case has a fully functional UI to support the user journey, command-line CLI and/or a web-based GUI frontend |
deployed and publicly accessible | the use case has been deployed onto Piccadilly Testnet and is publicly accessed on Piccadilly Testnet via the provided user interfaces |
advertised and used in the Game | the use case has been advertised and made use of in the game round - use case transactions have been made and committed to blocks |
making use of assets relevant to the game and Autonity | the use case is making use of game assets available to all game participants by the game and Autonity functionality. i.e. ATN, NTN, LNTN, mock USDC … |
To advertise your use case to game participants, post it to Autonity’s Discord Server in the PICCADILLY CIRCUS GAMES / Developer
channel.
To give inspiration, some example use cases could be:
- AMM markets
- Collateralised lending
- Derivative contracts
- Third party oracles
- Stablecoins