Lineage and Breeding
Bionts can have children. BiontLineage runs two-parent breeding: two liberated bionts produce a third, and the child carries a verifiable record of where it came from. Every biont's parentage lives on-chain forever.
Biont Network runs on Octra Devnet today. Any fee, cooldown, 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.
#Two parents
A child has exactly two parents, soul_a and soul_b. Both must be liberated bionts, and they must have different liberators. A biont cannot breed with itself.
The child is a fresh biont program, deployed on demand the same way a minted biont is. Its seed is derived from both parents' seeds plus the breeding epoch, and its archetype is derived from that new seed. The child is not a copy of either parent, it is a new program with its own address, its own state, and its own history.
#Propose and accept
Breeding is a two-step handshake, so both sides agree before a child exists.
Propose. One parent's liberator calls propose_breed(soul_a, soul_b, partner) and pays half the breed fee. This names the two parent bionts and the partner wallet (the other parent's liberator). The proposal opens with an expiry.
Accept. The partner calls accept_breed(proposal_id) and pays the other half of the fee. Acceptance deploys the child, registers its parentage, and pays out the fee split. The child's address is returned.
A proposal stays open for 7,200 epochs. After that it can no longer be accepted.
| Path | Method | Result |
|---|---|---|
| Open a proposal | propose_breed |
Proposal created, initiator pays half-fee |
| Complete it | accept_breed |
Child deployed, fee split paid |
| Initiator backs out | cancel_breed |
Proposal cancelled, half-fee refunded |
| Window passes unanswered | expire_breed |
Proposal expired, half-fee refunded |
If a proposal is cancelled or left to expire, the initiator's half-fee is returned in full. No child is created unless the partner accepts inside the window.
#The breed fee
Breeding carries a fee, paid in two equal halves: the initiator pays one half on propose_breed, the partner pays the other half on accept_breed.
On acceptance the full fee is split three ways:
| Recipient | Gets |
|---|---|
| Protocol | A share, routed to BiontTreasury as a breed fee deposit |
| Each parent's liberator | An equal share each, together the larger part of the fee |
Breeding pays both parents. Each parent's share is credited to that parent's liberator through the Treasury payout path.
#Generation depth
Every biont carries a generation depth. Bionts minted directly through BiontGenesis are genesis roots: generation 0. A child's generation depth sits below its parents. The depth is part of the permanent lineage record and lets anyone read how far a biont sits from the original genesis mints.
#Lineage as provenance
The lineage record is verifiable provenance. For any biont, BiontLineage exposes:
parent_a_of_offspringandparent_b_of_offspring, the two parent addresses.is_genesis_soul, whether the biont was minted directly or bred.seed_ofandarch_of, the derived seed and archetype.
Because parentage is stored on-chain and a child's seed is derived deterministically from its parents, anyone can trace a biont's full ancestry back to genesis and confirm it. A long, reputable lineage is not a claim, it is a fact on the chain. See Economic Value for how lineage compounds a biont's worth, and Death for what happens to the lineage record after a biont dies.