feat(explorer): phase 2 enhancements

backend/protocol_rpc/explorer/router.py

@@ -1,13 +1,10 @@
 """FastAPI router for the explorer API."""
 
-from typing import Annotated, Optional
+from typing import Annotated, Literal, Optional
 
 from fastapi import APIRouter, Depends, HTTPException, Query
-from pydantic import BaseModel
-from sqlalchemy import text
 from sqlalchemy.orm import Session
 
-from backend.database_handler.models import Transactions, TransactionStatus, Validators
 from backend.protocol_rpc.dependencies import get_db_session
 
 from . import queries
@@ -42,8 +39,12 @@ def get_transactions(
     limit: int = Query(20, ge=1, le=100),
     status: Optional[str] = None,
     search: Optional[str] = None,
+    from_date: Optional[str] = None,
+    to_date: Optional[str] = None,
 ):
-    return queries.get_all_transactions_paginated(session, page, limit, status, search)
+    return queries.get_all_transactions_paginated(
+        session, page, limit, status, search, from_date, to_date
+    )
 
 
 @explorer_router.get("/transactions/{tx_hash}")
@@ -57,96 +58,51 @@ def get_transaction(
     return result
 
 
-class _UpdateStatusBody(BaseModel):
-    status: str
+# ---------------------------------------------------------------------------
+# Validators
+# ---------------------------------------------------------------------------
 
 
-@explorer_router.patch("/transactions/{tx_hash}")
-def update_transaction(
-    tx_hash: str,
-    body: _UpdateStatusBody,
+@explorer_router.get("/validators")
+def get_validators(
     session: Annotated[Session, Depends(get_db_session)],
+    search: Optional[str] = None,
+    limit: Optional[int] = Query(None, ge=1, le=100),
 ):
-    # Validate status enum
-    try:
-        new_status = TransactionStatus(body.status)
-    except ValueError:
-        valid = [s.value for s in TransactionStatus]
-        raise HTTPException(
-            status_code=400,
-            detail=f"Invalid status. Must be one of: {', '.join(valid)}",
-        ) from None
-
-    # Simple status update (matches current explorer PATCH behaviour)
-    result = session.execute(
-        text(
-            "UPDATE transactions SET status = CAST(:new_status AS transaction_status) WHERE hash = :hash"
-        ),
-        {"hash": tx_hash, "new_status": new_status.value},
-    )
-
-    if result.rowcount == 0:
-        raise HTTPException(status_code=404, detail="Transaction not found")
+    return queries.get_all_validators(session, search=search, limit=limit)
 
-    session.flush()
 
-    # Return the updated transaction
-    tx = session.query(Transactions).filter(Transactions.hash == tx_hash).first()
-    return {
-        "success": True,
-        "message": "Transaction status updated successfully",
-        "transaction": queries._serialize_tx(tx),
-    }
+# ---------------------------------------------------------------------------
+# Address (unified lookup)
+# ---------------------------------------------------------------------------
 
 
-@explorer_router.delete("/transactions/{tx_hash}")
-def delete_transaction(
-    tx_hash: str,
+@explorer_router.get("/address/{address}")
+def get_address(
+    address: str,
     session: Annotated[Session, Depends(get_db_session)],
 ):
-    result = queries.delete_transaction(session, tx_hash)
+    result = queries.get_address_info(session, address)
     if result is None:
-        raise HTTPException(status_code=404, detail="Transaction not found")
+        raise HTTPException(status_code=404, detail="Address not found")
     return result
 
 
 # ---------------------------------------------------------------------------
-# Validators
-# ---------------------------------------------------------------------------
-
-
-@explorer_router.get("/validators")
-def get_validators(session: Annotated[Session, Depends(get_db_session)]):
-    validators = session.query(Validators).order_by(Validators.id).all()
-    return {
-        "validators": [queries._serialize_validator(v) for v in validators],
-    }
-
-
-# ---------------------------------------------------------------------------
-# State
+# Contracts
 # ---------------------------------------------------------------------------
 
 
-@explorer_router.get("/state")
-def get_states(
+@explorer_router.get("/contracts")
+def get_contracts(
     session: Annotated[Session, Depends(get_db_session)],
     search: Optional[str] = None,
     page: int = Query(1, ge=1),
     limit: int = Query(20, ge=1, le=100),
+    sort_by: Optional[Literal["tx_count", "created_at", "updated_at"]] = None,
+    sort_order: Literal["asc", "desc"] = "desc",
 ):
-    return queries.get_all_states(session, search, page, limit)
-
-
-@explorer_router.get("/state/{state_id}")
-def get_state(
-    state_id: str,
-    session: Annotated[Session, Depends(get_db_session)],
-):
-    result = queries.get_state_with_transactions(session, state_id)
-    if result is None:
-        raise HTTPException(status_code=404, detail="State not found")
-    return result
+    return queries.get_all_states(session, search, page, limit, sort_by, sort_order)
 
 
 # ---------------------------------------------------------------------------

explorer/package.json

@@ -12,6 +12,7 @@
     "@radix-ui/react-collapsible": "^1.1.12",
     "@radix-ui/react-dialog": "^1.1.15",
     "@radix-ui/react-dropdown-menu": "^2.1.16",
+    "@radix-ui/react-popover": "^1.1.15",
     "@radix-ui/react-select": "^2.2.6",
     "@radix-ui/react-separator": "^1.1.8",
     "@radix-ui/react-slot": "^1.2.4",
@@ -25,7 +26,9 @@
     "next": "16.1.6",
     "next-themes": "^0.4.6",
     "react": "19.2.4",
+    "react-day-picker": "^9.14.0",
     "react-dom": "19.2.4",
+    "shiki": "^4.0.2",
     "tailwind-merge": "^3.5.0"
   },
   "devDependencies": {