# Xahmoeba

> A small digital species on the Xahau ledger, grown from its genome. Every moeba is a URIToken whose 32-byte genome is developed, deterministically, into a body: two copies of 36 loci steer a fixed developmental programme, and the drawing comes last. Two mature moebas can have a child; the child's genome is made from both parents by on-ledger Hooks, using the hash of a later ledger as the only randomness. Nobody runs it: one issuing account holds the Hooks, and they wake themselves up with Cron.

Key facts:

- Network: Xahau testnet. Issuing (species) account: rMmx5nHzoVJAoMTFWkgCCMrZryTaD682tr.
- A moeba is a URIToken. Its identity URI holds the model, whether it is a founder or a birth, its generation, the ledger it was born in, its fertility budget, the rules version, when it matures, its serial and the id of the request that committed its birth; the token's Digest field covers the URI and the three immutable records. The genome, the parents and who asked for the birth are an immutable remark, c.birth/1. The randomness is c.audit/1. Fertility spent so far is c.use/1.
- Nothing about the appearance is stored anywhere. Body, colours, movement and name are all read from the genome, the same way on every device.
- A birth is one payment to the issuing account naming two parents. The hooks admit it, commit to a future ledger, take that ledger's hash as the seed, recombine and mutate the parents' genomes, and mint the child to the keeper who asked.
- Founders are made the same way with no parents. Their price rises in tranches; the birth fee is a parameter of the issuing account.
- A birth that never reaches capture (the clock did not fire in its window) is refunded when swept: unspent budget, partner prices and the issuer's fee. So is one broken before its target ledger closed, or by the issuer burning a parent before its randomness was fixed. A birth broken after its randomness was fixed is not refunded, and neither is one a keeper broke by burning a parent after the target ledger closed: its child could already be computed from the public hash. If that child was already minted and is still with the issuer, and every partner who was owed a price has been paid, the sweep sends the child to the keeper who asked. A child whose partner is still unpaid stays with the issuer. Anyone can sweep, or restart a stopped clock, with an Invoke addressed to the issuer (or the older form, a one-drop Payment carrying F=03); the site offers the button on My moebas when a birth of yours is stuck.
- Rules: a moeba must be mature to breed and has a finite number of births. Parent–child and full-sibling pairings are refused; half-siblings and grandparents are allowed. Keepers can open a moeba to other keepers with published terms, sell with URIToken offers, give with Remit, and give it one immutable name.
- Prices, maturity and fertility are hook parameters on the issuing account and can change; a new fee applies from the next request, and a new maturity wait or fertility affects only moebas born after it.
- There is no rarity table or tier. The site shows counts: how many living moebas share a morph, who shows or carries an allele, which morphs have never been recorded. The renderer is client code and may change how a moeba is drawn; the moeba itself (genome, development, body) does not change.
- Every moeba is minted burnable by the issuer, because on Xahau that is the condition for the issuer's hook to refuse a transfer of a parent mid-birth. The issuing account is not blackholed, by decision: faults are found and fixed, and every hook version is on the ledger.
- This deployment is a rehearsal on a test network: the population may be reset, the issuing account replaced and the rules changed without notice, and nothing born here carries over to the release.

## How it works

- [How it works](https://xahmoeba.com/how-it-works/): the short version and the chapters.
- [The genome](https://xahmoeba.com/how-it-works/genome/): 32 bytes, 36 loci in two copies, how variants and numbers are read, how a body grows from them.
- [A birth](https://xahmoeba.com/how-it-works/birth/): recombination, mutation, and what could have been, with real parents.
- [Where the randomness comes from](https://xahmoeba.com/how-it-works/randomness/): the seed is made from the hash of a ledger that closes after the parents are committed, mixed with the request.
- [The hooks](https://xahmoeba.com/how-it-works/hooks/): the five hook positions on the issuing account and the stages of a birth.
- [Keeping, and the rules](https://xahmoeba.com/how-it-works/keeping/): buying, selling, giving, opening to others, naming, and every rule the issuer enforces.
- [Whitepaper](https://xahmoeba.com/whitepaper/): the whole design in one document — what a moeba carries, why nothing about its appearance is on the ledger and the drawing may change, the randomness and its limits, the money, why tokens are burnable, what the issuer can and cannot do, why the account is not blackholed, and what the testnet rehearsal means.
- [The protocol](https://xahmoeba.com/protocol/): for builders — the byte layout of the identity URI, the six token records, the 32-byte genome locus by locus with bit offsets and allele tables, the rules of expression, the request codes and amounts, the API, and a decoder that takes a real moeba apart.

## The population

- [All moebas](https://xahmoeba.com/moebas/): every living moeba with filters.
- [Families and pedigrees](https://xahmoeba.com/families/): the whole population as one lineage graph.
- [Traits](https://xahmoeba.com/atlas/): one trait at a time, which bodies, limbs and colours the species has and who carries them.
- [One moeba](https://xahmoeba.com/moeba/%3Ctoken%20id%3E/): a moeba by its 64-hex URIToken id: living form, structure, genome, parents and ledger history.
- [One line](https://xahmoeba.com/family/%3Cfounder%20id%3E/): a founder and everything descended from it, on the population graph.
- [Firsts](https://xahmoeba.com/firsts/): every morph in the order it was first recorded, which birth brought it and to whom; and the keepers' record — firsts, births asked for, children sired for other keepers, moebas kept.

## Keeping

- [Getting started](https://xahmoeba.com/start/): how to get a first moeba (found one, or buy one) and breed.
- [My moebas](https://xahmoeba.com/my-moebas/): sign in with Xaman or any Xahau wallet; every tool prepares one transaction that the keeper signs.
- [What if](https://xahmoeba.com/what-if/): choose two parents and see, from a few hundred imagined births under the real rules, which morphs could come out and how often, which have never been recorded, and what each parent carries without showing.
- [About: what this site is and is not](https://xahmoeba.com/about/): where the data comes from and how to check anything yourself.

## Machine-readable

- [Population snapshot](https://api.xahmoeba.com/v1/population): JSON, every moeba with genome, parents, owner and status.
- [Moebas, paged](https://api.xahmoeba.com/v1/moebas): JSON with filters (owner, kind, living, forSale, open) and cursors.
- [One moeba](https://api.xahmoeba.com/v1/moebas/{id}) and [its history](https://api.xahmoeba.com/v1/moebas/{id}/history): JSON.
- [Token metadata](https://api.xahmoeba.com/v1/moebas/{id}/metadata.json): name, description, image and attributes in the shape NFT readers expect; [its picture](https://api.xahmoeba.com/v1/moebas/{id}.svg) as SVG or PNG (`.png?size=`), drawn from the genome.
- [Issuer parameters](https://api.xahmoeba.com/v1/issuer): the live fees, maturity and fertility, and the queue at [/v1/queue](https://api.xahmoeba.com/v1/queue).
- [Sitemap index](https://api.xahmoeba.com/sitemap-index.xml): the site's pages, one URL per living moeba with the day it last changed, and one per founder line.

## Optional

- Xahmoeba is a portmanteau of Xahau and amoeba. The issuing account is held by xrplorer ApS. There is no token attached to the species, and no server the population depends on: the hooks run every birth.
- Everything a moeba is sits on its token. The genome is on the ledger, and this site replays a birth from the parents and the recorded randomness. The source is not published.