Add study notes for 2025-08-20

Author: AutoBot42

3956ray.md

@@ -15,6 +15,109 @@ timezone: UTC+8
 ## Notes
 
 <!-- Content_START -->
+# 2025-08-20
+
+下面以区块链与合约开发者的视角，系统阐述 ERC‑721 的定义、技术细节、实现要点与在合约/DeFi 中的典型用法，并配上若干可直接复用的代码示例，帮助你从标准到工程落地一把过。
+
+一、定义与背景
+- 定义：ERC‑721 是以太坊最早、最广泛使用的“非同质化代币”（NFT）标准，核心特性是“唯一性 + 可确权归属”，每个 tokenId 代表一个不可互换的资产单元。
+- 标准目标：
+  - 标准化拥有者查询、转移、授权与元数据访问的接口；
+  - 为合约间 NFT 交互提供强约束（如 safeTransfer 的合约接收回调）；
+  - 与钱包、市场、浏览器等基础设施的互操作性。
+- 对比 ERC‑20/EIP‑1155：
+  - ERC‑20 可替代；ERC‑721 完全非同质；
+  - ERC‑1155 为多代币/半同质模型，适合大规模铸造与批量转移；ERC‑721 更强调 “每个 tokenId 是独立实体”。
+
+二、核心接口与事件
+- IERC165：接口检测
+  - 合约需实现 supportsInterface(bytes4 interfaceId)
+- IERC721：核心
+  - balanceOf(owner)、ownerOf(tokenId)
+  - approve(to, tokenId)、getApproved(tokenId)、setApprovalForAll(operator, approved)、isApprovedForAll(owner, operator)
+  - transferFrom(from, to, tokenId)、safeTransferFrom(from, to, tokenId[, data])
+  - 事件：Transfer、Approval、ApprovalForAll
+- IERC721Receiver：合约安全接收回调
+  - onERC721Received(operator, from, tokenId, data) -> bytes4
+  - safeTransferFrom 若目标是合约，必须返回正确的 selector，否则 revert
+- IERC721Metadata（可选但行业事实标准）
+  - name()、symbol()、tokenURI(tokenId)
+- IERC721Enumerable（可选，不再推荐用于大规模集合）
+  - tokenOfOwnerByIndex、totalSupply、tokenByIndex（链上枚举成本高）
+- 常见扩展
+  - EIP‑2981: 版税标准（royaltyInfo）
+  - EIP‑2309: 批量铸造事件（ConsecutiveTransfer）用于部署期大批量 mint 记账
+  - EIP‑4494: NFT Permit（签名授权，无需先 on-chain approve）
+  - EIP‑4907: 可租用角色（user/expiry）
+
+三、实现要点与存储结构
+- 典型存储
+  - mapping(uint256 => address) _ownerOf
+  - mapping(address => uint256) _balanceOf
+  - mapping(uint256 => address) _tokenApprovals
+  - mapping(address => mapping(address => bool)) _operatorApprovals
+- 必备不变量
+  - ownerOf(tokenId) 非零地址代表已存在
+  - balanceOf 与 Transfer 事件保持一致性
+  - 转移后应清空 token 级别的 single-approval
+- 转移安全
+  - 对未知地址优先使用 safeTransferFrom，避免 NFT 被转进不支持的合约导致“黑洞”
+  - checks-effects-interactions 原则：在对外调用前更新状态，必要时加 ReentrancyGuard
+- 元数据
+  - tokenURI 返回 JSON 元数据 URL（可 HTTP/IPFS/Arweave/data URI）
+  - 大集合建议 baseURI + tokenId 拼接，或 on-chain SVG/JSON（需注意 gas）
+- 构造 tokenId
+  - 常用自增计数器（如 OpenZeppelin Counters）
+  - 若需随机/稀有度分布，慎用链上随机（需 VRF/预承诺等抗操纵机制）
+- Gas/可扩展性
+  - 尽量避免 IERC721Enumerable；链上枚举昂贵
+  - 大规模集合：考虑 EIP‑2309、稀疏存储压缩、或使用优化实现（如批量 mint 的 gas 模式、稀疏 ownership 记录）
+  - 升级性：使用代理（UUPS/Transparent），注意构造函数逻辑迁移到 initializer
+
+四、可用 ERC‑721（基于 OpenZeppelin）
+包含：安全转移、BaseURI、仅拥有者铸造
+
+```solidity:contracts/MyNFT.sol
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.20;
+
+import {ERC721} from "@openzeppelin/contracts/token/ERC721/ERC721.sol";
+import {Ownable} from "@openzeppelin/contracts/access/Ownable.sol";
+import {Strings} from "@openzeppelin/contracts/utils/Strings.sol";
+
+contract MyNFT is ERC721, Ownable {
+    using Strings for uint256;
+
+    string private _baseTokenURI;
+    uint256 private _nextId;
+
+    constructor(string memory name_, string memory symbol_, string memory baseURI_) ERC721(name_, symbol_) Ownable(msg.sender) {
+        _baseTokenURI = baseURI_;
+        _nextId = 1;
+    }
+
+    function setBaseURI(string calldata baseURI_) external onlyOwner {
+        _baseTokenURI = baseURI_;
+    }
+
+    function mint(address to) external onlyOwner returns (uint256 tokenId) {
+        tokenId = _nextId++;
+        _safeMint(to, tokenId); // 使用 safeMint，自动调用 onERC721Received
+    }
+
+    function _baseURI() internal view override returns (string memory) {
+        return _baseTokenURI;
+    }
+
+    // 如果需要自定义 tokenURI，可覆盖如下
+    function tokenURI(uint256 tokenId) public view override returns (string memory) {
+        _requireOwned(tokenId);
+        string memory base = _baseURI();
+        return bytes(base).length > 0 ? string(abi.encodePacked(base, tokenId.toString(), ".json")) : "";
+    }
+}
+```
+
 # 2025-08-19
 
 # 1. EIP-20