How to actually use Pipoke.
Every shipped feature, step by step. Numbered markers point at the actual button in the actual UI. Start with sign-in, then set up your identity. The rest works in any order. Use the rail on the left to jump.
Sign in and pick a handle.
Four-step onboarding wires your wallet, approves a one-time POKE allowance, and registers your handle. You land on the feed after.
- 1Open
dev.pipoke.chat. The page shows one button, Connect 0xio Wallet. Click it. The 0xio extension pops to confirm. - 2You land on
/onboarding/connect(button reads Connected). Continue to/onboarding/grant. The card is titled Approve once, post forever. Click Approve POKE allowance and sign. - 3On
/onboarding/register, pick a handle (2 to 24 chars,a-z 0-9 _) and an optional bio. Click Register profile and confirm. - 4On
/onboarding/done: You are in. Click Skip to the feed or Take the quick tour. - 5Before you post, go to Settings and set up your session key and anon identity (next chapter).
Set up the session key and anon identity.
Session key skips popups for posts and likes. Anon identity registers your Poseidon commitment so you become ELIGIBLE. Anon bidder is a separate keypair for sealed auction bids. All in /settings.
- 1Go to
/settings. Find the Session key card (header SILENT POSTING). Click Enable silent posting and sign once. The card flips to show session address, expires at epoch, and protocol gas (OCT). - 2Top up gas: type an OCT amount or click a preset (
1,5,10,50), then Top up. Footer reads: *One OCT covers ~12,500 silent posts at 0.000080 OCT each.* Buttons Extend expiry and Revoke sit below. - 3Scroll to Anon identity. Your Poseidon commitment generates locally. Click Reveal under BACKUP and save the 44-char string somewhere safe. Anyone holding it can post as your anon identity. Treat it like a password.
- 4Watch the Identity activation card. Status flips to ELIGIBLE (green) once your commitment lands in a published root. You see LATEST ROOT version, YOUR LEAF index, and a QUEUE counter. Roots roll every ~30s.
- 5Below that, set up Anon bidder identity. A separate keypair derived from a wallet signature, used only for anonymous auction bids. Click Back up to circle or Restore to sync across devices.
Claim free POKE and OCT.
New wallets need POKE for actions and OCT for session-key gas. The faucet drips both. Claim once per cooldown window.
- 1Go to
/faucet. Two cards: POKE faucet and OCT faucet. - 2Click Claim POKE. The wallet pops; sign. The card shows the next claim window.
- 3Click Claim OCT. Sign. OCT lands in your wallet; route it to your session key from Settings → Session key → Top up.
- 4Cooldown shows live (next claim in
Xh Ym). Come back daily to top up. - 5Mainnet: faucets disappear. You get POKE from engagement and launches, OCT from the bridge.
Post to the feed.
The composer mounts inline at the top of the feed. Text by default, with three pills below for Photo/Video, Voice, and Video. The send button reads broadcast.
- 1On
/, click + to open the composer (it sits inline at the top of the feed). - 2Placeholder reads What is happening on Octra?. Format with Cmd+B and Cmd+I; mention with
@handle. - 3Three pills sit below the textarea: Photo/Video (green), Voice (yellow), Video (red, needs a funded session key). Pick one to attach or record.
- 4Char counter sits bottom-right. Limit depends on your premium tier (500 regular, 1,000 Premium, higher Premium+). Toolbar above the textarea: emoji, format, handle autocomplete.
- 5Click broadcast. The button cycles to broadcasting… then a toast confirms broadcasted. Your post lands at the top.
just deployed a new launch via the wizard. one signature, one minute, 1,000 POKE.
reminder that every poke, every like, every comment is a tx. read that again.
voice note posted from the train. circles holds the audio, the feed holds the URI.
React, repost, quote, bookmark.
On a post detail page you get 16-emoji reactions, repost (boost) versus quote (with comment), bookmark, and pin-to-profile.
- 1Click any post to open
/p/[id](full detail). - 2Reactions row: tap the smiley, pick one of 16 emoji. Your reaction stamps with your handle.
- 3Repost icon boosts as-is. Long-press or open the menu for Quote to attach your comment.
- 4Bookmark icon saves to your bookmarks tab on
/u/{me}(private to you). - 5Pin icon (own posts only) pins to the top of your profile.
every poke, every like, every comment is a tx. read that again.
Post a story or video drop.
Stories are 24h ephemeral. Video drops are short-form clips. Both live on the feed strip above the timeline.
- 1On
/, look at the stories strip at the top. Your avatar shows + Story. - 2Click + Story, record or upload. Pick TTL (default 24h) and privacy (public, followers, mutuals).
- 3Click post story. The strip refreshes with your avatar at the front.
- 4For a video drop: open the composer, click the Video pill, record up to the clip-length limit, then click broadcast.
- 5Viewers tap your avatar in the strip. StoryViewer opens with reactions and skip controls.
Send POKE as a tip.
Pokes are POKE tips you send to a post or a profile. The recipient gets a notification; the tip log lives on the profile patronage panel.
- 1On any post, tap the poke icon in the action row. PokeSheet slides in.
- 2Pick an amount (presets: 10 / 50 / 100 / 500 POKE) or type a custom number.
- 3Add an optional message. Click Poke.
- 4On a profile (
/u/{handle}), use the Tip button on the hero. Same sheet. - 5Recipient sees the poke in
/notificationsand on the Patronage strip on their profile.
Edit, delete, or promote a post.
On your own posts: the More menu carries Edit, Delete, and Promote. Promote pays a POKE fee to surface the post higher in feeds.
- 1On your own post, click the ⋯ (More) icon.
- 2Pick Edit post. EditPostModal opens; change text or media, click Save.
- 3Or pick Delete post. Confirm. The post is removed (the chain receipt stays).
- 4Or pick Promote. PromoteSheet opens. Pick duration and POKE budget. Promoted posts get the orange stripe + boost.
- 5Use Schedule on the composer (clock icon) to queue a post for a future epoch instead of broadcasting now.
Discover trending, people, coins.
Explore surfaces what is hot: trending topics, promoted posts, top fee collectors, and a search for handles.
- 1Go to
/explore. At the top: a search input. Type @handle or a topic. - 2Scroll: Trending (posts climbing), Promoted (paid surface), Top fee collectors (wallets routing the most POKE).
- 3Click any trending row to land on the post or community.
- 4Use the Markets strip at the bottom of Explore to jump straight into freshly launched coins.
- 5Add to following directly from any profile card with + Follow.
Follow, unfollow, see mutuals.
Follows are on-chain. The Mutual followers strip surfaces overlap. Follower-only channels gate posts behind a follow.
- 1Open any profile at
/u/{handle}. Hit Follow on the hero. - 2The Mutuals strip shows mutual followers between you and them.
- 3On your own profile, Following tab lists everyone you follow. Followers tab does the reverse.
- 4To unfollow: tap the Following button. It flips to Unfollow on hover.
- 5Posts marked followers-only are sealed. Only your followers can decrypt them.
Read notifications.
Replies, reposts, reactions, pokes, follows, DMs, group invites. Polls every ~10s. Unread badge sits on the nav item.
- 1Go to
/notifications. List groups by Today, Yesterday, Earlier. - 2Each row shows the actor avatar, the action (reposted, poked, replied), and a preview.
- 3Click a row to land on the source post, profile, or DM.
- 4Click Mark all read in the header to clear the badge.
- 5Filter chips at the top: All · Replies · Reposts · Pokes · Follows · DMs.
Send a sealed DM.
X25519 end-to-end. Each DM costs 0.1 POKE. Session key handles sends after a first encryption-seed signature. Attachments need >= 1 OCT on the session key.
- 1Go to
/dm. The header has a New button (Plus icon). It opens NewChatModal (Find a wallet to message). - 2Type @handle or paste an
octaddress. Click a result to land on/dm/{wallet}. - 3Thread header shows the recipient and an end-to-end encrypted badge (animated lock).
- 4First send only: the wallet pops to sign the encryption seed (cached in memory). After that, the session key sends silently.
- 5Composer placeholder: encrypted to wallet only…. Attach via paperclip (>= 1 OCT session key), record voice or video, click Send. Fee 0.1 POKE per message.
Create an encrypted group.
Multi-party encrypted chat. NaCl group key sealed once per member. Admins can rekey, kick, add, change threshold.
- 1Go to
/groups. Click + Create group in the header. - 2Name the group, add members (handles or addresses), pick an icon. Click Create.
- 3In the thread: composer placeholder reads send to {N} members. Each send seals to every member.
- 4Open the members sheet (top-right icon). Admins see Rekey (rotate key after removing someone), Kick, Promote to admin, and Change threshold.
- 5When a member is removed, the next message triggers an automatic rekey so the kicked address cannot read further plaintext.
Post anonymously.
Your anon identity is already registered (chapter 2). Now use it. A Groth16 proof generates in your browser before submit.
- 1Go to
/anon. AnonComposer mounts with your AnonIdenticon. Status reads ready. If it still reads almost ready, wait for the next root publish. - 2Type into the textarea. Placeholders rotate: tell on yourself., drop a take you wouldn't sign., say the part you keep quiet.
- 3Optional: attach a URI via attach a link · optional, or post to a community via the community chip (
c/{id}). - 4Click drop. The button cycles to sealing… while the Groth16 proof generates (preparing, proving, submitting).
- 5Toast: sealed · nobody knows you sent that. Your post lands on the anon feed under your nullifier slice.
Lock posts to followers or mutuals.
Followers-only posts seal with a channel key. Only your followers (or mutuals) hold the key, so only they can decrypt.
- 1In Settings, open the Follower channels card. Click Generate channel key and sign.
- 2In the composer, click the Privacy chip below the textarea. Pick public, followers, or mutuals.
- 3Type your post and broadcast as usual. The chain stores ciphertext and a key reference.
- 4Followers see the post normally. Your client unseals it client-side using their stored key share.
- 5To rotate after blocking someone: Settings → Follower channels → Rekey. New posts use the new key; old ones stay readable to whoever already saw them.
Launch a coin.
LaunchCoinWizard runs three onchain steps: deploy, approve POKE, register. Launch fee is 1,000 POKE.
- 1Go to
/markets. Click the Rocket button in the page header to open the wizard. - 2Step collect: type a ticker (2 to 16 chars, A-Z 0-9), a name (<= 64 chars), and upload an image. Click Launch.
- 3The wizard runs deploy contract, approve POKE, register coin in order. Each step shows its own spinner row.
- 4The done card shows your coin. Click View coin to land on
/markets/coin/[address]with chart, trade panel, and per-coin channel. - 5Share it: paste the coin URL in a post to render a live coin embed in feed.
Trade and manage holdings.
On a coin page you buy or sell against the bonding curve. Your holdings live in the Wallet tab; transfer them or sell back.
- 1Open any coin at
/markets/coin/[address]. The trade panel sits on the right. - 2Toggle Buy or Sell. Type an amount in POKE or token. Presets: 25% / 50% / MAX.
- 3Click Place trade. The session key signs silently. The quote shows price impact and min received.
- 4In
/wallet(Balance tab), the Holdings card lists every coin you own with live PnL. - 5Tap a row for Transfer (send to another wallet) or Sell (back to the curve). HoldingTransferModal handles the send.
Run your wallet dashboard.
/wallet has four tabs: Balance, Earnings, Activity, Premium. Balance shows POKE and OCT plus holdings. Earnings tracks fees in. Activity is your tx log.
- 1Go to
/wallet. Tabs: Balance · Earnings · Activity · Premium. - 2Balance: big POKE and OCT numbers, holdings list, yield drip, Send POKE card (paste address, amount, Send).
- 3Earnings: window selector with 24h / 7d / 30d / all. Bars show daily earnings split by source: engagement, launches, royalties.
- 4Activity: every tx (posts, trades, claims, votes), each linked to its onchain receipt.
- 5Premium: status card with Subscribe or Renew or upgrade (see next chapter).
Open an auction. Bid sealed.
CreateAuctionModal is a three-step wizard. Bid pages adapt to type. English shows Place bid. Sealed-bid splits Commit bid, Reveal bid, Settle auction.
- 1Go to
/auctions. Click the Gavel button in the header to open CreateAuctionModal. - 21 / 3 · what: item type. digital (upload file), biont (pick a soul), or token (paste collection + token id).
- 32 / 3 · terms: English or sealed-bid, min bid, duration (1h, 6h, 24h, 3d, 7d), reveal window (sealed only), bidder kind public or anon.
- 43 / 3 · review: confirm and click Create auction. Done card: View auction or Share in a post.
- 5On a live auction
/auctions/[id]: English shows Place bid. Sealed-bid shows Commit bid during commit, Reveal bid during reveal, then Settle auction.
Host or join a room.
One hub at /rooms. Filter chips: All, Drops, Communities, Backroom. Two entry buttons sit on the hero: go live (Drops) and open backroom.
- 1Open
/rooms. Filter chips at the top: All · Drops · Communities · Backroom. - 2Host a Drop: click go live in the top-right. DropPreStream wizard walks identify, categorize, capture, monetize. Click start stream.
- 3Join a Community Room: filter Communities, click any card. You land on
/rooms/community/[id]. Listener by default; raise your hand to speak. - 4Host a Backroom: click open backroom top-right. You land on
/rooms/backrooms/new. The frontend derives your anon identity + nullifier silently. - 5Join a Backroom: filter Backroom, click any live · anon card. Your identity stays masked behind a nullifier slice.
Play Crash (house + PvP).
Multiplier climbs; busts at random. Cash out before bust to lock in. House mode plays against the contract; PvP mode plays head-to-head.
- 1Go to
/games/crash. The stage shows the live multiplier and a phase pill: Betting, Running, or Crashed. - 2During Betting, enter a POKE amount and an optional auto cashout multiplier. Click Place bet.
- 3When Running, click the big CASH OUT button (or press Space) to lock in.
- 4For PvP head-to-head: open the PvP tab in the lobby, accept an open match, or Create match (set wager + room).
- 5After Crashed, the round payout posts. The onchain seed is public; anyone can re-derive the round to verify.
Play Texas Hold'em.
Cash tables and multi-table tournaments. Sealed cards via commit-reveal. The lobby lists live tables and registering tournaments.
- 1Go to
/games/poker. The lobby shows Live tables and Tournaments. - 2Click a cash table row to take a seat.
- 3Or click Register · {buy-in} POKE on a tournament card.
- 4Table UI: oval seat ring, your hole cards, action bar at the bottom (Fold, Check, Call, Raise, All-in). Bet slider for raise.
- 5Turn timer 60s. After showdown the cards decrypt; the chain log proves the deal was honest.
Wager a Poke Duel.
Rock-paper-scissors duel over commit-reveal. Wager a POKE amount; winner takes the pot.
- 1Go to
/games/duel. The lobby lists Open challenges and My duels. - 2Accept an open challenge, or click + Challenge to set wager + opponent (handle or address).
- 3Pick your move: Rock, Paper, or Scissors. The frontend commits a hash of your pick.
- 4After both commit, the reveal phase opens. Your pick auto-reveals. Winner takes the pot.
- 5Duel history shows on your profile under the Plays strip.
Join a community.
Communities at /communities are the hub. Each one has its own /c/[id] with 15 tabs. Some are open join, some require approval.
- 1Go to
/communities. Tabs: Joined · Discover · My applications. - 2On Discover, browse cards by category. Each card shows member count, recent posts, and join policy.
- 3Click Join for open communities, or Apply for gated ones (the form takes a short application).
- 4After joining, you land on
/c/[id]with 15 tabs: feed, pinned, members, about, rules, tournaments, crash, proposals, applications, modqueue, automod, appeals, modlog, bonds, settings. - 5Use the feed tab as your community-specific timeline. The composer auto-tags posts with the community.
Run a proposal. Vote. Execute.
The Proposals tab carries 9 kinds: SPEND, ADMIN_ADD, ADMIN_REMOVE, CAP, UNPAUSE, UNBAN, MEMBER_REMOVE, CREATOR_XFER, THRESHOLD. Admins propose; members veto. 48h timelock.
- 1On
/c/[id], open the proposals tab. The admin Treasury panel shows propose spend · admin. - 2Fill amount (POKE) and recipient. Click propose. ReasonComposer pops for an optional purpose; submit.
- 3Toast: spend proposal opened, with
awaiting N more admin confirmation(s) + 48h timelock. - 4Pending cards show kind badge, status pill, proposal id, and timelock countdown. Click into a card.
- 5On a proposal detail page: admins use Confirm or Veto. Member-vote kinds show For, Against, Abstain. After timelock, anyone clicks Execute.
Moderate with bonds and appeals.
Mod actions (MUTE, SHADOW, BAN, LOCK_POST) require a POKE bond. Affected users can appeal. If upheld the bond returns, if overturned it slashes 25%.
- 1On
/c/[id], open modqueue. Each row shows a flagged post and action options. - 2Pick Mute · 24h, Shadow, Ban, or Lock post. Confirm. The POKE bond locks in the community contract.
- 3The affected user sees the action in their notifications with an Appeal button. Tapping it opens the appeal form (text plus optional evidence).
- 4In appeals, members vote Uphold or Overturn. If overturned, 25% of the mod's bond slashes.
- 5The full action history lives in modlog (public, on-chain receipts). Use automod to set keyword and new-account rules.
Claim from the Engagement Vault.
A slice of every Pipoke action fee flows into the vault. Each period publishes a Merkle root. Multi-period claim runs through ClaimWizard.
- 1Go to
/vault. The header reads Vault. The section below lists distribution periods. - 2Each row shows period id, status (finalized, open, swept), total POKE, sweep countdown.
- 3Click a finalized row (or its Claim button) to open ClaimWizard.
- 4Tick one or more periods. Click Claim engagement to submit one combined claim.
- 5After the tx confirms you see your claimed amount and the affected periods. Unclaimed periods auto-sweep at the
sweep_afterepoch.
See who is winning.
Leaderboard ranks wallets by engagement metrics: POKE earned, pokes received, launches, reactions in. Filters by window.
- 1Go to
/leaderboard. Filter chips: 24h · 7d · 30d · all-time. - 2Columns: rank, handle, POKE earned, pokes received, posts, reactions in.
- 3Click any row to land on the profile.
- 4Your own row sits highlighted with your live rank.
- 5Switch the metric dropdown to rank by a different axis (for example, most-poked posts).
Edit your profile and page theme.
Edit profile lives behind an Edit3 button on your hero. The Edit dialog has tabs for picture, handle, bio, page (markdown), gallery (12 pins), and theme.
- 1Open your profile at
/u/{your-wallet}. Click Edit profile on the hero. - 2Dialog tabs: Profile picture (upload or pick bonded biont), Handle, Bio, Page (markdown), Gallery (12 image pins), Page theme (colour swatches).
- 3Each field shows its own POKE fee. The bottom row shows total cost.
- 4Click Save · {totalFee} POKE. Toast: Profile updated.
- 5The hero gradient re-paints from your avatar dominant color. Page theme applies to your markdown page tab.
Bond a biont.
A both-chain ritual at /bond. One blue Bond button runs both signatures in order: biont side (set_bond), then Pipoke side (link). One biont per wallet.
- 1Go to
/bond. If you own no liberated bionts: No liberated bionts. Otherwise each biont renders as a card with archetype, reputation, tier, and a state badge. - 2On an unbonded card, click the blue Bond button. Toast: Step 1/2 · biont side · Signing set_bond on the biont chain.
- 3After the biont-side tx confirms, toast: Step 2/2 · pipoke side · Linking your handle to the biont. Sign the second tx.
- 4Final toast: Bonded @{handle} ↔ {biont name}. State badge flips to bonded.
- 5Recovery: if half-bonded, click Complete link (or Complete unbond on the unbond path). To unbond later, click Unbond on a bonded card. Same two-step pattern.
Open Pipoke and try it.
Pipoke is live on Octra Devnet today. Pick any walkthrough above, follow the numbered steps, and you will have run it inside a minute.