> For the complete documentation index, see [llms.txt](https://wally-3.gitbook.io/wally-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wally-3.gitbook.io/wally-docs/product/features.md).

# Features

> Complete feature reference for the Wally platform.

***

## QuickSend (Instant Transfer)

Send money instantly to registered beneficiaries for everyday needs.

* Select registered beneficiary
* Enter amount in USDC
* Choose category: FOOD, EXPENSES, EMERGENCY, OTHER
* Optional note
* 3% fee
* Instant release to beneficiary's wallet
* Recipient notification

**Flow:** Choose beneficiary → Amount → Category → PIN → Decrypt key → Sign payment XDR → Broadcast on Stellar → Confirm → Notify recipient

***

## Remittances with Escrow (Provider Payments)

Controlled transfers that only release to verified providers.

* Select provider from the verified network
* Define amount and category (EDUCATION, HEALTH, FOOD, CONSTRUCTION)
* Create on-chain escrow via TrustlessWork
* Fund escrow with USDC
* Provider completes service → requests release
* Sender approves → funds release to provider

### Escrow Roles

| Role             | Who               | Action                             |
| ---------------- | ----------------- | ---------------------------------- |
| Service Provider | Verified provider | Provides service, requests payment |
| Approver         | Sender            | Approves release                   |
| Release Signer   | Sender            | Signs the release tx               |
| Receiver         | Provider          | Receives USDC                      |
| Dispute Resolver | Wally             | Mediates conflicts                 |
| Platform Address | Wally             | Collects fee                       |

***

## Projects with Goals

Accumulate funds for big goals like building a house or university education.

* Create project with name, description, USDC goal
* Categories: CONSTRUCTION, REMODELING, OTHER
* Assign beneficiary (optional)
* Multiple contributions until goal is reached
* **savingsEnabled** option: funds earn yield while accumulating
* On goal completion: migrate from savings → escrow → release to provider

***

## Savings Vaults (Yield)

Earn DeFi yield on idle USDC via Blend Capital.

* Create standalone vault or linked to a project
* Deposit USDC into Blend Capital pool
* Automatic yield visible on dashboard
* Withdraw at any time
* For project vaults: automatic migration to escrow on goal completion
* Variable APY (\~0.5-5%), displayed in real time

***

## WhatsApp Bot

Send and receive money without downloading an app.

* Link phone number
* Check balance via chat
* Send USDC to contacts
* Receive payment notifications
* OTP verification for security
* Configurable daily limit ($500 default)

***

## Merchant API

Accept USDC payments programmatically.

* Generate API keys
* Create payment requests with amount, description, expiry
* Webhook for payment notifications
* Callback URL for post-payment redirect

***

## Non-Custodial Wallet

Full control of funds without depending on Wally.

* Key pair (public/secret) generated on the client
* Secret encrypted with AES-256-GCM + user PIN
* Stored in vault in DB (only encrypted data)
* Transaction signing with PIN (decrypt → sign → broadcast)
* Import/export wallet
* Freighter wallet support (extension)

***

## AI Insights & Analytics

Intelligent spending analysis that helps users make better financial decisions.

* **Pre-transaction nudges**: anomaly detection, best day to send, frequent beneficiary suggestion, recurring pattern reminders
* **During-transaction alerts**: duplicate detection (24h), new destination + high amount warning, category inconsistency
* **Analytics dashboard** (`/analytics`): spending by category (bar chart), monthly trend (line chart), distribution (pie chart), smart recommendations
* **Dashboard widget**: monthly summary with total sent, trend, top category, yield earned
* **Smart recommendations**: excessive category warnings, goal acceleration suggestions, auto-savings prompts, beneficiary spike alerts
* **Nightly precomputation**: cron job at 3 AM computes stats, patterns, and recommendations per user

**Architecture:** Pure rule-based heuristics over transaction history (no external LLM). Precomputed `UserInsightsCache` in Prisma, real-time checks at query time.

> See [AI Insights & Analytics](https://wally-3.gitbook.io/wally-docs/product/insights.md) for full documentation.

***

## Referral Program

Grow the network with built-in incentives.

* Unique referral code per user
* $5 USDC credit per referred signup
* Double incentive: referrer + referee both receive credit
* Full tracking in database

***

## Main Flows

### Flow 1: QuickSend

```
Choose beneficiary → Amount → Category → PIN
→ Decrypt key → Sign payment XDR → Broadcast Stellar
→ Confirm → Notify recipient
```

### Flow 2: Remittance with Escrow

```
Choose provider → Amount → Category → Deploy escrow (TrustlessWork API)
→ PIN → Fund escrow → Wait for service
→ Provider requests release → Sender approves
→ PIN → Sign release → Funds to provider
```

### Flow 4: Analytics & Insights

```
Nightly cron → Compute aggregates per user → Cache in DB
→ User opens Send page → Fetch pre-transaction nudges
→ Select beneficiary + amount → Fetch transaction alerts
→ Show dismissible nudge banners
→ User opens /analytics → Fetch full analytics
→ Render charts + recommendations
```

### Flow 3: Project with Savings

```
Create project → Enable savings → Contribute $X
→ PIN → Build Blend supply XDR → Sign → Soroban submit
→ Yield accumulates → Goal reached
→ Migrate: withdraw Blend → Deploy escrow → Fund escrow
→ Normal release
```
