diff --git a/boltring-app/index.html b/boltring-app/index.html index 0e84af7..7a6f775 100755 --- a/boltring-app/index.html +++ b/boltring-app/index.html @@ -695,5 +695,7 @@

Screen: Connect - + \ No newline at end of file diff --git a/boltring-reset/index.html b/boltring-reset/index.html index 7f9c578..f1a82d1 100755 --- a/boltring-reset/index.html +++ b/boltring-reset/index.html @@ -553,9 +553,23 @@

Reset with Bolt Card Creator

In addition to the reset code you will also eed an Android Phone with NFC support.

-

Install the -Bolt Card Creator Android App

+

If you have an Android phone install the Bolt Card NFC Card Creator App from Google Play. +If you are using an iPhone install the Boltcard NFC Programmer from the App Store.

Make sure that NFC is enabled on your mobile phone before launching the app.

+
+

TIPS: NFC chip reset

+

LNbits NFC Chip Configuration

+

Important: If writing to the BoltRing NFC chip is interruped you may end up with a bricked +device. Be sure to:

+
    +
  • Remove any cover or shell from your phone before configuring your BoltRing.
    • +
  • Find out where the NFC chip antenna is positioned in your phone (using read tests).
    • +
  • Put the BoltRing on a table and and the phones antenna on top it in a stable position.
    • +
  • Wait a few seconds after writing before moving your phone.
    • +
+

If you are using an iPhone, put it on top of the BoltRing as shown on this image before +hitting the Reset Card Now button.

+

LNbits Bolt Card Create QR Code

BoltRing Reset Steps

@@ -563,9 +577,9 @@

Reset with Bolt Card Creator

  • Select the Reset Keys tab at the bottom of your start screen
  • Tap the SCAN QR CODE button to read the reset code (the card details should show your keys now)
    • -
  • Tap the RESET CARD NOW button and position your phone´s NFC antenna close above the - BoltRing
    • -
  • Hold the device still and wait until app shows green checkmarks that confirm the key resets.
    • +
  • Position your phones antenna on top of your BoltRing in a stable way and tap the + RESET CARD NOW button
    • +
  • Hold the device still and wait until the app confirms that the keys are reset.

    • Congratulations your BoltRing is reset to factory defaults and can now be configured with another wallet

    @@ -678,5 +692,7 @@

    Reset with Bolt Card Creator

    - + \ No newline at end of file diff --git a/getting-started/index.html b/getting-started/index.html index 1e61fd3..ef60b9b 100755 --- a/getting-started/index.html +++ b/getting-started/index.html @@ -765,5 +765,7 @@

    LNbits

    - + \ No newline at end of file diff --git a/images/iphone-positioning.jpg b/images/iphone-positioning.jpg new file mode 100755 index 0000000..e898f05 Binary files /dev/null and b/images/iphone-positioning.jpg differ diff --git a/index.html b/index.html index 72e7060..7432557 100755 --- a/index.html +++ b/index.html @@ -602,5 +602,7 @@

    - + \ No newline at end of file diff --git a/lnbits/index.html b/lnbits/index.html index eeba821..59fc364 100755 --- a/lnbits/index.html +++ b/lnbits/index.html @@ -705,15 +705,30 @@

    Step 6 - Pairing Your

    Warning

    Please make sure you go through these last steps in one go, because the QR code from the -previous step will be invalidated when you scan it. Make sure you hold your phone above the -BoltRing at the correct position and hold it steady and long enough for the pairing to +previous step will be invalidated when you scan it. Make sure you position your phone above +the BoltRing at the correct place in a steady fashion and long enough for the pairing to complete. If you close the App before writing the pairing data to the BoltRing, you must start over from step 5 and create a new card service entry.

    +
    +

    TIPS: NFC chip writing

    +

    LNbits NFC Chip Configuration

    +

    Important: If writing to the BoltRing NFC chip is interruped you may end up with a bricked +device. Be sure to:

    +
      +
    • Remove any cover or shell from your phone before configuring your BoltRing.
      • +
    • Find out where the NFC chip antenna is positioned in your phone (using read tests).
      • +
    • Put the BoltRing on a table and and the phones antenna on top it in a stable position.
      • +
    • Wait a few seconds after writing before moving your phone.
      • +
    +

    If you are using an iPhone, put it on top of the BoltRing as shown on this image before +hitting the Write Card Now button.

    +
    1. Go to the start screen of the Bolt Card Creator app
    2. On the start screen, tap SCAN QR CODE and scan the LNbits card creation QR code
      3. -
    3. Tap "WRITE CARD NOW" and position your phone´s NFC antenna close above the BoltRing
      4. +
    4. Put your phones antenna on top of the BoltRing in a stable position
      5. +
    5. Tap "WRITE CARD NOW"
    6. Verify that the app Output section shows all the green checkmarks

    Congratulations, your BoltRing is now ready for use.

    @@ -842,5 +857,7 @@

    Step 6 - Pairing Your - + \ No newline at end of file diff --git a/merchant-compatibility/index.html b/merchant-compatibility/index.html index 9dbe2a4..d2ced3f 100755 --- a/merchant-compatibility/index.html +++ b/merchant-compatibility/index.html @@ -772,5 +772,7 @@

    CoinCorner Checkout

    - + \ No newline at end of file diff --git a/search/search_index.json b/search/search_index.json index 0d256e4..8dacbf8 100755 --- a/search/search_index.json +++ b/search/search_index.json @@ -1 +1 @@ -{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"BoltRing Documentation","text":"

    Contactless Payments over Bitcoin Lightning

    Welcome to the world of contactless bitcoin lightning payments with the BoltRing! We're excited to offer this cutting-edge product to early adopters interested in exploring new technologies and pushing the boundaries of what's possible.

    The BoltRing is the first Bitcoin DIY contactless payment ring that brings the tap-to-pay experience to Bitcoin Lightning. You can use the BoltRing with your self-sovereign Bitcoin Lightning node or a commercial service provider.

    Get your own BoltRing at https://bitcoin-ring.com.

    A Community Effort

    The capabilities of the BoltRing are the results of contributions from developers and enthusiasts all around the world - most notably the Bolt Card Project and CoinCorner. Using this technology means being part of a global community of people who believe in the power of permissionless, decentralized, peer-to-peer transactions.

    By adopting this technology, you are not only getting access to cutting-edge payments capabilities, but you also get the opportunity to shape and influence the development of the technology while supporting a movement that aims to democratize access to financial services and promote financial freedom.

    The State of Development

    Please note that the BoltRing is still in its early stages. It is currently only supported by a limited number merchants, wallets, and the setup of the BoltRing may still be technically challenging. However, we believe that the benefits of using contactless payment technology for Bitcoin are worth the effort, and we are here to support you every step of the way.

    About the Documentation

    Our documentation is designed to guide you through every step, making it as easy as possible. We encourage you to experiment with the BoltRing and not to be afraid to try new things. By working through the documentation, you'll be able to take advantage of the ring's capabilities and learn about the underlying technology and how it all works.

    The documentation will cover all the necessary steps to get started and to be able to make your first bitcoin payments with the BoltRing. We will review the software and hardware requirements, the setup process, and how to pair the ring with a lightning service and your mobile wallet. From there, you can make convenient and contactless bitcoin payments.

    Let\u00b4s go

    We hope you enjoy using your new BoltRing, and we look forward to your feedback and suggestions. Please do not hesitate to reach out to us if you have any questions or encounter any issues. Let's take the first steps in NFC-based bitcoin payments together!

    "},{"location":"boltring-app/","title":"BoltRing App - Concept","text":"

    Work in Progress

    This document is work in progress and may change without notice. At the current time this concept of a BoltRing companion app is just that - A Concept. This document will be updated if/when we implement the concept.

    "},{"location":"boltring-app/#introduction","title":"Introduction","text":"

    The BoltRing App is a mobile application for Android and iOS. It is a companion app for the BoltRing payment device. The goal of the app is to enable non-technical people to configure and use the BoltRing. To drive adoption of contactless bitcoin lightning payments the user experience of this app shall be as convenient, simple and polished as possible.

    "},{"location":"boltring-app/#boltring-app-features","title":"BoltRing App Features","text":""},{"location":"boltring-app/#basic-features","title":"Basic Features","text":"
    • Connect the BoltRing with a BoltService
    • Configure payment rules and other settings
    • Track balance and send/receive payments
    • Reset a BoltRing to factory defaults
    "},{"location":"boltring-app/#special-features","title":"Special Features","text":"
    • Import a pre-configured BoltRing
    • Require PIN for certain payments
    • Separate activation of Send/Receive/BalanceCheck
    • Extended Payment Authorizaton Rules
    • Push notifications for payments
    "},{"location":"boltring-app/#hardware-requirements","title":"Hardware Requirements","text":"

    Connecting a BoltRing with a BoltService requires an accessible NFC Chip on the mobile device. If the device has no NFC-Chip it is possible to activate the Ring using another device and then import the pre-configured BoltRing to the device without NFC support.

    "},{"location":"boltring-app/#boltring-activation","title":"BoltRing Activation","text":"

    To activate the payment functionality of a BoltRing the following high level steps are required:

    • Creation of an account on a BoltService
    • Writing the Service URL and account keys to the NFC chip of the BoltRing
    "},{"location":"boltring-app/#user-experience","title":"User Experience","text":""},{"location":"boltring-app/#application-start","title":"Application Start","text":"

    Starting the application shows a loader screen with the BoltRing Logo. Optionally a high quality polished product photo of the BoltRing itself. Application start should be optimized to be as fast as possible.

    "},{"location":"boltring-app/#home-screen","title":"Home Screen","text":""},{"location":"boltring-app/#no-boltring-connected","title":"No BoltRing Connected","text":"

    If no BoltRing has yet been connected, the app should first check the NFC status of the mobile device. The following conditions may occur:

    The device has no NFC Chip

    "},{"location":"boltring-app/#-nfc-chip-detected-but-no-permission","title":"- NFC chip detected but no permission","text":"

    the Home Screen shows:

    • A welcome message: \u201cWelcome to your BoltRing\u201d
    • A button: \u201cConnect BoltRing\u201d
    "},{"location":"boltring-app/#screen-connect-boltring","title":"Screen: Connect BoltRing","text":"

    Allows user to connect his/her BoltRing with the BoltRing Wallet App.

    The screen shows the following elements:

    • Editable \u201cNAME\u201d field prefilled with a random name (\u201cXYZ BoltRing\u201d)
    • An image showing the position of the NFC chip of the mobile phone
    "},{"location":"boltring-reset/","title":"How to reset your BoltRing","text":"

    If your BoltRing is already paired with a lightning wallet, and you want to connect it to another BoltService you first need to reset your BoltRing. Your BoltRing configuration is protected by secret keys which you need to reset your BoltRing.

    Backup your Keys

    You need keys to re-configure your BoltRing. Without keys you cannot reset or re-configure your device!

    Keys are initialy set to ZERO at factory settings unless you bought a pre-configured BoltRing. For pre-configured BoltRings the keys are printed as QR code on the enclosed leaflet.

    After you re-configured your BoltRing you will need the newly set keys for any further re-configuration (the original keys will not work anymore).

    "},{"location":"boltring-reset/#boltring-reset-code","title":"BoltRing Reset Code","text":"

    If you received a pre-configured BoltRing, the reset code is printed on the leaflet that came with it. This QR code includes all the data required to reset your BoltRing to factory defaults. When you read the QR Code you should get data that looks like this:

    {\n\"action\": \"wipe\",\n\"k0\": \"dc41a9fc8db3766bf5e9f65b0f6f648e\",\n\"k1\": \"1a5aae9505a61f5b70b01deca990f728\",\n\"k2\": \"6f8cafe391f9181f7a72d778b816714b\",\n\"k3\": \"4d17d81c7c7a9a226a388f1e71addd15\",\n\"k4\": \"2fa4bf8c8e6d3e964459732627afc94e\",\n\"uid\": \"04DE663B7EA0A5\",\n\"version\": 1\n}\n
    "},{"location":"boltring-reset/#reset-with-bolt-card-creator","title":"Reset with Bolt Card Creator","text":"

    In addition to the reset code you will also eed an Android Phone with NFC support.

    Install the Bolt Card Creator Android App

    Make sure that NFC is enabled on your mobile phone before launching the app.

    BoltRing Reset Steps

    1. Select the Reset Keys tab at the bottom of your start screen
    2. Tap the SCAN QR CODE button to read the reset code (the card details should show your keys now)
    3. Tap the RESET CARD NOW button and position your phone\u00b4s NFC antenna close above the BoltRing
    4. Hold the device still and wait until app shows green checkmarks that confirm the key resets.

    Congratulations your BoltRing is reset to factory defaults and can now be configured with another wallet

    "},{"location":"getting-started/","title":"Getting started with your BoltRing","text":"

    To use your BoltRing you must pair it with a compatible Wallet and Bolt Card service. The service is then responsible for verifying and processing the unique payment URLs generated by your BoltRing according to the configured payment rules.

    As always, with Bitcoin, there are different options for setting up, operating, or using a Bolt Card service for your BoltRing, with varying features and tradeoffs.

    Backup your Keys

    You need keys to re-configure your BoltRing. Without keys you cannot reset or re-configure your device!

    Keys are initialy set to ZERO at factory settings unless you bought a pre-configured BoltRing. For pre-configured BoltRings the keys are printed as QR code on the enclosed leaflet.

    After you re-configured your BoltRing you will need the newly set keys for any further re-configuration (the original keys will not work anymore).

    "},{"location":"getting-started/#boltring-pairing-options","title":"BoltRing Pairing Options","text":"Wallet/Service Custodial Open Source Exchange Difficulty CoinCorner Yes No Yes Easy Bolt Card Wallet Yes/No Yes No Easy LNbits Yes/No Yes No Advanced"},{"location":"getting-started/#coincorner","title":"CoinCorner","text":"

    For non-technical folks and iPhone users, CoinCorner is probably the easiest way to get started. CoinCorner launched the Bolt Card in May 2022. They offer many Bitcoin-related services for users and merchants, including a custodial lightning wallet and fiat exchange services.

    Tip

    Before creating an account with CoinCorner, make sure their service is available in your country

    If you sign up with CoinCorner, you can easily pair your BoltRing with their mobile lightning wallet using any NFC-capable iPhone or Android device. The pairing procedure is the same as with the Bolt Card. Use our referral link to sign up:

    Go with CoinCorner

    "},{"location":"getting-started/#bolt-card-wallet","title":"Bolt Card Wallet","text":"

    Another option is the Bolt Card Wallet for Android or iOS which is a modified version of Bluewallet. The app is open source and allows you to connect your BoltRing with a Bolt Card Hub Service that you can run yourself. You may also use a public instance (custodial) of the Bolt Card Hub.

    Install Bolt Card Wallet

    "},{"location":"getting-started/#lnbits","title":"LNbits","text":"

    LNbits is a free, open-source lightning account system with many features, including a Bolt Card extension. You can use a hosted LNbits service or, provided that you have the necessary technical skills, install and operate your own LNbits service.

    LNbits Setup Guide

    "},{"location":"lnbits/","title":"BoltRing LNbits Setup","text":"

    LNbits is a free, open-source lightning account system with Bolt Card support. This guide shows you how to pair your BoltRing with the LNbits Bolt Card extension.

    Security notice

    In this guide, we use a public demo installation of LNbits, which means you must trust the service operators to guard your satoshis. Don\u00b4t be reckless; use it with caution and only for testing with small amounts.

    Use your own LNbits server

    You can also use this guide to pair your BoltRing with your self-hosted LNbits server. But be aware that your LNbits server has to be publicly reachable over clearnet with a https URL. A default Umbrel installation of LNbits will not work!

    "},{"location":"lnbits/#step-0-requirements","title":"Step 0 - Requirements","text":"
    • An existing Lightning Wallet that you can use to fund your LNbits account
    • A Mobile Phone with NFC support to provision your BoltRing
    • A BoltRing that has not been set up yet (or has been wiped)
    "},{"location":"lnbits/#step-1-install-bolt-card-creator","title":"Step 1 - Install Bolt Card Creator","text":"

    If you have an Android phone install the Bolt Card NFC Card Creator App from Google Play. If you are using an iPhone install the Boltcard NFC Programmer from the App Store.

    You will need this app later to write the bolt service configuration to the BoltRing. You will also need the NFC UID of your BoltRing for this set-up. You can either find it on the front page of the leaflet that came with your BoltRing or you can scan the BoltRing to get the NFC UID.

    If you already have your UID and are in a hurry, you can skip this section and continue with step 2.

    Read BoltRing NFC UID

    Using the Bolt Card Creator/Programmer App:

    1. Select the Advanced tab at the bottom of the start screen of the Bolt Card Creator App
    2. Select the Read NFC tab on the stacked menu
    3. Scan your BoltRing by holding it to the back of your phone
    4. Take note of the UID of your BoltRing

    Memorize the NFC antenna location

    Smartphones have their NFC antenna in different places. Usually, it is in the upper third of the back of the phone. While scanning the BoltRing, pay attention to the position the app detects the BoltRing. Knowing the antenna position will give you more confidence when writing the configuration to the BoltRing later.

    Error: This NFC card has not been formatted.

    If you get this error, you can use the NXP TagWriter App to erase and format your tag as NDEF.

    "},{"location":"lnbits/#step-2-create-an-lnbits-wallet","title":"Step 2 - Create an LNbits Wallet","text":"

    Do these steps from a PC

    The guide assumes you create your LNbits wallet from a desktop PC.

    • Browse to https://legend.lnbits.com/ (or your own LNbits installation)
    • Type a memorable name for your wallet
    • Click ADD A NEW WALLET
    • Take note of your Wallet-URL

    Secure your Wallet-URL

    The LNbits wallet you created does not have a password-protected login. The Wallet-URL shown in the browser after completing the setup IS YOUR PASSWORD/LOGIN. So please make a backup of the full Wallet-URL and keep it a secret.

    "},{"location":"lnbits/#step-3-fund-your-wallet","title":"Step 3 - Fund Your Wallet","text":"

    Click the CREATE INVOICE button and send some satoshis to your LNbits wallet.

    "},{"location":"lnbits/#step-4-install-extension","title":"Step 4 - Install Extension","text":"

    Activate the LNbits Bolt Card Extension for your wallet as follows:

    • Click on Manage Extensions in the left menu
    • Click ENABLE on the Bolt Cards tile
    • Click OPEN or the new Bolt Cards item in the left menu

    "},{"location":"lnbits/#step-5-create-bolt-card-service","title":"Step 5 - Create Bolt Card Service","text":"
    • Click the orange plus button on the Bolt Cards Extension screen

    On the card creation form:

    1. Select the LNbits wallet you created before
    2. Set a limit of satoshis per transaction (for example, 100 000)
    3. Set a limit of satoshis per day (for example, 600 000)
    4. Type a memorable name for your BoltRing
    5. Enter the NFC UID of your BoltRing
    6. Click CREATE CARD

    After clicking CREATE CARD, you should see the card service created. Click the QR Code in the first column of the list to show the QR code you need in the next step.

    After clicking the QR code symbol, you should see this card creation popup.

    Make sure you back up the keys shown below the QR code. You will need them to reset/wipe your BoltRing later. Should LNbits become unavailable, these keys will be the only way to recover/reset your BoltRing.

    Keep the popup window open; you will need to scan the shown QR code in the next step.

    "},{"location":"lnbits/#step-6-pairing-your-boltring","title":"Step 6 - Pairing Your BoltRing","text":"

    Now you will pair you BoltRing with the LNbits BoltCard Extension. Go to your mobile phone and start the Bolt Card Creator App you installed earlier. Place your BoltRing on a table, so it is ready to be paired.

    Warning

    Please make sure you go through these last steps in one go, because the QR code from the previous step will be invalidated when you scan it. Make sure you hold your phone above the BoltRing at the correct position and hold it steady and long enough for the pairing to complete. If you close the App before writing the pairing data to the BoltRing, you must start over from step 5 and create a new card service entry.

    1. Go to the start screen of the Bolt Card Creator app
    2. On the start screen, tap SCAN QR CODE and scan the LNbits card creation QR code
    3. Tap \"WRITE CARD NOW\" and position your phone\u00b4s NFC antenna close above the BoltRing
    4. Verify that the app Output section shows all the green checkmarks

    Congratulations, your BoltRing is now ready for use.

    "},{"location":"merchant-compatibility/","title":"BoltRing Merchant Compatibility","text":"

    The BoltRing compatible with the open LUD-17 LNURLW standard. The following wallets and point-of-sales systems support accepting BoltRing payments:

    "},{"location":"merchant-compatibility/#self-hosted","title":"Self-Hosted","text":""},{"location":"merchant-compatibility/#breez-mobile","title":"Breez Mobile","text":"

    The Breez Mobile app for Android and iPhone offers simple non-custodial Point-of-Sale functionality, including the possibility to accept Lightning NFC payments.

    Breez Mobile

    "},{"location":"merchant-compatibility/#btcpay-server","title":"BTCPay Server","text":"

    BTCPay Server is a comprehensive self-hosted, open-source Bitcoin payment processor. The LNURL NFC plugin supports NFC payments for the included Point-of-Sale app.

    BTCPay Server

    "},{"location":"merchant-compatibility/#lnbits-tpos","title":"LNbits TPoS","text":"

    LNbits is a free, open-source Lightning account system. It comes with the TPoS extension, a Point-of-Sales app that supports Lightning NFC payments.

    LNbits TPoS

    "},{"location":"merchant-compatibility/#custodial","title":"Custodial","text":""},{"location":"merchant-compatibility/#wallet-of-satoshi","title":"Wallet Of Satoshi","text":"

    Wallet of Satoshi is a popular and easy to use custodial wallet for Android and iPhonnes. The latest version comes with dedicated point-of-sale functionality for merchants that supports NFC payments.

    Wallet of Satoshi

    "},{"location":"merchant-compatibility/#coincorner-checkout","title":"CoinCorner Checkout","text":"

    CoinCorner Checkout is a hosted bitcoin payment solution for merchants and other businesses. Their Point-of-Sale mobile app supports Lightning NFC payments.

    CoinCorner Checkout

    "},{"location":"video-tutorials/","title":"Bitcoin BoltRing Video Tutorials","text":""},{"location":"video-tutorials/#unveiling-the-bitcoin-bolt-ring-tap-and-pay-instantly","title":"Unveiling the Bitcoin Bolt Ring: Tap And Pay Instantly!","text":"

    This video by BTC Session will walk through setting up and using your BoltRing with and LNbits service. We couldn\u00b4t have done this any better!

    "}]} \ No newline at end of file +{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"BoltRing Documentation","text":"

    Contactless Payments over Bitcoin Lightning

    Welcome to the world of contactless bitcoin lightning payments with the BoltRing! We're excited to offer this cutting-edge product to early adopters interested in exploring new technologies and pushing the boundaries of what's possible.

    The BoltRing is the first Bitcoin DIY contactless payment ring that brings the tap-to-pay experience to Bitcoin Lightning. You can use the BoltRing with your self-sovereign Bitcoin Lightning node or a commercial service provider.

    Get your own BoltRing at https://bitcoin-ring.com.

    A Community Effort

    The capabilities of the BoltRing are the results of contributions from developers and enthusiasts all around the world - most notably the Bolt Card Project and CoinCorner. Using this technology means being part of a global community of people who believe in the power of permissionless, decentralized, peer-to-peer transactions.

    By adopting this technology, you are not only getting access to cutting-edge payments capabilities, but you also get the opportunity to shape and influence the development of the technology while supporting a movement that aims to democratize access to financial services and promote financial freedom.

    The State of Development

    Please note that the BoltRing is still in its early stages. It is currently only supported by a limited number merchants, wallets, and the setup of the BoltRing may still be technically challenging. However, we believe that the benefits of using contactless payment technology for Bitcoin are worth the effort, and we are here to support you every step of the way.

    About the Documentation

    Our documentation is designed to guide you through every step, making it as easy as possible. We encourage you to experiment with the BoltRing and not to be afraid to try new things. By working through the documentation, you'll be able to take advantage of the ring's capabilities and learn about the underlying technology and how it all works.

    The documentation will cover all the necessary steps to get started and to be able to make your first bitcoin payments with the BoltRing. We will review the software and hardware requirements, the setup process, and how to pair the ring with a lightning service and your mobile wallet. From there, you can make convenient and contactless bitcoin payments.

    Let\u00b4s go

    We hope you enjoy using your new BoltRing, and we look forward to your feedback and suggestions. Please do not hesitate to reach out to us if you have any questions or encounter any issues. Let's take the first steps in NFC-based bitcoin payments together!

    "},{"location":"boltring-app/","title":"BoltRing App - Concept","text":"

    Work in Progress

    This document is work in progress and may change without notice. At the current time this concept of a BoltRing companion app is just that - A Concept. This document will be updated if/when we implement the concept.

    "},{"location":"boltring-app/#introduction","title":"Introduction","text":"

    The BoltRing App is a mobile application for Android and iOS. It is a companion app for the BoltRing payment device. The goal of the app is to enable non-technical people to configure and use the BoltRing. To drive adoption of contactless bitcoin lightning payments the user experience of this app shall be as convenient, simple and polished as possible.

    "},{"location":"boltring-app/#boltring-app-features","title":"BoltRing App Features","text":""},{"location":"boltring-app/#basic-features","title":"Basic Features","text":"
    • Connect the BoltRing with a BoltService
    • Configure payment rules and other settings
    • Track balance and send/receive payments
    • Reset a BoltRing to factory defaults
    "},{"location":"boltring-app/#special-features","title":"Special Features","text":"
    • Import a pre-configured BoltRing
    • Require PIN for certain payments
    • Separate activation of Send/Receive/BalanceCheck
    • Extended Payment Authorizaton Rules
    • Push notifications for payments
    "},{"location":"boltring-app/#hardware-requirements","title":"Hardware Requirements","text":"

    Connecting a BoltRing with a BoltService requires an accessible NFC Chip on the mobile device. If the device has no NFC-Chip it is possible to activate the Ring using another device and then import the pre-configured BoltRing to the device without NFC support.

    "},{"location":"boltring-app/#boltring-activation","title":"BoltRing Activation","text":"

    To activate the payment functionality of a BoltRing the following high level steps are required:

    • Creation of an account on a BoltService
    • Writing the Service URL and account keys to the NFC chip of the BoltRing
    "},{"location":"boltring-app/#user-experience","title":"User Experience","text":""},{"location":"boltring-app/#application-start","title":"Application Start","text":"

    Starting the application shows a loader screen with the BoltRing Logo. Optionally a high quality polished product photo of the BoltRing itself. Application start should be optimized to be as fast as possible.

    "},{"location":"boltring-app/#home-screen","title":"Home Screen","text":""},{"location":"boltring-app/#no-boltring-connected","title":"No BoltRing Connected","text":"

    If no BoltRing has yet been connected, the app should first check the NFC status of the mobile device. The following conditions may occur:

    The device has no NFC Chip

    "},{"location":"boltring-app/#-nfc-chip-detected-but-no-permission","title":"- NFC chip detected but no permission","text":"

    the Home Screen shows:

    • A welcome message: \u201cWelcome to your BoltRing\u201d
    • A button: \u201cConnect BoltRing\u201d
    "},{"location":"boltring-app/#screen-connect-boltring","title":"Screen: Connect BoltRing","text":"

    Allows user to connect his/her BoltRing with the BoltRing Wallet App.

    The screen shows the following elements:

    • Editable \u201cNAME\u201d field prefilled with a random name (\u201cXYZ BoltRing\u201d)
    • An image showing the position of the NFC chip of the mobile phone
    "},{"location":"boltring-reset/","title":"How to reset your BoltRing","text":"

    If your BoltRing is already paired with a lightning wallet, and you want to connect it to another BoltService you first need to reset your BoltRing. Your BoltRing configuration is protected by secret keys which you need to reset your BoltRing.

    Backup your Keys

    You need keys to re-configure your BoltRing. Without keys you cannot reset or re-configure your device!

    Keys are initialy set to ZERO at factory settings unless you bought a pre-configured BoltRing. For pre-configured BoltRings the keys are printed as QR code on the enclosed leaflet.

    After you re-configured your BoltRing you will need the newly set keys for any further re-configuration (the original keys will not work anymore).

    "},{"location":"boltring-reset/#boltring-reset-code","title":"BoltRing Reset Code","text":"

    If you received a pre-configured BoltRing, the reset code is printed on the leaflet that came with it. This QR code includes all the data required to reset your BoltRing to factory defaults. When you read the QR Code you should get data that looks like this:

    {\n\"action\": \"wipe\",\n\"k0\": \"dc41a9fc8db3766bf5e9f65b0f6f648e\",\n\"k1\": \"1a5aae9505a61f5b70b01deca990f728\",\n\"k2\": \"6f8cafe391f9181f7a72d778b816714b\",\n\"k3\": \"4d17d81c7c7a9a226a388f1e71addd15\",\n\"k4\": \"2fa4bf8c8e6d3e964459732627afc94e\",\n\"uid\": \"04DE663B7EA0A5\",\n\"version\": 1\n}\n
    "},{"location":"boltring-reset/#reset-with-bolt-card-creator","title":"Reset with Bolt Card Creator","text":"

    In addition to the reset code you will also eed an Android Phone with NFC support.

    If you have an Android phone install the Bolt Card NFC Card Creator App from Google Play. If you are using an iPhone install the Boltcard NFC Programmer from the App Store.

    Make sure that NFC is enabled on your mobile phone before launching the app.

    TIPS: NFC chip reset

    Important: If writing to the BoltRing NFC chip is interruped you may end up with a bricked device. Be sure to:

    • Remove any cover or shell from your phone before configuring your BoltRing.
    • Find out where the NFC chip antenna is positioned in your phone (using read tests).
    • Put the BoltRing on a table and and the phones antenna on top it in a stable position.
    • Wait a few seconds after writing before moving your phone.

    If you are using an iPhone, put it on top of the BoltRing as shown on this image before hitting the Reset Card Now button.

    BoltRing Reset Steps

    1. Select the Reset Keys tab at the bottom of your start screen
    2. Tap the SCAN QR CODE button to read the reset code (the card details should show your keys now)
    3. Position your phones antenna on top of your BoltRing in a stable way and tap the RESET CARD NOW button
    4. Hold the device still and wait until the app confirms that the keys are reset.

    Congratulations your BoltRing is reset to factory defaults and can now be configured with another wallet

    "},{"location":"getting-started/","title":"Getting started with your BoltRing","text":"

    To use your BoltRing you must pair it with a compatible Wallet and Bolt Card service. The service is then responsible for verifying and processing the unique payment URLs generated by your BoltRing according to the configured payment rules.

    As always, with Bitcoin, there are different options for setting up, operating, or using a Bolt Card service for your BoltRing, with varying features and tradeoffs.

    Backup your Keys

    You need keys to re-configure your BoltRing. Without keys you cannot reset or re-configure your device!

    Keys are initialy set to ZERO at factory settings unless you bought a pre-configured BoltRing. For pre-configured BoltRings the keys are printed as QR code on the enclosed leaflet.

    After you re-configured your BoltRing you will need the newly set keys for any further re-configuration (the original keys will not work anymore).

    "},{"location":"getting-started/#boltring-pairing-options","title":"BoltRing Pairing Options","text":"Wallet/Service Custodial Open Source Exchange Difficulty CoinCorner Yes No Yes Easy Bolt Card Wallet Yes/No Yes No Easy LNbits Yes/No Yes No Advanced"},{"location":"getting-started/#coincorner","title":"CoinCorner","text":"

    For non-technical folks and iPhone users, CoinCorner is probably the easiest way to get started. CoinCorner launched the Bolt Card in May 2022. They offer many Bitcoin-related services for users and merchants, including a custodial lightning wallet and fiat exchange services.

    Tip

    Before creating an account with CoinCorner, make sure their service is available in your country

    If you sign up with CoinCorner, you can easily pair your BoltRing with their mobile lightning wallet using any NFC-capable iPhone or Android device. The pairing procedure is the same as with the Bolt Card. Use our referral link to sign up:

    Go with CoinCorner

    "},{"location":"getting-started/#bolt-card-wallet","title":"Bolt Card Wallet","text":"

    Another option is the Bolt Card Wallet for Android or iOS which is a modified version of Bluewallet. The app is open source and allows you to connect your BoltRing with a Bolt Card Hub Service that you can run yourself. You may also use a public instance (custodial) of the Bolt Card Hub.

    Install Bolt Card Wallet

    "},{"location":"getting-started/#lnbits","title":"LNbits","text":"

    LNbits is a free, open-source lightning account system with many features, including a Bolt Card extension. You can use a hosted LNbits service or, provided that you have the necessary technical skills, install and operate your own LNbits service.

    LNbits Setup Guide

    "},{"location":"lnbits/","title":"BoltRing LNbits Setup","text":"

    LNbits is a free, open-source lightning account system with Bolt Card support. This guide shows you how to pair your BoltRing with the LNbits Bolt Card extension.

    Security notice

    In this guide, we use a public demo installation of LNbits, which means you must trust the service operators to guard your satoshis. Don\u00b4t be reckless; use it with caution and only for testing with small amounts.

    Use your own LNbits server

    You can also use this guide to pair your BoltRing with your self-hosted LNbits server. But be aware that your LNbits server has to be publicly reachable over clearnet with a https URL. A default Umbrel installation of LNbits will not work!

    "},{"location":"lnbits/#step-0-requirements","title":"Step 0 - Requirements","text":"
    • An existing Lightning Wallet that you can use to fund your LNbits account
    • A Mobile Phone with NFC support to provision your BoltRing
    • A BoltRing that has not been set up yet (or has been wiped)
    "},{"location":"lnbits/#step-1-install-bolt-card-creator","title":"Step 1 - Install Bolt Card Creator","text":"

    If you have an Android phone install the Bolt Card NFC Card Creator App from Google Play. If you are using an iPhone install the Boltcard NFC Programmer from the App Store.

    You will need this app later to write the bolt service configuration to the BoltRing. You will also need the NFC UID of your BoltRing for this set-up. You can either find it on the front page of the leaflet that came with your BoltRing or you can scan the BoltRing to get the NFC UID.

    If you already have your UID and are in a hurry, you can skip this section and continue with step 2.

    Read BoltRing NFC UID

    Using the Bolt Card Creator/Programmer App:

    1. Select the Advanced tab at the bottom of the start screen of the Bolt Card Creator App
    2. Select the Read NFC tab on the stacked menu
    3. Scan your BoltRing by holding it to the back of your phone
    4. Take note of the UID of your BoltRing

    Memorize the NFC antenna location

    Smartphones have their NFC antenna in different places. Usually, it is in the upper third of the back of the phone. While scanning the BoltRing, pay attention to the position the app detects the BoltRing. Knowing the antenna position will give you more confidence when writing the configuration to the BoltRing later.

    Error: This NFC card has not been formatted.

    If you get this error, you can use the NXP TagWriter App to erase and format your tag as NDEF.

    "},{"location":"lnbits/#step-2-create-an-lnbits-wallet","title":"Step 2 - Create an LNbits Wallet","text":"

    Do these steps from a PC

    The guide assumes you create your LNbits wallet from a desktop PC.

    • Browse to https://legend.lnbits.com/ (or your own LNbits installation)
    • Type a memorable name for your wallet
    • Click ADD A NEW WALLET
    • Take note of your Wallet-URL

    Secure your Wallet-URL

    The LNbits wallet you created does not have a password-protected login. The Wallet-URL shown in the browser after completing the setup IS YOUR PASSWORD/LOGIN. So please make a backup of the full Wallet-URL and keep it a secret.

    "},{"location":"lnbits/#step-3-fund-your-wallet","title":"Step 3 - Fund Your Wallet","text":"

    Click the CREATE INVOICE button and send some satoshis to your LNbits wallet.

    "},{"location":"lnbits/#step-4-install-extension","title":"Step 4 - Install Extension","text":"

    Activate the LNbits Bolt Card Extension for your wallet as follows:

    • Click on Manage Extensions in the left menu
    • Click ENABLE on the Bolt Cards tile
    • Click OPEN or the new Bolt Cards item in the left menu

    "},{"location":"lnbits/#step-5-create-bolt-card-service","title":"Step 5 - Create Bolt Card Service","text":"
    • Click the orange plus button on the Bolt Cards Extension screen

    On the card creation form:

    1. Select the LNbits wallet you created before
    2. Set a limit of satoshis per transaction (for example, 100 000)
    3. Set a limit of satoshis per day (for example, 600 000)
    4. Type a memorable name for your BoltRing
    5. Enter the NFC UID of your BoltRing
    6. Click CREATE CARD

    After clicking CREATE CARD, you should see the card service created. Click the QR Code in the first column of the list to show the QR code you need in the next step.

    After clicking the QR code symbol, you should see this card creation popup.

    Make sure you back up the keys shown below the QR code. You will need them to reset/wipe your BoltRing later. Should LNbits become unavailable, these keys will be the only way to recover/reset your BoltRing.

    Keep the popup window open; you will need to scan the shown QR code in the next step.

    "},{"location":"lnbits/#step-6-pairing-your-boltring","title":"Step 6 - Pairing Your BoltRing","text":"

    Now you will pair you BoltRing with the LNbits BoltCard Extension. Go to your mobile phone and start the Bolt Card Creator App you installed earlier. Place your BoltRing on a table, so it is ready to be paired.

    Warning

    Please make sure you go through these last steps in one go, because the QR code from the previous step will be invalidated when you scan it. Make sure you position your phone above the BoltRing at the correct place in a steady fashion and long enough for the pairing to complete. If you close the App before writing the pairing data to the BoltRing, you must start over from step 5 and create a new card service entry.

    TIPS: NFC chip writing

    Important: If writing to the BoltRing NFC chip is interruped you may end up with a bricked device. Be sure to:

    • Remove any cover or shell from your phone before configuring your BoltRing.
    • Find out where the NFC chip antenna is positioned in your phone (using read tests).
    • Put the BoltRing on a table and and the phones antenna on top it in a stable position.
    • Wait a few seconds after writing before moving your phone.

    If you are using an iPhone, put it on top of the BoltRing as shown on this image before hitting the Write Card Now button.

    1. Go to the start screen of the Bolt Card Creator app
    2. On the start screen, tap SCAN QR CODE and scan the LNbits card creation QR code
    3. Put your phones antenna on top of the BoltRing in a stable position
    4. Tap \"WRITE CARD NOW\"
    5. Verify that the app Output section shows all the green checkmarks

    Congratulations, your BoltRing is now ready for use.

    "},{"location":"merchant-compatibility/","title":"BoltRing Merchant Compatibility","text":"

    The BoltRing compatible with the open LUD-17 LNURLW standard. The following wallets and point-of-sales systems support accepting BoltRing payments:

    "},{"location":"merchant-compatibility/#self-hosted","title":"Self-Hosted","text":""},{"location":"merchant-compatibility/#breez-mobile","title":"Breez Mobile","text":"

    The Breez Mobile app for Android and iPhone offers simple non-custodial Point-of-Sale functionality, including the possibility to accept Lightning NFC payments.

    Breez Mobile

    "},{"location":"merchant-compatibility/#btcpay-server","title":"BTCPay Server","text":"

    BTCPay Server is a comprehensive self-hosted, open-source Bitcoin payment processor. The LNURL NFC plugin supports NFC payments for the included Point-of-Sale app.

    BTCPay Server

    "},{"location":"merchant-compatibility/#lnbits-tpos","title":"LNbits TPoS","text":"

    LNbits is a free, open-source Lightning account system. It comes with the TPoS extension, a Point-of-Sales app that supports Lightning NFC payments.

    LNbits TPoS

    "},{"location":"merchant-compatibility/#custodial","title":"Custodial","text":""},{"location":"merchant-compatibility/#wallet-of-satoshi","title":"Wallet Of Satoshi","text":"

    Wallet of Satoshi is a popular and easy to use custodial wallet for Android and iPhonnes. The latest version comes with dedicated point-of-sale functionality for merchants that supports NFC payments.

    Wallet of Satoshi

    "},{"location":"merchant-compatibility/#coincorner-checkout","title":"CoinCorner Checkout","text":"

    CoinCorner Checkout is a hosted bitcoin payment solution for merchants and other businesses. Their Point-of-Sale mobile app supports Lightning NFC payments.

    CoinCorner Checkout

    "},{"location":"video-tutorials/","title":"Bitcoin BoltRing Video Tutorials","text":""},{"location":"video-tutorials/#unveiling-the-bitcoin-bolt-ring-tap-and-pay-instantly","title":"Unveiling the Bitcoin Bolt Ring: Tap And Pay Instantly!","text":"

    This video by BTC Session will walk through setting up and using your BoltRing with and LNbits service. We couldn\u00b4t have done this any better!

    "}]} \ No newline at end of file diff --git a/sitemap.xml b/sitemap.xml index 0a3f918..4a05da7 100755 --- a/sitemap.xml +++ b/sitemap.xml @@ -2,37 +2,37 @@ https://docs.bolt-ring.com/ - 2024-03-16 + 2024-07-16 daily https://docs.bolt-ring.com/boltring-app/ - 2024-03-16 + 2024-07-16 daily https://docs.bolt-ring.com/boltring-reset/ - 2024-03-16 + 2024-07-16 daily https://docs.bolt-ring.com/getting-started/ - 2024-03-16 + 2024-07-16 daily https://docs.bolt-ring.com/lnbits/ - 2024-03-16 + 2024-07-16 daily https://docs.bolt-ring.com/merchant-compatibility/ - 2024-03-16 + 2024-07-16 daily https://docs.bolt-ring.com/video-tutorials/ - 2024-03-16 + 2024-07-16 daily \ No newline at end of file diff --git a/sitemap.xml.gz b/sitemap.xml.gz index 81a1062..8f95566 100755 Binary files a/sitemap.xml.gz and b/sitemap.xml.gz differ diff --git a/video-tutorials/index.html b/video-tutorials/index.html index 653d650..706561b 100755 --- a/video-tutorials/index.html +++ b/video-tutorials/index.html @@ -639,5 +639,7 @@

    Unveiling the Bit - + \ No newline at end of file