Receive money and check balance
New site!
All content has been migrated to docs.dash.org. You will be automatically redirected momentarily.
Receive money and display balance
Initialize the SDK Client with your generated mnemonic passed as an option.
const Dash = require("dash");
const mnemonic = ''// your mnemonic here.
const client = new Dash.Client({
wallet: {
mnemonic,
}
});
async function showBalance() {
const account = await client.wallet.getAccount();
const totalBalance = account.getTotalBalance();
console.log(`Account's total balance: ${totalBalance} duffs`);
}
Having your client
instance set up, you will be able to access the account
and wallet
instance generated from your mnemonic.
By default getAccount()
returns the first BIP44 account.
You can read more on how to use a different account.
Generate a receiving address
Dash wallet supports two different types of addresses:
external
addresses used for receiving funds from other addressesinternal
addresses used for change outputs of outgoing transactions- For your privacy, you might want to generate a new address for each payment:
async function generateUnusedAddress() {
const account = await client.wallet.getAccount();
const { address } = account.getUnusedAddress();
console.log(`Unused external address: ${address}`);
}
This above code will generate a new unique (never used) address.
Displaying your balance
Dash Wallet returns the balance in duffs (1 Dash is equal to 100.000.000 duffs)
getTotalBalance()
function takes into account confirmed
and unconfirmed
transactions (not included in a block).
It is recommended to check the confirmed balance before making a payment:
async function showBalance() {
const account = await client.wallet.getAccount();
const totalBalance = account.getTotalBalance();
const confirmedBalance = account.getConfirmedBalance();
const unconfirmedBalance = account.getUnconfirmedBalance();
console.log(`Account balance:
Confirmed: ${confirmedBalance}
Unconfirmed: ${unconfirmedBalance}
Total: ${totalBalance}
`);
}
Listen for event on received transaction
When a new unconfirmed transaction is received, you can receive an event, and then validate the address or perform an action if needed.
// FETCHED/UNCONFIRMED_TRANSACTION event is currently disabled
async function listenUnconfirmedTransaction() {
const account = await client.wallet.getAccount();
account.on('FETCHED/UNCONFIRMED_TRANSACTION', (data) => {
console.dir(data);
});
}
Get address at specific index
In case you want to retrieve an address at specific index:
async function getAddressAtIndex() {
const account = await client.wallet.getAccount();
const { address: externalAddress } = account.getAddress(2);
const { address: internalAddress } = account.getAddress(2, 'internal');
}
Updated about 1 year ago