dev-launchers / devbots__backend Goto Github PK

Implement a Score Database for Weekly/Monthly/All-Time Leaderboards

Direct API Documentation can be found here.
Main Wiki Entry is here

Goals:

• Create 3 new Database Tables
• Implement the 3 API Endpoints
• Reset Weekly/Monthly Leaderboards on Schedule

A new API Endpoint Group /relay that accepts MetaTransactions for DevBots which are signed using EIP-712, and sends them to the Blockchain on the users behalf.

POST /relay/transaction
Accepts TransactionRelayRequest Object:
- Address signer
- Address contract
- BigInteger chainID
- BigInteger nonce
- bytes data
- bytes innerMessageHash (usually "0x" == empty)
- bytes signature
Conditions:

• contract address must be the Adress of one of DevBots smart contracts (specified in config)
• chainId needs to equal the chainId of the current connected chain (web3j)
• nonce needs to be validated against the relayer smart contract (must equal getNonce(signer, lower128bits of nonce)
• signature needs to be validated (EIP-712 structure needs to be rebuilt)
  Returns:
  onFailure:
  • errorCode + errorText
    onSuccess:
  • transactionHash

GET /relay/transaction?reference=[transactionHash]
Fetches status of a transaction
Returns wether the transaction has already been mined and similar relevant information. (block number etc.)

More Endpoints are gonna be needed here in the future for e.g. queueing or cancelling queued transactions etc. but that is currently out of scope.

A API Endpoint Group /battle needs to be created to allow for Bot Battles to be queued, simulated and published to the Blockchain.
The Initial Implementation will only cover using a mocked "simulation" and publishing to the Blockchain, everything else is out of scope for now.

Specific API Definition can be found here: https://studio-ws.apicur.io/sharing/55d30746-025f-4fd8-9b13-eebc86543001