aries_cloudagent.wallet package

Abstract and Indy wallet handling.

Subpackages

• aries_cloudagent.wallet.models package
  • Submodules
  • aries_cloudagent.wallet.models.wallet_record module

Submodules

aries_cloudagent.wallet.askar module

Aries-Askar implementation of BaseWallet interface.

class aries_cloudagent.wallet.askar.AskarWallet(session: aries_cloudagent.askar.profile.AskarProfileSession)

Bases: aries_cloudagent.wallet.base.BaseWallet

Aries-Askar wallet implementation.

create_local_did(method: aries_cloudagent.wallet.did_method.DIDMethod, key_type: aries_cloudagent.wallet.key_type.KeyType, seed: str = None, did: str = None, metadata: dict = None) → aries_cloudagent.wallet.did_info.DIDInfo

Create and store a new local DID.

Parameters:

• method – The method to use for the DID
• key_type – The key type to use for the DID
• seed – Optional seed to use for DID
• did – The DID to use
• metadata – Metadata to store with DID

Returns:

A DIDInfo instance representing the created DID

Raises:

• WalletDuplicateError – If the DID already exists in the wallet
• WalletError – If there is another backend error

create_signing_key(key_type: aries_cloudagent.wallet.key_type.KeyType, seed: str = None, metadata: dict = None) → aries_cloudagent.wallet.did_info.KeyInfo

Create a new public/private signing keypair.

Parameters:

• key_type – Key type to create
• seed – Seed for key
• metadata – Optional metadata to store with the keypair

Returns:

A KeyInfo representing the new record

Raises:

• WalletDuplicateError – If the resulting verkey already exists in the wallet
• WalletError – If there is another backend error

get_local_did(did: str) → aries_cloudagent.wallet.did_info.DIDInfo

Find info for a local DID.

Parameters:

did – The DID for which to get info

Returns:

A DIDInfo instance representing the found DID

Raises:

• WalletNotFoundError – If the DID is not found
• WalletError – If there is another backend error

get_local_did_for_verkey(verkey: str) → aries_cloudagent.wallet.did_info.DIDInfo

Resolve a local DID from a verkey.

Parameters:verkey – The verkey for which to get the local DID Returns:A DIDInfo instance representing the found DID Raises:WalletNotFoundError – If the verkey is not found

get_local_dids() → Sequence[aries_cloudagent.wallet.did_info.DIDInfo]

Get list of defined local DIDs.

Returns:A list of locally stored DIDs as DIDInfo instances

get_public_did() → aries_cloudagent.wallet.did_info.DIDInfo

Retrieve the public DID.

Returns:The currently public DIDInfo, if any

get_signing_key(verkey: str) → aries_cloudagent.wallet.did_info.KeyInfo

Fetch info for a signing keypair.

Parameters:

verkey – The verification key of the keypair

Returns:

A KeyInfo representing the keypair

Raises:

• WalletNotFoundError – If no keypair is associated with the verification key
• WalletError – If there is another backend error

pack_message(message: str, to_verkeys: Sequence[str], from_verkey: str = None) → bytes

Pack a message for one or more recipients.

Parameters:

• message – The message to pack
• to_verkeys – List of verkeys for which to pack
• from_verkey – Sender verkey from which to pack

Returns:

The resulting packed message bytes

Raises:

• WalletError – If no message is provided
• WalletError – If another backend error occurs

replace_local_did_metadata(did: str, metadata: dict)

Replace metadata for a local DID.

Parameters:

• did – The DID for which to replace metadata
• metadata – The new metadata

replace_signing_key_metadata(verkey: str, metadata: dict)

Replace the metadata associated with a signing keypair.

Parameters:

• verkey – The verification key of the keypair
• metadata – The new metadata to store

Raises:

WalletNotFoundError – if no keypair is associated with the verification key

rotate_did_keypair_apply(did: str) → aries_cloudagent.wallet.did_info.DIDInfo

Apply temporary keypair as main for DID that wallet owns.

Parameters:did – signing DID Returns:DIDInfo with new verification key and metadata for DID

rotate_did_keypair_start(did: str, next_seed: str = None) → str

Begin key rotation for DID that wallet owns: generate new keypair.

Parameters:

• did – signing DID
• next_seed – incoming replacement seed (default random)

Returns:

The new verification key

session

Accessor for Askar profile session instance.

set_did_endpoint(did: str, endpoint: str, ledger: aries_cloudagent.ledger.base.BaseLedger, endpoint_type: aries_cloudagent.ledger.endpoint_type.EndpointType = None, write_ledger: bool = True, endorser_did: str = None, routing_keys: List[str] = None)

Update the endpoint for a DID in the wallet, send to ledger if public or posted.

Parameters:

• did – DID for which to set endpoint
• endpoint – the endpoint to set, None to clear
• ledger – the ledger to which to send endpoint update if DID is public or posted
• endpoint_type – the type of the endpoint/service. Only endpoint_type ‘endpoint’ affects local wallet

set_public_did(did: Union[str, aries_cloudagent.wallet.did_info.DIDInfo]) → aries_cloudagent.wallet.did_info.DIDInfo

Assign the public DID.

Returns:The updated DIDInfo

sign_message(message: Union[List[bytes], bytes], from_verkey: str) → bytes

Sign message(s) using the private key associated with a given verkey.

Parameters:

• message – The message(s) to sign
• from_verkey – Sign using the private key related to this verkey

Returns:

A signature

Raises:

• WalletError – If the message is not provided
• WalletError – If the verkey is not provided
• WalletError – If another backend error occurs

unpack_message(enc_message: bytes) → Tuple[str, str, str]

Unpack a message.

Parameters:

enc_message – The packed message bytes

Returns:

(message, from_verkey, to_verkey)

Return type:

A tuple

Raises:

• WalletError – If the message is not provided
• WalletError – If another backend error occurs

verify_message(message: Union[List[bytes], bytes], signature: bytes, from_verkey: str, key_type: aries_cloudagent.wallet.key_type.KeyType) → bool

Verify a signature against the public key of the signer.

Parameters:

• message – The message to verify
• signature – The signature to verify
• from_verkey – Verkey to use in verification
• key_type – The key type to derive the signature verification algorithm from

Returns:

True if verified, else False

Raises:

• WalletError – If the verkey is not provided
• WalletError – If the signature is not provided
• WalletError – If the message is not provided
• WalletError – If another backend error occurs

aries_cloudagent.wallet.base module

Wallet base class.

class aries_cloudagent.wallet.base.BaseWallet

Bases: abc.ABC

Abstract wallet interface.

create_local_did(method: aries_cloudagent.wallet.did_method.DIDMethod, key_type: aries_cloudagent.wallet.key_type.KeyType, seed: str = None, did: str = None, metadata: dict = None) → aries_cloudagent.wallet.did_info.DIDInfo

Create and store a new local DID.

Parameters:

• method – The method to use for the DID
• key_type – The key type to use for the DID
• seed – Optional seed to use for DID
• did – The DID to use
• metadata – Metadata to store with DID

Returns:

The created DIDInfo

create_public_did(method: aries_cloudagent.wallet.did_method.DIDMethod, key_type: aries_cloudagent.wallet.key_type.KeyType, seed: str = None, did: str = None, metadata: dict = {}) → aries_cloudagent.wallet.did_info.DIDInfo

Create and store a new public DID.

Parameters:

• seed – Optional seed to use for DID
• did – The DID to use
• metadata – Metadata to store with DID

Returns:

The created DIDInfo

create_signing_key(key_type: aries_cloudagent.wallet.key_type.KeyType, seed: str = None, metadata: dict = None) → aries_cloudagent.wallet.did_info.KeyInfo

Create a new public/private signing keypair.

Parameters:

• key_type – Key type to create
• seed – Optional seed allowing deterministic key creation
• metadata – Optional metadata to store with the keypair

Returns:

A KeyInfo representing the new record

get_local_did(did: str) → aries_cloudagent.wallet.did_info.DIDInfo

Find info for a local DID.

Parameters:did – The DID for which to get info Returns:A DIDInfo instance for the DID

get_local_did_for_verkey(verkey: str) → aries_cloudagent.wallet.did_info.DIDInfo

Resolve a local DID from a verkey.

Parameters:verkey – Verkey for which to get DID info Returns:A DIDInfo instance for the DID

get_local_dids() → Sequence[aries_cloudagent.wallet.did_info.DIDInfo]

Get list of defined local DIDs.

Returns:A list of DIDInfo instances

get_posted_dids() → Sequence[aries_cloudagent.wallet.did_info.DIDInfo]

Get list of defined posted DIDs.

Returns:A list of DIDInfo instances

get_public_did() → aries_cloudagent.wallet.did_info.DIDInfo

Retrieve the public DID.

Returns:The currently public DIDInfo, if any

get_signing_key(verkey: str) → aries_cloudagent.wallet.did_info.KeyInfo

Fetch info for a signing keypair.

Parameters:verkey – The verification key of the keypair Returns:A KeyInfo representing the keypair

pack_message(message: str, to_verkeys: Sequence[str], from_verkey: str = None) → bytes

Pack a message for one or more recipients.

Parameters:

• message – The message to pack
• to_verkeys – The verkeys to pack the message for
• from_verkey – The sender verkey

Returns:

The packed message

replace_local_did_metadata(did: str, metadata: dict)

Replace the metadata associated with a local DID.

Prefer set_did_endpoint() to set endpoint in metadata.

Parameters:

• did – DID for which to replace metadata
• metadata – The new metadata

replace_signing_key_metadata(verkey: str, metadata: dict)

Replace the metadata associated with a signing keypair.

Parameters:

• verkey – The verification key of the keypair
• metadata – The new metadata to store

rotate_did_keypair_apply(did: str) → None

Apply temporary keypair as main for DID that wallet owns.

Parameters:

did – signing DID

Raises:

• WalletNotFoundError – if wallet does not own DID
• WalletError – if wallet has not started key rotation

rotate_did_keypair_start(did: str, next_seed: str = None) → str

Begin key rotation for DID that wallet owns: generate new keypair.

Parameters:

• did – signing DID
• next_seed – seed for incoming ed25519 key pair (default random)

Returns:

The new verification key

Raises:

WalletNotFoundError – if wallet does not own DID

set_did_endpoint(did: str, endpoint: str, _ledger: aries_cloudagent.ledger.base.BaseLedger, endpoint_type: aries_cloudagent.ledger.endpoint_type.EndpointType = None, write_ledger: bool = True, endorser_did: str = None, routing_keys: List[str] = None)

Update the endpoint for a DID in the wallet, send to ledger if public or posted.

Parameters:

• did – DID for which to set endpoint
• endpoint – the endpoint to set, None to clear
• ledger – the ledger to which to send endpoint update if DID is public or posted
• endpoint_type – the type of the endpoint/service. Only endpoint_type ‘endpoint’ affects local wallet

set_public_did(did: Union[str, aries_cloudagent.wallet.did_info.DIDInfo]) → aries_cloudagent.wallet.did_info.DIDInfo

Assign the public DID.

Returns:The updated DIDInfo

sign_message(message: Union[List[bytes], bytes], from_verkey: str) → bytes

Sign message(s) using the private key associated with a given verkey.

Parameters:

• message – The message(s) to sign
• from_verkey – Sign using the private key related to this verkey

Returns:

The signature

unpack_message(enc_message: bytes) → Tuple[str, str, str]

Unpack a message.

Parameters:enc_message – The encrypted message Returns:(message, from_verkey, to_verkey) Return type:A tuple

verify_message(message: Union[List[bytes], bytes], signature: bytes, from_verkey: str, key_type: aries_cloudagent.wallet.key_type.KeyType) → bool

Verify a signature against the public key of the signer.

Parameters:

• message – The message to verify
• signature – The signature to verify
• from_verkey – Verkey to use in verification
• key_type – The key type to derive the signature verification algorithm from

Returns:

True if verified, else False

aries_cloudagent.wallet.bbs module

BBS+ crypto.

exception aries_cloudagent.wallet.bbs.BbsException(*args, error_code: str = None, **kwargs)

Bases: aries_cloudagent.core.error.BaseError

Base BBS exception.

aries_cloudagent.wallet.bbs.create_bls12381g2_keypair(seed: bytes = None) → Tuple[bytes, bytes]

Create a public and private bls12381g2 keypair from a seed value.

Parameters:seed – Seed for keypair Returns:A tuple of (public key, secret key)

aries_cloudagent.wallet.bbs.sign_messages_bls12381g2(messages: List[bytes], secret: bytes)

Sign messages using a bls12381g2 private signing key.

Parameters:

• messages (List[bytes]) – The messages to sign
• secret (bytes) – The private signing key

Returns:

The signature

Return type:

bytes

aries_cloudagent.wallet.bbs.verify_signed_messages_bls12381g2(messages: List[bytes], signature: bytes, public_key: bytes) → bool

Verify an ed25519 signed message according to a public verification key.

Parameters:

• signed – The signed messages
• public_key – The public key to use in verification

Returns:

True if verified, else False

aries_cloudagent.wallet.crypto module

Cryptography functions used by BasicWallet.

aries_cloudagent.wallet.crypto.add_pack_recipients(wrapper: aries_cloudagent.utils.jwe.JweEnvelope, cek: bytes, to_verkeys: Sequence[bytes], from_secret: bytes = None)

Assemble the recipients block of a packed message.

Parameters:

• wrapper – The envelope to add recipients to
• cek – The content encryption key
• to_verkeys – Verkeys of recipients
• from_secret – Secret to use for signing keys

Returns:

A tuple of (json result, key)

aries_cloudagent.wallet.crypto.create_ed25519_keypair(seed: bytes = None) → Tuple[bytes, bytes]

Create a public and private ed25519 keypair from a seed value.

Parameters:seed – Seed for keypair Returns:A tuple of (public key, secret key)

aries_cloudagent.wallet.crypto.create_keypair(key_type: aries_cloudagent.wallet.key_type.KeyType, seed: bytes = None) → Tuple[bytes, bytes]

Create a public and private keypair from a seed value.

Parameters:

• key_type – The type of key to generate
• seed – Seed for keypair

Raises:

WalletError – If the key type is not supported

Returns:

A tuple of (public key, secret key)

aries_cloudagent.wallet.crypto.decode_pack_message(enc_message: bytes, find_key: Callable) → Tuple[str, Optional[str], str]

Decode a packed message.

Disassemble and unencrypt a packed message, returning the message content, verification key of the sender (if available), and verification key of the recipient.

Parameters:

• enc_message – The encrypted message
• find_key – Function to retrieve private key

Returns:

A tuple of (message, sender_vk, recip_vk)

Raises:

• ValueError – If the packed message is invalid
• ValueError – If the packed message reipients are invalid
• ValueError – If the pack algorithm is unsupported
• ValueError – If the sender’s public key was not provided

aries_cloudagent.wallet.crypto.decode_pack_message_outer(enc_message: bytes) → Tuple[dict, dict, bool]

Decode the outer wrapper of a packed message and extract the recipients.

Parameters:enc_message – The encrypted message

Returns: a tuple of the decoded wrapper, recipients, and authcrypt flag

aries_cloudagent.wallet.crypto.decode_pack_message_payload(wrapper: aries_cloudagent.utils.jwe.JweEnvelope, payload_key: bytes) → str

Decode the payload of a packed message once the CEK is known.

Parameters:

• wrapper – The decoded message wrapper
• payload_key – The decrypted payload key

aries_cloudagent.wallet.crypto.decrypt_plaintext(ciphertext: bytes, recips_bin: bytes, nonce: bytes, key: bytes) → str

Decrypt the payload of a packed message.

Parameters:

• ciphertext –
• recips_bin –
• nonce –
• key –

Returns:

The decrypted string

aries_cloudagent.wallet.crypto.did_is_self_certified(did: str, verkey: str) → bool

Check if the DID is self certified.

Parameters:

• did – DID string
• verkey – VERKEY string

aries_cloudagent.wallet.crypto.ed25519_pk_to_curve25519(public_key: bytes) → bytes

Covert a public Ed25519 key to a public Curve25519 key as bytes.

aries_cloudagent.wallet.crypto.encode_pack_message(message: str, to_verkeys: Sequence[bytes], from_secret: bytes = None) → bytes

Assemble a packed message for a set of recipients, optionally including the sender.

Parameters:

• message – The message to pack
• to_verkeys – The verkeys to pack the message for
• from_secret – The sender secret

Returns:

The encoded message

aries_cloudagent.wallet.crypto.encrypt_plaintext(message: str, add_data: bytes, key: bytes) → Tuple[bytes, bytes, bytes]

Encrypt the payload of a packed message.

Parameters:

• message – Message to encrypt
• add_data –
• key – Key used for encryption

Returns:

A tuple of (ciphertext, nonce, tag)

aries_cloudagent.wallet.crypto.extract_pack_recipients(recipients: Sequence[aries_cloudagent.utils.jwe.JweRecipient]) → dict

Extract the pack message recipients into a dict indexed by verkey.

Parameters:recipients – Recipients to locate Raises:ValueError – If the recipients block is mal-formatted

aries_cloudagent.wallet.crypto.extract_payload_key(sender_cek: dict, recip_secret: bytes) → Tuple[bytes, str]

Extract the payload key from pack recipient details.

Returns: A tuple of the CEK and sender verkey

aries_cloudagent.wallet.crypto.seed_to_did(seed: str) → str

Derive a DID from a seed value.

Parameters:seed – The seed to derive Returns:The DID derived from the seed

aries_cloudagent.wallet.crypto.sign_message(message: Union[List[bytes], bytes], secret: bytes, key_type: aries_cloudagent.wallet.key_type.KeyType) → bytes

Sign message(s) using a private signing key.

Parameters:

• message – The message(s) to sign
• secret – The private signing key
• key_type – The key type to derive the signature algorithm from

Returns:

The signature

Return type:

bytes

aries_cloudagent.wallet.crypto.sign_message_ed25519(message: bytes, secret: bytes) → bytes

Sign message using a ed25519 private signing key.

Parameters:

• messages (bytes) – The message to sign
• secret (bytes) – The private signing key

Returns:

The signature

Return type:

bytes

aries_cloudagent.wallet.crypto.sign_pk_from_sk(secret: bytes) → bytes

Extract the verkey from a secret signing key.

aries_cloudagent.wallet.crypto.validate_seed(seed: Union[str, bytes]) → bytes

Convert a seed parameter to standard format and check length.

Parameters:seed – The seed to validate Returns:The validated and encoded seed

aries_cloudagent.wallet.crypto.verify_signed_message(message: Union[List[bytes], bytes], signature: bytes, verkey: bytes, key_type: aries_cloudagent.wallet.key_type.KeyType) → bool

Verify a signed message according to a public verification key.

Parameters:

• message – The message(s) to verify
• signature – The signature to verify
• verkey – The verkey to use in verification
• key_type – The key type to derive the signature verification algorithm from

Returns:

True if verified, else False

aries_cloudagent.wallet.crypto.verify_signed_message_ed25519(message: bytes, signature: bytes, verkey: bytes) → bool

Verify an ed25519 signed message according to a public verification key.

Parameters:

• message – The message to verify
• signature – The signature to verify
• verkey – The verkey to use in verification

Returns:

True if verified, else False

aries_cloudagent.wallet.default_verification_key_strategy module

Utilities for specifying which verification method is in use for a given DID.

class aries_cloudagent.wallet.default_verification_key_strategy.BaseVerificationKeyStrategy

Bases: abc.ABC

Base class for defining which verification method is in use.

get_verification_method_id_for_did(did: str, profile: Optional[aries_cloudagent.core.profile.Profile], allowed_verification_method_types: Optional[List[aries_cloudagent.wallet.key_type.KeyType]] = None, proof_purpose: Optional[str] = None) → Optional[str]

Given a DID, returns the verification key ID in use.

Returns None if no strategy is specified for this DID.

Params did:the did Params profile:context of the call Params allowed_verification_method_types:  list of accepted key types Params proof_purpose:  the verkey relationship (assertionMethod, keyAgreement, ..) Returns Optional[str]:  the current verkey ID

class aries_cloudagent.wallet.default_verification_key_strategy.DefaultVerificationKeyStrategy

Bases: aries_cloudagent.wallet.default_verification_key_strategy.BaseVerificationKeyStrategy

A basic implementation for verkey strategy.

Supports did:key: and did:sov only.

get_verification_method_id_for_did(did: str, profile: Optional[aries_cloudagent.core.profile.Profile], allowed_verification_method_types: Optional[List[aries_cloudagent.wallet.key_type.KeyType]] = None, proof_purpose: Optional[str] = None) → Optional[str]

Given a did:key or did:sov, returns the verification key ID in use.

Returns None if no strategy is specified for this DID.

Params did:the did Params profile:context of the call Params allowed_verification_method_types:  list of accepted key types Params proof_purpose:  the verkey relationship (assertionMethod, keyAgreement, ..) Returns Optional[str]:  the current verkey ID

aries_cloudagent.wallet.did_info module

KeyInfo, DIDInfo.

class aries_cloudagent.wallet.did_info.DIDInfo(did, verkey, metadata, method, key_type)

Bases: tuple

did

Alias for field number 0

key_type

Alias for field number 4

metadata

Alias for field number 2

method

Alias for field number 3

verkey

Alias for field number 1

class aries_cloudagent.wallet.did_info.KeyInfo(verkey, metadata, key_type)

Bases: tuple

key_type

Alias for field number 2

metadata

Alias for field number 1

verkey

Alias for field number 0

aries_cloudagent.wallet.did_method module

did method.py contains registry for did methods.

class aries_cloudagent.wallet.did_method.DIDMethod(name: str, key_types: List[aries_cloudagent.wallet.key_type.KeyType], rotation: bool = False, holder_defined_did: aries_cloudagent.wallet.did_method.HolderDefinedDid = <HolderDefinedDid.NO: 'no'>)

Bases: object

Class to represent a did method.

holder_defined_did() → aries_cloudagent.wallet.did_method.HolderDefinedDid

Return the did derivation policy.

eg: did:key DIDs are derived from the verkey -> HolderDefinedDid.NO eg: did:web DIDs cannot be derived from key material -> HolderDefinedDid.REQUIRED

method_name

Get method name.

supported_key_types

Get supported key types.

supports_key_type(key_type: aries_cloudagent.wallet.key_type.KeyType) → bool

Check whether the current method supports the key type.

supports_rotation

Check rotation support.

class aries_cloudagent.wallet.did_method.DIDMethods

Bases: object

DID Method class specifying DID methods with supported key types.

from_did(did: str) → aries_cloudagent.wallet.did_method.DIDMethod

Get DID method instance from the did url.

from_metadata(metadata: Mapping) → Optional[aries_cloudagent.wallet.did_method.DIDMethod]

Get DID method instance from metadata object.

Returns SOV if no metadata was found for backwards compatibility.

from_method(method_name: str) → Optional[aries_cloudagent.wallet.did_method.DIDMethod]

Retrieve a did method from method name.

register(method: aries_cloudagent.wallet.did_method.DIDMethod)

Register a new did method.

registered(method: str) → bool

Check for a supported method.

class aries_cloudagent.wallet.did_method.HolderDefinedDid

Bases: enum.Enum

Define if a holder can specify its own did for a given method.

ALLOWED = 'allowed'

NO = 'no'

REQUIRED = 'required'

aries_cloudagent.wallet.did_parameters_validation module

Tooling to validate DID creation parameters.

class aries_cloudagent.wallet.did_parameters_validation.DIDParametersValidation(did_methods: aries_cloudagent.wallet.did_method.DIDMethods)

Bases: object

A utility class to check compatibility of provided DID creation parameters.

static validate_key_type(method: aries_cloudagent.wallet.did_method.DIDMethod, key_type: aries_cloudagent.wallet.key_type.KeyType)

Validate compatibility of the DID method with the desired key type.

validate_or_derive_did(method: aries_cloudagent.wallet.did_method.DIDMethod, key_type: aries_cloudagent.wallet.key_type.KeyType, verkey: bytes, did: Optional[str]) → str

Validate compatibility of the provided did (if any) with the given DID method.

If no DID was provided, automatically derive one for methods that support it.

aries_cloudagent.wallet.did_posture module

Ledger utilities.

class aries_cloudagent.wallet.did_posture.DIDPosture

Bases: enum.Enum

Enum for DID postures: public, posted but not public, or in wallet only.

POSTED = DIDPostureSpec(moniker='posted', ordinal=1, public=False, posted=True)

PUBLIC = DIDPostureSpec(moniker='public', ordinal=0, public=True, posted=True)

WALLET_ONLY = DIDPostureSpec(moniker='wallet_only', ordinal=2, public=False, posted=False)

get = <function DIDPosture.get>

metadata

DID metadata for DID posture.

moniker

Name for DID posture.

ordinal

public first, then posted and wallet-only.

Type:Ordinal for presentation

class aries_cloudagent.wallet.did_posture.DIDPostureSpec(moniker, ordinal, public, posted)

Bases: tuple

moniker

Alias for field number 0

ordinal

Alias for field number 1

posted

Alias for field number 3

public

Alias for field number 2

aries_cloudagent.wallet.error module

Wallet-related exceptions.

exception aries_cloudagent.wallet.error.WalletDuplicateError(*args, error_code: str = None, **kwargs)

Bases: aries_cloudagent.wallet.error.WalletError

Duplicate record exception.

exception aries_cloudagent.wallet.error.WalletError(*args, error_code: str = None, **kwargs)

Bases: aries_cloudagent.core.error.BaseError

General wallet exception.

exception aries_cloudagent.wallet.error.WalletNotFoundError(*args, error_code: str = None, **kwargs)

Bases: aries_cloudagent.wallet.error.WalletError

Record not found exception.

exception aries_cloudagent.wallet.error.WalletSettingsError(*args, error_code: str = None, **kwargs)

Bases: aries_cloudagent.wallet.error.WalletError

Invalid settings exception.

aries_cloudagent.wallet.in_memory module

In-memory implementation of BaseWallet interface.

class aries_cloudagent.wallet.in_memory.InMemoryWallet(profile: aries_cloudagent.core.in_memory.profile.InMemoryProfile)

Bases: aries_cloudagent.wallet.base.BaseWallet

In-memory wallet implementation.

create_local_did(method: aries_cloudagent.wallet.did_method.DIDMethod, key_type: aries_cloudagent.wallet.key_type.KeyType, seed: str = None, did: str = None, metadata: dict = None) → aries_cloudagent.wallet.did_info.DIDInfo

Create and store a new local DID.

Parameters:

• method – The method to use for the DID
• key_type – The key type to use for the DID
• seed – Optional seed to use for DID
• did – The DID to use
• metadata – Metadata to store with DID

Returns:

A DIDInfo instance representing the created DID

Raises:

WalletDuplicateError – If the DID already exists in the wallet

create_signing_key(key_type: aries_cloudagent.wallet.key_type.KeyType, seed: str = None, metadata: dict = None) → aries_cloudagent.wallet.did_info.KeyInfo

Create a new public/private signing keypair.

Parameters:

• seed – Seed to use for signing key
• metadata – Optional metadata to store with the keypair
• key_type – Key type to generate. Default to ed25519

Returns:

A KeyInfo representing the new record

Raises:

WalletDuplicateError – If the resulting verkey already exists in the wallet

get_local_did(did: str) → aries_cloudagent.wallet.did_info.DIDInfo

Find info for a local DID.

Parameters:did – The DID for which to get info Returns:A DIDInfo instance representing the found DID Raises:WalletNotFoundError – If the DID is not found

get_local_did_for_verkey(verkey: str) → aries_cloudagent.wallet.did_info.DIDInfo

Resolve a local DID from a verkey.

Parameters:verkey – The verkey for which to get the local DID Returns:A DIDInfo instance representing the found DID Raises:WalletNotFoundError – If the verkey is not found

get_local_dids() → Sequence[aries_cloudagent.wallet.did_info.DIDInfo]

Get list of defined local DIDs.

Returns:A list of locally stored DIDs as DIDInfo instances

get_public_did() → aries_cloudagent.wallet.did_info.DIDInfo

Retrieve the public DID.

Returns:The currently public DIDInfo, if any

get_signing_key(verkey: str) → aries_cloudagent.wallet.did_info.KeyInfo

Fetch info for a signing keypair.

Parameters:verkey – The verification key of the keypair Returns:A KeyInfo representing the keypair Raises:WalletNotFoundError – if no keypair is associated with the verification key

pack_message(message: str, to_verkeys: Sequence[str], from_verkey: str = None) → bytes

Pack a message for one or more recipients.

Parameters:

• message – The message to pack
• to_verkeys – List of verkeys for which to pack
• from_verkey – Sender verkey from which to pack

Returns:

The resulting packed message bytes

Raises:

WalletError – If the message is not provided

replace_local_did_metadata(did: str, metadata: dict)

Replace metadata for a local DID.

Parameters:

• did – The DID for which to replace metadata
• metadata – The new metadata

Raises:

WalletNotFoundError – If the DID doesn’t exist

replace_signing_key_metadata(verkey: str, metadata: dict)

Replace the metadata associated with a signing keypair.

Parameters:

• verkey – The verification key of the keypair
• metadata – The new metadata to store

Raises:

WalletNotFoundError – if no keypair is associated with the verification key

rotate_did_keypair_apply(did: str) → None

Apply temporary keypair as main for DID that wallet owns.

Parameters:

did – signing DID

Raises:

• WalletNotFoundError – if wallet does not own DID
• WalletError – if wallet has not started key rotation

rotate_did_keypair_start(did: str, next_seed: str = None) → str

Begin key rotation for DID that wallet owns: generate new keypair.

Parameters:

• did – signing DID
• next_seed – incoming replacement seed (default random)

Returns:

The new verification key

Raises:

WalletNotFoundError – if wallet does not own DID

set_public_did(did: Union[str, aries_cloudagent.wallet.did_info.DIDInfo]) → aries_cloudagent.wallet.did_info.DIDInfo

Assign the public DID.

Returns:The updated DIDInfo

sign_message(message: Union[List[bytes], bytes], from_verkey: str) → bytes

Sign message(s) using the private key associated with a given verkey.

Parameters:

• message – Message(s) bytes to sign
• from_verkey – The verkey to use to sign

Returns:

A signature

Raises:

• WalletError – If the message is not provided
• WalletError – If the verkey is not provided

unpack_message(enc_message: bytes) → Tuple[str, str, str]

Unpack a message.

Parameters:

enc_message – The packed message bytes

Returns:

(message, from_verkey, to_verkey)

Return type:

A tuple

Raises:

• WalletError – If the message is not provided
• WalletError – If there is a problem unpacking the message

verify_message(message: Union[List[bytes], bytes], signature: bytes, from_verkey: str, key_type: aries_cloudagent.wallet.key_type.KeyType) → bool

Verify a signature against the public key of the signer.

Parameters:

• message – Message(s) to verify
• signature – Signature to verify
• from_verkey – Verkey to use in verification
• key_type – The key type to derive the signature verification algorithm from

Returns:

True if verified, else False

Raises:

• WalletError – If the verkey is not provided
• WalletError – If the signature is not provided
• WalletError – If the message is not provided

aries_cloudagent.wallet.indy module

Indy implementation of BaseWallet interface.

class aries_cloudagent.wallet.indy.IndySdkWallet(opened: aries_cloudagent.indy.sdk.wallet_setup.IndyOpenWallet)

Bases: aries_cloudagent.wallet.base.BaseWallet

Indy identity wallet implementation.

create_local_did(method: aries_cloudagent.wallet.did_method.DIDMethod, key_type: aries_cloudagent.wallet.key_type.KeyType, seed: str = None, did: str = None, metadata: dict = None) → aries_cloudagent.wallet.did_info.DIDInfo

Create and store a new local DID.

Parameters:

• method – The method to use for the DID
• key_type – The key type to use for the DID
• seed – Optional seed to use for DID
• did – The DID to use
• metadata – Metadata to store with DID

Returns:

A DIDInfo instance representing the created DID

Raises:

• WalletDuplicateError – If the DID already exists in the wallet
• WalletError – If there is a libindy error

create_signing_key(key_type: aries_cloudagent.wallet.key_type.KeyType, seed: str = None, metadata: dict = None) → aries_cloudagent.wallet.did_info.KeyInfo

Create a new public/private signing keypair.

Parameters:

• seed – Seed for key
• metadata – Optional metadata to store with the keypair

Returns:

A KeyInfo representing the new record

Raises:

• WalletDuplicateError – If the resulting verkey already exists in the wallet
• WalletError – If there is a libindy error

classmethod generate_wallet_key(seed: str = None) → str

Generate a raw Indy wallet key.

get_local_did(did: str) → aries_cloudagent.wallet.did_info.DIDInfo

Find info for a local DID.

Parameters:

did – The DID for which to get info

Returns:

A DIDInfo instance representing the found DID

Raises:

• WalletNotFoundError – If the DID is not found
• WalletError – If there is a libindy error

get_local_did_for_verkey(verkey: str) → aries_cloudagent.wallet.did_info.DIDInfo

Resolve a local DID from a verkey.

Parameters:verkey – The verkey for which to get the local DID Returns:A DIDInfo instance representing the found DID Raises:WalletNotFoundError – If the verkey is not found

get_local_dids() → Sequence[aries_cloudagent.wallet.did_info.DIDInfo]

Get list of defined local DIDs.

Returns:A list of locally stored DIDs as DIDInfo instances

get_public_did() → aries_cloudagent.wallet.did_info.DIDInfo

Retrieve the public DID.

Returns:The currently public DIDInfo, if any

get_signing_key(verkey: str) → aries_cloudagent.wallet.did_info.KeyInfo

Fetch info for a signing keypair.

Parameters:

verkey – The verification key of the keypair

Returns:

A KeyInfo representing the keypair

Raises:

• WalletNotFoundError – If no keypair is associated with the verification key
• WalletError – If there is a libindy error

pack_message(message: str, to_verkeys: Sequence[str], from_verkey: str = None) → bytes

Pack a message for one or more recipients.

Parameters:

• message – The message to pack
• to_verkeys – List of verkeys for which to pack
• from_verkey – Sender verkey from which to pack

Returns:

The resulting packed message bytes

Raises:

• WalletError – If no message is provided
• WalletError – If a libindy error occurs

replace_local_did_metadata(did: str, metadata: dict)

Replace metadata for a local DID.

Parameters:

• did – The DID for which to replace metadata
• metadata – The new metadata

replace_signing_key_metadata(verkey: str, metadata: dict)

Replace the metadata associated with a signing keypair.

Parameters:

• verkey – The verification key of the keypair
• metadata – The new metadata to store

Raises:

WalletNotFoundError – if no keypair is associated with the verification key

rotate_did_keypair_apply(did: str) → aries_cloudagent.wallet.did_info.DIDInfo

Apply temporary keypair as main for DID that wallet owns.

Parameters:did – signing DID Returns:DIDInfo with new verification key and metadata for DID

rotate_did_keypair_start(did: str, next_seed: str = None) → str

Begin key rotation for DID that wallet owns: generate new keypair.

Parameters:

• did – signing DID
• next_seed – incoming replacement seed (default random)

Returns:

The new verification key

set_did_endpoint(did: str, endpoint: str, ledger: aries_cloudagent.ledger.base.BaseLedger, endpoint_type: aries_cloudagent.ledger.endpoint_type.EndpointType = None, write_ledger: bool = True, endorser_did: str = None, routing_keys: List[str] = None)

Update the endpoint for a DID in the wallet, send to ledger if public or posted.

Parameters:

• did – DID for which to set endpoint
• endpoint – the endpoint to set, None to clear
• ledger – the ledger to which to send endpoint update if DID is public or posted
• endpoint_type – the type of the endpoint/service. Only endpoint_type ‘endpoint’ affects local wallet

set_public_did(did: Union[str, aries_cloudagent.wallet.did_info.DIDInfo]) → aries_cloudagent.wallet.did_info.DIDInfo

Assign the public DID.

Returns:The updated DIDInfo

sign_message(message: bytes, from_verkey: str) → bytes

Sign a message using the private key associated with a given verkey.

Parameters:

• message – Message bytes to sign
• from_verkey – The verkey to use to sign

Returns:

A signature

Raises:

• WalletError – If the message is not provided
• WalletError – If the verkey is not provided
• WalletError – If a libindy error occurs

unpack_message(enc_message: bytes) → Tuple[str, str, str]

Unpack a message.

Parameters:

enc_message – The packed message bytes

Returns:

(message, from_verkey, to_verkey)

Return type:

A tuple

Raises:

• WalletError – If the message is not provided
• WalletError – If a libindy error occurs

verify_message(message: Union[List[bytes], bytes], signature: bytes, from_verkey: str, key_type: aries_cloudagent.wallet.key_type.KeyType) → bool

Verify a signature against the public key of the signer.

Parameters:

• message – Message to verify
• signature – Signature to verify
• from_verkey – Verkey to use in verification

Returns:

True if verified, else False

Raises:

• WalletError – If the verkey is not provided
• WalletError – If the signature is not provided
• WalletError – If the message is not provided
• WalletError – If a libindy error occurs

aries_cloudagent.wallet.jwt module

Operations supporting JWT creation and verification.

class aries_cloudagent.wallet.jwt.JWTVerifyResult

Bases: tuple

Result from verify.

headers

Alias for field number 0

kid

Alias for field number 3

payload

Alias for field number 1

valid

Alias for field number 2

aries_cloudagent.wallet.jwt.b64_to_dict(value: str) → Mapping[str, Any]

Decode a dictionary from a b64 encoded value.

aries_cloudagent.wallet.jwt.dict_to_b64(value: Mapping[str, Any]) → str

Encode a dictionary as a b64 string.

aries_cloudagent.wallet.jwt.did_lookup_name(value: str) → str

Return the value used to lookup a DID in the wallet.

If value is did:sov, return the unqualified value. Else, return value.

aries_cloudagent.wallet.jwt.jwt_sign(profile: aries_cloudagent.core.profile.Profile, headers: Mapping[str, Any], payload: Mapping[str, Any], did: Optional[str] = None, verification_method: Optional[str] = None) → str

Create a signed JWT given headers, payload, and signing DID or DID URL.

aries_cloudagent.wallet.jwt.jwt_verify(profile: aries_cloudagent.core.profile.Profile, jwt: str) → aries_cloudagent.wallet.jwt.JWTVerifyResult

Verify a JWT and return the headers and payload.

aries_cloudagent.wallet.jwt.nym_to_did(value: str) → str

Return a did from nym if passed value is nym, else return value.

aries_cloudagent.wallet.jwt.resolve_public_key_by_kid_for_verify(profile: aries_cloudagent.core.profile.Profile, kid: str) → str

Resolve public key material from a kid.

aries_cloudagent.wallet.key_pair module

Key pair storage manager.

class aries_cloudagent.wallet.key_pair.KeyPairStorageManager(store: aries_cloudagent.storage.base.BaseStorage)

Bases: object

Key pair storage manager.

delete_key_pair(verkey: str)

Remove a previously-stored key pair record.

Raises:StorageNotFoundError – If the record is not found

find_key_pairs(tag_query: Optional[Mapping] = None) → List[dict]

Find key pairs by tag query.

get_key_pair(verkey: str) → dict

Retrieve signing key pair from storage by verkey.

Parameters:

• storage (BaseStorage) – The storage to use for querying
• verkey (str) – The verkey to query for

Raises:

• StorageDuplicateError – If more than one key pair is found for this verkey
• StorageNotFoundError – If no key pair is found for this verkey

Returns

dict: The key pair data

store_key_pair(public_key: bytes, secret_key: bytes, key_type: aries_cloudagent.wallet.key_type.KeyType, metadata: dict = {}, tags: dict = {})

Store signing key pair in storage.

Parameters:

• public_key (bytes) – The public key
• secret_key (bytes) – The secret key
• key_type (KeyType) – The key type
• metadata (dict, optional) – The metadata
• tags (dict, optional) – The tags.

update_key_pair_metadata(verkey: str, metadata: dict)

Update the metadata of a key pair record by verkey.

Raises:StorageNotFoundError – If the record is not found.

aries_cloudagent.wallet.key_type module

Key type code.

class aries_cloudagent.wallet.key_type.KeyType(key_type: str, multicodec_name: str, multicodec_prefix: bytes)

Bases: object

Key Type class.

key_type

Get Key type, type.

multicodec_name

Get key type multicodec name.

multicodec_prefix

Get key type multicodec prefix.

class aries_cloudagent.wallet.key_type.KeyTypes

Bases: object

KeyType class specifying key types with multicodec name.

from_key_type(key_type: str) → Optional[aries_cloudagent.wallet.key_type.KeyType]

Get KeyType instance from the key type identifier.

from_multicodec_name(multicodec_name: str) → Optional[aries_cloudagent.wallet.key_type.KeyType]

Get KeyType instance based on multicodec name. Returns None if not found.

from_multicodec_prefix(multicodec_prefix: bytes) → Optional[aries_cloudagent.wallet.key_type.KeyType]

Get KeyType instance based on multicodec prefix. Returns None if not found.

from_prefixed_bytes(prefixed_bytes: bytes) → Optional[aries_cloudagent.wallet.key_type.KeyType]

Get KeyType instance based on prefix in bytes. Returns None if not found.

register(key_type: aries_cloudagent.wallet.key_type.KeyType)

Register a new key type.

aries_cloudagent.wallet.routes module

Wallet admin routes.

class aries_cloudagent.wallet.routes.AttribConnIdMatchInfoSchema(*args, **kwargs)

Bases: aries_cloudagent.messaging.models.openapi.OpenAPISchema

Path parameters and validators for request taking connection id.

conn_id

Used by autodoc_mock_imports.

class aries_cloudagent.wallet.routes.CreateAttribTxnForEndorserOptionSchema(*args, **kwargs)

Bases: aries_cloudagent.messaging.models.openapi.OpenAPISchema

Class for user to input whether to create a transaction for endorser or not.

create_transaction_for_endorser

Used by autodoc_mock_imports.

class aries_cloudagent.wallet.routes.DIDCreateOptionsSchema(*args, **kwargs)

Bases: aries_cloudagent.messaging.models.openapi.OpenAPISchema

Parameters and validators for create DID options.

did

Used by autodoc_mock_imports.

key_type

Used by autodoc_mock_imports.

class aries_cloudagent.wallet.routes.DIDCreateSchema(*args, **kwargs)

Bases: aries_cloudagent.messaging.models.openapi.OpenAPISchema

Parameters and validators for create DID endpoint.

method

Used by autodoc_mock_imports.

options

Used by autodoc_mock_imports.

seed

Used by autodoc_mock_imports.

class aries_cloudagent.wallet.routes.DIDEndpointSchema(*args, **kwargs)

Bases: aries_cloudagent.messaging.models.openapi.OpenAPISchema

Request schema to set DID endpoint; response schema to get DID endpoint.

did

Used by autodoc_mock_imports.

endpoint

Used by autodoc_mock_imports.

class aries_cloudagent.wallet.routes.DIDEndpointWithTypeSchema(*args, **kwargs)

Bases: aries_cloudagent.messaging.models.openapi.OpenAPISchema

Request schema to set DID endpoint of particular type.

did

Used by autodoc_mock_imports.

endpoint

Used by autodoc_mock_imports.

endpoint_type

Used by autodoc_mock_imports.

class aries_cloudagent.wallet.routes.DIDListQueryStringSchema(*args, **kwargs)

Bases: aries_cloudagent.messaging.models.openapi.OpenAPISchema

Parameters and validators for DID list request query string.

did

Used by autodoc_mock_imports.

key_type

Used by autodoc_mock_imports.

method

Used by autodoc_mock_imports.

posture

Used by autodoc_mock_imports.

verkey

Used by autodoc_mock_imports.

class aries_cloudagent.wallet.routes.DIDListSchema(*args, **kwargs)

Bases: aries_cloudagent.messaging.models.openapi.OpenAPISchema

Result schema for connection list.

results

Used by autodoc_mock_imports.

class aries_cloudagent.wallet.routes.DIDQueryStringSchema(*args, **kwargs)

Bases: aries_cloudagent.messaging.models.openapi.OpenAPISchema

Parameters and validators for set public DID request query string.

did

Used by autodoc_mock_imports.

class aries_cloudagent.wallet.routes.DIDResultSchema(*args, **kwargs)

Bases: aries_cloudagent.messaging.models.openapi.OpenAPISchema

Result schema for a DID.

result

Used by autodoc_mock_imports.

class aries_cloudagent.wallet.routes.DIDSchema(*args, **kwargs)

Bases: aries_cloudagent.messaging.models.openapi.OpenAPISchema

Result schema for a DID.

did

Used by autodoc_mock_imports.

key_type

Used by autodoc_mock_imports.

method

Used by autodoc_mock_imports.

posture

Used by autodoc_mock_imports.

verkey

Used by autodoc_mock_imports.

class aries_cloudagent.wallet.routes.JWSCreateSchema(*args, **kwargs)

Bases: aries_cloudagent.messaging.models.openapi.OpenAPISchema

Request schema to create a jws with a particular DID.

did

Used by autodoc_mock_imports.

headers

Used by autodoc_mock_imports.

payload

Used by autodoc_mock_imports.

verification_method

Used by autodoc_mock_imports.

class aries_cloudagent.wallet.routes.JWSVerifyResponseSchema(*args, **kwargs)

Bases: aries_cloudagent.messaging.models.openapi.OpenAPISchema

Response schema for verification result.

error

Used by autodoc_mock_imports.

headers

Used by autodoc_mock_imports.

kid

Used by autodoc_mock_imports.

payload

Used by autodoc_mock_imports.

valid

Used by autodoc_mock_imports.

class aries_cloudagent.wallet.routes.JWSVerifySchema(*args, **kwargs)

Bases: aries_cloudagent.messaging.models.openapi.OpenAPISchema

Request schema to verify a jws created from a DID.

jwt

Used by autodoc_mock_imports.

class aries_cloudagent.wallet.routes.MediationIDSchema(*args, **kwargs)

Bases: aries_cloudagent.messaging.models.openapi.OpenAPISchema

Class for user to optionally input a mediation_id.

mediation_id

Used by autodoc_mock_imports.

class aries_cloudagent.wallet.routes.WalletModuleResponseSchema(*args, **kwargs)

Bases: aries_cloudagent.messaging.models.openapi.OpenAPISchema

Response schema for Wallet Module.

aries_cloudagent.wallet.routes.format_did_info(info: aries_cloudagent.wallet.did_info.DIDInfo)

Serialize a DIDInfo object.

aries_cloudagent.wallet.routes.on_register_nym_event(profile: aries_cloudagent.core.profile.Profile, event: aries_cloudagent.core.event_bus.Event)

Handle any events we need to support.

aries_cloudagent.wallet.routes.post_process_routes(app: <sphinx.ext.autodoc.importer._MockObject object at 0x7fc042a91d30>)

Amend swagger API.

aries_cloudagent.wallet.routes.promote_wallet_public_did(profile: aries_cloudagent.core.profile.Profile, context: aries_cloudagent.admin.request_context.AdminRequestContext, session_fn, did: str, write_ledger: bool = False, connection_id: str = None, routing_keys: List[str] = None, mediator_endpoint: str = None) → Tuple[aries_cloudagent.wallet.did_info.DIDInfo, Optional[dict]]

Promote supplied DID to the wallet public DID.

aries_cloudagent.wallet.routes.register(app: <sphinx.ext.autodoc.importer._MockObject object at 0x7fc042a91d30>)

Register routes.

aries_cloudagent.wallet.routes.register_events(event_bus: aries_cloudagent.core.event_bus.EventBus)

Subscribe to any events we need to support.

aries_cloudagent.wallet.routes.wallet_create_did(request: <sphinx.ext.autodoc.importer._MockObject object at 0x7fc042a91d30>)

Request handler for creating a new local DID in the wallet.

Parameters:request – aiohttp request object Returns:The DID info

aries_cloudagent.wallet.routes.wallet_did_list(request: <sphinx.ext.autodoc.importer._MockObject object at 0x7fc042a91d30>)

Request handler for searching wallet DIDs.

Parameters:request – aiohttp request object Returns:The DID list response

aries_cloudagent.wallet.routes.wallet_get_did_endpoint(request: <sphinx.ext.autodoc.importer._MockObject object at 0x7fc042a91d30>)

Request handler for getting the current DID endpoint from the wallet.

Parameters:request – aiohttp request object Returns:The updated DID info

aries_cloudagent.wallet.routes.wallet_get_public_did(request: <sphinx.ext.autodoc.importer._MockObject object at 0x7fc042a91d30>)

Request handler for fetching the current public DID.

Parameters:request – aiohttp request object Returns:The DID info

aries_cloudagent.wallet.routes.wallet_jwt_sign(request: <sphinx.ext.autodoc.importer._MockObject object at 0x7fc042a91d30>)

Request handler for jws creation using did.

Parameters:

• "headers" – { … },
• "payload" – { … },
• "did" – “did:example:123”,
• "verificationMethod" – “did:example:123#keys-1”
• did and verification being mutually exclusive. (with) –

aries_cloudagent.wallet.routes.wallet_jwt_verify(request: <sphinx.ext.autodoc.importer._MockObject object at 0x7fc042a91d30>)

Request handler for jws validation using did.

Parameters:"jwt" – { … }

aries_cloudagent.wallet.routes.wallet_rotate_did_keypair(request: <sphinx.ext.autodoc.importer._MockObject object at 0x7fc042a91d30>)

Request handler for rotating local DID keypair.

Parameters:request – aiohttp request object Returns:An empty JSON response

aries_cloudagent.wallet.routes.wallet_set_did_endpoint(request: <sphinx.ext.autodoc.importer._MockObject object at 0x7fc042a91d30>)

Request handler for setting an endpoint for a DID.

Parameters:request – aiohttp request object

aries_cloudagent.wallet.routes.wallet_set_public_did(request: <sphinx.ext.autodoc.importer._MockObject object at 0x7fc042a91d30>)

Request handler for setting the current public DID.

Parameters:request – aiohttp request object Returns:The updated DID info

aries_cloudagent.wallet.util module

Wallet utility functions.

aries_cloudagent.wallet.util.abbr_verkey(full_verkey: str, did: str = None) → str

Given a full verkey and DID, return the abbreviated verkey.

aries_cloudagent.wallet.util.b58_to_bytes(val: str) → bytes

Convert a base 58 string to bytes.

aries_cloudagent.wallet.util.b64_to_bytes(val: str, urlsafe=False) → bytes

Convert a base 64 string to bytes.

aries_cloudagent.wallet.util.b64_to_str(val: str, urlsafe=False, encoding=None) → str

Convert a base 64 string to string on input encoding (default utf-8).

aries_cloudagent.wallet.util.bytes_to_b58(val: bytes) → str

Convert a byte string to base 58.

aries_cloudagent.wallet.util.bytes_to_b64(val: bytes, urlsafe=False, pad=True, encoding: str = 'ascii') → str

Convert a byte string to base 64.

aries_cloudagent.wallet.util.default_did_from_verkey(verkey: str) → str

Given a verkey, return the default indy did.

By default the did is the first 16 bytes of the verkey.

aries_cloudagent.wallet.util.full_verkey(did: str, abbr_verkey: str) → str

Given a DID and abbreviated verkey, return the full verkey.

aries_cloudagent.wallet.util.notify_endorse_did_attrib_event(profile: aries_cloudagent.core.profile.Profile, did: str, meta_data: dict)

Send notification for a DID ATTRIB post-process event.

aries_cloudagent.wallet.util.notify_endorse_did_event(profile: aries_cloudagent.core.profile.Profile, did: str, meta_data: dict)

Send notification for a DID post-process event.

aries_cloudagent.wallet.util.pad(val: str) → str

Pad base64 values if need be: JWT calls to omit trailing padding.

aries_cloudagent.wallet.util.random_seed() → bytes

Generate a random seed value.

Returns:A new random seed

aries_cloudagent.wallet.util.set_urlsafe_b64(val: str, urlsafe: bool = True) → str

Set URL safety in base64 encoding.

aries_cloudagent.wallet.util.str_to_b64(val: str, urlsafe=False, encoding=None, pad=True) → str

Convert a string to base64 string on input encoding (default utf-8).

aries_cloudagent.wallet.util.unpad(val: str) → str

Remove padding from base64 values if need be.