{"id":24594439,"url":"https://github.com/den-is/adaops","last_synced_at":"2026-05-19T03:33:08.775Z","repository":{"id":272123636,"uuid":"390958954","full_name":"den-is/adaops","owner":"den-is","description":"Cardano CLI operations automation and augmentation functions library","archived":false,"fork":false,"pushed_at":"2025-02-16T17:33:20.000Z","size":176,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-16T18:30:28.198Z","etag":null,"topics":["ada","blockchain","cardano","cardano-cli","cardano-node","crypto","cryptocurrency","operations","python","python3"],"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/den-is.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-07-30T06:37:11.000Z","updated_at":"2025-02-16T17:33:12.000Z","dependencies_parsed_at":null,"dependency_job_id":"70453797-0fd1-40cd-b79e-cd26b7ede139","html_url":"https://github.com/den-is/adaops","commit_stats":null,"previous_names":["den-is/adaops"],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/den-is%2Fadaops","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/den-is%2Fadaops/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/den-is%2Fadaops/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/den-is%2Fadaops/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/den-is","download_url":"https://codeload.github.com/den-is/adaops/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244155890,"owners_count":20407434,"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":["ada","blockchain","cardano","cardano-cli","cardano-node","crypto","cryptocurrency","operations","python","python3"],"created_at":"2025-01-24T11:14:46.002Z","updated_at":"2026-05-19T03:33:03.747Z","avatar_url":"https://github.com/den-is.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# adaops - Cardano CLI operations automation\n\nPython library to help automate various cardano operations using Python.  \nMainly it is wrapper around **cardano-cli** and bunch of helpful methods.\n\n:warning::hammer_and_wrench: **Under development. Fasten seat belt and wear helmet!** :construction_worker:\n\n- This is work in progress. Depends on my mood, motivation and available free time\n- contributions and suggestions are welcome\n- provided example scripts are primitive, real scripts should consist of many checks and circuit-breakers\n- while this library seems to be primitive\n  - it works for me\n  - it worked in quite complex scenarios, for various projects and APIs built on top of it\n  - library does not cover every command and scenario possible with cardano-cli\n  - features were added when some specific scenario needed them\n  - features are not re-tested and might be broken, not updated, since I've never returned to them again after initial implementation and usage\n\n## Requirements\n\n- **cardano-cli** - binary should be discoverable in the `$PATH`\n- **v10.1.1.0** - is a minimum supported version of cardano-cli\n- **CARDANO_NODE_SOCKET_PATH** - Required for online operations. Env variable should be declared and pointing to existing socker of running cardano-node process.\n- Python 3.10+\n\n## Installation\n\nInstall Python any method which is suitable for you.  \nUsing isolated Python environment, rather than system's Python is strongly recommended.  \nShort list of installation options:\n\n- `brew install python` or alternative package manager for your OS, e.g. apt, apk, dnf, yum, ...\n- Alternative: [pyenv](https://github.com/pyenv/pyenv), [uv](https://github.com/astral-sh/uv), [docker](https://hub.docker.com/_/python), [virtualenv](https://virtualenv.pypa.io/en/stable/) + optional [virtualenvwrapper](https://virtualenvwrapper.readthedocs.io/en/stable/), built-in [venv](https://docs.python.org/3/library/venv.html) module\n\nIn almost all cases library should have access to an active `CARDANO_NODE_SOCKET_PATH`.\nThat being said, healthy `cardano-node` should be running on the same machine as `adaops` lib.\nOtherwise cardano-node socket should be mounted/forwarded into the environment were code will be executed.\n\n```sh\ncd ~\n\nmkdir -p ~/workspace\ncd ~/workspace\n\n# Create Python Virtual environment\npython3 -m venv venv\n\n# Activate just created Virtual environment\nsource venv/bin/activate\n\n# Get latest source code\ngit clone https://github.com/den-is/adaops.git\n\n# Change directory to just cloned directory\ncd adaops\n\n# Install library in the venv\npip install -e .\n```\n\n## Configuration\n\nAdd `.env` file in the root of your project\n\n| ENV                      | Default Value | Description |\n| ------------------------ | ------------- | ------------|\n| ADAOPS_CARDANO_CLI       | \"cardano-cli\" | Path to \"cardano-cli\" either found in $PATH or full path to binary\n| CARDANO_NODE_NETWORK_ID  | \"mainnet\"     | Cardano network to operate on. Possible values: \"mainnet\", \"preprod\", \"preview\"\n| CARDANO_NODE_SOCKET_PATH |               | Required. Path to running cardano-node unix socket\n| CARDANO_ERA              | \"conway\"      | Required.\n\n## Example usage\n\n```py\nfrom adaops.var import get_current_tip\ntip = get_current_tip()\nprint(tip)\n# 36019091\n```\n\nYou can support my work by sending some ADA:\n\n- `addr1q8qg398j8cyh9k8qf02yhy90t0sdm55q0rhttxfwgve68sgxfhqka2l369tk03nyynll9fqs59dq09njtk7nntkkcasqps24wl`\n\nProvided by [SOUL Cardano Staking pool](https://pooltool.io/pool/3866bed6c94a75ab0290bc86d83467c6557cf2275e8d49b3d727c78c)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fden-is%2Fadaops","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fden-is%2Fadaops","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fden-is%2Fadaops/lists"}