Bitcoin Economy Confederation Registration Guide

Overview

This guide will help you set up a complete profile on bitcoinconfederation.org for your circular economy project, including the ability to accept Bitcoin donations via Lightning Network and on-chain.

Step A: Initial Setup

Log into your Bitcoin Confederation profile and begin creating your circular economy listing.

A1: Add a Listing

From your dashboard, click the "Add a listing" button.

A2: Select Circular Economy

Choose "Circular Economy" as your listing type.

A3: Complete Listing Details

Fill in your project details including name, description, location, and other relevant information.

Step B: BtcMap URL Configuration

Connect your listing to the merchant locations on BtcMap to show where Bitcoin is being used in your area.

B1: Visit BtcMap

Go to btcmap.org and open the map interface.

B2: Locate Your Project Area

Navigate to your project's geographic area and center the map view so all relevant merchant pins are visible. Copy the URL from your browser's address bar.

B3: Paste BtcMap URL

Return to your confederation listing and paste the BtcMap URL into the appropriate field.

Step C: BTCPay Server Account Creation

Set up your BTCPay Server instance to manage Bitcoin donations. BTCPay is a self-hosted, open-source payment processor.

C1: Sign Into BTCPay

Go to btcpay.satcrowd.com and sign into your account (or create one if you haven't already).

C2: Create a Store

Create a new store with an appropriate name for your project. Important: Keep the default currency settings.

C3: Set Up Wallet

Click "Set up a wallet" to begin connecting your Bitcoin wallet.

Step D: Wallet Connection Process

Connect your self-custodial on-chain wallet to BTCPay Server using your extended public key (xpub/zpub).

D1: Select "Connect an existing wallet"

D2: Enter Extended Public Key

Choose "Enter extended public key" option.

D3: Paste Your xpub/zpub

Paste your extended public key from your self-custodial wallet.

D4: Verify Address Generation

Verify that the addresses generated by BTCPay match those in your wallet.

D5: Continue to Lightning Settings

D6: Access Lightning Wallet Settings

From the BTCPay menu, navigate to the Lightning wallet settings.

Step E: Blink Integration

Connect your Blink wallet to BTCPay Server to accept Lightning Network donations.

E1: Sign Into Blink Dashboard

Visit the Blink dashboard and sign into your account.

E2: Access API Keys

Navigate to API Keys in the Blink dashboard.

E3: Create New API Key

Create a new API key.

E4: Uncheck Write Permission

Important: Uncheck the "Write" permission – read-only access is sufficient and more secure.

E5: Copy BTCPay Connection String

Copy the BTCPay connection string provided by Blink.

E6: Paste and Test Connection

Return to your BTCPay Server Lightning settings and paste the connection string. Test the connection to ensure BTCPay can communicate with your Blink wallet.

Step F: Crowdfund Plugin Setup

Enable the Crowdfund plugin in BTCPay Server to create a donation page.

F1: Save Lightning Settings

Click Save to confirm your Lightning wallet connection.

F2: Verify Wallet Connections

Verify that both your on-chain wallet and Lightning wallet show green connection indicators.

F3: Enable Crowdfund Plugin

Under Plugins, select Crowdfund, give it an appropriate name, and create it.

Step G: Crowdfund Campaign Configuration

Set up your crowdfund campaign to accept custom donation amounts.

G1: Fill Campaign Details

Complete the campaign information including title and description.

G2: Add a New Perk

Under Perks, add a new item.

G3: Create Custom Amount Item

Critical: Create a custom item with the ID "custom amount" (exactly as written) with a minimum of 0.00000001 BTC.

G4: Save Campaign Settings

Save your campaign settings.

G5: View Crowdfund Page

Click View to see your crowdfund page.

G6: Copy Campaign URL

Copy the full URL of your crowdfund campaign page.

Step H: Donate Tab and QR Code Setup

Configure the donation settings in your confederation listing.

H1: Paste Crowdfund URL

Return to your confederation listing and paste the Crowdfund URL into the designated field.

H2: Open BTCPay Settings

Go back to BTCPay Server and click on Settings.

H3: Copy Your Store ID

Copy your Store ID from the BTCPay settings.

H4: Paste Store ID

Paste the Store ID into your confederation listing.

H5: Enter BTC Donation Addresses

Enter your BTC donation receive addresses from your self-custodial wallet.

H6: Add Temporary X URL Placeholder

Add your X (Twitter) profile URL as a temporary placeholder for the verification tweet (you'll update this later).

Step I: BTCPay Checkout Appearance Settings

Configure the checkout experience to prioritize Lightning payments for small amounts.

I1: Navigate to Checkout Appearance

In BTCPay Settings, go to Checkout Appearance.

I2: Set Default Payment Method

Set the default payment method to BTC-LN (Lightning Network).

I3: Configure On-Chain Threshold

For BTC-CHAIN, set it to "Greater than" with a value of 0.00021 BTC. This means on-chain payments will only be offered for amounts above this threshold, with Lightning used for smaller amounts.

Step J: Preview and Submission

Review your listing and submit it for approval.

J1: Preview Your Listing

Click Preview to see how your listing will appear to visitors.

J2: Review All Details

Carefully review all information, donation addresses, and links to ensure everything is correct.

J3: Submit for Approval

When everything looks correct, submit your listing for approval.

Step K: Final Verification (After Approval)

Once your listing is approved, you must create a public verification post on X (Twitter) to prove you control the donation addresses.

K1: Wait for Approval

After submission, wait for the Bitcoin Confederation team to review and approve your listing. You will receive a notification when approved.

K2: Go to X (Twitter)

Once approved, open X (Twitter) and create a new post.

K3: Write Your Verification Post

In your post, you must include these three items exactly:

1. Your confederation profile link – Example: https://bitcoinconfederation.org/listing/your-project-name
2. Your on-chain Bitcoin address – The address that starts with bc1 or 3 (from your self-custodial wallet)
3. Your Lightning address – Example: yourproject@blink.sv or your Lightning invoice address

Example post:

Our project is now on Bitcoin Confederation!

Profile: https://bitcoinconfederation.org/listing/your-project
On-chain: bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh
Lightning: yourproject@blink.sv

K4: Post and Copy the Link

Click Post to publish. After posting, click on the post to open it. Copy the full URL from your browser address bar. The URL should look like: https://x.com/YourUsername/status/1234567890

K5: Return to Your Listing

Go back to bitcoinconfederation.org, log in, and click Edit on your listing.

K6: Add the Verification Link

Find the field where you previously entered your X profile URL (the temporary placeholder). Delete that placeholder and paste the full URL to your verification post. Click Save to finish.

What's Next?

Now that your listing is complete:

• Share your confederation profile link on social media
• Add your BTCPay donation button to your website
• Keep your listing updated with your latest activities and impact