Skip to content

Commit 4900468

Browse files
committed
Remove NatSpec documentation comments that are under @dev tag
1 parent 7308b54 commit 4900468

File tree

13 files changed

+42
-177
lines changed

13 files changed

+42
-177
lines changed

autonity/contracts/__init__.py

Whitespace-only changes.

autonity/contracts/accountability.py

Lines changed: 5 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
"""Accountability contract binding and data structures."""
22

3-
# This module has been generated using pyabigen v0.2.8
3+
# This module has been generated using pyabigen v0.2.9
44

55
import enum
66
import typing
@@ -92,37 +92,22 @@ def __init__(
9292

9393
@property
9494
def InnocenceProven(self) -> typing.Type[base_contract.BaseContractEvent]:
95-
"""Binding for `event InnocenceProven` on the Accountability contract.
96-
97-
Event emitted after receiving a proof-of-innocence cancelling an accusation.
98-
"""
95+
"""Binding for `event InnocenceProven` on the Accountability contract."""
9996
return self._contract.events.InnocenceProven
10097

10198
@property
10299
def NewAccusation(self) -> typing.Type[base_contract.BaseContractEvent]:
103-
"""Binding for `event NewAccusation` on the Accountability contract.
104-
105-
Event emitted after receiving an accusation, the reported validator has a
106-
certain amount of time to submit a proof-of-innocence, otherwise, he gets
107-
slashed.
108-
"""
100+
"""Binding for `event NewAccusation` on the Accountability contract."""
109101
return self._contract.events.NewAccusation
110102

111103
@property
112104
def NewFaultProof(self) -> typing.Type[base_contract.BaseContractEvent]:
113-
"""Binding for `event NewFaultProof` on the Accountability contract.
114-
115-
Event emitted when a fault proof has been submitted. The reported validator will
116-
be silencied and slashed at the end of the current epoch.
117-
"""
105+
"""Binding for `event NewFaultProof` on the Accountability contract."""
118106
return self._contract.events.NewFaultProof
119107

120108
@property
121109
def SlashingEvent(self) -> typing.Type[base_contract.BaseContractEvent]:
122-
"""Binding for `event SlashingEvent` on the Accountability contract.
123-
124-
Event emitted after a successful slashing.
125-
"""
110+
"""Binding for `event SlashingEvent` on the Accountability contract."""
126111
return self._contract.events.SlashingEvent
127112

128113
def beneficiaries(

autonity/contracts/acu.py

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
"""ACU contract binding and data structures."""
22

3-
# This module has been generated using pyabigen v0.2.8
3+
# This module has been generated using pyabigen v0.2.9
44

55
import typing
66

@@ -15,7 +15,7 @@ class ACU:
1515
"""ACU contract binding.
1616
1717
Computes the value of the ACU, an optimal currency basket of 7 free-floating fiat
18-
currencies. Intended to be deployed by the protocol at genesis.
18+
currencies.
1919
2020
Parameters
2121
----------
@@ -60,8 +60,7 @@ def modify_basket(
6060
) -> contract.ContractFunction:
6161
"""Binding for `modifyBasket` on the ACU contract.
6262
63-
Modify the ACU symbols, quantites, or scale. Only the operator is authorized to
64-
modify the basket.
63+
Modify the ACU symbols, quantites, or scale.
6564
6665
Parameters
6766
----------

autonity/contracts/autonity.py

Lines changed: 9 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
"""Autonity contract binding and data structures."""
22

3-
# This module has been generated using pyabigen v0.2.8
3+
# This module has been generated using pyabigen v0.2.9
44

55
import enum
66
import typing
@@ -147,11 +147,7 @@ def AppliedUnbondingReverted(self) -> typing.Type[base_contract.BaseContractEven
147147

148148
@property
149149
def Approval(self) -> typing.Type[base_contract.BaseContractEvent]:
150-
"""Binding for `event Approval` on the Autonity contract.
151-
152-
Emitted when the allowance of a `spender` for an `owner` is set by a call to
153-
{approve}. `value` is the new allowance.
154-
"""
150+
"""Binding for `event Approval` on the Autonity contract."""
155151
return self._contract.events.Approval
156152

157153
@property
@@ -181,11 +177,7 @@ def EpochPeriodUpdated(self) -> typing.Type[base_contract.BaseContractEvent]:
181177

182178
@property
183179
def MinimumBaseFeeUpdated(self) -> typing.Type[base_contract.BaseContractEvent]:
184-
"""Binding for `event MinimumBaseFeeUpdated` on the Autonity contract.
185-
186-
Emitted when the Minimum Gas Price was updated and set to `gasPrice`. Note that
187-
`gasPrice` may be zero.
188-
"""
180+
"""Binding for `event MinimumBaseFeeUpdated` on the Autonity contract."""
189181
return self._contract.events.MinimumBaseFeeUpdated
190182

191183
@property
@@ -243,11 +235,7 @@ def Rewarded(self) -> typing.Type[base_contract.BaseContractEvent]:
243235

244236
@property
245237
def Transfer(self) -> typing.Type[base_contract.BaseContractEvent]:
246-
"""Binding for `event Transfer` on the Autonity contract.
247-
248-
Emitted when `value` tokens are moved from one account (`from`) to another
249-
(`to`). Note that `value` may be zero.
250-
"""
238+
"""Binding for `event Transfer` on the Autonity contract."""
251239
return self._contract.events.Transfer
252240

253241
@property
@@ -257,10 +245,7 @@ def UnbondingRejected(self) -> typing.Type[base_contract.BaseContractEvent]:
257245

258246
@property
259247
def UnlockingScheduleFailed(self) -> typing.Type[base_contract.BaseContractEvent]:
260-
"""Binding for `event UnlockingScheduleFailed` on the Autonity contract.
261-
262-
event to notify the failure in unlocking mechanism of the non-stakable schedules
263-
"""
248+
"""Binding for `event UnlockingScheduleFailed` on the Autonity contract."""
264249
return self._contract.events.UnlockingScheduleFailed
265250

266251
def commission_rate_precision(
@@ -304,8 +289,6 @@ def allowance(
304289
) -> int:
305290
"""Binding for `allowance` on the Autonity contract.
306291
307-
See {IERC20-allowance}.
308-
309292
Parameters
310293
----------
311294
owner : eth_typing.ChecksumAddress
@@ -328,8 +311,6 @@ def approve(
328311
) -> contract.ContractFunction:
329312
"""Binding for `approve` on the Autonity contract.
330313
331-
See {IERC20-approve}. Requirements: - `spender` cannot be the zero address.
332-
333314
Parameters
334315
----------
335316
spender : eth_typing.ChecksumAddress
@@ -517,8 +498,6 @@ def decimals(
517498
) -> int:
518499
"""Binding for `decimals` on the Autonity contract.
519500
520-
ERC-20 Optional.
521-
522501
Returns
523502
-------
524503
int
@@ -594,8 +573,7 @@ def get_committee(
594573
) -> typing.List[CommitteeMember]:
595574
"""Binding for `getCommittee` on the Autonity contract.
596575
597-
Returns the block committee. Current block committee if called before
598-
finalize(), next block if called after.
576+
Returns the block committee.
599577
600578
Returns
601579
-------
@@ -692,9 +670,6 @@ def get_minimum_base_fee(
692670
) -> int:
693671
"""Binding for `getMinimumBaseFee` on the Autonity contract.
694672
695-
Autonity transaction's gas price must be greater or equal to the minimum gas
696-
price.
697-
698673
Returns
699674
-------
700675
int
@@ -1048,8 +1023,6 @@ def name(
10481023
) -> str:
10491024
"""Binding for `name` on the Autonity contract.
10501025
1051-
ERC-20 Optional.
1052-
10531026
Returns
10541027
-------
10551028
str
@@ -1064,8 +1037,7 @@ def pause_validator(
10641037
) -> contract.ContractFunction:
10651038
"""Binding for `pauseValidator` on the Autonity contract.
10661039
1067-
Pause the validator and stop it accepting delegations. emit a
1068-
{DisabledValidator} event.
1040+
Pause the validator and stop it accepting delegations.
10691041
10701042
Parameters
10711043
----------
@@ -1107,7 +1079,6 @@ def register_validator(
11071079
Register a new validator in the system. The validator might be selected to be
11081080
part of consensus. This validator will have assigned to its treasury account the
11091081
caller of this function. A new token "Liquid Stake" is deployed at this phase.
1110-
Emit a {RegisteredValidator} event.
11111082
11121083
Parameters
11131084
----------
@@ -1330,8 +1301,7 @@ def set_minimum_base_fee(
13301301
) -> contract.ContractFunction:
13311302
"""Binding for `setMinimumBaseFee` on the Autonity contract.
13321303
1333-
Set the minimum gas price. Restricted to the operator account. Emit a
1334-
{MinimumBaseFeeUpdated} event.
1304+
Set the minimum gas price. Restricted to the operator account.
13351305
13361306
Parameters
13371307
----------
@@ -1561,8 +1531,6 @@ def symbol(
15611531
) -> str:
15621532
"""Binding for `symbol` on the Autonity contract.
15631533
1564-
ERC-20 Optional.
1565-
15661534
Returns
15671535
-------
15681536
str
@@ -1592,8 +1560,7 @@ def transfer(
15921560
) -> contract.ContractFunction:
15931561
"""Binding for `transfer` on the Autonity contract.
15941562
1595-
Moves `amount` NTN stake tokens from the caller's account to `recipient`. Emits
1596-
a {Transfer} event. Implementation of {IERC20 transfer}
1563+
Moves `amount` NTN stake tokens from the caller's account to `recipient`.
15971564
15981565
Parameters
15991566
----------
@@ -1618,11 +1585,6 @@ def transfer_from(
16181585
) -> contract.ContractFunction:
16191586
"""Binding for `transferFrom` on the Autonity contract.
16201587
1621-
See {IERC20-transferFrom}. Emits an {Approval} event indicating the updated
1622-
allowance. Requirements: - `sender` and `recipient` must be allowed to hold
1623-
stake. - `sender` must have a balance of at least `amount`. - the caller must
1624-
have allowance for ``sender``'s tokens of at least `amount`.
1625-
16261588
Parameters
16271589
----------
16281590
_sender : eth_typing.ChecksumAddress

autonity/contracts/ierc20.py

Lines changed: 3 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
"""IERC20 contract binding and data structures."""
22

3-
# This module has been generated using pyabigen v0.2.8
3+
# This module has been generated using pyabigen v0.2.9
44

55
import typing
66

@@ -14,8 +14,6 @@
1414
class IERC20:
1515
"""IERC20 contract binding.
1616
17-
Interface of the ERC20 standard as defined in the EIP.
18-
1917
Parameters
2018
----------
2119
w3 : web3.Web3
@@ -37,20 +35,12 @@ def __init__(
3735

3836
@property
3937
def Approval(self) -> typing.Type[base_contract.BaseContractEvent]:
40-
"""Binding for `event Approval` on the IERC20 contract.
41-
42-
Emitted when the allowance of a `spender` for an `owner` is set by a call to
43-
{approve}. `value` is the new allowance.
44-
"""
38+
"""Binding for `event Approval` on the IERC20 contract."""
4539
return self._contract.events.Approval
4640

4741
@property
4842
def Transfer(self) -> typing.Type[base_contract.BaseContractEvent]:
49-
"""Binding for `event Transfer` on the IERC20 contract.
50-
51-
Emitted when `value` tokens are moved from one account (`from`) to another
52-
(`to`). Note that `value` may be zero.
53-
"""
43+
"""Binding for `event Transfer` on the IERC20 contract."""
5444
return self._contract.events.Transfer
5545

5646
def allowance(
@@ -60,10 +50,6 @@ def allowance(
6050
) -> int:
6151
"""Binding for `allowance` on the IERC20 contract.
6252
63-
Returns the remaining number of tokens that `spender` will be allowed to spend
64-
on behalf of `owner` through {transferFrom}. This is zero by default. This value
65-
changes when {approve} or {transferFrom} are called.
66-
6753
Parameters
6854
----------
6955
owner : eth_typing.ChecksumAddress
@@ -86,15 +72,6 @@ def approve(
8672
) -> contract.ContractFunction:
8773
"""Binding for `approve` on the IERC20 contract.
8874
89-
Sets `amount` as the allowance of `spender` over the caller's tokens. Returns a
90-
boolean value indicating whether the operation succeeded. IMPORTANT: Beware that
91-
changing an allowance with this method brings the risk that someone may use both
92-
the old and the new allowance by unfortunate transaction ordering. One possible
93-
solution to mitigate this race condition is to first reduce the spender's
94-
allowance to 0 and set the desired value afterwards:
95-
https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729 Emits an
96-
{Approval} event.
97-
9875
Parameters
9976
----------
10077
spender : eth_typing.ChecksumAddress
@@ -116,8 +93,6 @@ def balance_of(
11693
) -> int:
11794
"""Binding for `balanceOf` on the IERC20 contract.
11895
119-
Returns the amount of tokens owned by `account`.
120-
12196
Parameters
12297
----------
12398
account : eth_typing.ChecksumAddress
@@ -136,8 +111,6 @@ def total_supply(
136111
) -> int:
137112
"""Binding for `totalSupply` on the IERC20 contract.
138113
139-
Returns the amount of tokens in existence.
140-
141114
Returns
142115
-------
143116
int
@@ -152,10 +125,6 @@ def transfer(
152125
) -> contract.ContractFunction:
153126
"""Binding for `transfer` on the IERC20 contract.
154127
155-
Moves `amount` tokens from the caller's account to `recipient`. Returns a
156-
boolean value indicating whether the operation succeeded. Emits a {Transfer}
157-
event.
158-
159128
Parameters
160129
----------
161130
recipient : eth_typing.ChecksumAddress
@@ -179,11 +148,6 @@ def transfer_from(
179148
) -> contract.ContractFunction:
180149
"""Binding for `transferFrom` on the IERC20 contract.
181150
182-
Moves `amount` tokens from `sender` to `recipient` using the allowance
183-
mechanism. `amount` is then deducted from the caller's allowance. Returns a
184-
boolean value indicating whether the operation succeeded. Emits a {Transfer}
185-
event.
186-
187151
Parameters
188152
----------
189153
sender : eth_typing.ChecksumAddress

autonity/contracts/inflation_controller.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
"""InflationController contract binding and data structures."""
22

3-
# This module has been generated using pyabigen v0.2.8
3+
# This module has been generated using pyabigen v0.2.9
44

55
import typing
66

0 commit comments

Comments
 (0)