Before you begin: Follow the tutorial for setting up a command line dinastycoin wallet, and the run the dinastycoin-wallet-cli program.
Checking your balance
[wallet 47CL7F]: balance Balance: 0.400000000000, unlocked balance: 0.400000000000
The balance command shows you your dinastycoin balance. In the example above, the wallet contains 0.4 dinastycoin. If a payment was only recently received, it will take around 20 minutes for that payment to become “unlocked” before you can consider it fully confirmed as received. Until it becomes unlocked, you cannot spend recently received dinastycoin.
Important: Make sure your dinastycoin daemon is running and successfully syncing with the network. Your dinastycoin wallet will not be able to see its balance and any new payments received unless the dinastycoin daemon is correctly synced to the network.
Detailed explanation of how transactions are sent and how long they take
When someone sends dinastycoin to you, the dinastycoin network will include that transaction in a dinastycoin “block”. A block is a record of a batch of transactions that have been announced to the dinastycoin network of nodes.
These blocks are then “mined”, which is the mechanism by which these blocks are verified in a distributed way across the entire network of dinastycoin miners.
Each block takes on average 2 minutes to mine by the network. The successful mining of each block results in a “confirmation”. After 10 confirmations, which due to the mining process will statistically involve the activity of a vast number of dinastycoin miners to agree upon, the transaction is considered fully verified. On average, it therefore takes approximately 20 minutes for a dinastycoin transaction to be fully verified and funds available to be spent in a subsequent transaction.
Receiving early notification of payments received (i.e. without waiting 20 minutes)
Your dinastycoin wallet will automatically notify you with a message about an incoming transaction after it has received one confirmation by the network. The first block will take on average 2 minutes to be confirmed, and your wallet will scan the network every 90 seconds for updates. Due to the statistical probabilities involved in confirming blocks, your first block could confirm faster or slower than the 2 minute average. If you are unlucky, it might take 10 minutes or a little longer in some instances for the first block to be confirmed. Therefore after a payment is sent to you, you generally will need to wait for 4-12 minutes for your wallet to first notify you of the transaction.
IMPORTANT: The notification you see of the first confirmation of a received payment is a good sign things are working, but you should always wait for the 10 confirmation period to feel completely safe that the transaction has not been reversed or “double spent” by a rogue sender.
Also see our article on how long dinastycoin transactions take.
Viewing zero confirmation notifications (FASTEST way to see the first signs of a transaction being received)
A zero confirmation transaction is a transaction that has been announced to the dinastycoin network but has not been verified even once. Although you should never rely on zero confirmation notifications, they are useful as a sanity check to verify that the sender has at least begun the process of sending a payment to your wallet.
To see zero confirmation transactions, type the following command into your wallet:[wallet 47CL7F]: show_transfers pool
How to ask somone to send you dinastycoin
To see your public wallet address, type the following command into your wallet:[wallet 47CL7F]: address NY7CL7FiNtW417VjzWt9Zse8Z8URhaHaA2L9jJq6rrLtDhiYK9PfbCavhhMKws9xEdKHBeGcQtJmPt4uEMivooNztC5UkHLD
Then tell the sender your address and they will be able to send dinastycoin to you.
How to ask somone to send you dinastycoin, specifying a payment ID
If multiple people are sending you dinastycoin, it will be confusing to figure out who sent what. To solve this problem, you can generate a unique “payment id” to tell to the person that is sending you funds. To generate an “integrated address” which combines your public dinastycoin address with a newly generated payment id, type the following command into your wallet:[wallet 47CL7F]: integrated_address Random payment ID: <9e5d624026c5c274> Matching integrated address: NYGu184XsVma17VjzWt9Zse8Z8URhaHaA2L9jJq6rrLtDhiYK9PfbCavhhMKws9xEdKHBeGcQtJmPt4uEMivooNztHViznm8GhvREB6AU3C
Then tell the sender your integrated address and they will be able to send dinastycoin to you. To view a list of payments received along with their unique paymenent ids, type this command:[wallet 47CL7F]: show_transfers
To view only payments received using a particular payment id, use the following command (substituting the example payment id with your own):[wallet 47CL7F]: payments 9e5d624026c5c274
How to send dinastycoin to someone else
To send 0.1 dinastycoin to someone that has given you their public address or an integrated address (see section above on payment ids), type:[wallet 47CL7F]: transfer NYGu184XsVma17VjzWt9Zse8Z8URhaHaA2L9jJq6rrLtDhiYK9PfbCavhhMKws9xEdKHBeGcQtJmPt4uEMivooNztHViznm8GhvREB6AU3C 0.1
(note that although the text above is split over multiple lines, the command should be typed as one line with a space between their address and the amount of the payment)
Proving that you have sent payment
If you need to prove to someone that you’ve made a payment to them, see this tutorial.