KeeperHub / KeeperHub/keeperhub

Onboarding teardown: 7 DX gaps blocking first-time agent integrations (hackathon build)

Open
#1,869 4 comments 0 reactions 0 assignees View on GitHub
accepted confirmed
Dominant language
TypeScript
Stars
24
Forks
93
Avg merge
1d 4h
Merged PRs (30d)
253

Description

Filed while building a first-time integration (no prior KeeperHub exposure) for the Agents Onchain Hackathon. Full detail: https://github.com/subheeksh5599/keepersense/blob/master/docs/ONBOARDING-TEARDOWN.md

1. **Base URL ambiguity** — docs show `https://app.keeperhub.com/api/workflows/...` while routes are documented as `/api/workflows`; setting base to `.../api` + path `/api/workflows` hits `/api/api/workflows` with no hint.
2. **No REST template search** — only MCP `search_templates` / CLI `kh template list`; `GET /api/workflows/public` is the closest REST surface.
3. **Strict EIP-55 recipient validation, misleading error** — the docs' own example recipient is rejected as "Invalid recipient address"; correctly-checksummed variants also rejected; only `0x…dEaD` passed. Error can't distinguish checksum vs allowlist failure.
4. **Address book is dashboard-only** — no API to add/label recipients; agents can't register recipients programmatically.
5. **No wallet info in REST** — wallet address only in dashboard; got it via MCP `list_integrations` only.
6. **`inputSchema` is `null` on workflows** — inputs live in node `data.config`; agents can't introspect required inputs from the schema.
7. **No testnet faucet API** — external faucets only; `kh wallet fund` prints a Coinbase Onramp URL.

Proposed fixes in the full doc (incl. effort/impact table). Happy to turn any of these into a PR.

Contributor guide

Open the contributing guide

Research direction

Read docs/ONBOARDING-TEARDOWN.md first to understand the seven reported integration gaps and their proposed effort/impact. Treat the listed REST, CLI, MCP, wallet, recipient-validation, workflow-schema, and faucet behaviors as the acceptance scope; done means the selected gaps have documented or implemented fixes with clear agent-facing behavior.

Written by the indexing model from the issue text.

Assessment

Tech stack
blockchain, typescript
Domain
api, blockchain, cli, developer-experience
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.