dash-docs/_includes/devdoc/example_intro.md
thephez 9c2b5e09b3
Content - Default regtest port changed 18332->19898 (#152)
* Content - Default regtest port changed 18332->19898
Avoids conflict with bitcoin

* Content - Update default regtest P2P port to 19899

* Content - Display default devnet port

* Formatting
2019-09-05 16:29:46 -04:00

76 lines
2.6 KiB
Markdown

{% comment %}
This file is licensed under the MIT License (MIT) available on
http://opensource.org/licenses/MIT.
{% endcomment %}
{% assign filename="_includes/devdoc/example_intro.md" %}
{% autocrossref %}
<!-- __ -->
The following guide aims to provide examples to help you start
building Dash-based applications. To make the best use of this document,
you may want to install the current version of Dash Core, either from
[source][core git] or from a [pre-compiled executable][core executable].
Once installed, you'll have access to three programs: `dashd`,
`dash-qt`, and `dash-cli`.
* `dash-qt` provides a combination full Dash peer and wallet
frontend. From the Help menu, you can access a console where you can
enter the RPC commands used throughout this document.
* `dashd` is more useful for programming: it provides a full peer
which you can interact with through RPCs to port 9998 (or 19998
for testnet / 19898 for regtest).
* `dash-cli` allows you to send RPC commands to `dashd` from the
command line. For example, `dash-cli help`
{% endautocrossref %}
### Configuration file
<!-- no subhead-links here -->
{% autocrossref %}
All three programs get settings from `dash.conf` in the `DashCore`
application directory:
* Windows: `%APPDATA%\DashCore\`
* OSX: `$HOME/Library/Application Support/DashCore/`
* Linux: `$HOME/.dashcore/`
To use `dashd` and `dash-cli`, you will need to add a RPC password
to your `dash.conf` file. Both programs will read from the same file
if both run on the same system as the same user, so any long random
password will work:
~~~
rpcpassword=change_this_to_a_long_random_password
~~~~
You should also make the `dash.conf` file only readable to its
owner. On Linux, Mac OSX, and other Unix-like systems, this can be
accomplished by running the following command in the Dash Core application
directory:
~~~
chmod 0600 dash.conf
~~~
For development, it's safer and cheaper to use Dash's test network (testnet),
regression test mode (regtest), or a develper network (devnet) described below.
Questions about Dash use are best sent to the [Dash forum][forum
tech support] and [Discord channels][Discord channels]. Errors or suggestions related to
documentation on dash-docs.github.io can be [submitted as an issue][docs issue].
In the following documentation, some strings have been shortened or wrapped: "[...]"
indicates extra data was removed, and lines ending in a single backslash "\\"
are continued below. If you hover your mouse over a paragraph, cross-reference
links will be shown in blue. If you hover over a cross-reference link, a brief
definition of the term will be displayed in a tooltip.
{% endautocrossref %}