Store a Wallet on a Remote Drive

This section of the documentation focuses on the importance of storing a wallet.

Overview

During the development of a web application that incorporates a wallet, you can choose to store it in the browser's local storage. This default storage approach makes the implementation of the wallet easier for developers, thus streamlining the testing process and the development of new features.

Risks of Storing a Wallet in a Web Browser's Local Storage

However, it is crucial to understand that this method of storing the wallet in local storage MUST NOT be used in a production environment. Local storage does not provide the necessary security measures to protect sensitive data such as wallet keys share and can be easily lost if the browser cache is cleared.

For a production application, it is highly recommended to use a more reliable storage method, such as a remote drive (e.g., Google Drive or Dropbox). These remote storage solutions provide robust security features, data encryption, and backup options, ensuring the safety and accessibility of the wallet data.

Storing a Wallet

In this code snippet, we demonstrate how to set up and utilize the SDK for storing a wallet. The script initiates the SDK with a provided client ID, stores the wallet to the user's Google Drive. This serves as a foundation example for developers who are looking to build and manage a wallet using the SDK.

Live Editor

// Instantiate the SDK with user and owner information. // The Wallet will be stored in the Google Drive account of the end user. // Here, replace the "240775764401-..." Client ID with yours const sdk = new Eniblock({ authConfig: { clientId: "50efd4aa-2aa1-499c-87e2-db089409b818", redirectUrl: window.location.origin + "/docs/", }, storageItems: [ { alias: 'drive', storage: new GoogleDrive("240775764401-1p1i5f7fjn9cdq5hk68trlck3mn3aevg.apps.googleusercontent.com") } ] }); console.log(`Creating or retrieving the wallet from Google Drive...`); try { // Create or retrieve a wallet using the Wallet Namespace. // This code either creates a new wallet instance or retrieves an existing one within the SDK. // You can now manage the accounts associated with this wallet. const wallet = await sdk.wallet.instantiate(); // Create a new account within the wallet using the Account Namespace. // Replace "My first account" with a custom alias for the account. const account = await wallet.account.instantiate("My first account"); // Display the account details. console.log(`Account Details: - Address: ${await account.getAddress()} - Alias: ${account.alias} - Balance: ${(await account.getNativeBalance()).amount} - Public Key: ${await account.getPublicKey()} - Creation Date: ${account.creationDate}`); } catch (error) { console.log(JSON.stringify(error)); }

// Instantiate the SDK with user and owner information.
// The Wallet will be stored in the Google Drive account of the end user.
// Here, replace the "240775764401-..." Client ID with yours
const sdk = new Eniblock({
  authConfig: {
      clientId: "50efd4aa-2aa1-499c-87e2-db089409b818",
      redirectUrl: window.location.origin + "/docs/",
  },
  storageItems: [
    {
      alias: 'drive',
      storage: new GoogleDrive("240775764401-1p1i5f7fjn9cdq5hk68trlck3mn3aevg.apps.googleusercontent.com")
    }
  ]
});
console.log(`Creating or retrieving the wallet from Google Drive...`);
try {
  // Create or retrieve a wallet using the Wallet Namespace.
  // This code either creates a new wallet instance or retrieves an existing one within the SDK.
  // You can now manage the accounts associated with this wallet.
  const wallet = await sdk.wallet.instantiate();

  // Create a new account within the wallet using the Account Namespace.
  // Replace "My first account" with a custom alias for the account.
  const account = await wallet.account.instantiate("My first account");

  // Display the account details.
  console.log(`Account Details:
    - Address: ${await account.getAddress()}
    - Alias: ${account.alias}
    - Balance: ${(await account.getNativeBalance()).amount}
    - Public Key: ${await account.getPublicKey()}
    - Creation Date: ${account.creationDate}`);
} catch (error) {
  console.log(JSON.stringify(error));
}

Retrieving a Wallet

Retrieving the wallet is completely transparent to the developer, as it is integrated into the instantiate method of the Wallet namespace.

References

1. Eniblock class
2. WalletNamespace.instantiate() method
3. AccountNamespace.get() method
4. Account.getAddress() method
5. Account.alias property
6. Account.getNativeBalance() method
7. Account.getPublicKey() method
8. Account.creationDate property

Store a wallet with Google Drive

Step 1: Create a Google Cloud Platform (GCP) Project

1. Visit the Google Cloud Platform Console.

2. Sign in with your Google account or create a new account if you don't have one.

3. Click on the project dropdown and select or create the project you want to use for your web app.

   Click on the project dropdown

   Create the project you want to use for your web app

   Name and save your new project

4. Select your new project

Step 2: Enable Google drive API

1. Enter in the "Enable APIS AND SERVICES" section

2. Select "Google Drive API" and enable the API

Step 3: Set Up OAuth 2.0 Consent Screen

1. Navigate to the "APIs & Services" dashboard

   From the dashboard, click on "Explore and enable APIs"

   From the dashboard, click on "Click on "Credentials."

2. Open the consent screen configuration

   Click on "Configure consent screen"

3. Select the appropriate User Type for your app

   Create your consent screen

4. Fill the consent screen configuration

   Fill all the consent screen configuration

5. Edit scopes

   Click on "ADD OR REMOVE SCOPES"

6. Add manually a new scope

   https://www.googleapis.com/auth/drive.appdata

7. Optionnaly, function of the User Type, add Test users.

Step 4: Set Up OAuth 2.0 Client IDs

1. Select Credentials

   Click on "Create credentials" and select "OAuth client ID."

2. Set the application type

   Choose "Web application" as the application type.

3. Fill in the required fields

   Such as the "Name," "Authorized JavaScript origins," and "Authorized redirect URIs."

4. Click "Create" to generate your OAuth 2.0 credentials

   Save the generated "Client ID" and "Client Secret" for later use.

Next Steps

Once you have created a wallet and added an account, you can perform various actions like checking the account balance, sending and receiving assets.