Home

Bitcoin Lightning CLINK Plugin for Vendure

Accept Bitcoin Lightning payments in your Vendure store via the CLINK protocol — Nostr-native static payment codes.

Features

• CLINK Protocol: Nostr-native payment codes (noffer format)
• BTC Price Oracle: Real-time conversion via CoinGecko, Kraken, or custom providers
• Per-Channel Config: Separate Nostr keys and relays per channel
• HTTP Webhook Fallback: For wallets without Nostr support
• Storefront Component: React component with relay info display

Quick Start

npm install vendure-plugin-bitcoin-lightning-via-clink

import { ClinkPlugin } from 'vendure-plugin-bitcoin-lightning-via-clink';

export const config = {
  plugins: [
    ClinkPlugin.init({
      relays: ['wss://relay.damus.io'],
      webhookSecret: 'your-secure-random-hex',
      network: 'mainnet',
      oracle: {
        provider: 'coingecko',
        cacheTtlMs: 60000,
        fallbackProviders: ['kraken'],
      },
    }),
  ],
};

Note: webhookSecret is required when using the HTTP webhook fallback. Generate with: openssl rand -hex 32

Documentation

• Installation
• Configuration
• Merchant Guide
• Customer Guide
• API Reference

Links

• GitHub Repository
• npm Package
• CLINK Protocol

Conversations

• In this repo: https://github.com/WoompaLoompa/vendure-clink/discussions
• In Vendure GH forum: https://github.com/vendurehq/vendure/discussions/5019
• In Vendure Discord: https://discord.com/channels/1100672177260478564/1529747875364474921