[FIL-227] Automatic allocator

[Filip-L]

[FIL-227] Automatic allocator

Two new endpoints have been added to handle the DataCap faucet.

Endpoint: [POST] autoallocator/trigger_autoallocation

Description:
This endpoint enables the automated allocation of DataCap to users at specified intervals.

The autoallocator/trigger_autoallocation endpoint evaluates the following conditions, based on the received data (TriggerAutoallocationInfo):

• The message dates must be valid (the message has not expired and is not from the future).
• The client's score must be greater than 30.
• The client has not received DataCap from any allocator, or no application exists for this client.
• The last allocation occurred at least 14 days ago.

If these conditions are met, the equivalent of 64GiB in DataCap will be allocated to the client.

Example TriggerAutoallocationInfo:

{
  "message": 
    "KycAutoallocationApproval": {
      "message": "message",
      "client_fil_address": "client_fil_address",
      "issued_at": "issued_date",
      "expires_at": "expiry_date",
    },
  "signature": "client_signature",
}

Endpoint: [GET]autoallocator/last_client_allocation

Description:
The autoallocator/last_client_allocation endpoint returns the timestamp of the last client autoallocation, based on the query params(LastAutoallocationQueryParams)

Example LastAutoallocationQueryParams:

{
  "evm_wallet_address": "evm_wallet_address"
}

Deployment Considerations:

• New environment variables:

  • AUTOALLOCATOR_PRIVATE_KEY - The private key of the autoallocator wallet.

  • ALLOCATOR_CONTRACT_ADDRESS - The address of the Allocator contract.

  • DAYS_TO_NEXT_AUTOALLOCATION - The time in days to allow allocations (set to 14).

  • AUTOALLOCATION_AMOUNT - The autoallocation amount in bytes (64 GiB = 68719476736 bytes).