Blockchain

Kaleido

Learn how to use Kaleido with Composio

Overview

SLUG: KALEIDO

Description

Kaleido is a full-stack platform for building and managing enterprise blockchain networks and applications.

Authentication Details

generic_api_key
stringRequired

Connecting to Kaleido

Create an auth config

Use the dashboard to create an auth config for the Kaleido toolkit. This allows you to connect multiple Kaleido accounts to Composio for agents to use.

1

Select App

Navigate to Kaleido.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Kaleido Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4kaleido_auth_config_id = "ac_YOUR_KALEIDO_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000"  # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10    # Replace this with a method to retrieve an API key from the user.
11    # Or supply your own.
12    user_api_key = input("[!] Enter API key")
13
14    connection_request = composio.connected_accounts.initiate(
15        user_id=user_id,
16        auth_config_id=auth_config_id,
17        config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18    )
19
20    # API Key authentication is immediate - no redirect needed
21    print(f"Successfully connected Kaleido for user {user_id}")
22    print(f"Connection status: {connection_request.status}")
23    
24    return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, kaleido_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Kaleido toolkit’s playground

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["KALEIDO"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17    completion = openai.chat.completions.create(
18        model="gpt-4o",
19        messages=[
20            {
21                "role": "user",
22                "content": task,  # Your task here!
23            },
24        ],
25        tools=tools,
26    )
27
28    # Handle Result from tool call
29    result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30    print(f"[!] Completion: {completion}")
31    print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Add Organization Identity Proof

Description

Tool to add an identity proof to an organization. Use when registering an x.509 certificate chain for an org immediately after creation.

Action Parameters

name
stringRequired
org_id
stringRequired
payload
stringRequired
type
stringDefaults to x509

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create API Key

Description

Tool to create a new API key for an organization. Use after confirming the org_id.

Action Parameters

name
string
org_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete API Key

Description

Tool to delete a specific API key. Use when you need to remove an API key by its identifier after confirming it's no longer in use.

Action Parameters

apikey_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get API Keys

Description

Tool to retrieve all API keys associated with the organization. Use when you need an overview of existing API keys after authenticating.

Action Parameters

Action Response

data
arrayRequired
error
string
successful
booleanRequired

Tool Name: Get App2App Runtimes

Description

Tool to retrieve App2App runtimes by listing all services and filtering where service == 'app2app'. Use after authenticating to enumerate App2App service instances.

Action Parameters

Action Response

data
arrayRequired
error
string
successful
booleanRequired

Tool Name: Get Application Credentials

Description

Tool to retrieve application credentials for a specific environment. Use when you need to list DApp credentials after environment setup.

Action Parameters

consortia_id
stringRequired
environment_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Consortia

Description

Tool to retrieve all consortia associated with the organization. Use after authenticating to view existing consortia.

Action Parameters

Action Response

data
arrayRequired
error
string
successful
booleanRequired

Tool Name: Get Event Streams

Description

Tool to list all event streams configured in the environment. Use when you need to retrieve current event stream setups.

Action Parameters

environment_id
string
full_url
string
node_id
string
zone_domain
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Memberships

Description

Tool to retrieve all memberships for the current user. Use after authenticating to list user memberships.

Action Parameters

query
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Organizations

Description

Tool to retrieve all organizations that the authenticated user has access to. Use after authenticating to list available organizations.

Action Parameters

Action Response

data
arrayRequired
error
string
successful
booleanRequired

Tool Name: Get Regions

Description

Tool to retrieve the list of deployment zones and endpoints. Use after authenticating to list available regions.

Action Parameters

Action Response

data
arrayRequired
error
string
successful
booleanRequired

Tool Name: Get Releases

Description

Tool to retrieve current and historical versions of node software. Use when you need to list all runtime releases available in the Kaleido platform.

Action Parameters

Action Response

data
arrayRequired
error
string
successful
booleanRequired

Tool Name: Get Roles

Description

Tool to retrieve all roles of an organization. Use when you need to audit or manage user roles after confirming a valid organization ID.

Action Parameters

org_id
stringRequired

Action Response

data
arrayRequired
error
string
successful
booleanRequired

Tool Name: Get Services

Description

Tool to retrieve all services the current user owns or can see. Use after authenticating to list available services.

Action Parameters

Action Response

data
arrayRequired
error
string
successful
booleanRequired

Tool Name: Get Token Factory Tokens

Description

Tool to retrieve all tokens managed by the Token Factory. Use after authenticating to list available tokens.

Action Parameters

Action Response

data
arrayRequired
error
string
successful
booleanRequired

Tool Name: Get Wallet Account Nonce

Description

Tool to retrieve the current nonce of a specific HD wallet account. Use before signing a transaction to determine the next transaction count.

Action Parameters

account_index
integerRequired
service_api_base_url
string
wallet_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Wallets

Description

Tool to retrieve HD wallet IDs hosted in the service. Use after creating or importing HD wallets to enumerate available wallets.

Action Parameters

service_api_base_url
string

Action Response

data
objectRequired
error
string
successful
booleanRequired