• English
  • Русский

# How to Create Account / Waves Wallet

To create a Waves account, you don't need to register anywhere. To create a Waves account means to generate account key pair and address based on a secret (seed) phrase.

⚠️ Security Information

  • The secret phrase or the private key derived from it provides complete control over the account, including the ability to dispose of funds. Do not give your secret phrase and private key to anyone, and do not publish or send them.
  • The secret phrase cannot be changed: another secret phrase (even one that differs by a single character) will generate a different key pair, and therefore a different account.
  • If you lose your secret phrase and private key, you will no longer be able to access your account permanently. We strongly encourage you to write down the secret phrase on a piece of paper and store it in a safe place.
  • If the secret phrase is compromised (you have accidentally sent it to someone or suspect that it was taken by fraudsters), immediately create a new account and transfer all assets to it.

You can use one of the recommended apps to create an account:

Alternatively, you can use one of the client libraries, such as:

  • TypeScript/JavaScript library ts-lib-crypto (it is also included in waves-transactions):

    const libCrypto = require('@waves/ts-lib-crypto')

const seed = libCrypto.randomSeed() // or input your existing seed
const sk = libCrypto.privateKey(seed)
const pk = libCrypto.publicKey(seed)
const addressBase58 = libCrypto.address(seed) // address for Mainnet
const addressTestnetBase58 = libCrypto.address(seed, 'T') // address for Testnet

  • Python module Pywaves

    import pywaves as pw

# pw.setChain('testnet') # Mainnet by default

# generate a new address
myAddress = pw.Address(seed='<insert your seed here>')

print(f'Your seed:   {myAddress.seed}')
print(f'Private Key: {myAddress.privateKey}')
print(f'Public Key:  {myAddress.publicKey}')
print(f'Address:     {myAddress.address}')

  • Java library WavesJ

    String seed = Crypto.getRandomSeedPhrase();
PrivateKey privateKey = PrivateKey.fromSeed(seed);
PublicKey publicKey = PublicKey.from(privateKey);
Address address = Address.from(publicKey);

Please note:

  • An account key pair and address are generated and stored locally. No data needs to be sent to the node or anywhere else.
  • The address is immediately available for transferring tokens. In particular, it can be specified as the recipient in the Transfer transaction.
  • The address appears on the blockchain along with the first transaction in which the account participates.
  • To use your account in another application or on another device, you need to enter a secret phrase on it and repeat the key pair generation.

# How to Create Wallets for Users in Bulk?

It is bad practice to generate accounts for users centrally. Knowing the secret phrase or private key allows you to do anything on behalf of the account. It is unsafe to store and transfer this data: in addition to the abuse of confidence, there is a risk of data theft or leakage.

Each user should create their own account, and the application should obtain a user signature separately for each transaction. To do this, you can use the Signer library on your site. Signer provides the user with the ability to log into their account or create an account and then sign transactions without providing their secret phrase or private key to your app.

Account
Address