From 0975452ef5f93865a82175e6cd1be2243c17dd73 Mon Sep 17 00:00:00 2001 From: Coco Tang Date: Fri, 10 Dec 2021 09:33:07 -0800 Subject: [PATCH 1/6] add maker app details, updates words, adds sending HNT to maker account warning --- .../burn-hnt-to-maker-wallet.mdx | 6 +++ .../hotspot-integration-testing.mdx | 52 +++++++++++-------- 2 files changed, 37 insertions(+), 21 deletions(-) diff --git a/docs/mine-hnt/full-hotspots/become-a-maker/burn-hnt-to-maker-wallet.mdx b/docs/mine-hnt/full-hotspots/become-a-maker/burn-hnt-to-maker-wallet.mdx index b82e0041c..2e0560ee3 100644 --- a/docs/mine-hnt/full-hotspots/become-a-maker/burn-hnt-to-maker-wallet.mdx +++ b/docs/mine-hnt/full-hotspots/become-a-maker/burn-hnt-to-maker-wallet.mdx @@ -76,3 +76,9 @@ $ helium-wallet burn --amount 10,000 --payee 138LbePH4r7hWPuTnK6HXVJ8ATM2QU71iVH ``` When this runs, you'll be asked to supply the passphrase for your HNT wallet. If this is correct, and you have enough HNT to pay for the specified burn amount, it will succeed. + +:::warning + +Do not send HNT into your Maker accounts. Doing so may result in lost funds. All Makers are required to pay for the onboarding fees for their customers. + +::: \ No newline at end of file diff --git a/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx b/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx index ac2f3bc2f..f78eeea80 100644 --- a/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx +++ b/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx @@ -8,17 +8,39 @@ slug: /mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing import useBaseUrl from "@docusaurus/useBaseUrl"; -This guide is intended for companies that have been approved via HIP19, or are considering submitting an application. +This guide is intended for companies that have been approved via HIP19 and successfully passed the hardware audit stage. -## Hotspot App Compatibility +(New) By March 1, 2022, all Makers and prospective makers are required to develop and make available to their customers, their own mobile app. This allows Makers to create new and differentiating features for their customers and Hotspots. Examples can include detailed diagnostics reports, notifications of status changes, peer address reporting, Proof-of-Coverage tips and improvements, and better troubleshooting and customer support access. + +To make the transition easier, a [Maker Starter App](https://github.com/helium/maker-starter-app) is available for anyone to fork and modify. + +The Helium app will continue to support HNT / Wallet functions, such as sending payments, receiving payments, and burn HNT. + +## Starter App features +* Supports deeplinking and transaction signing through the Helium app + * Simply put: users of the Maker app will not need to sign in with their 12 words, as long as they are signed in with the Helium app +* Hotspot onboarding with Bluetooth +* Hotspot onboarding with QR Code +* Setting Wi-Fi credentials for Hotspots onboarded with Bluetooth +* Assert Location (Bluetooth and QR Code) +* Generating any required transactions for the Helium app to sign (`add_gateway`, `assert_location`, `transfer_hotspot_v2`) +* Submit signed transactions to the blockchain +* A settings menu with PIN code, language selector, and the linked Helium address displayed +* Light and Dark mode For optimal user experience, we recommend Hotspots be equipped with compatible Bluetooth and Wi-Fi functionality. This allows a seamless onboarding experience. This integration guide will walk through both Bluetooth onboarding and QR code/Web onboarding (to support Hotspots without Bluetooth radios) +## Using the Maker Starter App +Instructions to run the Maker Starter app locally on your computer is provided on the README in the GitHub repo. The app is written in React Native and supports both iOS and Android devices. + +Support for any other operating system will not be available. + +## [Deprecated] Hotspot App Compatibility + To add your Hotspot to the Hotspot App, follow the [Maker Guide](https://github.com/helium/hotspot-app/tree/main/src/makers) in GitHub and [submit a pull request to the Hotspot Github Repo](https://github.com/helium/hotspot-app). In this codebase, you’ll want to modify the onboarding flow to add a UI element that enables users to select your Hotspot type on this screen, add support emails to Diagnostic Reports (Bluetooth only), add additional onboarding instructions (web/QR) and include default antenna TX/RX gain: - :::info Product names on this page should follow [Helium branding guidelines](https://www.helium.com/brand) and image assets must conform with existing user experience. If you require help, please reach out to the Helium team. @@ -48,17 +70,17 @@ To select QR Onboarding, in the `hotspot.ts` file, specify `QR` in `onboardType` ## Web Onboarding -Web Onboarding allows Makers to generate a partial `add_gateway` transaction outside of the Helium App. Makers generate a deep link back to the Helium App to finish the `add_gateway` transaction. [Read more about deep linking](https://docs.helium.com/wallets/app-wallet/deep-links-and-qr-codes/). +Web Onboarding allows Makers to generate a partial `add_gateway` transaction outside of the Maker App. Makers generate a deep link back to the Helium App/Maker App to finish the `add_gateway` transaction. [Read more about deep linking](https://docs.helium.com/wallets/app-wallet/deep-links-and-qr-codes/). -To select Web onboarding, in the `hotspot.ts` file, specify `web` in `onboardType`. [View the example in GitHub](https://github.com/helium/hotspot-app/blob/bbcf058844965e6501295643b95021b6ef26b280/src/makers/__example__/hotspots.ts#L41) +To select Web onboarding, in the `hotspot.ts` file, specify `web` in `onboardType`. [View the example in the Maker Starter app](https://github.com/helium/maker-starter-app/blob/main/src/makers/example/hotspots.ts).[(Deprecated) View the example in the Helium App](https://github.com/helium/hotspot-app/blob/bbcf058844965e6501295643b95021b6ef26b280/src/makers/__example__/hotspots.ts#L41) ## Bluetooth Pairing -The Helium Hotspot App will start scanning for broadcasting Hotspots. Makers will need to update the `localname` with the product name and include the last 6 digits of the MAC identifier. The character limit is 170 but we do not recommend anyone go beyond 25-30 characters in the product name. +The Maker App will start scanning for broadcasting Hotspots. Makers will need to update the `localname` with the product name and include the last 6 digits of the MAC identifier. The character limit is 170 but we do not recommend anyone go beyond 25-30 characters in the product name. The `localname` is the name used on the **Found Hotspots** page. -To select Bluetooth onboarding, in the `hotspot.ts` file, specify `BLE` in `onboardType`. [View the example in GitHub](https://github.com/helium/hotspot-app/blob/bbcf058844965e6501295643b95021b6ef26b280/src/makers/__example__/hotspots.ts#L8). +To select Bluetooth onboarding, in the `hotspot.ts` file, specify `BLE` in `onboardType`. [View the example in the Maker Starter App](https://github.com/helium/maker-starter-app/blob/f15a887afead44f2c0bba6ac7460cffebe02dc03/src/makers/example/hotspots.ts#L6)[(Deprecated) View the example the Helium app](https://github.com/helium/hotspot-app/blob/bbcf058844965e6501295643b95021b6ef26b280/src/makers/__example__/hotspots.ts#L8). [Read more about BLE Services](/mine-hnt/full-hotspots/become-a-maker/hotspot-ble-services). @@ -83,7 +105,7 @@ For testing, you'll set `payer` as `payer = 138LbePH4r7hWPuTnK6HXVJ8ATM2QU71iVHz When testing with this `payer` address, adding hotspots and asserting location transactions will be submitted and you’ll see them as pending transactions in the Hotspot App. However, once it reaches the blockchain, the transaction will be discarded as the payer address does not exist in the blockchain’s `chain_var` of valid addresses. This ensures no Data Credits are spent on testing, but allows trial and error as Makers finish app integration. -Once submitted, you can view the pending transaction using this API: +Once you have the transaction, you will pass it onto the Helium app to sign the transaction. Once submitted, you can view the pending transaction using this API: * [https://api.helium.io/v1/accounts/138LbePH4r7hWPuTnK6HXVJ8ATM2QU71iVHzLTup1UbnPDvbxmr/pending_transactions](https://api.helium.io/v1/accounts/138LbePH4r7hWPuTnK6HXVJ8ATM2QU71iVHzLTup1UbnPDvbxmr/pending_transactions) @@ -135,19 +157,7 @@ Maker IDs are sequential and cannot be customized. ## Funding the Maker Account -In order to fund the Maker account, you’ll need to [create a CLI wallet](https://github.com/helium/helium-wallet-rs). Once created, fund this wallet with HNT and use this HNT to produce Data Credits for your Hotspots. For each Hotspot onboarded, the [transaction fees](/blockchain/transaction-fees#transaction-fee-schedule) are as follows: - -* **Add Gateway**: `4000000 DCs` -* **Assert Location**: `1000000 DCs` - -The `payee` in the burn transaction will be your Maker account. This is where the Data Credits will be deposited. - -:::warning - -Remember, Data Credits are NON-TRANSFERABLE. Triple check that the `payee` address is your correct `maker` address. - -::: - +[Read the guide](https://docs.helium.com/mine-hnt/full-hotspots/become-a-maker/burn-hnt-to-maker-wallet) for more information. ## Adding Hotspots to the Onboarding Server From ccb21ba887e09f87444a0eac03a29e7744376418 Mon Sep 17 00:00:00 2001 From: Coco Tang Date: Fri, 10 Dec 2021 09:40:39 -0800 Subject: [PATCH 2/6] clean up --- .../hotspot-integration-testing.mdx | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx b/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx index f78eeea80..7f3d04eac 100644 --- a/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx +++ b/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx @@ -12,6 +12,8 @@ This guide is intended for companies that have been approved via HIP19 and succe (New) By March 1, 2022, all Makers and prospective makers are required to develop and make available to their customers, their own mobile app. This allows Makers to create new and differentiating features for their customers and Hotspots. Examples can include detailed diagnostics reports, notifications of status changes, peer address reporting, Proof-of-Coverage tips and improvements, and better troubleshooting and customer support access. +**Makers actively going through the HIP-19 process can continue to use the Helium app but are expected to develop their own Maker app by March 1, 2022.** + To make the transition easier, a [Maker Starter App](https://github.com/helium/maker-starter-app) is available for anyone to fork and modify. The Helium app will continue to support HNT / Wallet functions, such as sending payments, receiving payments, and burn HNT. @@ -35,7 +37,13 @@ Instructions to run the Maker Starter app locally on your computer is provided o Support for any other operating system will not be available. -## [Deprecated] Hotspot App Compatibility +## Hotspot App Integration + +:::info + +Makers in the HIP-19 process can continue to submit their Hotspots to the Hotspot App for integration. However, all active Makers by March 1, 2022 must have their own Maker app available on App Stores. + +::: To add your Hotspot to the Hotspot App, follow the [Maker Guide](https://github.com/helium/hotspot-app/tree/main/src/makers) in GitHub and [submit a pull request to the Hotspot Github Repo](https://github.com/helium/hotspot-app). @@ -53,7 +61,7 @@ Product names on this page should follow [Helium branding guidelines](https://ww QR Code Onboarding allows Makers to generate a partial `add_gateway` transaction outside of the Helium App. Users use the camera in the Helium App to add this type of Hotspot. -To select QR Onboarding, in the `hotspot.ts` file, specify `QR` in `onboardType`. [View the example in GitHub](https://github.com/helium/hotspot-app/blob/bbcf058844965e6501295643b95021b6ef26b280/src/makers/__example__/hotspots.ts#L41) or [read more about generating QR codes](https://docs.helium.com/wallets/app-wallet/deep-links-and-qr-codes/). +To select QR Onboarding, in the `hotspot.ts` file, specify `QR` in `onboardType`. [View the example in the Maker Starter app](https://github.com/helium/maker-starter-app/blob/f15a887afead44f2c0bba6ac7460cffebe02dc03/src/makers/example/hotspots.ts#L43)|[View the example in the Hotspot app](https://github.com/helium/hotspot-app/blob/bbcf058844965e6501295643b95021b6ef26b280/src/makers/__example__/hotspots.ts#L41) or [read more about generating QR codes](https://docs.helium.com/wallets/app-wallet/deep-links-and-qr-codes/). ### Example QR Onboarding Flow Date: Fri, 10 Dec 2021 09:51:12 -0800 Subject: [PATCH 3/6] formatting --- .../hotspot-integration-testing.mdx | 24 ++++++++++++++----- 1 file changed, 18 insertions(+), 6 deletions(-) diff --git a/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx b/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx index 7f3d04eac..adf83bd94 100644 --- a/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx +++ b/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx @@ -61,7 +61,10 @@ Product names on this page should follow [Helium branding guidelines](https://ww QR Code Onboarding allows Makers to generate a partial `add_gateway` transaction outside of the Helium App. Users use the camera in the Helium App to add this type of Hotspot. -To select QR Onboarding, in the `hotspot.ts` file, specify `QR` in `onboardType`. [View the example in the Maker Starter app](https://github.com/helium/maker-starter-app/blob/f15a887afead44f2c0bba6ac7460cffebe02dc03/src/makers/example/hotspots.ts#L43)|[View the example in the Hotspot app](https://github.com/helium/hotspot-app/blob/bbcf058844965e6501295643b95021b6ef26b280/src/makers/__example__/hotspots.ts#L41) or [read more about generating QR codes](https://docs.helium.com/wallets/app-wallet/deep-links-and-qr-codes/). +To select QR Onboarding, in the `hotspot.ts` file, specify `QR` in `onboardType`. +[View the example in the Maker Starter app](https://github.com/helium/maker-starter-app/blob/f15a887afead44f2c0bba6ac7460cffebe02dc03/src/makers/example/hotspots.ts#L43) +[View the example in the Hotspot app](https://github.com/helium/hotspot-app/blob/bbcf058844965e6501295643b95021b6ef26b280/src/makers/__example__/hotspots.ts#L41) +[Read more about generating QR codes](https://docs.helium.com/wallets/app-wallet/deep-links-and-qr-codes/) ### Example QR Onboarding Flow Date: Fri, 10 Dec 2021 09:57:10 -0800 Subject: [PATCH 4/6] spacing --- .../become-a-maker/hotspot-integration-testing.mdx | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx b/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx index adf83bd94..59adf12c2 100644 --- a/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx +++ b/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx @@ -62,6 +62,7 @@ Product names on this page should follow [Helium branding guidelines](https://ww QR Code Onboarding allows Makers to generate a partial `add_gateway` transaction outside of the Helium App. Users use the camera in the Helium App to add this type of Hotspot. To select QR Onboarding, in the `hotspot.ts` file, specify `QR` in `onboardType`. + [View the example in the Maker Starter app](https://github.com/helium/maker-starter-app/blob/f15a887afead44f2c0bba6ac7460cffebe02dc03/src/makers/example/hotspots.ts#L43) [View the example in the Hotspot app](https://github.com/helium/hotspot-app/blob/bbcf058844965e6501295643b95021b6ef26b280/src/makers/__example__/hotspots.ts#L41) [Read more about generating QR codes](https://docs.helium.com/wallets/app-wallet/deep-links-and-qr-codes/) @@ -85,6 +86,7 @@ Web Onboarding allows Makers to generate a partial `add_gateway` transaction out [Read more about deep linking](https://docs.helium.com/wallets/app-wallet/deep-links-and-qr-codes/). To select Web onboarding, in the `hotspot.ts` file, specify `web` in `onboardType`. + [View the example in the Maker Starter app](https://github.com/helium/maker-starter-app/blob/main/src/makers/example/hotspots.ts) [View the example in the Hotspot App](https://github.com/helium/hotspot-app/blob/bbcf058844965e6501295643b95021b6ef26b280/src/makers/__example__/hotspots.ts#L41) @@ -95,6 +97,7 @@ The Maker App will start scanning for broadcasting Hotspots. Makers will need to The `localname` is the name used on the **Found Hotspots** page. To select Bluetooth onboarding, in the `hotspot.ts` file, specify `BLE` in `onboardType`. + [View the example in the Maker Starter App](https://github.com/helium/maker-starter-app/blob/f15a887afead44f2c0bba6ac7460cffebe02dc03/src/makers/example/hotspots.ts#L6) [View the example the Hotspot app](https://github.com/helium/hotspot-app/blob/bbcf058844965e6501295643b95021b6ef26b280/src/makers/__example__/hotspots.ts#L8) [Read more about BLE Services](/mine-hnt/full-hotspots/become-a-maker/hotspot-ble-services). @@ -190,9 +193,13 @@ When you’re ready to start integration with the Test Maker account with the mo ``` `"mac_eth0": ` Ethernet MAC address + `"mac_wlan0": ` Wi-Fi MAC address + `"heliumSerial": ` Serial number for first generation Helium Hotspots. Can be ignored. + `"onboarding_key":` The onboarding key generated from the Hotspot miner in base58. Required. + `"rpi_serial": ` Serial number for the RaspberryPi. Can be repurposed to track your own serial number. ### Production From 8027efdcd7ff187cdbe18c869e61cd3cfbbb2309 Mon Sep 17 00:00:00 2001 From: Coco Tang Date: Fri, 10 Dec 2021 10:01:02 -0800 Subject: [PATCH 5/6] one more try --- .../hotspot-integration-testing.mdx | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx b/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx index 59adf12c2..f43b5fe85 100644 --- a/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx +++ b/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx @@ -63,9 +63,9 @@ QR Code Onboarding allows Makers to generate a partial `add_gateway` transaction To select QR Onboarding, in the `hotspot.ts` file, specify `QR` in `onboardType`. -[View the example in the Maker Starter app](https://github.com/helium/maker-starter-app/blob/f15a887afead44f2c0bba6ac7460cffebe02dc03/src/makers/example/hotspots.ts#L43) -[View the example in the Hotspot app](https://github.com/helium/hotspot-app/blob/bbcf058844965e6501295643b95021b6ef26b280/src/makers/__example__/hotspots.ts#L41) -[Read more about generating QR codes](https://docs.helium.com/wallets/app-wallet/deep-links-and-qr-codes/) +* [View the example in the Maker Starter app](https://github.com/helium/maker-starter-app/blob/f15a887afead44f2c0bba6ac7460cffebe02dc03/src/makers/example/hotspots.ts#L43) +* [View the example in the Hotspot app](https://github.com/helium/hotspot-app/blob/bbcf058844965e6501295643b95021b6ef26b280/src/makers/__example__/hotspots.ts#L41) +* [Read more about generating QR codes](https://docs.helium.com/wallets/app-wallet/deep-links-and-qr-codes/) ### Example QR Onboarding Flow Date: Fri, 10 Dec 2021 10:10:33 -0800 Subject: [PATCH 6/6] Update docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx Co-authored-by: Mark Phillips --- .../become-a-maker/hotspot-integration-testing.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx b/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx index f43b5fe85..9714b2698 100644 --- a/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx +++ b/docs/mine-hnt/full-hotspots/become-a-maker/hotspot-integration-testing.mdx @@ -10,7 +10,7 @@ import useBaseUrl from "@docusaurus/useBaseUrl"; This guide is intended for companies that have been approved via HIP19 and successfully passed the hardware audit stage. -(New) By March 1, 2022, all Makers and prospective makers are required to develop and make available to their customers, their own mobile app. This allows Makers to create new and differentiating features for their customers and Hotspots. Examples can include detailed diagnostics reports, notifications of status changes, peer address reporting, Proof-of-Coverage tips and improvements, and better troubleshooting and customer support access. +(New) By March 1, 2022, all Makers and prospective makers are required to develop, and make available to their customers, their own mobile app. This allows Makers to create new and differentiating features for their customers and Hotspots. Examples can include detailed diagnostics reports, notifications of status changes, peer address reporting, Proof-of-Coverage tips and improvements, and better troubleshooting and customer support access. **Makers actively going through the HIP-19 process can continue to use the Helium app but are expected to develop their own Maker app by March 1, 2022.**