Textile implementation in Go
This repository contains the core API, daemon, and command-line client, as well as bindings for mobile (iOS/Android) applications.
Textile provides encrypted, recoverable, schema-based, and cross-application data storage built on IPFS and libp2p. We like to think of it as a decentralized data wallet with built-in protocols for sharing and recovery, or more simply, an open and programmable iCloud.
Please see Textile Docs for more.
Join us on our public Slack channel for news, discussions, and status updates. Check out our blog for the latest posts and announcements.
Textile is still under heavy development and no part of it should be used before a thorough review of the underlying code and an understanding that APIs and protocols may change rapidly. There may be coding mistakes and the underlying protocols may contain design flaws. Please let us know immediately if you have discovered a security vulnerability.
Please also read the security note for go-ipfs.
Textile is a set of tools and trust-less infrastructure for building censorship resistant and privacy preserving applications.
While interoperable with the whole IPFS peer-to-peer network, Textile-flavored peers represent an additional layer or sub-network of users, applications, and services.
With good encryption defaults and anonymous, disposable application services like cafes, Textile aims to bring the decentralized internet to real products that people love.
Continue reading about Textile...
Installation instructions for the command-line tool and daemon are in the docs.
The Tour of Textile goes through many examples and use cases. textile --help
provides a quick look at the available APIs:
Usage:
textile [OPTIONS] <command>
Help Options:
-h, --help Show this help message
Available commands:
account Manage a wallet account
blocks View thread blocks
cafes Manage cafes
chat Start a thread chat
commands List available commands
comments Manage thread comments
config Get and set config values
contacts Manage contacts
daemon Start the daemon
docs Print docs
feed Paginate thread content as a consumable feed
files Manage thread files
init Init the node repo and exit
invites Manage thread invites
ipfs Access IPFS commands
likes Manage thread likes
logs List and control subsystem logs
messages Manage thread messages
migrate Migrate the node repo and exit
notifications Manage notifications
ping Ping another peer
profile Manage public profile
subscribe Subscribe to thread updates
summary Get a summary of local data
threads Manage threads
tokens Manage Cafe access tokens
version Print version and exit
wallet Manage or create an account wallet
git clone git@github.com:textileio/go-textile.git
- go >= 1.12
- node >= 10.0
Extra setup steps are needed to build the bindings for iOS or Android, as gomobile
does not yet support go modules. You'll need to move the go-textile source into your GOPATH
(like pre-go1.11 development), before installing and initializing the gomobile
tools:
go get golang.org/x/mobile/cmd/gomobile
gomobile init
Now you can execute the iOS and Android build tasks below. For the other build tasks, the source must not be under GOPATH
. Go 1.13 is supposed to bring module support to gomobile
, at which point we can remove this madness!
make setup
make build
make test
make ios
make android
make docs
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.