📈卖单及卖单库
Last updated
Last updated
卖单库是定义卖单对象及其增、删、改、查系列操作方法的公共库合约。
所谓“股权挂牌交易”是指系统设计的以定价委托卖单为挂牌对象的公开竞价撮合交易的股权交易机制。股东协议的挂牌规则可授权特定类别的股份可以采用挂牌方式公开竞价增发及转让，一但通过审议表决，则相关挂牌规则即生效，公司可挂牌增发新股，且相关股东可在锁定期结束后继续挂牌出让其持有的相关类别的股份。
只有通过实名认证的投资人方能摘牌买入挂牌股份，而有权审核投资人身份信息的则是挂牌规则规定的核验人。投资人的总人数，也由挂牌规则规定，一但达到上限则无法再审批新投资人加入。潜在投资人的人数是很多国家判断“公开发行”或“公开市场交易”的核心要素，因此公司应当根据注册地相关证券法规和商业安排，灵活确定投资人的总人数上限，依法履行相应的报告、披露义务。
每个卖单对象都规定了委托有效期，一但有效期届满，系统会在下一次撮合中自动将过期卖单做撤单处理；委托人也可以在有效期届满后主动操作撤单，将特定卖单从挂牌黄金链表上撤掉。
挂牌发行的股份均可通过挂牌出让方式转让，而总发行额、发行最高限价、最低限价、摘牌交易价格等发行交易条件均可通过挂牌规则详细规定。
委托卖单将按价格从低到高的次序在黄金链表中由头至尾有序排列。投资人可调用特定接口发出定价、定额委托买单并支付以太坊作为对价，系统将按照“价格优先、时间优先"规则撮合，在委托有效期内的卖单中选择价格最低的与买单撮合，只要卖单价格小于等于买单即按卖单价格成交，成交的卖单会相应调减成交金额或全额从黄金链表中删除，直至买单金额耗尽，或再也找不到合适价格的卖单为止。若有余款，则系统会自动退回投资人在公司的以太坊账户，供投资人自主取回，这主要是为了防范重入攻击。
成交摘牌后，相关卖单将直接从黄金链表中删除，但系统将在event中保留摘牌成交的交易日志。
卖单库的成员主要包括卖单对象构成的黄金链表，投资人对象构成的投资人映射表和不定长数组，摘牌交易对象构成的临时性成交单链表及不定长数组。
虽然不是卖单库的成员，但股东协议的挂牌规则全方位规定了挂牌发行或挂牌出让的所有规则。
seqOfRule
规则编号。
titleOfIssuer
（挂牌发行）发行人的职称。
classOfShare
股份类别编号。
maxTotalPar
最高（发行）认缴出资总额。
titleOfVerifier
(投资人)身份审核人职称。
maxQtyOfInvestors
投资人最高人数上限。
ceilingPrice
最高（发行）价格。
floorPrice
最低（发行）价格。
lockupDays
锁定天数。
offPrice
摘牌交易价格。
votingWeight
（发行股份）表决权重。
userNo
投资人用户编号。
groupRep
一致行动人集团代表人用户编号。
regDate
注册时间点。
verifier
验证人(实名认证负责人)用户编号。
approveDate
批准时间点。
data
附加数据。
state
状态。
idHash
身份文件哈希。（也可以为IPFS的内容索引CID）
classOfShare
标的股份类别编号。
seqOfShare
标的股份编号。
buyer
买方用户编号。
groupRep
买方一致行动人集团代表人用户编号。
paid
摘牌交易的实缴出资金额。
price
交易的成交价格。
votingWeight
标的股份的表决权重。
查询接口最能体现卖单库在整个系统中的功能和用途，具体请见下表。
isInvestor
查询特定编号用户是否为投资人。
getInvestor
获取特定编号用户的投资人对象。
getQtyOfInvestors
获取投资人的总人数。
investorList
获取所有投资人用户编号列表。
investorInfoList
获取所有投资人对象列表。
isClass
查询特定编号股份类别是否为可挂牌出让的股份类别。
getClassesList
获取所有可挂牌股份类别的编号列表。
getExpired
获取有效期已届满的挂牌卖单列表。
getDeals
获取摘牌交易对象列表。
