Cover Router

Computes the optimal capacity allocation in order to get the best price on cover purchases.

Table of Contents

• Cover Router
  • Table of Contents
  • Setup
  • Usage
  • Quote Route
  • Capacity Route
  • Capacity Route for a specific product

Setup

1. git clone git@github.com:NexusMutual/cover-router.git
2. cd cover-router && npm ci
3. cp .env.sample .env
   1. Set environment variables in .env:
   2. CONCURRENCY_NUMBER= number of concurrent products to process for faster startup
   3. PROVIDER_URL - use either Infura or Alchemy
   4. PORT= port number for the server
4. To run the server npm run start

Note: if running the server in nodemon(dev), change the destination of persisted data so the server wouldn't restart constantly

Usage

Quote Route

• URL: /v2/quote
• Method: GET
• OpenAPI: v2/api/docs/#/Quote/get_v2_quote
• Description: The quote route uses a product id, a period and the cover amount for a given cover asset to return premium and the best available combination of pools for the premium.
• Quote Engine: Calculation is based on batching the current capacities and mapping them with the price per pool, then the cheapest capacity is selected, and remapped if the whole cover amount is not covered by the cheapest capacity.

Capacity Route

• URL: /v2/capacity
• Method: GET
• OpenAPI: v2/api/docs/#/Capacity/get_v2capacity
• Description: Returns the current capacity for all products for a period of 30 days if no period query param is specified.

Capacity Route for a specific product

• URL: /v2/capacity/{productId}
• Method: GET
• OpenAPI: v2/api/docs/#/Capacity/get_v2_capacity_productId
• Description: Returns the current capacity for a specific product for a period of 30 days if no period query param is specified.