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

# Partner Revenue

> How partner attribution and referral economics should be documented before integrations.

Signalite should separate technical integration from commercial attribution. The API and SDK make the user flow possible; partner revenue requires a clear attribution and settlement model.

<Warning>
  Partner revenue sharing is not live until the referral or attribution system is explicitly implemented and published. Do not promise partner commissions from the current API alone.
</Warning>

## Reference models

| Model                | How it works                                               | Signalite fit                                                |
| -------------------- | ---------------------------------------------------------- | ------------------------------------------------------------ |
| Builder code         | Integrator passes a code during deposit                    | Good for direct attribution if added to quote/build payloads |
| Offchain attribution | Track wallet, transaction, and time-weighted deposits      | Good first partner-sandbox model                             |
| Fee wrapper          | Deposits route through a wrapper that collects yield share | More complex, requires contract work                         |
| Onchain splitter     | Fees are split by contract                                 | Best transparency, highest implementation cost               |

## Proposed sandbox model

For early partners:

1. Assign each partner a `partnerId`.
2. Allow partner apps to pass `partnerId` in action quote metadata once implemented.
3. Index deposits and wallet positions by partner attribution.
4. Calculate time-weighted attributed TVL.
5. Settle referral or performance-fee share offchain until onchain splitting is implemented.

## Data required

| Data                    | Why                             |
| ----------------------- | ------------------------------- |
| Partner ID              | Attribution                     |
| User wallet             | Position and lifecycle tracking |
| Deposit tx hash         | Verifiable source event         |
| Deposit amount          | Revenue share base              |
| Share balance over time | Time-weighted TVL               |
| Fee accrual             | Commission calculation          |

## Future API shape

```ts theme={null}
const quote = await shlp.quoteDepositAction({
  amount: parseUsdc("100"),
  account: userAddress,
  receiver: userAddress,
  slippageBps: 50,
  partnerId: "partner_mobile_app",
});
```

## Partner docs rule

Until attribution is live, document this as a roadmap feature, not as a currently available SDK field.