More and Troubleshooting
Coin name and ticker
- Name:
Alephium - Ticker/Symbol:
ALPH
Public services
All latest public APIs are listed on the Public services page.
Official wallets
Please refer to the wallet guide.
Full node
Run a full node
Please read the get started guide.
Required disk size
The current mainnet database size is around 95G. Pruned
nodes can reduce the disk
requirement to around 25G.
Snapshots
Please read the load snapshot guide.
Block producing rate
Currently the average network block production rate is 1 block every 1sec. This is because the network currently has 16 chains each with a blocktime of 16sec. (16/16=1s in average).
Configure file directory
Data folder for full node can be changed, use the following documentation.
Customize RPC Port
To customize the RPC port: add this line alephium.network.rest-port = PORT to the ${ALEPHIUM_HOME}/user.conf file1.
RPC documentation / SDK
Does the fullnode need to expose its port to the outside? If so, is it acceptable for the machine to have a NAT IP?
Yes and NAT IP is ok.
Is it necessary to add our node IP into your whitelist when synchronizing?
No, it’s not necessary.
Wallets & Addresses
Validate address format
Address is base58 encoded string, there is no max length for address, but in most case the decoded address length is 33 bytes.
There is a utility function in the TS SDK.
Access the address history
You can access the address history in two ways:
- You can get the address history from the explorer, but you will need to run your own explorer backend. Here is the explorer endpoint you can use.
- You can also maintain your own database, whenever you receive a new deposit.
Access the balance of an address
You can get the balance using this endpoint.
Get the UTXOs of an address
You can get the UTXOs using this endpoint
Restoring and recovering Wallets
You could restore your Wallets with your secret mnemonic or private keys:
Does the Wallet supports memo function?
No.
Transactions
Simple asset transfer
Simple transfer can be created using this endpoint.
Transfer process: sign transaction offline and broadcast it online
You can create, sign, and broadcast transactions following this guide.
Transaction precision
Alephium supports transaction precision up to 10^-18.
Is there any dust limit or reservation?
Yes, the dust amount is 0.001 ALPH and each at output/UTXO needs least 0.001 ALPH.
Is there a timeout mechanism for a transaction in tx pool, and if so, how long does it deal?
Yes, by default tx will be removed from mempool if it is not mined after 2 hours.
You can customize this config by add this line alephium.mempool.unconfirmed-tx-expiry-duration = xxx minutes in user.conf.
Access the detailed information of a transaction
You can get the tx details using this endpoint.
How to determine if a transaction failed
A transaction will if you submit it into the pool and get an internal server error message back.
How to determine if a transaction is accurate and avoid cheating recharge
Alephium is a UTXO-based blockchain, recharging can be avoided by ensuring the same UTXO input is not spend twice in two transactions. This is checked by the consensus protocol.
Misc.
Get highest blocks
You can get the current height using this endpoint, you need to replace the fromGroup and toGroup params as needed, which can be any value of [0, 1, 2, 3].
What mechanism is in place to protect Alephium against 51% attack or to avoid chain forking?
It’s recommended to wait for 110 block confirmations (about 2 hours currently) for each deposit as it’s a PoW chain. Alephium implemented the same 51% attack protection as Ravencoin and other PoW coins when the number of reorg is larger than 100.
What is the maximum reorg/rollback possible on Alephium?
The maximum allowed reorg size is 200 blocks. It is recommend to check 210 blocks for higher safety.
Footnotes
-
By default it is under
C:\Users\<your-username>in Windows,/Users/<your-username>in macOS, and/home/<your-username>in Linux. ↩