Domain Migrations for Hiro-hosted Services

Domain Migrations for Hiro-hosted Services

We are migrating!

Why:

Hiro-hosted services currently running on stacks.co and the much older Blockstack.org are now migrating to hiro.so. This move is part of an ongoing effort to better reflect the nature of the products and ensure that all Hiro products operate on Hiro’s domain. This migration will be rolled out over the next few weeks, and we expect to fully migrate all our products in April. We will share the latest updates for each of these as we roll out the changes.

What:

In addition to our Hiro-built and hosted APIs, we operate and host a few mission-critical services for our ecosystem, including (but not limited to) our private Bitcoin nodes, Seed nodes, Gaia storage, and API. We have been operating these services at the stacks.co domain, and now as we revamp our infrastructure with new K8s clusters, this also is an excellent time for us to move them to the hiro.so domain and branding to better reflect their status and ownership.

This domain migration will also impact explorer.stacks.so. The Explorer will migrate to explorer.hiro.so .

If you are a developer using our:

  • API, Clarinet or stacks.js: You need to use our new home for the API: https://api.hiro.so/ when the service goes live at an announced date in an upcoming post.

If you are a node operator:

If you use the explorer:
The experience will be the same (or better!) as before. Traffic to explorer.stacks.so will simply redirect to explorer.hiro.so. Check out our release roundups for monthly updates on the latest improvements to the Stacks Explorer.

Here’s more detail on each service being migrated and their new homes.

Screen Shot 2023-03-10 at 12.24.08 PM

What’s Next :

  1. In the upcoming weeks, we will migrate the remainder of our services across Testnet and Mainnet, starting with the API .
  2. In addition to the API, Hiro hosts a Registrar service at the centre of registration for subdomains like .id, .stx, and .btc as part of Phase 3, we will migrate our Registrar services to their new homes.
  3. Hiro also hosts Gaia Hub, which is used as a decentralized storage layer across the Stacks ecosystem. We will also be migrating this at the tail end of this process.
  4. We will share the updated new homes and timelines for all these services as we roll these new clusters out. We will redirect traffic from our current stacks.co and Blockstack.org to hiro.so.

We will notify our users ahead of each phase of the upcoming migration.

Redirection:

The following services will be redirected from their existing traffic destination for a service running on the old cluster (app.stacks.co or app.blockstack.org) to a service running on the new cluster (app.hiro.so) for a short time during each phase:

API, Blockchain Pools, Explorer, Registrar, Gaia Hub

To continue using the following services domains, you will need to start using the new URLs; we will eventually decommission the old service domains: Seeds and Gaia Storage

Watch out for more updates in this space, and contact us if you have any questions.

Updates:

  • UPDATE 1: Mar 14 2023:

    • If you are a node operator, please update the bootstrap_node config now in your config.toml. You will have trouble keeping up to the chain tip without this update. We will be updating our seed DNS records
      on Mar 15 2023.

      Bootstrap Nodes:

      Testnet: 029266faff4c8e0ca4f934f34996a96af481df94a89b0c9bd515f3536a95682ddc@seed.testnet.hiro.so:20444

      Mainnet: 02196f005965cebe6ddc3901b7b1cc1aa7a88f305bb8c5893456b8f9a605923893@seed.mainnet.hiro.so:20444

      Reference

  • UPDATE 2: Mar 21 2023:

  • UPDATE 3: Apr 07 2023:

    • We successfully migrated the explorer from explorer.stacks.co to explorer.hiro.so. We have 301 HTTP redirect set up, if your app doesn’t handle redirects , please update it ASAP.
3 Likes

I am interested to see how the gaia storage move will work. 500k zone files need to be updated?

Same question!

Yeah, you’re going to want to keep gaia.blockstack.org and hub.blockstack.org around.

Note: Archiver already runs on hiro.so and will not be part of the migration

All valid concerns on Gaia Hub, Gaia warrants an alternative strategy than copying the existing data over. For some context: Requesting Input: Gaia Hub - Costs and Future Plan - #15 by movingforward Gaia storage is the bulk of Hiro’s monthly infra expense, it has been sky rocketing and not sustainable for us in the long term.

An ideal solution will be for us to start from scratch in the new clusters which isn’t necessarily the ideal solution for our users. In the following weeks we will be actively reaching out to all our users to discuss a timeline and strategy for the migration.