fractalplatform / fractal

Fractal

Welcome to the Fractal source code repository!

What is Fractal?

Fractal is a high-level blockchain framework that can implement the issuance, circulation, and dividends of tokens efficiently and reliably. Fractal can also steadily implement various community governance functions with voting as the core and foundation. These functions are the foundation for building the token economy of future.

home page: https://fractalproject.com/

Executables

The fractal project comes with several wrappers/executables found in the cmd directory.

Command	Description
ft	Our main fractal CLI client. It is the entry point into the fractal network (main-, test- or private net), It can be used by other processes as a gateway into the fractal network via JSON RPC endpoints exposed on top of HTTP, WebSocket and/or IPC transports. ft -h and the Command Line Options for command line options.
ftfinder	ftfinder is a fractal node discoverer.ftfinder -h and the Command Line Options for command line options.

Getting Started

The following instructions overview the process of getting the code, building it, and start node.

How to create first account

You can use fractal wallet to create first account.

Getting the code

To download all of the code:

git clone https://github.com/fractalplatform/fractal

Setting up a build/development environment

Install latest distribution of Go if you don't have it already. (go version >= go1.10 )

Currently supports the following operating systems:

• Ubuntu 16.04
• Ubuntu 18.04
• MacOS Darwin 10.12 and higher

Build Fractal

make all

more information see: Installing Fractal

Running a node

To run ./ft , you can run your own FT instance.

$ ft

Join the fractal main network see: Main Network

Join the fractal test network see: Test Network

Operating a private network see:Private Network

Resources

Fractal Official Website

Fractal Blog

More Documentation see the Fractal wiki

License

Fractal is distributed under the terms of the GPLv3 License.

fractal's Issues

[BUG][dev] dpos too much rreversible blocks

Prerequisites:
DPOS
Test steps:
1.DPOS ：After two rounds
Test results:
dpos too much rreversible blocks

Remarks：Has been corrected but not incorporated dev（take notes）

[requirement][v0.0.1.1]Issuable non-renewable assets

Prerequisites: issuance of assets
Test steps:
Additional assets
Expected results:
No additional issuance of this asset

[BUG][dev]Snapshots cause CPUs to go up, not down.

Prerequisites:
Snapshots
Test steps:
wait an hour
Test results:
CPUs to go up, not down.

the genesis bootnodes' ip addresses are invalid

Excuse me , there were something wrong when i set up a node. During the process of starting a node, everything was fine except a warn"genesis bootnodes prased failed"and detail information just showed "invalid IP address". So , if you were just change the ip address in he "genesis.json" and "testnet.json"? The addresses you gave in theses two documents were all unable to connect, thus I can not find any other nodes.
It will be greatly appreciated if you can reply me soon. Thx!

[BUG][dev]dpos new features,After kick Cadidate,Insufficient Cadidate，Cadidates error

Prerequisites:
DOPS
Test steps:
1.After kick Cadidate,Insufficient Cadidate
Test results:
except [ftsystemio testtest11 testtest13 testtest3 testtest14 testtest4 testtest10 ftsystemio testtest12 testtest6 testtest7 testtest8 testtest15 testtest5 testtest9] index 11 (5752668) "

Debugging errors properly

You should not panic(err)

fractal/asset/asset.go

Lines 153 to 155 in 1d8e186

	if err != nil {
	panic(err)
	}

Hey dude,

Just a friendly advice. You should not panic(err). You’d rather use a package like this for debugging your errors. Debug your code with :

1. Clear stack trace
2. Failing func call highlighting

It’s way more easier then to debug.

Real better than panic-ing (in most case). You can still force exit if you need it.

I would be happy to get your feedbacks.

Wrong when executing `make all` under Ubuntu

~/fractal-0.0.30# make all
······
--- /tmp/gofmt022320232 2019-11-21 15:09:10.482600314 +0800
+++ /tmp/gofmt965464231 2019-11-21 15:09:10.482600314 +0800
@@ -151,7 +151,7 @@
}

accountTxs := &types.AccountTxs{
Txs: txhhpairs,
Txs: txhhpairs,
IrreversibleBlockHeight: b.ftservice.engine.CalcBFTIrreversible(),
EndHeight: uint64(lastnum),
}

Your marmot has found a problem with the formatting style of the code.
Makefile:38: recipe for target 'check' failed
make: *** [check] Error 1

How can I solve this problem?

how to create transaction

How to craeate transaction using 'https://github.com/fractalplatform/fractal/wiki/%E4%BA%A4%E6%98%93payload%E6%9E%84%E9%80%A0#%E5%88%9B%E5%BB%BA%E8%B4%A6%E5%8F%B7' ? Can you provide me a demo to do it,like requesting the interface or creating local code.

[dev]No limit on fee currency

Prerequisites:
fee
Test steps:
1.fee
Test results:
No limit on fee currency

[BUG][dev]Occasionally one producer comes out twice in a round.

Prerequisites:
DPOS
Test steps:
1.Look at the producers of large blocks
Test results:
Occasionally one producer comes out twice in a round.

[BUG][v0.0.2]ActivatedMinQuantity did not reach the set value, DPOS started

Prerequisites:
ProducerScheduleSize reach quantity
Test steps:
1.Registered producer
Test results:
ActivatedMinQuantity did not reach the set value, DPOS started

common.HexToPubKey should verify the input parameter and return an error if need

Like btcec,

func ParsePubKey(pubKeyStr []byte, curve *KoblitzCurve) (key *PublicKey, err error) {
...

[BUG][dev]update getSnapBalance，Non-platform currency as parameter，return 0

Prerequisites:
Non-platform currency as parameter
Test steps:
1.update getSnapBalance，Non-platform currency as parameter
Test results:
return 0

Remarks：Has been corrected but not test（take notes）

[BUG][dev]Enforcement of contract with transfer（value!=0),evm: execution reverted

Prerequisites:
contract
Test steps:

1. contract with transfer（value!=0)
   Test results:
   evm: execution reverted

[BUG][v.0.0.1.1]Transactions that create invalid accounts can be accessed through RLP to the TX Library

Prerequisites:RLP
Test steps:
1.Create an invalid account
2.Call RLP to send transactions
Test results:
Transactions that create invalid accounts can be accessed through RLP to the TX Library

[BUG][dev]Snapshot Causes Node Synchronization Error

Prerequisites:
Snapshots
Test steps:
Node Synchronization
Test results:
error

[BUG][dev]DPOS new features，statedb nil pointer dereference

Prerequisites:
DOPS
Test steps:
1.Cadidates<2/3+1
Test results:
snapshot statedb nil pointer dereference

notes:Changed, tested and observed

[BUG][20190222]txpool has too many transactions,but miner empty block

Prerequisites:
many many transactions
Test steps:
1.long-running
Test results:
txpool has too many transactions,but miner empty block

How to create a transfer transaction?

I built a transaction like this:

    "gasAssetId":0,
    "gasPrice":10000000000000000,
    "actions":[
        {
            "gasLimit":300000,
            "remark":"0xe78e8be69ca8e69ca8e5a49574657374",
            "amount":"0x1",
            "actionType":"0x205",
            "accountName":"wangmenglocal",
            "toAccountName":"wangmenghaha",
            "assetId":0,
            "nonce":1,
            "payload":"0x",
            "payloadDetailInfo":{
                "name":"payload",
                "value":"0x"
            }
        }
    ]
}

and then I signed and sent transaction, but got error "Invalid sender" , I guess it failed because wrong signature. I used FTWallet and sent transaction successfully with the same account. How can I get the signature from FTWallet? so that I can check if I did it right, or can you please tell me if I build the transfer body right?

[BUG][v0.0.2]The former producer does not block, the current producer does not have extraBlockReward

Prerequisites:
pre producer does not block
Test steps:
1.View current producer extraBlockReward
Test results:
The former producer does not block, the current producer does not have extraBlockReward

[BUG][dev]Occasionally bftIrreversible unchanged

Prerequisites:
DPOS
Test steps:
1.Look at the bftIrreversible
Test results:
Occasionally bftIrreversible unchanged.

notes:Has been repaired but has not been fitted in dev

[BUG][v0.0.1.1] txpool pending list unable to delete transactions

txpool pending transaction list unable to delete underbalanced transactions。

[BUG][dev]update getSnapBalance ，Non-producers as parameters ， stop mining

Prerequisites:
Non-producers as parameters
Test steps:
1.getSnapBalance ，Non-producers as parameters
Test results:
update getSnapBalance ，Non-producers as parameters ， stop mining

Remarks：Has been corrected but not incorporated dev（take notes）

when I run a Private Network, it shows ERROR

when I run a private networks as #134.
But after I runed ./build/bin/ft --genesis=./build/genesis.json --miner_start
it shows below

INFO [10-18|15:35:32.046] No config file , use default configuration. 
INFO [10-18|15:35:32.046] fractal node                             version=0.0.30+commit.v0.0.30-26-g2c95589+date.2019-10-18
INFO [10-18|15:35:32.046] Reading read genesis file                path=./build/genesis.json
WARN [10-18|15:35:32.072] genesis bootnodes parse failed           err="invalid IP address" node=fnode://9d18e8f043a1d2c06d87506cd968410a24db7cbca3c152e75a9e3850b9b737ec[e-mail]:30000
WARN [10-18|15:35:32.075] genesis bootnodes parse failed           err="invalid IP address" node=fnode://6629defca0f82ede9cb30d40a2ec6e8c56f51080ad49e9099eb960bed63829ee[e-mail]:30000
INFO [10-18|15:35:32.079] Allocated cache and file handles         database=/root/.ft_ledger/ft/chaindata cache=768 handles=512
WARN [10-18|15:35:32.096] genesis bootnodes parse failed           err="invalid IP address" node=fnode://9d18e8f043a1d2c06d87506cd968410a24db7cbca3c152e75a9e3850b9b737ec[e-mail]:30000
WARN [10-18|15:35:32.099] genesis bootnodes parse failed           err="invalid IP address" node=fnode://6629defca0f82ede9cb30d40a2ec6e8c56f51080ad49e9099eb960bed63829ee[e-mail]:30000
ERROR[10-18|15:35:32.102] ft start node failed.                    err="database already contains an incompatible genesis block (have fff77195a34bae2cbe56990436ef0ae4f41f1a466a1a7943f7040ecdd19eceba, new 3b7172d970b3309c11aabdfadf50a81a80649d57f4c1c47b7eb62328eb9e0f48)"

so how to solve the problem above ,thanks.

Bugs in common.Name.IsChildren

Bug1:

1. set config.AccountNameLevel = 1
2. set name1 = "abc"
3. set name2 = "abc.1"
4. check name1.IsChildren(name2) => panic

Bug2:

1. set config.AccountNameLevel = 3
2. set name1 = "abc4567.1"
3. set name2 = "def4567.1.abc4567.1"
4. check name1.IsChildren(name2) => true

proposedIrreversible's value is not equal when use different rpc.

When use different rpc, ft_getCurrentBlock and dpos_irreversible, to get the value of proposedIrreversible, the values are not equal.

Remove unused dependency before releasing a new version

Like govendor remove +u.

[BUG][v0.0.1.1]When there are no nodes in the first account, the order of mining nodes is not random.

Prerequisites:
Multiple Accounts, Multiple Nodes
Test steps:
no nodes in the first account
Test results:
the order of mining nodes is not random

[BUG][dev]IssueAsset Upperlimit=0,error

Prerequisites:
IssueAsset
Test steps:
1.IssueAsset Upperlimit=0,error
Test results:
error

[BUG][dev]Send unsigned transactions，Log error

Prerequisites:
ft_sendRawTransaction
Test steps:
1.Send unsigned transactions
Test results:
panic

[BUG][dev]txpool does not filter the newly added error transaction hints

Prerequisites:
txpool
Test steps:
1.New Types of False Trading
Test results:
txpool does not filter

[BUG][dev]Stress testing, after a period of time, some nodes can not synchronize

Prerequisites:
Stress testing
Test steps:
after a period of time
Test results:
some nodes can not synchronize

how to run a Private Network

the wiki is still a blank

[BUG][dev]transAsset Contract method,Contract Account as Parameter，evm: execution reverted

Prerequisites:
transAsset Contract method
Test steps:
1.Contract Account as Parameter
Test results:
evm: execution reverted

[BUG][dev]contract destroyAsset，account asset not exist or asset amount over the issuance limit，No error prompted

Prerequisites:
contract destroyAsset
Test steps:
1.account asset not exist or asset amount over the issuance limit
Test results:
No error prompted

the gasAllot slices are out of order

gasAllot slices are out of order from evm.FounderGasMap

[BUG][dev]ft_call Interface returns empty data

Prerequisites:
ft_call
Test steps:
1.return empty
Test results:
ft_call Interface returns empty data

[BUG][dev]Occasionally statedb fatal error: concurrent map read and map write

Prerequisites:

Test steps:
1.Pressure test
Test results:
Occasionally statedb fatal error: concurrent map read and map write

[BUG][dev]DPOS new features,insert error :497 not found block by number 497

Prerequisites:
DOPS
Test steps:
1.too much rreversible blocks
Test results:
DPOS new features,insert error :497 not found block by number 497

notes:Changed, tested and observed

[BUG][dev]dpos new features,UnRegCadidate nil pointter dereference

Prerequisites:
DOPS
Test steps:

1. UnRegCadidate
   Test results:
   fractal/consensus/miner/worker.go:332 +0xd24

[master/dev]Exceptionally close the node, the node can not continue to synchronize data

DEBUG[07-25|11:33:41.844] downloader statusTD x Local=53557276256 Number=19561 R=57070210640 Number=20839
DEBUG[07-25|11:33:41.844] downloader findAncestor headNumber=19561 preAncestor=0 irreversibleNumber=20306
WARN [07-25|11:33:41.844] ancestor err err="can not find ancestor after irreversibleNumber:20306" errid:=3
WARN [07-25|11:33:41.844] Disconnect because ancestor not find: station:=ecc702621e254cc2
DEBUG[07-25|11:33:41.844] multiplexDownload end
INFO [07-25|11:33:41.844] Add bad node node="&{node:0xc43029f7a0 endtime:1564025681}"
INFO [07-25|11:33:41.845] Removing p2p peer id=ecc702621e254cc2 conn=dyndial duration=3.021ms peers=10 req=false err="peer was added in the balcklist at least 1 minute"