🛠 Develop on Dolphin
Introduction
This guide provides step-by-step instructions to connect to a Dolphin node to test your applications on the public testnet named Dolphin. Dolphin is the public testnet of Calamari, which in turn is Manta Network's canary. A Dolphin node acts as your personal development environment to build and test applications for the Calamari Network.
Download Binary File
To download an official release of Calamari, visit our release page.
Connecting With Polkadot-JS
For development purposes, it is recommended to use the public Dolphin testnet.
- Open a browser to
https://polkadot.js.org/apps/#/explorer
. This opens Polkadot.js Apps, which connects to Polkadot MainNet by default. - In the top-left corner, open the menu and navigate to the Development sub-menu.
- Enter
wss://ws.calamari.seabird.systems
under custom endpoint. - Click the
Switch
button to connect to your Calamari development node.
With Polkadot.js Apps connected, your Calamari development node will be ready to receive transactions and produce blocks.
Network Endpoints
List of the load-balancer endpoints provided by Calamari:
- WSS -
wss://ws.calamari.seabird.systems
- HTTPS -
https://rpc.calamari.seabird.systems
Build Binary File
Building your own binary is especially useful if you're not working on a Linux as we don't distribute binaries for Mac/Windows. Furthermore should you need to customize something in your testing environment related to the node, you can rebuild it locally:
- Clone the specific tag of the Calamari repository from this URL:
https://github.com/Manta-Network/Manta/
git clone https://github.com/Manta-Network/Manta
cd Manta
- Install Rust:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
- Update your PATH environment variable with this command:
source $HOME/.cargo/env
- To build and run the binary file, choose one of the following options:
cargo build --release
./target/release/manta --chain=calamari-localdev --alice --tmp
or:
cargo run --release -- --chain=calamari-localdev --alice --tmp
Note: calamari-localdev
eliminates the need for a relay chain and creates blocks automatically when transactions are received.
Note: For a complete simulation, you can run a relay chain with a full parachain using tools like zombienet or polkadot-launch. In that case you need to run the node with --chain=calamari-local
Chain ID
Dolphin testnet chain id is 2084
Block Explorer
A block explorer is like a search engine for the blockchain. It lets you search for information such as balances, contracts, and transactions.
Subscan is the main block explorer for the Substrate API. It can handle both standard and custom modules, so you can see information about Staking, Governance, and XCM pallets (or modules), among others. The code is open-source and available on the Subscan Essentials GitHub repo.
Polkadot.js Apps is another option, especially if you're running local development nodes. It's not a full-featured block explorer, but it lets you view events and query transaction hashes using the WebSocket endpoint. You can easily connect to Moonbeam, Moonriver, or Moonbase Alpha.
Faucet
To use the Dolphin faucet, head to our Discord channel.
To receive tokens from the faucet, you'll need to get the attention of the faucet bot. Start by typing the command for the token you want, such as /gimme-dol
. Discord will display a small pop-up asking for your wallet address.
Type or paste your wallet address into the address field, then press enter to trigger the faucet request.
You can request each of the four supported tokens (DOL
, KAR
, KSM
, MOVR
) once per UTC day. If you request the same token twice in the same day, the faucet bot will only respond with the status of your first request of the day. You can check the status of your address at https://faucet.dolphin.community/.
Development Tools
manta.js Javascript SDK
: A set of functionality which connects your public address (polkadot-js), your private addresses (manta-signer
) and manages the creation of the payloads required forMantaPay
extrinsics.Manta-Signer
: The signer is a desktop application which generates zero knowledge proofs and manages the private keys of your UTXOs. The signer is open sourced and you find instruction to set it up locally at manta-signer.- zombienet or the deprecated polkadot-launch tool can help you set up a full relaychain + parachain network.