根据例子学习Solidity
大叔的爸爸
发表于 2022-12-26 19:53:53
169
0
0
以下的合约相当复杂,但展示了很多Solidity的功能。它实现了一个投票合约。 当然,电子投票的主要问题是如何将投票权分配给正确的人员以及如何防止被操纵。 我们不会在这里解决所有的问题,但至少我们会展示如何进行委托投票,同时,计票又是 自动和完全透明的 。' u4 V, v6 X2 y* z( ]0 N3 v9 N8 G. c
我们的想法是为每个(投票)表决创建一份合约,为每个选项提供简称。 然后作为合约的创造者——即主席,将给予每个独立的地址以投票权。
地址后面的人可以选择自己投票,或者委托给他们信任的人来投票。
在投票时间结束时,winningProposal()将返回获得最多投票的提案。
pragma solidity ^0.4.22;; O- F( ?: R( W% J3 {2 |
/// @title 委托投票
contract Ballot {2 y8 e. k8 q. F7 [
// 这里声明了一个新的复合类型用于稍后的变量- p5 J9 j6 X7 _/ I* G* V
// 它用来表示一个选民/ g6 X# t& U; ~; r9 E
struct Voter {
uint weight; // 计票的权重
bool voted; // 若为真,代表该人已投票
address delegate; // 被委托人
uint vote; // 投票提案的索引
}
// 提案的类型2 o& Q& ?# ?- |5 Z# ~9 f x* C
struct Proposal {" F* h, V" `0 ]* |
bytes32 name; // 简称(最长32个字节)$ q( l; f. l5 U/ q3 S% ^- S3 E
uint voteCount; // 得票数( `9 _4 a/ M4 o0 a: x
}
address public chairperson;
// 这声明了一个状态变量,为每个可能的地址存储一个 `Voter`。; T7 }. B, h/ a6 u
mapping(address => Voter) public voters;
// 一个 `Proposal` 结构类型的动态数组' `! v& g/ i1 x$ b9 ^) k
Proposal[] public proposals;# ?7 ]2 U: V2 J
/// 为 `proposalNames` 中的每个提案,创建一个新的(投票)表决2 _; d+ V: i) u1 [1 X
constructor(bytes32[] proposalNames) public {
chairperson = msg.sender;8 O* f X+ Y) V t! M8 `) Y. A
voters[chairperson].weight = 1;
//对于提供的每个提案名称,
//创建一个新的 Proposal 对象并把它添加到数组的末尾。
for (uint i = 0; i winningVoteCount) {4 V9 M4 s0 u! W% @
winningVoteCount = proposals.voteCount;
winningProposal_ = p;' C& R0 B7 O& [$ V8 K- H0 V
}
}4 @$ g: j( _* O& J5 e
}
// 调用 winningProposal() 函数以获取提案数组中获胜者的索引,并以此返回获胜者的名称
function winnerName() public view5 v. C! G2 ~% J' v3 q9 ~
returns (bytes32 winnerName_)
{4 \/ i, y) e5 d9 t5 }
winnerName_ = proposals[winningProposal()].name;$ s; O9 A* `, B2 {( d* [9 g1 ]
}
}
可能的优化3 B. k5 K. h7 ~. P+ w& U
当前,为了把投票权分配给所有参与者,需要执行很多交易。你有没有更好的主意?
秘密竞价(盲拍)8 e& Y- L0 |, T m
在本节中,我们将展示如何轻松地在以太坊上创建一个秘密竞价的合约。 我们将从公开拍卖开始,每个人都可以看到出价,然后将此合约扩展到盲拍合约, 在竞标期结束之前无法看到实际出价。
简单的公开拍卖. l; F; Y& K' D
以下简单的拍卖合约的总体思路是每个人都可以在投标期内发送他们的出价。 出价已经包含了资金/以太币,来将投标人与他们的投标绑定。 如果最高出价提高了(被其他出价者的出价超过),之前出价最高的出价者可以拿回她的钱。 在投标期结束后,受益人需要手动调用合约来接收他的钱 - 合约不能自己激活接收% D2 h8 |+ s* g# ^6 ^+ s g8 \0 y
pragma solidity ^0.4.22;
contract SimpleAuction {
// 拍卖的参数。
address public beneficiary;
// 时间是unix的绝对时间戳(自1970-01-01以来的秒数)8 W# [3 S6 o, G3 {
// 或以秒为单位的时间段。
uint public auctionEnd;
// 拍卖的当前状态
address public highestBidder;
uint public highestBid;
//可以取回的之前的出价
mapping(address => uint) pendingReturns; C, g, S. W. {; @3 U( q& }% U
// 拍卖结束后设为 true,将禁止所有的变更
bool ended;
// 变更触发的事件
event HighestBidIncreased(address bidder, uint amount);
event AuctionEnded(address winner, uint amount);
// 以下是所谓的 natspec 注释,可以通过三个斜杠来识别。
// 当用户被要求确认交易时将显示。
/// 以受益者地址 `_beneficiary` 的名义,
/// 创建一个简单的拍卖,拍卖时间为 `_biddingTime` 秒。4 [. @' X0 {* p( T
constructor(
uint _biddingTime,2 Q. S4 t' G/ S
address _beneficiary! V" I1 L! ]) `! {# ?( ?( N9 @5 p
) public {5 I3 \& w: i/ f% I/ b9 e
beneficiary = _beneficiary;, c* w+ e' h" z/ G. o$ {
auctionEnd = now + _biddingTime;0 A `6 a/ ^4 f) l% L) T
}
/// 对拍卖进行出价,具体的出价随交易一起发送。7 t2 ^$ S/ O! t
/// 如果没有在拍卖中胜出,则返还出价。
function bid() public payable {
// 参数不是必要的。因为所有的信息已经包含在了交易中。3 n% H, z" @; U
// 对于能接收以太币的函数,关键字 payable 是必须的。
// 如果拍卖已结束,撤销函数的调用。% @$ o* n5 `0 e
require(
now highestBid,& s4 O) s5 B6 K1 ?# A( ~
"There already is a higher bid."
);
if (highestBid != 0) {
// 返还出价时,简单地直接调用 highestBidder.send(highestBid) 函数,. |# B1 o, i' M D2 e6 @
// 是有安全风险的,因为它有可能执行一个非信任合约。
// 更为安全的做法是让接收方自己提取金钱。1 s2 l6 B* m# ~8 V$ j+ e& S, M
pendingReturns[highestBidder] += highestBid;5 t, G' A' n1 v$ G2 [
}$ a4 t& R9 t& g! U# p: G& H
highestBidder = msg.sender;9 y6 N& T( Q: i, U2 _
highestBid = msg.value;- B1 ~3 K# F( N: L) `3 f
emit HighestBidIncreased(msg.sender, msg.value);
}
/// 取回出价(当该出价已被超越)" P }/ r+ w+ j. d+ U
function withdraw() public returns (bool) {! x$ z# ?( j4 K& ~/ I Y
uint amount = pendingReturns[msg.sender];9 d# w9 e' e, E$ v
if (amount > 0) {
// 这里很重要,首先要设零值。5 F8 P& r% z- E
// 因为,作为接收调用的一部分,! ]; c/ k) h4 Q% e8 ]. |
// 接收者可以在 `send` 返回之前,重新调用该函数。$ G% q' j+ V7 U( M. H# Y/ }
pendingReturns[msg.sender] = 0;% j" r7 d. T! B% g7 v
if (!msg.sender.send(amount)) {
// 这里不需抛出异常,只需重置未付款
pendingReturns[msg.sender] = amount;
return false;
}" D+ i b' _- x9 R+ [3 N/ }
}
return true;' v y1 r/ a! n' J
}# S3 g5 @0 A9 H2 L# \7 r" n
/// 结束拍卖,并把最高的出价发送给受益人
function auctionEnd() public {
// 对于可与其他合约交互的函数(意味着它会调用其他函数或发送以太币),; A; k8 j8 B) P& k4 d0 }
// 一个好的指导方针是将其结构分为三个阶段:
// 1. 检查条件9 C1 g. y7 J' f9 m6 |: l) v$ v( S
// 2. 执行动作 (可能会改变条件)# x% R5 b& c( t) Q3 Z+ p ~
// 3. 与其他合约交互( r4 j" s/ j- T* H: q; T' E
// 如果这些阶段相混合,其他的合约可能会回调当前合约并修改状态,
// 或者导致某些效果(比如支付以太币)多次生效。# n& ^) k4 s0 C1 `
// 如果合约内调用的函数包含了与外部合约的交互,
// 则它也会被认为是与外部合约有交互的。+ B/ B L# o7 k( A) c# q9 }/ M
// 1. 条件
require(now >= auctionEnd, "Auction not yet ended.");
require(!ended, "auctionEnd has already been called.");- N0 h* z! A, V7 k) ^
// 2. 生效
ended = true;
emit AuctionEnded(highestBidder, highestBid);
// 3. 交互
beneficiary.transfer(highestBid);
}
}' I. s# ^9 n- l& |$ v0 N, C
秘密竞拍(盲拍)
之前的公开拍卖接下来将被扩展为一个秘密竞拍。 秘密竞拍的好处是在投标结束前不会有时间压力。 在一个透明的计算平台上进行秘密竞拍听起来像是自相矛盾,但密码学可以实现它。
在 投标期间 ,投标人实际上并没有发送她的出价,而只是发送一个哈希版本的出价。 由于目前几乎不可能找到两个(足够长的)值,其哈希值是相等的,因此投标人可通过该方式提交报价。 在投标结束后,投标人必须公开他们的出价:他们不加密的发送他们的出价,合约检查出价的哈希值是否与投标期间提供的相同。8 W3 X& k7 F9 i$ u
另一个挑战是如何使拍卖同时做到 绑定和秘密 : 唯一能阻止投标者在她赢得拍卖后不付款的方式是,让她将钱连同出价一起发出。 但由于资金转移在 以太坊Ethereum 中不能被隐藏,因此任何人都可以看到转移的资金。
下面的合约通过接受任何大于最高出价的值来解决这个问题。 当然,因为这只能在披露阶段进行检查,有些出价可能是 无效 的, 并且,这是故意的(与高出价一起,它甚至提供了一个明确的标志来标识无效的出价): 投标人可以通过设置几个或高或低的无效出价来迷惑竞争对手。
pragma solidity >0.4.23 Bid[]) public bids;
address public highestBidder;' T& S8 h2 `! h1 C% B/ Y( q
uint public highestBid;
// 可以取回的之前的出价, k/ ?1 x- z3 K& |! s# M' L0 z4 Y) [8 s
mapping(address => uint) pendingReturns;
event AuctionEnded(address winner, uint highestBid);
/// 使用 modifier 可以更便捷的校验函数的入参。
/// `onlyBefore` 会被用于后面的 `bid` 函数:+ [6 X+ D" S* z
/// 新的函数体是由 modifier 本身的函数体,并用原函数体替换 `_;` 语句来组成的。- S6 E5 i7 B4 q3 b6 ?/ ?7 l. r
modifier onlyBefore(uint _time) { require(now _time); _; }* d3 I, M& P# r" z" `6 g
constructor(
uint _biddingTime,
uint _revealTime,
address _beneficiary+ |( S% \* _0 B+ t, T" ?& J7 b
) public {
beneficiary = _beneficiary;
biddingEnd = now + _biddingTime;
revealEnd = biddingEnd + _revealTime;3 X3 p# }& y! C* t. C# ^( j
}3 {- M3 l i. S# }! i0 f H) r& l3 S
/// 可以通过 `_blindedBid` = keccak256(value, fake, secret)
/// 设置一个秘密竞拍。: V0 k6 k X4 F" O+ ]
/// 只有在出价披露阶段被正确披露,已发送的以太币才会被退还。
/// 如果与出价一起发送的以太币至少为 “value” 且 “fake” 不为真,则出价有效。
/// 将 “fake” 设置为 true ,然后发送满足订金金额但又不与出价相同的金额是隐藏实际出价的方法。3 `* P: _ E: \% _& I8 _! t8 X5 U
/// 同一个地址可以放置多个出价。; w! L) O2 r% \2 b% Q- _9 E" N
function bid(bytes32 _blindedBid)4 m: k' O5 E/ w4 y* b# S. B
public
payable
onlyBefore(biddingEnd)) M' f) S6 h% o0 M( A3 B( E
{6 b6 C* w3 Z! r. y
bids[msg.sender].push(Bid({2 |6 r$ Y, R$ P8 W/ N
blindedBid: _blindedBid,
deposit: msg.value
}));
}
/// 披露你的秘密竞拍出价。6 q9 J7 h4 u2 q5 q; ^0 h/ B
/// 对于所有正确披露的无效出价以及除最高出价以外的所有出价,你都将获得退款。6 r* Y, x# U( G
function reveal(3 |. |" D3 n* J: V5 b$ y9 m
uint[] _values,: F. e. t# a2 {* Q) e) t" O- F* P
bool[] _fake, L3 |1 P8 a5 _1 G) l2 \
bytes32[] _secret; A3 y1 f1 g" W
)( H: P/ L$ r* Q( M- q
public
onlyAfter(biddingEnd)
onlyBefore(revealEnd)
{4 `. K% i3 {- R% M3 H9 F2 z
uint length = bids[msg.sender].length;* s2 S0 u$ C2 H+ v; `9 n, H" ~
require(_values.length == length);
require(_fake.length == length);2 H: {: X; K! j$ [1 W
require(_secret.length == length);
uint refund;
for (uint i = 0; i = value) {+ C2 J+ O4 g8 J5 @- E* W/ C! i& x
if (placeBid(msg.sender, value))+ l( F; M8 o+ Q; k$ l0 A4 N f
refund -= value;1 a n4 Z, {# K8 ]
}0 s- H& T" | q; R, H
// 使发送者不可能再次认领同一笔订金: E; O9 d9 ], V" o6 f$ Z: V! S7 z2 Q
bid.blindedBid = bytes32(0);
}
msg.sender.transfer(refund);1 V& q: b( A$ V; I; t1 V
}9 r% _! [8 h6 x. b8 c
// 这是一个 "internal" 函数, 意味着它只能在本合约(或继承合约)内被调用& d6 T; ~! U! I4 d0 N6 Y3 M7 J
function placeBid(address bidder, uint value) internal
returns (bool success)
{$ b/ S* F9 l) w/ \- v) q" t7 K8 K
if (value 0) {
// 这里很重要,首先要设零值。0 y7 J( a; L0 @
// 因为,作为接收调用的一部分,
// 接收者可以在 `transfer` 返回之前重新调用该函数。(可查看上面关于‘条件 -> 影响 -> 交互’的标注)
pendingReturns[msg.sender] = 0;
msg.sender.transfer(amount);
}
}( r, Y# k4 H1 d1 W5 ]& g* y
/// 结束拍卖,并把最高的出价发送给受益人
function auctionEnd()
public
onlyAfter(revealEnd)/ x/ \% @' y) [9 }: z/ Y$ B4 o
{
require(!ended);
emit AuctionEnded(highestBidder, highestBid);! g4 j1 u( H6 K% Q& L
ended = true;
beneficiary.transfer(highestBid);
}
}* Y; y# h+ N4 K! r" {0 ^' E
安全的远程购买3 i7 V0 V+ s3 {5 d/ S. r7 i
pragma solidity ^0.4.22;
contract Purchase {
uint public value;% L0 \1 |; N* b% ^* l
address public seller;
address public buyer;
enum State { Created, Locked, Inactive }1 A. m E9 U4 t& M2 V6 b* S
State public state;
//确保 `msg.value` 是一个偶数。& R0 ^/ x. c6 \
//如果它是一个奇数,则它将被截断。
//通过乘法检查它不是奇数。
constructor() public payable {! Q' `! i- q/ U. g
seller = msg.sender;
value = msg.value / 2;
require((2 * value) == msg.value, "Value has to be even.");
}
modifier condition(bool _condition) {
require(_condition);
_;
}
modifier onlyBuyer() {7 D6 z& m* c- m% @( f! @. W4 U( @
require(3 c, }0 m6 B0 ?& y
msg.sender == buyer,
"Only buyer can call this."
);
_;0 O- e2 T; a1 Y/ V
}
modifier onlySeller() {
require(; o. ^% {3 O/ `
msg.sender == seller,
"Only seller can call this."
);! k4 L& m/ g6 V& z% G h
_;
}# X% g7 Y& \) N
modifier inState(State _state) {0 Q# w% T; r* n7 P
require(* [, g! W, ]- ~ }/ z
state == _state,) ?0 Z$ N1 T8 ^# a, O2 f, ~. r: s
"Invalid state."
);# D0 d" ^6 b6 p2 ^
_;! M& \4 f8 j/ I1 t0 @
}
event Aborted();
event PurchaseConfirmed();
event ItemReceived();; x$ }* B5 A( ]+ E$ i+ E
///中止购买并回收以太币。% s# ~5 R( J* u: g4 b2 L* T
///只能在合约被锁定之前由卖家调用。
function abort()5 Q; T- D* b# ^8 [
public
onlySeller6 b4 Y; V7 {- X7 E& e* N& F0 B
inState(State.Created). c: F0 {/ [' }, [6 v, v
{) w; |4 E( C/ }7 }' ^
emit Aborted();# T: L- P0 ?$ I, G1 K1 H' Z
state = State.Inactive;
seller.transfer(address(this).balance);
}; q2 {0 j7 B* M# O) s1 k, k$ k
/// 买家确认购买。
/// 交易必须包含 `2 * value` 个以太币。
/// 以太币会被锁定,直到 confirmReceived 被调用。1 W& S6 w# R N+ I9 n' p
function confirmPurchase(): r1 \3 o) s# }2 Y
public' u% v6 O* \2 Q+ g% e' V4 A
inState(State.Created)
condition(msg.value == (2 * value)), |2 ^7 t+ B2 V: a6 s8 E
payable
{
emit PurchaseConfirmed();; l- m4 r1 S ], J/ g" Y
buyer = msg.sender;
state = State.Locked;7 `9 u; E" D2 t9 `- w3 e
}
/// 确认你(买家)已经收到商品。
/// 这会释放被锁定的以太币。
function confirmReceived()- Y. v C0 ]4 y
public7 @% F0 Q V1 M9 w
onlyBuyer
inState(State.Locked)
{
emit ItemReceived();) b `4 W! O# B1 Y; E, y- @0 |
// 首先修改状态很重要,否则的话,由 `transfer` 所调用的合约可以回调进这里(再次接收以太币)。5 J+ O W4 j% q" d/ O1 B6 m3 c
state = State.Inactive;1 V4 |3 }7 ~ }+ U+ ]: \( k, A
// 注意: 这实际上允许买方和卖方阻止退款 - 应该使用取回模式。
buyer.transfer(value); \6 H: ^7 K* C- G+ w# _" i
seller.transfer(address(this).balance);3 ]: A x- w5 R$ O
}
}
成为第一个吐槽的人