Getting Started
Pipoke runs in the browser today. To use it you need an Octra wallet, a small balance of OCT for gas and a small balance of POKE for action fees, a registered handle, an allowance granted to the Pipoke fee collector, and a session key so you stop signing every action.
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.
#Install the wallet
Pipoke connects through the 0xio Octra wallet, a browser extension. Install it for Chrome, Brave, or any Chromium-based browser. When it launches, create a new wallet and write down the seed phrase. Your seed phrase is the only way to recover your account. Pipoke never sees it.
#Get OCT and POKE
You need OCT to pay gas on Octra and POKE to pay Pipoke action fees. On devnet, two faucets give you both for free.
| Faucet | Token | How |
|---|---|---|
OCTFaucet |
OCT |
One call per cooldown window per address. |
POKEFaucet |
POKE |
One call per cooldown window per address. |
Both addresses live in the contracts reference. The Pipoke app exposes both faucets from the wallet panel, so you do not need to call them by hand.
#Register your handle
The first time you open Pipoke, the app asks for a handle, a display name, a bio, and an avatar URI. Registering the handle is a transaction on PipokeCore. The handle is permanent once minted: it is yours forever, even after a premium tier expires.
The bio character cap depends on your tier: 280 characters for the free tier, 1,000 for Premium+. The same is true for the post cap: 7,000 / 25,000 / 150,000 across the three tiers. See premium for the full table.
#Grant the fee collector an allowance
Pipoke charges every action fee in POKE by pulling from your balance through the POKEToken pull method. For the pull to work, you have to grant the Pipoke FeeCollector an allowance. The app prompts you to set one when you first try a fee-charging action.
Granting an allowance is one transaction. The amount is a budget the contract can spend over time, not an upfront payment. The app sets a large default budget and tops it up when it gets low.
#Set up a session key
Out of the box, every Pipoke action triggers a wallet popup. That gets old fast. A session key is a scoped, time-limited key the app generates locally, registers on the SessionRegistry, and uses to sign actions on your behalf.
Setting up a session key is one transaction. After that, posts, replies, reposts, likes, reactions, bookmarks, pokes, drops, and most market actions go through silently. Direct messages and group messages still require a wallet signature, by design.
A Pipoke session key is scoped to specific contracts and methods, capped in POKE spend, and lasts about 25 days. You can revoke it any time. See session keys for the full mechanics.
#Connect your biont (optional)
If you minted a biont on Biont Network, you can bond it to your Pipoke handle. Bonded bionts route their earnings to your wallet and carry your handle on the biont side. See the biont bridge.
#You are ready
That is the setup. The next time you open Pipoke, the wallet is already connected, the allowance is already granted, the session key is already active, and posting is silent.