Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updated several subsections under Solana Migration Guides #1860

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 23 additions & 22 deletions docs/architecture/solana/migration-faq.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,42 +12,43 @@ slug: /solana/migration-faq

## Why Does My Account Have A Small Amount Of SOL?

Every migrated Wallet was seeded with a small amount, approximately 0.00139 SOL for
transactions, enough for roughly 100 transactions. The amount of SOL needs to be topped up and it is
recommended topping up with 0.1 and keeping it above 0.02 SOL. If the balance is between 0.01 and
0.001 SOL then transactions attempted on the blockchain may fail due to lack of funds.
Every migrated Wallet was seeded with a small amount, approximately 0.00139 SOL for transactions,
enough for roughly 100 transactions. The amount of SOL needs to be topped up and it is recommended
topping up with 0.1 and keeping it above 0.02 SOL. If the balance is between 0.01 and 0.001 SOL then
transactions attempted on the blockchain may fail due to lack of funds.

## Where Can I See My Hotspot's Activity And Rewards?

Oracle Data is available to application developers such as [Helium Geek](https://heliumgeek.com/),
[Moken](https://explorer.moken.io/), Relay[https://app.relaywireless.com/explorer] and [Hotspotty](https://app.hotspotty.net/), who have built interfaces to monitor Hotspot
activity and rewards.
Oracle Data is available to application developers such as [Helium Geek](https://heliumgeek.com/),
[Moken](https://explorer.moken.io/), Relay[https://app.relaywireless.com/explorer] and
[Hotspotty](https://app.hotspotty.net/), who have built interfaces to monitor Hotspot activity and
rewards.

## What Is The IOT Token?

Instead of earning HNT, LoRaWAN Hotspots will earn IOT rewards for their PoC and data transfer.
IOT can be swapped for HNT in the Helium Wallet app or on an exchange. Find more info about the [IOT]
(/tokens/iot-token) Token.
Instead of receiving HNT, LoRaWAN Hotspots will receive IOT rewards for their PoC and data transfer.
IOT can be swapped for HNT in the Helium Wallet app or on an exchange. Find more info about the
[IOT Token](/tokens/iot-token).

## How Do I Stake My HNT Tokens?
## How Do I Lock HNT Tokens?

Staking HNT tokens uses [Realms](https://realms.heliumvote.com/dao/hnt) and can be done in the Helium
Wallet app.
Locking HNT tokens happens on [Helium Vote](https://heliumvote.com/hnt) and can be done in the
Helium Wallet app.

More instructions are available [here](/governance/staking-with-helium-vote).
More instructions are available via this [tutorial](/governance/staking-with-helium-vote).

## How Can I Exchange Or See The Exchange Rate For My Tokens?

Here are 2 ways to do this:

1. On the home screen in the Helium Wallet App, there is an orange button for swapping tokens that
leverages the Jupiter DEX.
2. Directly using a DEX like [Jupiter](https://jup.ag) or [Orca](https://orca.so)
2. Directly using a DEX such as [Jupiter](https://jup.ag) or [Orca](https://orca.so)

:::warning

Please always check the swap or exchange rate before you confirm a transaction. You are responsible for
the confirmation of the exchange rate that is shown.
Please always check the swap or exchange rate before you confirm a transaction. You are responsible
for the confirmation of the exchange rate that is shown.

:::

Expand All @@ -59,17 +60,17 @@ Hotspots receive rewards for all the activity within an epoch as one sum.

## Is It Possible To Migrate A Wallet Without Having To Log Into The Helium Wallet App?

Yes, Wallets can be migrated directly within the Helium docs
[here](/solana/migration/exchange#mapping-helium-wallets-to-solana-wallets) using widget or by
following manual instructions.
Yes, Wallets can be migrated directly within the
[Helium docs](/solana/migration/exchange#mapping-helium-wallets-to-solana-wallets) using widget or
by following manual instructions.

Enter an old Helium address into the entry box and click the "Seed Wallet" button, give it a few
seconds, and the Wallet will be migrated over to Solana.

## Why Am I Getting The `{"Instructionerror":[0, {"Custom":1}]}` Error When I Try To Stake?
## Why Am I Getting The `{"Instructionerror":[0, {"Custom":1}]}` Error When I Try To Lock Tokens?

This error occurs when a Wallet does not have enough SOL to proceed with a transaction. For example,
a Wallet will need approximately 0.02 SOL to stake.
a Wallet will need approximately 0.02 SOL to lock tokens.

Use the [HNT-SOL Swapping widget](/tokens/sol-token) in the Helium docs to swap HNT for SOL as
needed.
Expand Down
5 changes: 1 addition & 4 deletions docs/architecture/solana/migration/application-builder.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,15 +9,12 @@ slug: /solana/migration/application-builder
---

import useBaseUrl from '@docusaurus/useBaseUrl'
import LegacyContentBanner from '@site/src/theme/LegacyContentBanner'

<LegacyContentBanner />

As an application builder on top of Helium, many of the APIs and interfaces are changing.

If you are building against Hotspots, token accounts, or anything blockchain related, you should
start with the [Primer on Solana](/solana/primer) and continue through the
[Solana docs](https://docs.solana.com/).

If you are building against the Proof of Coverage datasets, you should read through the
If you are building against the Proof-of-Coverage datasets, you should read through the
[Data-Transfer Oracles documentation](/oracles/data-transfer-oracles).
5 changes: 1 addition & 4 deletions docs/architecture/solana/migration/blockchain-etl.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,8 @@ slug: /solana/migration/blockchain-etl
---

import useBaseUrl from '@docusaurus/useBaseUrl'
import LegacyContentBanner from '@site/src/theme/LegacyContentBanner'

<LegacyContentBanner />

[Blockchain ETL](https://github.com/helium/blockchain-etl) will halt along with the blockchain
[Blockchain ETL](https://github.com/helium/blockchain-etl) has halted along with the blockchain
during the migration. Hosted instances of this service may choose to continue offering historical
data from the Helium L1 via these synced ETLs.

Expand Down
3 changes: 0 additions & 3 deletions docs/architecture/solana/migration/blockchain-node.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,6 @@ slug: /solana/migration/blockchain-node
---

import useBaseUrl from '@docusaurus/useBaseUrl'
import LegacyContentBanner from '@site/src/theme/LegacyContentBanner'

<LegacyContentBanner />

:::warning Updated for Solana Mainnet

Expand Down
3 changes: 0 additions & 3 deletions docs/architecture/solana/migration/console-operator.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,6 @@ slug: /solana/migration/console-operator
---

import useBaseUrl from '@docusaurus/useBaseUrl'
import LegacyContentBanner from '@site/src/theme/LegacyContentBanner'

<LegacyContentBanner />

Please be advised that you must upgrade your instance of Helium Console to the latest version to
ensure the continued operation of devices managed by your LNS. Failure to upgrade before the Solana
Expand Down
7 changes: 2 additions & 5 deletions docs/architecture/solana/migration/exchange.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,6 @@ slug: /solana/migration/exchange
---

import useBaseUrl from '@docusaurus/useBaseUrl'
import LegacyContentBanner from '@site/src/theme/LegacyContentBanner'

<LegacyContentBanner />

:::warning Updated for Solana Mainnet

Expand All @@ -20,7 +17,7 @@ description provided below have been updated to reflect Solana Mainnet.

:::

The Helium Network is migrating to the Solana blockchain. All Helium Network Tokens (HNT, IOT, and
The Helium Network migrated to the Solana blockchain. All Helium Network Tokens (HNT, IOT, and
MOBILE), will become [Solana SPL](https://spl.solana.com/token) tokens.

If an exchange already supports SPL tokens, follow the steps below.
Expand Down Expand Up @@ -64,7 +61,7 @@ Or continue reading for manual instructions:

### JavaScript

To get the Solana public key equivalent of a Helium public key in javascript run:
To get the Solana public key equivalent of a Helium public key in JavaScript run:

<!-- prettier-ignore -->
```javascript
Expand Down
20 changes: 7 additions & 13 deletions docs/architecture/solana/migration/governance.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,26 +9,20 @@ slug: /solana/migration/governance
---

import useBaseUrl from '@docusaurus/useBaseUrl'
import LegacyContentBanner from '@site/src/theme/LegacyContentBanner'

<LegacyContentBanner />

[Helium Vote][helium-vote] will transition to using [Solana SPL Governance Realms][realms].

While the user interface will change, the governance process will remain mostly the same.
[Helium Vote][helium-vote] will be used for Governance.

Using the Helium Wallet app, users will use an embedded browser to visit
[https://helium.vote][helium-vote], connect a Wallet, and vote yes/no on proposals. Ledger users, or
users of any other Solana Wallet, can also navigate to [https://helium.vote][helium-vote], connect a
wallet, and vote.
[https://heliumvote.com/hnt][helium-vote], connect a Wallet, and vote yes/no on proposals. Ledger
users, or users of any other Solana Wallet, can also navigate to
[https://heliumvote.com/hnt][helium-vote], connect a wallet, and vote.

---

## Governance Changes

The major change with Solana governance is that more of the Helium Network can be governed by the
Helium DAO and its subDAOS. Everything from Program (smart contract) changes to approving Makers can
now be controlled by the Helium DAO and its subDAOs.
Helium Network and its subnetworks. Everything from Program (smart contract) changes to approving
Makers can now be controlled by the Helium Network and its subnetworks.

[helium-vote]: https://helium.vote
[realms]: https://app.realms.today
[helium-vote]: https://heliumvote.com/hnt
28 changes: 12 additions & 16 deletions docs/architecture/solana/migration/hotspot-maker.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,6 @@ slug: /solana/migration/maker
---

import useBaseUrl from '@docusaurus/useBaseUrl'
import LegacyContentBanner from '@site/src/theme/LegacyContentBanner'

<LegacyContentBanner />

## Update and Add New Dependencies

Expand All @@ -32,7 +29,7 @@ import LegacyContentBanner from '@site/src/theme/LegacyContentBanner'

## Update App Providers

Apps must now be wrapped in a `<SolanaProvider>` and the `baseUrl` for `<OnboardingProvider>` has
Apps must be wrapped in a `<SolanaProvider>` and the `baseUrl` for `<OnboardingProvider>` has
changed

A Solana Provider must be set with a Solana RPC. Because Helium makes use of Compressed NFTs, there
Expand All @@ -44,7 +41,7 @@ are currently 5 RPC providers with support:
- [Shyft](https://docs.shyft.to/solana-rpcs-das-api/compression-das-api)
- [Hello Moon](https://docs.hellomoon.io/reference/rpc-endpoint-for-digital-asset-standard)

You can visit their websites and get set up with an RPC url.
You can visit their websites and get set up with an RPC URL.

```tsx
// src/App.tsx
Expand Down Expand Up @@ -81,9 +78,9 @@ useEffect(() => {

## Testing Solana Pre-Migration

Before the migration to Solana has been completed, the v2 onboarding server will be used, and
transactions will still be submitted to the Helium blockchain. To test Solana before transition, use
these variables:
Before the migration to Solana was completed, the v2 onboarding server was used, and transactions
were still be submitted to the Helium blockchain. To test Solana before transition these variables
were used:

**_IT IS CRITICALLY IMPORTANT THAT YOU ONLY USE THESE FOR TESTING._**

Expand All @@ -110,7 +107,7 @@ ONBOARDING_MAKER_NAME="Test Maker"

## Onboarding a Hotspot

When onboarding a Hotspot you must specify which `hotspotTypes` it supports (eg `iot` , `mobile`)
When onboarding a Hotspot you must specify which `hotspotTypes` it supports (e.g., `iot` , `mobile`)

You can optionally set `elevation`, `gain`, `lat`, and `lng` to avoid having to create a second
transaction.
Expand Down Expand Up @@ -155,7 +152,7 @@ setSolanaTransactions(onboardData.solanaTransactions)

## Updating a Hotspot

When updating a Hotspot you must specify which `hotspotTypes` it supports (eg `iot` , `mobile`)
When updating a Hotspot you must specify which `hotspotTypes` it supports (e.g., `iot` , `mobile`)

### Create transactions

Expand Down Expand Up @@ -259,7 +256,7 @@ useEffect(() => {

The Helium Hotspot App is deprecated, Maker Apps should link to the Helium Wallet app. Add the hook
`useCheckWalletLink()` to `src/App.tsx` It will check to see if the user is linked to the Hotspot
app and prompt them to update their link
app and prompt them to update their link.

```tsx
// src/App.tsx
Expand Down Expand Up @@ -316,9 +313,8 @@ const permissions = [
]
```

The Maker Starter is now using `react-native-permissions` to request/check permissions. If you'd
like to use the library, the setup guide can be found here:
https://github.com/zoontek/react-native-permissions
The Maker Starter uses `react-native-permissions` to request/check permissions. If you'd like to use
the library, the setup guide can be found here: https://github.com/zoontek/react-native-permissions

---

Expand All @@ -327,7 +323,7 @@ https://github.com/zoontek/react-native-permissions
:::info

Maker Wallets will need both `SOL` for transactions on the Solana blockchain and `DC` for onboarding
fees post Migration.
fees.

:::

Expand Down Expand Up @@ -367,7 +363,7 @@ For more insight to the amount of SOL needed, check out

### Maker Wallet DC

Maker Wallets will need `DC` to pay Helium onboarding and assert fees. DC can be acquired by either
Maker Wallets will need `DC` to pay Helium onboarding and assert fees. DC can be acquired by either:

- Depositing DC into the Maker Wallet on the current Helium L1.
- Use the Helium Wallet app to swap HNT for DC.
Expand Down
Loading