hifi-webhooks
/hifi-webhooks
Odbiera i weryfikuje webhooki HIFI z podpisem hifi-signature, obsługując zdarzenia onramp, nowego użytkownika i transferu kryptowalut.
- Autor
- hookdeck ↗
- Repozytorium
- webhook-skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 13.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 25
- Skrypty
- 8
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 12
Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 8 skryptów w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: examples/express/src/index.js, examples/express/test/webhook.test.js, examples/fastapi/main.py, examples/fastapi/test_webhook.py, examples/nextjs/app/lib/webhook.ts, examples/nextjs/app/webhooks/hifi/route.ts, examples/nextjs/test/webhook.test.ts, examples/nextjs/vitest.config.ts
Co robi i kiedy
Odbiera i weryfikuje webhooki HIFI z podpisem hifi-signature, obsługując zdarzenia onramp, nowego użytkownika i transferu kryptowalut.
Oryginalny opis (EN)
Receive and verify HIFI webhooks. Use when configuring HIFI webhook endpoints, debugging hifi-signature signatures, or handling ONRAMP.STATUS.COMPLETED, USER.CREATED, CRYPTO_TRANSFER.CREATED.
Jak działa
- When to Use This Skill
- Setup
- Verification (core)
- Event Handling
- Local Development
- Resources
- Recommended: webhook-handler-patterns
- Related Skills
Podgląd SKILL.md
---
name: hifi-webhooks
description: >
Receive and verify HIFI webhooks. Use when configuring HIFI webhook
endpoints, debugging hifi-signature signatures, or handling ONRAMP.STATUS.COMPLETED, USER.CREATED, CRYPTO_TRANSFER.CREATED.
license: MIT
metadata:
author: hookdeck
version: "0.1.0"
repository: https://github.com/hookdeck/webhook-skills
---
# HIFI Webhooks
Receive HIFI user, compliance and money-movement events.
## When to Use This Skill
- Configure a receiver for HIFI webhook deliveries.
- Diagnose `hifi-signature` verification failures.
- Handle `ONRAMP.STATUS.COMPLETED`, `USER.CREATED`, `CRYPTO_TRANSFER.CREATED`.
## Setup
Register an endpoint with the HIFI Webhooks API, set its subscriptions, and store the signingSecret returned at registration. It is shown only once. To replace the secret, delete and register the endpoint again.
Set `HIFI_WEBHOOK_SECRET` in the server environment. Read [setup](references/setup.md) before enabling delivery.
## Verification (core)
`hifi-signature` contains `t=<Unix seconds>,v1=<hex>` over `timestamp + "." + raw body`. Use HMAC-SHA256 with the secret's UTF-8 bytes. Verify the original bytes before parsing JSON. Validate the digest format, then compare equal-length buffers in constant time.
After extracting the documented digest and constructing `message` as described in [verification](references/verification.md), the comparison is:
```javascript
const expected = crypto.createHmac('sha256', secret).update(message).digest();
if (digest.length !== 64 || !/^[0-9a-fA-F]{64}$/.test(digest)) return false;
const received = Buffer.from(digest, 'hex');
return received.length === expected.length && crypto.timingSafeEqual(received, expected);
```
Set `HIFI_WEBHOOK_TOLERANCE_SECONDS` to a positive number to enforce an application age limit in seconds. Unset or `0` disables it. Old timestamps remain valid by default so Hookdeck retries and replays can retain the original headers.
Complete handlers and tests: [Express](examples/express/), [Next.js](examples/nextjs/), [FastAPI](examples/fastapi/).
## Event Handling
The envelope contains id, eventType, eventCreatedAt and data. Use eventType for dispatch; data is the resource state. RESOURCE.CREATED and RESOURCE.STATUS.CREATED are distinct notifications.
Return 2xx promptly. HIFI retries failed deliveries with exponential backoff for up to 10 attempts. Deliveries may arrive out of order; reconcile the resource state before applying a change.
## Local Development
```bash
npx hookdeck-cli listen 3000 hifi --path /webhooks/hifi
```
Use port 8000 for FastAPI. The CLI provides a local tunnel and inspection UI; no account is required to start.
## Resources
- [Overview and event routing](references/overview.md)
- [Endpoint and secret setup](references/setup.md)
- [Verification and troubleshooting](references/verification.md)
## Recommended: webhook-handler-patterns
Use the patterns skill for [handler sequence](https://github.com/hookdeck/webhook-skills/blob/main/skills/webhook-handler-patterns/references/handler-sequence.md), [idempotency](https://github.com/hookdeck/webhook-skills/blob/main/skills/webhook-handler-patterns/references/idempotency.md), [error handling](https://github.com/hookdeck/webhook-skills/blob/main/skills/webhook-handler-patterns/references/error-handling.md) and [retry logic](https://github.com/hookdeck/webhook-skills/blob/main/skills/webhook-handler-patterns/references/retry-logic.md).
## Related Skills
- [stripe-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/stripe-webhooks): another HMAC receiver.
- [github-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/github-webhooks): another HMAC receiver.
- [shopify-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/shopify-webhooks): another HMAC receiver.
- [gitbook-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/gitbook-webhooks): another HMAC receiver.
- [preczn-webhooks](https://github.com/hookdeck/webhook-skills/tree/main/skills/preczn-webhooks): another HMAC receiver.
- [webhook-handler-patterns](https://github.com/hookdeck/webhook-skills/tree/main/skills/webhook-handler-patterns): delivery and processing patterns.
- [hookdeck-event-gateway](https://github.com/hookdeck/webhook-skills/tree/main/skills/hookdeck-event-gateway): managed delivery and inspection.
Pliki w paczce (25)
- SKILL.md 4 KB
- examples/express/.env.example 1 KB
- examples/express/README.md 2 KB
- examples/express/package.json 1 KB
- examples/express/vector.json 1 KB
- examples/express/src/index.js 3 KB
- examples/express/test/webhook.test.js 6 KB
- examples/fastapi/.env.example 1 KB
- examples/fastapi/README.md 2 KB
- examples/fastapi/main.py 3 KB
- examples/fastapi/requirements.txt 1 KB
- examples/fastapi/test_webhook.py 6 KB
- examples/fastapi/vector.json 1 KB
- examples/nextjs/.env.example 1 KB
- examples/nextjs/README.md 2 KB
- examples/nextjs/package.json 1 KB
- examples/nextjs/tsconfig.json 1 KB
- examples/nextjs/vector.json 1 KB
- examples/nextjs/vitest.config.ts 1 KB
- examples/nextjs/app/lib/webhook.ts 2 KB
- examples/nextjs/app/webhooks/hifi/route.ts 1 KB
- examples/nextjs/test/webhook.test.ts 6 KB
- references/overview.md 1 KB
- references/setup.md 1 KB
- references/verification.md 2 KB
Wersje
W bazie nie ma innych skilli o nazwie hifi-webhooks.
Migawka bazy z 13.11.2026 · wersja paczki 0e3d95701882 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100authgear-webhooks
Odbiera i weryfikuje webhooki Authgear, sprawdza podpisy i obsługuje zdarzenia użytkowników. - 100vivenu-webhooks
Odbiera i weryfikuje webhooki vivenu, sprawdza podpis x-vivenu-signature i obsługuje zdarzenia transakcji, biletów i zakupów.