Ten przewodnik wyjaśnia, jak skonfigurować płatności Bitcoin na swojej stronie internetowej za pomocą Electrum. Będziemy używać żądań płatności z podpisem SSL, postępując zgodnie z instrukcjami BIP-70 standard. Niniejsza dokumentacja jest aktualna dla Electrum 4.0 i nowszych wersji.
Przed rozpoczęciem upewnij się, że posiadasz:
- Ważny certyfikat SSL (podpisany przez CA, taki jak darmowy LetsEncrypt).
- Zainstalowana wersja rozwojowa Electrum.
Pamiętaj, aby uruchomić polecenie aktualizacji podmodułu podczas instalacji.
Konfiguracja certyfikatu SSL w Electrum
Aby włączyć bezpieczne połączenia, należy dodać certyfikat SSL do Electrum. Użyj tych poleceń w terminalu:
electrum -o setconfig ssl_keyfile /path/to/ssl/privkey.pem
electrum -o setconfig ssl_certfile /path/to/ssl/fullchain.pem
Bardziej szczegółowe instrukcje dotyczące dodawania SSL do Electrum można znaleźć na stronie Konfiguracja SSL dla Electrum.
Tworzenie i korzystanie z portfela sprzedawcy
Skonfiguruj bezpieczny portfel dla transakcji biznesowych. Proces ten pomaga chronić kryptowalutę nawet w przypadku naruszenia bezpieczeństwa serwera sprzedawcy.
- Utwórz nowy portfel
Na bezpiecznym komputerze utwórz nowy portfel:
electrum create
Najlepiej jest używać oddzielnego portfela dla firmy, a nie osobistego.
- Eksportowanie głównego klucza publicznego
Nadal na bezpiecznym komputerze wyeksportuj główny klucz publiczny (xpub):
electrum getmpk -w .electrum/wallets/your-wallet
- Konfiguracja serwera sprzedawcy
Na serwerze przywróć portfel przy użyciu wyeksportowanego głównego klucza publicznego:
electrum restore xpub...............................................
Wymiana xpub... z aktualnym głównym kluczem publicznym
- Skonfiguruj ustawienia serwera.
electrum -o setconfig payserver_address yourdomain.com:80
Wymiana yourdomain.com z rzeczywistą domeną.
Uruchamianie demona Electrum
Po skonfigurowaniu portfela tylko do odczytu należy uruchomić Electrum jako usługę działającą w tle. Oto jak to zrobić:
- Uruchom demona
Uruchom to polecenie, aby uruchomić Electrum jako demona:
electrum daemon -d
Uruchamia to Electrum w trybie demona, pozwalając mu działać w tle.
- Załaduj swój portfel
Następnie należy załadować portfel do uruchomionego demona:
electrum load_wallet
Polecenie to sprawia, że portfel jest aktywny i gotowy do użycia.
Zatrzymywanie demona
Jeśli chcesz zatrzymać demona Electrum w dowolnym momencie, użyj tego polecenia:
electrum stop
Spowoduje to bezpieczne wyłączenie demona Electrum.
Utwórz podpisane żądanie płatności
electrum add_request 0.5 -m "test"
{
"URI": "bitcoin:bc1q3hr4xnta7s4jgeymjhs498ygqa53qkjxqhlx3z?amount=0.5&message=test&time=1589115653&exp=3600",
"address": "bc1q3hr4xnta7s4jgeymjhs498ygqa53qkjxqhlx3z",
"amount": 50000000,
"amount_BTC": "0.5",
"bip70_url": "https://yourdomain.com:80/bip70/bc1qyr5xx5jkue3k72sldm5xa0taqs3n2achupymz8.bip70",
"exp": 3600,
"id": "63822b69013",
"memo": "test",
"status": 0,
"status_str": "Expires in about 1 hour",
"time": 1589115653,
"type": 0,
"view_url": "https://yourdomain.com:80/r/pay?id=bc1q3hr4xnta7s4jgeymjhs498ygqa53qkjxqhlx3z"
}
Oto zestawienie najważniejszych informacji:
URI: Identyfikator URI Bitcoin zawierający kwotę, wiadomość, znacznik czasu i datę wygaśnięcia.address: Adres Bitcoin dla płatności.amount: Żądana kwota w satoshis.amount_BTC: Żądana kwota w BTC.bip70_url: Adres URL podpisanego żądania BIP70.view_url: Adres URL strony internetowej wyświetlającej żądanie.
Wyjście polecenia zawiera dwa ważne adresy URL:
bip70_url: Jest to adres URL podpisanego żądania BIP70.view_url: Jest to adres URL strony internetowej, która wyświetla szczegóły żądania.
Aby wyświetlić bieżącą listę żądań, użyj opcji list_requests polecenie.
Aby usunąć wszystkie żądania z listy, użyj opcji clear_requests polecenie.
Otwórz stronę żądania płatności w przeglądarce
Po utworzeniu żądania płatności można je wyświetlić w przeglądarce internetowej.
Oto jak korzystać ze strony żądania płatności:
- Otwórz
view_urlz danych wyjściowych żądania płatności w przeglądarce internetowej. - Strona wyświetli szczegóły żądania płatności, w tym:
- Identyfikator URI Bitcoin, który można otworzyć za pomocą portfela.
- Kod QR, który można zeskanować w celu dokonania płatności.
- Czas pozostały do wygaśnięcia żądania.
- Aby dokonać płatności:
- Użyj portfela Bitcoin, aby otworzyć dostarczony identyfikator URI Bitcoin.
- Zeskanuj kod QR za pomocą portfela mobilnego.
- Strona wykorzystuje websockety do aktualizacji w czasie rzeczywistym. Po otrzymaniu płatności strona zostanie automatycznie odświeżona, aby wyświetlić zaktualizowany status.
Rzeczywisty wygląd strony może się różnić, ale będzie ona zawierać najważniejsze informacje potrzebne do dokonania płatności.
Ważne: Zawsze weryfikuj szczegóły płatności przed wysłaniem jakichkolwiek środków.
Lightning Payments
Konfiguracja Lightning
Aby korzystać z Lightning, musisz skonfigurować klucze Lightning w swoim portfelu. Wykonaj następujące kroki:
- Zatrzymanie demona Electrum:
electrum stop - Inicjalizacja kluczy Lightning:
electrum -o init_lightning - Uruchom ponownie demona:
electrum daemon -d
Klucze Lightning można dodać do portfela przeznaczonego wyłącznie do obserwowania. Ten portfel nie będzie mógł wydawać monet w łańcuchu, ale może wykonywać transakcje Lightning.
Otwieranie kanału
Po skonfigurowaniu Lightning należy otworzyć kanał:
electrum open_channel <node_id> <amount>
Aby sprawdzić, czy kanał jest gotowy do użycia:
electrum list_channels
Należy pamiętać, że nowy kanał nie będzie miał początkowo przepustowości przychodzącej, więc nie będzie można natychmiast otrzymywać płatności. Jeśli chcesz otrzymywać płatności od razu, rozważ podmorską wymianę środków kanału.
Tworzenie żądania płatności Lightning
Aby utworzyć żądanie płatności Lightning:
electrum add_lightning_request 0.0001 -m "test"
To polecenie tworzy żądanie 0,0001 BTC z komunikatem "test".