{"id":29560920,"url":"https://github.com/decred/dcrros","last_synced_at":"2025-07-18T15:39:23.550Z","repository":{"id":44720547,"uuid":"276786903","full_name":"decred/dcrros","owner":"decred","description":null,"archived":false,"fork":false,"pushed_at":"2022-12-05T12:16:09.000Z","size":480,"stargazers_count":10,"open_issues_count":3,"forks_count":4,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-04-13T16:25:42.783Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/decred.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-07-03T02:15:17.000Z","updated_at":"2024-01-12T18:14:00.000Z","dependencies_parsed_at":"2023-01-23T03:30:12.077Z","dependency_job_id":null,"html_url":"https://github.com/decred/dcrros","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/decred/dcrros","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decred%2Fdcrros","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decred%2Fdcrros/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decred%2Fdcrros/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decred%2Fdcrros/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/decred","download_url":"https://codeload.github.com/decred/dcrros/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decred%2Fdcrros/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265787586,"owners_count":23828458,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-07-18T15:39:22.662Z","updated_at":"2025-07-18T15:39:23.534Z","avatar_url":"https://github.com/decred.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Decred/Rosetta middleware service\n\n[![ISC License](https://img.shields.io/badge/license-ISC-blue.svg)](http://copyfree.org)\n[![ISC License](https://img.shields.io/badge/rosetta-1.4.10-blue.svg)](https://rosetta-api.org)\n[![ISC License](https://img.shields.io/badge/rosetta-cli-0.7.2-blue.svg)](https://github.com/coinbase/rosetta-cli)\n\n`dcrros` (Decred/Rosetta) is a middleware service that provides access to the [Decred](https://www.decred.org) network via a [Rosetta-compatible](https://rosetta-api.org) API.\n\nThis version is currently compatible to Rosetta version **1.4.10** and passes\nthe `check:data` and `check:construction` validations done by the `rosetta-cli`\ntool version **0.7.2**.\n\n`dcrros` works as an API conversion layer and cache for the data required by Rosetta implementations. It requires a running `dcrd` node to use for authoritative blockchain data. For technical information about the mapping between Decred and Rosetta concepts, please see the [mapping](/docs/mapping.md) document.\n\n# Running via Docker\n\nThe recommended way to run `dcrros` as specified by the Rosetta documentation, is by running via [Docker](https://docker.com).\n\nThe [Dockerfile](/Dockerfile) contained in this repository contains everything needed to run a `dcrros` container along with an embedded `dcrd`. The simplest command to build and run a mainnet instance using the current stable version and without any requirements in the host OS other than Docker is to use:\n\n```shell\n$ docker build --tag dcrros:stable https://raw.githubusercontent.com/decred/dcrros/master/Dockerfile\n$ docker run --rm -p 9128:9128/tcp dcrros:stable\n```\n\nIf the port of the `dcrros` service is exposed (like in the previous command), the [rosetta-cli](https://github.com/coinbase/rosetta-cli) tool can be used to perform some simple checks on the service, such as (note the use of an appropriate `--configuration-file`):\n\n```shell\n$ rosetta-cli --configuration-file docs/roscli-mainnet.json view:block 0\n```\n \nFor additional configuration options, including how to run on the test network, please see the [Docker Options](/docs/docker.md) document.\n\n# Developing\n\n`dcrros` is currently developed on go version 1.16+. It follows the same conventions as other Decred tools, such as [dcrd](https://github.com/decred/dcrd) and [dcrwallet](https://github.com/decred/dcrwallet).\n\nA guide for using simnet for development purposes is available in\n[docs/simnet-development.md](/docs/simnet-development.md).\n\n# E2E Testing\n\nAn End-to-End test suite, including running the Rosetta CLI's `check:data` and `check:construction` tests is included in [/internal/e2etest](/internal/e2etest). This test suite runs on a local simnet instance that exercises a large number of common on-chain operations found in the Decred chain.\n\nThe tests can also be run via Docker by using the included [Dockerfile.e2e](/Dockerfile.e2e):\n\n```shell\n$ docker build --tag dcrros:e2e -f Dockerfile.e2e .\n$ docker run --rm dcrros:e2e\n```\n\n# License\n\n`dcrros` is licensed under the [copyfree](http://copyfree.org) ISC License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdecred%2Fdcrros","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdecred%2Fdcrros","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdecred%2Fdcrros/lists"}