credex-protocol

# Credex Protocol Skill

Interact with the Credex Protocol—a decentralized credit system for AI agents on the Arc Network.

---

## Usage

**Base Directory:** `{baseDir}` (the directory containing this SKILL.md)

**Run all commands from the project root:**

```bash
cd {baseDir}
npx ts-node scripts/client.ts <command> [args]   # Borrower commands
npx ts-node scripts/lp.ts <command> [args]       # LP commands
```

**Output Format:** All scripts return **JSON** for machine readability. Parse the output to extract fields like `creditLimit`, `txHash`, `debt`, etc.

---

## Environment Variables

### Required (Must Be Set)

| Variable             | Description                                                                |
| -------------------- | -------------------------------------------------------------------------- |
| `WALLET_PRIVATE_KEY` | Private key for signing transactions. **Without this, all commands fail.** |
| `RPC_URL`            | Arc Network RPC. Default: `https://rpc.testnet.arc.network`                |

### Optional

| Variable              | Description             | Default                                      |
| --------------------- | ----------------------- | -------------------------------------------- |
| `CREDEX_POOL_ADDRESS` | Pool contract address   | `0x32239e52534c0b7e525fb37ed7b8d1912f263ad3` |
| `CREDEX_AGENT_URL`    | Credex agent server URL | `http://localhost:10003`                     |

**Pre-Flight Check:** Before running any command, verify `WALLET_PRIVATE_KEY` is set. If missing, prompt the user.

---

## Contract Addresses (Arc Testnet)

| Contract              | Address                                      |
| --------------------- | -------------------------------------------- |
| `CredexPool`          | `0x32239e52534c0b7e525fb37ed7b8d1912f263ad3` |
| `USDC` (Arc)          | `0x3600000000000000000000000000000000000000` |
| `USDC` (Base Sepolia) | `0x036CbD53842c5426634e7929541eC2318f3dCF7e` |

---

## Client Commands (Borro...

# Credex Protocol Skill

OpenClaw skill for interacting with the Credex Protocol—unsecured credit lines for AI agents on Arc Network.

## Features

- **Borrower Commands**: Check credit status, borrow USDC, repay debt
- **LP Commands**: Deposit liquidity, withdraw with yield, check pool metrics
- **Cross-Chain**: Bridge USDC between Arc and Base via Circle Bridge

## Installation

The skill is automatically installed when placed in `~/.openclaw/workspace/skills/credex-protocol/`.

## Quick Start

### Setup Environment

```bash
export WALLET_PRIVATE_KEY=0x...
export CREDEX_POOL_ADDRESS=0x60C04c09ee252C4e99C1B56580F7A0D3c65a3b36
export RPC_URL=https://rpc.testnet.arc.network
```

### Borrower (Client)

```bash
# Check your credit status
npx ts-node scripts/client.ts status

# Borrow 5 USDC
npx ts-node scripts/client.ts borrow 5

# Repay all debt
npx ts-node scripts/client.ts repay all

# Bridge to Base
npx ts-node scripts/client.ts bridge 10 arc base
```

### Liquidity Provider (LP)

```bash
# Check pool status
npx ts-node scripts/lp.ts pool-status

# Deposit 100 USDC
npx ts-node scripts/lp.ts deposit 100

# Withdraw all shares
npx ts-node scripts/lp.ts withdraw all
```

## Files

```
credex-protocol/
├── SKILL.md              # Main skill documentation
├── README.md             # This file
├── scripts/
│   ├── client.ts         # Borrower CLI
│   └── lp.ts             # LP CLI
└── references/
    └── contracts.md      # ABIs and contract info
```

## Dependencies

- `ethers` (v6)
- `@circle-fin/bridge-kit`
- `@circle-fin/adapter-viem-v2`
- `tsx` or `ts-node`

## Networks

- **Arc Testnet**: Chain ID 1328
- **Base Sepolia**: Chain ID 84532

## License

MIT