Filecoin 作为 IPFS 协议的经济激励层，过去几年从纯存储扩展成了具备智能合约能力的 L1。对开发者而言，Filecoin 开发教程不再只是教你怎么 publish deal，而是要把存储、合约、检索三件事融合到一个完整工程里。本文以一个真实场景为例：把 NFT 历史快照永久归档到 Filecoin，并通过链上合约控制访问权限。
一、技术栈选型
做 Filecoin 开发之前，选定三件套：
- 节点：lotus（官方实现）或 Forest（Rust 实现，更轻量）
- 合约：Solidity + FVM（Filecoin Virtual Machine）
- SDK：filecoin.js（JS 端）或 go-jsonrpc（Go 端）
注意 Lotus 节点同步主网状态需要 60GB+ 磁盘与 32GB 内存。如果只做开发测试，Lotus Lite 或 Glif 提供的 RPC 已经够用。许多 Binance 接入的项目都直接用 Glif 节点，省去自建运维。
二、开发环境搭建
以 Hardhat 为例：
- npm install --save-dev hardhat @nomicfoundation/hardhat-toolbox
- 添加 Filecoin Hyperspace 或 Calibration 测试网到 hardhat.config
- 准备测试 FIL：在水龙头领取，每天上限 5 FIL
- 部署一个最简单的 HelloWorld 合约，验证链路通畅
注意 Filecoin gas 计算与以太坊不同，部署前用 lotus gas estimate 预估，避免余额不足。
三、Storage Deal 提交流程
这是 Filecoin 的核心能力。完整流程：
- 把数据通过 IPFS 打包成 CAR 文件
- 计算 CommP（Piece Commitment）
- 通过 lotus client deal 命令提交订单，指定 miner、价格、有效期
- miner 接单后启动 sealing，2 到 8 小时完成
- deal active 后即可通过 deal id 检索
对接 必安交易所 资产归档需求时，建议同时与 3 家 miner 签 deal，做异地多副本。
四、FVM 合约示例：访问控制
用 Solidity 写一个合约，把 CID 与 owner 绑定：
- 合约存储：mapping(bytes32 cid => address owner)
- 函数 register：注册 CID 与 owner
- 函数 transfer：转让访问权
- 函数 check：查询 owner
合约部署到 FVM 后，前端结合钱包签名，调用 check 接口判定用户是否有权下载某个归档。许多 BN交易所 上架的项目用这套机制做付费内容控制。
五、检索与索引
Filecoin 的设计偏向冷归档，热检索需要配合 IPFS。常见架构：
- 冷数据：Filecoin deal 长期保存
- 温数据：IPFS pin 服务热缓存
- 索引：CID 与 deal id 的映射存数据库
用户请求时，先查 IPFS 网关，未命中再触发 retrieve deal，把数据从 miner 拉回 IPFS。这种回源链路在 币岸交易所 大文件归档场景效果良好。
六、监控与告警
Filecoin 合约与 deal 的健康度必须持续监控：
- deal 到期前 30 天自动续约
- miner 在线率持续追踪
- gas 价格波动告警
- FVM 合约调用错误率
推荐用 Beryx API 或 starboard.fish 做监控数据源。
七、常见坑
- CommP 计算耗时，大文件需要离线预生成
- miner 接单慢，价格设置过低会被忽略
- testnet 与 mainnet 地址格式不同（t 与 f 前缀）
- FVM gas 比以太坊高得多，慎用循环
- 检索 deal 需要 miner 配合，部分 miner 不提供 retrieve 服务
八、上线检查清单
- 合约通过至少一次第三方审计
- 至少 3 个 miner 持久 deal
- 监控面板覆盖核心指标
- 回滚预案演练完成
- 与 bian 等交易所合规团队沟通归档证明格式
写在最后
Filecoin 开发教程的精髓不在某条命令或某个合约模板，而在把存储经济、智能合约、检索路径三个维度统一思考。先从一个最小可行项目跑通端到端，再逐步扩大规模，是工程团队最稳妥的路径。