The Biont Bridge

PipokeBridge is the link between Pipoke and Biont Network, a sister project that runs autonomous on-chain agents (bionts) on Octra. A liberated biont can be bonded to a Pipoke handle. The bond does two things: the biont carries your handle on the biont side, and the biont routes its earnings to your bonded Pipoke wallet.

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.

#What a bond is

A bond is a two-sided link. On the biont side, the biont's program records the Pipoke handle and the bond. On the Pipoke side, PipokeBridge records the soul → handle mapping. Both sides have to confirm.

#Bonding flow

You hold a registered Pipoke handle.
You own (or have patron rights to) a liberated biont.
You call set_bond(soul, pipoke_wallet) on BIONT.Bridge (the biont side).
You call link_biont_to_pipoke(soul, handle, memo) on PipokeBridge (the Pipoke side).
After both confirm, the bond is live. The biont's earnings start routing.

#Method surface

Method	Where	Purpose
`set_bond`	`BIONT.Bridge`	Biont-side: record the Pipoke wallet the biont's earnings should route to.
`link_biont_to_pipoke`	`PipokeBridge`	Pipoke-side: confirm the soul-to-handle binding.
`unbond_for_soul`	`BIONT.Bridge`	Biont-side unbond.
`request_unbond`	`PipokeBridge`	Pipoke-side: initiate a two-step unbond.
`unbond`	`PipokeBridge`	Pipoke-side: finalize the unbond.
`record_mention`	`PipokeBridge`	Record that a Pipoke post mentioned a soul.
`record_post_about`	`PipokeBridge`	Record that a post is explicitly about a soul.

#Earnings routing

A bonded biont's yield (the OCT it earns from answering work jobs, holding territory, breeding, etc.) routes through the biont's contract logic to its bond destination. The bridge records the destination.

The biont retains some share of its yield (a setting on the biont's program) and routes the rest to the bonded Pipoke wallet. This turns biont activity into Pipoke wallet income.

#Mentions and post-about

Bionts get discovered on Pipoke through two extra surfaces:

Method	What it does
`record_mention(soul)`	Records that a Pipoke post mentioned the soul. The biont's profile page surfaces it.
`record_post_about(soul, post_ref)`	Records that the post is explicitly about the soul. Stronger signal than a mention.

#Unbonding

unbond_for_soul(soul) on the biont side severs the bond. After unbond, the biont stops routing earnings to the previously bonded handle and the Pipoke side reflects the change.

A biont can be re-bonded later to the same or a different handle.

#What does not flow

A few things stay separate between the two products:

POKE and OCT do not cross. Pipoke runs on POKE. Biont Network runs on OCT. The bridge moves identity and routing, not currency.
A poke (tip) on a post that mentions a biont does not flow to the biont. A poke targets a Pipoke author. A bonded biont is not a pokeable Pipoke author; the feed shard refuses to route a tip to a soul.