Debian Codegraph @

autotests/html/test.sol.dark.html

raw
1 <!DOCTYPE html>
2 <html><head>
3 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
4 <title>test.sol</title>
5 <meta name="generator" content="KF5::SyntaxHighlighting - Definition (Solidity) - Theme (Breeze Dark)"/>
6 </head><body style="background-color:#232629;color:#cfcfc2"><pre>
7 <span style="color:#7a7c7d;">// Solidity Sample File</span>
8 <span style="color:#7a7c7d;">// https://solidity.readthedocs.io/en/latest/solidity-by-example.html#voting</span>
9
10 <span style="font-weight:bold;">pragma</span> <span style="color:#7f8c8d;">solidity</span> &gt;=0.4.22 &lt;0.7.0;
11
12 <span style="color:#7a7c7d;">/// </span><span style="color:#3f8058;">@title</span><span style="color:#7a7c7d;"> Voting with delegation.</span>
13 <span style="color:#fdbc4b;font-weight:bold;">contract</span> Ballot <span style="color:#3f8058;">{</span>
14 <span style="color:#7a7c7d;">// This declares a new complex type which will</span>
15 <span style="color:#7a7c7d;">// be used for variables later.</span>
16 <span style="color:#7a7c7d;">// It will represent a single voter.</span>
17 <span style="font-weight:bold;">struct</span> Voter <span style="color:#3f8058;">{</span>
18 <span style="color:#2980b9;">uint</span> weight<span style="color:#3f8058;">;</span> <span style="color:#7a7c7d;">// weight is accumulated by delegation</span>
19 <span style="color:#2980b9;">bool</span> voted<span style="color:#3f8058;">;</span> <span style="color:#7a7c7d;">// if true, that person already voted</span>
20 <span style="color:#2980b9;">address</span> delegate<span style="color:#3f8058;">;</span> <span style="color:#7a7c7d;">// person delegated to</span>
21 <span style="color:#2980b9;">uint</span> vote<span style="color:#3f8058;">;</span> <span style="color:#7a7c7d;">// index of the voted proposal</span>
22 <span style="color:#3f8058;">}</span>
23
24 <span style="color:#7a7c7d;">// This is a type for a single proposal.</span>
25 <span style="font-weight:bold;">struct</span> Proposal <span style="color:#3f8058;">{</span>
26 <span style="color:#2980b9;">bytes32</span> name<span style="color:#3f8058;">;</span> <span style="color:#7a7c7d;">// short name (up to 32 bytes)</span>
27 <span style="color:#2980b9;">uint</span> voteCount<span style="color:#3f8058;">;</span> <span style="color:#7a7c7d;">// number of accumulated votes</span>
28 <span style="color:#3f8058;">}</span>
29
30 <span style="color:#2980b9;">address</span> <span style="font-weight:bold;">public</span> chairperson<span style="color:#3f8058;">;</span>
31
32 <span style="color:#7a7c7d;">// This declares a state variable that</span>
33 <span style="color:#7a7c7d;">// stores a `Voter` struct for each possible address.</span>
34 <span style="color:#2980b9;">mapping</span><span style="color:#3f8058;">(</span><span style="color:#2980b9;">address</span> <span style="color:#3f8058;">=&gt;</span> Voter<span style="color:#3f8058;">)</span> <span style="font-weight:bold;">public</span> voters<span style="color:#3f8058;">;</span>
35
36 <span style="color:#7a7c7d;">// A dynamically-sized array of `Proposal` structs.</span>
37 Proposal<span style="color:#3f8058;">[]</span> <span style="font-weight:bold;">public</span> proposals<span style="color:#3f8058;">;</span>
38
39 <span style="color:#7a7c7d;">/// Create a new ballot to choose one of `proposalNames`.</span>
40 <span style="color:#fdbc4b;font-weight:bold;">constructor</span><span style="color:#3f8058;">(</span><span style="color:#2980b9;">bytes32</span><span style="color:#3f8058;">[]</span> <span style="font-weight:bold;">memory</span> proposalNames<span style="color:#3f8058;">)</span> <span style="font-weight:bold;">public</span> <span style="color:#3f8058;">{</span>
41 chairperson <span style="color:#3f8058;">=</span> <span style="color:#7f8c8d;">msg</span><span style="color:#3f8058;">.</span>sender<span style="color:#3f8058;">;</span>
42 voters<span style="color:#3f8058;">[</span>chairperson<span style="color:#3f8058;">].</span>weight <span style="color:#3f8058;">=</span> <span style="color:#f67400;">1</span><span style="color:#3f8058;">;</span>
43
44 <span style="color:#7a7c7d;">// For each of the provided proposal names,</span>
45 <span style="color:#7a7c7d;">// create a new proposal object and add it</span>
46 <span style="color:#7a7c7d;">// to the end of the array.</span>
47 <span style="color:#fdbc4b;font-weight:bold;">for</span> <span style="color:#3f8058;">(</span><span style="color:#2980b9;">uint</span> i <span style="color:#3f8058;">=</span> <span style="color:#f67400;">0</span><span style="color:#3f8058;">;</span> i <span style="color:#3f8058;">&lt;</span> proposalNames<span style="color:#3f8058;">.</span>length<span style="color:#3f8058;">;</span> i<span style="color:#7f8c8d;">++</span><span style="color:#3f8058;">)</span> <span style="color:#3f8058;">{</span>
48 <span style="color:#7a7c7d;">// `Proposal({...})` creates a temporary</span>
49 <span style="color:#7a7c7d;">// Proposal object and `proposals.push(...)`</span>
50 <span style="color:#7a7c7d;">// appends it to the end of `proposals`.</span>
51 proposals<span style="color:#3f8058;">.</span>push<span style="color:#3f8058;">(</span>Proposal<span style="color:#3f8058;">({</span>
52 name<span style="color:#3f8058;">:</span> proposalNames<span style="color:#3f8058;">[</span>i<span style="color:#3f8058;">],</span>
53 voteCount<span style="color:#3f8058;">:</span> <span style="color:#f67400;">0</span>
54 <span style="color:#3f8058;">}));</span>
55 <span style="color:#3f8058;">}</span>
56 <span style="color:#3f8058;">}</span>
57
58 <span style="color:#7a7c7d;">// Give `voter` the right to vote on this ballot.</span>
59 <span style="color:#7a7c7d;">// May only be called by `chairperson`.</span>
60 <span style="color:#fdbc4b;font-weight:bold;">function</span> giveRightToVote<span style="color:#3f8058;">(</span><span style="color:#2980b9;">address</span> voter<span style="color:#3f8058;">)</span> <span style="font-weight:bold;">public</span> <span style="color:#3f8058;">{</span>
61 <span style="color:#7a7c7d;">// If the first argument of `require` evaluates</span>
62 <span style="color:#7a7c7d;">// to `false`, execution terminates and all</span>
63 <span style="color:#7a7c7d;">// changes to the state and to Ether balances</span>
64 <span style="color:#7a7c7d;">// are reverted.</span>
65 <span style="color:#7a7c7d;">// This used to consume all gas in old EVM versions, but</span>
66 <span style="color:#7a7c7d;">// not anymore.</span>
67 <span style="color:#7a7c7d;">// It is often a good idea to use `require` to check if</span>
68 <span style="color:#7a7c7d;">// functions are called correctly.</span>
69 <span style="color:#7a7c7d;">// As a second argument, you can also provide an</span>
70 <span style="color:#7a7c7d;">// explanation about what went wrong.</span>
71 <span style="color:#7f8c8d;">require</span><span style="color:#3f8058;">(</span>
72 <span style="color:#7f8c8d;">msg</span><span style="color:#3f8058;">.</span>sender <span style="color:#3f8058;">==</span> chairperson<span style="color:#3f8058;">,</span>
73 <span style="color:#f44f4f;">&quot;Only chairperson can give right to vote.&quot;</span>
74 <span style="color:#3f8058;">);</span>
75 <span style="color:#7f8c8d;">require</span><span style="color:#3f8058;">(</span>
76 <span style="color:#3f8058;">!</span>voters<span style="color:#3f8058;">[</span>voter<span style="color:#3f8058;">].</span>voted<span style="color:#3f8058;">,</span>
77 <span style="color:#f44f4f;">&quot;The voter already voted.&quot;</span>
78 <span style="color:#3f8058;">);</span>
79 <span style="color:#7f8c8d;">require</span><span style="color:#3f8058;">(</span>voters<span style="color:#3f8058;">[</span>voter<span style="color:#3f8058;">].</span>weight <span style="color:#3f8058;">==</span> <span style="color:#f67400;">0</span><span style="color:#3f8058;">);</span>
80 voters<span style="color:#3f8058;">[</span>voter<span style="color:#3f8058;">].</span>weight <span style="color:#3f8058;">=</span> <span style="color:#f67400;">1</span><span style="color:#3f8058;">;</span>
81 <span style="color:#3f8058;">}</span>
82
83 <span style="color:#7a7c7d;">/// Delegate your vote to the voter `to`.</span>
84 <span style="color:#fdbc4b;font-weight:bold;">function</span> delegate<span style="color:#3f8058;">(</span><span style="color:#2980b9;">address</span> to<span style="color:#3f8058;">)</span> <span style="font-weight:bold;">public</span> <span style="color:#3f8058;">{</span>
85 <span style="color:#7a7c7d;">// assigns reference</span>
86 Voter <span style="font-weight:bold;">storage</span> sender <span style="color:#3f8058;">=</span> voters<span style="color:#3f8058;">[</span><span style="color:#7f8c8d;">msg</span><span style="color:#3f8058;">.</span>sender<span style="color:#3f8058;">];</span>
87 <span style="color:#7f8c8d;">require</span><span style="color:#3f8058;">(!</span>sender<span style="color:#3f8058;">.</span>voted<span style="color:#3f8058;">,</span> <span style="color:#f44f4f;">&quot;You already voted.&quot;</span><span style="color:#3f8058;">);</span>
88
89 <span style="color:#7f8c8d;">require</span><span style="color:#3f8058;">(</span>to <span style="color:#3f8058;">!=</span> <span style="color:#7f8c8d;">msg</span><span style="color:#3f8058;">.</span>sender<span style="color:#3f8058;">,</span> <span style="color:#f44f4f;">&quot;Self-delegation is disallowed.&quot;</span><span style="color:#3f8058;">);</span>
90
91 <span style="color:#7a7c7d;">// Forward the delegation as long as</span>
92 <span style="color:#7a7c7d;">// `to` also delegated.</span>
93 <span style="color:#7a7c7d;">// In general, such loops are very dangerous,</span>
94 <span style="color:#7a7c7d;">// because if they run too long, they might</span>
95 <span style="color:#7a7c7d;">// need more gas than is available in a block.</span>
96 <span style="color:#7a7c7d;">// In this case, the delegation will not be executed,</span>
97 <span style="color:#7a7c7d;">// but in other situations, such loops might</span>
98 <span style="color:#7a7c7d;">// cause a contract to get &quot;stuck&quot; completely.</span>
99 <span style="color:#fdbc4b;font-weight:bold;">while</span> <span style="color:#3f8058;">(</span>voters<span style="color:#3f8058;">[</span>to<span style="color:#3f8058;">].</span>delegate <span style="color:#3f8058;">!=</span> <span style="color:#2980b9;">address</span><span style="color:#3f8058;">(</span><span style="color:#f67400;">0</span><span style="color:#3f8058;">))</span> <span style="color:#3f8058;">{</span>
100 to <span style="color:#3f8058;">=</span> voters<span style="color:#3f8058;">[</span>to<span style="color:#3f8058;">].</span>delegate<span style="color:#3f8058;">;</span>
101
102 <span style="color:#7a7c7d;">// We found a loop in the delegation, not allowed.</span>
103 <span style="color:#7f8c8d;">require</span><span style="color:#3f8058;">(</span>to <span style="color:#3f8058;">!=</span> <span style="color:#7f8c8d;">msg</span><span style="color:#3f8058;">.</span>sender<span style="color:#3f8058;">,</span> <span style="color:#f44f4f;">&quot;Found loop in delegation.&quot;</span><span style="color:#3f8058;">);</span>
104 <span style="color:#3f8058;">}</span>
105
106 <span style="color:#7a7c7d;">// Since `sender` is a reference, this</span>
107 <span style="color:#7a7c7d;">// modifies `voters[msg.sender].voted`</span>
108 sender<span style="color:#3f8058;">.</span>voted <span style="color:#3f8058;">=</span> <span style="font-weight:bold;">true</span><span style="color:#3f8058;">;</span>
109 sender<span style="color:#3f8058;">.</span>delegate <span style="color:#3f8058;">=</span> to<span style="color:#3f8058;">;</span>
110 Voter <span style="font-weight:bold;">storage</span> delegate_ <span style="color:#3f8058;">=</span> voters<span style="color:#3f8058;">[</span>to<span style="color:#3f8058;">];</span>
111 <span style="color:#fdbc4b;font-weight:bold;">if</span> <span style="color:#3f8058;">(</span>delegate_<span style="color:#3f8058;">.</span>voted<span style="color:#3f8058;">)</span> <span style="color:#3f8058;">{</span>
112 <span style="color:#7a7c7d;">// If the delegate already voted,</span>
113 <span style="color:#7a7c7d;">// directly add to the number of votes</span>
114 proposals<span style="color:#3f8058;">[</span>delegate_<span style="color:#3f8058;">.</span>vote<span style="color:#3f8058;">].</span>voteCount <span style="color:#3f8058;">+=</span> sender<span style="color:#3f8058;">.</span>weight<span style="color:#3f8058;">;</span>
115 <span style="color:#3f8058;">}</span> <span style="color:#fdbc4b;font-weight:bold;">else</span> <span style="color:#3f8058;">{</span>
116 <span style="color:#7a7c7d;">// If the delegate did not vote yet,</span>
117 <span style="color:#7a7c7d;">// add to her weight.</span>
118 delegate_<span style="color:#3f8058;">.</span>weight <span style="color:#3f8058;">+=</span> sender<span style="color:#3f8058;">.</span>weight<span style="color:#3f8058;">;</span>
119 <span style="color:#3f8058;">}</span>
120 <span style="color:#3f8058;">}</span>
121
122 <span style="color:#7a7c7d;">/// Give your vote (including votes delegated to you)</span>
123 <span style="color:#7a7c7d;">/// to proposal `proposals[proposal].name`.</span>
124 <span style="color:#fdbc4b;font-weight:bold;">function</span> vote<span style="color:#3f8058;">(</span><span style="color:#2980b9;">uint</span> proposal<span style="color:#3f8058;">)</span> <span style="font-weight:bold;">public</span> <span style="color:#3f8058;">{</span>
125 Voter <span style="font-weight:bold;">storage</span> sender <span style="color:#3f8058;">=</span> voters<span style="color:#3f8058;">[</span><span style="color:#7f8c8d;">msg</span><span style="color:#3f8058;">.</span>sender<span style="color:#3f8058;">];</span>
126 <span style="color:#7f8c8d;">require</span><span style="color:#3f8058;">(</span>sender<span style="color:#3f8058;">.</span>weight <span style="color:#3f8058;">!=</span> <span style="color:#f67400;">0</span><span style="color:#3f8058;">,</span> <span style="color:#f44f4f;">&quot;Has no right to vote&quot;</span><span style="color:#3f8058;">);</span>
127 <span style="color:#7f8c8d;">require</span><span style="color:#3f8058;">(!</span>sender<span style="color:#3f8058;">.</span>voted<span style="color:#3f8058;">,</span> <span style="color:#f44f4f;">&quot;Already voted.&quot;</span><span style="color:#3f8058;">);</span>
128 sender<span style="color:#3f8058;">.</span>voted <span style="color:#3f8058;">=</span> <span style="font-weight:bold;">true</span><span style="color:#3f8058;">;</span>
129 sender<span style="color:#3f8058;">.</span>vote <span style="color:#3f8058;">=</span> proposal<span style="color:#3f8058;">;</span>
130
131 <span style="color:#7a7c7d;">// If `proposal` is out of the range of the array,</span>
132 <span style="color:#7a7c7d;">// this will throw automatically and revert all</span>
133 <span style="color:#7a7c7d;">// changes.</span>
134 proposals<span style="color:#3f8058;">[</span>proposal<span style="color:#3f8058;">].</span>voteCount <span style="color:#3f8058;">+=</span> sender<span style="color:#3f8058;">.</span>weight<span style="color:#3f8058;">;</span>
135 <span style="color:#3f8058;">}</span>
136
137 <span style="color:#7a7c7d;">/// </span><span style="color:#3f8058;">@dev</span><span style="color:#7a7c7d;"> Computes the winning proposal taking all</span>
138 <span style="color:#7a7c7d;">/// previous votes into account.</span>
139 <span style="color:#fdbc4b;font-weight:bold;">function</span> winningProposal<span style="color:#3f8058;">()</span> <span style="font-weight:bold;">public</span> <span style="font-weight:bold;">view</span>
140 <span style="font-weight:bold;">returns</span> <span style="color:#3f8058;">(</span><span style="color:#2980b9;">uint</span> winningProposal_<span style="color:#3f8058;">)</span>
141 <span style="color:#3f8058;">{</span>
142 <span style="color:#2980b9;">uint</span> winningVoteCount <span style="color:#3f8058;">=</span> <span style="color:#f67400;">0</span><span style="color:#3f8058;">;</span>
143 <span style="color:#fdbc4b;font-weight:bold;">for</span> <span style="color:#3f8058;">(</span><span style="color:#2980b9;">uint</span> p <span style="color:#3f8058;">=</span> <span style="color:#f67400;">0</span><span style="color:#3f8058;">;</span> p <span style="color:#3f8058;">&lt;</span> proposals<span style="color:#3f8058;">.</span>length<span style="color:#3f8058;">;</span> p<span style="color:#7f8c8d;">++</span><span style="color:#3f8058;">)</span> <span style="color:#3f8058;">{</span>
144 <span style="color:#fdbc4b;font-weight:bold;">if</span> <span style="color:#3f8058;">(</span>proposals<span style="color:#3f8058;">[</span>p<span style="color:#3f8058;">].</span>voteCount <span style="color:#3f8058;">&gt;</span> winningVoteCount<span style="color:#3f8058;">)</span> <span style="color:#3f8058;">{</span>
145 winningVoteCount <span style="color:#3f8058;">=</span> proposals<span style="color:#3f8058;">[</span>p<span style="color:#3f8058;">].</span>voteCount<span style="color:#3f8058;">;</span>
146 winningProposal_ <span style="color:#3f8058;">=</span> p<span style="color:#3f8058;">;</span>
147 <span style="color:#3f8058;">}</span>
148 <span style="color:#3f8058;">}</span>
149 <span style="color:#3f8058;">}</span>
150
151 <span style="color:#7a7c7d;">// Calls winningProposal() function to get the index</span>
152 <span style="color:#7a7c7d;">// of the winner contained in the proposals array and then</span>
153 <span style="color:#7a7c7d;">// returns the name of the winner</span>
154 <span style="color:#fdbc4b;font-weight:bold;">function</span> winnerName<span style="color:#3f8058;">()</span> <span style="font-weight:bold;">public</span> <span style="font-weight:bold;">view</span>
155 <span style="font-weight:bold;">returns</span> <span style="color:#3f8058;">(</span><span style="color:#2980b9;">bytes32</span> winnerName_<span style="color:#3f8058;">)</span>
156 <span style="color:#3f8058;">{</span>
157 winnerName_ <span style="color:#3f8058;">=</span> proposals<span style="color:#3f8058;">[</span>winningProposal<span style="color:#3f8058;">()].</span>name<span style="color:#3f8058;">;</span>
158 <span style="color:#3f8058;">}</span>
159 <span style="color:#3f8058;">}</span>
160 </pre></body></html>