feat: add V-PROGRAM to address stats sort keys and counts

src/aleph/sdk/query/filters.py

@@ -30,6 +30,7 @@ class SortByMessageType(str, Enum):
     POST = "post"
     PROGRAM = "program"
     STORE = "store"
+    V_PROGRAM = "v_program"
     TOTAL = "total"
 
 
@@ -252,7 +253,7 @@ class AddressesFilter:
     A collection of query parameters for address stats queries.
 
     :param address_contains: Case-insensitive substring to filter addresses
-    :param sort_by: Message type to sort by (aggregate, forget, instance, post, program, store, total)
+    :param sort_by: Message type to sort by (aggregate, forget, instance, post, program, store, v_program, total)
     :param sort_order: Sort order (ascending or descending)
     """
 

src/aleph/sdk/query/responses.py

@@ -160,6 +160,7 @@ class AddressStats(BaseModel):
     forget: int = Field(description="Number of FORGET messages")
     program: int = Field(description="Number of PROGRAM messages")
     instance: int = Field(description="Number of INSTANCE messages")
+    v_program: int = Field(default=0, description="Number of V-PROGRAM messages")
 
     model_config = ConfigDict(extra="forbid")
 

tests/unit/test_asynchronous_get.py

@@ -16,6 +16,7 @@
 )
 from aleph.sdk.query.responses import (
     AccountFilesResponse,
+    AddressStats,
     AddressStatsResponse,
     ChainBalancesResponse,
     PostsResponse,
@@ -393,3 +394,16 @@ async def test_get_account_files_rejects_empty_address():
 
 if __name__ == "__main __":
     unittest.main()
+
+
+def test_addresses_filter_sort_by_v_program():
+    f = AddressesFilter(sort_by=SortByMessageType.V_PROGRAM)
+    assert f.as_http_params() == {"sortBy": "v_program"}
+
+
+def test_address_stats_v_program_defaults_to_zero():
+    stats = AddressStats(
+        messages=1, post=1, aggregate=0, store=0, forget=0, program=0, instance=0
+    )
+    assert stats.v_program == 0
+    assert AddressStats(**{**stats.model_dump(), "v_program": 3}).v_program == 3