Fragnova is a custom blockchain built on the Substrate framework.
It is a protocol and networking stack that enables complete on-chain storage and full synchronization of asset data (protos, fragments, shards scripts etc.) across the blockchain nodes.
Before you start, ensure you've set up your development environment and installed Rust.
NOTE - The following instructions are for developing Fragnova on Linux (also on WSL) / Mac since Substrate does not yet have a reliable native Windows support.
# To build the project
cargo build
Run the following command from the root folder of Fragnova project:
RUST_LOG=bitswap=trace,pallet_protos::pallet=trace,pallet_frag::pallet=trace,pallet_fragments::pallet=trace cargo run -- --dev --tmp --rpc-external --rpc-port 9933 --rpc-cors all --ws-external --enable-offchain-indexing true --rpc-methods=Unsafe --pool-kbytes 200000
If you want to run the Fragnova node with a chain specification instead, use this script:
cargo run -- --chain=spec_raw.json --validator --rpc-external --rpc-port 9933 --rpc-cors all --ws-external --enable-offchain-indexing true --rpc-methods=Unsafe -d <DATA PATH>
Polkadot.js provides a browser based application, App Explorer (also available as hosted IPFS and IPNS versions). This application allows you to interact with your locally running Substrate node, with minimal setup.
To do this:
- Run you Fragnova node locally
- Head over to the App Explorer
- Click the top-left Pokadot icon on the header of the page
- Expand the Development sub-menu (at the bottom of the list)
- Click Local Node to enable it
- Click Switch at the top of the panel
The App Explorer will now connect with your local node and will show the blocks being produced by your node in real-time.
Build to make sure wasm runtime is uptodate
cargo build --release
Build the spec, in order to generate the json spec we need to grab stuff from
./target/release/fragnova build-spec > spec.json
Grab "system" the wasm runtime and paste it into your template, in our case testnet.json
Produce a raw spec
./target/release/fragnova build-spec --chain testnet.json --raw > testnet-raw.json
Run the validator with permissive external rpcs in order to add "aura" and "gran" keys calling author_insertKey rpc
./target/release/fragnova --node-key-file p2p-node.key --chain testnet-raw.json --ipfs-server --validator --enable-offchain-indexing true --rpc-methods=Unsafe --rpc-external --rpc-cors all --ws-external --port 30337
Now run again in a more restrictive environment, also including rpc/bootstrap known nodes
./target/release/fragnova --node-key-file p2p-node.key --chain testnet-raw.json --ipfs-server --validator --enable-offchain-indexing true --bootnodes /ip4/20.225.200.219/tcp/30337/ws/p2p/12D3KooWQoQhtVUT8j2hV7dXrFpf3pp4Q5FT7c3GdAf2wiKACjD6 --port 30337