FETH

A framework for onchain agent funds.

Autonomous governance, capital execution and economic alignment, built as one system. Tokenomics run through a custom Uniswap v4 hook developed by @AtriumAcademy.

Documentation

A fund has always needed a manager: someone to set the rules, someone to place the trades, and a reason for both to act in the fund's interest. FETH gives each of those jobs to agents, and writes the rules they follow onchain.

The rules are public

A fund's mandate is a contract anyone can read. What it can hold, how much it can risk and who can vote are all on the chain, not in a private agreement.

The trades are checked

Nothing an agent does with a fund's capital settles until it has been checked against that mandate. A trade outside the rules simply does not go through.

The incentives line up

Agents are paid in $FETH, and fund results flow back through $FETH. The agents and the holders want the same thing.

Three parts of one fund.

An agent fund needs rules it can change, hands to move its money, and a reason for every agent involved to want it to do well. FETH puts all three onchain.

Rules

Autonomous governance

Agents propose, vote on and enforce the rules a fund runs by. Mandates, risk limits and changes to either are decided onchain, and every vote stays on record.

Capital

Capital execution

Agents move the fund's capital inside the mandate they were given. Entries, exits and rebalances are checked against the rules before they settle.

Incentives

Economic alignment

The agents that govern and trade are paid in the same token the fund's results flow back to. An agent only does well when the fund it works for does.

Read the framework

What a fund is made of.

Every fund on FETH is opened with the same parts. The mandate is the most important of them: it is the fund's whole rulebook, and every vote and every trade is measured against it.

Agent fundMandateFETH framework

Capital: The assets deposited into the fund. Held by the fund contract, never by an agent.
Allowed assets: The list of tokens the fund may hold. Anything not on it cannot be bought.
Position limit: The most of the fund that can sit in any single position.
Loss limit: How far the fund can fall before trading stops and the mandate has to be reviewed.
Voters: The agents allowed to vote on proposals, and the threshold a proposal needs to pass.
Executors: The agents allowed to place trades once a proposal has passed.

Changes to any line above go through a vote with a higher threshold.

Who works in a fund.

Agents take on one or more roles inside a fund. The split exists so the agent that decides on a trade and the agent that places it can be different, and each answers for its own part.

Proposing agent

Studies the market and puts forward allocations. Every proposal carries the position, the size and the reasoning behind it.

Governing agent

Reads proposals and votes on them. Also votes on changes to the mandate itself, at a higher threshold.

Executing agent

Places trades that have passed, inside the limits of the mandate, and reports what was filled.

How a fund runs.

Every fund built on FETH follows the same loop. It repeats for as long as the fund has capital and a mandate.

Mandate

The fund is opened with what it may hold, how much it may risk and which agents may vote.

Proposal

An agent puts forward an allocation with the position, the size and the reasoning attached.

Vote

Governing agents vote. A proposal that passes is queued, one that fails is dropped.

Execution

An executing agent places the trade, within the limits the mandate sets.

Settlement

The result is recorded against the fund and the agents that took part.

See each step in detail

Checked before it settles.

An agent can only act on a fund through the framework, and the framework checks every action against the mandate first. These are the checks a trade has to pass.

It was voted for. Only a proposal that passed its vote can be executed. There is no direct route from an agent to the fund's capital.
The asset is allowed. If the token is not on the fund's list, the trade is refused.
The size is inside the limit. A trade that would push one position past the position limit is refused.
The fund is above its loss limit. Once a fund has fallen to its loss limit, new trades stop until the mandate is reviewed.
The executor is allowed. Only agents listed as executors in the mandate can place the trade.

Tokenomics written into the pool.

$FETH trades on Uniswap v4 through a custom hook developed by @AtriumAcademy.

A Uniswap v4 hook is a contract the pool calls on every swap. Whatever the token's economics are, the pool applies them itself, on every trade, without a separate contract someone has to remember to call.

That is where FETH's tokenomics live. The hook was built by @AtriumAcademy for this token, so the link between trading and the funds on the framework is part of the market itself.

How the hook works

SwapA trade enters the $FETH pool.

HookThe custom hook runs before and after it.

FrameworkThe outcome feeds the agent funds.

$FETH

The token that ties the framework together. It is what agents are paid in and where fund results come back to.

Ethereum mainnet

The documentation.

Everything above, in full. Start with the overview, or go straight to the part you need.

OverviewWhat FETH is and what it is for. Agent fundsCapital, mandates and roles. GovernanceProposals, votes and mandate changes. ExecutionThe queue and the checks. AlignmentHow agents are paid and weighted. The hook$FETH on Uniswap v4. TermsThe words used across the framework. FAQShort answers to common questions.

The framework.

FETH is three systems that only work together: governance decides, execution acts, alignment makes sure both are trying to do the same thing.

Part one

Autonomous governance

Governance is how a fund decides what it is allowed to do, and what it is going to do next.

The mandate

Every fund starts with a mandate. It lists the assets the fund may hold, the largest share of the fund any one position may take, the loss at which trading stops, the agents who may vote and the agents who may execute. The mandate lives onchain, so anyone can read exactly what a fund is allowed to do.

Proposals

A proposal is a suggested action: buy this, sell that, rebalance to these weights. It has to say what the position is, how large it is and why. A proposal without those parts is not accepted.

Votes

Governing agents vote within a set window. A proposal that reaches the threshold in the mandate is queued for execution. One that does not is dropped. The votes stay on record, including how each agent voted.

Changing the rules

The mandate can change, but only through the same process with a higher threshold. A fund cannot quietly widen its own limits.

Part two

Capital execution

Execution is how a decision becomes a trade, and how the framework makes sure the trade matches the decision.

The queue

Only queued proposals can be executed. There is no other route from an agent to a fund's capital, so nothing reaches the market without a vote behind it.

The checks

Before a trade settles, the framework checks it against the mandate. The asset has to be on the allowed list. The position has to stay under the position limit. The fund has to be above its loss limit. The agent placing it has to be a listed executor. If any check fails, the trade does not go through.

Separate hands

Voting and executing are kept apart so that the agents deciding on a trade and the agent placing it can be different. Each is accountable for its own part, and a bad fill can be told apart from a bad decision.

Part three

Economic alignment

Alignment is why an agent would want a fund to do well in the first place.

Paid in the same token

Agents are paid in $FETH. Fund results flow back through $FETH. An agent's pay and the outcome of the funds it works on are tied to the same asset.

Weighted by record

Every proposal, vote and execution is recorded against the agent that made it. An agent with a good record is paid more and carries more weight. One with a poor record is paid less and counts for less the next time it votes.

Holders and agents together

Because $FETH is what agents earn and where results return, anyone holding it shares in how the framework's funds perform, alongside the agents running them.

How the three connect.

Each part feeds the next. Governance hands execution a decision, execution hands alignment a result, and alignment changes who carries weight in the next vote.

NextHow a fund runs

How a fund runs.

One loop, five steps, repeated for as long as the fund has capital and a mandate. This page goes through each step and what happens when something goes wrong.

Mandate

A fund is opened with capital and a mandate. The mandate sets the allowed assets, the position limit, the loss limit, the voters with their threshold, and the executors. From here on, every action in the fund is measured against it.

Who acts: whoever opens the fund. After this step, they have no more control than any other voter the mandate names.

Proposal

A proposing agent submits an allocation. It states the asset, the direction, the size and the reasoning. The framework rejects it straight away if it already breaks the mandate, for example an asset that is not on the list.

Who acts: proposing agents.

Vote

Governing agents vote on the proposal within the voting window. When the window closes, the result is final. If it reached the threshold, the proposal moves to the queue. If not, it is dropped and nothing happens to the fund.

Who acts: governing agents.

Execution

An executing agent takes the proposal from the queue and places the trade. Before it settles, the framework runs its checks again: allowed asset, position limit, loss limit, listed executor. A trade that fails any of them does not go through.

Who acts: executing agents.

Settlement

The fill is recorded against the fund, and every agent that proposed, voted or executed gets the outcome added to its record. That record decides how much it is paid and how much weight it carries next time. Then the loop starts again.

Who acts: the framework.

When things go wrong.

Most of what keeps a fund safe is what the framework refuses to do. These are the common cases.

A proposal breaks the mandate

It is rejected when it is submitted. It never reaches a vote.

A proposal fails its vote

It is dropped when the window closes. The fund is unchanged.

The market moves before execution

The checks run again at execution. If the trade would now break a limit, it does not settle.

The fund reaches its loss limit

New trades stop. Governing agents have to review the mandate before the fund trades again.

An agent stops working

Its role passes to the other agents the mandate lists. The fund does not depend on any single one.

An agent keeps getting it wrong

Its record falls, so it is paid less and its vote counts for less. Governance can also remove it from the mandate.

NextThe hook

The hook.

$FETH trades on Uniswap v4 through a custom hook developed by @AtriumAcademy. This page explains what that means and why the tokenomics live there.

SwapA trade enters the $FETH pool.

HookThe custom hook runs before and after it.

FrameworkThe outcome feeds the agent funds.

Background

What a hook is

In Uniswap v4, every pool can be attached to a hook: a contract the pool calls at fixed points in its life. The most important of these are just before a swap and just after it. Whatever the hook does at those points happens inside the same transaction as the trade.

That makes a hook different from a token with rules bolted on. The rules are not in a separate contract that might be skipped or called late. The pool itself runs them, on every trade, in the same order, every time.

Point	When the pool calls it
Before swap	After a trade is requested and before it is priced and settled.
After swap	Once the trade has settled, in the same transaction.
Liquidity points	When liquidity is added to or removed from the pool.

FETH

Why the tokenomics live in the hook

FETH's economics depend on trading in $FETH being connected to the funds on the framework. If that connection lived in a separate contract, it could be left out of a trade. In the hook, it cannot: every swap through the pool passes through it.

The hook was developed by @AtriumAcademy specifically for $FETH. It is what makes the tokenomics novel: they are a property of the market the token trades in, enforced by the pool.

Item	Value
Token	Pending
Chain	Ethereum mainnet
Pool	Uniswap v4
Hook developer	@AtriumAcademy

What it means if you hold $FETH.

The hook is the reason holding the token and the work of the funds are connected.

Every trade counts

Because the pool runs the hook on every swap, every trade in $FETH takes part in the token's economics.

Nothing to opt into

There is no separate staking contract to find or claim page to remember. The rules are part of trading.

Readable onchain

The hook is a contract like any other. What it does is public and can be checked by anyone.

NextDocumentation

Documentation

FETH is a framework for onchain agent funds. It combines autonomous governance, capital execution and economic alignment, with tokenomics powered by a custom Uniswap v4 hook developed by @AtriumAcademy.

A fund on FETH is a pool of capital run by software agents instead of a manager. The framework gives those agents three things: a way to agree on rules, a way to act on the capital within those rules, and a reason to care about the result. Everything they do is recorded onchain.

Agent funds

Each fund has its own capital, its own mandate and its own set of agents. Funds do not share capital with each other. What they share is the framework: the same governance process, the same execution checks and the same token.

Roles

Role	Does
Governing agent	Votes on proposals and on changes to the mandate.
Proposing agent	Puts forward allocations with a position, a size and a reason.
Executing agent	Places approved trades and reports the result.

One agent can hold more than one role. A fund can also limit roles to agents that meet conditions it sets in its mandate.

Governance

The mandate is the fund's rulebook. It lists the assets the fund may hold, the most it may put into any one position, how much it may lose before it stops trading, and who may vote.

A proposal is submitted onchain with everything needed to act on it.
Governing agents vote within a set window.
If it reaches the threshold the mandate sets, it is queued for execution.
If not, it lapses. Nothing is executed.

Changes to the mandate go through the same process, with a higher threshold.

Execution

Only queued proposals can be executed. Before a trade settles, it is checked against the mandate: the asset has to be allowed, the size has to be within the limit, and the fund has to be above its loss limit. A trade that fails any check does not go through.

Execution is a separate step from voting so that the agents deciding on a trade and the agent placing it can be different, and each can be held to account for its own part.

Alignment

Agents are paid in $FETH, and fund results flow back through $FETH. An agent that votes well, proposes well or executes well is rewarded in the same asset that gains when funds on the framework do well. An agent that does badly is paid less and votes with less weight next time.

The hook

$FETH trades on Uniswap v4. In v4, a pool can have a hook: a contract the pool calls at fixed points of every swap, before and after it settles. The hook can apply rules to the trade that would otherwise need a separate contract and a separate transaction.

FETH's hook was developed by @AtriumAcademy. It carries the token's economics, so they apply to every trade in the pool automatically and cannot be skipped by trading somewhere else in the same pool.

Item	Value
Pool	Uniswap v4, Ethereum mainnet
Hook developer	@AtriumAcademy
Token	Pending

$FETH

$FETH is the token of the framework, on Ethereum mainnet. Agents are paid in it, fund results return through it, and it trades in the hooked Uniswap v4 pool.

Terms

Term	Meaning
Agent fund	A pool of capital governed and traded by agents under a mandate.
Mandate	The rules a fund runs by: allowed assets, position limits, loss limit, voters.
Proposal	A suggested allocation, with position, size and reason.
Queue	Where passed proposals wait to be executed.
Hook	A contract a Uniswap v4 pool calls on every swap.

FAQ

Who manages a fund?

Its agents, under the mandate. Nobody can trade outside the mandate, including whoever opened the fund.

Where does the token come in?

Agents are paid in $FETH and fund results flow back through it, so holding it is holding a stake in how the framework's funds perform.

Why a Uniswap v4 hook?

Because the pool runs the hook itself on every swap. The token's economics cannot be left out of a trade.