User Profile

`user_profile_get_blinded_msgreqs`

Returns true if blinded message requests should be retrieved (from SOGS servers), false if they should be ignored.

Declaration

INT user_profile_get_blinded_msgreqs(
    [in]    const config_object*    conf
);

Parameters

conf — [in] Pointer to the config object

Returns

int — Will be -1 if the config does not have the value explicitly set, 0 if the setting is explicitly disabled, and 1 if the setting is explicitly enabled.

`user_profile_get_name`

Returns a pointer to the currently-set name (null-terminated), or NULL if there is no name at all. Should be copied right away as the pointer may not remain valid beyond other API calls.

Declaration

CONST CHAR* user_profile_get_name(
    [in]    const config_object*    conf
);

Parameters

conf — [in] Pointer to the config object

Returns

char* — Pointer to the currently-set name as a null-terminated string, or NULL if there is no name

`user_profile_get_nts_expiry`

Gets the Note-to-self message expiry timer (seconds). Returns 0 if not set.

Declaration

INT user_profile_get_nts_expiry(
    [in]    const config_object*    conf
);

Parameters

conf — [in] Pointer to the config object

Returns

int — Returns the expiry timer in seconds. Returns 0 if not set

`user_profile_get_nts_priority`

Gets the current note-to-self priority level. Will be negative for hidden, 0 for unpinned, and > 0 for pinned (with higher value = higher priority).

Declaration

INT user_profile_get_nts_priority(
    [in]    const config_object*    conf
);

Parameters

conf — [in] Pointer to the config object

Returns

int — Returns the priority level

`user_profile_get_pic`

Obtains the current profile pic. The pointers in the returned struct will be NULL if a profile pic is not currently set, and otherwise should be copied right away (they will not be valid beyond other API calls on this config object). The returned value will be the latest profile pic between when the user last set their profile and when it was last re-uploaded.

Declaration

USER_PROFILE_PIC user_profile_get_pic(
    [in]    const config_object*    conf
);

Parameters

conf — [in] Pointer to the config object

Returns

user_profile_pic — Pointer to the currently-set profile pic

`user_profile_get_profile_updated`

Returns the timestamp that the user last updated their profile information; or 0 if it's never been updated. This value will return the latest timestamp between when the user last set their profile and when it was last re-uploaded.

Declaration

LIBSESSION_EXPORT int64_t user_profile_get_profile_updated(config_object* conf);

Parameters

This endpoint takes no inputs.

Returns

int64_t - timestamp (unix seconds) that the user last updated their public profile information. Will be 0 if it's never been updated.

`user_profile_init`

Constructs a user profile config object and sets a pointer to it in conf.

When done with the object the config_object must be destroyed by passing the pointer to config_free() (in session/config/base.h).

Declaration

INT user_profile_init(
    [out]   config_object**         conf,
    [in]    const unsigned char*    ed25519_secretkey,
    [in]    const unsigned char*    dump,
    [in]    size_t                  dumplen,
    [out]   char*                   error
);

Parameters

conf — [in] Pointer to the config object
ed25519_secretkey — [in] must be the 32-byte secret key seed value. (You can also pass the pointer to the beginning of the 64-byte value libsodium calls the "secret key" as the first 32 bytes of that are the seed). This field cannot be null.
dump — [in] if non-NULL this restores the state from the dumped byte string produced by a past instantiation's call to dump(). To construct a new, empty profile this should be NULL.
dumplen — [in] the length of dump when restoring from a dump, or 0 when dump is NULL.
error — [out] the pointer to a buffer in which we will write an error string if an error occurs; error messages are discarded if this is given as NULL. If non-NULL this must be a buffer of at least 256 bytes.

Returns

int — Returns 0 on success; returns a non-zero error code and write the exception message as a C-string into error (if not NULL) on failure.

`user_profile_set_blinded_msgreqs`

Sets whether blinded message requests should be retrieved from SOGS servers. Set to 1 (or any positive value) to enable; 0 to disable; and -1 to clear the setting.

Declaration

VOID user_profile_set_blinded_msgreqs(
    [in]    config_object*      conf,
    [in]    int                 enabled
);

Parameters

conf — [in] Pointer to the config object
enabled — [in] true if they should be enabled, false if disabled

Returns

void — Returns Nothing

`user_profile_set_name`

Sets the user profile name to the null-terminated C string. Returns 0 on success, non-zero on error (and sets the config_object's error string).

Declaration

INT user_profile_set_name(
    [in]    config_object*  conf,
    [in]    const char*     name
);

Parameters

conf — [in] Pointer to the config object
name — [in] Pointer to the name as a null-terminated C string

Returns

int — Returns 0 on success, non-zero on error

`user_profile_set_nts_expiry`

Sets the Note-to-self message expiry timer (seconds). Setting 0 (or negative) will clear the current timer.

Declaration

VOID user_profile_set_nts_expiry(
    [in]    config_object*      conf,
    [in]    int                 expiry
);

Parameters

conf — [in] Pointer to the config object
expiry — [in] Integer of the expiry timer in seconds

Returns

`user_profile_set_nts_priority`

Sets the current note-to-self priority level. Set to -1 for hidden; 0 for unpinned, and > 0 for higher priority in the conversation list.

Declaration

VOID user_profile_set_nts_priority(
    [in]    config_object*      conf,
    [in]    int                 priority
);

Parameters

conf — [in] Pointer to the config object
priority — [in] Integer of the priority

Returns

void — Returns Nothing

`user_profile_set_pic`

Sets a user profile pic

Declaration

INT user_profile_set_pic(
    [in]    config_object*      conf,
    [in]    user_profile_pic    pic
);

Parameters

conf — [in] Pointer to the config object
pic — [in] Pointer to the pic

Returns

int — Returns 0 on success, non-zero on error

`user_profile_set_reupload_pic`

Sets a user profile pic when reuploading

Declaration

INT user_profile_set_reupload_pic(
    [in]    config_object*      conf,
    [in]    user_profile_pic    pic
);

Parameters

conf — [in] Pointer to the config object
pic — [in] Pointer to the pic

Returns

int — Returns 0 on success, non-zero on error