fixup! identity service refactoring

Signed-off-by: Angelo De Caro <[email protected]>

Author: adecaro

docs/services/identity.md

@@ -41,4 +41,38 @@ This registry relies on the token driver to implement the specific wallet functi
 
 In essence, the Token-SDK identity service provides a secure and flexible framework for managing access control within your system.
 
-The identity service is locate under [`token/services/identity`](./../../token/services/identity).
+The identity service is locate under [`token/services/identity`](./../../token/services/identity).
+
+## Understanding Roles in More Detail
+
+Building on the concept of long-term identities, we'll now explore how they are grouped into roles within the identity service.
+
+Each role acts as a container for long-term identities, which are then used to create wallets. Here's the interface that defines a role:
+
+```go
+// Role is a container of long-term identities.
+// A long-term identity is then used to construct a wallet.
+type Role interface {
+   // MapToID returns the long-term identity and its identifier for the given index.
+   // The index can be an identity or a label (string).
+   MapToID(v interface{}) (view.Identity, string, error)
+   // GetIdentityInfo returns the long-term identity info associated to the passed id
+   GetIdentityInfo(id string) driver.IdentityInfo
+   // RegisterIdentity registers the given identity
+   RegisterIdentity(id string, path string) error
+   // IDs returns the identifiers contained in this role
+   IDs() ([]string, error)
+   // Reload the roles with the respect to the passed public parameters
+   Reload(pp driver.PublicParameters) error
+}
+```
+
+This interface offers functions for managing identities within the role. 
+You, as the developer, have the flexibility to implement a role using any identity representation that best fits your application's needs. 
+For example, a role could even encompass identities based on various cryptographic schemes.
+
+The identity service conveniently provides two built-in implementations of the Role interface. 
+Both implementations leverage the concept of Hyperledger Fabric MSP ([https://hyperledger-fabric.readthedocs.io/en/latest/msp.html](https://hyperledger-fabric.readthedocs.io/en/latest/msp.html)):
+
+* **MSP X.509:** This implementation retrieves long-term identities from local folders adhering to the X.509-based MSP format.
+* **MSP Idemix:** This implementation loads long-term identities from local folders that follow the Idemix-based MSP format.