moeralib.naming

Constants

MAIN_SERVER = "https://naming.moera.org/moera-naming"

Main Moera naming server.

DEV_SERVER = "https://naming-dev.moera.org/moera-naming"

Moera developers' naming server.

Functions

node_name_parse(node_name)

Parse a node name and return its name and generation parts. If the node name does not include a generation, generation 0 is returned. If name syntax is invalid, ValueError is raised.

Parameters:

node_name:  str – the node name to be parsed

Return value:

Tuple[str, int] – tuple (name, generation)

shorten(node_name)

Converts the node name to the compact form, omitting generation 0.

Parameters:

node_name:  str | None – the node name in compact or full form

Return value:

str | None – the node name in the compact form

expand(node_name)

Converts the node name to the full form, containing generation.

Parameters:

node_name:  str | None – the node name in compact or full form

Return value:

str | None – the node name in the full form

resolve(name, naming_server=MAIN_SERVER)

Shortcut function to resolve a node name and get the node URI.

Parameters:

name:  str – the node name

naming_server:  str – (optional) a naming server to be used

Return value:

str | None – the node URI, or None if the name does not exist

MoeraNamingError

Generic naming server error.

MoeraNamingError(name, message)

Parameters:

name:  str – API method name

message:  str – error message

MoeraNamingApiError

Naming server returned an error response.

error_code

str – Error code.

MoeraNamingApiError(name, response)

Parameters:

name:  str – request name

response:  Mapping[str, Any] – server response

MoeraNamingConnectionError

Naming server connection error.

MoeraNamingConnectionError(name)

Parameters:

message:  str – error message

MoeraNaming

Naming API interface.

MoeraNaming(server=MAIN_SERVER)

Parameters:

server:  str – (optional) the naming server URL

call(method, params, schema=None)

Generic naming API call.

Parameters:

method:  str – name of the method to be called

params:  Sequence[Any] – parameters of the call

schema:  Any – (optional) JSON schema to validate the return value

Return value:

Any – the return value, if any

put(name, generation, updating_key, node_uri, signing_key, valid_from, previous_digest, signature)

Register or update the name. See Architecture Overview for the detailed description of the algorithm.

Parameters:

name: str – the name to be registered/updated. Required.

generation: int – the name generation to be registered/updated. Required.

updating_key: bytes – the public key for verifying signatures of further updates of the name. May be None – the current key is preserved in this case.

node_uri: str – URI of the REST API endpoint of the node to which the name is assigned. May be None – the current URI is preserved in this case.

signing_key: bytes – the public key of the name owner. May be None – the current key is preserved in this case.

valid_from: Timestamp – the moment in time the owner's key is valid from. May be None, if signing_key is also None.

previous_digest: bytes – the unique identifier as reported by a naming server of the current state of the name. Used to detect the situations when the name was changed by someone else between sending the request and processing it. May be None, if the name was never registered before.

signature: bytes – the signature, if required, None otherwise.

Return value:

str – identifier of the operation that was created

get_status(operation_id)

Get current status of the operation.

Parameters:

operation_id: str

Return value:

types.OperationStatusInfo – the operation status or None, if the operation ID is unknown

get_current(name, generation)

Get current information about the given generation of the name.

Parameters:

name: str

generation: int

Return value:

types.RegisteredNameInfo – the information or None, if the name/generation is not found

get_past(name, generation, at)

Get past information about the given generation of the name.

Parameters:

name: str

generation: int

at: Timestamp – the moment in time the information is related to

Return value:

types.RegisteredNameInfo – the information or None, if the name/generation did not exist at the given moment

is_free(name, generation)

Check if the given name is available for registration.

Parameters:

name: str

generation: int

Return value:

bool – True, if the name is free, False otherwise

get_similar(name)

Find a name that is close to the given name.

Parameters:

name: str

Return value:

types.RegisteredNameInfo – information about the name or None, if no name found that is close enough

get_all_keys(name, generation)

Get the whole history of signing keys for the given name.

Parameters:

name: str

generation: int

Return value:

List[types.SigningKeyInfo]

get_all(at, page, size)

Get the list of all registered names at the given moment. The list is returned in pages, one per call.

Parameters:

at: Timestamp – the moment in time the information is related to

page: int – number of the page to be returned (starting from 0)

size: int – size of the page

Return value:

List[types.RegisteredNameInfo]

get_all_newer(at, page, size)

Get the list of all names registered after the given moment. The list is returned in pages, one per call.

Parameters:

at: Timestamp – the moment in time the information is related to

page: int – number of the page to be returned (starting from 0)

size: int – size of the page

Return value:

List[types.RegisteredNameInfo]

Structures

types.OperationStatusInfo

types.RegisteredNameInfo

types.SigningKeyInfo

Enums

Enums are string literals. Every particular enum type is a set of allowed values you can choose from.

OperationStatus

This enum is used to designate the operation status both by the naming server and by the node.