# Funding Flow

**Holonic Funding** is the economic layer of the Holons protocol: the set of smart-contract primitives that let any holon receive, route, and distribute resources without a central custodian. This page is a working summary of how those primitives fit together.

For the full whitepaper—tokenomics, simulation results, market analysis, roadmap, and investment thesis—see [Funding Flow Whitepaper](/getting-started/funding-flow-whitepaper.md).

## The problem it solves

Every existing financial system assumes hierarchical control and monetary abstraction. Communities working on regeneration, commons-based projects, and decentralized coordination keep running into the same pattern: **value creation happens across relationships, not hierarchies**, but the tools available force every relationship through cash.

A regenerative village has empty rooms and can offer housing, food, and community. A developer can build valuable coordination infrastructure. Each has what the other needs—but the monetary system makes the exchange impossible unless both first convert their offering into money.

Holonic Funding makes relationships economically meaningful by tracking resource flows directly: time, care, knowledge, tools, land, infrastructure, and money, all as first-class flows between holons.

## Core idea

Every holon has the same shape:

* An **identity** ([membrane](/getting-started/glossary.md#membrane)) that defines who is in and what the holon is for.
* A **value system** ([value equation](/getting-started/glossary.md#value-equation)) that converts contributions into points and points into shares.
* **Flows** in and out, routed by configurable primitives.
* **Federation relationships** with other holons.

What changes between holons is the configuration of these elements—not the architecture.

## The primitives

Holonic Funding provides a small set of composable contracts. Each holon picks and parameterizes the ones it needs.

### Holon contract

The root identity object. Holds:

* Identity and reputation registry.
* Multi-asset resource balance.
* Inflow and outflow configuration.
* Federation membership.
* Commitment registry pointer.

### Splitter

Routes incoming flow to multiple destinations. The canonical form is a **dual-mechanism splitter** with a single adjustable **dial** (0–100%) governing the split between internal and external flows:

* **Internal flows** — rewards for direct contribution inside the holon.
* **External flows** — rewards routed to ecosystem partners through declared relational priorities.

The dial position shifts with the holon's stage: early stages favor internal (build capacity), mature stages favor external (invest in the ecosystem).

See [Splitter Holon](/software/holons-types-flavor/splitter-holon.md) for the patterns.

### Threshold bucket

Accumulates resources until a minimum is met, then either distributes or routes **overflow** to a downstream destination. Encodes the principle "fund what we need first, then share the surplus." Threshold buckets are how a holon expresses its actual cost of operation as a structural fact rather than a perpetual ask.

### Value equation module

Calculates points from contributions. A common form:

```
Points = (Hours × Hour_Weight) +
         (Appreciations × Appreciation_Weight) +
         (Outcomes_Delivered × Outcome_Weight)

Share  = Points_Individual / Points_Total
```

Each holon sets its own weights. This is what lets two holons running identical software produce completely different cultures—what they pay attention to is what their members get recognized for.

### Federation contract

Coordinates multiple holons. Manages:

* Shared resource pools (mutual-aid treasuries, project funds, regenerative commons).
* The trust graph between member holons.
* Access propagation—how rights and liabilities flow along delegation chains.

See [HoloSphere Federation](/software/holosphere/federation.md) for the data-layer counterpart.

### Commitment registry

Records published commitments, supports validation workflows, updates reputation on completion, and links commitments to delivered outcomes. The commitment registry is what makes promises economically meaningful: a holon's standing in the network is built from commitments kept.

## Distribution mechanisms

A holon's outgoing flow is shaped by two complementary mechanisms, balanced by the splitter dial:

**Mechanism A — Internal flows.** Reward direct value creation inside the holon.

1. Contributors log activities (hours, outcomes, appreciations).
2. The value equation calculates contribution points.
3. Resources are allocated proportionally at the end of each [epoch](/getting-started/glossary.md#epoch).

**Mechanism B — External flows.** Reward relationship-building and ecosystem participation.

1. The holon declares relational priorities (which partners it values).
2. Incoming resources are weighted by relational signals.
3. Resources flow to ecosystem partners.
4. Reciprocal value recognition strengthens the network.

The same holon can run both mechanisms simultaneously, with the dial controlling the proportion.

## Federation patterns

Holons federate to access shared resource pools under value-aligned conditions:

* **Mutual aid treasuries** for member support.
* **Project collaboration funds** for shared initiatives.
* **Regenerative commons pools** for ecosystem health.
* **Risk-sharing instruments** for collective resilience.
* **Shared infrastructure budgets** for network needs.

Federation creates a trust graph. Holons that are more connected attract more flow, and relationship-building becomes economically rewarded over time. Crucially, federated holons retain full autonomy: each one defines its own rules, value equation, and dial position—federation just declares which other holons it trusts and on what terms.

## Resources are not only money

The system coordinates many kinds of resources—tools, spaces, services, tokens, land, time, commitments—each tracked, valued, and governed according to the holon's own rules. Money is one flow among many, not the universal medium that compresses every other relationship.

This is what makes "relational zones" (bilateral resource agreements between holons—"I share my space if you share your expertise") tractable as on-protocol contracts rather than informal arrangements.

## Where to read deeper

* **Full whitepaper** — [Funding Flow Whitepaper](/getting-started/funding-flow-whitepaper.md) (problem statement, simulation results, tokenomics, market analysis, roadmap, investment thesis).
* **The shapes a holon can take** — [Holon types (flavor)](/software/holons-types-flavor.md): Splitter, Managed, Zoned, Appreciative.
* **Practical setup** — [Setting up your holonic organization](/daos/setting-up-your-holonic-organization.md) and [Managing your organization](/daos/managing-your-organization.md).
* **The data substrate** — [HoloSphere](/software/holosphere.md) for geographic holons, [HolonsBot](/software/holonsbot.md) for community holons.
* **Vocabulary** — [Glossary](/getting-started/glossary.md) for every recurring term.


---

# Agent Instructions: 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:

```
GET https://docs.holons.io/getting-started/funding-flow.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
