| Name | geodefi JSON |
| Version |
3.2.0
JSON |
| download |
| home_page | None |
| Summary | Python SDK for Geodefi Ecosystem |
| upload_time | 2024-08-23 16:27:19 |
| maintainer | None |
| docs_url | None |
| author | 0xIceBear |
| requires_python | <3.13,>=3.8 |
| license | None |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# geodefi
**geodefi** is a Python library for interacting with [geode.fi](https://www.geode.fi) smart contract infrastructure.
[geode.fi](https://www.geode.fi) an open source **Decentralized Infrastructure Provider** aiming to create a secure closed-environment for the wider Decentralized Finance landscape.
Currently providing a set of smart contracts which allows anyone to create their own Staking Pool on Ethereum.
Soon, much more.
Built on top of [web3.py](https://web3py.readthedocs.io/en/stable) Geodefi offers a comprehensive set of functions and utilities that simplify the process of interacting with the protocol's smart contract infrastructure.
Whether you're looking to query contract data or execute transactions, **geodefi** Python SDK has you covered! With a user-friendly and highly efficient interface, this SDK also provides cool features such as built-in cache, easy wallet management etc.
## Features
- Supports Ethereum Holesky testnet (as of v2.1.0) where The Protocol is deployed.
- Provides a simple and intuitive API for managing validators, operators, pools, tokens, and other smart contracts/packages.
- Dynamically adapts to the contract upgrades.
- Mostly chain agnostic. However, might differ according to the unique PoS implementations.
- Compatible with Python versions that are bigger than 3.8.
## Installation
```sh
pip install geodefi
```
## Documentation
Detailed documentation for this project is available on [Geodefi SDK Read The Docs](https://sdk.geode.fi).
### Sphinx
If your feature needs to have additional section in [Read The Docs](https://sdk.geode.fi). Please check the docs in your local computer first.
> built docs page is located in docs/_build/html/index.html.
You will need a sphinx server to render rst files:
#### **Build**
```bash
sphinx-build docs docs/_build/html
```
#### **Auto-build**
```bash
sphinx-autobuild docs docs/_build/html
```
## Contributing
We welcome contributions from the community! To contribute to this project, please follow these steps:
1. **Fork the Repository**: Click the "Fork" button at the top right corner of this repository to create your own copy.
2. **Clone the Repository**: Clone the forked repository to your local machine using the following command:
```bash
git clone https://github.com/<your_user_name>/geode-py.git
```
3. **Build from source**:
Take a look at the [Build](#building) section
4. **Create a Branch**: Create a new branch for your contribution:
```bash
git checkout -b feature/your-feature-name
```
5. **Stage Changes**: Stage your changes to be commited
```bash
git add <your-modified-files>
```
6. **Commit Changes**: Commit your changes with a descriptive commit message:
```bash
git commit -m "Add feature: your feature description"
```
7. **Push Changes**: Push your changes to your forked repository:
```bash
git push origin feature/your-feature-name
```
8. **Create a Pull Request**: Go to the original repository on GitHub and click on the "Pull Request" button. Fill out the necessary information and submit the pull request. Your pull request will be reviewed by the maintainers. Be ready to respond to any feedback or changes requested. You might need to make additional commits based on the feedback.
### Building
We do not recommend using `pip` and your *local* `python` installation.
Use `pipx` to manage your local packages, which in this case will be used to install pyenv.
Use `pyenv` to manage your python version.
Use `poetry` for dependency management and packaging.
#### Create virtual env
Simply do:
```bash
poetry shell
```
> This will create and activate a virtual environment.
If you want to set the python version from start you can also do:
```bash
poetry env use <python_version/3.9/3.9.19/etc>
```
This will output:
> Using virtualenv: <path_to_venv>
> copy <path_to_venv> and use it above to activate
```bash
source <path_to_venv>/bin/activate
```
#### Install deps
Install project dependencies with:
```bash
poetry install
```
## Release
Old method:
- Use main branch for releases.
- test with ``VERSION=1.0.0 python -m build`` if you want, then:
``` bash
git tag -a "v0.0.1-beta" -m "beta version testing"
git push --tags
```
New Method:
``` bash
poetry publish --build
```
## License
`geodefi` python sdk is licensed under MIT.
Raw data
{
"_id": null,
"home_page": null,
"name": "geodefi",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.8",
"maintainer_email": null,
"keywords": null,
"author": "0xIceBear",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/ef/7b/2b1317b7cdc323a238b701986c9a03dc50003874efd29797bbf9f6b3d102/geodefi-3.2.0.tar.gz",
"platform": null,
"description": "# geodefi\n\n**geodefi** is a Python library for interacting with [geode.fi](https://www.geode.fi) smart contract infrastructure.\n\n[geode.fi](https://www.geode.fi) an open source **Decentralized Infrastructure Provider** aiming to create a secure closed-environment for the wider Decentralized Finance landscape.\nCurrently providing a set of smart contracts which allows anyone to create their own Staking Pool on Ethereum.\nSoon, much more.\n\nBuilt on top of [web3.py](https://web3py.readthedocs.io/en/stable) Geodefi offers a comprehensive set of functions and utilities that simplify the process of interacting with the protocol's smart contract infrastructure.\n\nWhether you're looking to query contract data or execute transactions, **geodefi** Python SDK has you covered! With a user-friendly and highly efficient interface, this SDK also provides cool features such as built-in cache, easy wallet management etc.\n\n## Features\n\n- Supports Ethereum Holesky testnet (as of v2.1.0) where The Protocol is deployed.\n- Provides a simple and intuitive API for managing validators, operators, pools, tokens, and other smart contracts/packages.\n- Dynamically adapts to the contract upgrades.\n- Mostly chain agnostic. However, might differ according to the unique PoS implementations.\n- Compatible with Python versions that are bigger than 3.8.\n\n## Installation\n\n```sh\npip install geodefi\n```\n\n## Documentation\n\nDetailed documentation for this project is available on [Geodefi SDK Read The Docs](https://sdk.geode.fi).\n\n### Sphinx\n\nIf your feature needs to have additional section in [Read The Docs](https://sdk.geode.fi). Please check the docs in your local computer first.\n\n> built docs page is located in docs/_build/html/index.html.\n\nYou will need a sphinx server to render rst files:\n\n#### **Build**\n\n```bash\nsphinx-build docs docs/_build/html\n```\n\n#### **Auto-build**\n\n```bash\nsphinx-autobuild docs docs/_build/html\n```\n\n## Contributing\n\nWe welcome contributions from the community! To contribute to this project, please follow these steps:\n\n1. **Fork the Repository**: Click the \"Fork\" button at the top right corner of this repository to create your own copy.\n\n2. **Clone the Repository**: Clone the forked repository to your local machine using the following command:\n\n ```bash\n git clone https://github.com/<your_user_name>/geode-py.git\n ```\n\n3. **Build from source**:\n Take a look at the [Build](#building) section\n\n4. **Create a Branch**: Create a new branch for your contribution:\n\n ```bash\n git checkout -b feature/your-feature-name\n ```\n\n5. **Stage Changes**: Stage your changes to be commited\n\n ```bash\n git add <your-modified-files>\n ```\n\n6. **Commit Changes**: Commit your changes with a descriptive commit message:\n\n ```bash\n git commit -m \"Add feature: your feature description\"\n ```\n\n7. **Push Changes**: Push your changes to your forked repository:\n\n ```bash\n git push origin feature/your-feature-name\n ```\n\n8. **Create a Pull Request**: Go to the original repository on GitHub and click on the \"Pull Request\" button. Fill out the necessary information and submit the pull request. Your pull request will be reviewed by the maintainers. Be ready to respond to any feedback or changes requested. You might need to make additional commits based on the feedback.\n\n### Building\n\nWe do not recommend using `pip` and your *local* `python` installation.\n\nUse `pipx` to manage your local packages, which in this case will be used to install pyenv.\n\nUse `pyenv` to manage your python version.\n\nUse `poetry` for dependency management and packaging.\n\n#### Create virtual env\n\nSimply do:\n\n```bash\npoetry shell\n```\n\n> This will create and activate a virtual environment.\n\nIf you want to set the python version from start you can also do:\n\n```bash\npoetry env use <python_version/3.9/3.9.19/etc>\n```\n\nThis will output:\n\n> Using virtualenv: <path_to_venv>\n> copy <path_to_venv> and use it above to activate\n\n```bash\nsource <path_to_venv>/bin/activate\n```\n\n#### Install deps\n\nInstall project dependencies with:\n\n```bash\npoetry install\n```\n\n## Release\n\nOld method:\n\n- Use main branch for releases.\n- test with ``VERSION=1.0.0 python -m build`` if you want, then:\n\n``` bash\n git tag -a \"v0.0.1-beta\" -m \"beta version testing\"\n git push --tags\n```\n\nNew Method:\n\n``` bash\npoetry publish --build\n```\n\n## License\n\n`geodefi` python sdk is licensed under MIT.\n",
"bugtrack_url": null,
"license": null,
"summary": "Python SDK for Geodefi Ecosystem",
"version": "3.2.0",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "511d57cbba4b464a2f8d181cc31a4a4f1ffdfb50e3a2b4b389f8ff62bf444d9b",
"md5": "ec300b6b8dbfbb6f63e01a059f6be72c",
"sha256": "7f8a31fb8ff0330acabd65bdd90d7878abefe8317cdd378e30d494fe0651954d"
},
"downloads": -1,
"filename": "geodefi-3.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ec300b6b8dbfbb6f63e01a059f6be72c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.8",
"size": 256197,
"upload_time": "2024-08-23T16:27:17",
"upload_time_iso_8601": "2024-08-23T16:27:17.903849Z",
"url": "https://files.pythonhosted.org/packages/51/1d/57cbba4b464a2f8d181cc31a4a4f1ffdfb50e3a2b4b389f8ff62bf444d9b/geodefi-3.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ef7b2b1317b7cdc323a238b701986c9a03dc50003874efd29797bbf9f6b3d102",
"md5": "64367f830742139aba1a57ab2ef591f5",
"sha256": "687149cde79efbffbd19e6f4ec42dea25981c6369bb67c612031f6db190fd33f"
},
"downloads": -1,
"filename": "geodefi-3.2.0.tar.gz",
"has_sig": false,
"md5_digest": "64367f830742139aba1a57ab2ef591f5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.8",
"size": 245007,
"upload_time": "2024-08-23T16:27:19",
"upload_time_iso_8601": "2024-08-23T16:27:19.636175Z",
"url": "https://files.pythonhosted.org/packages/ef/7b/2b1317b7cdc323a238b701986c9a03dc50003874efd29797bbf9f6b3d102/geodefi-3.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-23 16:27:19",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "geodefi"
}
