Crypto wallets
A crypto wallet is an account of the Crypto category (/crypto), and it holds
lines like a securities account does. There are two kinds, chosen when you create it, and
the difference is who states what you hold.
- A manual wallet is one you fill yourself, line by line: an exchange, a hardware wallet, anything whose balance you read somewhere else and type here.
- A watched address is declared by a chain and a public address, and Badlen fetches the balance from the chain itself. It is the only way anything enters your wealth in Badlen without you typing a figure.
Creating one
Section titled “Creating one”The Crypto wallet tile of the add screen (/ajouter/crypto-wallet), which
Your first account says how to reach, opens one
form with a chip at the top for the two kinds. Both take a name and, optionally, the
platform behind it.
Manual stops there and sends you straight on to adding a line: a ticker and a
quantity, with the cost basis and the day it entered your wealth both optional. The price
comes from Yahoo Finance, which quotes a ticker as <SYMBOL>-EUR, so a coin Yahoo does
not quote is refused by name rather than stored without a price.
Holdings describes a line and how one is corrected.
Watched address adds two boxes: the chain, Bitcoin or Ethereum, and the public address. The address is checked against the shape that chain uses before anything is stored, and the wallet fetches its balance once at creation. A source that is down at that moment does not fail the creation: the wallet is there, empty, and the next sync says which source was missing.
Sync, and what it records
Section titled “Sync, and what it records”Sync, on the wallet’s own Settings tab, asks the chain again. It records the quantities it receives, drops the lines the address no longer holds, and prices what it can; the lines it could not price keep whatever price they had. A chain that is down answers with the explorer’s name, and nothing is written: quantities you can no longer trust are worse than quantities that are a day old.
Two consequences follow from that:
- a line you add by hand to a watched wallet is removed at the next sync, because the chain says it is not there. Hand-entered lines belong in a manual wallet;
- quantities and prices can fail separately. An unpriced line still has its quantity and still appears, and it is counted among the lines with no known price rather than valued at zero.
The button appears on every crypto wallet, but only a wallet declared by an address has a chain to ask: on a manual one it answers This account is not a syncable crypto wallet. The way to refresh a manual wallet is Refresh this price on the line itself.
Ethereum tokens, and the key they need
Section titled “Ethereum tokens, and the key they need”A watched Bitcoin address reports its balance in BTC, read as its funded outputs minus its spent ones.
A watched Ethereum address reports its ether, from a public RPC that needs no key at all. Its ERC-20 tokens need one: a Moralis key, which you paste in Settings → Access under What Badlen reaches. Without it the address reports its ether and no tokens; with it, the tokens arrive with their symbol and their quantity, and the ones flagged as spam are left out.
Those tokens arrive with no price. Only ether is quoted here, so an address holding tokens reports their quantity and counts them among the lines with no known price. The key is stored encrypted, like every key you paste; Encryption explains how.
Where the data comes from lists every server this reaches, and what each one is asked for.