GETTING STARTED

the xlmwallet & lumen's guide
What are Lumens?

Lumens are the native asset of the Stellar network.

Native means that lumens are built into the network. Asset is how the network refers to an item of value that is stored on the ledger.

One lumen is a unit of digital currency, like a bitcoin.
While you can’t hold a lumen in your hand, they are essential to the Stellar network—they contribute to the ability to move money around the world and to conduct
transactions between different currencies quickly and securely.

from stellar.org

What is XLM?

XLM is shorthand for lumen. Most currencies have 3-letter codes (USD, EUR, AUD, BTC) as an international standard.

from stellar.org

What is XLMwallet?

XLMwallet is a Lumens' wallet, it is used to send and receive Lumens (XLM).

How do I receive Lumens?

First, you need a wallet for this. Guess what? That's exactly what XLMwallet is!
Then, you have to generate a key pair (a public and a private key), these are used to access to your wallet.

The public key starts with a G while the secret key starts with a S

You must absolutely keep secret your private key (which is actually called secret key), if someone else has access to it, he has access to your funds!

To receive Lumens, you have to give your public key to the sender.

How do I generate a key pair?

On the wallet's page you will find a "generate a key pair" button, click the button below to access it:

to the Wallet

You must keep safe your secret key, you can for example, write it on a paper or somewhere only you know and only you can access - that key is used to access to your wallet.

If you lose/forget your key, you will never have access to your wallet again.

Where can I buy/sell XLM?

Lumens are available for purchase on several known markets and exchanges.

Please be aware of the risk associated with all digital currencies, including complete loss of value.
Digital currencies are very innovative but not insured by regulatory bodies such as the FDIC.

Before purchasing lumens, consult the Consumer Advisory brief by the Consumer Protection Finance Board (CPFB) on the potential risks associated with digital currencies.

from stellar.org

How do I use XLMwallet as an app-like?

XLMwallet can be used on any device as long as the device can execute javascript code.

Thanks to the LocalStorage technology, you can use XLMwallet as a mobile / tablet application.
To do so, follow these simple steps:

  1. Browse XLMwallet using your device
  2. Unlock your wallet using your private key
  3. Go to the settings and enable Mobile mode
  4. Finished!

Now, each time you will browse the page through your bookmarks or screenboard, your wallet will automatically be unlocked.
This mode can only disabled by logging out .

How can I have multiple accounts?

XLMwallet can be used to manage multiple accounts.
It's pretty easy to set up:

  1. Enable the Mobile mode in the settings
  2. In the accounts directory, click the
  3. You can now manage your accounts (add new, rename, delete etc.)

To switch from one account to another, simply click on the account you'd like to use.

How to merge accounts?

Access the account you would like to send all your funds from, then:

  1. Click "send money" ()
  2. To: enter the account's id you would like to send your funds to
  3. Amount: enter a number greater or equal your XLM balance
  4. Click send

A popup will appear and prompt if you'd like to send all your Lumens to the address, click yes.

You can't merge your account if you have assets or active trust lines - make sure to empty your assets and delete your trust lines if you encounter errors.

How to add/remove an asset trust line?

Access to your account, then:

  1. Click "holdings" ()
  2. Go to the "TRUST" menu
  3. Asset code: enter the asset code (usually 3 or 4 letters long, like XLM, BTC...)
  4. Asset issuer: enter the asset's issuer account
  5. Limit: set to 0 to remove the trust line, do not enter anything to use the max limit.
  6. Click "UPDATE"

Once the trust line was updated, you can go back to the "ASSETS" menu, if you added a trust line, the asset should be displayed in the list - if you removed the trust line, the asset should not be listed anymore.

How to set the inflation destination address?

Access to your account, then:

  1. Click "settings" ()
  2. Go to the "MONEY" menu
  3. Inflation destination: enter the destination address
  4. Click "SET"
How to send Lumens to an email?

Pretty easy with xlmwallet, just send Lumens like if you were sending to a public address - but instead - enter the email address in the destination field.
XLMwallet use an escrow account system for the mail sending feature, you will be displayed the secret key of that escrow account: save it, you can use it to refund yourself in case your recipient never claims the lumens.

How can I get a federated name?

XLMwallet has an open federation service for you! To get a federated name, access to your account and then:

  1. Click "receive money"
  2. Click the button
  3. Enter the name you want
  4. Click "SET"

Congrats! People can now send you lumens at yourname*xlmwallet.co on any wallet that supports federated names.

How can I link my email to my account?

XLMwallet uses a secret hash system to prevent users from linking emails they do not own to an account id.
For that reason, the only way to link your email to an account id is to send Lumens to your email address using xlmwallet.

  1. Send Lumens to your email
  2. Click the claim button in the mail
  3. Click "send funds to a new account"
  4. Check "yes, link my email"
  5. Click "CLAIM"

Now each time someone will send you Lumens to youremail@domain.com, the lumens will be sent directly to the account linked to your email.

Still have questions?

You can read more on stellar.org, the official Stellar Foundation website - please note however that XLMwallet is not affiliated with the Stellar Foundation, you won't find any support regarding XLMwallet on stellar.org.

For XLMwallet related questions, please ask them on our official thread

to the wallet