Skip to content

Account storage

Silkaj features the account storage to store and read security-wise important documents from a location on your local computer. It is used to store and read authentication and revocation files with Silkaj. It is recommended to use the storage instead of storing and reading these files anywhere on your system.

They are stored into $XDG_DATA_HOME/silkaj, aka $HOME/.local/share/silkaj/$currency/$account_name as:

  • revocation.txt
  • authentication_file_ed25519.dewif for v1 WIF and EWIF formats based on the approved RFC n°13.
  • authentication_file_sr25519.json for v2 encrypted json format

The account name is a local name given to a wallet. It does not necessarily need to be the same identity username stored into the blockchain. No verification what so ever is performed to check any correspondence between the local name stored into Silkaj account storage and the one stored on the blockchain or the indexer.

Per currency storage

The storage is organized per currencies. Depending on the specified endpoint with the endpoint options (--endpoint, --gtest) the currency will be determined. Based on the latter, it will be stored into g1 or g1-test directory.

Authentication

Import

Import your authentication file into the storage. In case you want to use an other authentication method than the default Scrypt method, use one of the authentication options which can be find in silkaj authentication --help usage.

Next command will store the authentication file in $HOME/.local/share/silkaj/g1/test/authentication_file_ed25519.dewif

silkaj --account test authentication <authentication option>

Note: g1 and test folders come respectively from the default Ğ1 endpoint and test from the name of the passed account.

Reading

Commands using authentication such as money transfer, wot certify, wot membership, and money balance will read the authentication file from the account storage. With the general --account option, it will use the authentication file created in previous step.

silkaj --account test money transfer

Revocation

Input/Output

The general --account option (placed between silkaj and the sub-command) is used to read the authentication file and to write the revocation file in the same directory.

silkaj --account test authentication

Creation

silkaj --gtest --account john wot revocation create

Will be stored into $HOME/.local/share/silkaj/g1-test/john/revocation.txt

Reading

The revocation document can be read with wot revocation publish and verify commands as follow:

silkaj --gtest --account john wot revocation verify

Here we are reading the revocation file generated in previous step.