易懂案例：用班费记账来理解区块链Fabric链码开发相关API有哪些？各自的原理、数学逻辑、区别和联系是什么？

用班费记账理解Fabric链码开发核心API

在Hyperledger Fabric中，链码API是开发者与账本交互的"工具包"，相当于财务委员管理班费时使用的"记账工具"（如钢笔、计算器、账本索引表）。这些API封装了与分布式账本交互的底层逻辑，让开发者能专注于业务规则（如班费的收支计算）。以下通过班费记账场景，解析链码开发中最常用的几类API的原理、数学逻辑、区别与联系。

一、账本状态操作API：财务委员的“记账笔”

账本状态操作API是链码中最基础的API，用于读写账本中的键值对数据（如“班费余额”“收支记录”），相当于财务委员手中的“记账笔”——用来在账本上记录、修改或擦除信息。核心API包括GetState()、PutState()、DelState()，对应“查看记录”“添加/修改记录”“删除错误记录”三个动作。

（一）GetState(key)：查看账本中的特定记录

原理

GetState(key)用于读取账本中指定键（key）对应的value值，操作的是账本的当前状态（最新值），而非历史记录。例如要查询“班费余额”，只需传入键"balance"，即可获取当前余额数值。该API通过直接访问Peer节点的状态数据库（如LevelDB）实现快速查询，无需遍历区块。

班费场景类比</