> For the complete documentation index, see [llms.txt](https://raretyperesearch.gitbook.io/stockmon/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://raretyperesearch.gitbook.io/stockmon/start-here/how-stockmon-works.md).

# How Stockmon works

Stockmon begins with one fixed creature identity, then connects that identity to permanent Stock DNA, an NFT, a token-level Vault ledger, and a wider product world. Those systems support one another, but they never become interchangeable.

![Four-layer map connecting Genesis identity, MON and Vault accounting, Markets and ownership, and clearly separated future systems](https://164480815-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0r3IgolbVPO14VcUCkOG%2Fuploads%2FSfTvbvDM1sAqXvVcAMQY%2Fecosystem-map-v1.svg?alt=media)

{% hint style="warning" %}
**Your Genesis identity and DNA are permanent.** Hunt, Breeding, Aetheryn, PVP, and agent payments are coming soon and do nothing to your NFT until they launch inside the Stockmon app.
{% endhint %}

## The complete loop

### 1. Start with a visible Genesis creature

Genesis contains exactly **116 Stockmons**: 100 Hybrids followed by 16 Pures. Every creature, token number, and DNA recipe is visible before selection. There is no random reveal that swaps the chosen artwork later.

### 2. Read the permanent Stock DNA

Each Genesis ID has an ordered set of ticker weights totaling 100%.

DNA does two jobs:

* it shapes the creature through anatomy, silhouette, materials, color relationships, energy, and personality; and
* it divides that token ID’s equal share of an eligible Feed round across its DNA lineages.

DNA is a recipe—not a live balance. The Vault ledger records what has actually been funded, settled, or left pending.

### 3. The NFT carries the living identity

The ERC-721 token records the current owner of that Genesis ID on Robinhood Chain. A normal transfer changes ownership without changing the creature, DNA, Feed history, or token-level ledger.

While the NFT remains living, its settled Stock Tokens and pending WETH remain sealed in pooled contract custody and accounted for by token ID. A seller cannot strip individual positions immediately before transferring the NFT.

### 4. MON activity can create protocol revenue

`$MON` is Stockmon’s ecosystem token. Fee-bearing activity can create distributable revenue. Its dedicated Flap processor delivers WETH to the Stockmon Vault, and the Vault records only what it receives.

The chain does not treat gross volume, gross tax, and Stockmon revenue as the same number. Stockmon begins accounting only after canonical WETH is actually received by the Vault.

### 5. The Vault runs the 48-hour Feed

Feed rounds follow one launch-anchored 48-hour clock. For each eligible round:

1. the Vault identifies distributable WETH actually received;
2. 50% becomes the Stock Token budget and 50% is tracked for the project treasury;
3. the Stock Token budget is divided equally across every living Genesis ID;
4. each ID’s permanent DNA divides its equal share by lineage;
5. execution is aggregated by ticker; and
6. verified output becomes settled entitlement while unsupported amounts remain pending.

Available-unminted and wallet-owned IDs are both living. Permanently burned IDs are excluded from future snapshots.

### 6. Markets explains the current ledger

The **Markets** experience combines two different evidence classes:

* exact onchain Stock Token atoms and pending WETH recorded for each token ID; and
* timestamped USD estimates derived from validated price sources.

Exact balances remain exact even when a USD estimate is unavailable. Markets hides stale or incomplete estimates instead of inventing a price. It is a read-only discovery and valuation layer—not a brokerage account, stock exchange, or promise that the displayed amount can be withdrawn.

### 7. Marketplace changes ownership, not protocol history

The first-party **Marketplace** and **Den** are separate from Markets. Marketplace is the noncustodial order and settlement experience for verified Genesis NFTs; Den is the owner workspace.

A completed sale transfers the NFT and its living token-level history to the buyer. Stockmon does not take custody of the NFT, buyer funds, seller funds, or private keys. Marketplace charges the disclosed **0.85% seller-paid Stockmon fee**.

### 8. Redemption is the one-way exit

Permanent redemption burns the NFT, ends future Feed participation, and fixes the burner as beneficiary of matured claims. WETH and supported Stock Token claims can settle independently after burn.

Redemption cannot be reversed. A burned Genesis ID never returns to the living supply.

### 9. What is coming next

Stockmon expands without changing Genesis:

* **Hunt** gives your eligible Stockmon an isolated 6.5-hour active-play position with a normal return and an intact rescue path. A finalized full normal close earns one permanent Readiness Mark; seven marks are required for Breeding readiness.
* **Breeding** checks marks, fertility, cooldown, ownership, generation, and kinship before showing the complete outcome catalog. One accepted MON payment seals one transferable Egg with a 24-hour incubation and zero rerolls.
* **Aetheryn** is the separate descendant collection built from 196 permanent lineage identities.
* **PVP** brings eligible creatures into direct competition.
* **Agent payments** let authorized software agents buy clearly priced Stockmon services and return a receipt.

These features are coming soon. They are not available in the app today.

### 10. Hunt and Breeding form one owner journey

`Full Hunt → Readiness Mark → 7 Marks → Compatibility Review → Seal Egg → 24-Hour Incubation → Hatch`

G1 uses one eligible Genesis with seven marks and an available fertility use. G2+ uses two distinct, compatible Aetheryn owned by the same wallet; each must earn seven marks of its own. Cousins are compatible, while self-pairs, ancestors with descendants, full siblings, and half siblings are not.

The sealed Egg—not the parent—owns the hidden outcome, maturity, and Birth Vault entitlement. It can be transferred without changing those terms. The current Egg owner receives the exact committed child at Hatch.

See the complete Breeding rules and Aetheryn Eggs.

## What moves together—and what does not

| Relationship                               | Correct interpretation                                                                                                     |
| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------- |
| Creature + token ID + DNA                  | One permanent Genesis identity                                                                                             |
| NFT transfer + sealed living ledger        | The ledger follows the token ID to the new owner                                                                           |
| MON activity + authenticated Vault receipt | Activity can contribute to protocol revenue after the verified ingress succeeds                                            |
| Exact ledger + external price              | Produces a timestamped display estimate, not withdrawable cash                                                             |
| Parent DNA + Aetheryn child                | Visual ancestry only; the child begins with zero XP, zero marks, and zero inherited parent financial rights                |
| Hunt marks + Breeding                      | Seven permanent qualifying marks unlock the readiness check; fertility, cooldown, ownership, and compatibility still apply |
| Parent NFT + sealed Egg                    | Separate assets; transferring a parent cannot cancel, redirect, or change the Egg                                          |
| Hunt position + Genesis Feed               | Separate custody and accounting; Hunt loss cannot debit the Feed basket                                                    |
| PVP or agent-payment page                  | Coming-soon information; no usable feature or payment today                                                                |

## A practical reading order

1. Genesis 116
2. Stock DNA
3. $MON
4. The Vault and 48-hour Feed
5. Markets
6. The NFT lifecycle
7. Marketplace and Den
8. Hunt, PVP, and Aetheryn
9. Prepare for Breeding
10. Agent payments
11. Owner FAQ
12. Status, safety, and risks

Next: Explore Genesis 116.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://raretyperesearch.gitbook.io/stockmon/start-here/how-stockmon-works.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
