Skip to content

[KLC-2170/KLC-2171] Add on-chain tools for Klever blockchain interaction #28

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
nickgs1337 merged 7 commits into from
Feb 19, 2026
Merged

[KLC-2170/KLC-2171] Add on-chain tools for Klever blockchain interaction #28

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
c65f420
feat: add on-chain tools for Klever blockchain interaction
fbsobreira Feb 15, 2026
af4c014
fix: update klever-sc crate version from 0.44.0 to 0.45.0 in knowledg…
fbsobreira Feb 15, 2026
45b1e6b
fix: validate network parameter in chain tool handlers
fbsobreira Feb 15, 2026
7e8c1a3
fix: address PR review feedback for on-chain tools
fbsobreira Feb 15, 2026
af25cef
fix: address second round of PR review feedback
fbsobreira Feb 15, 2026
cbe52e2
fix: address reviewer feedback from nickgs1337 and RomuloSiebra
fbsobreira Feb 16, 2026
98e2316
fix: add wasmPath safety guards and fix getTransaction doc comment
fbsobreira Feb 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,10 @@ The MCP server (`src/mcp/server.ts`) exposes: `query_context`, `add_context`, `g
2. Update relevance scoring in `ContextService.calculateRelevanceScore()`
3. Update MCP tool input schemas in `src/mcp/server.ts` (the enum arrays in `query_context` and `add_context`)

### Chain Client

`src/chain/` provides a zero-dependency HTTP client for querying the Klever blockchain (uses native `fetch`). `KleverChainClient` supports mainnet/testnet/devnet/local with per-call network override. The MCP server creates a chain client at startup (configured via env vars) and passes it to `KleverMCPServer`. On-chain tools (get_balance, get_account, get_asset_info, query_sc, get_transaction, get_block, list_validators) are available in all profiles. Write tools (send_transfer, deploy_sc, invoke_sc, freeze_klv) are local-only.

## Environment Variables

- `MODE`: `http` (default) or `mcp`
Expand All @@ -69,6 +73,10 @@ The MCP server (`src/mcp/server.ts`) exposes: `query_context`, `add_context`, `g
- `REDIS_URL`: Redis connection string (only for redis storage)
- `MEMORY_MAX_SIZE`: Max contexts in memory storage (default: 10000)
- `NODE_ENV`: `development` or `production` (affects error detail in responses)
- `KLEVER_NETWORK`: Default chain network: `mainnet` (default), `testnet`, `devnet`, `local`
- `KLEVER_NODE_URL`: Custom node URL (overrides network-based URL)
- `KLEVER_API_URL`: Custom API proxy URL (overrides network-based URL)
- `KLEVER_TIMEOUT`: Chain client request timeout in ms (default: 15000)

## Branching & Release Process

Expand Down
Loading