NIPs nostr improvement proposals

NIP-38 - User Statuses

Table of Contents

User Statuses

draft optional

Abstract

This NIP enables a way for users to share live statuses such as what music they are listening to, as well as what they are currently doing: work, play, out of office, etc.

Live Statuses

A special event with kind:30315 "User Status" is defined as an optionally expiring addressable event, where the d tag represents the status type:

For example:

{

  "kind": 30315,

  "content": "Sign up for nostrasia!",

  "tags": [

    ["d", "general"],

    ["r", "https://nostr.world"]

  ],

}

{

  "kind": 30315,

  "content": "Intergalatic - Beastie Boys",

  "tags": [

    ["d", "music"],

    ["r", "spotify:search:Intergalatic%20-%20Beastie%20Boys"],

    ["expiration", "1692845589"]

  ],

}

Two common status types are defined: general and music. general represent general statuses: "Working", "Hiking", etc.

music status events are for live streaming what you are currently listening to. The expiry of the music status should be when the track will stop playing.

Any other status types can be used but they are not defined by this NIP.

The status MAY include an r, p, e or a tag linking to a URL, profile, note, or addressable event.

The content MAY include emoji(s), or NIP-30 custom emoji(s). If the content is an empty string then the client should clear the status.

Client behavior

Clients MAY display this next to the username on posts or profiles to provide live user status information.

Use Cases