From 53e07717070b9313922cc93a2c31e4ca7326f14a Mon Sep 17 00:00:00 2001
From: Jean-Paul Calderone <exarkun@twistedmatrix.com>
Date: Fri, 23 Jul 2021 09:15:31 -0400
Subject: [PATCH] some notes about schema changes

---
 src/_zkapauthorizer/schema.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/src/_zkapauthorizer/schema.py b/src/_zkapauthorizer/schema.py
index 24c402b..8fe7dc6 100644
--- a/src/_zkapauthorizer/schema.py
+++ b/src/_zkapauthorizer/schema.py
@@ -192,11 +192,18 @@ _UPGRADES = {
         """,
 
         """
+        -- Create one redemption group for every existing, redeemed voucher.
+        -- These tokens were probably *not* all redeemed in one group but
+        -- we've only preserved one public key for them so we can't do much
+        -- better than this.
         INSERT INTO [redemption-groups] ([voucher], [public-key], [spendable])
             SELECT DISTINCT([number]), [public-key], 1 FROM [vouchers] WHERE [state] = "redeemed"
         """,
 
         """
+        -- Give each voucher a count of "sequestered" tokens.  Currently,
+        -- these are unspendable tokens that were issued using a disallowed
+        -- public key.
         ALTER TABLE [vouchers] ADD COLUMN [sequestered-count] integer NOT NULL DEFAULT 0
         """,
 
-- 
GitLab