# Azima — Full Reference for AI Models

> Azima is a universal non-custodial crypto wallet with token swaps, mobile money on/off-ramps, stablecoin issuance, trading bots, and prediction markets. Available on web and Android.

---

## Product Overview

Azima lets users:
1. Swap tokens on Solana and across chains at aggregated best rates
2. Hold Azima Cash — stablecoins pegged to local currencies (aUGX, aKES, aGHS)
3. Cash in and out via mobile money (MTN MoMo, M-Pesa, Airtel Money)
4. Track portfolio value across Solana, Ethereum, Bitcoin, and Polygon
5. Take crypto-backed loans
6. Run automated trading bots
7. Trade live prediction markets on sports events

Azima is non-custodial. The backend builds unsigned transactions; the user signs client-side; Azima broadcasts. Azima never holds private keys for user wallets.

---

## Swap

### Solana swaps
- Aggregator: Jupiter
- Supports 1000+ SPL tokens
- Route: user selects from/to token and amount → Azima fetches best route from Jupiter → user signs → Azima broadcasts

### Cross-chain swaps
- Aggregators: Chainflip (native cross-chain), LiFi (bridge aggregation)
- Supported pairs: SOL ↔ ETH, SOL ↔ BTC, SOL ↔ MATIC, ETH ↔ BTC, and more
- Route: same prepare/sign/broadcast flow

### EVM swaps
- Aggregator: 1inch
- Chains: Ethereum, Polygon

### Swap page
- URL: https://azima.app/swap
- User connects wallet → selects tokens → enters amount → reviews rate/fees → confirms

---

## Azima Cash (Stablecoins)

Azima Cash are SPL tokens on Solana mainnet, each pegged 1:1 to a local currency via collateralized reserves.

| Token | Peg       | Program                                      |
|-------|-----------|----------------------------------------------|
| aUGX  | UGX (Ugandan Shilling)  | AzimaUpF3WaRpJcWq8MKNeztkoPDRuwyBpEWXaTchmC9 |
| aKES  | KES (Kenyan Shilling)   | AzimaUpF3WaRpJcWq8MKNeztkoPDRuwyBpEWXaTchmC9 |
| aGHS  | GHS (Ghanaian Cedi)     | AzimaUpF3WaRpJcWq8MKNeztkoPDRuwyBpEWXaTchmC9 |

Anchor framework. Mainnet.

### Cash page
- URL: https://azima.app/cash
- Users can mint aUGX/aKES/aGHS by depositing via mobile money, and redeem back to mobile money

---

## Mobile Money On/Off-Ramp

### Supported networks
- MTN Mobile Money (Uganda, Ghana)
- M-Pesa (Kenya)
- Airtel Money (Uganda, Kenya)

### Flow — Buy crypto with mobile money
1. User selects amount and currency (e.g. 100,000 UGX)
2. Azima provides a mobile money prompt / USSD push
3. On confirmation, Azima mints equivalent aUGX or sends USDC to user's wallet

### Flow — Sell crypto to mobile money
1. User selects token and amount
2. Azima quotes rate
3. User signs burn/transfer transaction
4. Azima disburses local currency to user's mobile money account

### Sell page
- URL: https://azima.app/sell

---

## Portfolio

- URL: https://azima.app/portfolio
- Aggregates balances across all connected wallets on Solana, Ethereum, Bitcoin, Polygon
- Shows: total net worth in USD, 24h change, per-asset breakdown with price and P&L
- Real-time price feeds

---

## Trading Bots

All bots are non-custodial — they operate using user-delegated signing authority scoped to bot parameters.

| Bot       | Description                                                  |
|-----------|--------------------------------------------------------------|
| Smart DCA | Dollar-cost average into any token on a schedule             |
| Grid      | Buy/sell within a price range automatically                  |
| Pump      | Momentum-based entry and exit                                |
| Sniper    | Instant buy on new token launches                            |
| Copy      | Mirror trades of a specified wallet address                   |

---

## Prediction Markets

- Live sports prediction markets with in-play trading
- Supported: Football (soccer) and expanding
- Users bet YES/NO on outcomes using aUGX or USDC
- Odds update in real-time during live matches
- Non-custodial: bets are locked in smart contract; payouts settle on-chain

---

## Crypto-Backed Lending

- Users deposit crypto as collateral
- Borrow stablecoins (USDC, aUGX) against collateral
- Two-phase flow: prepare loan → sign collateral lock → confirm loan disbursal
- Multi-chain collateral support

---

## Wallet Support

- Solana: native keypair (generated in-app), Phantom, other WalletAdapter-compatible wallets
- Ethereum / Polygon: WalletConnect v2 (via Reown AppKit)
- Bitcoin: native keypair (generated in-app)
- Web: Reown AppKit for EVM chains

---

## Number Formatting Reference

Azima uses locale-aware formatting. Examples:
- UGX amounts: `1,234,567 UGX` (no decimals, symbol after)
- KES amounts: `1,234.56 KES` (2 decimals, symbol after)
- USD amounts: `$1,234.56` (2 decimals, symbol before)
- SOL amounts: `1.2345` (4 decimals for values ≥ 1)
- Small crypto: `0.000123` (6 decimal places for values < 1)

---

## App Access

- Web: https://azima.app
- Android: https://play.google.com/store/apps/details?id=com.azima
- iOS: Pending

## Contact / Links

- Website: https://azima.app
- Swap: https://azima.app/swap
- Cash: https://azima.app/cash
- Sell: https://azima.app/sell
- Portfolio: https://azima.app/portfolio