Wallet RPCs (Deprecated)#
❗️ Wallet Support
RPCs that require wallet support are not available on masternodes for security reasons. Such RPCs are designated with a “Requires wallet support” message.
GetAccount#
❗️
Warning:
setaccount
will be removed in Dash Core v18.0. Use the RPCs listed in the See Also subsection below instead. To use this command in Dash Core v0.17, start dashd with-deprecatedrpc=accounts
.
📘
Requires wallet support (unavailable on masternodes)
The getaccount
RPC returns the name of the account associated with the given address.
Parameter #1—a Dash address
Name |
Type |
Presence |
Description |
---|---|---|---|
Address |
string (base58) |
Required |
A P2PKH or P2SH Dash address belonging either to a specific account or the default account (")” |
Result—an account name
Name |
Type |
Presence |
Description |
---|---|---|---|
|
string |
Required |
The name of an account, or an empty string (", the default account)” |
Example from Dash Core 0.12.2
dash-cli -testnet getaccount yMTFRnrfJ4NpnYVeidDNHVwT7uuNsVjevq
Result:
doc test
See also
GetAddressesByAccount: returns a list of every address assigned to a particular account.
GetAccountAddress#
❗️
Warning:
getaccountaddress
will be removed in Dash Core v18.0. Use the RPCs listed in the See Also subsection below instead. To use this command in Dash Core v0.17, start dashd with-deprecatedrpc=accounts
.
📘
Requires wallet support (unavailable on masternodes)
The getaccountaddress
RPC returns the current Dash address for receiving payments to this account. If the account doesn’t exist, it creates both the account and a new address for receiving payment. Once a payment has been received to an address, future calls to this RPC for the same account will return a different address.
Parameter #1—an account name
Name |
Type |
Presence |
Description |
---|---|---|---|
Account |
string |
Required |
The name of an account. Use an empty string (") for the default account. If the account doesn’t exist, it will be created” |
Result—a Dash address
Name |
Type |
Presence |
Description |
---|---|---|---|
|
string (base58) |
Required |
An address, belonging to the account specified, which has not yet received any payments |
Example from Dash Core 0.12.2
Get an address for the default account:
dash-cli -testnet getaccountaddress ""
Result:
yNUQ6RzTpNj5GP5ebdRcusJ7K9JJKx6VvV
See also
GetNewAddress: returns a new Dash address for receiving payments. If an account is specified, payments received with the address will be credited to that account.
GetRawChangeAddress: returns a new Dash address for receiving change. This is for use with raw transactions, not normal use.
GetAddressesByAccount: returns a list of every address assigned to a particular account.
GetAddressesByAccount#
❗️
Warning:
getaddressesbyaccount
will be removed in Dash Core v18.0. Use the RPCs listed in the See Also subsection below instead. To use this command in Dash Core v0.17, start dashd with-deprecatedrpc=accounts
.
📘
Requires wallet support (unavailable on masternodes)
The getaddressesbyaccount
RPC returns a list of every address assigned to a particular account.
Parameter #1—the account name
Name |
Type |
Presence |
Description |
---|---|---|---|
Account |
string |
Required |
The name of the account containing the addresses to get. To get addresses from the default account, pass an empty string (")” |
Result—a list of addresses
Name |
Type |
Presence |
Description |
---|---|---|---|
|
array |
Required |
An array containing all addresses belonging to the specified account. If the account has no addresses, the array will be empty |
Address |
string (base58) |
Optional |
A P2PKH or P2SH address belonging to the account |
Example from Dash Core 0.12.2
Get the addresses assigned to the account “doc test”:
dash-cli -testnet getaddressesbyaccount "doc test"
Result:
[
"yMTFRnrfJ4NpnYVeidDNHVwT7uuNsVjevq",
"yhT2HS1SxvXkMVdAdf6RNtGPfuVFvwZi35"
]
See also
GetAccount: returns the name of the account associated with the given address.
GetBalance: gets the balance in decimal dash across all accounts or for a particular account.
SetAccount#
🚧
Warning:
setaccount
will be removed in a later version of Dash Core. Use the RPCs listed in the See Also subsection below instead.
📘
Requires wallet support (unavailable on masternodes)
The setaccount
RPC puts the specified address in the given account.
Parameter #1—a dash address
Name |
Type |
Presence |
Description |
---|---|---|---|
Address |
string (base58) |
Required |
The P2PKH or P2SH address to put in the account. Must already belong to the wallet |
Parameter #2—an account
Name |
Type |
Presence |
Description |
---|---|---|---|
Account |
string |
Required |
The name of the account in which the address should be placed. May be the default account, an empty string (")” |
Result—null
if successful
Name |
Type |
Presence |
Description |
---|---|---|---|
|
null |
Required |
Set to JSON |
Example from Dash Core 0.12.2
Put the address indicated below in the “doc test” account.
dash-cli -testnet setaccount \
yMTFRnrfJ4NpnYVeidDNHVwT7uuNsVjevq "doc test"
(Success: no result displayed.)
See also
GetAccount: returns the name of the account associated with the given address.
GetAddressesByAccount: returns a list of every address assigned to a particular account.
SetLabel: sets the label associated with the given address.