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

# How Turtle works

> The flow from a liquidity provider deposit through on-chain attribution to distributor revenue and protocol incentives.

Turtle is infrastructure between DeFi yield opportunities and the platforms that distribute them. The clearest way to understand it is to follow a single deposit from start to finish.

This page is for a partner deciding whether and how to integrate Turtle, and it traces the full flow so you can see where your product plugs in.

## The flow

<Steps>
  <Step title="A distributor surfaces an opportunity">
    A distributor picks which vaults to show its users and links them to the deposit page, either through a no-code [share link](/partner-products/share-links) or a full [API integration](/sdk/earn/deposit). Each link or transaction carries the distributor's ID.
  </Step>

  <Step title="A liquidity provider deposits into a vault">
    The LP deposits into the vault from their own wallet. The vault is one of many in the catalog, each reviewed before listing. The LP signs and submits the transaction; Turtle never takes custody.
  </Step>

  <Step title="Turtle attributes the deposit on-chain">
    The distributor's ID is embedded in the deposit calldata. Turtle monitors every supported chain and links the deposit to the distributor that sourced it. There is no manual reporting step.
  </Step>

  <Step title="The LP earns yield, and rewards on top">
    The LP earns the vault's base yield. On a featured opportunity (or Turtle Deal), the LP also earns extra token emissions funded by the protocol, distributed through Turtle's incentive products.
  </Step>

  <Step title="The distributor earns revenue share">
    Because the deposit is attributed, the distributor earns recurring revenue share on the TVL it brought, for as long as that TVL stays. Protocols are billed on attributed TVL, so they pay only for liquidity Turtle delivered.
  </Step>
</Steps>

## The pieces that run the flow

The same flow runs through a small set of products, each handling one part of the loop.

**Earn** is the distribution layer. It gives a distributor access to the full vault catalog through one integration, generates the deposit and withdrawal transactions, and tracks attributed activity, all scoped to a single distributor ID. See [Turtle Earn](/partner-products/turtle-earn).

**Yield Opportunities** are the opportunities themselves. An LP deposits, holds, and withdraws; some vaults settle instantly and some settle asynchronously. See [Yield Opportunities](/liquidity-products/turtle-vaults).

**Streams** are how a protocol attaches extra incentives to a vault. A [Stream](/partner-products/streams/overview) is a self-serve reward campaign that pays LPs in proportion to their TVL.

**Liquidity Campaigns, and Ecosystem Campaigns** define Turtle-selected opportunities that pass Turtle Diligence Counsel review and often include additional incentives to attract investors. A [Liquidity Campaign](/liquidity-products/turtle-deals) is a selected series of vaults, often with additional incentives funded by a protocol treasury. An [Ecosystem Campaign](/liquidity-products/turtle-campaigns) coordinates many vaults and incentives to bootstrap a whole chain.

**Swaps** let an LP deposit from almost any EVM token into any supported vault, with routing handled inside the deposit flow.

## Attribution and revenue share

Attribution is what makes the loop pay. Every deposit is linked on-chain to the distributor that sourced it, automatically, with no trusted reporting in between. Distributors earn recurring revenue share on attributed TVL, and the same on-chain record is what protocols are billed against. The full attribution mechanism for engineers lives in the [distributor model](/sdk/concepts/distributor-model).

## The diligence standard

Opportunities on Turtle are not self-listed. Each vault goes through a structured review before a distributor can surface it. The review covers technical risk, smart contract exposure, operational risk, and curator assessment. See [Trust and Security](/get-started/trust-and-security) for how that review and the custody model protect LPs.

## Get started

<CardGroup cols={2}>
  <Card title="Trust and Security" icon="shield-check" href="/get-started/trust-and-security">
    How the diligence review and the non-custodial model protect LPs.
  </Card>

  <Card title="Turtle Earn" icon="layer-group" href="/partner-products/turtle-earn">
    The distribution layer that gives you the full vault catalog through one integration.
  </Card>

  <Card title="Streams" icon="bolt" href="/partner-products/streams/overview">
    Self-serve reward campaigns that pay LPs in proportion to their TVL.
  </Card>

  <Card title="Deposit API" icon="code" href="/sdk/earn/deposit">
    Generate an attributed deposit transaction from your own backend.
  </Card>
</CardGroup>