Source code for aries_cloudagent.connections.models.diddoc.service

"""
DID Document Service classes.

Copyright 2017-2019 Government of Canada
Public Services and Procurement Canada - buyandsell.gc.ca

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.
"""


from typing import List, Sequence, Union

from .util import canon_did, canon_ref
from .publickey import PublicKey


[docs]class Service: """ Service specification to embed in DID document. Retains DIDs as raw values (orientated toward indy-facing operations), everything else as URIs (oriented toward W3C-facing operations). """ def __init__( self, did: str, ident: str, typ: str, recip_keys: Union[Sequence, PublicKey], routing_keys: Union[Sequence, PublicKey], endpoint: str, priority: int = 0, ): """ Initialize the Service instance. Retain service specification particulars. Args: did: DID of DID document embedding service, specified raw (operation converts to URI) ident: identifier for service typ: service type recip_keys: recipient key or keys routing_keys: routing key or keys endpoint: service endpoint priority: service priority Raises: ValueError: on bad input controller DID """ self._did = canon_did(did) self._id = canon_ref(self._did, ident, ";") self._type = typ self._recip_keys = ( [recip_keys] if isinstance(recip_keys, PublicKey) else list(recip_keys) if recip_keys else None ) self._routing_keys = ( [routing_keys] if isinstance(routing_keys, PublicKey) else list(routing_keys) if routing_keys else None ) self._endpoint = endpoint self._priority = priority @property def did(self) -> str: """Accessor for the DID value.""" return self._did @property def id(self) -> str: """Accessor for the service identifier.""" return self._id @property def type(self) -> str: """Accessor for the service type.""" return self._type @property def recip_keys(self) -> List[PublicKey]: """Accessor for the recipient keys.""" return self._recip_keys @property def routing_keys(self) -> List[PublicKey]: """Accessor for the routing keys.""" return self._routing_keys @property def endpoint(self) -> str: """Accessor for the endpoint value.""" return self._endpoint @property def priority(self) -> int: """Accessor for the priority value.""" return self._priority
[docs] def to_dict(self) -> dict: """Return dict representation of service to embed in DID document.""" rv = {"id": self.id, "type": self.type, "priority": self.priority} if self.recip_keys: rv["recipientKeys"] = [k.value for k in self.recip_keys] if self.routing_keys: rv["routingKeys"] = [k.value for k in self.routing_keys] rv["serviceEndpoint"] = self.endpoint return rv