mamo

# Mamo — DeFi Yield Aggregator (Moonwell on Base)

Mamo is a DeFi yield aggregator built by Moonwell on Base chain. It deploys per-user smart contracts that split deposits between Moonwell core markets and Morpho vaults for optimized yield, with auto-compounding of rewards.

**Chain:** Base (8453)
**Strategies:** USDC stablecoin, cbBTC lending, ETH lending, MAMO staking

## Setup

```bash
cd ~/clawd/skills/mamo/scripts  # or wherever this skill lives
npm install
export MAMO_WALLET_KEY=0x...     # wallet private key
export MAMO_RPC_URL=https://...  # optional, defaults to Base public RPC
```

## Commands

```bash
# Create a yield strategy (deploys your personal strategy contract via on-chain factory)
node mamo.mjs create usdc_stablecoin
node mamo.mjs create cbbtc_lending
node mamo.mjs create eth_lending

# Deposit tokens (approve + deposit to your strategy contract)
node mamo.mjs deposit 100 usdc
node mamo.mjs deposit 0.5 cbbtc

# Withdraw tokens
node mamo.mjs withdraw 50 usdc
node mamo.mjs withdraw all cbbtc

# Account overview — wallet balances + strategy positions
node mamo.mjs status

# Current APY rates
node mamo.mjs apy
node mamo.mjs apy usdc_stablecoin
```

## How It Works

1. **Create strategy** → Calls the on-chain StrategyFactory to deploy a personal proxy contract owned by your wallet
2. **Deposit** → CLI approves token spend, then calls `deposit(amount)` on your strategy contract
3. **Yield accrues** → Strategy splits funds between Moonwell + Morpho, auto-compounds rewards via CowSwap
4. **Withdraw** → Only the owner (your wallet) can withdraw. Funds go directly to your wallet

Strategy addresses are stored locally in `~/.config/mamo/strategies.json` (the on-chain registry may not be updated for user-created strategies).

## Key Addresses

| Token | Address |
|-------|---------|
| USDC | `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` |
| cbBTC | `0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf` |
| MAMO | `0x7300b37dfdfab110d83290a29dfb31b1740219fe` |
| Registry...

# Mamo CLI

[![CI](https://github.com/moonwell-fi/openclaw-mamo-skill/actions/workflows/ci.yml/badge.svg)](https://github.com/moonwell-fi/openclaw-mamo-skill/actions/workflows/ci.yml)

A command-line interface for [Mamo](https://mamo.xyz), the DeFi yield aggregator built by [Moonwell](https://moonwell.fi) on Base.

## What is Mamo?

Mamo deploys personal smart contracts for each user that automatically:
- Split deposits between Moonwell core markets and Morpho vaults for optimal yield
- Claim and compound rewards (WELL, MORPHO) via CowSwap
- Maintain full user custody - only your wallet can withdraw

## Installation

### Global Installation (Recommended)

```bash
npm install -g mamo-cli
```

After installation, the `mamo` command will be available globally:

```bash
mamo --help
```

### Local Development

```bash
git clone https://github.com/moonwell-fi/openclaw-mamo-skill.git
cd openclaw-mamo-skill
npm install
npm run build
npm link  # Makes 'mamo' command available locally
```

## Quick Start

```bash
# Set your wallet private key
export MAMO_WALLET_KEY=0x...

# Check available APY rates
mamo apy

# Create a USDC yield strategy
mamo create usdc_stablecoin

# Deposit 100 USDC
mamo deposit 100 usdc

# Check your positions
mamo status

# Withdraw 50 USDC
mamo withdraw 50 usdc

# Withdraw everything
mamo withdraw all usdc
```

## Commands

### `mamo create <strategy>`

Create a yield strategy on-chain. This deploys a personal ERC1967 proxy contract owned by your wallet.

```bash
mamo create usdc_stablecoin
mamo create cbbtc_lending
mamo create eth_lending
```

### `mamo deposit <amount> <token>`

Deposit tokens into your yield strategy. The CLI will handle token approval if needed.

```bash
mamo deposit 100 usdc
mamo deposit 0.5 cbbtc
mamo deposit 1.0 eth
```

### `mamo withdraw <amount|all> <token>`

Withdraw tokens from your yield strategy. Use `all` to withdraw the entire balance.

```bash
mamo withdraw 50 usdc
mamo withdraw all cbbtc
```

### `mamo status`

Displa...