coincap-hedera-agent-kit-plugin 0.1__tar.gz

coincap_hedera_agent_kit_plugin-0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Henry Tong
+
+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.

coincap_hedera_agent_kit_plugin-0.1/PKG-INFO

@@ -0,0 +1,18 @@
+Metadata-Version: 2.4
+Name: coincap-hedera-agent-kit-plugin
+Version: 0.1
+Home-page: https://github.com/henrytongv/coincap-hedera-plugin-py
+Author: Henry Tong
+Author-email: taksantong@gmail.com
+License: MIT
+Keywords: hedera agent-kit coincap web3
+License-File: LICENSE
+Requires-Dist: hedera-agent-kit
+Requires-Dist: requests
+Dynamic: author
+Dynamic: author-email
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist

coincap_hedera_agent_kit_plugin-0.1/README.md

@@ -0,0 +1,71 @@
+# Hedera Agent Kit - CoinCap Plugin Python version
+
+A plugin for [Hedera Agent Kit PY](https://github.com/hashgraph/hedera-agent-kit-py) that provides integration with the CoinCap API
+
+In this plugin we use CoinCap to get the current price in USD of one HBAR and combine it with the power of the Hedera Agent Kit to get your current balance of HBA in USD currency.
+
+## Overview
+
+This plugin enables `AI agents` to interact with the CoinCap API
+
+## Installation in the example index.js agent
+
+1.- Install the plugin
+
+```bash
+pip install coincap-hedera-plugin-py
+```
+
+2.- Add your CoinCap API Bearer token in the .env file ( You get it in the CoinCap website )
+
+```
+# Coincap API needed by coincap-hedera-plugin
+COINCAP_BEARER_TOKEN=******************************
+```
+
+3.- Import the plugin code in your index.js (Hedera Agent)
+
+```js
+// CoinCap plugin to connect to CoinCap API
+import { CoinCapHederalugin } from 'coincap-hedera-plugin/plugin.js';
+```
+
+4.- Add the query and account plugins from core Hedera Agent code, and, this new plugin, in the tools secion of the agent
+
+```js
+const hederaAgentToolkit = new HederaLangchainToolkit({
+client,
+configuration: {
+    tools: [],
+    plugins: [coreQueriesPlugin, coreAccountPlugin, CoinCapHederalugin], // <---- Add these
+```
+
+5.- Use a prompt to ask for you current balance and tell the agent to want it in USD currency, for example like this:
+
+```js
+const response = await agent.invoke(
+{ messages: [{ role: 'user', content: "Get my balance in HBAR and give it to me converted to USD currency" }] },
+{ configurable: { thread_id: '1' } }
+);
+```
+
+6.- Now you can run the example agent and you should get your current HBAR balance converted to USD currency
+
+```bash
+node index.js
+```
+
+## Tools
+
+```js
+// Use the CoinCap API to get the current price in USD of one HBAR
+function getHBARPriceInUSD()
+```
+
+## How to publish the PyPi package
+1.- Read the [instructions](https://towardsdatascience.com/how-to-upload-your-python-package-to-pypi-de1b363a1b3/)
+
+1.- Create the distribution package
+```bash
+python setup.py sdist
+```

coincap_hedera_agent_kit_plugin-0.1/setup.cfg

@@ -0,0 +1,8 @@
+[metadata]
+description_file = README.md
+license_files = LICENSE
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

coincap_hedera_agent_kit_plugin-0.1/setup.py

@@ -0,0 +1,18 @@
+from setuptools import setup, find_packages
+
+setup(
+    name='coincap-hedera-agent-kit-plugin',
+    version='0.1',
+    license='MIT',
+    author="Henry Tong",
+    author_email='taksantong@gmail.com',
+    packages=find_packages('src'),
+    package_dir={'': 'src'},
+    url='https://github.com/henrytongv/coincap-hedera-plugin-py',
+    keywords='hedera agent-kit coincap web3',
+    install_requires=[
+          'hedera-agent-kit',
+          'requests',
+      ],
+
+)

coincap_hedera_agent_kit_plugin-0.1/src/coincap_hedera_agent_kit_plugin.egg-info/PKG-INFO

@@ -0,0 +1,18 @@
+Metadata-Version: 2.4
+Name: coincap-hedera-agent-kit-plugin
+Version: 0.1
+Home-page: https://github.com/henrytongv/coincap-hedera-plugin-py
+Author: Henry Tong
+Author-email: taksantong@gmail.com
+License: MIT
+Keywords: hedera agent-kit coincap web3
+License-File: LICENSE
+Requires-Dist: hedera-agent-kit
+Requires-Dist: requests
+Dynamic: author
+Dynamic: author-email
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist

coincap_hedera_agent_kit_plugin-0.1/src/coincap_hedera_agent_kit_plugin.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+setup.cfg
+setup.py
+src/coincap_hedera_agent_kit_plugin.egg-info/PKG-INFO
+src/coincap_hedera_agent_kit_plugin.egg-info/SOURCES.txt
+src/coincap_hedera_agent_kit_plugin.egg-info/dependency_links.txt
+src/coincap_hedera_agent_kit_plugin.egg-info/requires.txt
+src/coincap_hedera_agent_kit_plugin.egg-info/top_level.txt
+src/coincap_hedera_plugin/__init__.py
+src/coincap_hedera_plugin/coincap_plugin/__init__.py
+src/coincap_hedera_plugin/coincap_plugin/plugin.py
+src/coincap_hedera_plugin/coincap_plugin/tool.py

coincap_hedera_agent_kit_plugin-0.1/src/coincap_hedera_agent_kit_plugin.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

coincap_hedera_agent_kit_plugin-0.1/src/coincap_hedera_agent_kit_plugin.egg-info/requires.txt

@@ -0,0 +1,2 @@
+hedera-agent-kit
+requests

coincap_hedera_agent_kit_plugin-0.1/src/coincap_hedera_agent_kit_plugin.egg-info/top_level.txt

@@ -0,0 +1 @@
+coincap_hedera_plugin

coincap_hedera_agent_kit_plugin-0.1/src/coincap_hedera_plugin/__init__.py

@@ -0,0 +1,9 @@
+__all__ = [
+    "conincap_h_plugin",
+    "conincap_h_plugin_tool_names",
+]
+
+from coincap_plugin import (
+    conincap_h_plugin,
+    conincap_h_plugin_tool_names,
+)

coincap_hedera_agent_kit_plugin-0.1/src/coincap_hedera_plugin/coincap_plugin/__init__.py

@@ -0,0 +1,20 @@
+from .plugin import GetHbarInUsdTool, GET_HBAR_IN_USD_TOOL
+from hedera_agent_kit.shared.plugin import Plugin
+
+conincap_h_plugin = Plugin(
+    name="get_hbar_price_in_usd-query-plugin",
+    version="1.0.0",
+    description="A plugin to get the price of HBAR in USD",
+    tools=lambda context: [
+        GetHbarInUsdTool(context),
+    ],
+)
+
+conincap_h_plugin_tool_names = {
+    "GET_HBAR_IN_USD_TOOL": GET_HBAR_IN_USD_TOOL,
+}
+
+__all__ = [
+    "GetHbarInUsdTool",
+    "conincap_h_plugin_tool_names",
+]

coincap_hedera_agent_kit_plugin-0.1/src/coincap_hedera_plugin/coincap_plugin/plugin.py

@@ -0,0 +1,102 @@
+from __future__ import annotations
+
+from hiero_sdk_python import Client
+
+from hedera_agent_kit.shared.configuration import Context
+from hedera_agent_kit.shared.models import ToolResponse
+from hedera_agent_kit.shared.parameter_schemas import AccountQueryParameters
+from hedera_agent_kit.shared.tool import Tool
+from hedera_agent_kit.shared.utils.default_tool_output_parsing import (
+    untyped_query_output_parser,
+)
+from hedera_agent_kit.shared.utils.prompt_generator import PromptGenerator
+
+from tool import get_hbar_price_from_coincap
+
+def get_hbar_price_in_usd_prompt(context: Context = {}) -> str:
+    """Generate a human-readable description of the get hbar price in usd query tool.
+
+    Args:
+        context: Optional contextual configuration that may influence the prompt.
+
+    Returns:
+        A string describing the tool, its parameters, and usage instructions.
+    """
+    context_snippet: str = PromptGenerator.get_context_snippet(context)
+    usage_instructions: str = PromptGenerator.get_parameter_usage_instructions()
+
+    return f"""
+{context_snippet}
+
+This tool will return the current price in USD of HBAR
+
+Parameters:
+- account_id (str, required): The account ID to query
+{usage_instructions}
+"""
+
+async def get_hbar_price_in_usd_query(
+    client: Client,
+    context: Context,
+    params: AccountQueryParameters,
+) -> ToolResponse:
+    """Execute a get hbar price in usd request to coincap API.
+
+    Args:
+        client: Hedera client used to determine the network.
+        context: Runtime context providing configuration and defaults.
+
+    Returns:
+        The current price in USD for HBAR
+
+    Notes:
+        This function captures exceptions and returns a failure ToolResponse
+        rather than raising, to keep tool behavior consistent for callers.
+    """
+    try:
+        current_price_of_hbar_in_usd = get_hbar_price_from_coincap()
+        print(f"coincap said that the price in USD of one HBAR is {current_price_of_hbar_in_usd}")
+        return ToolResponse(
+            human_message=str(current_price_of_hbar_in_usd),
+        )
+    except Exception as e:
+        message: str = f"Failed to get hbar price in usd: {str(e)}"
+        print("[get_hbar_price_in_usd_tool]", message)
+        return ToolResponse(
+            human_message=message,
+            error=message,
+        )
+
+
+GET_HBAR_IN_USD_TOOL: str = "get_hbar_price_in_usd_tool"
+
+
+class GetHbarInUsdTool(Tool):
+    """Tool wrapper that exposes the get hbar price in usd capability to the Agent runtime."""
+
+    def __init__(self, context: Context):
+        """Initialize the tool metadata and parameter specification.
+
+        Args:
+            context: Runtime context used to tailor the tool description.
+        """
+        self.method: str = GET_HBAR_IN_USD_TOOL
+        self.name: str = "get hbar price in usd"
+        self.description: str = get_hbar_price_in_usd_prompt(context)
+        self.parameters: type[AccountQueryParameters] = AccountQueryParameters
+        self.outputParser = untyped_query_output_parser
+
+    async def execute(
+        self, client: Client, context: Context, params: AccountQueryParameters
+    ) -> ToolResponse:
+        """Execute the get hbar price in usd using the provided client, context, and params.
+
+        Args:
+            client: Hedera client used to determine the network.
+            context: Runtime context providing configuration and defaults.
+
+        Returns:
+            The result of the get hbar price in usd as a ToolResponse, including a human-readable
+            message and error information if applicable.
+        """
+        return await get_hbar_price_in_usd_query(client, context, params)

coincap_hedera_agent_kit_plugin-0.1/src/coincap_hedera_plugin/coincap_plugin/tool.py

@@ -0,0 +1,23 @@
+import requests
+import os
+
+def get_hbar_price_from_coincap():
+    headers = {
+        "Authorization": f"Bearer {os.getenv("BEARER_TOKEN")}"
+    }
+
+    # Send GET request
+    response = requests.get("https://rest.coincap.io/v3/price/bysymbol/hbar", headers=headers)
+    
+    # Raise an error if the request failed (4xx / 5xx)
+    response.raise_for_status()
+    
+    # Parse JSON response
+    json_data = response.json()
+    
+    # Get the first element from the "data" array and convert it to float
+    first_value = float(json_data["data"][0])
+
+    print(f"* got this value from coincap api {first_value}")
+    
+    return first_value