pleth 1.1.1__tar.gz

pleth-1.1.1/.gitignore

@@ -0,0 +1,4 @@
+/.pytest_cache
+/build
+/dist
+/pyeth.egg-info

pleth-1.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Mohanson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pleth-1.1.1/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.3
+Name: pleth
+Version: 1.1.1
+Summary: Python SDK for ETH
+Project-URL: homepage, https://github.com/mohanson/pyeth
+Author-email: Mohanson <mohanson@outlook.com>
+License: MIT License
+        
+        Copyright (c) 2024 Mohanson
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+Requires-Dist: pycryptodome
+Requires-Dist: requests
+Description-Content-Type: text/markdown
+
+# Python SDK for ETH
+
+Python ETH is an experimental project that aims to provide human-friendly interfaces for common ETH operations. Note that Python ETH is not a complete SDK, but only implements the ETH functions that I am interested in.
+
+## Installation
+
+```sh
+$ git clone https://github.com/mohanson/pyeth
+$ cd pyeth
+$ python -m pip install --editable .
+```
+
+## Usage
+
+**example/addr.py**
+
+Calculate the address from a private key.
+
+```sh
+$ python example/addr.py --prikey 0x1
+
+# 0x7e5f4552091a69125d5dfcb7b8c2659029395bdf
+```
+
+**example/balance.py**
+
+Get the balance by an address.
+
+```sh
+$ python example/balance.py --addr 0x7e5f4552091a69125d5dfcb7b8c2659029395bdf
+
+# 39934.9989371221
+```
+
+**example/collision.py**
+
+Generate a random private key and check whether there are assets under the private key.
+
+```sh
+$ python example/collision.py --net mainnet
+```
+
+**example/scan_erc20.py**
+
+Print all usdt transfer events in the last block.
+
+```sh
+$ python example/scan_erc20.py
+
+# 0x4d74d6fb5a75d121cda9f9dfbd0bd074999b43731f17140606ea57eccb5a7192
+# 0x11b815efb8f581194ae79006d24e0d814b7697f6 0xa69babef1ca67a37ffaf7a485dfff3382056e78c 135241.983213
+# ...
+```
+
+**example/scan_eth.py**
+
+Get the latest block and print out the transaction hash, sender, receiver and value(in ether).
+
+```sh
+$ python example/scan_eth.py --net mainnet
+
+# 0x41733e4e2b1537c9be99ad591c2e2a608dbff547ebd91acbb65e9a205aceb3ff
+# 0x9ab23085cb3e847d37819a712512dfd5d60c8d88 0x429cf888dae41d589d57f6dc685707bec755fe63 1.9937829e-11
+# ...
+```
+
+**example/storage.py**
+
+Publish a storage contract, then store a number 42 in the contract, and finally read this number.
+
+```sh
+$ python example/storage.py --action deploy --prikey 0x1
+# hash = 0xc4a663c8a867d1d6fcbb8b57794eb732baa1bf6cb4c1b0c1cee278e00c8fd644
+# addr = 0x930b793f778bbf43fab1080abf1840e018831cde
+
+$ python example/storage.py --action set --addr 0x930b793f778bbf43fab1080abf1840e018831cde --prikey 0x1
+# hash = 0x95c3fab08f6f4dcac14db157c2c2936417ae528acf9637fd50f772ac617072b5
+
+$ python example/storage.py --action get --addr 0x930b793f778bbf43fab1080abf1840e018831cde
+# data = 0x000000000000000000000000000000000000000000000000000000000000002a
+```
+
+**example/transfer.py**
+
+Transfer ether to other.
+
+```sh
+$ python example/transfer.py --prikey 0x1 --to 0x2b5ad5c4795c026514f8317c7a215e218dccd6cf --value 0.05
+# 0xfdeb27f32a21c793562daa8fa2780546e3304620a9925337c7df5e4e9819ef3a
+```
+
+## Test
+
+```sh
+$ git clone https://github.com/ethereum/go-ethereum --branch release/1.14
+$ cd go-ethereum
+$ make geth
+
+$ geth --dev --http
+$ geth --exec "eth.sendTransaction({from: eth.accounts[0], to: '0x7e5f4552091a69125d5dfcb7b8c2659029395bdf', value: web3.toWei(10000, 'ether')})" attach /tmp/geth.ipc
+$ pytest -v
+```
+
+## License
+
+MIT

pleth-1.1.1/README.md

@@ -0,0 +1,106 @@
+# Python SDK for ETH
+
+Python ETH is an experimental project that aims to provide human-friendly interfaces for common ETH operations. Note that Python ETH is not a complete SDK, but only implements the ETH functions that I am interested in.
+
+## Installation
+
+```sh
+$ git clone https://github.com/mohanson/pyeth
+$ cd pyeth
+$ python -m pip install --editable .
+```
+
+## Usage
+
+**example/addr.py**
+
+Calculate the address from a private key.
+
+```sh
+$ python example/addr.py --prikey 0x1
+
+# 0x7e5f4552091a69125d5dfcb7b8c2659029395bdf
+```
+
+**example/balance.py**
+
+Get the balance by an address.
+
+```sh
+$ python example/balance.py --addr 0x7e5f4552091a69125d5dfcb7b8c2659029395bdf
+
+# 39934.9989371221
+```
+
+**example/collision.py**
+
+Generate a random private key and check whether there are assets under the private key.
+
+```sh
+$ python example/collision.py --net mainnet
+```
+
+**example/scan_erc20.py**
+
+Print all usdt transfer events in the last block.
+
+```sh
+$ python example/scan_erc20.py
+
+# 0x4d74d6fb5a75d121cda9f9dfbd0bd074999b43731f17140606ea57eccb5a7192
+# 0x11b815efb8f581194ae79006d24e0d814b7697f6 0xa69babef1ca67a37ffaf7a485dfff3382056e78c 135241.983213
+# ...
+```
+
+**example/scan_eth.py**
+
+Get the latest block and print out the transaction hash, sender, receiver and value(in ether).
+
+```sh
+$ python example/scan_eth.py --net mainnet
+
+# 0x41733e4e2b1537c9be99ad591c2e2a608dbff547ebd91acbb65e9a205aceb3ff
+# 0x9ab23085cb3e847d37819a712512dfd5d60c8d88 0x429cf888dae41d589d57f6dc685707bec755fe63 1.9937829e-11
+# ...
+```
+
+**example/storage.py**
+
+Publish a storage contract, then store a number 42 in the contract, and finally read this number.
+
+```sh
+$ python example/storage.py --action deploy --prikey 0x1
+# hash = 0xc4a663c8a867d1d6fcbb8b57794eb732baa1bf6cb4c1b0c1cee278e00c8fd644
+# addr = 0x930b793f778bbf43fab1080abf1840e018831cde
+
+$ python example/storage.py --action set --addr 0x930b793f778bbf43fab1080abf1840e018831cde --prikey 0x1
+# hash = 0x95c3fab08f6f4dcac14db157c2c2936417ae528acf9637fd50f772ac617072b5
+
+$ python example/storage.py --action get --addr 0x930b793f778bbf43fab1080abf1840e018831cde
+# data = 0x000000000000000000000000000000000000000000000000000000000000002a
+```
+
+**example/transfer.py**
+
+Transfer ether to other.
+
+```sh
+$ python example/transfer.py --prikey 0x1 --to 0x2b5ad5c4795c026514f8317c7a215e218dccd6cf --value 0.05
+# 0xfdeb27f32a21c793562daa8fa2780546e3304620a9925337c7df5e4e9819ef3a
+```
+
+## Test
+
+```sh
+$ git clone https://github.com/ethereum/go-ethereum --branch release/1.14
+$ cd go-ethereum
+$ make geth
+
+$ geth --dev --http
+$ geth --exec "eth.sendTransaction({from: eth.accounts[0], to: '0x7e5f4552091a69125d5dfcb7b8c2659029395bdf', value: web3.toWei(10000, 'ether')})" attach /tmp/geth.ipc
+$ pytest -v
+```
+
+## License
+
+MIT

pleth-1.1.1/eth/__init__.py

@@ -0,0 +1,9 @@
+from . import abi
+from . import config
+from . import core
+from . import denomination
+from . import ecdsa
+from . import rlp
+from . import rpc
+from . import secp256k1
+from . import wallet

pleth-1.1.1/eth/abi.py

@@ -0,0 +1,41 @@
+import eth.core
+import typing
+
+# The Contract Application Binary Interface (ABI) is the standard way to interact with contracts in the Ethereum
+# ecosystem, both from outside the blockchain and for contract-to-contract interaction. Data is encoded according to
+# its type, as described in this specification. The encoding is not self describing and thus requires a schema in order
+# to decode.
+#
+# See: https://docs.soliditylang.org/en/latest/abi-spec.html
+
+def encode_uint256(data: int) -> bytearray:
+    assert data >= 0
+    assert data <= 0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
+    return bytearray(data.to_bytes(32))
+
+
+def decode_uint256(data: bytearray) -> int:
+    assert len(data) == 32
+    return int.from_bytes(data)
+
+
+def encode_address(data: bytearray) -> bytearray:
+    assert len(data) == 20
+    return bytearray(12) + data
+
+
+def decode_address(data: bytearray) -> bytearray:
+    assert len(data) == 32
+    return data[12:]
+
+
+def function_selector(name: str, args_type: typing.List[str]) -> bytearray:
+    s = name + '(' + ','.join(args_type) + ')'
+    return eth.core.hash(bytearray(s.encode()))[:4]
+
+
+def argument_encoding(data: typing.List[bytearray]) -> bytearray:
+    s = bytearray()
+    for e in data:
+        s.extend(e)
+    return s

pleth-1.1.1/eth/config.py

@@ -0,0 +1,46 @@
+import random
+import requests
+import typing
+
+
+class ObjectDict(dict):
+    def __getattr__(self, name: str) -> typing.Any:
+        try:
+            return self[name]
+        except KeyError:
+            raise AttributeError(name)
+
+    def __setattr__(self, name: str, value: typing.Any):
+        self[name] = value
+
+
+develop = ObjectDict({
+    'chain_id': 1337,
+    'gas_base_fee': 21000,
+    'url': 'http://127.0.0.1:8545',
+})
+
+mainnet = ObjectDict({
+    'chain_id': 1,
+    'gas_base_fee': 21000,
+    'url': 'https://eth.drpc.org',
+})
+
+testnet = ObjectDict({
+    'chain_id': 11155111,
+    'gas_base_fee': 21000,
+    'url': 'https://rpc.sepolia.org',
+})
+
+
+def upgrade(url: str):
+    develop.chain_id = int(requests.post(url, json={
+        'id': random.randint(0x00000000, 0xffffffff),
+        'jsonrpc': '2.0',
+        'method': 'eth_chainId',
+        'params': []
+    }).json()['result'], 0)
+    develop.url = url
+
+
+current = develop