Files
usdt/sql/usdt_config_wallet_envelope.sql
2026-10-07 23:03:33 -04:00

46 lines
2.5 KiB
SQL
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
-- ================================================================
-- usdt_config 钱包信封加密字段迁移
--
-- 说明:
-- 1. encrypted_mnemonic 是 AES-256-GCM 加密后的助记词密文(Base64)。
-- 2. encrypted_dek 是使用配置密码派生 KEK 后包装的 DEK(Base64)。
-- 3. nonce、salt、password_hash 都是二进制值的 Base64 表示。
-- 4. 数据库绝不能保存 configuration_password、明文助记词、DEK 或 KEK。
-- 5. 本脚本按 WalletEnvelopeEncryptionDemo.EncryptedEnvelope 字段命名。
--
-- 执行前请确认 usdt_config 已存在,并在生产环境先备份数据库。
-- ================================================================
ALTER TABLE `usdt_config`
ADD COLUMN `version` INT NOT NULL DEFAULT 1
COMMENT '信封版本;配置密码轮换成功后递增',
ADD COLUMN `encryption_algorithm` VARCHAR(32) NOT NULL DEFAULT 'AES-256-GCM'
COMMENT '助记词和 DEK 使用的加密算法',
ADD COLUMN `password_kdf` VARCHAR(64) NOT NULL DEFAULT 'PBKDF2-HMAC-SHA256'
COMMENT '配置密码派生算法',
ADD COLUMN `iterations` INT NOT NULL DEFAULT 210000
COMMENT 'PBKDF2 迭代次数;轮换时按当前安全策略更新',
ADD COLUMN `encrypted_mnemonic` VARCHAR(1024) NOT NULL
COMMENT 'AES-GCM 加密后的助记词密文,Base64;禁止保存明文助记词',
ADD COLUMN `mnemonic_nonce` VARCHAR(64) NOT NULL
COMMENT '助记词 AES-GCM nonce,Base64,通常为 12 字节',
ADD COLUMN `encrypted_dek` VARCHAR(256) NOT NULL
COMMENT '由 KEK 包装后的 DEK,Base64;禁止保存明文 DEK',
ADD COLUMN `dek_nonce` VARCHAR(64) NOT NULL
COMMENT 'DEK AES-GCM nonce,Base64,通常为 12 字节',
ADD COLUMN `key_salt` VARCHAR(128) NOT NULL
COMMENT '配置密码派生 KEK 使用的 salt,Base64',
ADD COLUMN `password_salt` VARCHAR(128) NOT NULL
COMMENT '配置密码校验哈希使用的独立 salt,Base64',
ADD COLUMN `password_hash` VARCHAR(128) NOT NULL
COMMENT 'PBKDF2 配置密码校验值,Base64;不是可逆密码',
ADD COLUMN `rotated_at` TIMESTAMP NULL DEFAULT NULL
COMMENT '最近一次配置密码轮换时间';
-- 推荐约束:确保数据库中不存在空的信封字段。
-- 如果已有历史记录,请先完成数据回填后再执行以下语句。
-- ALTER TABLE `usdt_config`
-- MODIFY COLUMN `encrypted_mnemonic` VARCHAR(1024) NOT NULL,
-- MODIFY COLUMN `encrypted_dek` VARCHAR(256) NOT NULL;