ERC-1155: Multi-Token StandardERC-1155

id = 1  →  "Gold Coin" (공급량 1,000,000) — 대체 가능 (Fungible)
id = 2  →  "Legendary Sword #001" (공급량 1) — 대체 불가 (NFT)
id = 3  →  "Silver Key" (공급량 50,000)     — 대체 가능 (Semi-fungible)

interface IERC1155 {
    // ── 조회 ─────────────────────────────────────────────
    // 특정 account가 보유한 id 토큰 수량
    function balanceOf(address account, uint256 id)
        external view returns (uint256);

    // 여러 account-id 쌍의 잔액 일괄 조회
    function balanceOfBatch(address[] calldata accounts, uint256[] calldata ids)
        external view returns (uint256[] memory);

    // operator가 owner의 모든 토큰 사용 권한 여부
    function isApprovedForAll(address owner, address operator)
        external view returns (bool);

    // 토큰 메타데이터 URI ({id} 자리표시자 포함)
    function uri(uint256 id) external view returns (string memory);

    // ── 전송 ─────────────────────────────────────────────
    // 단일 토큰 안전 전송
    function safeTransferFrom(
        address from, address to,
        uint256 id, uint256 amount, bytes calldata data
    ) external;

    // 복수 토큰 배치 안전 전송
    function safeBatchTransferFrom(
        address from, address to,
        uint256[] calldata ids, uint256[] calldata amounts,
        bytes calldata data
    ) external;

    // ── 승인 ─────────────────────────────────────────────
    // operator에게 모든 토큰 사용 권한 부여/회수
    function setApprovalForAll(address operator, bool approved) external;
}

// 단일 토큰 전송 시 발생
event TransferSingle(
    address indexed operator,
    address indexed from,
    address indexed to,
    uint256 id,
    uint256 value
);

// 배치 전송 시 발생
event TransferBatch(
    address indexed operator,
    address indexed from,
    address indexed to,
    uint256[] ids,
    uint256[] values
);

// 운영자 승인 변경 시 발생
event ApprovalForAll(
    address indexed account,
    address indexed operator,
    bool approved
);

// 토큰 URI 변경 시 발생
event URI(string value, uint256 indexed id);

interface IERC1155Receiver {
    // 단일 토큰 수신 훅
    function onERC1155Received(
        address operator,
        address from,
        uint256 id,
        uint256 value,
        bytes calldata data
    ) external returns (bytes4);
    // 반드시 bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))
    // == 0xf23a6e61 반환

    // 배치 토큰 수신 훅
    function onERC1155BatchReceived(
        address operator,
        address from,
        uint256[] calldata ids,
        uint256[] calldata values,
        bytes calldata data
    ) external returns (bytes4);
    // 반드시 bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))
    // == 0xbc197c81 반환
}

uri(id) 반환값 예시:
  "https://api.example.com/metadata/{id}.json"

클라이언트가 id=2를 조회할 때:
  "https://api.example.com/metadata/0000000000000000000000000000000000000000000000000000000000000002.json"
  ↑ id를 64자리 16진수 0-패딩 형태로 치환

{
  "name": "Legendary Sword",
  "description": "A rare weapon",
  "image": "ipfs://Qm.../sword.png",
  "decimals": 0,
  "properties": {
    "attack": 150,
    "rarity": "legendary"
  }
}

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

import "@openzeppelin/contracts/token/ERC1155/ERC1155.sol";

contract GameItems is ERC1155 {
    uint256 public constant GOLD   = 0;  // 대체 가능 (화폐)
    uint256 public constant SILVER = 1;  // 대체 가능 (화폐)
    uint256 public constant SWORD  = 2;  // 반대체 가능 (장비)
    uint256 public constant SHIELD = 3;  // 반대체 가능 (장비)
    uint256 public constant CROWN  = 4;  // 대체 불가 (희귀 아이템)

    constructor() ERC1155("https://game.example/api/item/{id}.json") {
        _mint(msg.sender, GOLD,   10**18, "");  // 100경 GOLD 발행
        _mint(msg.sender, SILVER, 10**27, "");
        _mint(msg.sender, SWORD,  1000,   "");
        _mint(msg.sender, SHIELD, 1000,   "");
        _mint(msg.sender, CROWN,  1,      ""); // NFT
    }
}

// 배치 민팅 (가스 절감)
// _mintBatch(msg.sender, [GOLD, SWORD, CROWN], [10**18, 1000, 1], "");