flwr-nightly 1.26.0.dev20260126__py3-none-any.whl → 1.26.0.dev20260128__py3-none-any.whl

flwr/cli/app.py

@@ -27,7 +27,6 @@ from .app_cmd import review as app_review
 from .build import build
 from .config import ls as config_list
 from .federation import ls as federation_list
-from .flower_config import init_flwr_config
 from .install import install
 from .log import log
 from .login import login
@@ -115,7 +114,6 @@ def main(
     ),
 ) -> None:
     """Flower CLI."""
-    init_flwr_config()
     if version:
         typer.secho(f"Flower version: {package_version}", fg="blue")
         raise typer.Exit()

flwr/cli/config/ls.py

@@ -40,7 +40,7 @@ def ls(
         ),
     ] = CliOutputFormat.DEFAULT,
 ) -> None:
-    """List all SuperLink connections."""
+    """List all SuperLink connections (alias: ls)."""
     suppress_output = output_format == CliOutputFormat.JSON
     captured_output = io.StringIO()
     config_path = None

flwr/cli/config_migration.py

@@ -31,7 +31,7 @@ from .flower_config import (
 )
 
 CONFIG_MIGRATION_NOTICE = """
-##################################################################
+#######################################################################
 # CONFIGURATION MIGRATION NOTICE:
 #
 # What was previously called "federation config" for SuperLink
@@ -43,8 +43,8 @@ CONFIG_MIGRATION_NOTICE = """
 # The entries below are commented out intentionally and are kept
 # only as a migration reference.
 #
-# Docs: <link to Flower config docs>
-##################################################################
+# Docs: https://flower.ai/docs/framework/ref-flower-configuration.html
+#######################################################################
 
 """
 
@@ -53,7 +53,7 @@ CLI_NOTICE = (
     + "We detected legacy usage of this command that relies on connection\n"
     + "settings from your pyproject.toml.\n\n"
     + "Flower will migrate any relevant settings to the new Flower config.\n\n"
-    + "Learn more: https://flower.ai/docs\n"
+    + "Learn more: https://flower.ai/docs/framework/ref-flower-configuration.html\n"
 )
 
 

flwr/cli/constant.py

@@ -57,7 +57,6 @@ class SuperLinkConnectionTomlKey:
     ADDRESS = "address"
     ROOT_CERTIFICATES = "root-certificates"
     INSECURE = "insecure"
-    ENABLE_ACCOUNT_AUTH = "enable-account-auth"
     FEDERATION = "federation"
     OPTIONS = "options"
 
@@ -102,8 +101,6 @@ default = "local"
 
 [superlink.supergrid]
 address = "{SUPERGRID_ADDRESS}"
-enable-account-auth = true
-federation = "YOUR-FEDERATION-HERE"
 
 [superlink.local]
 options.num-supernodes = 10

flwr/cli/federation/ls.py

@@ -68,7 +68,7 @@ def ls(  # pylint: disable=R0914, R0913, R0917, R0912
         ),
     ] = None,
 ) -> None:
-    """List available federations."""
+    """List available federations or details of a specific federation (alias: ls)."""
     suppress_output = output_format == CliOutputFormat.JSON
     captured_output = io.StringIO()
 

flwr/cli/flower_config.py

@@ -195,9 +195,6 @@ def parse_superlink_connection(
         address=conn_dict.get(SuperLinkConnectionTomlKey.ADDRESS),
         root_certificates=conn_dict.get(SuperLinkConnectionTomlKey.ROOT_CERTIFICATES),
         insecure=conn_dict.get(SuperLinkConnectionTomlKey.INSECURE),
-        enable_account_auth=conn_dict.get(
-            SuperLinkConnectionTomlKey.ENABLE_ACCOUNT_AUTH
-        ),
         federation=conn_dict.get(SuperLinkConnectionTomlKey.FEDERATION),
         options=simulation_options,
     )
@@ -221,7 +218,6 @@ def serialize_superlink_connection(connection: SuperLinkConnection) -> dict[str,
         SuperLinkConnectionTomlKey.ADDRESS: connection.address,
         SuperLinkConnectionTomlKey.ROOT_CERTIFICATES: connection.root_certificates,
         SuperLinkConnectionTomlKey.INSECURE: connection._insecure,
-        SuperLinkConnectionTomlKey.ENABLE_ACCOUNT_AUTH: connection._enable_account_auth,
         SuperLinkConnectionTomlKey.FEDERATION: connection.federation,
     }
     # Remove None values

flwr/cli/login/login.py

@@ -61,14 +61,6 @@ def login(
     superlink_connection = read_superlink_connection(superlink)
     superlink = superlink_connection.name
 
-    # Check if `enable-account-auth` is set to `true`
-    if not superlink_connection.enable_account_auth:
-        raise click.ClickException(
-            "Account authentication is not enabled for the SuperLink connection "
-            f"'{superlink}'. To enable it, set `enable-account-auth = true` "
-            "in the configuration."
-        )
-
     # Check if insecure flag is set to `True`
     if superlink_connection.insecure:
         raise click.ClickException(

flwr/cli/ls.py

@@ -79,7 +79,7 @@ def ls(  # pylint: disable=too-many-locals, too-many-branches, R0913, R0917
         ),
     ] = CliOutputFormat.DEFAULT,
 ) -> None:
-    """List the details of one provided run ID or all runs in a Flower federation.
+    """List the details of one provided run ID or all runs (alias: ls).
 
     The following details are displayed:
 

flwr/cli/supernode/ls.py

@@ -66,7 +66,7 @@ def ls(  # pylint: disable=R0914, R0913, R0917
         ),
     ] = False,
 ) -> None:
-    """List SuperNodes in the federation."""
+    """List SuperNodes in the federation (alias: ls)."""
     suppress_output = output_format == CliOutputFormat.JSON
     captured_output = io.StringIO()
 

flwr/cli/typing.py

@@ -22,6 +22,7 @@ from flwr.cli.constant import (
     DEFAULT_SIMULATION_BACKEND_NAME,
     SuperLinkConnectionTomlKey,
 )
+from flwr.supercore.utils import check_federation_format
 
 _ERROR_MSG_FMT = "SuperLinkConnection.%s is None"
 
@@ -106,8 +107,6 @@ class SuperLinkConnection:
     insecure : bool (default: False)
          Whether to use an insecure channel. If True, the
          connection will not use TLS encryption.
-    enable_account_auth : bool (default: False)
-         Whether to enable account authentication.
     federation : str
          The name of the federation to interface with.
     options : SuperLinkSimulationOptions
@@ -118,7 +117,6 @@ class SuperLinkConnection:
     address: str | None = None
     root_certificates: str | None = None
     _insecure: bool | None = None
-    _enable_account_auth: bool | None = None
     federation: str | None = None
     options: SuperLinkSimulationOptions | None = None
 
@@ -129,7 +127,6 @@ class SuperLinkConnection:
         address: str | None = None,
         root_certificates: str | None = None,
         insecure: bool | None = None,
-        enable_account_auth: bool | None = None,
         federation: str | None = None,
         options: SuperLinkSimulationOptions | None = None,
     ) -> None:
@@ -137,7 +134,6 @@ class SuperLinkConnection:
         self.address = address
         self.root_certificates = root_certificates
         self._insecure = insecure
-        self._enable_account_auth = enable_account_auth
         self.federation = federation
         self.options = options
 
@@ -150,13 +146,6 @@ class SuperLinkConnection:
             return False
         return self._insecure
 
-    @property
-    def enable_account_auth(self) -> bool:
-        """Return the enable_account_auth flag or its default (False) if unset."""
-        if self._enable_account_auth is None:
-            return False
-        return self._enable_account_auth
-
     def __post_init__(self) -> None:
         """Validate SuperLink connection configuration."""
         err_prefix = f"Invalid value for key '%s' in connection '{self.name}': "
@@ -187,19 +176,16 @@ class SuperLinkConnection:
                 err_prefix % SuperLinkConnectionTomlKey.INSECURE
                 + f"expected bool, but got {type(self._insecure).__name__}."
             )
-        if self._enable_account_auth is not None and not isinstance(
-            self._enable_account_auth, bool
-        ):
-            raise ValueError(
-                err_prefix % SuperLinkConnectionTomlKey.ENABLE_ACCOUNT_AUTH
-                + f"expected bool, but got {type(self._enable_account_auth).__name__}."
-            )
 
-        if self.federation is not None and not isinstance(self.federation, str):
-            raise ValueError(
-                err_prefix % SuperLinkConnectionTomlKey.FEDERATION
-                + f"expected str, but got {type(self.federation).__name__}."
-            )
+        if self.federation is not None:
+            if not isinstance(self.federation, str):
+                raise ValueError(
+                    err_prefix % SuperLinkConnectionTomlKey.FEDERATION
+                    + f"expected str, but got {type(self.federation).__name__}."
+                )
+
+            # Check if the federation string is valid
+            check_federation_format(self.federation)
 
         # The connection needs to have either an address or options (or both).
         if self.address is None and self.options is None:

flwr/cli/utils.py

@@ -241,7 +241,9 @@ def require_superlink_address(connection: SuperLinkConnection) -> str:
         cmd = click.get_current_context().command.name
         raise click.ClickException(
             f"`flwr {cmd}` currently works with a SuperLink. Ensure that the "
-            "correct SuperLink (Control API) address is provided in `pyproject.toml`."
+            "correct SuperLink (Control API) address is provided SuperLink connection "
+            "you are using. Check your Flower configuration file. You may use `flwr "
+            "config list` to see its location in the file system."
         )
     return connection.address
 
@@ -326,8 +328,10 @@ def flwr_cli_grpc_exc_handler() -> Iterator[None]:  # pylint: disable=too-many-b
             raise click.ClickException(
                 "The SuperLink cannot process this request. Please verify that "
                 "you set the address to its Control API endpoint correctly in your "
-                "`pyproject.toml`, and ensure that the Flower versions used by "
-                "the CLI and SuperLink are compatible."
+                "SuperLink connection in your Flower Configuration file. You may use "
+                "`flwr config list` to see its location in the file system. "
+                "Additonally, ensure that the Flower versions used by the CLI and "
+                "SuperLink are compatible."
             ) from None
         if e.code() == grpc.StatusCode.PERMISSION_DENIED:
             # pylint: disable-next=E1101

flwr/common/exit/exit_code.py

@@ -33,6 +33,7 @@ class ExitCode:
     SUPERLINK_LICENSE_MISSING = 102
     SUPERLINK_LICENSE_URL_INVALID = 103
     SUPERLINK_INVALID_ARGS = 104
+    SUPERLINK_DATABASE_SCHEMA_MISMATCH = 105
 
     # ServerApp-specific exit codes (200-299)
     SERVERAPP_STRATEGY_PRECONDITION_UNMET = 200
@@ -91,6 +92,11 @@ EXIT_CODE_HELP = {
         "Invalid arguments provided to SuperLink. Use `--help` check for the correct "
         "usage. Alternatively, check the documentation."
     ),
+    ExitCode.SUPERLINK_DATABASE_SCHEMA_MISMATCH: (
+        "The database schema does not match the expected schema for this version of "
+        "SuperLink. Please refer to the documentation for guidance on how to resolve "
+        "this issue."
+    ),
     # ServerApp-specific exit codes (200-299)
     ExitCode.SERVERAPP_STRATEGY_PRECONDITION_UNMET: (
         "The strategy received replies that cannot be aggregated. Please ensure all "

flwr/common/typing.py

@@ -24,6 +24,7 @@ import numpy as np
 import numpy.typing as npt
 
 from flwr.app.user_config import UserConfig
+from flwr.proto.federation_pb2 import Account  # pylint: disable=E0611
 from flwr.proto.node_pb2 import NodeInfo  # pylint: disable=E0611
 
 NDArray = npt.NDArray[Any]
@@ -343,5 +344,6 @@ class Federation:
 
     name: str
     member_aids: list[str]
+    accounts: list[Account]
     nodes: list[NodeInfo]
     runs: list[Run]

flwr/proto/federation_pb2.py

@@ -26,13 +26,15 @@ from flwr.proto import run_pb2 as flwr_dot_proto_dot_run__pb2
 from flwr.proto import node_pb2 as flwr_dot_proto_dot_node__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1b\x66lwr/proto/federation.proto\x12\nflwr.proto\x1a\x14\x66lwr/proto/run.proto\x1a\x15\x66lwr/proto/node.proto\"s\n\nFederation\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0bmember_aids\x18\x02 \x03(\t\x12#\n\x05nodes\x18\x03 \x03(\x0b\x32\x14.flwr.proto.NodeInfo\x12\x1d\n\x04runs\x18\x04 \x03(\x0b\x32\x0f.flwr.proto.Runb\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1b\x66lwr/proto/federation.proto\x12\nflwr.proto\x1a\x14\x66lwr/proto/run.proto\x1a\x15\x66lwr/proto/node.proto\"#\n\x07\x41\x63\x63ount\x12\n\n\x02id\x18\x01 \x01(\t\x12\x0c\n\x04name\x18\x02 \x01(\t\"\x9a\x01\n\nFederation\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0bmember_aids\x18\x02 \x03(\t\x12%\n\x08\x61\x63\x63ounts\x18\x03 \x03(\x0b\x32\x13.flwr.proto.Account\x12#\n\x05nodes\x18\x04 \x03(\x0b\x32\x14.flwr.proto.NodeInfo\x12\x1d\n\x04runs\x18\x05 \x03(\x0b\x32\x0f.flwr.proto.Runb\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
 _builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'flwr.proto.federation_pb2', _globals)
 if not _descriptor._USE_C_DESCRIPTORS:
   DESCRIPTOR._loaded_options = None
-  _globals['_FEDERATION']._serialized_start=88
-  _globals['_FEDERATION']._serialized_end=203
+  _globals['_ACCOUNT']._serialized_start=88
+  _globals['_ACCOUNT']._serialized_end=123
+  _globals['_FEDERATION']._serialized_start=126
+  _globals['_FEDERATION']._serialized_end=280
 # @@protoc_insertion_point(module_scope)

flwr/proto/federation_pb2.pyi

@@ -28,18 +28,39 @@ import typing
 
 DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
 
+@typing.final
+class Account(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    ID_FIELD_NUMBER: builtins.int
+    NAME_FIELD_NUMBER: builtins.int
+    id: builtins.str
+    name: builtins.str
+    def __init__(
+        self,
+        *,
+        id: builtins.str = ...,
+        name: builtins.str = ...,
+    ) -> None: ...
+    def ClearField(self, field_name: typing.Literal["id", b"id", "name", b"name"]) -> None: ...
+
+global___Account = Account
+
 @typing.final
 class Federation(google.protobuf.message.Message):
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     NAME_FIELD_NUMBER: builtins.int
     MEMBER_AIDS_FIELD_NUMBER: builtins.int
+    ACCOUNTS_FIELD_NUMBER: builtins.int
     NODES_FIELD_NUMBER: builtins.int
     RUNS_FIELD_NUMBER: builtins.int
     name: builtins.str
     @property
     def member_aids(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.str]: ...
     @property
+    def accounts(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[global___Account]: ...
+    @property
     def nodes(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[flwr.proto.node_pb2.NodeInfo]: ...
     @property
     def runs(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[flwr.proto.run_pb2.Run]: ...
@@ -48,9 +69,10 @@ class Federation(google.protobuf.message.Message):
         *,
         name: builtins.str = ...,
         member_aids: collections.abc.Iterable[builtins.str] | None = ...,
+        accounts: collections.abc.Iterable[global___Account] | None = ...,
         nodes: collections.abc.Iterable[flwr.proto.node_pb2.NodeInfo] | None = ...,
         runs: collections.abc.Iterable[flwr.proto.run_pb2.Run] | None = ...,
     ) -> None: ...
-    def ClearField(self, field_name: typing.Literal["member_aids", b"member_aids", "name", b"name", "nodes", b"nodes", "runs", b"runs"]) -> None: ...
+    def ClearField(self, field_name: typing.Literal["accounts", b"accounts", "member_aids", b"member_aids", "name", b"name", "nodes", b"nodes", "runs", b"runs"]) -> None: ...
 
 global___Federation = Federation

flwr/server/app.py

@@ -36,13 +36,11 @@ from flwr.common.config import get_flwr_dir
 from flwr.common.constant import (
     AUTHN_TYPE_YAML_KEY,
     AUTHZ_TYPE_YAML_KEY,
-    CLIENT_OCTET,
     CONTROL_API_DEFAULT_SERVER_ADDRESS,
     FLEET_API_GRPC_RERE_DEFAULT_ADDRESS,
     FLEET_API_REST_DEFAULT_ADDRESS,
     ISOLATION_MODE_PROCESS,
     ISOLATION_MODE_SUBPROCESS,
-    SERVER_OCTET,
     SERVERAPPIO_API_DEFAULT_SERVER_ADDRESS,
     SIMULATIONIO_API_DEFAULT_SERVER_ADDRESS,
     TRANSPORT_TYPE_GRPC_ADAPTER,
@@ -62,7 +60,7 @@ from flwr.proto.fleet_pb2_grpc import (  # pylint: disable=E0611
 )
 from flwr.proto.grpcadapter_pb2_grpc import add_GrpcAdapterServicer_to_server
 from flwr.server.fleet_event_log_interceptor import FleetEventLogInterceptor
-from flwr.supercore.address import parse_address
+from flwr.supercore.address import parse_address, resolve_bind_address
 from flwr.supercore.constant import FLWR_IN_MEMORY_DB_NAME
 from flwr.supercore.ffs import FfsFactory
 from flwr.supercore.grpc_health import add_args_health, run_health_server_grpc_no_tls
@@ -429,16 +427,11 @@ def run_superlink() -> None:
             raise ValueError(f"Unknown fleet_api_type: {args.fleet_api_type}")
 
     if args.isolation == ISOLATION_MODE_SUBPROCESS:
-
-        _octet, _colon, _port = serverappio_address.rpartition(":")
-        io_address = (
-            f"{CLIENT_OCTET}:{_port}" if _octet == SERVER_OCTET else serverappio_address
+        appio_address = resolve_bind_address(
+            simulationio_address if is_simulation else serverappio_address
         )
         command = ["flower-superexec", "--insecure"]
-        command += [
-            "--appio-api-address",
-            simulationio_address if is_simulation else io_address,
-        ]
+        command += ["--appio-api-address", appio_address]
         command += [
             "--plugin-type",
             ExecPluginType.SIMULATION if is_simulation else ExecPluginType.SERVER_APP,

flwr/server/superlink/fleet/message_handler/message_handler.py

@@ -321,7 +321,8 @@ def pull_object(
     if content is not None:
         object_available = content != b""
         # Record bytes traffic pulled by SuperNode
-        state.store_traffic(request.run_id, bytes_sent=len(content), bytes_recv=0)
+        if object_available:
+            state.store_traffic(request.run_id, bytes_sent=len(content), bytes_recv=0)
         return PullObjectResponse(
             object_found=True,
             object_available=object_available,

flwr/supercore/address.py

@@ -100,3 +100,12 @@ def is_port_in_use(address: str) -> bool:
             return True
 
         return False
+
+
+def resolve_bind_address(address: str) -> str:
+    """Replace bind-all addresses (0.0.0.0, ::) with localhost (127.0.0.1, ::1)."""
+    if address.startswith("[::]"):
+        return address.replace("[::]", "[::1]", 1)
+    if address.startswith("0.0.0.0"):
+        return address.replace("0.0.0.0", "127.0.0.1", 1)
+    return address

flwr/supercore/app_utils.py

@@ -53,6 +53,7 @@ def start_parent_process_monitor(
         while True:
             time.sleep(0.2)
             if not _pid_exists(parent_pid):
-                os.kill(os.getpid(), signal.SIGKILL)
+                signal.raise_signal(signal.SIGINT)
+                break
 
     threading.Thread(target=monitor, daemon=True).start()

flwr/supercore/constant.py

@@ -25,6 +25,9 @@ EXEC_PLUGIN_SECTION = "exec_plugin"
 # Flower in-memory Python-based database name
 FLWR_IN_MEMORY_DB_NAME = ":flwr-in-memory:"
 
+# Flower in-memory SQLite database URL
+FLWR_IN_MEMORY_SQLITE_DB_URL = "sqlite:///:memory:"
+
 # Constants for Hub
 APP_ID_PATTERN = r"^@[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$"
 APP_VERSION_PATTERN = r"^\d+\.\d+\.\d+$"

flwr/supercore/sql_mixin.py

@@ -29,7 +29,7 @@ from sqlalchemy.exc import SQLAlchemyError
 from sqlalchemy.orm import Session, sessionmaker
 
 from flwr.common.logger import log
-from flwr.supercore.constant import SQLITE_PRAGMAS
+from flwr.supercore.constant import FLWR_IN_MEMORY_SQLITE_DB_URL, SQLITE_PRAGMAS
 
 _current_session: ContextVar[Session | None] = ContextVar(
     "current_sqlalchemy_session",
@@ -95,7 +95,7 @@ class SqlMixin(ABC):
 
         # Auto-convert file path to SQLAlchemy SQLite URL if needed
         if database_path == ":memory:":
-            self.database_url = "sqlite:///:memory:"
+            self.database_url = FLWR_IN_MEMORY_SQLITE_DB_URL
         elif not database_path.startswith("sqlite://"):
             # Treat as file path, convert to absolute and create SQLite URL
             abs_path = Path(database_path).resolve()

flwr/supercore/state/alembic/__init__.py

@@ -0,0 +1,15 @@
+# Copyright 2026 Flower Labs GmbH. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+"""Alembic helpers and migration environment for SQL state."""

flwr/supercore/state/alembic/env.py

@@ -0,0 +1,81 @@
+# Copyright 2026 Flower Labs GmbH. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+"""Alembic environment configuration for State migrations."""
+
+
+from logging.config import fileConfig
+
+from alembic import context
+from sqlalchemy import engine_from_config, pool
+
+from flwr.supercore.state.alembic.utils import get_combined_metadata
+
+# Alembic Config object
+config = context.config  # pylint: disable=no-member
+
+# Interpret the config file for Python logging
+if config.config_file_name is not None:
+    fileConfig(config.config_file_name)
+
+
+# Target metadata for autogenerate
+target_metadata = get_combined_metadata()
+
+
+def run_migrations_offline() -> None:
+    """Run migrations in 'offline' mode.
+
+    This configures the context with just a URL and not an Engine, though an Engine is
+    acceptable here as well. By skipping the Engine creation we don't even need a DBAPI
+    to be available.
+
+    Calls to context.execute() here emit the given string to the script output.
+    """
+    url = config.get_main_option("sqlalchemy.url")
+    context.configure(  # pylint: disable=no-member
+        url=url,
+        target_metadata=target_metadata,
+        literal_binds=True,
+        dialect_opts={"paramstyle": "named"},
+    )
+
+    with context.begin_transaction():  # pylint: disable=no-member
+        context.run_migrations()  # pylint: disable=no-member
+
+
+def run_migrations_online() -> None:
+    """Run migrations in 'online' mode.
+
+    In this scenario we need to create an Engine and associate a connection with the
+    context.
+    """
+    connectable = engine_from_config(
+        config.get_section(config.config_ini_section, {}),
+        prefix="sqlalchemy.",
+        poolclass=pool.NullPool,
+    )
+
+    with connectable.connect() as connection:
+        # pylint: disable-next=no-member
+        context.configure(connection=connection, target_metadata=target_metadata)
+
+        with context.begin_transaction():  # pylint: disable=no-member
+            context.run_migrations()  # pylint: disable=no-member
+
+
+if context.is_offline_mode():  # pylint: disable=no-member
+    run_migrations_offline()
+else:
+    run_migrations_online()

flwr/supercore/state/alembic/script.py.mako

@@ -0,0 +1,43 @@
+# Copyright 2026 Flower Labs GmbH. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+"""${message}.
+
+Revision ID: ${up_revision}
+Revises: ${down_revision | comma,n}
+Create Date: ${create_date}
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+${imports if imports else ""}
+
+# pylint: disable=no-member
+
+# revision identifiers, used by Alembic.
+revision: str = ${repr(up_revision)}
+down_revision: Union[str, Sequence[str], None] = ${repr(down_revision)}
+branch_labels: Union[str, Sequence[str], None] = ${repr(branch_labels)}
+depends_on: Union[str, Sequence[str], None] = ${repr(depends_on)}
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    ${upgrades if upgrades else "pass"}
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    ${downgrades if downgrades else "pass"}

flwr/supercore/state/alembic/utils.py

@@ -0,0 +1,49 @@
+# Copyright 2026 Flower Labs GmbH. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+"""Helpers for running and validating Alembic migrations."""
+
+
+from sqlalchemy import MetaData
+
+from flwr.supercore.state.schema.corestate_tables import create_corestate_metadata
+from flwr.supercore.state.schema.linkstate_tables import create_linkstate_metadata
+from flwr.supercore.state.schema.objectstore_tables import create_objectstore_metadata
+
+
+def get_combined_metadata() -> MetaData:
+    """Combine all Flower state metadata objects into a single MetaData instance.
+
+    This ensures Alembic can track all tables across CoreState, LinkState, and
+    ObjectStore.
+
+    Returns
+    -------
+    MetaData
+        Combined SQLAlchemy MetaData with all Flower state tables.
+    """
+    # Start with linkstate tables
+    metadata = create_linkstate_metadata()
+
+    # Add corestate tables
+    corestate_metadata = create_corestate_metadata()
+    for table in corestate_metadata.tables.values():
+        table.to_metadata(metadata)
+
+    # Add objectstore tables
+    objectstore_metadata = create_objectstore_metadata()
+    for table in objectstore_metadata.tables.values():
+        table.to_metadata(metadata)
+
+    return metadata

flwr/supercore/state/alembic/versions/__init__.py

@@ -0,0 +1,15 @@
+# Copyright 2026 Flower Labs GmbH. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+"""Alembic migration versions."""

flwr/supercore/state/alembic/versions/rev_2026_01_28_initialize_migration_of_state_tables.py

@@ -0,0 +1,200 @@
+# Copyright 2026 Flower Labs GmbH. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+"""Initialize migration of state tables.
+
+Revision ID: 8e65d8ae60b0
+Revises:
+Create Date: 2026-01-28 11:03:18.038794
+"""
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+from alembic import op
+
+# pylint: disable=no-member
+
+# revision identifiers, used by Alembic.
+revision: str = "8e65d8ae60b0"
+down_revision: str | Sequence[str] | None = None
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    # LinkState tables
+    op.create_table(
+        "node",
+        sa.Column("node_id", sa.Integer(), nullable=True),
+        sa.Column("owner_aid", sa.String(), nullable=True),
+        sa.Column("owner_name", sa.String(), nullable=True),
+        sa.Column("status", sa.String(), nullable=True),
+        sa.Column("registered_at", sa.String(), nullable=True),
+        sa.Column("last_activated_at", sa.String(), nullable=True),
+        sa.Column("last_deactivated_at", sa.String(), nullable=True),
+        sa.Column("unregistered_at", sa.String(), nullable=True),
+        sa.Column("online_until", sa.TIMESTAMP(), nullable=True),
+        sa.Column("heartbeat_interval", sa.Float(), nullable=True),
+        sa.Column("public_key", sa.LargeBinary(), nullable=True),
+        sa.UniqueConstraint("node_id"),
+        sa.UniqueConstraint("public_key"),
+    )
+    op.create_index("idx_node_owner_aid", "node", ["owner_aid"], unique=False)
+    op.create_index("idx_node_status", "node", ["status"], unique=False)
+    op.create_index("idx_online_until", "node", ["online_until"], unique=False)
+    op.create_table(
+        "run",
+        sa.Column("run_id", sa.Integer(), nullable=True),
+        sa.Column("fab_id", sa.String(), nullable=True),
+        sa.Column("fab_version", sa.String(), nullable=True),
+        sa.Column("fab_hash", sa.String(), nullable=True),
+        sa.Column("override_config", sa.String(), nullable=True),
+        sa.Column("pending_at", sa.String(), nullable=True),
+        sa.Column("starting_at", sa.String(), nullable=True),
+        sa.Column("running_at", sa.String(), nullable=True),
+        sa.Column("finished_at", sa.String(), nullable=True),
+        sa.Column("sub_status", sa.String(), nullable=True),
+        sa.Column("details", sa.String(), nullable=True),
+        sa.Column("federation", sa.String(), nullable=True),
+        sa.Column("federation_options", sa.LargeBinary(), nullable=True),
+        sa.Column("flwr_aid", sa.String(), nullable=True),
+        sa.Column("bytes_sent", sa.Integer(), server_default="0", nullable=True),
+        sa.Column("bytes_recv", sa.Integer(), server_default="0", nullable=True),
+        sa.Column("clientapp_runtime", sa.Float(), server_default="0.0", nullable=True),
+        sa.UniqueConstraint("run_id"),
+    )
+    op.create_table(
+        "logs",
+        sa.Column("timestamp", sa.Float(), nullable=True),
+        sa.Column("run_id", sa.Integer(), nullable=True),
+        sa.Column("node_id", sa.Integer(), nullable=True),
+        sa.Column("log", sa.String(), nullable=True),
+        sa.ForeignKeyConstraint(
+            ["run_id"],
+            ["run.run_id"],
+        ),
+        sa.UniqueConstraint("timestamp", "run_id", "node_id"),
+    )
+    op.create_table(
+        "context",
+        sa.Column("run_id", sa.Integer(), nullable=True),
+        sa.Column("context", sa.LargeBinary(), nullable=True),
+        sa.ForeignKeyConstraint(
+            ["run_id"],
+            ["run.run_id"],
+        ),
+        sa.UniqueConstraint("run_id"),
+    )
+    op.create_table(
+        "message_ins",
+        sa.Column("message_id", sa.String(), nullable=True),
+        sa.Column("group_id", sa.String(), nullable=True),
+        sa.Column("run_id", sa.Integer(), nullable=True),
+        sa.Column("src_node_id", sa.Integer(), nullable=True),
+        sa.Column("dst_node_id", sa.Integer(), nullable=True),
+        sa.Column("reply_to_message_id", sa.String(), nullable=True),
+        sa.Column("created_at", sa.Float(), nullable=True),
+        sa.Column("delivered_at", sa.String(), nullable=True),
+        sa.Column("ttl", sa.Float(), nullable=True),
+        sa.Column("message_type", sa.String(), nullable=True),
+        sa.Column("content", sa.LargeBinary(), nullable=True),
+        sa.Column("error", sa.LargeBinary(), nullable=True),
+        sa.ForeignKeyConstraint(
+            ["run_id"],
+            ["run.run_id"],
+        ),
+        sa.UniqueConstraint("message_id"),
+    )
+    op.create_table(
+        "message_res",
+        sa.Column("message_id", sa.String(), nullable=True),
+        sa.Column("group_id", sa.String(), nullable=True),
+        sa.Column("run_id", sa.Integer(), nullable=True),
+        sa.Column("src_node_id", sa.Integer(), nullable=True),
+        sa.Column("dst_node_id", sa.Integer(), nullable=True),
+        sa.Column("reply_to_message_id", sa.String(), nullable=True),
+        sa.Column("created_at", sa.Float(), nullable=True),
+        sa.Column("delivered_at", sa.String(), nullable=True),
+        sa.Column("ttl", sa.Float(), nullable=True),
+        sa.Column("message_type", sa.String(), nullable=True),
+        sa.Column("content", sa.LargeBinary(), nullable=True),
+        sa.Column("error", sa.LargeBinary(), nullable=True),
+        sa.ForeignKeyConstraint(
+            ["run_id"],
+            ["run.run_id"],
+        ),
+        sa.UniqueConstraint("message_id"),
+    )
+    # CoreState tables
+    op.create_table(
+        "token_store",
+        sa.Column("run_id", sa.Integer(), nullable=True),
+        sa.Column("token", sa.String(), nullable=False),
+        sa.Column("active_until", sa.Float(), nullable=True),
+        sa.PrimaryKeyConstraint("run_id"),
+        sa.UniqueConstraint("token"),
+    )
+    # ObjectStore tables
+    op.create_table(
+        "objects",
+        sa.Column("object_id", sa.String(), nullable=True),
+        sa.Column("content", sa.LargeBinary(), nullable=True),
+        sa.Column("is_available", sa.Integer(), server_default="0", nullable=False),
+        sa.Column("ref_count", sa.Integer(), server_default="0", nullable=False),
+        sa.CheckConstraint("is_available IN (0, 1)", name="ck_objects_is_available"),
+        sa.PrimaryKeyConstraint("object_id"),
+    )
+    op.create_table(
+        "object_children",
+        sa.Column("parent_id", sa.String(), nullable=False),
+        sa.Column("child_id", sa.String(), nullable=False),
+        sa.ForeignKeyConstraint(
+            ["child_id"], ["objects.object_id"], ondelete="CASCADE"
+        ),
+        sa.ForeignKeyConstraint(
+            ["parent_id"], ["objects.object_id"], ondelete="CASCADE"
+        ),
+        sa.PrimaryKeyConstraint("parent_id", "child_id"),
+    )
+    op.create_table(
+        "run_objects",
+        sa.Column("run_id", sa.Integer(), nullable=False),
+        sa.Column("object_id", sa.String(), nullable=False),
+        sa.ForeignKeyConstraint(
+            ["object_id"], ["objects.object_id"], ondelete="CASCADE"
+        ),
+        sa.PrimaryKeyConstraint("run_id", "object_id"),
+    )
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.drop_table("run_objects")
+    op.drop_table("object_children")
+    op.drop_table("objects")
+    op.drop_table("token_store")
+    op.drop_table("message_res")
+    op.drop_table("message_ins")
+    op.drop_table("context")
+    op.drop_table("logs")
+    op.drop_table("run")
+    op.drop_index("idx_online_until", table_name="node")
+    op.drop_index("idx_node_status", table_name="node")
+    op.drop_index("idx_node_owner_aid", table_name="node")
+    op.drop_table("node")
+    # ### end Alembic commands ###

flwr/supercore/state/schema/README.md

@@ -2,6 +2,7 @@
 
 ## Schema
 
+<!-- BEGIN_SQLALCHEMY_DOCS -->
 ```mermaid
 
 ---
@@ -77,7 +78,6 @@ erDiagram
     INTEGER ref_count
   }
 
-<<<<<<< HEAD
   run {
     INTEGER bytes_recv "nullable"
     INTEGER bytes_sent "nullable"
@@ -98,8 +98,6 @@ erDiagram
     VARCHAR sub_status "nullable"
   }
 
-=======
->>>>>>> main
   run_objects {
     VARCHAR object_id PK,FK
     INTEGER run_id PK
@@ -111,15 +109,13 @@ erDiagram
     VARCHAR token UK
   }
 
-<<<<<<< HEAD
   run ||--o| context : run_id
   run ||--o{ logs : run_id
   run ||--o{ message_ins : run_id
   run ||--o{ message_res : run_id
-=======
->>>>>>> main
   objects ||--o| object_children : parent_id
   objects ||--o| object_children : child_id
   objects ||--o| run_objects : object_id
 
 ```
+<!-- END_SQLALCHEMY_DOCS -->

flwr/supercore/utils.py

@@ -254,3 +254,24 @@ def humanize_bytes(num_bytes: int) -> str:
         value /= 1024
 
     raise RuntimeError("Unreachable code")  # Make mypy happy
+
+
+def check_federation_format(federation: str) -> None:
+    """Check if the federation string is valid.
+
+    Parameters
+    ----------
+    federation : str
+        The federation string to check.
+
+    Raises
+    ------
+    ValueError
+        If the federation string is not valid. The expected
+        format is '@<account-name>/<federation-name>'.
+    """
+    if not re.match(r"^@[a-zA-Z0-9\-_]+/[a-zA-Z0-9\-_]+$", federation):
+        raise ValueError(
+            f"Invalid federation format: {federation}. "
+            f"Expected format: '@<account-name>/<federation-name>'."
+        )

flwr/superlink/federation/noop_federation_manager.py

@@ -15,8 +15,9 @@
 """NoOp implementation of FederationManager."""
 
 
-from flwr.common.constant import NOOP_FLWR_AID
+from flwr.common.constant import NOOP_ACCOUNT_NAME, NOOP_FLWR_AID
 from flwr.common.typing import Federation
+from flwr.proto.federation_pb2 import Account  # pylint: disable=E0611
 from flwr.supercore.constant import NOOP_FEDERATION
 
 from .federation_manager import FederationManager
@@ -66,6 +67,7 @@ class NoOpFederationManager(FederationManager):
         return Federation(
             name=NOOP_FEDERATION,
             member_aids=[NOOP_FLWR_AID],
+            accounts=[Account(id=NOOP_FLWR_AID, name=NOOP_ACCOUNT_NAME)],
             nodes=nodes,
             runs=runs,
         )

flwr/supernode/start_client_internal.py

@@ -65,7 +65,7 @@ from flwr.common.telemetry import EventType
 from flwr.common.typing import Fab, Run, RunNotRunningException
 from flwr.proto.clientappio_pb2_grpc import add_ClientAppIoServicer_to_server
 from flwr.proto.message_pb2 import ObjectTree  # pylint: disable=E0611
-from flwr.supercore.address import parse_address
+from flwr.supercore.address import parse_address, resolve_bind_address
 from flwr.supercore.ffs import Ffs, FfsFactory
 from flwr.supercore.grpc_health import run_health_server_grpc_no_tls
 from flwr.supercore.object_store import ObjectStore, ObjectStoreFactory
@@ -213,7 +213,10 @@ def start_client_internal(
     # Launch the SuperExec if the isolation mode is `subprocess`
     if isolation == ISOLATION_MODE_SUBPROCESS:
         command = ["flower-superexec", "--insecure"]
-        command += ["--appio-api-address", clientappio_api_address]
+        command += [
+            "--appio-api-address",
+            resolve_bind_address(clientappio_api_address),
+        ]
         command += ["--plugin-type", ExecPluginType.CLIENT_APP]
         command += ["--parent-pid", str(os.getpid())]
         # pylint: disable-next=consider-using-with

{flwr_nightly-1.26.0.dev20260126.dist-info → flwr_nightly-1.26.0.dev20260128.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: flwr-nightly
-Version: 1.26.0.dev20260126
+Version: 1.26.0.dev20260128
 Summary: Flower: A Friendly Federated AI Framework
 License: Apache-2.0
 Keywords: Artificial Intelligence,Federated AI,Federated Analytics,Federated Evaluation,Federated Learning,Flower,Machine Learning
@@ -31,6 +31,7 @@ Classifier: Typing :: Typed
 Provides-Extra: rest
 Provides-Extra: simulation
 Requires-Dist: SQLAlchemy (>=2.0.45,<3.0.0)
+Requires-Dist: alembic (>=1.18.1,<2.0.0)
 Requires-Dist: click (<8.2.0)
 Requires-Dist: cryptography (>=44.0.1,<45.0.0)
 Requires-Dist: grpcio (>=1.70.0,<2.0.0)

{flwr_nightly-1.26.0.dev20260126.dist-info → flwr_nightly-1.26.0.dev20260128.dist-info}/RECORD

@@ -6,7 +6,7 @@ flwr/app/message_type.py,sha256=WABg74wnkIdrmjD_AhlA7tYOqwni5n5Isagc8O9IdOc,1002
 flwr/app/metadata.py,sha256=rnfEHbw-IL1anLHwploK1YQQqKFHQmoF_M6rcSpRNCc,7422
 flwr/app/user_config.py,sha256=7xsOVs-NYIvE710iE1qRFqxlA3LQNnmcoVXqcg_Ez2g,802
 flwr/cli/__init__.py,sha256=EfMGmHoobET6P2blBt_eOByXL8299MgFfB7XNdaPQ6I,720
-flwr/cli/app.py,sha256=62ELnHyEbgTp2GDzgsuk-mJ09_Gs8WHysbRceOnH-x8,3851
+flwr/cli/app.py,sha256=AEm7JewC_0FT2esOqNcB9Xkot7s7sGBf6yitzp8z6E4,3784
 flwr/cli/app_cmd/__init__.py,sha256=O_vTzS2u-n27fBYnDbjTMMKQQ2Bz80Y4JqGBHSAnK40,856
 flwr/cli/app_cmd/publish.py,sha256=DAFRu12EAO1NtzrGN9uYN_hW20gQZ2vCyf0HggzqaZ0,8006
 flwr/cli/app_cmd/review.py,sha256=FPusshF36519z_KN36mU2fcvRtb5DCh0esinsts8WEs,7200
@@ -17,19 +17,19 @@ flwr/cli/auth_plugin/oidc_cli_plugin.py,sha256=1gN00FifSrhUA5s5uaE_GpQ3N7U8fQec4
 flwr/cli/build.py,sha256=wjLrxWHGnwRFp7WxZFgm8J0cwcdQY9-QHxjFnEa2dII,10097
 flwr/cli/cli_account_auth_interceptor.py,sha256=mXgxThpZjU_2Xlae9xT8ewOw60GeE64comDd57asLIY,3680
 flwr/cli/config/__init__.py,sha256=46z6whA3hvKkl9APRs-UG7Ym3K9VOqKx_pYcgelRjtE,788
-flwr/cli/config/ls.py,sha256=llQiXC0kK7shT96Y3GD2uvVP3MjWWLpYTeExUH1rALo,3537
-flwr/cli/config_migration.py,sha256=UM3lZU34TOhGXkjBBChyGaE6r7uaVV2NpyP4TZhFPyY,10848
+flwr/cli/config/ls.py,sha256=i976g1rzpSLEagyjEFdxxYAM-FqaP0Unqlk2EiKj4B4,3549
+flwr/cli/config_migration.py,sha256=KJIVqpVbEfhY53taELFZuVGY0-sTPGiPOI6_FwEjfDI,10932
 flwr/cli/config_utils.py,sha256=t9GNUPnUH1nUNZQ3oGjx6Jd5VSO9SlnQXjz3-yro7Rs,7683
-flwr/cli/constant.py,sha256=Ihww6e-6V_Ocv7pRnIQeezdy72_RBL9dPYv87Yf4ppI,3612
+flwr/cli/constant.py,sha256=N50fATyqwwFuy8Ty7nl4zvKOQtmdSjfoJH4bHggb6BU,3501
 flwr/cli/example.py,sha256=SNTorkKPrx1rOryGREUyZu8TcOc1-vFv1zEddaysdY0,2216
 flwr/cli/federation/__init__.py,sha256=okxswL4fAjApI9gV_alU1lRkTUcQRbwlzvtUTLz61fE,793
-flwr/cli/federation/ls.py,sha256=xjS3HHNwOXXsaNN-xrdWvClmV29R6yT8R2AA0SVzJas,10689
-flwr/cli/flower_config.py,sha256=8XGB9-XjJrpR2xYOcFWjmvmqGZRS5_M-rPhuZQQASSs,15267
+flwr/cli/federation/ls.py,sha256=SZrQb_uUBrK2v4nAo3GETxyVBoNpBUJLjQuE_maX8_E,10737
+flwr/cli/flower_config.py,sha256=EFsSJByBD-SmIReoBaSzuEriLz4716qh7LMU2_yfGzc,15065
 flwr/cli/install.py,sha256=gBYg1SczpvBh8MMrXJxi0q4DUdzXCdvapK3jC3CBlPk,9114
 flwr/cli/log.py,sha256=BPA0dvGlXx5PrtURPua5fJyF7iVrb28K4fEY2Uth0EE,7317
 flwr/cli/login/__init__.py,sha256=B1SXKU3HCQhWfFDMJhlC7FOl8UsvH4mxysxeBnrfyUE,800
-flwr/cli/login/login.py,sha256=uUUrt6TNJjV_udwS3qJ5TXcRqqtI9nBySdXzwXItoVc,3999
-flwr/cli/ls.py,sha256=ROSDyaQw5y9BjcBUtj57Vc3HgHTW_JbYX5NDIl-Yfhg,12793
+flwr/cli/login/login.py,sha256=o-jm5QRMIpivE8kpY7cPTGbr7nQhsyFYaftMtBaaT0s,3649
+flwr/cli/ls.py,sha256=7CUtSdqnEuAkAgN-7u9c8TBOoM-IYms0nh0h1SkLz7I,12782
 flwr/cli/new/__init__.py,sha256=QA1E2QtzPvFCjLTUHnFnJbufuFiGyT_0Y53Wpbvg1F0,790
 flwr/cli/new/new.py,sha256=15phs5dhEpo7ORs7uulGzHWtW9W5ZGn0EKFE_T5WXb8,7829
 flwr/cli/pull.py,sha256=XzBvLrdYGrSCuky5OoCEU4V9UR9QlyZMT7Tj-W6wSw0,2946
@@ -38,11 +38,11 @@ flwr/cli/run/run.py,sha256=6yrVljd1CqqALq-wqiv0TnZlveiN5ymiUI5iTjuvUJM,8954
 flwr/cli/run_utils.py,sha256=ZnlBOqFfRxVEPZKR_9zYrynNcohiCFY8QN6OFyOCrQs,5082
 flwr/cli/stop.py,sha256=w3frNt3TD5AukGmlGq4CbWo-3PC3B-YSLO6PjJeHjH4,4692
 flwr/cli/supernode/__init__.py,sha256=DBkjoPo2hS2Y-ghJxwLbrAbCQFBgD82_Itl2_892UBo,917
-flwr/cli/supernode/ls.py,sha256=x4ghJHpqcpDGuZx91ZehzSdmrUJ8ZuZvpY_UybnP63U,8224
+flwr/cli/supernode/ls.py,sha256=o3YENA1e-W4oJjq2rHwwzZthllpLzEhSY--9-m_c6Qc,8236
 flwr/cli/supernode/register.py,sha256=YPf28ZDvqPAQAt6c6OG73AJa9zZPONKgpxhnnb3NWQk,5498
 flwr/cli/supernode/unregister.py,sha256=qWGg8G_KqF300ze4D1dYaSIRJZkl9zwM2ul8VLYjJMY,3719
-flwr/cli/typing.py,sha256=MaY3NAca2PgmNByogksDKSCoRQLQpXTgO8NO9nLP0yA,8008
-flwr/cli/utils.py,sha256=jLhe-Voj0v8cK16MwRXW7qf34lEffOauRIukDyYX2II,15258
+flwr/cli/typing.py,sha256=COLEK_zVQuGGm4t_nYAW0_8EWu09zFiAv-tEZNg95_s,7367
+flwr/cli/utils.py,sha256=HCQYvqAjO74awSWQ9dV_OfCZ9QSkMIoKQ5b0Y4EOeoo,15568
 flwr/client/__init__.py,sha256=xwkPJfdeWxIIfmiPE5vnmnY_JbTlErP0Qs9eBP6qRFg,1252
 flwr/client/client.py,sha256=3HAchxvknKG9jYbB7swNyDj-e5vUWDuMKoLvbT7jCVM,7895
 flwr/client/dpfedavg_numpy_client.py,sha256=ELDHyEJcTB-FlLhHC-JXy8HuB3ZFHfT0HL3g1VSWY5w,7451
@@ -86,7 +86,7 @@ flwr/common/event_log_plugin/__init__.py,sha256=ts3VAL3Fk6Grp1EK_1Qg_V-BfOof9F86
 flwr/common/event_log_plugin/event_log_plugin.py,sha256=uJYR363nVzjfJePay3UHwaifwgBx2rAbKHHAuQC10VU,2014
 flwr/common/exit/__init__.py,sha256=8W7xaO1iw0vacgmQW7FTFbSh7csNv6XfsgIlnIbNF6U,978
 flwr/common/exit/exit.py,sha256=EBHZos4EhZLxW1lmZXDVlFUOf0_eTQ1FxzQiZ466hZ0,4018
-flwr/common/exit/exit_code.py,sha256=1S_LJNdo2lai3tjAYgZgNjN5jcIyU60Y1a-IDfUZVAM,6702
+flwr/common/exit/exit_code.py,sha256=xpvi_3UOhf6AT8pR0ZGXyBxWfnuFFE50O1cKqOGVxxE,7000
 flwr/common/exit/exit_handler.py,sha256=zUAXHtp4rYK_sbkgsqS5zrVAzJUiSBrB-a4Ay3vSPE8,2302
 flwr/common/exit/signal_handler.py,sha256=o_e33v9kP0jz13q-8BZDrKF7vNCzOApvDPZ3-nTXfIc,3697
 flwr/common/grpc.py,sha256=8XoMTA5rJMze8fG6vOs1g4_rkxMhfpvMEYJPnqYPi2g,9799
@@ -119,7 +119,7 @@ flwr/common/secure_aggregation/secaggplus_utils.py,sha256=E_xU-Zd45daO1em7M6C2wO
 flwr/common/serde.py,sha256=FqqJqNqCk-DryCOgTGkabENvFeU2Q0LieLe0bt3qBbU,22342
 flwr/common/serde_utils.py,sha256=Vk49PnZWRgo0NrvBhFqH-Li7sMFVVgyrs3Ck7kHB-ZE,5820
 flwr/common/telemetry.py,sha256=7HNy5ytioJ3SbFtaKNucwYYC-IXEOXphitZbdHmSlfk,8924
-flwr/common/typing.py,sha256=pUhyfCA6vbApelxxDnUti5Yj_oBZv1xuuzyU8vhwqaw,7295
+flwr/common/typing.py,sha256=LLL-4wB8LaijpiVCIJQBv-PI8SXM4RNjbClu3BHWQh0,7394
 flwr/compat/__init__.py,sha256=gbfDQKKKMZzi3GswyVRgyLdDlHiWj3wU6dg7y6m5O_s,752
 flwr/compat/client/__init__.py,sha256=qpbo0lcxdNL4qy5KHqiGm8OLxSxkYgI_-dLh5rwhtcI,746
 flwr/compat/client/app.py,sha256=oBOB-gYm0oqxtfAp58QZtv3dyUsPxjFm__f1_teenHU,27178
@@ -151,8 +151,8 @@ flwr/proto/fab_pb2.py,sha256=QDkVHGRGmugjQQUiN8A_okppZ5e2pJi5KipjnWmF6e4,2320
 flwr/proto/fab_pb2.pyi,sha256=PUUZ1FHeTwXxjVmTX14Vx5gmgRSFvoW_e5v_Z5qkT54,3948
 flwr/proto/fab_pb2_grpc.py,sha256=jmhCnnwSqBpZ0329XGUGARbcz5sHrr0WrXwccqzc3Vs,895
 flwr/proto/fab_pb2_grpc.pyi,sha256=fMwjLr-QCljWBa8uk0fvMCytnrF1-IzFLCbezqEmvdU,1071
-flwr/proto/federation_pb2.py,sha256=x8hwIFsw87e7STmvq5qL90RmcImCGw5oOqbke7xaykA,1670
-flwr/proto/federation_pb2.pyi,sha256=_At18SzwJjlf3k3FXjVi3Op59rs2i5XcIeBSPlvfXr0,2215
+flwr/proto/federation_pb2.py,sha256=1IAerSPg5O3DDx1Nixc9PL-0ELK4C_yjeCa3IpHLCjE,1927
+flwr/proto/federation_pb2.pyi,sha256=EMPXcT0b6a6rs8oB-rHp-5dIQ_83aBDd7fTmamVzy60,2970
 flwr/proto/federation_pb2_grpc.py,sha256=HPErt9uXJPbY8jLtTNFr941z82uMm7cOx10hTHgcwZM,902
 flwr/proto/federation_pb2_grpc.pyi,sha256=fMwjLr-QCljWBa8uk0fvMCytnrF1-IzFLCbezqEmvdU,1071
 flwr/proto/fleet_pb2.py,sha256=HnxtM2pqVdn2xhl3e1NlLazpSMaGoUUEG9Nd17egxqU,6543
@@ -201,7 +201,7 @@ flwr/proto/transport_pb2_grpc.py,sha256=jYsbV3KYdp4TaNfWxv3ljFEvB-Yjsa8MIPtTH-vV
 flwr/proto/transport_pb2_grpc.pyi,sha256=qd2cOXq6HBZtwRfPpKuni27NGMJCAxyP5R95Vk8WWDU,2073
 flwr/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 flwr/server/__init__.py,sha256=LQQHiuL2jy7TpNaKastRdGsexlxSt5ZWAQNVqitDnrY,1598
-flwr/server/app.py,sha256=Z9JRCp8S4YIGr79r1LM2wXsuoNoxt4K7dKnletzxJU0,31827
+flwr/server/app.py,sha256=90rGFbhQw0vDrVDamqBVIm0RtUDfUUdUcXc9WpU7BKI,31678
 flwr/server/client_manager.py,sha256=3WOqNWh5dlqPRG-DMGwXiyvGNEYS_jKqXKkFIkMqWLQ,6187
 flwr/server/client_proxy.py,sha256=QS_RGgjSZ8V4StAHH8zc7W9_os2FyO4wNqkbylQMBTY,2341
 flwr/server/compat/__init__.py,sha256=0IsttWvY15qO98_1GyzVC-vR1e_ZPXOdu2qUlOkYMPE,886
@@ -260,7 +260,7 @@ flwr/server/superlink/fleet/grpc_rere/__init__.py,sha256=ahDJJ1e-lDxBpeBMgPk7YZt
 flwr/server/superlink/fleet/grpc_rere/fleet_servicer.py,sha256=DtHuDP7fvgO-iamI48ACr0TQcD20eBYwMicHKIjhmXQ,12583
 flwr/server/superlink/fleet/grpc_rere/node_auth_server_interceptor.py,sha256=88e9yEapAbk8fOoqG4f4-jvXMLuJAZYQF9j6whczegc,5811
 flwr/server/superlink/fleet/message_handler/__init__.py,sha256=fHsRV0KvJ8HtgSA4_YBsEzuhJLjO8p6xx4aCY2oE1p4,731
-flwr/server/superlink/fleet/message_handler/message_handler.py,sha256=FO-CuOKfOwomjefmZsn_NGUM4m0ptPGwMOtfQTYfro0,12109
+flwr/server/superlink/fleet/message_handler/message_handler.py,sha256=WrJkw8SX_0XMnZ8velhjjFHUIQ8SuGMpojkWkyhqB_E,12142
 flwr/server/superlink/fleet/rest_rere/__init__.py,sha256=Lzc93nA7tDqoy-zRUaPG316oqFiZX1HUCL5ELaXY_xw,735
 flwr/server/superlink/fleet/rest_rere/rest_api.py,sha256=cDWDQBf79F9tZ1mXOErc-nsnY4zFP9Tcv7Fs-bQIdiU,9616
 flwr/server/superlink/fleet/vce/__init__.py,sha256=XOKbAWOzlCqEOQ3M2cBYkH7HKA7PxlbCJMunt-ty-DY,784
@@ -324,11 +324,11 @@ flwr/simulation/ray_transport/utils.py,sha256=KrexpWYCF-dAF3UHc9yDbPQWO-ahMT-BbD
 flwr/simulation/run_simulation.py,sha256=hSJAqOfMd8I30Pq9x2TXYXDCXAeUtWqwBncX6JGEMOQ,20798
 flwr/simulation/simulationio_connection.py,sha256=cS7yTOa5yeK-bQ2YjS9eJCXL8SOItEkiJD5sN5mBb_Y,3475
 flwr/supercore/__init__.py,sha256=pqkFoow_E6UhbBlhmoD1gmTH-33yJRhBsIZqxRPFZ7U,755
-flwr/supercore/address.py,sha256=vVE5y-t77YL16lMDVTeK3g75N8IKbQ72sVcRI-RPPWs,2984
-flwr/supercore/app_utils.py,sha256=K76Zt6R670b1hUmxOsNc1WUCVYvF7lejXPcCO9K0Q0g,1753
+flwr/supercore/address.py,sha256=SgM_pazKsw1Avo5nms0WWgIZFUGS349O0gOP7N3bFW4,3318
+flwr/supercore/app_utils.py,sha256=P558DOr5a4UPyOdRCxbDQueQF-L-kSc6qzouPPuqj0U,1773
 flwr/supercore/cli/__init__.py,sha256=EDl2aO-fuQfxSbL-T1W9RAfA2N0hpWHmqX_GSwblJbQ,845
 flwr/supercore/cli/flower_superexec.py,sha256=IQIGzxgaeLNMNzGXGemfYK3lp8God5bTkXpVkbeP_ig,6109
-flwr/supercore/constant.py,sha256=qMeN0YGu_aZ95XKlLc7n4WBl_AVjA9vv_1666gGhCq8,2792
+flwr/supercore/constant.py,sha256=ZtS-CpGSyth9iKjavNOLE7T-8xmCaEVoXi4ZarYry5s,2884
 flwr/supercore/corestate/__init__.py,sha256=Vau6-L_JG5QzNqtCTa9xCKGGljc09wY8avZmIjSJemg,774
 flwr/supercore/corestate/corestate.py,sha256=EZg4gPXqVOXwS7t0tlPfedajoWj5T80oeDBNxpV2y2I,2874
 flwr/supercore/corestate/in_memory_corestate.py,sha256=9qa6RuRZfCp6vs-ARYdiZjCL31VOAAxw0a_VkBXR5zY,5116
@@ -355,9 +355,15 @@ flwr/supercore/object_store/sql_object_store.py,sha256=ZBmyc3a_GXZFNaefDCxhrri-_
 flwr/supercore/primitives/__init__.py,sha256=Tx8GOjnmMo8Y74RsDGrMpfr-E0Nl8dcUDF784_ge6F8,745
 flwr/supercore/primitives/asymmetric.py,sha256=1643niHYj3uEbfPd06VuMHwN3tKVwg0uVyR3RhTdWIU,3778
 flwr/supercore/primitives/asymmetric_ed25519.py,sha256=eIhOTMibQW0FJX4MXdplHdL3HcfCiKuFu2mQ8GQTUz8,5025
-flwr/supercore/sql_mixin.py,sha256=eT4JHaLG4gShZrC10pkUVIGcTvZszlJI1ARhOJEA_WY,11727
+flwr/supercore/sql_mixin.py,sha256=dAK_NCnXa0Ili0N5vYgQ9dlVOE-KeiQCRc2Z0RcS0sU,11765
 flwr/supercore/state/__init__.py,sha256=FkKhsNVM4LjlRlOgXTz6twINmw5ohIUKS_OER0BNo_w,724
-flwr/supercore/state/schema/README.md,sha256=-0QrXDhnv30gEYoIUJo7aLUolY0r_t_nC24yk7B2agM,2892
+flwr/supercore/state/alembic/__init__.py,sha256=pC-y-xsfgi9YwCrqnt814yOJ9ytlDRUFGqOY6Qzt-_U,746
+flwr/supercore/state/alembic/env.py,sha256=fmRDLxsmJ77pC4LLDlpx3iBeBZXN2DFZ7LKhNTmGTIg,2739
+flwr/supercore/state/alembic/script.py.mako,sha256=oNrcIBPuSq0jfg3ycPAg3vo18QhA-_OaGMTkKCix74I,1416
+flwr/supercore/state/alembic/utils.py,sha256=6KpFEgR4_oNjq8KmNXuq-3ilOfNbzqlCw80NbBgjn9I,1813
+flwr/supercore/state/alembic/versions/__init__.py,sha256=ri3OIpl8xD_Csv25uAAT7l-MtHhixqmAGt9Aa1OpM1s,717
+flwr/supercore/state/alembic/versions/rev_2026_01_28_initialize_migration_of_state_tables.py,sha256=U4j4PdRUtIAZuWUGuLO7N8W_5Ixit1rfEqfcIp2SAmE,8407
+flwr/supercore/state/schema/README.md,sha256=qVCGuyU-gObFrL5MRvH9LraNi0Z_LbXzolXykbOrY9w,2884
 flwr/supercore/state/schema/__init__.py,sha256=Egnde6OY01wrpT4PuhL4NGn_NY4jdAH7kf7ktagN4Ws,724
 flwr/supercore/state/schema/corestate_tables.py,sha256=TwonogWgEUtKeE-LY59wousWzhF0w3wMKAotRqvRxao,1392
 flwr/supercore/state/schema/linkstate_tables.py,sha256=aKh9zR6cF4ecOJHS8SzniLXkcNGd4OG4xnZvwC_qers,5583
@@ -370,7 +376,7 @@ flwr/supercore/superexec/plugin/exec_plugin.py,sha256=iRRZcnTcM3wMwkkUElmfFka31a
 flwr/supercore/superexec/plugin/serverapp_exec_plugin.py,sha256=IwRzdPV-cSKwrP2krGh0De4IkAuxsmgK0WU6J-2GXqM,1035
 flwr/supercore/superexec/plugin/simulation_exec_plugin.py,sha256=upn5zE-YKkl_jTw8RzmeyQ58PU_UAlQ7CqnBXXdng8I,1060
 flwr/supercore/superexec/run_superexec.py,sha256=yeV6_eI0XFfPyNwnlgqchR9jI80FzSI80oyekrIlO2M,7144
-flwr/supercore/utils.py,sha256=WGHnvyZ9sC5fvFDR8rXnGyz3CQ1O-qSBMT0Alh1a090,7819
+flwr/supercore/utils.py,sha256=2ywouz7y4M4NSdvZ_DMPYZX5xCpt5zIR5z5rEgl7znI,8410
 flwr/supercore/version.py,sha256=7GAGzPn73Mkh09qhrjbmjZQtcqVhBuzhFBaK4Mk4VRk,1325
 flwr/superlink/__init__.py,sha256=GNSuJ4-N6Z8wun2iZNlXqENt5beUyzC0Gi_tN396bbM,707
 flwr/superlink/artifact_provider/__init__.py,sha256=pgZEcVPKRE874LSu3cgy0HbwSJBIpVy_HxQOmne4PAs,810
@@ -380,7 +386,7 @@ flwr/superlink/auth_plugin/auth_plugin.py,sha256=xLqAYFG7sjAhYgyeTvvEY6fSMjPRq0o
 flwr/superlink/auth_plugin/noop_auth_plugin.py,sha256=0MWjNXZdz6zGRfitlnZfVKu4sKVn0HhJvnp09c3xVUA,2962
 flwr/superlink/federation/__init__.py,sha256=A1pFFvkEQrHzvRAOstr2o7nphx3JbuJgkNRFKJ9qD3M,890
 flwr/superlink/federation/federation_manager.py,sha256=-Vu1v_WWhWK7wgKEQua24lw9a6iPxG89VI-jqLO5E4g,2322
-flwr/superlink/federation/noop_federation_manager.py,sha256=Hc6_YVlMZZkdElS8bawi85eCTHOzVPUZVe9Dmrl2DW8,2881
+flwr/superlink/federation/noop_federation_manager.py,sha256=YqAfmbxUPzFrivZNAheJtDEpUjTLaxPi-k7tuZTAvoU,3045
 flwr/superlink/servicer/__init__.py,sha256=ZC-kILcUGeh6IxJsfu24cTzUqIGXmQfEKsGfhsnhBpM,717
 flwr/superlink/servicer/control/__init__.py,sha256=qhUTMt_Mg4lxslCJYn5hDSrA-lXf5ya3617BT8kR-2Y,803
 flwr/superlink/servicer/control/control_account_auth_interceptor.py,sha256=AJs7GE-fyUBLcUEUzB058TpFzC7gyDOL17THvYkJTn8,6529
@@ -401,8 +407,8 @@ flwr/supernode/runtime/run_clientapp.py,sha256=-JsN3h7jQC12vzDBmImzYmyccI3LveIu-
 flwr/supernode/servicer/__init__.py,sha256=lucTzre5WPK7G1YLCfaqg3rbFWdNSb7ZTt-ca8gxdEo,717
 flwr/supernode/servicer/clientappio/__init__.py,sha256=7Oy62Y_oijqF7Dxi6tpcUQyOpLc_QpIRZ83NvwmB0Yg,813
 flwr/supernode/servicer/clientappio/clientappio_servicer.py,sha256=rRL4CQ0L78jF_p0ct4-JMGREt6wWRy__wy4czF4f54Y,11639
-flwr/supernode/start_client_internal.py,sha256=BYk69UBQ2gQJaDQxXhccUgfOWrb7ShAstrbcMOCZIIs,26173
-flwr_nightly-1.26.0.dev20260126.dist-info/METADATA,sha256=tcxTPuQjyJ_6Uyt2AjjiDY18bTLl4a5awalqhBFiJkM,14398
-flwr_nightly-1.26.0.dev20260126.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-flwr_nightly-1.26.0.dev20260126.dist-info/entry_points.txt,sha256=hxHD2ixb_vJFDOlZV-zB4Ao32_BQlL34ftsDh1GXv14,420
-flwr_nightly-1.26.0.dev20260126.dist-info/RECORD,,
+flwr/supernode/start_client_internal.py,sha256=AUzEUFJbKRvyJbOjE6b6kShJrd4aJkqqOZgCokY67_A,26252
+flwr_nightly-1.26.0.dev20260128.dist-info/METADATA,sha256=vwyjsIU9OBUX7zRbFGbUOqciYyerGlRDba7iSXcEfOM,14439
+flwr_nightly-1.26.0.dev20260128.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+flwr_nightly-1.26.0.dev20260128.dist-info/entry_points.txt,sha256=hxHD2ixb_vJFDOlZV-zB4Ao32_BQlL34ftsDh1GXv14,420
+flwr_nightly-1.26.0.dev20260128.dist-info/RECORD,,