OCT-2179: Script to calculate raffle weights (#541)

## Description
Calculates the raffle weights for given addresses using total
allocations in epoch

## Definition of Done

1. [ ] If required, the desciption of your change is added to the [QA
changelog](https://www.notion.so/octantapp/Changelog-for-the-QA-d96fa3b411cf488bb1d8d9a598d88281)
2. [ ] Acceptance criteria are met.
3. [ ] PR is manually tested before the merge by developer(s).
    - [ ] Happy path is manually checked.
4. [ ] PR is manually tested by QA when their assistance is required
(1).
- [ ] Octant Areas & Test Cases are checked for impact and updated if
required (2).
5. [ ] Unit tests are added unless there is a reason to omit them.
6. [ ] Automated tests are added when required.
7. [ ] The code is merged.
8. [ ] Tech documentation is added / updated, reviewed and approved
(including mandatory approval by a code owner, should such exist for
changed files).
    - [ ] BE: Swagger documentation is updated.
9. [ ] When required by QA:
    - [ ] Deployed to the relevant environment.
    - [ ] Passed system tests.

---

(1) Developer(s) in coordination with QA decide whether it's required.
For small tickets introducing small changes QA assistance is most
probably not required.

(2) [Octant Areas & Test
Cases](https://docs.google.com/spreadsheets/d/1cRe6dxuKJV3a4ZskAwWEPvrFkQm6rEfyUCYwLTYw_Cc).

raffle-weights/calc_weights.py

@@ -0,0 +1,96 @@
+import csv
+import requests
+from eth_utils import to_checksum_address
+
+# Dictionary to store address -> totalPoints mapping
+address_points = {}
+# Dictionary to store address -> total allocation amount (in WEI)
+address_allocations = {}
+# Dictionary to store address -> total allocation amount (in ETH)
+address_allocations_eth = {}
+# Dictionary to store final total points
+final_points = {}
+
+WEI_TO_ETH = 1_000_000_000_000_000_000  # 1 ETH = 1,000,000,000,000,000,000 WEI
+MAX_ETH = 0.1  # Maximum ETH cap
+
+# Get list of donors for epoch 5
+donors_response = requests.get('https://backend.mainnet.octant.app/flask/user/patrons/5')
+donors = []
+if donors_response.status_code == 200:
+    donors = [to_checksum_address(addr) for addr in donors_response.json().get('patrons', [])]
+
+# Read the CSV file and convert addresses to checksum format
+with open('raffle-weights/leaderboard-62254-33064.csv', mode='r') as csvfile:
+    reader = csv.DictReader(csvfile)
+    for row in list(reader):
+        original_address = row['address']
+        checksum_address = to_checksum_address(original_address)
+        total_points = int(row['totalPoints'])  # Convert points to integer
+
+        # Print if totalPoints is 0
+        if total_points == 0:
+            print(f"Warning: Address {checksum_address} has 0 total points")
+
+        # Store in dictionary
+        address_points[checksum_address] = total_points
+
+        # Fetch allocations for the 5th epoch
+        epoch_num = 5
+        url = f"https://backend.mainnet.octant.app/flask/allocations/user/{checksum_address}/epoch/{epoch_num}"
+        response = requests.get(url)
+
+        # Initialize total allocation amount for this address
+        total_allocation = 0
+
+        if response.status_code == 200:
+            allocations = response.json().get('allocations', [])
+            if not allocations and checksum_address in donors:
+                # This is a donor with no allocations, get their budget
+                budget_url = f"https://backend.mainnet.octant.app/flask/rewards/budget/{checksum_address}/epoch/{epoch_num}"
+                budget_response = requests.get(budget_url)
+                if budget_response.status_code == 200:
+                    total_allocation = int(budget_response.json().get('budget', 0))
+                    # print(f"Donor found: {checksum_address} with budget: {total_allocation / WEI_TO_ETH:.4f} ETH")
+            else:
+                # Sum up all allocation amounts for this address
+                for allocation in allocations:
+                    amount = int(allocation.get('amount', 0))  # amount in WEI
+                    total_allocation += amount
+
+        # Store total allocation for this address (in WEI)
+        address_allocations[checksum_address] = total_allocation
+        # Store total allocation in ETH (capped at 0.1 ETH)
+        eth_amount = total_allocation / WEI_TO_ETH
+        capped_eth_amount = min(eth_amount, MAX_ETH)
+
+        # Print if amount was capped
+        if eth_amount > MAX_ETH:
+            print(f"Notice: Address {checksum_address} allocation capped from {eth_amount:.4f} ETH to {MAX_ETH} ETH")
+
+        address_allocations_eth[checksum_address] = capped_eth_amount
+
+        # Calculate final points
+        # total = total_points + (eth_value * 2000) if total_points > 0 and eth_value > 0
+        # total = 0 otherwise
+        if total_points > 0 and capped_eth_amount > 0:
+            final_total = total_points + (capped_eth_amount * 2000)
+        else:
+            final_total = 0
+
+        final_points[checksum_address] = final_total
+
+        print(f"Address: {checksum_address}, Weight: {final_total:.4f}, Points: {total_points}, Eth: {eth_amount:.4f}, Donor: {checksum_address in donors}")
+
+# Write results to new CSV file (only non-zero weights)
+output_file = 'raffle-weights/raffle_weights_output.csv'
+with open(output_file, 'w', newline='') as csvfile:
+    writer = csv.writer(csvfile)
+    # Write header
+    writer.writerow(['wallet address', 'weight'])
+    # Write data (only non-zero weights)
+    for address, weight in final_points.items():
+        if weight > 0:  # Only write if weight is non-zero
+            writer.writerow([address, weight])
+
+print(f"\nResults have been written to {output_file}")