Merge pull request #518 from iamdefinitelyahuman/feat-gas-used

Account.gas_used

brownie/network/account.py

@@ -17,10 +17,13 @@
 from brownie.exceptions import IncompatibleEVMVersion, UnknownAccount, VirtualMachineError
 
 from .rpc import Rpc, _revert_register
+from .state import TxHistory
 from .transaction import TransactionReceipt
 from .web3 import _resolve_address, web3
 
 __tracebackhide__ = True
+
+history = TxHistory()
 rpc = Rpc()
 
 
@@ -197,6 +200,11 @@ def balance(self) -> Wei:
         balance = web3.eth.getBalance(self.address)
         return Wei(balance)
 
+    @property
+    def gas_used(self) -> int:
+        """Returns the cumulative gas amount paid from this account."""
+        return sum(i.gas_used for i in history.from_sender(self.address))
+
     @property
     def nonce(self) -> int:
         return web3.eth.getTransactionCount(self.address)

docs/api-network.rst

@@ -225,14 +225,23 @@ Account Attributes
         >>> accounts[0].address
         '0x7Ebaa12c5d1EE7fD498b51d4F9278DC45f8D627A'
 
+.. py:attribute:: Account.gas_used
+
+    The cumulative gas amount paid for transactions from this account.
+
+    .. code-block:: python
+
+        >>> accounts[0].gas_used
+        21000
+
 .. py:attribute:: Account.nonce
 
     The current nonce of the address.
 
     .. code-block:: python
 
         >>> accounts[0].nonce
-        0
+        1
 
 Account Methods
 ***************

tests/network/account/test_account.py

@@ -19,3 +19,10 @@ def test_balance(accounts):
     balance = accounts[0].balance()
     assert type(balance) is Wei
     assert balance == "100 ether"
+
+
+def test_gas_paid(accounts):
+    accounts[0].transfer(accounts[1], 10000)
+    accounts[0].transfer(accounts[2], 10000)
+
+    assert accounts[0].gas_used == 42000