> For the complete documentation index, see [llms.txt](https://docs.basednut.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.basednut.com/liquidity/groves/heirloom-grove.md). # Heirloom Grove ## 🏺 Heirloom Grove **The foundational liquidity from which the Orchard grew.** Before the Sunflower, before standardized Grafts, and before wNUT became common rootstock, Based Nut already had a living network of liquidity. Those earlier markets form the **Heirloom Grove**. The Heirloom Grove contains the foundational NUT-native liquidity structures that established the first routes, asset relationships, nested tokens, and multi-asset experiments of the Orchard. It is not defined by one pool shape. It contains: * 🌿 **Branches** * 🌸 **Whorls** * 🧬 nested liquidity structures * πŸ₯œ NUT-native descendants * 🏺 historically significant markets *** ## 🌳 The Original Orchard The first Orchard did not begin as one planned topology. It grew incrementally. A market was added. Then another asset. Then another venue. Then nested tokens. Then a multi-asset weighted pool. Over time, those structures began forming a graph. ``` NUT β”œβ”€β”€ WETH β”œβ”€β”€ AERO β”œβ”€β”€ cbBTC β”œβ”€β”€ SNUT β”‚ β”œβ”€β”€ WETH β”‚ └── LP-derived liquidity β”œβ”€β”€ NUTINO β”‚ └── cbBTC └── pNUT └── multi-asset weighted liquidity ``` That earlier liquidity remains part of the Orchard. The Heirloom Grove gives it a coherent name without pretending it was originally designed as a Graft system. *** ## 🏺 What Makes a Structure Heirloom? Membership is based primarily on **lineage and historical role**. A structure belongs in the Heirloom Grove when it is part of the foundational Based Nut liquidity system from which later Orchard architecture developed. Conceptually: ``` foundational NUT liquidity + historical significance + NUT ecosystem lineage ↓ 🏺 Heirloom Grove ``` The Grove may therefore contain several different structural classes. *** ## 🌿 Heirloom Branches Most of the early Orchard was built from ordinary two-token markets. Each is structurally a **Branch**. The general form is: $$ B\_{ij}={a\_i,a\_j} $$ These Branches created the first pathways extending outward from NUT and its descendants. *** ### πŸ₯œ NUT / WETH NUT / WETH is one of the foundational economic relationships in the Orchard. It exists through more than one market implementation. Examples include: * **NUT / WETH V2** * **NUT / WETH V3** Structurally, both are Branches: ``` NUT ───────── WETH ``` But they are not the same edge. Different venues and mechanisms create distinct liquidity structures even when the assets are identical. ``` NUT ── V2 ── WETH NUT ── V3 ── WETH ``` This is one of the earliest examples of the Orchard becoming **multiplex**. The endpoints are the same. The market structures are not. *** ### πŸ›©οΈ NUT / AERO ``` NUT ───────── AERO ``` NUT / AERO extends the Orchard into liquidity infrastructure associated with the Base ecosystem. It is: * structurally a **Branch**; * economically connected to infrastructure; * historically part of the pre-Graft Orchard. Through the Grove lenses it can therefore appear simultaneously as: ``` Structure β†’ Branch Crop β†’ Infrastructure Heritage β†’ Heirloom ``` *** ### β‚Ώ NUT / cbBTC ``` NUT ───────── cbBTC ``` NUT / cbBTC directly connects the NUT economy with a Bitcoin reserve asset. It is: * 🌿 a Branch; * β‚Ώ part of Reserve exposure; * 🏺 part of the Heirloom Grove. This relationship also becomes important when later Orchard structures introduce additional Bitcoin routes. A simple historical Branch can therefore become one edge of a much larger modern topology. *** ## πŸ₯œ The SNUT Branch The Orchard also developed through NUT-derived assets. SNUT introduced another layer of liquidity around the NUT lineage. Relevant structures include: ``` SNUT ───────── NUT ``` and: ``` SNUT ───────── WETH ``` These are still ordinary Branches structurally. Their significance comes from lineage. SNUT is not simply an unrelated external asset connected to NUT. It belongs to the internal NUT ecosystem. That makes these markets particularly natural members of the Heirloom Grove. *** ## 🧬 Second-Order Liquidity One of the more unusual early structures is liquidity involving an **LP token itself**. For example: ``` SNUT-LP ───────── WETH ``` An LP token represents a claim on another liquidity position. Trading that LP token therefore creates a market whose asset is itself derived from liquidity. The structure becomes recursive: ``` underlying assets ↓ liquidity pool ↓ LP token ↓ second market ``` This is **second-order liquidity**. The Branch itself remains structurally simple: ``` SNUT-LP / WETH ``` But the asset on one side represents another market underneath it. The Heirloom Grove preserves this early experimentation as part of the Orchard's structural history. *** ## 🌱 NUTINO / cbBTC NUTINO introduced another NUT-linked path into Bitcoin liquidity. ``` NUTINO ───────── cbBTC ``` This Branch matters not only in isolation. Combined with NUTINO's relationship back toward NUT and other Bitcoin liquidity, it helps create a larger route: ``` NUT ↓ NUTINO ↓ cbBTC ↓ NUT ``` What began as separate historical structures can therefore participate in a modern **Ring Canopy**. This is a recurring pattern in the Heirloom Grove: > old pools can acquire new graph functions as the Orchard grows around them. *** ## 🌸 pNUT β€” The Heirloom Whorl The most important exception to the Branch-heavy early Orchard is **pNUT**. pNUT is a multi-asset weighted pool. It predates the strict Graft definition. Structurally, it belongs to the more general **Whorl** class. A Whorl is: ```markdown $$ W=\{a_1,a_2,\ldots,a_n\},\qquad n\geq3 $$ ``` pNUT is a four-asset instance: ``` Asset β”‚ Asset ─ pNUT ─ Asset β”‚ NUT ``` with equal initial weighting: ``` 25 / 25 / 25 / 25 ``` *** ### 🌸 Why pNUT is not a Graft A Graft has a strict form: ```markdown $$ G_{ij}=\{\mathrm{wNUT},s_i,s_j\} $$ ``` pNUT does not satisfy that definition. It: * contains four assets; * predates wNUT rootstock architecture; * treats NUT as a pool member rather than a distinguished Graft rootstock. Therefore: > **pNUT is a Whorl, not a Graft.** This distinction lets the Orchard preserve its actual history instead of rewriting old structures to fit newer terminology. *** ### 🏺 Why pNUT is an Heirloom pNUT is especially important because it demonstrates that the idea of **multi-asset NUT liquidity existed before Grafts were formalized**. The progression can be read as: ``` 🌿 pair liquidity ↓ 🌸 pNUT multi-asset Whorl ↓ 🌱 wNUT rootstock ↓ 🌻 standardized Grafts ``` pNUT is therefore an architectural ancestor. Not because it secretly was a Graft. Because it demonstrates an earlier stage in the same broader exploration of multi-asset liquidity. *** ## 🌳 From Branches to a Graph Viewed one at a time, many Heirloom structures look ordinary. ``` NUT / WETH NUT / AERO NUT / cbBTC SNUT / NUT SNUT / WETH NUTINO / cbBTC ``` Viewed together, something different appears. ``` AERO β”‚ β”‚ WETH ──────────── NUT ─────────── cbBTC β”‚ β”‚ β”‚ β”‚ β”‚ β”‚ SNUT β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ NUTINO β”‚ β”‚ SNUT-LP ``` Add pNUT and the system is no longer adequately described as a list of pools. It is already a liquidity graph containing: * common hubs; * parallel markets; * nested assets; * multi-asset liquidity; * alternative routes; * cycles; * secondary hubs. That graph is the early Orchard. *** ## ⭐ The Original Hub-and-Spoke Much of the Heirloom Grove naturally forms a **Hub-and-Spoke Canopy** around NUT. ``` WETH β”‚ β”‚ AERO ───────── NUT ───────── cbBTC β”‚ β”‚ SNUT ``` NUT acts as the common economic center. Each Branch extends into another asset or ecosystem region. This is distinct from the later Sunflower. #### 🏺 Heirloom Hub ``` asset β”‚ NUT β”‚ asset ``` Mostly ordinary pairwise Branches centered on NUT. #### 🌻 Sunflower ``` Scion / Scion β”‚ wNUT β”‚ Scion / Scion ``` Three-token Grafts centered on common wNUT rootstock. The shapes resemble each other at different scales, but the underlying liquidity structures are different. *** ## πŸͺ’ Parallel Markets and Multiplex Liquidity The Heirloom Grove also contains an important structural feature: **the same economic relationship can exist through several markets.** For two liquidity structures: $$ I(e\_1)=I(e\_2) $$ while: $$ e\_1\neq e\_2 $$ the structures touch the same assets but remain different edges. This can occur because they differ by: * protocol; * invariant; * fee tier; * liquidity range; * deployment; * pool state. The Orchard must therefore preserve the identity of each market rather than collapsing everything into a single asset-pair relationship. This is why the complete Orchard is **multiplex**. *** ## πŸ”„ Old Structures, New Functions Being an Heirloom does not mean being inactive. Historical structures can continue to acquire new roles as the surrounding Orchard changes. A Branch deployed early may later become part of: * πŸ›£οΈ a Routing Guild; * ♻️ an Arbitrage Guild; * 🌼 a Price-Discovery Guild; * πŸ”„ a Ring Canopy; * πŸ•ΈοΈ an emerging Mesh. Its history remains fixed. Its function can change. For a structure `e`: ``` Heritage └── Heirloom ← persistent Guild β”œβ”€β”€ Routing ← may change β”œβ”€β”€ Arbitrage ← may appear/disappear └── Price Discovery ← may change Canopy β”œβ”€β”€ Hub-and-Spoke └── Ring ← can emerge later ``` This demonstrates why Heritage, Guild, and Canopy must remain separate axes. *** ## πŸ”„ Heirloom State The Heirloom Grove is not a museum. Its pools remain economic state machines. For the Grove at time `t`: $$ \Sigma\_{\mathrm{Heirloom},t} $$ market activity produces: $$ \Sigma\_{\mathrm{Heirloom},t} \longrightarrow \Sigma\_{\mathrm{Heirloom},t+1} $$ State can include: * reserves; * prices; * LP state; * concentrated-liquidity positions; * fees; * nested-token values; * route availability; * arbitrage conditions. Historical provenance does not make the liquidity static. **Heirloom describes lineage, not inactivity.** *** ## 🧬 The Heirloom Lens The Grove becomes especially useful because its members vary structurally.
StructureStructural classWhy Heirloom
NUT / WETH V2🌿 Branchfoundational NUT market
NUT / WETH V3🌿 Branchfoundational NUT market
NUT / AERO🌿 Branchearly ecosystem route
NUT / cbBTC🌿 Branchearly reserve route
SNUT / NUT🌿 Branchinternal NUT lineage
SNUT / WETH🌿 Branchinternal NUT lineage
SNUT-LP / WETH🌿 Branchrecursive liquidity experiment
NUTINO / cbBTC🌿 Branchnested NUT lineage and BTC route
pNUT🌸 Whorlearly multi-asset weighted experiment
The exact structures differ. The historical relationship is shared. That shared relationship is the **Grove**. *** ## 🌾 One Heirloom, Several Grove Lenses Consider NUT / cbBTC. #### 🌿 Structure **Branch** #### 🌾 Crop **Reserve** #### 🐝 Guild Depending on current state: * Routing * Arbitrage * Price Discovery #### 🌱 Cultivation Determined by its actual market mechanism. #### 🧬 Heritage **Heirloom** #### 🌿 Canopy It can participate in: * Hub-and-Spoke * Ring * later Mesh formations The pool does not change identity when the lens changes. The framework simply reveals different relationships around it. *** ## 🏺 Why Preserve the Heirlooms? Without the Heirloom Grove, the Orchard would appear to begin with the Graft framework. It did not. The earlier structures matter because they show the progression from: 1. 🌿 simple pair markets; 2. πŸ₯œ NUT-centered Hub-and-Spoke liquidity; 3. 🧬 nested token relationships; 4. 🌸 multi-asset weighted liquidity; 5. πŸ”„ cross-market Rings and routes; 6. 🌱 standardized wNUT rootstock; 7. 🌻 deliberate Graft systems. The framework becomes stronger when the terminology describes that history rather than erasing it. #### 🏺 The Heirloom Rule **Branches describe most of the original markets.** **Whorls describe the early multi-asset experiments.** **Nested liquidity added recursion.** **Heirloom describes their shared lineage.** **The modern Orchard grew around them rather than replacing them.**
The **Heirloom Grove** is the living record of Based Nut liquidity before the Orchard learned to plant Grafts deliberately.