项目实例:区块链 × 物联网
一个冷链温控可信溯源与自动理赔平台的完整设计:架构、数据模型、合约、资料清单与未来改进空间,以及它真正解决的生产问题。
场景:一箱疫苗的 1800 公里
一批需要全程 2~8℃ 冷藏的生物制品,从苏州的生产企业发出,送到成都的收货单位。全程 1800 公里、约 42 小时,被切成三段:
① 干线运输
生产企业 → 承运商 A 的冷藏车 → 武汉中转冷库。
② 中转暂存
冷库卸货、入库、出库,涉及一次责任交接与一次温度环境切换。
③ 区域配送
承运商 B 的冷藏车 → 成都收货单位,末端还有多次开门卸货。
参与方一共七个:生产企业、承运商 A、中转冷库、承运商 B、收货单位、保险公司、行业监管。每一方都有自己的系统,每一方都只相信自己系统里的数据——这就是问题开始的地方。
它到底解决了什么生产问题
先说清楚"为什么必须用区块链",否则就是一个普通的物联网监控项目。
| 生产痛点 | 改造前的做法 | 区块链 + IoT 之后 | 产生的价值 |
| 温控数据不可信 | 随车记录仪可事后补录,纸质温度记录可以"照着标准值"补写;最常见的造假是到货前把探头放进保温杯。 | 温度值在设备端由安全芯片签名后才发出,平台与司机都无法代签;缺签名的样本一律标记为不可采信。 | 把"信不信这份数据"变成"验一下签名",争议从扯皮变成技术判定。 |
| 责任界定困难 | 三段运输各记各的,超温后互相甩锅,最后靠保险公司派人现场取证。 | 每一段起止都有双签交接事件(双方签名 + 时间 + GPS + 铅封号),超温时刻可精确落在某一责任段的某一分钟。 | 责任判定从"协商 30 天"变成"查链 3 分钟"。 |
| 异常发现严重滞后 | 货到目的地才导数据,超温往往已持续十几小时,整车报废。 | 边缘网关实时跑规则,超温即刻触发链上事件 + 短信/电话通知,途中可补冷、可就近进冷库。 | 从"事后报废"变为"途中挽救",直接减少货损。 |
| 理赔与结算周期长 | 人工收集各方记录、比对、定责、核算,30~60 天是常态。 | 理赔规则写进合约并版本化,触发条件满足即自动计算责任方与赔付比例,证据包自动生成。 | 结算周期压缩到天级,同时减少错赔与通融赔付。 |
| 监管取证与审计难 | 监管方做一次检查要向多家企业分别调数据,格式不一、时间对不上。 | 监管方作为只读节点接入,直接同步链上数据;证据链自带时间戳与签名,不可抵赖。 | 检查成本大幅下降,企业也从"反复迎检"中解放出来。 |
| 多方数据不互认 | 每家一套系统,对账靠人工导 Excel,口径不一致。 | 统一数据模型与合约接口,各方基于同一份账本对账,链下系统各自保留。 | 不推翻现有系统,只增加一层"共同认可的真相"。 |
总体架构:五层与它们的职责
| 层 | 关键组件 | 这一层必须做到的事 |
| 感知层 | 温控终端、安全芯片(SE/TPM)、GPS、门磁、冷机控制器 | 私钥出厂注入安全芯片且永不出芯片;每条样本带设备签名与单调计数器(防重放);上报校准证书编号与有效期。 |
| 边缘层 | 工业网关(ARM,宽温,4G/5G + 有线) | 弱网与断网下不丢数据(本地持久化队列);按窗口聚合+Merkle 打包;本地规则秒级告警;作为设备向链发交易的代理(设备不直接连链)。 |
| 平台层 | EMQX、TDengine、MinIO、规则引擎、索引服务 | 承接高吞吐明细数据;把链上事件回写索引,供应用查询;只把锚定交易发往链,不把明细灌进链。 |
| 区块链层 | 联盟链(4~7 共识节点)+ 监管只读节点 + 合约集 | 提供跨机构的共同账本与自动执行;合约版本化;节点分布在不同参与方机房;监管节点只同步不参与共识。 |
| 应用层 | API 网关、Web 看板、扫码验真页、对账结算、监管视图 | 面向不同角色提供不同视图;对外只暴露"验证"能力,不暴露其他客户的业务数据。 |
一次运输的完整流程
- 建单与绑定生产企业在平台创建运单(批次号、温区、允许偏差、参与方清单),调用运单合约写入链;装车时扫描设备序列号,生成设备—运单绑定交易。
- 在途采集终端每 60 秒采样一次温度/湿度,签名后发往边缘网关;网关聚合为 15 分钟窗口,计算 min/max/avg 与超限次数。
- 批量锚定每小时(或每 20 个窗口)把该时段所有原始样本构造成 Merkle 树,仅把根哈希 + 统计摘要 + 设备签名提交到存证合约。
- 异常告警网关本地判定超温即上链
ExcursionDetected事件并通知责任人;应用侧触发处置工单(补冷 / 就近入库 / 改派)。 - 中转交接卸货方与接货方各自用 App 签名确认(时间、GPS、铅封号、外观照片哈希),两笔签名齐全才生成
HandoverConfirmed。 - 到货结案生成全程报告(PDF)+ 所有窗口的 Merkle 根清单,报告哈希上链;运单状态置为
CLOSED。 - 自动理赔若途中出现定责事件,理赔合约按规则版本读取链上交接与超温记录,计算责任段与赔付比例,生成
ClaimSettled,各方对账。
链上数据模型与合约设计
设计原则:链上存"可判定的事实与承诺",链下存"可分析的明细"。下面是一套可直接落地的结构(字段名保持 snake 风格便于与链下对齐)。
| 结构 | 主要字段 | 上链方式 |
| Device 设备 | device_id、pub_key、cert_hash、vendor、model、calib_expire、status | 写入(注册/吊销) |
| Shipment 运单 | shipment_id、batch_no、product_code、temp_min/max、allow_excursion_min、parties[]、status | 写入 |
| Binding 绑定 | shipment_id、device_id、bind_ts、unbind_ts、sig | 写入 |
| TempAnchor 温控锚定 | anchor_id、shipment_id、period_start/end、sample_count、t_min/t_max/t_avg、excursion_count、merkle_root、raw_uri、device_sig | 写入(高频) |
| Handover 交接 | shipment_id、from_party、to_party、gps、seal_no、photo_hash、ts、sig_from、sig_to | 写入(双签) |
| Incident 异常 | shipment_id、type、start_ts、duration_s、max_deviation、evidence_ref、handled | 写入 |
| Claim 理赔 | claim_id、shipment_id、liable_party、amount、rule_version、state | 写入 + 状态机 |
合约划分:建议拆成四个合约而不是一个巨石合约,便于升级与权限隔离。
| 合约 | 主要接口 | 权限 |
| DeviceRegistry | register() revoke() rotateKey() isActive() | 厂商 + 联盟管理员 |
| Shipment | create() bindDevice() confirmHandover(from,to,…) close() | 参与方各自签名 |
| TempOracle(存证) | submitAnchor(anchor) getAnchors(shipmentId) verifySample(root, leaf, proof) | 边缘网关(白名单)+ 设备签名校验 |
| ClaimRule / Claim | setRule(version, params) evaluate(shipmentId) settle() appeal() | 规则由联盟治理投票;结算自动 |
对外发出的事件(供链下索引服务消费):AnchorSubmitted、ExcursionDetected、HandoverConfirmed、IncidentHandled、ClaimSettled。事件只放 ID 与关键字段,详细内容查链下。
上链策略:什么上链,什么坚决不上链
| 数据 | 是否上链 | 理由 |
| 每一条温度采样值(秒级/分钟级) | 不上链 | 量大、无独立判定价值;存时序库,用 Merkle 根整体锚定即可。 |
| 15 分钟窗口的统计 + Merkle 根 | 上链 | 既能判定是否超标,又能用根哈希验证任意一条原始样本未被改。 |
| 设备签名与公钥指纹 | 上链 | 证明数据来源,是整套信任的锚点。 |
| 交接双签记录 | 上链 | 责任切分的关键事实,争议时唯一依据。 |
| 客户名称、药品价格、合同金额 | 不上链 | 商业隐私;链上只放哈希,明文留在各自系统内。 |
| 司机姓名、电话等个人信息 | 不上链 | 个人信息保护要求;如必须关联,用假名 ID + 链下授权解密。 |
| 视频、照片、PDF 报告 | 不上链 | 存对象存储,哈希上链,链上存 URI(注意 URI 可用性与防篡改)。 |
技术选型与资料清单
| 层 | 组件 | 用途与选型理由 | 资料 |
| 设备 | STM32 + SHT3x 温湿度 + BC26/N58 NB-IoT;ATECC608A 或 OPTIGA 安全芯片 | 低成本、低功耗;签名在芯片内完成,私钥不可导出,从物理上解决"平台代签"。 | Microchip ATECC608A 数据手册与 cryptoauthlib |
| 设备 | GPS/北斗模块、门磁开关、铅封(带 RFID/二维码) | 提供位置与"是否被打开"的佐证,与温度联合判责。 | 国标铅封与 RFID 相关规范 |
| 边缘 | ARM 工业网关(Debian + Docker)、本地 SQLite/LevelDB 队列 | 断网续传、本地规则、打包;比"终端直连链"可靠得多。 | EMQX Neuron / eKuiper 边缘流处理文档 |
| 接入 | EMQX(MQTT Broker) | 单机可支撑十万级连接;支持 TLS 双向认证与主题级 ACL。 | emqx.io 文档 |
| 存储 | TDengine / InfluxDB(时序)、MinIO(对象)、PostgreSQL(业务) | 时序库压缩比高、按时间窗口查询快,适合温度明细。 | tdengine.com 文档 |
| 链 | FISCO BCOS 或长安链 ChainMaker(国产联盟链) | 无 Gas 成本、权限体系完善、国密支持、有配套中间件与控制台,适配国内合规要求。 | fisco-bcos.org、chainmaker.org.cn 官方文档 |
| 链中间件 | WeBASE(FISCO 配套)或长安链 cmc / 链下索引服务 | 合约管理、私钥托管、事件订阅、交易上链封装,省掉大量重复开发。 | webasedoc.readthedocs.io |
| 应用 | FastAPI / Spring Boot、Vue3、Grafana | API 与看板;Grafana 直接读时序库画温度曲线与告警带。 | grafana.com 文档 |
| 标准 | GS1 EPCIS 2.0、GB/T 冷链物流相关规范、GSP、IEEE 2418.2 | 事件模型与编码对齐国标/国际标准,避免每接一个伙伴改一次接口。 | gs1.org、ieee.org 标准文本 |
部署拓扑与代码结构
最小可用部署:链 4 节点(分布在生产、承运 A、冷库、监管四方机房)+ 1 个监管只读节点;平台侧单机 Docker Compose 起步,后期再拆。
# docker-compose.yml(平台侧精简版)
services:
emqx:
image: emqx/emqx:5.7
ports: ["1883:1883", "8883:8883", "18083:18083"]
tdengine:
image: tdengine/tdengine:3.3.0.0
volumes: ["td-data:/var/lib/taos"]
minio:
image: minio/minio
command: server /data --console-address ":9001"
indexer: # 订阅链上事件 → 写业务库,供 API 查询
build: ./services/indexer
environment:
CHAIN_RPC: "http://chain-node1:8545"
api:
build: ./services/api
ports: ["8000:8000"]
web:
build: ./web
ports: ["8080:80"]
coldchain-bcp/ # 项目目录建议结构
├── contracts/ # 合约(Solidity / ChainMaker 的 Rust/Go 合约)
│ ├── DeviceRegistry.sol
│ ├── Shipment.sol
│ ├── TempOracle.sol
│ ├── Claim.sol
│ └── test/ # 合约单测:权限、双签、边界温度
├── device/ # 终端固件(C)+ 安全芯片驱动
├── edge/ # 边缘网关(Python/Go)
│ ├── collector.py # MQTT 订阅 + 验签 + 落本地队列
│ ├── window.py # 15 分钟聚合统计
│ ├── merkle.py # Merkle 树构造与证明
│ └── anchor.py # 调合约 submitAnchor,失败重试
├── services/
│ ├── indexer/ # 链上事件 → 业务库
│ ├── api/ # REST:运单、看板、验证
│ └── notifier/ # 告警通知(短信/电话/企微)
├── web/ # 看板 + 扫码验真页
└── deploy/ # ansible / compose / 监控告警规则
四段关键代码
① 设备端:签名后再上报
# 终端侧伪码:真实实现在 MCU 内调用安全芯片
payload = {
"device_id": DEVICE_ID,
"ts": rtc_time(), # 需做时钟漂移校正,或用网关时间兜底
"temp": 4.62, "rh": 58.1,
"lat": 31.31, "lng": 120.62,
"seq": monotonic_counter(), # 单调计数,防重放与补录
"calib": CALIB_CERT_NO,
}
canon = json.dumps(payload, sort_keys=True, separators=(",", ":"))
payload["sig"] = se_sign(sha256(canon)) # 私钥不出芯片
mqtt.publish(f"cc/{DEVICE_ID}/sample", json.dumps(payload), qos=1)
② 边缘:窗口聚合 + Merkle 锚定
import hashlib
def _h(b): return hashlib.sha256(b).digest()
def merkle_root(leaves): # leaves: 已规范化的样本字节串列表
if not leaves: return None
lvl = [_h(x) for x in leaves]
while len(lvl) > 1:
if len(lvl) % 2: lvl.append(lvl[-1]) # 奇数复制最后一个
lvl = [_h(lvl[i] + lvl[i+1]) for i in range(0, len(lvl), 2)]
return lvl[0].hex()
def build_anchor(samples): # 一个 15 分钟窗口
leaves = [canonical(s) for s in samples]
temps = [s["temp"] for s in samples]
return {
"period_start": samples[0]["ts"], "period_end": samples[-1]["ts"],
"sample_count": len(samples),
"t_min": min(temps), "t_max": max(temps),
"t_avg": round(sum(temps)/len(temps), 2),
"excursion_count": sum(1 for t in temps if t < LO or t > HI),
"merkle_root": merkle_root(leaves),
"raw_uri": f"s3://coldchain/{SHIPMENT}/{samples[0]['ts']}.jsonl",
}
# 之后由 anchor.py 签名并调用 TempOracle.submitAnchor,落库前先写本地 outbox 表保证不丢
③ 合约:异常判定与自动定责(核心逻辑片段)
function evaluate(bytes32 shipmentId) external returns (address liable, uint256 ratioBp) {
Shipment storage s = shipments[shipmentId];
require(s.status == Status.CLOSED, "not closed");
// 找出累计超限时长最长的一段(段由交接事件切分)
uint256 worst; uint16 worstSeg;
for (uint16 i = 0; i < s.segCount; i++) {
uint256 d = excursionSeconds(shipmentId, i);
if (d > worst) { worst = d; worstSeg = i; }
}
if (worst == 0) return (address(0), 0); // 全程达标,不赔
Rule storage r = rules[s.ruleVersion]; // 规则版本化,避免事后改规则
if (worst < r.toleranceSec) return (address(0), 0); // 容差内视为正常(开门卸货等)
liable = s.segParty[worstSeg];
ratioBp = uint256(worst) * 10000 / totalSeconds(shipmentId);
emit ClaimSettled(shipmentId, liable, ratioBp, s.ruleVersion);
}
④ 对外验证:任何人可验,但看不到别人的数据
# FastAPI:扫码验真接口——只回答"是/否 + 时间",不返回明细
@app.post("/verify")
def verify(file: UploadFile, shipment_id: str = Form(...)):
raw = file.file.read()
dg = hashlib.sha256(raw).hexdigest()
rec = chain.call("TempOracle", "getAnchors", shipment_id) # 链上锚定记录
hit = [a for a in rec if a["report_hash"] == dg]
return {
"match": bool(hit),
"anchored_at": hit[0]["ts"] if hit else None,
"shipment": bool(rec), # 运单是否存在
"excursion": sum(a["excursion_count"] for a in rec), # 只给次数不给曲线
}
实施效果与成本(设计目标)
| 指标 | 改造前(常见量级) | 本方案目标 | 达成路径 |
| 超温发现时延 | 到货后数小时至数天 | ≤ 60 秒 | 边缘本地规则 + 即时通知 |
| 责任判定耗时 | 数天至数周 | 分钟级(自动) | 双签交接 + 链上记录自动比对 |
| 理赔结案周期 | 30~60 天 | 3~7 天 | 规则合约 + 证据包自动生成 |
| 货损率 | 行业普遍为千分之几到百分之几 | 相对下降 30%~50% | 途中干预 + 责任清晰带来的行为改善 |
| 监管检查取证 | 跨企业人工调取 | 在线一键导出 | 监管只读节点 + 证据链 |
| 上链成本 | — | 每运单数十次写入 | 窗口聚合 + Merkle 批量锚定 |
成本构成:终端改造(安全芯片与固件,一次性)+ 边缘网关(每车/每库一台)+ 链节点服务器(每方 1~2 台)+ 平台与运维。最大的隐性成本往往不是技术,而是多方协调与规则谈判——"超温多久算责任""容差多少分钟"这些业务规则,比写代码更难达成一致。
边界:这套方案解决不了什么
传感器本身被骗
把探头放进保温杯、用冰袋贴住传感器,链会忠实地记录下一个"完美"的温度曲线。链保证的是记录未被改,不是测量对象真实。应对:多点布点(回风/送风/货箱中心)、开门与位移传感器交叉验证、随机飞行抽检、铅封与视频留存。
设备校准过期
未校准的探头数据同样"不可篡改",只是不可信。应对:链上记录校准证书编号与有效期,过期后该设备数据自动降级为"参考值",不参与判责。
系统可用性
链不宕机不代表业务不中断;MQTT、时序库、API 任何一环挂掉都会影响监控。应对:边缘自治(断网仍告警)、全链路监控与演练。
隐私与数据合规
位置轨迹属于敏感个人信息,跨境场景还涉及数据出境。应对:数据分级、链上只放哈希与假名 ID、访问授权留痕、必要时做数据出境评估。
治理不是技术问题
联盟链是"多中心"而非"无中心":节点谁运维、新成员怎么加入、争议如何仲裁、合约升级谁签字,都必须事先写进联盟章程。
不是所有数据都值得上链
把明细全灌上链是最常见的错误做法:成本飙升、性能崩塌、隐私外泄。坚持"摘要上链、明细链下、哈希锚定"。
未来可改进的空间
把改进按"能马上做 / 需要建设 / 需要生态"分三档,避免把远期愿景当成当前排期。
| 档位 | 方向 | 做法与预期收益 |
| 近期 | 规则引擎外置与版本化 | 把容差、赔付比例等参数从合约代码里抽出来,做成可治理的参数表 + 版本快照,新增品类无需重新部署合约。 |
| 近期 | 边缘智能降噪 | 在网关跑轻量模型识别"开门、化霜、探头脱落"造成的假告警,减少误报与无效上链,把运维注意力集中在真异常上。 |
| 近期 | 全链路可观测 | 补齐设备在线率、签名失败率、锚定延迟、事件积压等 SLO 指标,把"链上不可篡改"与"系统真的在跑"分开度量。 |
| 中期 | 设备身份升级为 DID + 可验证凭证 | 用 W3C DID 为每台设备发放去中心化标识,厂商签发"校准凭证""型号凭证"(VC)。设备跨企业、跨生态流动时,身份与资质可自带、可离线验证,不再依赖中心化注册表。 |
| 中期 | 隐私保护:只证明"达标"不暴露明细 | 用零知识证明或 TEE 远程证明,向监管/客户证明"全程 2~8℃ 且超限累计 < X 分钟",而不泄露具体温度曲线与路线——解决"想自证清白又怕泄商业机密"的矛盾。 |
| 中期 | 跨链与跨生态互通 | 通过跨链网关/中继,与药监追溯链、保险行业平台、海关与口岸系统互联,做到"一次上链、多处采信",避免企业重复报送。 |
| 中期 | 参数化保险与再保联动 | 把理赔规则与保险产品条款对齐,接入共保体与再保,实现定责即赔付、自动分账;规则变更全程留痕可审计。 |
| 中期 | 标准对齐降低对接成本 | 事件模型对齐 GS1 EPCIS 2.0、编码与温度要求对齐国标与 GSP,把"每个伙伴一套接口"变成"一套标准多处复用"。 |
| 远期 | 数据要素化与收益分配 | 在确权与授权前提下,把脱敏后的温控数据作为数据资产参与流通;收益分配用合约自动执行。注意:国内严禁虚拟货币与相关炒作,任何激励都不得涉及代币发行交易,只能采用数据权益凭证、服务积分、合约分账等合规形式。 |
| 远期 | 数字孪生与路径优化 | 用历史数据仿真不同路线、季节、冷机策略下的温度与能耗表现,反向优化配送计划与设备配置,从"记录合规"走向"预测与优化"。 |
| 远期 | AI 大模型结合 | 自然语言查询运单与异常、自动生成监管报送材料与事故归因报告、用多模态模型审验照片与视频证据,压缩人工审核工作量。 |
| 远期 | 绿色低碳与 ESG | 采用低能耗共识、边缘设备休眠调度,并把能耗与碳排核算结果上链,服务 ESG 披露与绿色供应链评估。 |
| 远期 | 联邦学习联合风控 | 多方数据不出域,联合训练"超温风险预测模型",把风险识别前置到发车之前。 |
落地路线(12 周试点)
- 第 1–2 周 · 基线选定一条真实线路与一家货主,采集现有流程的耗时、争议点、数据格式作为基线指标;确定联盟章程与节点归属。
- 第 3–4 周 · 设备与签名完成终端固件与安全芯片签名改造,跑通"设备 → 网关 → 验签入库";验收标准:任何一条被篡改的样本都能被验签拦下。
- 第 5–6 周 · 链与合约四节点联盟链搭建,部署四个合约,完成权限与双签交接的单元测试;验收标准:模拟超温与交接,链上记录可完整还原时间线。
- 第 7–8 周 · 锚定与看板窗口聚合、Merkle 锚定、事件索引与看板上线;验收标准:明细与链上根哈希可交叉验证,任意样本可出证明。
- 第 9–10 周 · 告警与处置边缘规则、通知、处置工单闭环;验收标准:注入超温后 60 秒内触达责任人并形成工单。
- 第 11–12 周 · 理赔与复盘理赔合约接入,跑 1~2 次真实或模拟理赔;输出成本、耗时、问题的复盘报告与下一阶段规划。
延伸资料
- 标准:GS1 EPCIS 2.0(供应链事件模型)、W3C DID / Verifiable Credentials(去中心化身份与凭证)、IEEE 2418.2(区块链与物联网结合的标准化框架)、IETF RATS(远程证明架构)。
- 联盟链:FISCO BCOS 官方文档与 WeBASE、长安链 ChainMaker 文档与合约示例(含国密与隐私合约)。
- 物联网侧:EMQX 文档(MQTT、规则引擎、eKuiper 边缘流处理)、TDengine 文档(时序建模与窗口聚合)、Microchip cryptoauthlib(ATECC608A 签名)。
- 行业规范:药品经营质量管理规范(GSP)与冷链物流相关国家标准、医疗器械与疫苗储存运输的温度要求。
- 本站相关:溯源、存证与电子票据(哈希上链与司法采信)、FISCO BCOS 解读、长安链解读、智能合约与 EVM、工具链与调试。