Skip to content

Conversation

@sangwon0001
Copy link
Contributor

Description

As a Stacks node operator, I would like to use the latest archive files from Hiro to seed my chainstate. The Hiro archive has updated to newer versions and changed the compression format from tar.gz to tar.zst for better compression ratios.

  1. Motivation for change: Hiro archive files have been updated with new versions and a new compression format (tar.zst)
  2. What was changed:
    • Update STACKS_BLOCKCHAIN_VERSION to 3.3.0.0.3
    • Update STACKS_SIGNER_VERSION to 3.3.0.0.3.0
    • Update STACKS_BLOCKCHAIN_API_VERSION to 8.13.6
    • Update POSTGRES_VERSION to 17
    • Change chainstate archive format from tar.gz to tar.zst
    • Add zstd extraction support with availability check
  3. How does this impact application developers: Node operators using seed-chainstate.sh will now need zstd installed for extraction
  4. Link to relevant issues and documentation: https://docs.hiro.so/hiro-archive
  5. Examples:
# Install zstd if not already installed
# macOS
brew install zstd

# Ubuntu/Debian
apt install zstd

# Then run the seed script as usual
sudo ./scripts/seed-chainstate.sh

Type of Change

  • Bug fix (alignment with current Hiro archive format)

Does this introduce a breaking change?

  • Users must have zstd installed for chainstate extraction
  • The script will exit with an error message if zstd is not available

Are documentation updates required?

  • Link to documentation updates: README should mention zstd as a dependency

Testing information

  1. Is testing required for this change? Yes
  2. Steps to test:
    • Ensure zstd is installed
    • Run sudo ./scripts/seed-chainstate.sh
    • Verify chainstate downloads and extracts successfully
  3. Affected code paths: scripts/seed-chainstate.sh, sample.env
  4. Things to watch out for: Ensure zstd is available on the system before running

Checklist

  • Code is commented where needed
  • Unit test coverage for new or modified code paths
  • npm run test passes
  • Changelog is updated
  • Tag 1 of @wileyj

@CLAassistant
Copy link

CLAassistant commented Jan 20, 2026

CLA assistant check
All committers have signed the CLA.

- Update STACKS_BLOCKCHAIN_VERSION to 3.3.0.0.3
- Update STACKS_SIGNER_VERSION to 3.3.0.0.3.0
- Update STACKS_BLOCKCHAIN_API_VERSION to 8.13.6
- Update POSTGRES_VERSION to 17
- Change chainstate archive format from tar.gz to tar.zst
- Add zstd extraction support with availability check

Co-Authored-By: Claude Opus 4.5 <[email protected]>
@sangwon0001 sangwon0001 force-pushed the chore/update-archive-versions-and-zstd-support branch from c1f7013 to 55c32a5 Compare January 20, 2026 02:28
if command -v zstd &> /dev/null; then
zstd -d -c "${CHAINDATA_DEST}" | tar -xvf - -C "${SCRIPTPATH}/persistent-data/${NETWORK}/stacks-blockchain/" || exit_error "${COLRED}Error${COLRESET} extracting stacks-blockchain chainstate data"
else
exit_error "${COLRED}Error${COLRESET} - zstd is required for extraction. Install with: brew install zstd (macOS) or apt install zstd (Ubuntu)"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
exit_error "${COLRED}Error${COLRESET} - zstd is required for extraction. Install with: brew install zstd (macOS) or apt install zstd (Ubuntu)"
exit_error "${COLRED}Error${COLRESET} - zstd is required for extraction. Install with: brew install zstd (macOS) or apt install zstd (Debian based systems)"

STACKS_BLOCKCHAIN_VERSION=3.3.0.0.1
STACKS_SIGNER_VERSION=3.3.0.0.1.0
STACKS_BLOCKCHAIN_API_VERSION=8.13.4
STACKS_BLOCKCHAIN_VERSION=3.3.0.0.3
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
STACKS_BLOCKCHAIN_VERSION=3.3.0.0.3
STACKS_BLOCKCHAIN_VERSION=3.3.0.0.4

STACKS_SIGNER_VERSION=3.3.0.0.1.0
STACKS_BLOCKCHAIN_API_VERSION=8.13.4
STACKS_BLOCKCHAIN_VERSION=3.3.0.0.3
STACKS_SIGNER_VERSION=3.3.0.0.3.0
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
STACKS_SIGNER_VERSION=3.3.0.0.3.0
STACKS_SIGNER_VERSION=3.3.0.0.4.0

Copy link
Contributor

@wileyj wileyj left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Few nits, but overall good to go.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants