Accept Bitcoin payments. Free, open-source & self-hosted, Bitcoin payment processor.
Go to file
Andrew Camilleri c5a0e28420
Refactor Wallet import code (#5638)
* Refactor Wallet import code

The code for wallet import was incredibly messy as it evolved over time from various requests.

This PR:
* splits up each supported format into its own file
* Supports taproot descriptors (through a hack until NBitcoin supports it internally) fixes #5518
* Reduces different paths for handling electrum/non-electrum xpubs
* Allows plugins to add their own import support formats for onchain wallets.

* Update NBitcoin to parse tr descriptors

* Fix warnings

* Use dedicated type OnChainWalletParsers

---------

Co-authored-by: nicolas.dorier <nicolas.dorier@gmail.com>
2024-01-17 18:08:39 +09:00
.circleci Use buildx for creating and pushing docker images (#5592) 2023-12-22 14:23:04 +09:00
.github Fix codeql config to not scan vendor js, add it to solution 2023-05-23 10:38:59 +09:00
.vscode Adjust VSCode browser launch regex 2022-01-11 21:11:15 -08:00
BTCPayServer Refactor Wallet import code (#5638) 2024-01-17 18:08:39 +09:00
BTCPayServer.Abstractions enhance fine grain permissions (#5502) 2023-12-01 09:12:02 +01:00
BTCPayServer.Client Refactor Wallet import code (#5638) 2024-01-17 18:08:39 +09:00
BTCPayServer.Common Startup: List configured networks in non-altcoin build warning (#5593) 2023-12-22 17:25:04 +09:00
BTCPayServer.Data Fix: Payments to Top-Up could be undetected due to race condition (#5568) 2023-12-20 18:41:28 +09:00
BTCPayServer.PluginPacker Bump .NET 8.0 (#5479) 2023-11-21 14:11:17 +09:00
BTCPayServer.Rating Refactor Wallet import code (#5638) 2024-01-17 18:08:39 +09:00
BTCPayServer.Tests Refactor Wallet import code (#5638) 2024-01-17 18:08:39 +09:00
Build Changelog and bump 2023-12-22 14:21:12 +09:00
docs Update db-migration.md 2023-03-02 13:20:47 +09:00
.dockerignore Remove launch profile from docker 2017-10-19 17:45:07 +09:00
.editorconfig Code formatting updates (#4502) 2023-01-06 22:18:07 +09:00
.gitattributes shebang and fix line ending 2018-03-06 09:23:08 -05:00
.gitignore Pluginize Webhooks and support Payouts (#5421) 2023-12-01 10:50:05 +01:00
btcpayserver.sln Use buildx for creating and pushing docker images (#5592) 2023-12-22 14:23:04 +09:00
btcpayserver.sln.DotSettings Support accepting 0 amount bolt 11 invoices for payouts (#4014) 2023-07-24 20:40:26 +09:00
build.ps1 Fix build and run scripts (#4655) 2023-02-16 18:31:33 +09:00
build.sh Fix build and run scripts (#4655) 2023-02-16 18:31:33 +09:00
Changelog.md Changelog and bump 2023-12-22 14:21:12 +09:00
docker-entrypoint.sh Make BTCPay ssh key using safe algo 2022-07-08 16:32:43 +09:00
Dockerfile Use buildx for creating and pushing docker images (#5592) 2023-12-22 14:23:04 +09:00
LICENSE Update license (#4480) 2023-01-06 16:19:02 +01:00
nuget.config Add a test catching expirationTime bug (#1336) 2020-03-10 17:11:15 +09:00
publish-docker.ps1 Improve publish docker script 2023-02-26 00:19:59 +09:00
README.md README.md: .NET is not called "Core" anymore (#5636) 2024-01-02 12:29:40 +01:00
RELEASE-CHECKLIST.md Add missing file 2020-06-28 18:00:51 +09:00
run.ps1 Fix build and run scripts (#4655) 2023-02-16 18:31:33 +09:00
run.sh Fix build and run scripts (#4655) 2023-02-16 18:31:33 +09:00
SECURITY.md Security Page Refactor (#4815) 2023-04-24 15:04:56 +09:00

BTCPay Server

BTCPay Server

Accept Bitcoin payments โ‚ฟ

BTCPay Server is a free and open-source Bitcoin payment processor which allows you to accept bitcoin without fees or intermediaries.

"This is lies, my trust in you is broken, I will make you obsolete" ๐Ÿ’š

View Demo ยท Report a bug ยท Request a feature ยท FAQ

๐Ÿ’ผ Table of Contents

๐ŸŽจ Features

  • Direct, peer-to-peer Bitcoin payments
  • No transaction fees (other than the network fee)
  • No fees, middleman or KYC
  • Non-custodial (complete control over the private key)
  • Enhanced privacy & security
  • Self-hosted
  • SegWit support
  • Lightning Network support (LND, Core Lightning (CLN), Eclair)
  • Tor support
  • Share your instance with friends (multi-tenant)
  • Invoice management and Payment requests
  • Apps: Point of sale, crowdfunding, donation button
  • Full-node reliant wallet with hardware wallet integration and SegWit support
  • Bitcoin-only build, separate community-maintained altcoin build (supported altcoins)

๐Ÿš€ Getting Started

Firstly, decide if you want to host an instance yourself or use a third-party host. If you've chosen to self-host, there are plenty of documented ways to deploy BTCPay Server.

After successful deployment, make sure to check our getting started and walkthrough guides. In case you would like to use Lightning Network, see Lightning guide.

๐Ÿ“— Documentation

Please check out our official website, complete documentation and FAQ for more details.

If you have trouble using BTCPay Server, consider joining communities listed on the official website to get help from other contributors. Only create a GitHub issue for technical issues you can't resolve through other channels or feature requests you've validated with other members of the community.

๐Ÿค Contributing

BTCPay Server is built and maintained entirely by volunteer contributors around the internet. We welcome and appreciate new contributions.

If you're a developer looking to help, but you're not sure where to begin, check the good first issue label, which contains small pieces of work that have been specifically flagged as being friendly to new contributors.

Contributors looking to do something a bit more challenging, before opening a pull request, please join our community chat or start a GitHub discussion to get early feedback, discuss the best ways to tackle the problem, and ensure there is no work duplication.

There are many other ways to get involved with the project. Check our contribution guidelines. To get the big-picture of the project development, visit our evolving roadmap.

๐Ÿง‘โ€๐Ÿ’ป Developing

To begin developing locally, visit our local development guide. There are also several video-tutorials:

How to build

While the documentation advises using docker-compose, you may want to build BTCPay Server yourself.

First, install .NET SDK v8.0 as specified by the Microsoft website.

On Powershell:

.\build.ps1

On linux:

./build.sh

How to run

Use the run scripts to run BTCPay Server, this example shows how to print the available command-line arguments of BTCPay Server.

On Powershell:

.\run.ps1 --help

On linux:

./run.sh --help

How to debug

If you want to debug, use Jetbrain's Rider or Visual Studio 2022.

You need to run the development time docker-compose as described in the test guide.

You can then run the debugger by using the Launch Profile Docker-Regtest.

If you need to debug ledger wallet interaction, install the development time certificate with:

# Install development time certificate in the trust store
dotnet dev-certs https --trust

Then use the Docker-Regtest-https debug profile.

Other dependencies

For more information, see the documentation: How to deploy a BTCPay Server instance.

๐Ÿงช API

BTCPay Server has two APIs:

The Greenfield API is our brand-new API which is still in development. Once complete, it will allow you to run BTCPay Server headlessly. The Legacy API, is fully compatible with BitPay's API. It has limited features, but allows instant migration from BitPay.

๐Ÿ’š Community

Our community is the โค๏ธ of the project. To chat with other community members in real-time, join our Mattermost chat. We're also on GitHub discussions.

๐Ÿ“ License

BTCPay Server software, logo and designs are provided under MIT License.

๐Ÿ™ Supporters

The BTCPay Server Project is proudly supported by these entities through the BTCPay Server Foundation.

Spiral Baillie Gifford Strike Human Rights Foundation Escape to El Salvador LunaNode Wallet of Satoshi Coincards IVPN

If you'd like to support the project, please visit the donation page.