Flows

Login Flow

1. Get Omikron from Omega:

GET /get_omikron/{user_id}/

{
  "type": "omikron",
  "data": {
    "domain": "{example: "germany-1.omikron.tensamin.net"}",
    "public_key": "{x448 Public Key}"
  }
}

2. Connect to Omikron and identify:

Request:

{
  "type": "identification",
  "data": {
    "user_id": "{id}"
  }
}

Response:

{
  "type": "challenge",
  "data": {
    "challenge": "{E2EE base64 string}",
    "solved_hash": "{SHA256 from solved}"
  }
}

3. Solve challenge and finish identification:

If the solved challenge doesn’t match the provided hash throw an error.

Request:

{
  "type": "challenge_response",
  "data": {
    "challenge": "{solved challenge}"
  }
}

Response:

{
  "type": "error_{error type} | identification_response",
  "data": {
    // If success
    "chats": [],
    "communties": []
  }
}