# 共识模块设计文档

共识机制——POC
	NULS主链默认采用信用共识机制 POC(Proof-Of-Credit)。节点信用达标的情况下，锁定一定保证金即可加入共识，共识节点重新排序后每轮轮流出块，退出共识时保证金解锁。
1、共识进入与退出机制
	任何人都可以随时加入NULS的共识之中，只要满足条件，遵守规则，即可持续获得NULS代币奖励。POC的加入分为硬性指标和软性指标。硬性指标指的是信用分值必须达到一定标准线，排除掉一部分曾经作恶的节点。软性指标指的是必须冻结一定量的NULS代币作为保证金，为杜绝节点的泛滥，同时让整个系统更加公平，保证金的数量除了有一个最低值的限制外，任何人可自由选择保证金的数量，保证金的数量会和最终的奖励挂钩。
1.1黄牌警告
	由于节点硬件配置或者网络原因，造成的共识期间掉线、死机等无法出块的，不属于违规情况，但对整个系统会造成一定影响，所以对这类情况，系统有一个轻度的警告机制：降低节点信用值，
1.2红牌警告
	对于一些双花、重复出块、尝试分叉系统、不遵守系统规则的恶意人为破坏情况，NULS系统坚决抵制，所有节点都可以检测到这类情况的发生；一旦有恶意节点确实试图挑战系统，那么对应的保证金将会被锁定2个月，且再次信用评级，将永远达不到共识门槛。
2、信用评级
	在 NULS 系统里，信用是账户在系统中的诚信系数，所有账户的信用会在区间[-1,1]内，通过信用评级算法公式自动计算。
	信用评估公式：信用基数=能力系数+责任系数
	能力系数：根据历史出块数量计算
	责任系数：根据违规情况和出块正确性计算
3、共识奖励
	为了整个 NULS 系统的平衡与公平，共识奖励根据所有共识节点所提交保证金与共识节点信用综合计算。共识奖励计算公式：见（图p1）
4、子链共识机制
	接入 NULS 的子链分为两种类型，第一种是通过 NULS 系统的标准接口协议接入，第二种是通过 NULS 的程序部署接入。
	NULS 是一套通用的区块链底层基础设施，在其主链上不运行任何应用业务，所有应用业务由子链运行。通过 NULS 的系统，能快速的部署基于 NULS 的子链，且可灵活定制子链的各种运行参数，包括是否支持基础代币、加密算法、共识机制、存储机制等。
	NULS 定义了标准共识模块，以提供接口兼容不同的共识机制。NULS 社区会陆续开发 POW、DPOS、POS、PBFT、POOL 验证池等共识机制，以供用户自由选择。

说明：当一个新区快打包成功之后发布该事件

 event_topic : "evt_cs_packing"

data:{
    "chainId":88,
    "smallBlock":"smallBlock对象序列化成十六进制字符串"
}

说明：当创建节点交易被确认并打包进块之后发布该事件

 event_topic : "evt_cs_createAgent"

data:{
    "chainId":88,
    "agentList":{    //打包区块中创建的共识节点列表
        "agent1",    //Agent对象的序列化为十六进制字符串
        "agent2",
        "agent3"
    }
}

说明：当注销节点交易被确认并打包进块之后发布该事件

 event_topic : "evt_cs_stopAgent"

data:{
    "chainId":88,
    "agentList":{    //打包区块中注销的共识节点列表
        "agent1",    //Agent对象的序列化为十六进制字符串
        "agent2",
        "agent3"
    }
}

说明：当共识节点状态改变时发布该事件

 event_topic : "evt_cs_agentStatusChage"

data:{
    "chainId":88,
    "agentList":{    //打包区块中状态该表的共识节点列表
        "agent1",    //Agent对象的序列化为十六进制字符串
        "agent2",
        "agent3"
    }
}

说明：当委托共识交易被确认并打包进块之后发布该事件

 event_topic : "evt_cs_deposit"

data:{
    "chainId":88,
    "depositList":{     //打包区块中委托列表
        "deposit1",     //Deposit对象序列化为十六进制字符串
        "deposit2"
    }
}

说明：当退出共识交易被确认并打包进块之后发布该事件

 event_topic : "evt_cs_withdraw"

data:{
    "chainId":88,
    "depositList":{     //打包区块中退出委托列表
        "deposit1",     //Deposit对象序列化为十六进制字符串
        "deposit2"
    }
}

说明：当有共识节点获得黄牌惩罚是发布该事件

 event_topic : "evt_cs_yellowPublish"

data:{
    "chainId":88,
    "yellowPublishList":{    //打包区块中黄牌列表
        "yellowPublish1",    //YellowPublish对象序列化为十六进制字符串
        "yellowPublish2"
    }
}

说明：当有共识节点获得红牌交易时获得该事件

 event_topic : "evt_cs_redPublish"

data:{
    "chainId":88,
    "redPublishList":{    //打包区块中红牌列表
        "redPublish1",    //RedPublish对象序列化为十六进制字符串
        "redPublish2"
    }
}

无

{
    {
        "name": "packing_interval",
        "remark": "打包间隔时间",
        "changable": "true",
        "default": "10秒"
    },
    {
    	"name": "packing_amount",
        "remark": "出块最小金额",
        "changable": "true",
        "default": "200000"
    },
    {
    	"name": "coinbase_unlock_height",
        "remark": "奖励金锁定块数",
        "changable": "true",
        "default": "100"
    },
    {
    	"name": "redPublish_lockTime",
        "remark": "获得红牌保证金锁定时间",
        "changable": "true",
        "default": "3个月"
    },
    {
    	"name": "stopAgent_lockTime",
        "remark": "注销节点保证金锁定时间",
        "changable": "true",
        "default": "3天"
    },
    {
    	"name": "commissionRate_min",
        "remark": "佣金比例的最小值",
        "changable": "true",
        "default": "10"
    },
    {
    	"name": "commissionRate_max",
        "remark": "佣金比例的最大值",
        "changable": "true",
        "default": "80"
    },
    {
    	"name": "deposit_min",
        "remark": "创建节点的保证金最小值",
        "changable": "true",
        "default": "20000"
    },
    {
    	"name": "deposit_max",
        "remark": "创建节点的保证金最大值",
        "changable": "true",
        "default": "700000"
    },
    {
    	"name": "commission_min",
        "remark": "委托最小值",
        "changable": "true",
        "default": "2000"
    },
    {
    	"name": "commission_max",
        "remark": "委托最大值",
        "changable": "true",
        "default": "680000"
    }
}