DocsLLM Skill: Kvasyr API

LLM Skill: Kvasyr API

Kvasyr ships a reusable skill in this repository at:

  • skills/kvasyr-api

The skill translates natural-language requests into valid Kvasyr API calls for:

  • subscription creation and management,
  • webhook verify/test flows,
  • event and delivery reads,
  • backfill requests.

It defaults to Kvasyr Cloud (app.kvasyr.com) when no domain is specified, and supports self-hosted domains when one is provided.

Install (Codex)

Symlink the skill folder into your Codex skill directory:

mkdir -p ~/.codex/skills
ln -s /absolute/path/to/kvasyr/skills/kvasyr-api ~/.codex/skills/kvasyr-api

If the link already exists and you want to replace it:

ln -sfn /absolute/path/to/kvasyr/skills/kvasyr-api ~/.codex/skills/kvasyr-api

Use

Invoke the skill by name and provide API intent details.

SaaS example:

Use $kvasyr-api.
Make me a Kvasyr subscription for contract 0xYourContract on chain 8453
for events Transfer(address,address,uint256), Approval(address,address,uint256),
and topic T1 0x0000000000000000000000001111111111111111111111111111111111111111,
using API key kva_..., with webhook URL https://example.com/kvasyr/webhook.

Self-host example:

Use $kvasyr-api against https://kvasyr.example.com.
Create subscriptions for contract 0xYourContract on chain 8453 for events
Transfer(address,address,uint256) and Mint(address,uint256), using API key kva_....

Behavior Notes

  • One subscription is created per event_signature.
  • Topic aliases map as T1 -> topic1_in, T2 -> topic2_in, T3 -> topic3_in.
  • /v1/* is used as canonical API paths.
  • Idempotency-Key is added on create/backfill calls for safe retries.

LLMs Without Native Skill Loading

If your assistant does not support skill folders, provide it with:

  • skills/kvasyr-api/SKILL.md
  • skills/kvasyr-api/references/v1-endpoints.md
  • skills/kvasyr-api/references/payload-recipes.md

and ask it to follow those instructions while generating Kvasyr API calls.

Related

Managing Account and CreditsChains