WIP Transfer Native Cryptocurrency

In this tutorial, we will walk you through the process of transferring native cryptocurrency between two wallets using the Eniblock SDK.

Overview

Creating a wallet using the Eniblock SDK is a straightforward process that involves instantiating the SDK, creating a new wallet instance, and managing the accounts within the wallet.

1. Login (responsibility of the application creator): Your customer accesses your decentralized application (dApp) and "Login" or "Sign in".
2. Transfer cryptocurrency (responsibility of the application creator): The customer sends some cryptocurrency, entering the recipient's wallet address, the amount of cryptocurrency to send, and any additional transaction details (e.g., fees). The user confirms the transaction details and proceeds to the next step.
3. Load secret share (responsibility of Eniblock): The application securely retrieves the user's secret share from their chosen cloud storage provider. The secret share is temporarily loaded into the application to apply the transaction signing process (cf Store and retrieve a Wallet).
4. Check identity (responsibility of Eniblock): Eniblock services verify the identity of the end-user based on the authentication performed by your IDP
5. Generate the (TSS) signature (responsibility of Eniblock): Upon the user's initiation of the transaction, the user's secret share, combined with the shares of Eniblock, is used to create a valid signature without revealing the complete private key.
6. Submit transaction (responsibility of the application creator): The application submits the signed transaction to the relevant blockchain network for processing and confirmation. The user receives a notification about the transaction status and can monitor the progress within the wallet interface (cf Get notified of Incoming Cryptocurrency Transactions.

Step 1 - Create a wallet

Live Editor

const sdk = new Eniblock({ authConfig: { clientId: "50efd4aa-2aa1-499c-87e2-db089409b818", redirectUrl: window.location.origin + "/docs/", }, storageItems: [{ alias: "LocalStorage", storage: new LocalStorage() }], }); const account = await wallet.account.instantiate("My first account"); 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}`);

const sdk = new Eniblock({
  authConfig: {
      clientId: "50efd4aa-2aa1-499c-87e2-db089409b818",
      redirectUrl: window.location.origin + "/docs/",
  },
    storageItems: [{ alias: "LocalStorage", storage: new LocalStorage() }],
});

const account = await wallet.account.instantiate("My first account");

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}`);

Step 2 - Top up the wallet

To top up your wallet:

1. Run the code of the Step 1 section and collect the address of the wallet.
2. Follow this FAQ entry: How to top up a wallet on the Polygon Testnet?

Step 3 - Check the balance

Verify the balance of your account. After topping up the wallet, you will have the ability to send MATIC tokens.

Live Editor

const sdk = new Eniblock({ authConfig: { clientId: "50efd4aa-2aa1-499c-87e2-db089409b818", redirectUrl: window.location.origin + "/docs/", }, storageItems: [{ alias: "LocalStorage", storage: new LocalStorage() }], }); const account = await wallet.account.instantiate("My first account"); console.log(`Getting account ${await account.getAddress()} balance...`); const tokenBalance = await account.getNativeBalance(); console.log(`> ${tokenBalance.amount} ${tokenBalance.symbol}`);

const sdk = new Eniblock({
  authConfig: {
      clientId: "50efd4aa-2aa1-499c-87e2-db089409b818",
      redirectUrl: window.location.origin + "/docs/",
  },
    storageItems: [{ alias: "LocalStorage", storage: new LocalStorage() }],
});

const account = await wallet.account.instantiate("My first account");

console.log(`Getting account ${await account.getAddress()} balance...`);
const tokenBalance = await account.getNativeBalance();

console.log(`> ${tokenBalance.amount} ${tokenBalance.symbol}`);

Step 4 - Send crypto currency and get confirmation

Here we retrieve the wallet, build a transfer transaction, send it and wait for a notification that confirms it is mined. Indeed, a transaction must be mined (i.e. integrated into the blockchain) with enough confirmation blocks to be considered as effective.

Live Editor

// We retrieve the wallet const sdk = new Eniblock({ authConfig: { clientId: "50efd4aa-2aa1-499c-87e2-db089409b818", redirectUrl: window.location.origin + "/docs/", }, storageItems: [{ alias: "LocalStorage", storage: new LocalStorage() }], }); const account = await wallet.account.instantiate("My first account"); console.log(`Getting account ${await account.getAddress()} balance...`); const balance = await account.getNativeBalance(); console.log(`> ${balance.amount} ${balance.symbol}`); // Define the transaction parameters // This example will send 0.001 MATIC to this address: https://mumbai.polygonscan.com/address/0x31a663F562b150Ed6758856021E16F621b2376B9 const txParams = { to: "0x31a663F562b150Ed6758856021E16F621b2376B9", type: "MATIC", value: "0.001", }; console.log(`Sending ${txParams.value} ${txParams.type} to ${txParams.to}. Please wait...`); try { // Sending 0.001 MATIC to 0x31a663F562b150Ed6758856021E16F621b2376B9 const { txDetails, txResponse, txReceipt } = await account.buildTransfer(txParams).send({waitingBlockUntil: "PENDING"}); console.log(`Transaction details: Transaction hash: ${txDetails.hash} Status: ${txDetails.status} Timestamp: ${txResponse.timestamp} From: ${txDetails.from} To: ${txDetails.to} Value: ${txDetails.value} MATIC ------------- Confirmations: ${txResponse.confirmations} `); console.log(`Waiting to be notified... \n`); const listener = async (str) => { console.log(JSON.stringify(str)); if(str.content.hash == txDetails.hash){ console.log(`\n Transaction ${txDetails.hash} mined!`); console.log(`Getting account ${await account.getAddress()} balance...`); const balance = await account.getNativeBalance(); console.log(`> ${balance.amount} ${balance.symbol}`); } } const notification = new eniblock.Notification(txParams.to); notification.on(eniblock.EVENT_NOTIFICATION_RECEIVED, listener); } catch (error) { console.log(`Transaction failed!!!`); console.log(error); }

// We retrieve the wallet
const sdk = new Eniblock({
  authConfig: {
      clientId: "50efd4aa-2aa1-499c-87e2-db089409b818",
      redirectUrl: window.location.origin + "/docs/",
  },
    storageItems: [{ alias: "LocalStorage", storage: new LocalStorage() }],
});
const account = await wallet.account.instantiate("My first account");

console.log(`Getting account ${await account.getAddress()} balance...`);
const balance = await account.getNativeBalance();
console.log(`> ${balance.amount} ${balance.symbol}`);

// Define the transaction parameters
// This example will send 0.001 MATIC to this address: https://mumbai.polygonscan.com/address/0x31a663F562b150Ed6758856021E16F621b2376B9
const txParams = {
  to: "0x31a663F562b150Ed6758856021E16F621b2376B9",
  type: "MATIC",
  value: "0.001",
};

console.log(`Sending ${txParams.value} ${txParams.type} to ${txParams.to}. Please wait...`);
try {
  // Sending 0.001 MATIC to 0x31a663F562b150Ed6758856021E16F621b2376B9
  const { txDetails, txResponse, txReceipt } = await account.buildTransfer(txParams).send({waitingBlockUntil: "PENDING"});

  console.log(`Transaction details:
    Transaction hash: ${txDetails.hash}
    Status: ${txDetails.status}
    Timestamp: ${txResponse.timestamp}
    From: ${txDetails.from}
    To: ${txDetails.to}
    Value: ${txDetails.value} MATIC
    -------------
    Confirmations: ${txResponse.confirmations}

  `);

  console.log(`Waiting to be notified... \n`);


  const listener = async (str) => {
    console.log(JSON.stringify(str));
    if(str.content.hash == txDetails.hash){
      console.log(`\n Transaction ${txDetails.hash} mined!`);

      console.log(`Getting account ${await account.getAddress()} balance...`);
      const balance = await account.getNativeBalance();
      console.log(`> ${balance.amount} ${balance.symbol}`);
    }
  }
  const notification = new eniblock.Notification(txParams.to);
  notification.on(eniblock.EVENT_NOTIFICATION_RECEIVED, listener);

} catch (error) {
  console.log(`Transaction failed!!!`);
  console.log(error);
}

API References

1. Eniblock class
2. Wallet namespace
3. Wallet class
4. Account namespace
5. Account class
6. Account address
7. Account getNativeBalance
8. BalanceResult
9. Account.buildTransfer() method
10. TransferParams type
11. NativeTransferParams interface
12. TransactionExecutor class
13. TransactionExecutor.estimate() method
14. EstimateResult interface
15. TransactionExecutor.send() method
16. Ethers TransactionResponse class