Skip to content
Textile's Filecoin tools
Go Other
  1. Go 98.7%
  2. Other 1.3%
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.dependabot ci: removes libp2p filter from dependabot (#43) Jan 7, 2020
.github/workflows Cli command for retrieve (#105) Feb 6, 2020
api Cli command for retrieve (#105) Feb 6, 2020
build Use ldevnet for tests, Docker fixes, GH Action improv., extend Readme… Feb 3, 2020
chainstore rename repo as GH (#96) Feb 3, 2020
chainsync rename repo as GH (#96) Feb 3, 2020
deals Implement retrieve service and client (#103) Feb 5, 2020
docker use viper for configuration (#104) Feb 5, 2020
exe Demo cleanup (#124) Feb 12, 2020
extern using native lotus types & ldevnet for tests (#79) Jan 30, 2020
fchost fixes & improvements (#66) Jan 22, 2020
index rename repo as GH (#96) Feb 3, 2020
iplocation rename repo as GH (#96) Feb 3, 2020
ldevnet retrieval api, ldevnet multiple miners, renaming (#101) Feb 5, 2020
lotus rename repo as GH (#96) Feb 3, 2020
reputation rename repo as GH (#96) Feb 3, 2020
signaler chain reorg, http endpoint, ds persistence, others (#62) Jan 21, 2020
tests rename repo as GH (#96) Feb 3, 2020
txndstransform chain reorg, http endpoint, ds persistence, others (#62) Jan 21, 2020
util Use ldevnet for tests, Docker fixes, GH Action improv., extend Readme… Feb 3, 2020
wallet rename repo as GH (#96) Feb 3, 2020
.dockerignore Use ldevnet for tests, Docker fixes, GH Action improv., extend Readme… Feb 3, 2020
.gitignore Use ldevnet for tests, Docker fixes, GH Action improv., extend Readme… Feb 3, 2020
.gitmodules using native lotus types & ldevnet for tests (#79) Jan 30, 2020
LICENSE Initial commit Dec 17, 2019
Makefile retrieval api, ldevnet multiple miners, renaming (#101) Feb 5, 2020
README.md rename repo as GH (#96) Feb 3, 2020
go.mod build(deps): bump github.com/stretchr/testify from 1.4.0 to 1.5.0 (#135) Feb 19, 2020
go.sum build(deps): bump github.com/stretchr/testify from 1.4.0 to 1.5.0 (#135) Feb 19, 2020

README.md

filecoin

Made by Textile Chat on Slack GitHub license Go Report Card GitHub action

Textile's Filecoin swiss army knife for developers

Join us on our public Slack channel for news, discussions, and status updates. Check out our blog for the latest posts and announcements.

Table of Contents

Usage

Warning This project is still pre-release and is only meant for testing.

Lotus (lotus)

See https://lotu.sh/. Required for client. Lotus is an implementation of the Filecoin Distributed Storage Network—we run the Lotus client to join the Filecoin Testnet.

Client (filcoin)

Note to developers—as of 1/25/2020, the main line of development for the filecoin client is happening in the asutula/cli branch.

# from the asutula/cli branch
go build -i -o filecoin exe/cli/main.go 
chmod +x filecoin 

Try filecoin --help.

Server

The server connects to Lotus and enables multiple modules, such as:

  • Reputations module:
    • Miners index: with on-chain and metadata information.
    • Ask index: with an up-to-date information about available Storage Ask in the network.
    • Slashing index: contains a history of all miner-slashes.
  • Deals Module:
    • Contain helper features for making and watching deals.

Prerequisites

Currently, the server needs the same dependencies as Lotus, so most probably they will be already installed if you run the server in dev mode (go run syntax). If that's not the case, see here.

Run in dev mode

The server can be run in dev mode with go run exe/server/main.go.

Run in docker mode

You can run the server in a Docker Compose enviroment with Prometheus and Grafana to have a health-monitoring for the server. To do so:

cd docker
make fresh

This will do whatever it takes to get all systems running:

  • localhost:3000: Grafana dashboard with anonymous setup. admin:foobar are admin credentials.
  • localhost:9090: Prometheus enpoint.
  • localhost:8888: Server Prometheus endpoint for metric scraping.
  • localhost:8889: HTTP endpoint for current index values (index/miners, index/slashing, index/ask).

It's important to mention that the Docker Compose is run in host network mode, which is only supported in Linux. Eventually we'll include Lotus inside the compose file allowing for default network modes.

Test

For running tests: make test

Contributing

This project is a work in progress. As such, there's a few things you can do right now to help out:

  • Ask questions! We'll try to help. Be sure to drop a note (on the above issue) if there is anything you'd like to work on and we'll update the issue to let others know. Also get in touch on Slack.
  • Open issues, file issues, submit pull requests!
  • Perform code reviews. More eyes will help a) speed the project along b) ensure quality and c) reduce possible future bugs.
  • Take a look at the code. Contributions here that would be most helpful are top-level comments about how it should look based on your understanding. Again, the more eyes the better.
  • Add tests. There can never be enough tests.

Before you get started, be sure to read our contributors guide and our contributor covenant code of conduct.

Changelog

Changelog is published to Releases.

License

MIT

You can’t perform that action at this time.