🥇GoldChain

Functions and Usages

Golden Chain defines a chain consisting of a series of order nodes representing the sell orders for the shares listed for sale, with the nodes sorted in order from the lowest to the highest transfer price. Investors can call a specific API to issue a fixed price delegation buy orders and pay ETH as consideration, the system will match the sell order in the delegation valid period with the buy order with the lowest price as per the "price first, time first" principle. As long as the sell order price is less than or equal to the buy order, the order will be sold at the sell order price, and the closed order will be adjusted to the number of transactions or fully removed from the golden chain until the amount of the buy order is depleted, or no more sell order can be found at the right price. If there is a balance, the system will automatically return the investor's ETH account for the investor to retrieve, aiming to prevent re-entry attacks. Each sell order object provides delegation validity period, once the validity period expires, the system will automatically in the next aggregation of the expired sell order to do the withdrawal processing; the delegate can initiate to withdraw the specific sell order from the listing of the golden chain.

All the listing shares can be transferred through listing, while the total issue amount, maximum issue price, minimum issue price, transaction price and other transaction conditions can be detailedly stipulated in the listing rules.

After the transaction is closed, the relevant sell order will be directly deleted from the golden chain, but the system will keep the transaction log of the successful transaction in event.

Members and Attributes

The golden chain mainly consists of the node object representing the sell order of listing shares, and its sell order node mapping chain composed of "node number -> node object".

Nodes of Sell Order

Structure of Node Object of Sell Order

Attributes List of Sell Order

Attribute	Commercial and Legal Meaning
prev	The number of previous sell order node.
next	The number of next sell order node.
seqOfShare	The number of underlying shares of the sell order.
paid	The paid-in contribution of the sell order.
price	The transaction price of the sell order.
expireDate	The expiration date of the sell order.
votingWeight	The voting weight of the underlying shares.

Parameter Objects

The Parameter object is mainly used to track the head and tail user numbers of the minority shareholder queue, as well as some aggregated data.

属性	商业法律含义
tail	小股东队列的尾结点用户编号。
head	小股东队列的头结点用户编号。
maxQtyOfMembers	公司股东人数上限。0-无限数量。
minVoteRatioOnChain	大股东表决权比重阈值。万分数，即500代表5%。
qtyOfSticks	独立小股东及小股东一致行动人集团总数量。
qtyOfBranches	独立大股东及大股东一致行动人集团总数量。
qtyOfMembers	股东总人数。

Golden Chain

Golden Chain Structure

Query API

The query API well describes the function and usage of the Golden Chain in the whole system, as shown in the table below.

API	Commercial and Legal Meaning
counter	Get the current value of the node number counter of sell order.
length	Get the length of the chain, i.e. the sum of all sell order numbers.
head	Get the head node, i.e. the lowest sell order price.
tail	Get the tail node, i.e. the highest sell order price.
isNode	Query whether the specific numbered sell order exists.
getNode	Get the node object of the specific sell order number.
getSeqList	Get a list of all sell order numbers.
getChain	Get a list of all sell order node objects.

Source Code

GoldChain