mesh-specifications

mesh-specifications copied to clipboard

Mesh Specifications

This repository contains all specification files used to generate code for the Mesh API.

Build once. Integrate your blockchain everywhere.

Overview

Mesh is an open-source specification and set of tools that makes integrating with blockchains simpler, faster, and more reliable. The Mesh API is specified in the OpenAPI 3.0 format.

Requests and responses can be crafted with auto-generated code using Swagger Codegen or OpenAPI Generator, are human-readable (easy to debug and understand), and can be used in servers and browsers.

Installation

No installation is required, as the repository only includes specification files.

Documentation

You can find the Mesh API documentation here.

Contributing

You may contribute to the mesh-specifications project in various ways:

• Asking Questions
• Providing Feedback
• Reporting Issues

Read our Contributing documentation for more information.

Related Projects

• mesh-sdk-go — The mesh-sdk-go SDK provides a collection of packages used for interaction with the Mesh API specification. Much of the SDK code is generated from this, the mesh-specifications repository.
• mesh-cli — Use the mesh-cli tool to test your Mesh API implementation. The tool also provides the ability to look up block contents and account balances.

Reference Implementations

To help you with examples, we developed complete Mesh API reference implementations for Bitcoin and Ethereum. Developers of Bitcoin-like or Ethereum-like blockchains may find it easier to fork these reference implementations than to write an implementation from scratch.

You can also find community implementations for a variety of blockchains in the mesh-ecosystem repository.

Specification Development

While working on improvements to this repository, we recommend that you use these commands to check your code:

• make deps to install dependencies
• make gen to generate the specification files
• make check-valid to ensure specification is valid
• make release to check if code passes all tests run by CircleCI

Adding New CurveTypes or SignatureTypes

Unlike the Data API where there are no global type constraints (e.g., you can specify any operation type), the Construction API has a clearly enumerated list of supported curves and signatures. Each one of these items has a clearly specified format that all implementations should expect to receive.

If a curve or signature you are employing is not enumerated in the specification, you will need to open a PR against the specification to add it along with the standard format it will be represented in.

It is up to the caller of a Construction API implementation to implement key generation and signing for a particular CurveType:SignatureType. There is a keys package in mesh-sdk-go that is commonly used by callers and anyone in the community can implement additional schemes there.

License

This project is available open source under the terms of the Apache 2.0 License.

© 2022 Coinbase