# Plunder: Sovereign Abyss - AI Agent Skill Definition (Mainnet V1.0)

This document serves as the operational handbook for AI Agents, autonomous sub-routines, and smart contract indexers interacting with **The Great Plunder** ecosystem on the Tempo Mainnet.

## 1. Network Environment
- **Network**: Tempo Mainnet
- **RPC URL**: `https://rpc.tempo.xyz`
- **Native Currency**: pathUSD (pUSD)
- **Currency Standard**: TIP20 (Precompiled ERC20 Proxy)

## 2. Core Protocol Addresses
| Contract | Address | Standard |
|----------|---------|----------|
| **Plunder Minion (V6)** | `0x219af0E71E7e4B98ED0b31B6B53679D61503AfcD` | ERC-721 |
| **pathUSD (Native Proxy)** | `0x20C0000000000000000000000000000000000000` | ERC-20 |
| **$BUCK Token (Rewards)** | `0x49a2B2f2348480152A830BC24D5e38d2A733E09F` | ERC-20 |
| **The Arena** | `0x4B5052d6ef41b9cF30c45d54b028DE56f6200c76` | Custom |
| **Plunder Marketplace** | `0x4Fe7f0FE01C30f2177Ac0862ED18A44148ccC2D3` | Custom |

## 3. Interaction Primitives

### A. The Shipyard (Minting NFTs)
**Goal**: Acquire Plunder Minion NFTs using pathUSD.
- **Contract**: `Plunder Minion`
- **Logic**: The contract uses a whitelisted Merkle Proof logic.
- **Write (Prerequisite)**: `approve(Minion Address, 500000)` on the **pathUSD** contract.
- **Write**: `mint(uint256 quantity, bytes32[] proof)`
  - *Note*: `quantity` limited to 1-10.
  - *Cost*: Whitelist uses 0.35 pUSD (350,000 units). Public uses 0.50 pUSD (500,000 units).

### B. The Arena (Sector Maintenance)
**Goal**: Earn $BUCK rewards by staking and winning brawls.
- **Contract**: `The Arena`
- **Status**: [MAINTENANCE] Brawling and Staking systems will go live post-mint.
- **Goal**: Acquire $BUCK yield once the fleet is fully assembled.

### C. The Marketplace (Trading)
**Goal**: Exchange Minions for pathUSD.
- **Contract**: `Plunder Marketplace`
- **Currency**: Transactions are executed in **pathUSD**.
- **Write (Buy)**:
  1. `approve(Marketplace Address, price)` on **pathUSD**.
  2. `buyNFT(uint256 listingId)` on `Plunder Marketplace`.

---

### Agent Validation Checklist:
- [x] Wallet holds sufficient `pathUSD` (0x20C0...) for both gas and minting/purchasing.
- [x] Agent utilizes the **Approve First** flow to authorize TIP20 transfers before calling contract logic.
- [x] Whitelist status verified via `sailor_proofs.json` before attempting a discounted mint.