docs: document optional license_token and JWKS on validate_license

Author: VoxHash

licensechain/client.py

@@ -443,15 +443,17 @@ async def validate_license(
         self, license_key: str, app_id: Optional[str] = None, hwuid: Optional[str] = None
     ) -> Dict[str, Any]:
         """
-        Validate a license key.
+        Validate a license key (POST /v1/licenses/verify).
         
         Args:
             license_key: License key to validate
             app_id: Application ID for validation (optional)
             hwuid: Optional hardware/device ID for ecosystem HMAC/HWUID contract
             
         Returns:
-            License validation result
+            Full API JSON. When the API has license JWT signing configured, the payload may
+            include ``license_token`` (RS256 JWT), ``license_token_expires_at``, and
+            ``license_jwks_uri`` for offline verification with the JWKS at GET /v1/licenses/jwks.
         """
         payload: Dict[str, Any] = {"key": license_key}
         if app_id: