This repository contains all specification files used to generate code for the Rosetta API.
Build once. Integrate your blockchain everywhere.
Rosetta is an open-source specification and set of tools that makes integrating with blockchains simpler, faster, and more reliable. The Rosetta API is specified in the OpenAPI 3.0 format.
No installation is required, as the repository only includes specification files.
You can find the Rosetta API documentation at rosetta-api.org.
Check out the Getting Started section to start diving into Rosetta.
Our documentation is divided into the following sections:
You may contribute to the
rosetta-specifications project in various ways:
Read our Contributing documentation for more information.
When you've finished an implementation for a blockchain, share your work in the ecosystem category of the community site. Platforms looking for implementations for certain blockchains will be monitoring this section of the website for high-quality implementations they can use for integration. Make sure that your implementation meets the expectations of any implementation.
- rosetta-sdk-go — The
rosetta-sdk-goSDK provides a collection of packages used for interaction with the Rosetta API specification. Much of the SDK code is generated from this, the rosetta-specifications repository.
- rosetta-cli — Use the
rosetta-clitool to test your Rosetta API implementation. The tool also provides the ability to look up block contents and account balances.
To help you with examples, we developed complete Rosetta 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.
While working on improvements to this repository, we recommend that you use these commands to check your code:
make depsto install dependencies
make gento generate the specification files
make check-validto ensure specification is valid
make releaseto 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 rosetta-sdk-go that is commonly used by callers and anyone in the community can implement additional schemes there.
This project is available open source under the terms of the Apache 2.0 License.
© 2022 Coinbase