# Splitter Holon

A **Splitter Holon** is a holon whose primary function is to route incoming resources to multiple destinations according to a configurable distribution rule. It is the foundational primitive for translating an inflow of value—money, tokens, hours of attention, access rights—into outflows that respect the priorities of the participants.

Where a generic holon holds resources, a Splitter Holon **moves** them. Every other holon type can be composed with a Splitter when distribution logic is needed.

## How it works

A Splitter Holon is configured with a set of destinations (other holons, wallets, or pools) and an allocation rule. When resources arrive, the rule is applied automatically.

The simplest form is a percentage split:

> "70% to direct contributors, 30% to the ecosystem pool."

Splitters can also condition allocations on a \[\[value-equation]]—for example, distributing a pool to contributors in proportion to logged hours, appreciations, and delivered outcomes.

## The dial: internal vs. external

The most common Splitter pattern in Holonic Funding is the **dual-mechanism splitter**, which has a single adjustable dial (0–100%) governing the split between two channels:

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

| Dial position | Behavior                                                 |
| ------------- | -------------------------------------------------------- |
| 0%            | All resources to internal contributors (siloed)          |
| 50%           | Balanced internal/external flows                         |
| 100%          | All resources to ecosystem partners (pure collaboration) |

Communities adjust the dial based on their stage:

* **Early stage** — high internal, to build capacity.
* **Growth stage** — balanced, to build and connect.
* **Mature stage** — high external, to invest in the ecosystem.

## When to use a Splitter Holon

Use a Splitter Holon when:

* A pool of incoming resources must be divided across multiple parties on a recurring basis.
* The split should be transparent and changeable by the participants rather than by a custodian.
* You need to route overflow (anything above a threshold) to a different destination — for example, into a federated mutual-aid pool.

## Composition

Splitter Holons compose naturally with other primitives:

* With a **threshold bucket**, the Splitter only fires once minimum needs are met, and overflow goes to a downstream holon.
* With a **federation contract**, the external side of the dial can fan out across an entire trust graph instead of a single partner.
* With a **value equation module**, the internal side can be weighted by contribution data rather than fixed percentages.

See [Funding Flow](/getting-started/funding-flow.md) for the full whitepaper treatment of splitter contracts and distribution mechanisms.


---

# 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/software/holons-types-flavor/splitter-holon.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.