social state

PostID

NOTE: a PostID is relative to the userPosts.

Reaction

Reaction is for the "enum" of ways to react to a post

Gnod

MaxReaction

Post

A Post is a "thread" or a "reply" depending on context. A thread is a Post of a UserPosts that holds other replies. This is similar to boards.Post except that this doesn't have a title.

newPost

validateReaction

getPosts

UserAndPostID

PostMessage

Post a message to the caller's main user posts. The caller must already be registered with /r/gnoland/users/v1 Register. Return the "thread ID" of the new post. (This is similar to boards.CreateThread, but no message title)

PostReply

Post a reply to the user posts of userPostsAddr where threadid is the ID returned by the original call to PostMessage. If postid == threadid then create another top-level post for the threadid, otherwise post a reply to the postid "sub reply". The caller must already be registered with /r/gnoland/users/v1 Register. Return the new post ID. (This is similar to boards.CreateReply.)

RepostThread

Repost the message from the user posts of userPostsAddr where threadid is the ID returned by the original call to PostMessage. This must be a top-level thread (not a reply). Return the new post ID. (This is similar to boards.CreateRepost.)

GetJsonTopPostsByID

For each address/PostID in addrAndIDs, get the thread post. The Post ID must be for a a top-level thread (not a reply; to get reply posts, use GetThreadPosts). If the Post ID is not found, set the result for that Post ID to {}. The response is a JSON string.

GetThreadPosts

Get posts in a thread for a user. A thread is the sequence of posts without replies. While each post has an an arbitrary id, it also has an index within the thread starting from 0. Limit the response to posts from startIndex up to (not including) endIndex within the thread. If you just want the total count, set startIndex and endIndex to 0 and see the response "n\_threads". If threadID is 0 then return the user's top-level posts. (Like render args "user".) If threadID is X and replyID is 0, then return the posts (without replies) in that thread. (Like render args "user/2".) If threadID is X and replyID is Y, then return the posts in the thread starting with replyID. (Like render args "user/2/5".) The response includes reposts by this user (only if threadID is 0), but not messages of other users that are being followed. (See GetJsonHomePosts.) The response is a JSON string.

RefreshHomePosts

Update the home posts by scanning all posts from all followed users and adding the followed posts since the last call to RefreshHomePosts (or since started following the user). Return the new count of home posts. The result is something like "(12 int)".

GetHomePostsCount

Get the number of posts which GetJsonHomePosts will return. The result is something like "(12 int)". This returns the current count of the home posts (without need to pay gas). To include the latest followed posts, call RefreshHomePosts.

getHomePosts

Get home posts for a user, which are the user's top-level posts plus all posts of all users being followed. The response is a map of postID -> \*Post. The bptree.BPTree sorts by the post ID which is unique for every post and increases in time. This must not be exported. Another realm holding this pointer could mutate the tree (and the posts in it) with this realm's authority.

GetJsonHomePosts

Get home posts for a user, which are the user's top-level posts plus all posts of all users being followed. Limit the response to posts from startIndex up to (not including) endIndex within the home posts. If you just want the total count, use GetHomePostsCount. The response is a JSON string. This returns the current state of the home posts (without need to pay gas). To include the latest posts, call RefreshHomePosts.

Follow

Update the caller to follow the user with followedAddr. See UserPosts.follow.

Unfollow

Update the caller to unfollow the user with followedAddr. See UserPosts.unfollow.

AddReaction

Add the reaction by the caller to the post of userPostsAddr, where threadid is the ID returned by the original call to PostMessage. If postid == threadid then add the reaction to a top-level post for the threadid, otherwise add the reaction to the postid "sub reply". (This function's arguments are similar to PostReply.) The caller must already be registered with /r/gnoland/users/v1 Register. Return a boolean indicating whether the userAddr was added. See Post.addReaction.

RemoveReaction

Remove the reaction by the caller to the post of userPostsAddr, where threadid is the ID returned by the original call to PostMessage. If postid == threadid then remove the reaction from a top-level post for the threadid, otherwise remove the reaction from the postid "sub reply". (This function's arguments are similar to PostReply.) The caller must already be registered with /r/gnoland/users/v1 Register. Return a boolean indicating whether the userAddr was removed. See Post.removeReaction.

GetJsonUserByAddress

Call users.ResolveAddress and return the result as JSON, or "" if not found. (This is a temporary utility until gno.land supports returning structured data directly.)

GetJsonUserByName

Call users.ResolveName and return the result as JSON, or "" if not found. (This is a temporary utility until gno.land supports returning structured data directly.)

GetJsonUserPostsInfo

Get the UserPosts info for the user with the given address, including url, n\_threads, n\_followers and n\_following. If the user address is not found, return "". The name of this function has "Info" because it just returns the number of items, not the items themselves. To get the items, see GetJsonFollowers, etc. The response is a JSON string.

GetJsonFollowers

Get the UserPosts for the user with the given address, and return the list of followers. If the user address is not found, return "". Limit the response to entries from startIndex up to (not including) endIndex. The response is a JSON string.

GetJsonFollowing

Get the UserPosts for the user with the given address, and return the list of other users that this user is following. If the user address is not found, return "". Limit the response to entries from startIndex up to (not including) endIndex. The response is a JSON string.

ListUsersByPrefix

Get a list of user names starting from the given prefix. Limit the number of results to maxResults.

ListJsonUsersByPrefix

Get a list of user names starting from the given prefix. Limit the number of results to maxResults. The response is a JSON string.

resolveAddr

Render

gUserPostsByAddress

// user's address -> \*UserPosts

gUserAddressByName

// user's username -> address

postsCtr

// increments Post.id globally

gRealmPath

init.35

FollowingInfo

UserPosts

UserPosts is similar to boards.Board where each user has their own "board" for posts which come from the user. The list of posts is identified by the user's address . A user's "home feed" may contain other posts (from followed users, etc.) but this only has the top-level posts from the user (not replies to other user's posts).

newUserPosts

Create a new userPosts for the user. Panic if there is already a userPosts for the user.

getUserPosts

Get the UserPosts for the user.

getOrCreateUserPosts

Get the UserPosts for the userAddr. If not found, add a new UserPosts to gUserPostsByAddress and update gUserAddressByName with the username. (The caller usually has already called usernameOf to get the username, but if it is "" then this will get it.)

padZero

postIDKey

reactionKey

getOrCreateReactionValue

If reactions has an value for the given reaction, then return it. Otherwise, add the reaction key to reactions, set the value to an empty bptree.BPTree and return it.

listByteStringKeysByPrefix

listByteStringKeysByPrefix returns up to maxResults keys from tree that start with the given prefix, treating keys as byte strings (not Unicode runes). Inlined from gno.land/p/jefft0/avlhelpers which is not yet deployed.

indentBody

summaryOf

NOTE: length must be greater than 3.

displayAddressMD

usernameOf

marshalJsonUser

Return the User info as a JSON string. (This is a temporary utility until gno.land supports returning structured data directly.)