Reactions, Bookmarks, and Pins

A reaction is an emoji you put on a post. A bookmark is a private save. A pin is the one post you anchor on your profile. All three are signed transactions on PipokeEngagementShard. The shard counts them, the indexer aggregates them, and the engagement-reward computation weighs them.

Pipoke runs on Octra Devnet today. Any fee, price, or limit referred to here is a contract setting chosen for testing. Every one is owner-settable, and mainnet values will be different. These docs describe how the mechanics work, not what the numbers are.

#Reactions

Pipoke supports 16 reaction kinds, numbered 1 through 16. The app maps each number to an emoji. A wallet can react to a post once, with one kind, at a time. Switching reactions calls unreact first, then react again.

Method	Signature
`react`	`react(post_id, kind, principal)`
`unreact`	`unreact(post_id, kind, principal)`

kind is an integer in [1, 16]. The shard rejects values outside that range. Idempotency is enforced per (post_id, wallet, kind): calling react twice with the same kind is a no-op (the second call reverts as already-reacted).

Reactions feed the engagement-reward pot. Reacting to a post increases the recipient's chance of winning a slice of the next reward period, weighted by the reactor's premium tier.

#Bookmarks

A bookmark is a private save on a post. The save is on-chain (so it survives device wipes), but the app only surfaces your bookmarks on your own bookmark tab. The post's author is not notified.

Method	Signature
`bookmark`	`bookmark(post_id, principal)`
`unbookmark`	`unbookmark(post_id, principal)`

#Pins

A pin is the one post you anchor on your profile. The pinned post shows above your latest post on your profile view.

Method	Signature
`pin`	`pin(post_id, principal)`
`unpin`	`unpin(principal)`

Pinning a new post replaces the previous pin. There is no second pin slot.

#Action fees

Action	Fee
React	Small `POKE` fee. Split 50/40/10.
Unreact	Free.
Bookmark	Small `POKE` fee.
Unbookmark	Free.
Pin	Small `POKE` fee.
Unpin	Free.

The undo is always free so users can clean up cheaply.

#Session-keyed