Skip to main content

Signing Into a Space

In Space Lasers, we demonstrate how LAMINA1 Hub integration will work with a simple, 2D, browser-based Space created in Unity and hosted on WebGL. For the Nyric Space, we have adapted the sign-in flow and will be testing how authentication works with a locally-run, downloadable experience. \ \ Space Lasers

To begin playing Space Lasers make sure you are logged into your LAMINA1 Hub account and have navigated to the experience from your ‘Home’ Tab on https\://hub.lamina1.com. \ \ Next, you will be prompted to sign into Space Lasers directly from the Space’s Details Page by signing a short message for the server to verify. Click on the plus sign next to ‘Details’ on the ‘Get Started’ page to pull up more information and learn more about what signing into the experience entails.\ \ As described above, signing this message authenticates you and gives Space lasers the ability to add new items to your LAMINA1 Hub account on your behalf. Once confirmed, a Session Token will be sent into the Unity experience running “Space Lasers” that will automatically grant you access to the game for a period of 24 hours. Initiating this process essentially “abstracts” your Hub account, allowing the Space to gain crucial information about you and the items you have in your inventory without exposing your Hub Account’s private keys to the experience’s developer.

If you are using Metamask, this UI flow will look/work slightly differently than pictured above, but the message and parameters are the same.

Nyric

Signing into Nyric is very similar, but with a few additional steps –– namely downloading the Space’s application, then authenticating it with a code you will receive via the LAMINA1 Hub. 

To begin playing NYRIC, make sure you are logged into your LAMINA1 Hub account and have navigated to the experience from your ‘Home’ Tab on https://hub.lamina1.com. 

Next, make sure you have reviewed the Space’s technical requirements, noting that the current Early Alpha test we are demo-ing on Betanet is available to PC users ONLY, and requires a pretty sophisticated machine and internet connection to access. \ \ If your system meets those requirements, you can then download the game by following the Installation Instructions included on the Hub and listed below:

  1. Click ‘Download’ to get the nyric.zip game package
  2. Unzip nyric.zip into any folder you prefer
  3. Open the folder and run \winGameShipping\Windows\Alpha_V1.exe to launch
  4. Press the “L1 Alpha” button in the Nyric app
  5. Click ‘Play’ above to generate your LAMINA1 Hub authentication code and paste it into the Nyric app\

This extra authentication code step ensures that your LAMINA1 Hub wallet is connected into the game before you begin playing so that you can receive items from Nyric as you complete Quests in the game. \ \ Similarly to how this works in Space Lasers, signing the authentication message (and providing a correct code once you’ve downloaded the game) authenticates you and gives Nyric the ability to add new items to your LAMINA1 Hub account on your behalf. \ \ Please note that authentication codes currently last only 5 minutes, and cannot be shared among different users. You must log in using your unique authentication code, via the account you have created on/connected to the LAMINA1 Hub.

What's Next?\ \ These authentication flows are just the first and simplest way in which you, as a developer, can integrate the Lamina1 Hub. We are conducting research now on how to further extend and simplify this onboarding process for future Spaces –– but for now, we think it’s a pretty streamlined solution to a fairly complicated Web3 permissions and authentication problem. \ \ To provide feedback or share additional ideas on this onboarding or authentication flow, fill out this feedback form.