KeeperHub / KeeperHub/keeperhub
Onboarding teardown: 7 DX gaps blocking first-time agent integrations (hackathon build)
- 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
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