Przejdź do treści
Biblioteka skilli
Programowanie · Integracja z narzędziem

hifi-webhooks

/hifi-webhooks

Odbiera i weryfikuje webhooki HIFI z podpisem hifi-signature, obsługując zdarzenia onramp, nowego użytkownika i transferu kryptowalut.

Repozytorium
webhook-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
25
Skrypty
8
Komentarze HTML
0
Adresy URL w SKILL.md
12
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 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

  1. When to Use This Skill
  2. Setup
  3. Verification (core)
  4. Event Handling
  5. Local Development
  6. Resources
  7. Recommended: webhook-handler-patterns
  8. Related Skills
Sekcje z nagłówków SKILL.md, w oryginale · 68 linii, 362 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.