Updating interfaces

Author: valzargaming

README.md

@@ -4,14 +4,15 @@ Reference: https://www.rfc-editor.org/rfc/rfc9420.html
 
 Status
 
-- Interfaces only — no concrete implementations yet.
+- Interface-first: comprehensive RFC-shaped interfaces and registry enums implemented; no concrete cryptographic primitives included.
 - Goal: provide a complete set of PHP interfaces that mirror RFC 9420 concepts for downstream implementations and tests.
 Current status
 
 - Interfaces: comprehensive interface-only definitions for the major RFC 9420 concepts (groups, ratchet tree, messages, proposals, commits, credentials, crypto abstractions).
 - Registry enums: added enum-style classes mirroring RFC tables and registries (Tables 4–7 and related): `CipherSuite`, `KEM`, `KDF`, `AEAD`, `HashAlgorithm`, `SignatureScheme`, `ExtensionType`, `ProposalType`, `CredentialType`, `EpochSecrets`, `SignatureLabels`, `PublicKeyEncryptionLabels`, `MessageWireFormat`, and `ContentType`.
 - Tests: a basic PHPUnit test (`tests/MLSInterfacesTest.php`) asserts presence of interfaces and method signatures; run locally with `./vendor/bin/phpunit`.
 - Implementations: no concrete cryptographic implementations included — those remain out of scope.
+ - Recent API changes: `MLSPlaintextInterface::getSender()` and `FramedContentInterface::getSender()` return a `SenderInterface` (typed sender union). `KeyScheduleInterface::init()` now accepts an ordered array of PSKs (`array $psks`) to reflect RFC PSK chaining semantics. `CommitInterface::getSender()` and `ProposalInterface::getSender()` now also return `SenderInterface`.
 
 Implemented (interface files) — ordered by RFC section
 
@@ -127,6 +128,8 @@ Roadmap
 3. Add minimal reference implementations or adapters for HPKE/signature primitives.
 4. Implement end-to-end examples that exercise the KeySchedule, Commit, and Welcome flows.
 
+If you'd like, I can add a short example showing how to construct a `SenderInterface` instance value (as a simple DTO) for use with these interfaces — or scaffold minimal reference implementations for `KeySchedule` and `HPKE` to exercise PSK chaining and welcome creation.
+
 Contributing
 
 - Add concrete implementations under `src/MLS/` and tests under `tests/`.

src/MLS/Commit/CommitCreatorInterface.php

@@ -2,6 +2,15 @@
 
 declare(strict_types=1);
 
+/*
+ * This file is a part of the DiscordPHP-RFC9420 project.
+ *
+ * Copyright (c) 2026-present Valithor Obsidion <valithor@discordphp.org>
+ *
+ * This file is subject to the MIT license that is bundled
+ * with this source code in the LICENSE.md file.
+ */
+
 namespace MLS\Commit;
 
 use MLS\Proposal\ProposalListInterface;
@@ -12,7 +21,7 @@ interface CommitCreatorInterface
      * Create a Commit from a (validated) proposal list.
      *
      * @param ProposalListInterface $proposals
-     * @param array|null $path optional path information
+     * @param array|null            $path      optional path information
      */
     public function createCommit(ProposalListInterface $proposals, ?array $path = null): CommitInterface;
 }

src/MLS/Commit/CommitInterface.php

@@ -13,9 +13,11 @@
 
 namespace MLS\Commit;
 
+use MLS\Message\SenderInterface;
+
 interface CommitInterface
 {
-    public function getSender(): string;
+    public function getSender(): SenderInterface;
 
     public function getProposals(): array;
 

src/MLS/Commit/CommitProcessorInterface.php

@@ -2,14 +2,23 @@
 
 declare(strict_types=1);
 
+/*
+ * This file is a part of the DiscordPHP-RFC9420 project.
+ *
+ * Copyright (c) 2026-present Valithor Obsidion <valithor@discordphp.org>
+ *
+ * This file is subject to the MIT license that is bundled
+ * with this source code in the LICENSE.md file.
+ */
+
 namespace MLS\Commit;
 
 interface CommitProcessorInterface
 {
     /**
      * Process an incoming Commit and apply changes to group state.
      *
-     * @param CommitInterface $commit
+     * @param  CommitInterface  $commit
      * @return array<int,mixed> results or updated state details
      */
     public function processCommit(CommitInterface $commit): array;

src/MLS/Commit/UpdatePathInterface.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is a part of the DiscordPHP-RFC9420 project.
+ *
+ * Copyright (c) 2026-present Valithor Obsidion <valithor@discordphp.org>
+ *
+ * This file is subject to the MIT license that is bundled
+ * with this source code in the LICENSE.md file.
+ */
+
+namespace MLS\Commit;
+
+interface UpdatePathInterface
+{
+    /**
+     * The leaf node presented in the path (serialized).
+     */
+    public function getLeafNode(): string;
+
+    /**
+     * Array of UpdatePathNodeInterface.
+     * @return UpdatePathNodeInterface[]
+     */
+    public function getNodes(): array;
+}

src/MLS/Commit/UpdatePathNodeInterface.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is a part of the DiscordPHP-RFC9420 project.
+ *
+ * Copyright (c) 2026-present Valithor Obsidion <valithor@discordphp.org>
+ *
+ * This file is subject to the MIT license that is bundled
+ * with this source code in the LICENSE.md file.
+ */
+
+namespace MLS\Commit;
+
+interface UpdatePathInterface
+{
+    /**
+     * The leaf node presented in the path (serialized).
+     */
+    public function getLeafNode(): string;
+
+    /**
+     * Array of UpdatePathNodeInterface.
+     * @return UpdatePathNodeInterface[]
+     */
+    public function getNodes(): array;
+}

src/MLS/Crypto/KeyScheduleInterface.php

@@ -15,7 +15,12 @@
 
 interface KeyScheduleInterface
 {
-    public function init(string $psk, CipherSuiteInterface $suite): void;
+    /**
+     * Initialize the key schedule.
+     *
+     * @param string[] $psks Ordered list of PSKs (may be empty)
+     */
+    public function init(array $psks, CipherSuiteInterface $suite): void;
 
     public function deriveWelcomeSecret(string $epochSecret): string;
 

src/MLS/Enums/AEAD.php

@@ -2,10 +2,19 @@
 
 declare(strict_types=1);
 
+/*
+ * This file is a part of the DiscordPHP-RFC9420 project.
+ *
+ * Copyright (c) 2026-present Valithor Obsidion <valithor@discordphp.org>
+ *
+ * This file is subject to the MIT license that is bundled
+ * with this source code in the LICENSE.md file.
+ */
+
 namespace MLS\Enums;
 
 /**
- * AEAD identifiers referenced by MLS cipher suites (RFC 9420 Table 7)
+ * AEAD identifiers referenced by MLS cipher suites (RFC 9420 Table 7).
  */
 final class AEAD
 {

src/MLS/Enums/CipherSuite.php

@@ -2,10 +2,19 @@
 
 declare(strict_types=1);
 
+/*
+ * This file is a part of the DiscordPHP-RFC9420 project.
+ *
+ * Copyright (c) 2026-present Valithor Obsidion <valithor@discordphp.org>
+ *
+ * This file is subject to the MIT license that is bundled
+ * with this source code in the LICENSE.md file.
+ */
+
 namespace MLS\Enums;
 
 /**
- * MLS Cipher Suites (RFC 9420 - Section 17.1, Tables 6 & 7)
+ * MLS Cipher Suites (RFC 9420 - Section 17.1, Tables 6 & 7).
  */
 final class CipherSuite
 {

src/MLS/Enums/CredentialType.php

@@ -2,6 +2,15 @@
 
 declare(strict_types=1);
 
+/*
+ * This file is a part of the DiscordPHP-RFC9420 project.
+ *
+ * Copyright (c) 2026-present Valithor Obsidion <valithor@discordphp.org>
+ *
+ * This file is subject to the MIT license that is bundled
+ * with this source code in the LICENSE.md file.
+ */
+
 namespace MLS\Enums;
 
 /**