# ERC1155

### 想像一個遊戲裡，既有金幣（可互換）又有獨特武器（不可互換）。在以前，你需要兩個不同的合約分別處理。ERC1155 說：「一個合約搞定！」這就是為什麼它被稱為「多代幣標準」。

> ⚠️ **免責聲明**：本文僅供教育目的，不構成投資建議。加密貨幣投資有風險，請自行研究（DYOR）後再做決定。

***

## 什麼是 ERC1155？

| 項目   | 說明            |
| ---- | ------------- |
| 提案編號 | EIP-1155      |
| 提出者  | Enjin 團隊      |
| 類型   | 多代幣標準         |
| 特色   | 同時支援 FT 和 NFT |

***

## ERC1155 vs 其他標準

### 比較表

| 特性     | ERC20 | ERC721 | ERC1155 |
| ------ | ----- | ------ | ------- |
| 代幣類型   | 同質    | 非同質    | 兩者皆可    |
| 批量轉移   | ❌     | ❌      | ✅       |
| Gas 效率 | 一般    | 較高     | 最優      |
| 適用場景   | 貨幣    | 收藏品    | 遊戲      |

### 技術差異

```
三種標準的設計差異：

ERC20（同質代幣）：
- balanceOf(address) → 餘額
- transfer(to, amount)
- 每個代幣完全相同

ERC721（NFT）：
- ownerOf(tokenId) → 擁有者
- transferFrom(from, to, tokenId)
- 每個代幣唯一

ERC1155（多代幣）：
- balanceOf(address, id) → 特定代幣餘額
- safeBatchTransferFrom(from, to, ids[], amounts[])
- 可以是同質或非同質
- 支援批量操作
```

***

## 主要特點

### 批量操作

```
ERC1155 的批量能力：

場景：轉移 10 種不同物品

ERC721 做法：
- 呼叫 10 次 transferFrom
- 10 筆交易
- 10 倍 Gas 費

ERC1155 做法：
- 呼叫 1 次 safeBatchTransferFrom
- 1 筆交易
- 大幅節省 Gas

程式碼示例：
safeBatchTransferFrom(
  from,
  to,
  [id1, id2, id3, id4, id5],  // 多個物品 ID
  [10, 5, 1, 100, 1],         // 各自數量
  data
)
```

### 半同質代幣

| 類型    | 說明        | 例子     |
| ----- | --------- | ------ |
| 同質部分  | 可互換、可堆疊   | 遊戲金幣   |
| 非同質部分 | 每個獨特      | 傳奇裝備   |
| 半同質   | 同類可換、跨類不行 | 同款劍的多把 |

***

## 應用場景

### 遊戲產業

```
ERC1155 在遊戲中的應用：

一個 RPG 遊戲可能有：

同質資源：
- 金幣（每枚相同）
- 木材（可堆疊）
- 鑽石（通用貨幣）

非同質物品：
- 角色（每個獨特）
- 傳奇武器（限量唯一）
- 土地（位置唯一）

半同質物品：
- 普通劍（同款可換）
- 藥水（同類型相同）
- 箱子（同類別相同）

一個 ERC1155 合約全部搞定！
```

### 其他應用

| 應用   | 說明     |
| ---- | ------ |
| 活動票券 | 同類票券互換 |
| 會員卡  | 批量發行   |
| 數位收藏 | 限量版系列  |

***

## Metadata 結構

### OpenSea 範例

```json
{
    "name": "Edward Snowden (Supporting Image 2)",
    "description": "NFT 描述文字...",
    "external_link": null,
    "image": "https://lh3.googleusercontent.com/...",
    "animation_url": null
}
```

### Metadata 取得

```
取得 NFT Metadata 的方式：

API 呼叫：
GET /api/v1/metadata/{contract}/{tokenId}

回傳內容：
- name: NFT 名稱
- description: 描述
- image: 圖片 URL
- animation_url: 動畫 URL
- attributes: 屬性陣列

重要提醒：
- Metadata 通常存在鏈下
- 使用 IPFS 更去中心化
- 中心化伺服器有風險
```

***

## 開發考量

### 實作要點

| 要點     | 說明                   |
| ------ | -------------------- |
| 接收檢查   | 實作 onERC1155Received |
| 批量邏輯   | 正確處理陣列               |
| URI 管理 | 動態生成 Metadata        |
| 權限控制   | setApprovalForAll    |

```
ERC1155 合約範例結構：

contract MyGameItems is ERC1155 {
    // 代幣類型常數
    uint256 public constant GOLD = 0;
    uint256 public constant SILVER = 1;
    uint256 public constant SWORD = 2;
    uint256 public constant SHIELD = 3;

    constructor() ERC1155("https://game.example/api/item/{id}.json") {
        // 初始化：鑄造一些代幣
        _mint(msg.sender, GOLD, 10000, "");      // 10000 金幣
        _mint(msg.sender, SILVER, 5000, "");     // 5000 銀幣
        _mint(msg.sender, SWORD, 100, "");       // 100 把劍
        _mint(msg.sender, SHIELD, 50, "");       // 50 個盾
    }
}
```

{% hint style="info" %}
**URI 中的 {id}**

ERC1155 的 Metadata URI 可以使用 {id} 佔位符，合約會自動替換成實際的代幣 ID，實現動態 Metadata。
{% endhint %}

***

## 延伸閱讀

* [ERC721](https://www.0x1.academy/shu-wei-yi-shu-yu-shou-cang-pin/erc721) — NFT 標準
* [ERC20：代幣標準](https://www.0x1.academy/zhi-neng-he-yue-de-shi-jie/erc20-1) — 同質代幣標準
* [同質 vs 非同質](https://www.0x1.academy/shu-wei-yi-shu-yu-shou-cang-pin/tong-nfts) — 代幣類型比較
* [ERC 與 EIP](https://www.0x1.academy/zhi-neng-he-yue-de-shi-jie/smart-contract/smart-contract-developer/erc-eip) — 以太坊改進提案

***

#### 參考資料

* [EIP-1155 官方提案](https://eips.ethereum.org/EIPS/eip-1155)
* OpenSea 開發文件
* Enjin 技術文件