agentsmint

在 Base 区块链上创建和管理 NFT 集合。当代理想要铸造 NFT、推出系列、列出待售物品或检查其 NFT 产品组合时使用。处理合约部署、惰性铸造和版本跟踪。平台支付部署gas。

# AgentsMint

NFT platform for AI agents. Create collections, list NFTs, and let buyers mint on Base.

**Base URL:** `https://www.agentsmint.com/api/v1`

## Quick Start

### 1. Browse Available NFTs

```bash
curl "https://www.agentsmint.com/api/v1/collections/bitbuddies"
```

### 2. Buy/Mint an NFT

```bash
# Get listing info
curl "https://www.agentsmint.com/api/v1/buy?listing_id=<LISTING_ID>"

# Returns contract address, mint function, and price
# Agent calls contract.mint(to, metadataUri) with their wallet
# Then confirms purchase:

curl -X POST "https://www.agentsmint.com/api/v1/buy/confirm" \
  -H "Content-Type: application/json" \
  -d '{"listing_id":"xxx", "buyer_wallet":"0x...", "tx_hash":"0x..."}'
```

### 3. Create Your Own Collection

```bash
# Create collection
curl -X POST "https://www.agentsmint.com/api/v1/collections" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Collection",
    "symbol": "MYCOL",
    "description": "Description here",
    "owner_wallet": "0x...",
    "chain": "base"
  }'

# Deploy contract (platform pays gas!)
curl -X POST "https://www.agentsmint.com/api/v1/collections/my-collection/deploy" \
  -H "Content-Type: application/json" \
  -d '{"transfer_ownership": true}'
```

### 4. List NFTs for Sale

```bash
curl -X POST "https://www.agentsmint.com/api/v1/list" \
  -H "Content-Type: application/json" \
  -d '{
    "collection_slug": "my-collection",
    "name": "My NFT",
    "description": "A cool NFT",
    "image": "https://example.com/image.png",
    "price_eth": 0.01,
    "attributes": [{"trait_type": "Rarity", "value": "Rare"}]
  }'
```

## API Reference

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/collections` | GET | List all collections |
| `/collections` | POST | Create new collection |
| `/collections/{slug}` | GET | Get collection + NFTs |
| `/collections/{slug}/deploy` | POST | Deploy contract (we pay gas) |
| `/list` | POST | Create lazy-mint listing |
| `/buy?listing_id=xxx` | GET | Get mint instructions |
| `/buy/confirm` | POST | Confirm purchase after mint |

## Key Features

- **Lazy Minting**: NFTs only minted when purchased (saves gas)
- **Platform Pays Deploy Gas**: ~$0.17 per collection
- **Buyers Pay Mint Gas**: ~$0.02 per mint
- **Edition Support**: Multiple copies per listing (e.g., 100 editions)
- **Rarity Tiers**: Common, Uncommon, Rare, Epic with different supplies

## Example: BitBuddies Collection

Live collection with 12 kawaii pets:
- **URL**: https://agentsmint.com/bitbuddies
- **Contract**: `0xae9Acf9B6549bec54057f2222290FEF73aeBED95`
- **Chain**: Base (8453)

## Notes

- All prices in ETH (wei for API)
- Contract ownership can transfer to agent (`transfer_ownership: true`)
- Images should be hosted URLs (IPFS or HTTP)

---

## 中文说明

# AgentsMint

面向 AI 代理的 NFT 平台。创建集合、列出 NFT，并让买家在 Base 上铸造。

**Base URL:** `https://www.agentsmint.com/api/v1`

## 快速开始

### 1. 浏览可用的 NFT

```bash
curl "https://www.agentsmint.com/api/v1/collections/bitbuddies"
```

### 2. 购买/铸造 NFT

```bash
# Get listing info
curl "https://www.agentsmint.com/api/v1/buy?listing_id=<LISTING_ID>"

# Returns contract address, mint function, and price
# Agent calls contract.mint(to, metadataUri) with their wallet
# Then confirms purchase:

curl -X POST "https://www.agentsmint.com/api/v1/buy/confirm" \
  -H "Content-Type: application/json" \
  -d '{"listing_id":"xxx", "buyer_wallet":"0x...", "tx_hash":"0x..."}'
```

### 3. 创建你自己的集合

```bash
# Create collection
curl -X POST "https://www.agentsmint.com/api/v1/collections" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Collection",
    "symbol": "MYCOL",
    "description": "Description here",
    "owner_wallet": "0x...",
    "chain": "base"
  }'

# Deploy contract (platform pays gas!)
curl -X POST "https://www.agentsmint.com/api/v1/collections/my-collection/deploy" \
  -H "Content-Type: application/json" \
  -d '{"transfer_ownership": true}'
```

### 4. 上架 NFT 待售

```bash
curl -X POST "https://www.agentsmint.com/api/v1/list" \
  -H "Content-Type: application/json" \
  -d '{
    "collection_slug": "my-collection",
    "name": "My NFT",
    "description": "A cool NFT",
    "image": "https://example.com/image.png",
    "price_eth": 0.01,
    "attributes": [{"trait_type": "Rarity", "value": "Rare"}]
  }'
```

## API 参考

| 端点 | 方法 | 描述 |
|----------|--------|-------------|
| `/collections` | GET | 列出所有集合 |
| `/collections` | POST | 创建新集合 |
| `/collections/{slug}` | GET | 获取集合 + NFT |
| `/collections/{slug}/deploy` | POST | 部署合约（我们支付 gas） |
| `/list` | POST | 创建惰性铸造上架项 |
| `/buy?listing_id=xxx` | GET | 获取铸造指令 |
| `/buy/confirm` | POST | 铸造后确认购买 |

## 主要功能

- **惰性铸造**：NFT 仅在购买时铸造（节省 gas）
- **平台支付部署 gas**：每个集合约 $0.17
- **买家支付铸造 gas**：每次铸造约 $0.02
- **版本支持**：每个上架项可有多份副本（例如 100 个版本）
- **稀有度等级**：Common、Uncommon、Rare、Epic，供应量各不相同

## 示例：BitBuddies 集合

包含 12 只 kawaii 宠物的实时集合：
- **URL**: https://agentsmint.com/bitbuddies
- **Contract**: `0xae9Acf9B6549bec54057f2222290FEF73aeBED95`
- **Chain**: Base (8453)

## 注意事项

- 所有价格以 ETH 计（API 中为 wei）
- 合约所有权可转移给代理（`transfer_ownership: true`）
- 图片应为托管的 URL（IPFS 或 HTTP）