Sending instant Bitcoin payments with Supabase

​

Prerequisites

To complete this guide, you will need the following:

• ZBD Project with a Live API key
• Supabase account + Supabase CLI installed

​

1. Create a Supabase Function

To create a Supabase Edge Function you must run the following command locally:

supabase functions new zbd-send

This will create a /supabase/functions/zbd-send folder structure in your project.

​

2. Write the Edge Function

Use the code below as a starting point for your handler function. You will need to replace the ZBD_API_KEY with your own ZBD Project’s API key.

import { serve } from "https://deno.land/std@0.168.0/http/server.ts"

const ZBD_API_KEY = "b7Ya3s2JZKZcXXX2Dqf8wjKTZZZRuWr8";

const zbdSend = async (_request: Request): Promise<Response> => {
  const res = await fetch("https://api.zebedee.io/v0/ln-address/send-payment", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "apikey": `${ZBD_API_KEY}`,
    },
    body: JSON.stringify({
      lnAddress: 'andre@zbd.gg', // Who is the recipient of the payment?
      amount: '100000', // 100 satoshis (100,000 msats) -- ~$0.03
      comment: 'Money at internet speed', // What is this payment for?
    }),
  });

  const data = await res.json();

  return new Response(JSON.stringify(data), {
    status: 200,
    headers: {
      "Content-Type": "application/json",
    },
  });
};

serve(zbdSend);

​

3. Send payment locally

To run this Supabase Edge Function locally you can spin up your Supabase instance using the following command. You may already have this running at this stage.

supabase functions start

Then you can run the following command to start your serverless function:

supabase functions serve zbd-send --no-verify-jwt

Note that we add the --no-verify-jwt flag to the command to disable JWT verification. This is because we are not passing a JWT token to the function when we call it. This is not recommended for production use.

Supabase CLI will output a HTTP URL endpoint that you can use to test your function by issuing a POST request to that resource.

​

4. Deploying to Supabase Edge

After testing it locally, you can deploy your function to Supabase Edge using the following command. You will need to enter your Supabase project ID to deploy.

supabase functions deploy zbd-send

Once you deploy you will receive a URL that you can use to view that function in production on Supabase’s Web Dashboard:

Opening your browser (or another HTTP client) to the URL provided by Supabase: https://xxxxxxxxxxxxx.supabase.co/functions/v1/zbd-send should return a JSON response with the payment sent message.

You can also test this using curl command:

curl https://xxxxxxxxxxxxx.supabase.co/functions/v1/zbd-send

You’re looking for the status of completed to know that the payment settled successfully.

​

5. Try it yourself

You can now begin sending instant Bitcoin payments on the edge with Supabase + ZBD!