Overview

Connect your application with Wavy Node to receive real-time compliance notifications and monitor on-chain activity.

Integrations connect your application with Wavy Node. By creating an integration, you can receive real-time notifications about your users’ on-chain activity and provide Wavy Node with the necessary data to monitor their wallets.

How it works

Your integration is a server that exposes two endpoints that Wavy Node calls:

1. GET /users/:userId — Wavy Node requests user data from your system for compliance checks.
2. POST /webhook — Wavy Node sends you real-time alerts when suspicious activity is detected.

All requests from Wavy Node are signed with HMAC-SHA256 so you can verify their authenticity.

Getting started

There are two ways to create a new integration:

Use the template

A ready-to-go Nitro application with all required endpoints and authentication already set up.

Build from scratch

Use any framework or language. Start by setting up authentication.

@wavynode/utils package

We provide an npm package with utilities to simplify the integration process:

npm install @wavynode/utils

This package includes the validateSignature function, which you need to authenticate requests from Wavy Node.

Next steps

Authentication

Learn how to verify requests from Wavy Node.

Endpoints

Implement the required endpoints for your integration.

API Reference

Explore the full API documentation.