🗞️股份及股份库

功能与用途

股份库是系统最核心的公共库合约，用于跟踪记录股份的设立、变更、转让和注销。

成员与属性

股份库主要包括股份、股份类别两个核心对象，以及这两个核心对象构成的“编号->对象”映射表。

股份

股份由Head和Body两大属性集合构成，Head主要记载自创设时起便不再更改的属性，例如：股份编号、股份类别等等；Body用于记载随股权交易可能动态变化的属性，例如：股份的票面金额、实缴金额、清洁实缴金额等。

股份对象结构

股份的属性列表

属性	商业法律含义
class	股份所属类别，以此区分不同股权设立时的融资轮次、不同的特殊投资人权益，以及可能的表决权重差异。
seqOfShare	股份编号。
preSeq	来源股份的编号。股转交易的具体实现是将标的股份注销，同时向买方发行同样的股份，新创设的股份会将转让标的股份的编号记录在preSeq中。
issueDate	新股发行日期或股转交易的交割日。
shareholder	股份持有人的用户编号。
priceOfPaid	实缴出资额的单价。股转交易中体现标的股权实缴出资的转让价格，增资交易中体现公司实缴出资的估值溢价。
priceOfPar	认缴出资额的单价。股转交易中体现标的股权认缴未实缴出资的转让价格，增资交易中体现公司认缴未实缴出资的估值溢价。
votingWeight	表决权重。百分数，即每元出资额所代表的表决权总数的100倍。例如，“100”，代表每元出资额代表1个表决权；“1800”，代表每元出资额代表18个表决权。
payInDeadline	出资期限。48位时间戳，可支持毫秒级时间戳。
par	认缴出资额。可能存在认缴未实缴的余额。
paid	实缴出资额。实际缴付的出资金额。
cleanPaid	清洁实缴出资额。 没有任何质押、出让等权利负担的实缴出资金额。
state	股份的状态。
para	预留属性。

股份类别

股份类别其实是股份映射表按股份类别汇总的一个股份编号列表和该类别股份各项出资额的汇总数据。

股份类别对象结构

股份库

股份库由两个映射表构成，一个是“股份编号->股份对象”的股份映射表，另一个是“类别编号->股份类别对象”的股份类别映射表。

股权仓库结构

查询接口

查询接口最能体现股份库在整个系统中的功能和用途，具体请见下表。

接口名称	功能与用途
counterOfShares	获取股份编号计数器的当前值。
counterOfClasses	获取股份类别编号计数器的当前值。
isShare	验证特定编号的股份是否存在。
getShare	获取特定编号的股份对象。
getQtyOfShares	获取当前股份对象的总数量。
getSeqListOfShares	获取股份编号列表。
getSharesList	获取全部股份对象的列表。
getQtyOfSharesInClass	获取特定编号股份类别的所有股份数量。
getSeqListOfClass	获取特定股份类别的股份编号清单。
getInfoOfClass	获取特定股份类别的汇总数据。
getSharesOfClass	获取特定股份类别的所有股份对象列表。

源代码

SharesRepo