> For the complete documentation index, see [llms.txt](https://comboox.gitbook.io/whitepaper-en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://comboox.gitbook.io/whitepaper-en/technical-brochure/structure-and-components/goldchain.md). # 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". ### **Sell Order Object**

### **Attributes List of Sell Order**

Attributes	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.
isOffer	Whether the order is a sell order.
classOfShare	Number of underlying shares class.
groupRep	The user number of representative of buyer's Concert Group
votingWeight	The voting weight of the underlying shares.
distrWeight	The voting weight of the underlying shares.
margin	The margin of the sell order.
isEth	Whether the order is settled by ETH.
Date	Whether the order is matched and closed.

### **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.

Attribute	Commercial and Legal Meaning
tail	The tail node user number of the minority shareholder queue.
head	The head node user number of the minority shareholder queue.
maxQtyOfMembers	Upper limit on the number of shareholders in the company. 0 - Unlimited number.
minVoteRatioOnChain	Major Shareholder Voting Weight Threshold. 10,000 points, i.e., 500 represents 5%.
qtyOfSticks	Total number of independent minority shareholders and minority shareholders acting in concert group.
qtyOfBranches	Total number of independent major shareholders and major shareholders acting in concert group.
qtyOfMembers	Total number of shareholders.

### **Golden Chain**

## 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](https://github.com/paul-lee-attorney/comboox/blob/master/contracts/lib/GoldChain.sol)