01
公开记录,可核查的评分
读者应该既能查到记录本身,也能核查对它做的计算。
这个项目从国会议员的交易披露出发,想解决的问题是:怎样保留评分所用数据的记录。 它把交易、评分输入和结果都放进公开账本,这样计算过程可以被检查,而不只是依赖网站上的展示。
TradeRecord 存储的记录不能修改或删除,每条记录写入时就算好评分。 目前的原型仍然依赖所有者提交记录和设定权重。计算公开,并不能保证原始申报被正确解析。
申报众议院书记官和参议院 eFD 的披露,整理成 JSON
名册议员、所属议院、党派和委员会席位
账本 + 评分TradeRecord 存下交易,再向 SuspicionScorer 要评分
前端排名、交易列表和评分核查都直接从链上读取
02
评分
四个 0 到 100 的分项,按基点加权,权重合计 10,000。
| 因素 | 权重 | 何时为 0 | 何时为 100 |
|---|---|---|---|
| 披露延迟 | 15% | 当天申报 | ≥ 90 天(45 天期限 = 50 分) |
| 委员会管辖 | 30% | 没有相关委员会 | 在相关委员会任职 |
| 临近听证会 | 35% | ≥ 30 天 | ≤ 3 天 |
| 交易金额 | 20% | < $15,000 | ≥ $1,000,000 |
function score(uint32 delayDays, uint8 committeeRelevant, uint256 amountUsd, uint32 daysToHearing)
external view returns (uint8)
{
uint256 total = ( _delaySubscore(delayDays) * weights.delay
+ (committeeRelevant > 0 ? 100 : 0) * weights.committee
+ _hearingSubscore(daysToHearing) * weights.hearing
+ _amountSubscore(amountUsd) * weights.amount ) / 10_000;
return uint8(total > 100 ? 100 : total);
}
这个版本的权重由所有者设定,每次修改都会发出事件;按设计,之后的版本会把权重交给 项目 SUN 代币的持有者。因为用的是整数运算,上面的计算器和合约的结果完全一致。
03
合约
五个 Solidity 合约。课程提交里包含 18 个 Foundry 测试。
| 合约 | 作用 | 地址(Base Sepolia) |
|---|
04
在线演示
课程原版前端(英文界面),通过公共 RPC 读取已部署的合约。浏览不需要钱包。
这是测试网上的原型,只有 5 位议员、15 笔交易。缺少申报日期的,演示用交易日期加 30 天代替。 评分只是演示公式,不是违规的证据。展示中还提出了用代币奖励数据提交、由社区投票决定权重,这些是未来计划,不是这个演示的功能。