Getting Started

Getting onto Pipoke takes four steps: connect a wallet, register a handle, get some $POKE, and grant the allowance that lets the feed charge action fees. After that you can post.

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.

#1. Connect a wallet

PipokeOS, the Pipoke app, runs in the browser and talks to Octra through the 0xio wallet. Install the 0xio wallet extension, open PipokeOS, and click Connect. It reads your address and balance and shows whether you already have a profile.

An in-app embedded wallet (key custody inside Pipoke, no external extension needed) is on the roadmap. It is not live today, so the 0xio extension is required for now.

#2. Register a handle

Your Pipoke identity is a handle attached to your wallet. Register it through PipokeCore.

PipokeCore.register_profile(handle, bio, avatar)

Argument	What it is
handle	Your unique @name. Must not already be taken.
bio	A short profile description.
avatar	An avatar URI.

Registering does three things in one call: it claims the handle, stores your bio and avatar, and assigns you to a feed shard so the feed knows where your posts live. It charges a registration fee in POKE.

A handle can be empty at registration and set later with set_display_name. Handles are unique. The contract reverts if the one you picked is already held by another wallet.

#3. Claim starter POKE from the faucet

Every action on Pipoke costs a POKE fee, so you need a balance to begin. The POKEFaucet hands out a fixed drip per claim.

POKEFaucet.claim()

The faucet pays a drip amount and then enforces a cooldown of 23,328 epochs before the same wallet can claim again. On devnet the faucet runs in whitelist mode, so a wallet has to be whitelisted by the faucet owner before its first claim. The app surfaces can_claim(addr) and time_until_claim(addr) so you know when you are eligible.

#4. Grant a POKE spending allowance

$POKE is an OCS-01 token. Pipoke's fee collector cannot pull POKE from your wallet unless you have granted it an allowance first. This is a one-time approval.

POKEToken.grant(spender, amount)

Grant the allowance to the fee-charging contracts so posts, replies, likes, and the rest can deduct their fees. The app handles the exact spender addresses for you. Grant enough to cover a stretch of activity. You can re-grant at any time to top the allowance back up.

When you set up session keys for silent posting, the same wallet popup that registers the session key also sets this allowance, so step 4 folds into that flow.

#You are ready

Once your handle is registered, your faucet POKE has landed, and the allowance is set, you can post. Head to Posting and the feed. To skip a wallet prompt on every feed action, set up a session key.