package mobile.persona.v2

Get desktop application:
View/edit binary Protocol Buffers messages

• rpc SetDisplayName (SetDisplayNameRequest, SetDisplayNameResponse)

  persona_service.proto:20

  Change the first and/or last name for the specified Persona. Last name is not required and if it is not specified then any value currently stored for it will be cleared. The specified Persona must be owned by the caller of this method; clients cannot change Personas that they do not own. The specified PersonaId cannot be a wrapper for an AliasJid; the only way to change the display info for an AliasJid is to change the info for the Genesis Persona directly that the AliasJid maps to.

  message SetDisplayNameRequest

  persona_service.proto:23

  • optional common.v2.PersonaId persona_id = 1

  • oneof display_name

    • SetDisplayNameRequest.FirstLastName person_name = 2

  message SetDisplayNameResponse

  persona_service.proto:51

  • SetDisplayNameResponse.Result result = 1

PersonaInfoService is for mobile to retrieve Personas by PersonaId or lookup PersonaIds by username Mobile calls for setting/updating Persona info are in PersonaService

• rpc GetPersonaShort (GetPersonaShortRequest, GetPersonaShortResponse)

  persona_info_service.proto:17

  message GetPersonaShortRequest

  persona_info_service.proto:24

  • repeated common.v2.PersonaId persona_ids = 1

  message GetPersonaShortResponse

  persona_info_service.proto:32

  • GetPersonaShortResponse.Result result = 1

  • repeated common.persona.v2.PersonaShort personas = 2

  • repeated common.v2.PersonaId not_found_ids = 3

    All the ids from the request that no Persona was found for, or the Persona is not visible to the caller

  • repeated common.v2.PersonaId failed_ids = 4

    All the ids from the request that hit an error on the server side Requesting them again may result in the server successfully returning them

• rpc GetPersonaFull (GetPersonaFullRequest, GetPersonaFullResponse)

  persona_info_service.proto:19

  message GetPersonaFullRequest

  persona_info_service.proto:57

  • repeated common.v2.PersonaId persona_ids = 1

  message GetPersonaFullResponse

  persona_info_service.proto:65

  • GetPersonaFullResponse.Result result = 1

  • repeated common.persona.v2.PersonaFull personas = 2

    All the PersonaFull that were found for the requested ids

  • repeated common.v2.PersonaId not_found_ids = 3

    All the ids from the request that no Persona was found for Shouldn't happen if you're using valid PersonaId

  • repeated common.v2.PersonaId failed_ids = 4

    All the ids from the request that hit an error on the server side Requesting them again may result in the server successfully returning them

• rpc GetPersonaFullByUsername (GetPersonaFullByUsernameRequest, GetPersonaFullByUsernameResponse)

  persona_info_service.proto:21

  message GetPersonaFullByUsernameRequest

  persona_info_service.proto:92

  • optional common.v2.Username username = 1

  message GetPersonaFullByUsernameResponse

  persona_info_service.proto:98

  • GetPersonaFullByUsernameResponse.Result result = 1

  • optional common.persona.v2.PersonaFull persona = 2

    persona is only returned if result == OK

Used in: GetPersonaFullByUsernameResponse

• OK = 0

• NOT_FOUND = 1

  This result is also returned if the rate limit has been reached

Used in: GetPersonaFullResponse

• OK = 0

Used in: GetPersonaShortResponse

• OK = 0

Currently the only name format supported is first and optional last, but we may support other name formats in the future

Used in: SetDisplayNameRequest

• string first_name = 1

  These first_name, last_name specifications match v1/user_info_shared.proto If any first name or last name is allowed that would be rejected by that protobuf then calls to UserInfo will fail.

• string last_name = 2

Used in: SetDisplayNameResponse

• OK = 0

• NOT_FOUND = 1

• NOT_MODIFIABLE = 2

  Some Personas cannot be changed even by their owner, e.g. AliasJid Personas cannot be modified directly because they just map back to the Genesis Persona. Instead the Genesis Persona should be modified directly via its PersonaId.

• FIRST_NAME_INVALID = 3

  I don't think we need these codes for now because the only name validation done currently is extra length checking in AccountUtils.isNameValid and the byte length restrictions in here are already more restrictive. However I could see us doing more validation in the future; in fact I'm surprised we don't already check against banned words/phrases or reject URLs

• LAST_NAME_INVALID = 4