# 6. 外部写操作接口 系统共对外暴露【84】个外部写操作接口，这些接口共同涵盖了与公司治理、股权交易及 USDC 收付相关的几乎所有法律行为。这些接口被路由至各个分项管理人合约进行进一步处理和执行，从而实现每项法律行为相应的法律后果。
6.1 路由至股东协议登记簿管理人的接口
S.N.API函数及输入参数说明
1

function createSHA(

uint version

) external

（任意股东）通过克隆特定版本的模版，创建新的股东协议合约。
2

Function circulateSHA(

address body,

bytes32 docUrl,

bytes32 docHash

) external

（草案所有者）将部署在地址 body 的股东协议定稿草案传阅给合同当事方签署，并附带文档的 URL 信息 docUrl 及哈希值 docHash。
3

function signSHA(

address sha,

bytes32 sigHash

) external

（草案当事方）签署部署在地址 sha 的股东协议定稿草案，并附带签名的哈希值 sigHash。
4

function activateSHA(

address body

) external

（任意用户）激活部署在地址 body 的股东协议草案。
5

function acceptSHA(

bytes32 sigHash

) external

（任意用户）接受生效中的股东协议合约的条款和条件，并附上哈希值 sigHash。
6.2 路由至董事高管名册管理人的接口
S.N.API函数及输入参数说明
6

function takeSeat(

uint256 seqOfMotion,

uint256 seqOfPos

) external

（获选董事）根据编号为 seqOfMotion 的动议所授予的授权，就任编号为 seqOfPos 的董事席位。
7

function removeDirector (

uint256 seqOfMotion,

uint256 seqOfPos

) external

（拥有提名权的股东）根据编号为 seqOfMotion 的罢免动议，罢免编号为 seqOfPos 职位的董事。
8

function takePosition(

uint256 seqOfMotion,

uint256 seqOfPos

) external

（获选管理人员）根据编号为 seqOfMotion 的动议所授予的授权，就任编号为 seqOfPos 的管理人员职位。
9

function removeOfficer (

uint256 seqOfMotion,

uint256 seqOfPos

) external

（执行人）根据编号为 seqOfMotion 的罢免动议，罢免编号为 seqOfPos 职位的管理人员。
10

function quitPosition(

uint256 seqOfPos

) external

（董事或管理人员）自愿辞去编号为 seqOfPos 的职位。
6.3 路由至董事会纪要管理人的接口
S.N.API函数及输入参数说明
11

function nominateOfficer(

uint256 seqOfPos,

uint256 candidate

) external

（拥有提名权的董事）提名用户编号为 candidate 的用户担任编号为 seqOfPos 的管理人员职位。
12

function createMotionToRemoveOfficer(

uint256 seqOfPos

) external

（拥有提名权的董事）创建一份罢免编号为 seqOfPos 职位的管理人员的动议草案。
13

function createMotionToApproveDoc(

uint256 doc,

uint256 seqOfVR,

uint256 executor

) external

（任意董事）为董事会创建一份动议草案，按照编号为 seqOfVR 的表决规则，批准部署在地址 doc 的文档，并由编号为 executor 的用户负责调用。
14

function proposeToTransferFundWithBoard(

address to,

bool isCBP,

uint256 amt,

uint256 expireDate,

uint256 seqOfVR,

uint256 executor

) external

（任意董事）向董事会会议提议，按照编号为 seqOfVR 的表决规则，在 expireDate 时间戳之前，向账户地址 to 划转一定数量的 CBP（isCBP 为 true）或 USDC（isCBP 为 false），金额为 amt，并由编号为 executor 的用户执行相关动议。
15

function createAction(

uint256 seqOfVR,

address[] memory targets,

uint256[] memory values,

bytes[] memory params,

bytes32 desHash,

uint256 executor

) external

为董事会创建一份动议草案，按照编号为 seqOfVR 的表决规则，对部署在地址 targets 的合约执行一系列调用，支付相应的 ETH 金额 values，输入参数 params，并附上描述消息的哈希值 desHash，由编号为 executor 的用户负责调用。
16

function entrustDelegaterForBoardMeeting(

uint256 seqOfMotion,

uint256 delegate

) external

（任意董事）委托用户编号为 delegate 的用户在董事会会议上对编号为 seqOfMotion 的动议代为投票。
17

function proposeMotionToBoard (

uint256 seqOfMotion

) external

（任意董事）将编号为 seqOfMotion 的动议草案提交至董事会会议。
18

function castVote(

uint256 seqOfMotion,

uint256 attitude,

bytes32 sigHash

) external

（任意董事）对编号为 seqOfMotion 的动议进行投票，并附上签名消息的哈希值 sigHash。
19

function voteCounting(

uint256 seqOfMotion

) external

（任意用户）统计编号为 seqOfMotion 的动议的表决结果。
20

function execAction(

uint typeOfAction,

address[] memory targets,

uint256[] memory values,

bytes[] memory params,

bytes32 desHash,

uint256 seqOfMotion

) external

（指定执行人）执行编号为 seqOfMotion、类别为 typeOfAction 的动议，触发对部署在地址 targets 的合约的一系列调用，支付相应的 ETH 金额 values，输入参数 params，并附上描述消息的哈希值 desHash。
6.4 路由至股东名册管理人的接口
S.N.API函数及输入参数说明
21

function setMaxQtyOfMembers(

uint256 max

) external

（公司秘书，即总管理人合约的直接管理人）设置股东人数上限为 max。
22

function setPayInAmt(

uint256 seqOfShare,

uint256 amt,

uint256 expireDate,

bytes32 hashLock

) external

（公司秘书，即总管理人合约的直接管理人）为编号为 seqOfShare 的股份设定拟实缴金额 amt，截止日期为 expireDate，并设置哈希值为 hashLock 的哈希锁。
23

function requestPaidInCapital(

bytes32 hashLock,

string memory hashKey

) external

（股东，在链下支付相关实缴价款后）通过输入哈希钥匙字符串 hashKey，解除哈希值为 hashLock 的哈希锁，以请求获得目标股份的特定实缴出资额。
24

function withdrawPayInAmt(

bytes32 hashLock,

uint256 seqOfShare

) external;

（公司秘书，即总管理人合约的直接管理人，在相关哈希锁到期日后）通过输入哈希锁值 hashLock，撤销为编号为 seqOfShare 的特定股份设置的实缴出资额设定。
25

function payInCapital(

ICashier.TransferAuth memory auth,

uint256 seqOfShare,

uint256 paid

) external;

（股东）通过链下签署的授权 auth 支付一定数量的 USDC，为其编号为 seqOfShare 的特定股份实缴出资，金额为 paid。
26

function decreaseCapital(

uint seqOfVR,

uint256 seqOfShare,

uint paid, uint par,

uint amt,

uint seqOfMotion

) external;

（授权执行人）根据编号为 seqOfMotion 的已通过决议，按照编号为 seqOfVR 的表决规则，减少编号为 seqOfShare 的股份的注册资本，实缴金额为 paid，票面金额为 par，USDC 金额为 amt。
6.5 路由至股东会纪要管理人的接口
S.N.API函数及输入参数说明
27

function nominateDirector(

uint256 seqOfPos,

uint256 candidate

) external

（拥有提名权的股东）提名用户编号为 candidate 的用户担任编号为 seqOfPos 的董事职位。
28

function createMotionToRemoveDirector(

uint256 seqOfPos

) external

（拥有提名权的股东）创建一份罢免编号为 seqOfPos 职位的董事的动议草案。
29

function proposeDocOfGM(

uint256 doc,

uint256 seqOfVR,

uint256 executor

) external

（任意股东）为股东会创建并提交一份动议草案，按照编号为 seqOfVR 的表决规则，批准部署在地址 doc 的文档，并由编号为 executor 的用户负责调用。
30

function proposeToDistributeUsd(

uint amt,

uint expireDate,

uint seqOfVR,

uint seqOfDR,

uint para,

uint executor

) external;

（任意股东）为股东会创建并提交一份动议草案，按照编号为 seqOfVR 的表决规则及编号为 seqOfDR 的分配规则，在 expireDate 到期日之前批准分配金额为 amt 的 USDC，并附带参数 para，由编号为 executor 的用户负责调用。
31

function proposeToTransferFundWithGM(

address to,

bool isCBP,

uint256 amt,

uint256 expireDate,

uint256 seqOfVR,

uint256 executor

) external

（任意股东或董事）向股东会提议，按照编号为 seqOfVR 的表决规则，在 expireDate 时间戳之前，向账户地址 to 划转一定数量的 CBP（isCBP 为 true）或 USDC（isCBP 为 false），金额为 amt，并由编号为 executor 的用户执行相关动议。
32

function createActionOfGM(

uint seqOfVR,

address[] memory targets,

uint256[] memory values,

bytes[] memory params,

bytes32 desHash,

uint executor

) external

（任意股东）为股东会创建一份动议草案，按照编号为 seqOfVR 的表决规则，对部署在地址 targets 的合约执行一系列调用，支付相应的 ETH 金额 values，输入参数 params，并附上描述消息的哈希值 desHash，由编号为 executor 的用户负责调用。
33

function entrustDelegaterForGeneralMeeting(

uint256 seqOfMotion,

uint256 delegate

) external

（任意股东）委托用户编号为 delegate 的用户在股东会上对编号为 seqOfMotion 的动议代为投票。
34

function proposeMotionToGeneralMeeting(

uint256 seqOfMotion

) external

（任意股东）将编号为 seqOfMotion 的动议提交至股东会。
35

function castVoteOfGM(

uint256 seqOfMotion,

uint256 attitude,

bytes32 sigHash

) external

（任意股东）对编号为 seqOfMotion 的动议进行投票，并附上签名消息的哈希值 sigHash。
36

function voteCountingOfGM(

uint256 seqOfMotion

) external

（任意用户）统计股东会上编号为 seqOfMotion 的动议的表决结果。
37

function execActionOfGM(

uint typeOfAction,

address[] memory targets,

uint256[] memory values,

bytes[] memory params,

bytes32 desHash,

uint256 seqOfMotion

) external

（指定执行人）执行编号为 seqOfMotion、类别为 typeOfAction 的动议，触发对部署在地址 targets 的合约的一系列调用，支付相应的 ETH 金额 values，输入参数 params，并附上描述消息的哈希值 desHash。
6.6 路由至投资协议登记簿管理人的接口
S.N.API函数及输入参数说明
38

function createIA(

uint256 version

) external

（任意股东）通过克隆编号为 version 的版本模版，在投资协议登记簿上创建一份投资协议草案。
39

function circulateIA(

address body,

bytes32 docUrl,

bytes32 docHash

) external

（投资协议草案的所有者）将部署在地址 body 的定稿草案传阅给各当事方签署，并附带文档的 URL 信息 docUrl 及草案的哈希值 docHash。
40

function signIA(

address ia,

bytes32 sigHash

) external

（投资协议的当事方）签署部署在地址 ia 的投资协议，并附上签名消息的哈希值 sigHash。
41

function pushToCoffer(

address ia,

uint256 seqOfDeal,

bytes32 hashLock,

uint256 closingDeadline

) external

（卖方）针对投资协议（部署在地址 ia）下编号为 seqOfDeal 的特定交易，输入哈希锁值 hashLock 并设定交割截止日期 closingDeadline，确认所有先决条件均已满足并准备交割。
42

function closeDeal(

address ia,

uint256 seqOfDeal,

string memory hashKey

) external

（买方）在链下支付对价后，通过输入哈希钥匙字符串 hashKey，完成投资协议（部署在地址 ia）下编号为 seqOfDeal 的交易的交割。
43

function issueNewShare(

address ia,

uint256 seqOfDeal

) external

（发行人）针对投资协议（部署在地址 ia）下编号为 seqOfDeal 的增资交易，直接将新股发行给买方。
44

function transferTargetShare(

address ia,

uint256 seqOfDeal

) external

（卖方）针对投资协议（部署在地址 ia）下编号为 seqOfDeal 的特定股权转让交易，将标的股权直接转让给买方。
45

function terminateDeal(

address ia,

uint256 seqOfDeal

) external

（卖方，在相关到期日后）终止投资协议（部署在地址 ia）下编号为 seqOfDeal 的交易。
46

function payOffApprovedDeal(

ICashier.TransferAuth memory auth,

address ia,

uint256 seqOfDeal,

address to

) external;

（买方）根据链下签署的授权 auth，向卖方/发行人地址支付一定数量的 USDC，以结清部署在地址 ia 的投资协议中编号为 seqOfDeal 的特定交易。
6.7 路由至期权登记簿管理人的接口
S.N.API函数及输入参数说明
47

function updateOracle(

uint256 seqOfOpt,

uint256 d1,

uint256 d2,

uint256 d3

) external

（公司秘书，即总管理人合约的直接管理人）针对编号为 seqOfOpt 的特定期权，更新关键绩效指标 d1、d2 及 d3。
48

function execOption(

uint256 seqOfOpt

) external

（权利人）执行编号为 seqOfOpt 的期权。
49

function createSwap(

uint256 seqOfOpt,

uint256 seqOfTarget,

uint256 paidOfTarget,

uint256 seqOfPledge

) external

（权利人）针对编号为 seqOfTarget 的目标股份，以实缴金额 paidOfTarget，并以编号为 seqOfPledge 的质押股份作为担保物，为执行编号为 seqOfOpt 的期权创建互换交易。
50

function payOffSwap(

ICashier.TransferAuth memory auth,

uint256 seqOfOpt,

uint256 seqOfSwap,

address to

) external;

（出质人）根据链下签署的授权 auth 支付一定数量的 USDC，以解除编号为 seqOfOpt 的期权下编号为 seqOfSwap 的互换交易中的质押股份，从而了结该互换交易。
51

function terminateSwap(

uint256 seqOfOpt,

uint256 seqOfSwap

) external

（目标股份持有人）通过转让目标股份并解除质押股份的质押，执行编号为 seqOfOpt 的期权下编号为 seqOfSwap 的互换交易。
6.8 路由至质权登记簿管理人的接口
S.N.API函数及输入参数说明
52

function createPledge(

bytes32 snOfPld,

uint256 paid,

uint256 par,

uint256 guaranteedAmt,

uint256 execDays

) external

（任意股东）以编号为 snOfPld 的质押，实缴金额为 paid，票面金额为 par，担保债务金额为 guaranteedAmt，担保期限为 execDays 天。
53

function transferPledge(

uint256 seqOfShare,

uint256 seqOfPld,

uint256 buyer,

uint256 amt

) external

（债权人）将在编号为 seqOfShare 的质押股份上设立的编号为 seqOfPld 的质权，转让给编号为 buyer 的用户，转让的债权金额为 amt。
54

function refundDebt(

uint256 seqOfShare,

uint256 seqOfPld,

uint256 amt

) external

（债权人）确认偿还由编号为 seqOfShare 的质押股份上设立的编号为 seqOfPld 的质权所担保的债务，偿还金额为 amt。
55

function extendPledge(

uint256 seqOfShare,

uint256 seqOfPld,

uint256 extDays

) external

（出质人）将编号为 seqOfShare 的质押股份上设立的编号为 seqOfPld 的质权的担保期限延长 extDays 天。
56

function lockPledge(

uint256 seqOfShare,

uint256 seqOfPld,

bytes32 hashLock

) external

（债权人）在编号为 seqOfShare 的质押股份上设立的编号为 seqOfPld 的质权上，设置哈希值为 hashLock 的哈希锁。
57

function releasePledge(

uint256 seqOfShare,

uint256 seqOfPld,

string memory hashKey

) external

（出质人，在链下支付并获取哈希钥匙后）通过输入哈希钥匙字符串 hashKey，解除编号为 seqOfShare 的质押股份上设立的编号为 seqOfPld 的质权。
58

function execPledge(

uint256 seqOfShare,

uint256 seqOfPld,

uint256 buyer,

uint256 groupOfBuyer

) external

（债权人，在链下处置并收到对价后）执行编号为 seqOfShare 的质押股份上设立的编号为 seqOfPld 的质权，将标的股份转让给编号为 buyer 的用户，该用户属于由编号为 groupOfBuyer 的用户代表的一致行动人小组。
59

function revokePledge(

uint256 seqOfShare,

uint256 seqOfPld

) external

（出质人，在担保期限届满后）撤销编号为 seqOfShare 的质押股份上设立的编号为 seqOfPld 的质权。
6.9 路由至股东协议权益管理人的接口
S.N.API函数及输入参数说明
60

function execAlongRight(

address ia,

bytes32 snOfClaim,

bytes32 sigHash

) external

（权利人）针对部署在地址 ia 的投资协议中编码为 snOfClaim 的随售权或拖售权主张，行使随售权，并附上签名哈希值 sigHash。
61

function acceptAlongDeal(

address ia,

uint256 seqOfDeal,

bytes32 sigHash

) external

（买方）接受针对部署在地址 ia 的投资协议中编号为 seqOfDeal 的交易的拖售/随售请求，并附上签名哈希值 sigHash。
62

function execAntiDilution(

address ia,

uint256 seqOfDeal,

uint256 seqOfShare,

bytes32 sigHash

) external

（权利人）针对部署在地址 ia 的投资协议中编号为 seqOfDeal 的交易，就其编号为 seqOfShare 的股份行使反稀释权，并附上签名哈希值 sigHash。
63

function takeGiftShares(

address ia,

uint256 seqOfDeal

) external

（反稀释权利人，在交割后）根据股东协议合约的反稀释条款，领取针对部署在地址 ia 的投资协议中编号为 seqOfDeal 的交易产生的赠与股份。
64

function execFirstRefusal(

uint256 seqOfRule,

uint256 seqOfRightholder,

address ia,

uint256 seqOfDeal,

bytes32 sigHash

) external

（权利人）根据编号为 seqOfRule 的规则，以 seqOfRightholder 作为权利人识别序号，请求购买部署在地址 ia 的投资协议中编号为 seqOfDeal 的交易项下的标的股份，行使优先购买权，并附上签名哈希值 sigHash。
65

function computeFirstRefusal(

address ia,

uint256 seqOfDeal

) external;

（任意股东）计算部署在地址 ia 的投资协议中编号为 seqOfDeal 的交易的优先购买权请求结果，从而获取自动更新的投资协议。
6.10 路由至会计师的接口
S.N.API函数及输入参数说明
66

function initClass(

uint class

) external;

（公司秘书）启动特定class股份的净资产收益率（ROE）或内部收益率（IRR）计算。
67

function distributeProfits(

uint256 amt,

uint256 expireDate,

uint256 seqOfDR,

uint256 seqOfMotion

) external

（指定执行人）根据编号为 seqOfDR 的分配规则及编号为 seqOfMotion 的动议，在 expireDate 到期日之前，分配公司利润，金额为 amt。
68

function distributeIncome(

uint256 amt,

uint256 expireDate,

uint256 seqOfDR,

uint256 fundManager,

uint256 seqOfMotion

) external

（指定执行人）根据编号为 seqOfMotion 的动议，在 expireDate 到期日之前，分配基金收益，金额为 amt，资产管理人的用户编号为 fundManager。
69

function transferFund(

bool fromBMM,

address to,

bool isCBP,

uint256 amt,

uint256 expireDate,

uint256 seqOfMotion

) external

（指定执行人）根据董事会（toBMM 为 true）或股东会（toBMM 为 false）通过的编号为 seqOfMotion 的动议，在 expireDate 时间戳之前，向账户地址 to 划转金额为 amt 的 CBP（isCBP 为 true）或 ETH（isCBP 为 false）。
6.11 路由至投资意向登记簿管理人的接口
S.N.API函数及输入参数说明
70

function pause(

uint seqOfLR

) external;

（授权执行人）根据编号为 seqOfLR 的挂牌交易规则，暂停股份的交易。
71

function unPause(

uint seqOfLR

) external;

（授权执行人）根据编号为 seqOfLR 的挂牌交易规则，恢复股份的交易。
72

function regInvestor(

address bKey,

uint256 groupRep,

bytes32 idHash

) external;

（任意用户）输入其备用钥匙 bKey、其一致行动人小组代表的用户编号 groupRep，以及其身份信息的哈希值 idHash，将其自身注册为投资人。
73

function approveInvestor(

uint256 userNo,

uint256 seqOfLR

) external;

（核验人）根据编号为 seqOfLR 的挂牌交易规则，批准用户编号为 userNo 的投资人的申请。
74

function revokeInvestor(

uint256 userNo,

uint256 seqOfLR

) external;

（核验人）根据编号为 seqOfLR 的挂牌交易规则，撤销用户编号为 userNo 的投资人的资格。
75

function freezeShare(

uint seqOfLR,

uint seqOfShare,

uint paid,

bytes32 hashOrder

) external;

（授权执行人）根据编号为 seqOfLR 的挂牌交易规则所载授权，并依照哈希值为 hashOrder 的执行指令，冻结序列号为 seqOfShare 的目标股份，其实缴金额记录为 paid。
76

function unfreezeShare(

uint seqOfLR,

uint seqOfShare,

uint paid,

bytes32 hashOrder

) external;

（授权执行人）根据编号为 seqOfLR 的挂牌交易规则所载授权，并依照哈希值为 hashOrder 的执行指令，解冻序列号为 seqOfShare 的目标股份，其实缴金额记录为 paid。
77

function forceTransfer(

uint seqOfLR,

uint seqOfShare,

uint paid,

address addrTo,

bytes32 hashOrder

) external;

（授权执行人）根据编号为 seqOfLR 的挂牌交易规则所载授权，并依照哈希值为 hashOrder 的执行指令，将序列号为 seqOfShare、实缴金额为 paid 的目标股份强制转让至主钥匙地址为 addrTo 的指定用户。
6.12 路由至挂牌交易登记簿管理人的接口
S.N.API函数及输入参数说明
78

function placeInitialOffer(

uint256 classOfShare,

uint256 execHours,

uint256 paid,

uint256 price,

uint256 seqOfLR

) external

（发行人）根据编号为 seqOfLR 的挂牌交易规则的授权，以 paid 作为发行价格，发行数量为 paid，有效小时数为 execHours，挂牌 classOfShare 类别的首次发行要约。
79

function withdrawInitialOffer(

uint256 classOfShare,

uint256 seqOfOrder,

uint256 seqOfLR

) external;

（发行人）根据编号为 seqOfLR 的挂牌交易规则的授权，撤销 classOfShare 类别下编号为 seqOfOrder 的首次发行要约。
80

function placeSellOrder(

uint256 seqOfClass,

uint256 execHours,

uint256 paid,

uint256 price,

uint256 seqOfLR

) external

（任意合格投资人）根据编号为 seqOfLR 的挂牌交易规则，就编号为 seqOfClass 的类别提交卖单，卖出数量为 paid，卖出价格为 price，有效时间为 execHours 小时。
81

function withdrawSellOrder(

uint256 classOfShare,

uint256 seqOfOrder

) external

（卖方）撤销其自行提交的 classOfShare 类别下编号为 seqOfOrder 的卖单。
82

function placeBuyOrder(

ICashier.TransferAuth memory auth,

uint256 classOfShare,

uint256 paid,

uint256 price,

uint256 execHours

) external

（任意合格投资人）就 classOfShare 类别提交买单，买入数量为 paid，买入价格为 price，有效时间为 execHours 小时，并根据链下签署的授权 auth 支付一定数量的 USDC。
83

function placeMarketBuyOrder(

ICashier.TransferAuth memory auth,

uint256 classOfShare,

uint256 paid,

uint256 execHours

) external

（任意合格投资人）就 classOfShare 类别提交市价买单，买入数量为 paid，有效时间为 execHours 小时，并根据链下签署的授权 auth 支付一定数量的 USDC。
84

function withdrawBuyOrder(

uint256 classOfShare,

uint256 seqOfOrder

) external

（买方）撤销其自行提交的 classOfShare 类别下编号为 seqOfOrder 的买单。
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://comboox.gitbook.io/whitepaper-cn/xi-tong-zong-shu/6.-wai-bu-xie-cao-zuo-jie-kou.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.