> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ownafarm.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# How OwnaFarm works end to end

> Walk through the full farmer and investor journey on OwnaFarm, from registration and invoice submission to investment, monitoring, and harvest payouts.

## Farmer flow

```mermaid theme={null}
flowchart LR
    A[Register] --> B[Submit Invoice]
    B --> C[Admin Approval]
    C --> D[Receive Funds]
```

<Steps>
  <Step title="Register">
    Complete KYC verification with personal ID, business documents, and bank details.
  </Step>

  <Step title="Submit invoice">
    Upload the offtaker contract with funding target, yield percentage, and duration.
  </Step>

  <Step title="Get approved">
    Platform administrators verify invoice authenticity and offtaker credibility.
  </Step>

  <Step title="Receive funds">
    Once fully funded, GOLD tokens transfer to the farmer's wallet.
  </Step>
</Steps>

## Investor flow

```mermaid theme={null}
flowchart LR
    A[Connect Wallet] --> B[Buy Seed]
    B --> C[Nurture]
    C --> D[Harvest]
```

<Steps>
  <Step title="Connect wallet">
    Link a Web3 wallet and claim GOLD from the faucet (testnet).
  </Step>

  <Step title="Buy seed">
    Browse the marketplace, view yield and duration, and purchase with GOLD tokens.
  </Step>

  <Step title="Nurture">
    Water plants daily for XP, track growth progress, and level up your profile.
  </Step>

  <Step title="Harvest">
    When the invoice matures, claim principal plus yield.
  </Step>
</Steps>

## Investment lifecycle

| Phase    | Duration    | Action         | Result                     |
| -------- | ----------- | -------------- | -------------------------- |
| Purchase | Instant     | Buy seed       | NFT minted, funds locked   |
| Growing  | 1–180 days  | Water, earn XP | Contract executes          |
| Maturity | End of term | Wait           | Invoice paid               |
| Harvest  | Instant     | Claim          | Principal + yield returned |

## Fund flow

```mermaid theme={null}
sequenceDiagram
    participant I as Investor
    participant SC as Smart Contract
    participant F as Farmer
    participant O as Offtaker

    I->>SC: Invest GOLD
    SC->>F: Disburse funds
    F->>O: Deliver goods
    O->>SC: Pay invoice
    I->>SC: Harvest
    SC->>I: Principal + Yield
```

## Safety mechanisms

| Layer                 | Protection                    |
| --------------------- | ----------------------------- |
| Offtaker verification | Only approved buyers accepted |
| Invoice validation    | Admin review before listing   |
| Vault reserve         | Yield funds pre-deposited     |
| Smart contract        | Automated settlement          |
| Blockchain record     | Immutable transaction history |