> 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/polyforest-grove.md).

# Polyforest Grove

## 🌲 Polyforest Grove

**The heterogeneous liquidity region of the Orchard.**

The **Polyforest Grove** is where different assets, protocols, pricing mechanisms, and liquidity structures grow together.

Unlike the Sunflower, it does not repeat one standardized Graft geometry.

Unlike the Heirloom Grove, it is not defined primarily by foundational NUT lineage.

The Polyforest is defined by **heterogeneity and interaction**.

It contains the mixed liquidity that connects different economic regions and market mechanisms into the wider Orchard.

#### 🌲 Polyforest at a glance

**Sunflower** — deliberately repeated Grafts.

**Heirloom** — foundational NUT-native liquidity.

**Polyforest** — heterogeneous liquidity interacting across mechanisms, assets, and protocols.

A forest does not contain one kind of tree.

Neither does the Polyforest.

***

## 🌳 A Mixed Forest

The Orchard is not built from one AMM repeated across every asset.

Its liquidity can include:

* 🌱 bonding curves;
* 🌿 ordinary pair markets;
* 🎯 concentrated liquidity;
* ♻️ reCLAMM;
* ⚖️ weighted liquidity;
* 🧬 nested assets;
* 🥜 NUT-linked markets;
* 🌐 external ecosystem assets.

The Polyforest describes the region where these structures begin interacting as one economic network.

```
bonding curve ──────┐
                    │
constant product ───┤
                    │
reCLAMM ────────────┼── 🌲 POLYFOREST
                    │
concentrated LP ────┤
                    │
external markets ───┘
```

The structures do not need identical:

* arity;
* weights;
* protocols;
* invariants;
* asset classes;
* provenance.

They belong together because their liquidity forms useful relationships across the Orchard.

***

## 🌲 What Makes a Structure Polyforest?

Polyforest membership is based on **economic interconnection across heterogeneous liquidity systems**.

A structure becomes relevant to the Polyforest when it contributes to relationships such as:

* cross-protocol routing;
* multi-mechanism arbitrage;
* settlement paths;
* cross-Crop liquidity;
* price propagation;
* external ecosystem connectivity;
* heterogeneous Rings;
* emerging Meshes.

Conceptually:

```
different assets
      +
different mechanisms
      +
different venues
      +
shared economic paths
      ↓
🌲 Polyforest Grove
```

#### 🌲 The Polyforest rule

The Polyforest is not defined by **what every pool has in common**.

It is defined by **what becomes possible when different pools interact**.<br>

***

## 🌿 Different Structures Can Coexist

The Polyforest may contain several Orchard structure classes.

### 🌿 Branches

Two-token markets can connect distinct parts of the system.

Examples include:

* SALT / USDC;
* PIPS / USDC;
* PIPS / NUT;
* other cross-ecosystem pair markets.

A Branch remains:

$$
B\_{ij}={a\_i,a\_j}
$$

Its Polyforest membership comes from its role in the larger heterogeneous network, not from being a special kind of Branch.

***

### 🌱 Grafts

Future Grafts may also participate in the Polyforest.

A Graft remains structurally:

$$
G\_{ij}={\mathrm{wNUT},s\_i,s\_j}
$$

If its Scions connect otherwise distinct economic regions, the same Graft can simultaneously belong to:

* 🌻 Sunflower;
* 🌲 Polyforest;
* 🐝 Cross-Pollination Guild;
* one or more Crop Groves.

The classifications overlap because they answer different questions.

***

### 🌸 Whorls

Whorls can also participate wherever multi-asset liquidity contributes to a Polyforest route.

The general Whorl remains:

$$
W={a\_1,a\_2,\ldots,a\_n},\qquad n\geq3
$$

The Polyforest therefore does not require one structural primitive.

That structural diversity is part of its purpose.

***

## 🌱 Different Cultivation Methods

The strongest feature of the Polyforest is that its markets can use fundamentally different pricing systems.

### 🌱 Bonding Curves

Bonding curves create liquidity according to an issuance or reserve function rather than an ordinary pair-market invariant.

Examples in the wider Orchard include:

* SALT;
* NUTINO;
* other curve-issued assets.

A bonding curve can become the first step of a route that later enters an AMM.

***

### ♾️ Constant-Product Markets

Traditional AMMs create another form of liquidity.

Their reserve behavior differs from:

* bonding curves;
* weighted pools;
* concentrated liquidity;
* reCLAMM.

Yet all can participate in the same economic path.

***

### 🎯 Concentrated Liquidity

Markets such as Slipstream or Uniswap V3 concentrate liquidity inside selected price ranges.

For example:

```
PIPS / NUT
```

can connect external agent liquidity directly back into the NUT economy.

***

### ♻️ reCLAMM

reCLAMM introduces another pricing and rebalancing mechanism.

For example:

```
PIPS / USDC
```

can participate in the same route as markets using completely different invariants.

***

### ⚖️ Weighted Liquidity

Weighted pools and Grafts add yet another mechanism.

The Polyforest can therefore intersect with the Sunflower and other weighted regions without becoming synonymous with them.

***

## 🧬 Polyculture

Agricultural monoculture repeats one crop under similar conditions.

Polyculture allows different organisms to occupy the same environment and interact.

The same distinction applies to liquidity.

#### 🌻 Sunflower

```
weighted Graft
weighted Graft
weighted Graft
weighted Graft
weighted Graft
```

Deliberately standardized.

#### 🌲 Polyforest

```
bonding curve
      │
     AMM
      │
   reCLAMM
      │
concentrated LP
      │
weighted market
```

Deliberately heterogeneous.

Neither is inherently superior.

They expose different properties of the Orchard.

***

## 🐝 Cross-Pollination Between Economic Domains

The Polyforest can also connect different **Crop Groves**.

Consider the NUT → SALT → USDC → PIPS route.

It crosses several economic domains:

* 🥜 NUT ecosystem;
* 🧂 internal/nested asset;
* 💵 settlement asset;
* 🤖 agent/compute asset.

The route is therefore not merely technical.

It connects different economic categories.

```
NUT ecosystem
      ↓
nested asset
      ↓
settlement
      ↓
AI / agent economy
      ↓
NUT ecosystem
```

That makes the Polyforest a natural home for the **Cross-Pollination Guild**.

***

## 🛣️ Routing Through the Forest

A heterogeneous network creates routes that would not exist if every liquidity structure were considered in isolation.

Suppose an asset has no direct market against another target asset.

The Orchard can still provide a path:

```
Asset A
   ↓
Market 1
   ↓
Asset B
   ↓
Market 2
   ↓
Asset C
   ↓
Market 3
   ↓
Asset D
```

The markets can use completely different mechanisms.

The route remains economically valid as long as each transition is executable.

This makes the Polyforest especially important to the:

* 🛣️ Routing Guild;
* 🐝 Cross-Pollination Guild;
* ♻️ Arbitrage Guild;
* 🌼 Price-Discovery Guild.

***

## ♻️ Arbitrage Across Mechanisms

Arbitrage does not require two identical AMMs.

It requires economically connected prices that can diverge.

A Polyforest can therefore generate discrepancies across:

* bonding curves;
* spot AMMs;
* concentrated liquidity;
* reCLAMM;
* weighted markets;
* wrappers;
* external markets.

If execution around the cycle returns more economic value than it began with after costs, an arbitrage opportunity exists.

The Orchard does not need every edge to use the same invariant for that relationship to emerge.

***

## 🌼 Price Propagation

A price change in one part of the Polyforest can create pressure elsewhere.

For example:

```
external PIPS price changes
          ↓
PIPS / NUT moves out of alignment
          ↓
routing or arbitrage changes
          ↓
USDC / PIPS relationship changes
          ↓
pressure propagates into wider routes
```

Different protocols remain mechanically independent.

Economically, they become connected through traders, routes, and arbitrage.

This is how a forest of separate markets becomes one liquidity system.

***

## 🕸️ From Rings to Meshes

A single Polyforest cycle forms a Ring.

Additional markets can create alternative routes.

Suppose:

```
A → B → C → D
```

and later another path appears:

```
A → E → D
```

The region begins developing route redundancy.

Continue adding lateral connections and the Polyforest can evolve toward a **Mesh Canopy**.

```
A ───── B
│ \     │
│  \    │
E ───── C
 \     /
  \   /
    D
```

This is an important property of the Polyforest:

> heterogeneous liquidity can gradually produce network resilience.

***

## 🌐 External Assets Enter the Orchard

The Polyforest is also where external ecosystems become economically connected to Based Nut.

An asset does not need to descend from NUT to participate in the Orchard.

It only needs a liquidity relationship that connects it to the graph.

Examples can include:

* stablecoins;
* agent tokens;
* protocol assets;
* reserve assets;
* future RWAs;
* other Base-native assets.

```
external asset
      ↓
liquidity structure
      ↓
Polyforest
      ↓
Orchard
```

This prevents the Orchard from becoming a closed token family.

Its topology can expand outward.

***

## 🌲 Polyforest ≠ External Grove

The word **external** alone is too weak.

The Polyforest is not simply:

> everything that is not NUT.

Some external assets belong naturally inside:

* 🌻 Sunflower Grafts;
* 🌾 Reserve Groves;
* 🤖 Compute Groves;
* 💵 Settlement Groves.

Likewise, a NUT-related market may participate in the Polyforest if it forms part of a heterogeneous cross-mechanism route.

The defining property is therefore not origin.

It is:

> **heterogeneous economic interconnection.**

***

## 🏺 Polyforest and Heirloom Can Overlap

Groves are collections.

They do not need mutually exclusive membership.

A historical Branch may be:

* 🏺 Heirloom because of its lineage;
* 🌲 Polyforest because of its current routing role.

For example, a foundational NUT market can later become an edge in a cross-protocol Ring.

Its history did not change.

Its network function did.

```
one market
   │
   ├── 🏺 Heirloom
   │      historical lineage
   │
   └── 🌲 Polyforest
          heterogeneous route
```

This is not double counting.

It is the Grove system working as intended.

***

## 🔄 A Living Polyforest

Polyforest membership can be especially dynamic.

A route may become economically meaningful only when:

* liquidity exists;
* prices align;
* sufficient depth develops;
* an arbitrage opportunity emerges;
* a new pool is deployed.

Let the Polyforest state at time `t` be:

$$
\Sigma\_{\mathrm{Polyforest},t}
$$

Market activity changes that state:

$$
\Sigma\_{\mathrm{Polyforest},t}
\longrightarrow
\Sigma\_{\mathrm{Polyforest},t+1}
$$

Changes can include:

* reserves;
* prices;
* liquidity depth;
* active ranges;
* bonding-curve state;
* reCLAMM state;
* routes;
* arbitrage opportunities;
* fees.

Because the mechanisms differ, state is not uniform across the Grove.

Each structure keeps its own rules while contributing to the larger graph.

***

## 🌳 One Polyforest, Several Lenses

Consider the PIPS / NUT market.

#### 🌿 Structure

**Branch**

#### 🌾 Crop

It connects:

* 🤖 Compute / Agent exposure;
* 🥜 NUT economic liquidity.

#### 🐝 Guild

It can participate in:

* Routing;
* Arbitrage;
* Price Discovery;
* Cross-Pollination;
* Attestation.

#### 🌱 Cultivation

**Concentrated Liquidity**

#### 🧬 Heritage

Its own deployment and asset provenance.

#### 🌲 Practical Grove

**Polyforest**

because it contributes to heterogeneous cross-mechanism routes.

#### 🔄 Canopy

It helps close the:

```
NUT → SALT → USDC → PIPS → NUT
```

Ring.

One Branch therefore participates in the complete Orchard ontology simultaneously.

***

## 🌲 Why the Polyforest Matters

Without the Polyforest, the Orchard could be mistaken for two isolated ideas:

1. old NUT liquidity;
2. new Grafts.

The actual system is broader.

Liquidity moves across:

* generations;
* protocols;
* asset classes;
* market mechanisms;
* pool structures.

The Polyforest is where those systems meet.

It turns heterogeneous markets into a connected economic environment.

#### 🌲 The Polyforest Rule

**The Sunflower standardizes liquidity.**

**The Heirloom preserves lineage.**

**The Polyforest connects difference.**

Its Branches, Grafts, Whorls, curves, AMMs, and external markets do not need to look alike.

They need to interact.

That interaction is what makes them a forest rather than a list of pools.

The **Polyforest Grove** is the part of the Orchard where different forms of liquidity begin behaving as one ecosystem.
