Skip to content

Latest commit

 

History

History
37 lines (22 loc) · 1.39 KB

README-rosetta.md

File metadata and controls

37 lines (22 loc) · 1.39 KB
Raw

Testing the Rosetta APIs

Build and run the rosetta.Dockerfile image:

docker build -t rosetta:stable -f rosetta.Dockerfile .
docker run -d -p 3999:3999 --mount source=rosetta-data,target=/data \
    --name rosetta rosetta:stable

By default, this will connect to the testnet. To run a local node, run

docker run -d -p 3999:3999 --mount source=rosetta-data,target=/data \
    --name rosetta -e STACKS_NETWORK=mocknet rosetta:stable

Optionally, you can seed the chainstate for testnet/mainnet using Hiro archive data:

docker run -d -p 3999:3999 --mount source=rosetta-data,target=/data \
        --name rosetta -e SEED_CHAINSTATE=true rosetta:stable

Use a recent version of rosetta-cli to test the endpoints:

rosetta-cli --configuration-file rosetta-cli-config/rosetta-config.json \
    view:block 1

rosetta-cli --configuration-file rosetta-cli-config/rosetta-config.json \
    check:data

rosetta-cli will sync with the blockchain until it reaches the tip, and then exit, displaying the test results.

At present, account reconciliation is disabled; proper testing of that requires token transfer transactions while rosetta-cli is running.

Documentation for the Rosetta APIs can be found at

https://hirosystems.github.io/stacks-blockchain-api/