diff --git a/ledger/participant-state/src/main/scala/com/daml/ledger/participant/state/v2/WritePackagesService.scala b/ledger/participant-state/src/main/scala/com/daml/ledger/participant/state/v2/WritePackagesService.scala
index 785791d36394..e9191c1c948e 100644
--- a/ledger/participant-state/src/main/scala/com/daml/ledger/participant/state/v2/WritePackagesService.scala
+++ b/ledger/participant-state/src/main/scala/com/daml/ledger/participant/state/v2/WritePackagesService.scala
@@ -35,6 +35,8 @@ trait WritePackagesService {
     *   describing where it got the package from, e.g., when, where, or by whom
     *   the packages were uploaded.
     * @param archives           Daml-LF archives to be uploaded to the ledger.
+    *    All archives must be valid, i.e., they must successfully decode and pass
+    *    Daml engine validation.
     * @param telemetryContext   An implicit context for tracing.
     *
     * @return an async result of a [[SubmissionResult]]