Skip to content

Instantly share code, notes, and snippets.

@emberian
Forked from amc-ie/preupgraderelease.md
Last active March 29, 2024 22:53
Show Gist options
  • Save emberian/d621edda81b0ad6ee7af0a6858784e8c to your computer and use it in GitHub Desktop.
Save emberian/d621edda81b0ad6ee7af0a6858784e8c to your computer and use it in GitHub Desktop.
Migration Tooling Release

April Fool's! These release notes are from ChatGPT.

You might want to read the real deal.

πŸš€πŸ’₯ O(1) Labs Team is ALL FIRED UP to Drop the LATEST Devnet Archive Migration Tools! πŸ’₯πŸš€

πŸŽ‰ BIG NEWS, Friends! πŸŽ‰ We're thrilled to bits to unveil the shiny new gadgets you'll need for a smooth sail through the Devnet Archive Database Migration! Get ready to kick things up a notch before the Berkeley Upgrade hits Devnet. πŸš€

What's Cooking? πŸ”₯

  1. mina-archive-maintenance: Your go-to tool to make sure your Devnet Archive Database is sparkling clean and fully up-to-date. Missing some blocks? No sweat! This genius tool patches them up with blocks exported as JSON by the mina daemon. 🌟 Find these golden blocks at gs://mina_network_block_data. πŸ› οΈ

  2. mina-berkeley-migration-script: A smart script that juggles multiple tools to seamlessly migrate your Devnet database and ensures it's as good as new. πŸ“ˆ

πŸ“š For the ins and outs on wielding these tools like a pro, peek at the documentation drafts or dive into the reference info. πŸ“š

Setting Up Shop πŸ› οΈ

Heads Up! 🌟 Opt for a fresh machine/VM for this mission. Let's keep it clean until the ultimate Devnet hardfork blueprint is ready for action. 🌐

Supported Scenes: macOS, Linux (Debian 10, 11, and Ubuntu 20.04 LTS), and any Docker-friendly host machine.

Debian Goodies:

Tap into the Debian Repository: Kick things off by refreshing the unstable Debian Repository for your platform with these magic spells:

sudo rm /etc/apt/sources.list.d/mina*.list
sudo echo "deb [trusted=yes] http://packages.o1test.net $(lsb_release -cs) unstable" | sudo tee /etc/apt/sources.list.d/mina.list
sudo apt-get update

Then, snag the package(s) you're after:

  • Mina Migration Toolkit: sudo apt-get install --allow-downgrades -y mina-archive-migration=3.0.0-rc0-7a3c681
  • Mina Berkeley Archive Schema: create_schema.sql & zkapp_tables.sql (both are must-haves)

Docker Delights:

Each Docker image is tailored for the supported platforms. Swap CODENAME with your choice of focal, buster, or bullseye to match your Docker base image.

  • Mina Archive Migration Tooling: gcr.io/o1labs-192920/mina-archive:3.0.0-rc0-7a3c681-CODENAME
  • Mina Berkeley Archive Schema: create_schema.sql & zkapp_tables.sql (both essential)

Testing 101 πŸ§ͺ

Dive into the usual Devnet connection docs, but keep an eye out for the new requirement: ample disk space for storing the entire chain history in a hefty JSON format. πŸ”„ If disk space is tight but patience is a virtue, the mina-berkeley-migration-script --delete-blocks switch is your new BFF. Prefer to dodge the download-migrate dance? mina-berkeley-migration-script --prefetch-blocks is here to save the day! πŸš€

Grab a testing block bundle to shave off some prep time. It's a hefty 50GB that unfolds into about 80GB. πŸ“¦

Peek into the full details above for the ultimate guide to marching through the Devnet migration like a champ. πŸ†

Step-By-Step Migration Guide: Dive deep with our step-by-step example and script documentation to master the migration process. πŸ“

Mina Riddle 🎩✨

Let's add a dash of fun with a riddle, shall we? Amidst the battle with software gremlins, one mainnet block gave us a chuckle and a moment of light relief. Any guesses why block 241082 turned out to be more amusing than anticipated? πŸ€”

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