================================================================================
Account Store
================================================================================

.. list-table:: 
   :widths: auto
   :stub-columns: 1

   * - Class Name
     - AccountStore
   * - Implements
     - `KeyStoreInterface <https://github.com/evannetwork/dbcp/tree/master/src/account-store.ts>`__
   * - Extends
     - `Logger </common/logger.html>`_
   * - Extends
     - `account-store.ts <https://github.com/evannetwork/dbcp/tree/master/src/account-store.ts>`__
   * - Source
     - `account-store.ts <https://github.com/evannetwork/ui-dapp-browser/tree/develop/src/app/bcc/AccountStore.ts>`__

The `DApp Browser AccountStore <https://github.com/evannetwork/ui-dapp-browser/blob/master/src/app/bcc/AccountStore.ts>`_ is a adaption to the original `blockchain-core AccountStore <https://github.com/evannetwork/dbcp/tree/master/src/account-store.ts>`_ and overwrites the Keystore function, to handle private keys loaded from the lightwallet browser instance. Initially no keys are provided into the KeyProvider. When privateKeys are requested, the user must insert his password to unlock its lightwallet account to handle the privateKeys for signing.

The original `DApp Browser AccountStore <https://github.com/evannetwork/ui-dapp-browser/blob/master/src/app/bcc/AccountStore.ts>`_ implements the `KeyStoreInterface <https://github.com/evannetwork/dbcp/tree/master/src/account-store.ts>`_ and is a wrapper for a storage, where evan.network account ids are stored. The default `AccountStore <https://github.com/evannetwork/dbcp/tree/master/src/account-store.ts>`_ takes an account --> private key mapping as a pojo as its arguments and uses this to perform lookups, when the :ref:`getPrivateKey <db_accountstore_getPrivateKey>` function is called. This lookup needs to be done, when transactions are signed by the `InternalSigner <https://github.com/evannetwork/dbcp/tree/master/src/contracts/signer-internal.ts>`_ (see `Signer <https://github.com/evannetwork/api-blockchain-core/blob/develop/docs/blockchain/signer.rst>`_).

Note that the return value of the :ref:`getPrivateKey <db_accountstore_getPrivateKey>` function is a promise. This may not be required in the default `DBCP AccountStore <https://github.com/evannetwork/dbcp/tree/master/src/account-store.ts>`_, but this allows you to implement own implementations of the `KeyStoreInterface <https://github.com/evannetwork/dbcp/tree/master/src/account-store.ts>`_, which may enforce a more strict security behavior or are able to access other sources for private keys.

------------------------------------------------------------------------------

.. _db_accountstore_constructor:

constructor
================================================================================

.. code-block:: typescript

  new AccountStore(vault?: any);

Creates a new AccountStore instance.

----------
Parameters
----------

#. ``vault`` - ``AccountStoreOptions`` (optional): overwrite the global vault with an specific one

-------
Returns
-------

``AccountStore`` instance

-------
Example
-------

.. code-block:: typescript
  
  const accountStore = new AccountStore();

--------------------------------------------------------------------------------

.. _db_accountstore_getPrivateKey:

getPrivateKey 
=============

.. code-block:: javascript

    accountStore.getPrivateKey(accountId);

get private key for given account



----------
Parameters
----------

#. ``accountId`` - ``string``: eth accountId

-------
Returns
-------

Promise resolves to ``string``: private key for this account

-------
Example
-------

.. code-block:: javascript

    const privateKey = await runtime.accountStore.getPrivateKey('0x0000000000000000000000000000000000000002');

.. required for building markup

.. |source logLevel| replace:: ``LogLevel``
.. _source logLevel: https://github.com/evannetwork/api-blockchain-core/blob/develop/docs/common/logger.html#loglevel

.. |source logLogInterface| replace:: ``LogLogInterface``
.. _source logLogInterface: https://github.com/evannetwork/api-blockchain-core/blob/develop/docs/common/logger.html#logloginterface