# Solution Architecture

Earn API is engineered for straightforward integration across custodian systems. This overview outlines integration partner responsibilities without requiring knowledge of your specific architecture.

### Integration tasks overview

The solution involves eight key tasks. Synchronous operations occur alongside user interface actions; asynchronous operations run as background jobs.

| # | Task                               | Description                                                                                                                    | Dependencies |
| - | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------ |
| 1 | Authentication                     | OAuth2 Client Credentials Flow (M2M) is used to acquire an access token for Earn API.                                          | —            |
| 2 | Product list                       | Partners retrieve product listings from internal storage, with options for automated sync or manual database maintenance.      | 1            |
| 3 | Create Tesseract user and accounts | User and account creation before deposits, implementable synchronously at deposit time or beforehand.                          | 1, 2         |
| 4 | Deposit                            | Partner calls Earn API to book a user deposit into Tesseract's accounting with no immediate crypto transfer.                   | 1, 3         |
| 5 | Balance and transaction views      | Balance and transaction details sourced from partner systems.                                                                  | 4b, 6b, 8    |
| 6 | Withdrawal                         | Partner books a withdrawal on Earn API with no immediate crypto transfer.                                                      | 1, 4         |
| 7 | Daily settlement                   | Partners fetch daily reports containing settlement figures and initiate crypto transactions where deposits exceed withdrawals. | 1            |
| 8 | Daily interest sync                | The daily report contains all journal entries for the day, requiring partner synchronisation.                                  | 1            |

### Accounting cycle

The accounting cycle executes daily at 00:00 (typically UTC) and handles user interest distribution, partner margin allocation, and report generation.

### Daily settlement process

When Earn API is used to deposit and withdraw assets to accounts, no actual crypto transfers are sent or received. Instead, all deposits and withdrawals are netted per-currency once per day. Partners configure wallet addresses within Earn API for automated settlement, with complete visibility through daily reports.

### Multi-entity compliance structure

Partners receive separate authentication credentials for each product line due to regulatory requirements. Partners must maintain credential-to-user mappings and create dual Earn API user accounts per end user while presenting a unified product experience. See [Data Model Mapping](/earn-direct-and-earn-api/earn-api/data-model-mapping.md) for the mapping pattern.


---

# Agent Instructions: 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:

```
GET https://docs.tesseract.fi/earn-direct-and-earn-api/earn-api/solution-architecture.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.