# Investor Flow (Investor Portal dApp)

Investors are the source of capital in the tokenized private credit lifecycle.\
Their experience must be **simple, transparent, and trustworthy**, even though the underlying mechanics involve multiple smart contracts.

In this hackathon project, investors interact only through the **Investor Portal**, where they can:

* View the project
* Connect their wallet
* Buy participation tokens
* Monitor escrow and milestone progress
* Claim their ROI once the project completes

Trustless Work provides the escrow infrastructure and transparency layer that assures investors their capital is being used according to the promised milestones.

***

## **6.1 Responsibilities of the Investor**

An Investor is responsible for:

* Adding the trustline to the participation token
* Purchasing tokens through the token sale
* Tracking project updates
* Claiming their payout at the end of the cycle

They do **not** need to understand smart contracts — all functions are abstracted into a clean UI.

***

## **6.2 Where the Investor Works**

Investors use only one interface:

#### **📱 Investor Portal**

This portal allows investors to:

* View project details
* Inspect escrow progress (via embedded escrow viewer)
* Participate in the token sale (funding phase)
* Claim USDC during the ROI phase

The portal is lightweight and fully powered by Trustless Work APIs and the newly added tokenization contracts.

***

## **6.3 Step-by-Step Investor Flow**

***

### **Step 1 — Open Project Public Page**

The project public page displays:

* Project name & description
* Industry (e.g., luxury cars, art gallery, hotel, etc.)
* Token sale price (USDC per token)
* Hard cap & progress bar
* Timeline preview (milestones)
* Escrow viewer for transparency

This gives investors the right level of context before committing funds.

***

### **Step 2 — Connect Wallet**

The investor connects via:

* Freighter
* Albedo
* Lobstr Vault (if supported)
* Any wallet integrated via Stellar Wallet Connect

The portal recognizes:

* Wallet address
* Token trustlines
* Existing PT balance
* Claim eligibility (later)

***

### **Step 3 — Set Trustline to the Participation Token**

Participation Tokens (PT) require trustlines on Stellar.

Upon first visit after token deployment:

* The portal detects if the trustline is missing
* Displays a **Trustline Required** modal
* Investor approves the trustline in their wallet

**Outcome:**\
Investor wallet is now eligible to receive PT.

***

### **Step 4 — Buy Participation Tokens**

Investor selects an amount of USDC to invest.

#### **Actions:**

* Input USDC amount (e.g., 1,500 USDC)
* Review purchase summary
* Click **Buy Token**

#### **Token Sale Contract Process (under the hood):**

1. Receives investor’s USDC
2. Mints PT to the investor wallet
3. Automatically deposits USDC into the **Escrow Contract**

**Outcome:**\
The investor holds PT tokens representing their share of the round.

***

### **Step 5 — Monitor Escrow Progress**

Investors can check real-time progress as the project evolves.

Portal displays:

* Milestone list
* Evidence uploads (photos, receipts, PDFs)
* Approval and release signatures
* Escrow balance
* Total releases made

This is where Trustless Work shines:\
Investors finally get full visibility into the use of funds.

***

### **Step 6 — Wait for Project Completion**

Investors simply monitor:

* Milestones = completed
* Escrow = fully released
* Project = ready for ROI

When the project creator creates and funds the vault, the system notifies the investor that **redemption is now open**.

***

### **Step 7 — Claim ROI from Vault**

Once the Vault is open:

**Investor Actions:**

* Connect wallet
* Portal reads PT balance
* Shows “Your Claimable USDC”
* Investor clicks **Claim**
* Vault burns PT
* Vault pays USDC to investor

#### Formula:

```
payout = token_balance × price_per_token
```

**Outcome:**\
Investor receives principal + yield.\
Tokens are burned, ending their participation.

## **6.5 Why This Matters**

The Investor Flow demonstrates how Trustless Work enables:

* **True transparency** on how funds are used
* **Milestone-based capital protection**
* **Clear lines of responsibility between roles**
* **Simple redemption without intermediaries**
* **A trust experience that traditional private credit lacks**

This is how tokenized private credit becomes accessible and trustworthy.


---

# 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.trustlesswork.com/trustless-work/v2-en/oss-dapps/tokenization-private-credit/investor-flow-investor-portal-dapp.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.