{"id":13705718,"url":"https://github.com/m-bo-one/ethereumd-proxy","last_synced_at":"2025-05-06T22:13:33.261Z","repository":{"id":39762120,"uuid":"97245734","full_name":"m-bo-one/ethereumd-proxy","owner":"m-bo-one","description":"Proxy client-server for Ethereum node using bitcoin JSON-RPC interface.","archived":false,"fork":false,"pushed_at":"2022-08-06T05:21:52.000Z","size":83,"stargazers_count":21,"open_issues_count":10,"forks_count":7,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-06T22:13:27.877Z","etag":null,"topics":["api","asyncio","bitcoin","bitcoin-core","bitcoind","ethereum","ethereumd","protocol","proxy","python","sanic"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/m-bo-one.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGES.rst","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-07-14T15:03:52.000Z","updated_at":"2022-12-03T00:43:33.000Z","dependencies_parsed_at":"2022-09-05T11:30:35.591Z","dependency_job_id":null,"html_url":"https://github.com/m-bo-one/ethereumd-proxy","commit_stats":null,"previous_names":["dev1dor/ethereumd-proxy"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m-bo-one%2Fethereumd-proxy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m-bo-one%2Fethereumd-proxy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m-bo-one%2Fethereumd-proxy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m-bo-one%2Fethereumd-proxy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/m-bo-one","download_url":"https://codeload.github.com/m-bo-one/ethereumd-proxy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252776600,"owners_count":21802469,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","asyncio","bitcoin","bitcoin-core","bitcoind","ethereum","ethereumd","protocol","proxy","python","sanic"],"created_at":"2024-08-02T22:00:46.634Z","updated_at":"2025-05-06T22:13:32.952Z","avatar_url":"https://github.com/m-bo-one.png","language":"Python","funding_links":[],"categories":["Resources"],"sub_categories":["Built with Sanic"],"readme":"|pypi| |coverage| |license|\n\nethereumd-proxy\n===============\n\nProxy client-server for Ethereum node using JSON-RPC interface.\n\nWhy?\n----\nMostly popular cryptocurrencies usually are forks of Bitcoin and all of them support Bitcoin protocol for communication with their full nodes. Ethereum go hard by own way and made own API for that. This library is a proxy to Ethereum node which implement many API methods like in bitcoind. Also it have signals like blocknotify and walletnotify.\nAll these features are implemented by ethereumd-proxy using polling and other techniques behind the scene.\n\nInstallation\n------------\n\nPython 3.5+ required.\n\nFirst you need Geth/Parity or any other ethereum node (for listening). Tested on Geth 1.6.7 and used in production.\n\nInstallation\n\n.. code:: bash\n\n   $ pip install ethereumd-proxy\n\nUsage\n-----\nIt is the same as bitcoin-cli. Except it is not a node runner, just simple proxy for listening actual node.\n\nAvailable command list:\n\n.. code:: bash\n\n   $ ethereum-cli -help\n\nTo start proxy server use:\n\n.. code:: bash\n\n   $ ethereum-cli -datadir=\u003cpath_to_your_dir_with_node_and_ethereum.conf\u003e -daemon\n\nTo stop server:\n\n.. code:: bash\n\n   $ ethereum-cli -datadir=\u003cpath_to_your_dir_with_node_and_ethereum.conf\u003e stop\n\nAlso can be used as python client connector:\n\n.. code:: python\n\n    import asyncio\n    import ethereumd\n\n    loop = asyncio.get_event_loop()\n\n    async def go():\n        client = await ethereumd.create_ethereumd_proxy(\n            'http://localhost:8545', loop=loop)\n\n        val = await client.validateaddress('0x6cace0528324a8afc2b157ceba3cdd2a27c4e21f')\n        print(val)  # will print {'isvalid': True, 'address': '0x6cace0528324a8afc2b157ceba3cdd2a27c4e21f', 'scriptPubKey': 'hex', 'ismine': False, 'iswatchonly': False, 'isscript': False, 'pubkey': '0x6cace0528324a8afc2b157ceba3cdd2a27c4e21f', 'iscompressed': False, 'timestamp': None}\n\n        address = await client.getnewaddress(passphrase='admin')\n        print(address)  # will print address like '0x137dd92be1d986eb3af023d0fb6fa8436c3ee5f8'\n\n    loop.run_until_complete(go())\n\n\n\nImplemented JSON-RPC methods\n----------------------------\n\n+-----------------+------------------+------------------+\n| Util            | Wallet           | Blockchain       |\n+=================+==================+==================+\n| validateaddress | getbalance       | getblockhash     |\n+-----------------+------------------+------------------+\n| estimatefee     | settxfee         | getdifficulty    |\n+-----------------+------------------+------------------+\n|                 | listaccounts     | getblockcount    |\n+-----------------+------------------+------------------+\n|                 | gettransaction   | getbestblockhash |\n+-----------------+------------------+------------------+\n|                 | sendfrom         | getblock         |\n+-----------------+------------------+------------------+\n|                 | sendtoaddress    |                  |\n+-----------------+------------------+------------------+\n|                 | walletlock       |                  |\n+-----------------+------------------+------------------+\n|                 | walletpassphrase |                  |\n+-----------------+------------------+------------------+\n|                 | getnewaddress    |                  |\n+-----------------+------------------+------------------+\n\n\nPlanned add more methods as soon as possible. Read help of some method first before use!\n\nSample of ethereum.conf\n-----------------------\n\n.. code:: bash\n\n    #\n    # ETHEREUMD-PROXY options (for controlling a running proxy process)\n    #\n\n    # Local server address for ethereumd-proxy RPC:\n    #ethpconnect=127.0.0.1\n\n    # Local server port for ethereumd-proxy RPC:\n    #ethpport=9500\n\n    #\n    # JSON-RPC options (for controlling a running ethereum process)\n    #\n\n    # You can use go-ethereum to send commands to ethereum\n    # running on another host using this option:\n    #rpcconnect=127.0.0.1\n\n    # Listen for RPC connections on this TCP port:\n    #rpcport=8545\n\n    # Listen for RPC connections on this unix/ipc socket:\n    #ipcconnect=~/.ethereum/geth/geth.ipc\n\n    #\n    # Signals options (for controlling a script management process)\n    #\n\n    # Execute command when a wallet transaction changes (%s in cmd is replaced by TxID)\n    #walletnotify=\n    # Execute command when the best block changes (%s in cmd is replaced by block hash)\n    #blocknotify=\n    # Execute command when a relevant alert is received (%s in cmd is replaced by message)\n    # TODO: add notification of long fork\n    #alertnotify=\n\nCopy it to your datadir folder or use direct path to it.\n\n\n.. |pypi| image:: https://badge.fury.io/py/ethereumd-proxy.svg\n    :target: https://badge.fury.io/py/ethereumd-proxy\n    :alt: Latest version released on PyPi\n\n.. |coverage| image:: https://codecov.io/gh/DeV1doR/ethereumd-proxy/branch/master/graph/badge.svg\n    :target: https://codecov.io/gh/DeV1doR/ethereumd-proxy\n    :alt: Test coverage\n\n.. |license| image:: https://img.shields.io/badge/license-MIT-blue.svg\n    :target: https://opensource.org/licenses/MIT\n    :alt: MIT License\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fm-bo-one%2Fethereumd-proxy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fm-bo-one%2Fethereumd-proxy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fm-bo-one%2Fethereumd-proxy/lists"}