Fractal
  • Overview
  • Basics
    • Architecture
  • Key Concepts
    • Fractal Confluence: The EVM Layer
    • The Confluence Bridge
    • Fractal Spring: The UTXO Layer
      • Concepts
      • Technical Specifications
    • Staking
      • Overview
      • EVM Staking
        • UTXO Staking and EVM Staking
      • Consensus
      • Rewards
      • Penalties
  • Developers
    • Acquire Testnet FRA
    • EVM Tools & Tutorials
      • Contract Deployment
        • Ganache
        • Hardhat
        • Remix
        • Truffle
        • Waffle
      • The Graph
    • Developer SDKs
      • UTXO Native Chain SDK
        • Fractal Spring (UTXO Layer) SDK Installation
        • Developer Tools
          • Fractal CLI Tool
        • UTXO API Reference
          • Account
          • Keypair
          • Network
          • Asset
          • Staking
          • Transaction
          • Helpers
      • The Confluence Bridge SDK
    • EVM References
      • Metamask
      • Local Development Network Setup
      • EVM API Reference
      • Precompiled Contracts
  • Network Settings
    • Contract Addresses
    • Network Settings
  • User Guides
    • Fractal Wallet Guides
      • MetaMask
        • Download
        • Configure (Auto)
        • Configure (Manual)
      • Fractal Wallet
        • Download
        • New Wallet
        • Transfer Tokens in the Fractal Wallet
        • The Confluence Bridge
        • Adding Custom Assets to the Fractal Wallet
        • Manage Assets
      • Ledger Hardware Wallet
    • Acquire FRA
    • Explore Testnet
    • Acquire FRA (Testnet)
    • Stake FRA
    • How to Use Block Explorers
    • Bridging Tokens to Fractal
  • Validator Materials
    • Validator Setup Guides
      • System Requirements
      • Acquire a Server
      • Validator Toolbox Setup
        • New Build
        • Existing Build
        • Additional Info
      • Manual Setup
      • Automated Setup (Deprecated)
    • Upgrade Guides
      • Node Upgrade (Toolbox)
      • Node Upgrade (Manual)
      • fn CLI Upgrade (Wallet)
    • Operational Guides
      • Emergency Recovery
      • Data Backup
      • CLI Staking
Powered by GitBook
On this page
  • 1. Prerequisites​
  • 2. Build Required Binaries​
  • 3. Install Python3 and toml-cli​
  • 4. Run Devnet​
  • 5. Devnet URLs and Ports​
  • 6. Troubleshoot​
  1. Developers
  2. EVM References

Local Development Network Setup

This guide walks through how to deploy a local blockchain instance for software development and testing purposes. Alternatively, developers can also develop and test on Fractal's Trickle Testnet.

PreviousMetamaskNextEVM API Reference

Last updated 1 year ago

1. Prerequisites

i) Install Golang

Tips for Linux (Ubuntu)

#first command needs to be run as root, rest as your normal user
wget https://go.dev/dl/go1.18.3.linux-amd64.tar.gz 
sudo su 
rm -rf /usr/local/go && tar -C /usr/local -xzf go1.18.3.linux-amd64.tar.gz

#exit root now
exit

#add to path. For more permanent you should add this line to bottom of your ~/.profile
export PATH=$PATH:/usr/local/go/bin

#check go version
go version

ii) Install Rust

If already installed, please update to 1.59 or newer

rustup update

iii) Install System Specific Dependencies

sudo apt update && \
sudo apt upgrade -y && \
sudo apt install -y build-essential libleveldb-dev libssl-dev pkg-config clang libclang-dev librocksdb-dev
brew install openssl leveldb

Fractal can run on both MacOS or Linux. The commands below will build all required binaries to start a local Fractal network.

git clone -b v0.3.19-release https://github.com/FindoraNetwork/platform &&
cd platform &&
make build_release

Please make sure to add all below 3 binaries to your $PATH. By default, they will be copied to ~/.cargo/bin/ which should already be in your $PATH.

  • stt: The tool to initialize Fractal Network

  • abcid: Fractal core protocol.

  • tendermint: Tendermint consensus engine.

pip3 install toml-cli

and then copy the newly installed toml cli tool to /usr/local/bin to make it visible

cp /Library/Python/3.x/site-packages/toml /usr/local/bin

Inside your platform directory, execute make devnet in the terminal.

Name
Description

node0

The validator

node1

The fullnode

Faucet

The key pair that holds FRA

The local blockchain can be stopped and restarted anytime during development and tests.

  • Stop Blockchain: ./tools/devnet/stopnodes.sh

  • Restart Blockchain: ./tools/devnet/startnodes.sh

  • Start Over: make devnet again.

URL
Purpose

connects to Web3 HTTP

connects to Web3 WebSocket

  • Problem 1

    • Error Message:

      • make build_release fails with go:linkname must refer to declared function or variable

  • Solution

    • Update your golang.org/x/sys

      # go to platform/tools/tendermint run following to update  
      go get -u golang.org/x/sys
  • Problem 2

    • .findora file is missing

  • Solution

    • manually add .findora to your home directory (i.e. directory ~)

2. Build Required Binaries

3. Install Python3 and toml-cli

Fractal devnet tools are written in Python3 and use toml-cli to manipulate configuration files. if not already installed. Also, install toml-cli using the command below:

4. Run Devnet

i) What's in devnet?

ii) How to control devnet?

5. Devnet URLs and Ports

connects to

6. Troubleshoot

​
​
https://go.dev/doc/install
​
https://rustup.rs/
​
​
Install Python3
​
​
​
​
​
http://127.0.0.1
Findora Electron Wallet
http://127.0.0.1:8545
http://127.0.0.1:8546