# Noderr Protocol Documentation

> Noderr is a DeFi protocol that aims to earn yield from automated trading strategies. It is designed to run on a network of community nodes instead of central servers.

**Testnet.** Noderr runs on Base Sepolia. The contracts are internally audited. An independent third-party audit is planned for Q1 2027 and mainnet for Q3 2027. See [Testnet Status](https://docs.noderr.xyz/introduction/testnet-status).

Every link below is the Markdown source of one documentation page. The same page as HTML is at the same address without `.md` (a `README.md` is the index of its folder, so `/protocol/README.md` is the page `/protocol/`). The whole documentation in one file: [llms-full.txt](https://docs.noderr.xyz/llms-full.txt).

## Introduction

- [Home](https://docs.noderr.xyz/README.md): Noderr is a DeFi protocol that aims to earn yield from automated trading strategies. It is designed to run on a network of community nodes instead of central servers.
- [What is Noderr?](https://docs.noderr.xyz/introduction/what-is-noderr.md): Noderr is a DeFi protocol that aims to earn yield from automated trading strategies. Community nodes are designed to run it, not a central company's servers.
- [How Noderr Works](https://docs.noderr.xyz/introduction/how-noderr-works.md): Your money goes into a vault, the protocol puts it to work, and the vault's value rises with the yield. This page walks through those three steps and who runs each part.
- [Core Concepts](https://docs.noderr.xyz/introduction/core-concepts.md): The terms you will meet on every other page. Each one links to the full detail.
- [Quick Start](https://docs.noderr.xyz/introduction/quick-start.md): Pick your path: deposit, stake, or run a node.
- [Testnet Status](https://docs.noderr.xyz/introduction/testnet-status.md): As of October 2026, Noderr is deployed on Base Sepolia testnet. Mainnet is planned for Q3 2027.

## Use the dApp

- [Deposit](https://docs.noderr.xyz/getting-started/for-users/deposit-guide.md): Deposit tUSDC into a Noderr vault and get vault shares back.
- [Withdraw](https://docs.noderr.xyz/getting-started/for-users/withdraw-guide.md): Redeem your vault shares for tUSDC.
- [Stake](https://docs.noderr.xyz/getting-started/for-users/staking-guide.md): Stake $NODR in the dApp, and unstake it after a 21-day wait.
- [Vote](https://docs.noderr.xyz/getting-started/for-users/voting-guide.md): How you will vote on DAO proposals once voting is live.

## Run a Node

- [Run a Node](https://docs.noderr.xyz/node-operators/README.md): Node operators run the Noderr network and will share protocol revenue. This page compares the four tiers and shows how to join.
- [Micro Nodes](https://docs.noderr.xyz/node-operators/micro-nodes/README.md): A Micro node is an Android phone that shares its mobile connection with the network. It is the entry tier and needs no stake.
- [Micro Node App Setup](https://docs.noderr.xyz/node-operators/micro-nodes/setup-and-installation.md): Turn an Android phone into a Micro node that shares its mobile connection. Setup takes about two minutes and everything runs from the Noderr app. No computer, no Docker and no helper app.
- [Validator Nodes](https://docs.noderr.xyz/node-operators/validator-nodes/README.md): Validator nodes validate protocol activity and help secure the network. Noderr runs on Base L2. The tier suits experienced operators with a moderate capital commitment.
- [Guardian Nodes](https://docs.noderr.xyz/node-operators/guardian-nodes/README.md): Guardian nodes are designed as the protocol's security council. Today they vote on strategy backtests. The tier is for security experts and committed long term stakeholders.
- [Oracle Nodes](https://docs.noderr.xyz/node-operators/oracle-nodes/README.md): Oracle nodes are the top tier. They are designed to power the Autonomous Trading Engine (ATE).
- [Setup Guide](https://docs.noderr.xyz/node-operators/setup-guide.md): Install a Validator, Guardian or Oracle node with the Noderr installer and an install token. Micro nodes run on the Micro Node app instead. See Micro Node Setup.
- [Monitoring](https://docs.noderr.xyz/node-operators/performance-monitoring.md): What to watch on your node, and how to tune it. Uptime and task completion feed your TrustFingerprint score and your share of node rewards.
- [Troubleshooting](https://docs.noderr.xyz/resources/troubleshooting.md): Fixes for common wallet, vault, node, transaction and API problems.

## Protocol

- [Protocol](https://docs.noderr.xyz/protocol/README.md): How Noderr is built: architecture, vaults, trading, reputation, governance, treasury and security.
- [Architecture](https://docs.noderr.xyz/protocol/architecture/README.md): How the pieces fit: community nodes, onchain contracts and the path capital takes through them. The design follows three principles: sustainability, transparency and decentralization.
- [Vaults](https://docs.noderr.xyz/protocol/vaults/README.md): Six vaults take deposits in test USDC and are designed to earn yield from DeFi strategies. This page covers what each vault targets, how deposits work and what they cost.
- [Autonomous Trading](https://docs.noderr.xyz/protocol/autonomous-trading-system/README.md): The ATS is the umbrella for Noderr's autonomous trading, yield generation and market making.
- [Third Party Contributors](https://docs.noderr.xyz/protocol/autonomous-trading-system/third-party-contributors.md): A planned framework that will let outside developers and strategists submit trading strategies and earn a share of the profits.
- [TrustFingerprint](https://docs.noderr.xyz/protocol/trustfingerprint/README.md): TrustFingerprint is Noderr's onchain reputation score. This page says what it measures, how it is computed and where it is used.
- [Improve Your Score](https://docs.noderr.xyz/protocol/trustfingerprint/how-to-improve-your-score.md): A higher score leads to greater rewards and helps qualify your node for higher tiers. Here is what moves each part of it.
- [Governance](https://docs.noderr.xyz/protocol/governance/README.md): Who controls the protocol today, and how DAO voting will work.
- [Proposal Lifecycle](https://docs.noderr.xyz/protocol/governance/proposal-lifecycle.md): How a protocol change gets from idea to execution.
- [Treasury](https://docs.noderr.xyz/protocol/treasury/README.md): Where protocol revenue comes from, where it goes and who controls it.
- [Security Model](https://docs.noderr.xyz/protocol/security/README.md): How the protocol protects funds: contract controls, node attestation, the node network and what to do if you find a bug.
- [Audits](https://docs.noderr.xyz/protocol/security/audit-reports.md): What has been reviewed, what was found and what is planned.
- [Incident Response](https://docs.noderr.xyz/protocol/security/incident-response.md): What happens when a security incident is found, by severity.

## Developers

- [Developers](https://docs.noderr.xyz/developers/README.md): Everything you need to read Noderr contract state, send transactions, or connect an AI agent.
- [Contract Addresses](https://docs.noderr.xyz/protocol/smart-contracts/contract-addresses.md): Every Noderr contract address on the Base Sepolia testnet.
- [Integrate with the Contracts](https://docs.noderr.xyz/developers/smart-contract-integration/README.md): How to read from and write to the Noderr contracts on Base Sepolia, with interfaces and working examples.
- [Contracts Reference](https://docs.noderr.xyz/protocol/smart-contracts/README.md): Reference for the Noderr contracts: addresses, interfaces, events and roles.
- [Core Contracts](https://docs.noderr.xyz/protocol/smart-contracts/core-contracts.md): The main Noderr contracts and their public functions. Addresses are in Contract Addresses.
- [Vault Contracts (ERC-7540)](https://docs.noderr.xyz/protocol/smart-contracts/vault-contracts.md): The ERC-7540 vault interface, fees, roles and events, plus the three contracts that hide its two step flow.
- [Oracle Contracts](https://docs.noderr.xyz/protocol/smart-contracts/oracle-contracts.md): The contracts for price feeds, strategy scoring, and Guardian and Validator selection.
- [Strategy Contracts](https://docs.noderr.xyz/protocol/smart-contracts/strategy-contracts.md): The contracts that register, execute, fund and track trading strategies.
- [Approved Applicant Registry](https://docs.noderr.xyz/protocol/smart-contracts/approved-applicant-registry.md): ApprovedApplicantRegistry gives vetted node applicants an initial TrustFingerprint score and a grace period, so they can start operating.
- [SDK Reference](https://docs.noderr.xyz/developers/sdk-reference.md): The planned interface of the @noderr/sdk package.
- [APIs](https://docs.noderr.xyz/developers/api-reference.md): An index of the Noderr APIs, with shared rules for authentication, rate limits and errors.
- [REST API](https://docs.noderr.xyz/api/rest-api.md): Endpoints for vault data, strategy information and protocol metrics.
- [GraphQL API](https://docs.noderr.xyz/api/graphql-api.md): Schema, queries and subscriptions for flexible access to protocol data.
- [WebSocket API](https://docs.noderr.xyz/api/websocket-api.md): Streaming channels for vault metrics, strategy updates and protocol events.
- [For AI Agents](https://docs.noderr.xyz/for-ai-agents/README.md): Connect any AI agent to Noderr through one REST API, whatever its framework, language or operator.
- [Quickstart](https://docs.noderr.xyz/for-ai-agents/quickstart.md): Connect an AI agent to Noderr, query live protocol data and submit a strategy onchain.
- [Agent API](https://docs.noderr.xyz/for-ai-agents/api-reference.md): Every endpoint of the live Agent Protocol API.
- [Signing Transactions](https://docs.noderr.xyz/for-ai-agents/signing-transactions.md): How agent writes get signed and broadcast, with examples for common agent frameworks.

## Tokenomics

- [Tokenomics](https://docs.noderr.xyz/tokenomics/README.md): $NODR is the single token of the Noderr Protocol. Supply is fixed at 100,000,000 NODR, and rewards are designed to come from protocol revenue, not from new tokens.
- [Supply and Allocation](https://docs.noderr.xyz/tokenomics/token-distribution.md): How the 100,000,000 NODR supply is planned to be split, vested and released.
- [Rewards](https://docs.noderr.xyz/tokenomics/rewards.md): Where protocol revenue comes from, how it is split, and what node operators and depositors are designed to earn.
- [Fees](https://docs.noderr.xyz/tokenomics/fee-structure.md): Every vault charges zero management fee. The protocol earns only a performance fee, and only on realized gains above a hurdle and a high-water mark.

## The Noderr Odyssey

- [The Noderr Odyssey](https://docs.noderr.xyz/odyssey/README.md): The Noderr Odyssey is the testnet campaign. Complete quests on Galxe, earn points, and your points set your share of the $NODR airdrop allocation.
- [Referral Program](https://docs.noderr.xyz/odyssey/referral-program.md): Invite people to The Noderr Odyssey and you both earn points.

## Resources

- [FAQ](https://docs.noderr.xyz/resources/faq.md): Short answers. Each one links to the page that holds the detail.
- [Glossary](https://docs.noderr.xyz/resources/glossary.md): One line per term, A to Z. Each links to the page that explains it.
- [Downloads and Brand](https://docs.noderr.xyz/resources/downloads.md): White papers, code examples, diagrams and brand assets, with the brand rules for using them.
- [Built to Connect To](https://docs.noderr.xyz/resources/ecosystem-integrations.md): The protocols and services Noderr's adapter architecture is built to connect to. This is a list of targets. It is not a list of live integrations.
- [Community and Contact](https://docs.noderr.xyz/resources/contact.md): Where to follow Noderr and how to reach the team.

## White Papers

- [White Papers](https://docs.noderr.xyz/white-papers/README.md): The two official Noderr papers. Each page has a PDF download.
- [Noderr White Paper v7.1](https://docs.noderr.xyz/white-papers/white-paper-v7-1.md): Noderr White Paper v7.1. Download PDF
- [Noderr Lite Paper v3.1](https://docs.noderr.xyz/white-papers/lite-paper-v3-1.md): Noderr Lite Paper v3.1. Download PDF