> For the complete documentation index, see [llms.txt](https://docs.yolkfi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yolkfi.com/readme.md).

# Introduction

Welcome to the official technical documentation for **YolkFi**, the real-world asset (RWA) protocol connecting industrial poultry production to programmable decentralized finance on the Stellar network.

***

### Key Protocol Highlights

* **Real Economic Foundation:** Backed by an active agricultural enterprise (**AT Grup**, operating since 1997) with **200,000+ laying hens**, **6,000,000+ eggs produced monthly**, and **€4,000,000+ annual turnover**.
* **Pre-Financing Production Model:** YolkFi acts as the capital formation layer that finances designated production batches and turns verified commercial cash flows into programmable on-chain yield.
* **Deterministic Soroban Architecture:** 7 purpose-built Rust smart contracts enforcing Layer-0 investor compliance (`InvestorRegistry.rs`), NFT lifecycle management (`HenNFT.rs`), batch tracking (`ProductionRegistry.rs`), and automated yield accounting (`YieldDistributor.rs`).
* **Cryptographic IoT Oracle:** Telemetry ingestion from **Big Dutchman** automated systems combined with commercial ERP reconciliation, signed via **Ed25519** and verified natively on Soroban via `env.crypto().ed25519_verify()`.
* **Complete Blockchain Abstraction:** Frictionless Web2 onboarding via **Privy** embedded wallets, native wallet support via **Stellar Wallets Kit**, fiat ramps via **SEP-24 Anchor Platform & MoneyGram Access**, and secondary liquidity via **Soroswap**.

***

### Documentation Structure

1. [**Project Overview & Traction**](/01.-project-overview-and-traction/abstract.md) — Vision, corporate verification, operational metrics, and team background.
2. [**Technical Architecture**](/02.-technical-architecture/overview.md) — Comprehensive technical design, contract specifications, oracle pipelines, and storage lifecycle.
3. [**Stellar Ecosystem Integrations**](/03.-stellar-ecosystem-integrations/overview.md) — In-depth specifications for Stellar Wallets Kit, Privy, SEP-24, MoneyGram, and Soroswap.
4. [**Milestones & Deliverables**](/04.-milestones-and-deliverables/roadmap.md) — Structured SCF Build Award milestones with dependency ordering, budget breakdowns, and outcome-based completion criteria.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.yolkfi.com/readme.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.