README
¶
Tinyport
Tinyport is a scaffolding tool for cosmos-sdk blockchains. Like tinyseed tinyport is a fork that improves usability through extreme minimalism.
- Build a blockchain with Tinyport in a web-based IDE (stable) or use nightly version
- Check out the latest features in v0.19
Quick start
Open Tinyport in your browser, or install it. Create and start a blockchain:
tinyport scaffold chain github.com/cosmonaut/mars
cd mars
tinyport chain serve
Documentation
To learn how to use Tinyport, check out the Tinyport Documentation. To learn more about how to build blockchain apps with Tinyport, see the Tinyport Developer Tutorials.
To install Tinyport locally on GNU, Linux, or macOS, see Install Tinyport.
To learn more about building a JavaScript frontend for your Cosmos SDK blockchain, see tendermint/vue.
Questions
For questions and support, join the official Tinyport Discord server. The issue list in this repo is exclusively for bug reports and feature requests.
Cosmos SDK Compatibility
Blockchains created with Tinyport use the Cosmos SDK framework. To ensure the best possible experience, use the version of Tinyport that corresponds to the version of Cosmos SDK that your blockchain is built with. Unless noted otherwise, a row refers to a minor version and all associated patch versions.
| Tinyport | Cosmos SDK | IBC | Notes |
|---|---|---|---|
| v0.19.2 | v0.44.5 | v2.0.2 | |
| v0.19 | v0.44 | v1.2.2 | |
| v0.18 | v0.44 | v1.2.2 | tinyport chain serve works with v0.44.x chains |
| v0.17 | v0.42 | Same with Cosmos SDK |
To upgrade your blockchain to the newer version of Cosmos SDK, see the Migration guide.
Contributing
We welcome contributions from everyone. The develop branch contains the development version of the code. You can create a branch from develop and create a pull request, or maintain your own fork and submit a cross-repository pull request.
Important Before you start implementing a new Tinyport feature, the first step is to create an issue on Github that describes the proposed changes.
If you're not sure where to start, check out contributing.md for our guidelines and policies for how we develop Tinyport. Thank you to everyone who has contributed to Tinyport!
Community
Tinyport is a free and open-source product maintained by Notional. Here's where you can find us. Stay in touch.
Directories
¶
| Path | Synopsis |
|---|---|
|
tinyport
|
|
|
errors
Package sperrors holds tinyport spesific errors.
|
Package sperrors holds tinyport spesific errors. |
|
internal/tools/gen-cli-docs
this tool generates Tinyport CLI docs to be placed in the docs/cli dir and deployed on docs.tinyport.network.
|
this tool generates Tinyport CLI docs to be placed in the docs/cli dir and deployed on docs.tinyport.network. |
|
pkg/chaincmd/runner
Package chaincmdrunner provides a high level access to a blockchain's commands.
|
Package chaincmdrunner provides a high level access to a blockchain's commands. |
|
pkg/cliquiz
Package cliquiz is a tool to collect answers from the users on cli.
|
Package cliquiz is a tool to collect answers from the users on cli. |
|
pkg/cmdrunner/exec
Package exec provides easy access to command execution for basic uses.
|
Package exec provides easy access to command execution for basic uses. |
|
pkg/confile
Package confile is helper to load and overwrite configuration files.
|
Package confile is helper to load and overwrite configuration files. |
|
pkg/cosmosanalysis
Package cosmosanalysis provides a toolset for statically analysing Cosmos SDK's source code and blockchain source codes based on the Cosmos SDK
|
Package cosmosanalysis provides a toolset for statically analysing Cosmos SDK's source code and blockchain source codes based on the Cosmos SDK |
|
pkg/cosmosclient
Package cosmosclient provides a standalone client to connect to Cosmos SDK chains.
|
Package cosmosclient provides a standalone client to connect to Cosmos SDK chains. |
|
pkg/cosmosfaucet
Package cosmosfaucet is a faucet to request tokens for sdk accounts.
|
Package cosmosfaucet is a faucet to request tokens for sdk accounts. |
|
pkg/ctxreader
Package ctxreader brings context.Context to io.Reader
|
Package ctxreader brings context.Context to io.Reader |
|
pkg/events
Package events provides functionalities for packages to log their states as events for others to consume and display to end users in meaningful ways.
|
Package events provides functionalities for packages to log their states as events for others to consume and display to end users in meaningful ways. |
|
pkg/gacli
Package gacli is a client for Google Analyrics to send data points for hint-type=event.
|
Package gacli is a client for Google Analyrics to send data points for hint-type=event. |
|
pkg/goanalysis
Package goanalysis provides a toolset for statically analysing Go applications
|
Package goanalysis provides a toolset for statically analysing Go applications |
|
pkg/goenv
Package goenv defines env variables known by Go and some utilities around it.
|
Package goenv defines env variables known by Go and some utilities around it. |
|
pkg/httpstatuschecker
httpstatuschecker is a tool check health of http pages.
|
httpstatuschecker is a tool check health of http pages. |
|
pkg/lineprefixer
Package lineprefixer is a helpers to add prefixes to new lines.
|
Package lineprefixer is a helpers to add prefixes to new lines. |
|
pkg/multiformatname
Package multiformatname provides names automatically converted into multiple naming convention
|
Package multiformatname provides names automatically converted into multiple naming convention |
|
pkg/nodetime
Package nodetime provides a single, and standalone NodeJS runtime executable that contains several NodeJS CLI programs bundled inside where those are reachable via subcommands.
|
Package nodetime provides a single, and standalone NodeJS runtime executable that contains several NodeJS CLI programs bundled inside where those are reachable via subcommands. |
|
pkg/nodetime/programs/sta
Package sta provides access to swagger-typescript-api CLI.
|
Package sta provides access to swagger-typescript-api CLI. |
|
pkg/nodetime/programs/ts-proto
Package tsproto provides access to protoc-gen-ts_proto protoc plugin.
|
Package tsproto provides access to protoc-gen-ts_proto protoc plugin. |
|
pkg/prefixgen
Package prefixgen is a prefix generation helper for log messages and any other kind.
|
Package prefixgen is a prefix generation helper for log messages and any other kind. |
|
pkg/protoanalysis
Package protoanalysis provides a toolset for analyzing proto files and packages.
|
Package protoanalysis provides a toolset for analyzing proto files and packages. |
|
pkg/protoc
Package protoc provides high level access to protoc command.
|
Package protoc provides high level access to protoc command. |
|
pkg/xfilepath
Package xfilepath defines functions to define path retrievers that support error handling
|
Package xfilepath defines functions to define path retrievers that support error handling |
|
services/scaffolder
Package scaffolder initializes Tinyport apps and modifies existing ones to add more features in a later time.
|
Package scaffolder initializes Tinyport apps and modifies existing ones to add more features in a later time. |
|
templates/field
Package field provides methods to parse a field provided in a command with the format name:type
|
Package field provides methods to parse a field provided in a command with the format name:type |