Testnet telemetry | Web wallet | Mobile wallet | Discord chat | Telegram chat
Guidelines:
Requirements
The most common way for a beginner to run a miner and validator is to leverage a cloud server running Linux. You may choose whatever VPS provider that your prefer, and whatever operating system you are comfortable with. The transactions weights in PoScan were benchmarked on standard hardware. It is recommended that miners and validators run at least the standard hardware in order to ensure they are able to process all blocks in time. The following are not minimum requirements but if you decide to run with less than this beware that you might have performance issue.
Standard Hardware
- CPU - Intel(R) Core(TM) i7-7700K CPU @ 4.20GHz
- Storage - A NVMe solid state drive. Should be reasonably sized to deal with blockchain growth. Starting around 80GB - 160GB will be okay for the first six months of Realis, but will need to be re-evaluated every six months.
- Memory - 64GB.
The specs posted above are by no means the minimum specs that you could use when running a validator, however you should be aware that if you are using less you may need to toggle some extra optimizations in order to be equal to other validators that are running the standard.
How to start mining on Linux or MAC OS
- Open your Terminal and build the testnet Node with the folowing:
cd ~
git clone https://github.com/3Dpass/3DP.git
cd 3DP
git checkout test
curl https://sh.rustup.rs -sSf | sh -s -- -y --default-toolchain nightly
source $HOME/.cargo/env
rustup update nightly
rustup target add wasm32-unknown-unknown --toolchain nightly
sudo apt-get install -y libclang-dev libssl-dev clang
cargo build --release
- Option (for Linux only): You can download the latest release instead of building yourself:
wget https://github.com/3Dpass/3DP/releases/download/v0.0.6/poscan-consensus-x86_64-unknown-linux-gnu.tar.gz
tar xzf poscan-consensus-x86_64-unknown-linux-gnu.tar.gz
- Generate your mining key:
./target/release/poscan-consensus generate-mining-key --base-path ~/3dp-chain/ --chain testnetSpecRaw.json
The output would be like this:
Public key: 0xccc201f5b3e7036c5ea534096d75befbda68a9b285025csd7105bc4726f02f7e
Secret seed: fog olympic thrive recall allow page hood damage october curtain degrwe bubble
Address: d7GtBxnPwRZVez7VsQ9H7MskPn34H59RddrR9yXqhgDYsqC3t
-
Register your mining key in the keystore:
./target/release/poscan-consensus import-mining-key 'your secret seed phrase' --base-path ~/3dp-chain/ --chain testnetSpecRaw.json
-
Generate the key for GRANDPA:
./target/release/poscan-consensus key inspect --scheme Ed25519 "your secret seed phrase"
The seed phrase must be the same as for your mining key.
The output would be like this:
Secret phrase `fog olympic thrive recall allow page hood damage october curtain degrwe bubble` is account:
Network ID/Version: 72
Secret seed: 0x4934fa3a959af00a0caccf2be77d82f4cbf2154c3c7bebc021f2c1573f44fbb3
Public key (hex): 0x23dad301fa6165b70bf538ca3be304ad418232c76814b38223c57d69bf2b28d1
Account ID: 0x23dad301fa6165b70bf538ca3be304ad418232c76814b38223c57d69bf2b28d1
SS58 Address: d7HqrBYq9qsTbBb4tQtnt9sLgh9UsS7XJbgQgr5Cb4CxH2xAd
-
Insert Grandpa key into the keystore:
./target/release/poscan-consensus key insert --base-path ~/3dp-chain/ --chain testnetSpecRaw.json --scheme Ed25519 --suri 0x4934fa3a959af00a0caccf2be77d82f4cbf2154c3c7bebc021f2c1573f44fbb3 --key-type gran
--suri
is your Secret seed for Grandpa (not a Secret phrase, but this one 0x4934fa3a959af00a0caccf2be77d82f4cbf2154c3c7bebc021f2c1573f44fbb3
in the example above)
-
Check if there are 2 keys in the keystore:
ls ~/3dp-chain/chains/3dpass-test/keystore
You can also check the keys manualy ~/3dp-chain/chains/3dpass-test/keystore
-
Restart the Node with the following:
./target/release/poscan-consensus --base-path ~/3dp-chain/ --chain testnetSpecRaw.json --name MyNodeName --validator --telemetry-url "wss://submit.telemetry.3dpass.org/submit 0" --author 0xccc201f5b3e7036c5ea534096d75befbda68a9b285025csd7105bc4726f02f7e --threads 2 --no-mdns
--author
is your Public key from mining account (the one you have generated as mining key, in the example above it is 0xccc201f5b3e7036c5ea534096d75befbda68a9b285025csd7105bc4726f02f7e
)
--threads
is the number of threads you're about to use for mining ("--threads 2" means, you are going to leverage 2 threads)
- Install Nodejs v16 and Yarn
- Install miner:
Yarn
- Run miner:
Yarn miner --interval 100
--interval
is the amount of time in miliseconds between the last and the next one objects being sent towards the Node.
Dependidng on how much threads are you mining with, reduce the interval until you reach desired proc load.
- Make sure you can see your Node in the list
cd ~ git clone https://github.com/3Dpass/3DP.git cd 3DP git checkout test curl https://sh.rustup.rs -sSf | sh -s -- -y --default-toolchain nightly source $HOME/.cargo/env rustup update nightly rustup target add wasm32-unknown-unknown --toolchain nightly sudo apt-get install -y libclang-dev libssl-dev clang cargo build --release
wget https://github.com/3Dpass/3DP/releases/download/v0.0.6/poscan-consensus-x86_64-unknown-linux-gnu.tar.gz tar xzf poscan-consensus-x86_64-unknown-linux-gnu.tar.gz
./target/release/poscan-consensus generate-mining-key --base-path ~/3dp-chain/ --chain testnetSpecRaw.json
The output would be like this:
Public key: 0xccc201f5b3e7036c5ea534096d75befbda68a9b285025csd7105bc4726f02f7e Secret seed: fog olympic thrive recall allow page hood damage october curtain degrwe bubble Address: d7GtBxnPwRZVez7VsQ9H7MskPn34H59RddrR9yXqhgDYsqC3t
./target/release/poscan-consensus import-mining-key 'your secret seed phrase' --base-path ~/3dp-chain/ --chain testnetSpecRaw.json
./target/release/poscan-consensus key inspect --scheme Ed25519 "your secret seed phrase"The seed phrase must be the same as for your mining key.
The output would be like this:
Secret phrase `fog olympic thrive recall allow page hood damage october curtain degrwe bubble` is account: Network ID/Version: 72 Secret seed: 0x4934fa3a959af00a0caccf2be77d82f4cbf2154c3c7bebc021f2c1573f44fbb3 Public key (hex): 0x23dad301fa6165b70bf538ca3be304ad418232c76814b38223c57d69bf2b28d1 Account ID: 0x23dad301fa6165b70bf538ca3be304ad418232c76814b38223c57d69bf2b28d1 SS58 Address: d7HqrBYq9qsTbBb4tQtnt9sLgh9UsS7XJbgQgr5Cb4CxH2xAd
./target/release/poscan-consensus key insert --base-path ~/3dp-chain/ --chain testnetSpecRaw.json --scheme Ed25519 --suri 0x4934fa3a959af00a0caccf2be77d82f4cbf2154c3c7bebc021f2c1573f44fbb3 --key-type gran
--suri
is your Secret seed for Grandpa (not a Secret phrase, but this one 0x4934fa3a959af00a0caccf2be77d82f4cbf2154c3c7bebc021f2c1573f44fbb3
in the example above)
ls ~/3dp-chain/chains/3dpass-test/keystoreYou can also check the keys manualy
~/3dp-chain/chains/3dpass-test/keystore
./target/release/poscan-consensus --base-path ~/3dp-chain/ --chain testnetSpecRaw.json --name MyNodeName --validator --telemetry-url "wss://submit.telemetry.3dpass.org/submit 0" --author 0xccc201f5b3e7036c5ea534096d75befbda68a9b285025csd7105bc4726f02f7e --threads 2 --no-mdns
--author
is your Public key from mining account (the one you have generated as mining key, in the example above it is 0xccc201f5b3e7036c5ea534096d75befbda68a9b285025csd7105bc4726f02f7e
) --threads
is the number of threads you're about to use for mining ("--threads 2" means, you are going to leverage 2 threads)
Yarn
Yarn miner --interval 100
--interval
is the amount of time in miliseconds between the last and the next one objects being sent towards the Node.
Dependidng on how much threads are you mining with, reduce the interval until you reach desired proc load.
In order ot remove your blockchain DB use this command:
rm -rf ~/3dp-chain/chains/3dpass-test/db
How to start mining on Windows
- Download and install Rust
- Install Git if you havent installed it yet
- Install Node.js. Make sure you have picked up "Chocolatey installation", which is required for the node to work correctly
- Open powershell as administrator and go to the Desktop (we use this as an example). You can choose any location you like:
cd C:\Users\YourUserNameHere\Desktop\
- Install llvm with choco
choco install llvm
- Configure Rust with the following:
rustup install nightly-2022-06-17 rustup default nightly-2022-06-17 rustup toolchain install nightly-2022-06-17 rustup target add wasm32-unknown-unknown --toolchain nightly-2022-06-17-x86_64-pc-windows-msvc
-
Clone the node from the repo:
git clone https://github.com/3Dpass/3DP.git
- Build the node with the command:
cd 3DP git checkout test cargo build --release
- Set up your keys for mining and Grandpa finalization and run the Node as it's shown above
- Install Yarn:
npm install --global yarn
- Configure miner:
yarn
-
Run miner:
yarn miner --interval 100
--interval
is the amount of time in miliseconds between the last and the next one objects being sent towards the Node. Dependidng on how much threads are you mining with, reduce the interval until you reach desired proc load.
How to use 3DPass web wallet
3DPass browser wallet is a Java Script page interacting with the blockchain network directly from your browser. Once being downloaded it might be connected either to the remote API endpoint available or to the local node running on your computer. By means of changing endpoints you can easily switch among different networks. Go to Settings to switch the endpoint:

API endpoints:
- wss://test-rpc.3dpass.org - testnet
- ws://127.0.0.1:9944 - local Node

How to create new address:
- Open 3DPass wallet page in your web browser.
- Make sure that you are connected to the correct endpoint: wss://test-rpc.3dpass.org or wss://test-rpc.3dpass.org as it's shown above. Use "+" to generate new address. Keep your seed phrase in a safe place. There is no any possible ways to recover if it's lost. You can also import your address from the seed phrase.

Remove your address after being used:
We recommend that you not to store your addresses in browser constantly. Store your seed phrase in a safe place. You can import the address again whenever you need.