security: remove .env from tracking (contains secrets)

apps/api/src/services/crypto.service.ts

@@ -0,0 +1,144 @@
+import { randomBytes, createCipheriv, createDecipheriv, timingSafeEqual } from 'crypto';
+import { fetchVaultKV2 } from '../config/vault';
+
+/**
+ * Symmetric encryption (AES-256-GCM) для хранения мнемоник юзеров в БД.
+ * Master-key читается из Vault при старте + при каждой ротации ключей.
+ *
+ * Storage layout (base64):
+ *   IV(12) || ciphertext(N) || authTag(16)
+ *
+ * Ключ — 32 байта (256 бит), храним в Buffer, нигде на диск не пишем.
+ * Если ключ не загружен — encrypt/decrypt бросают ошибку (fail-secure).
+ */
+
+const KEY_LEN = 32; // 256-bit AES key
+const IV_LEN = 12;  // GCM standard nonce
+const TAG_LEN = 16; // GCM auth tag
+
+let masterKey: Buffer | null = null;
+
+/**
+ * Установить master-key. Вызывается ОДНОКРАТНО при первом старте.
+ * Передача null или повторная установка после успешной загрузки — запрещено,
+ * это бы убило все существующие encrypted_mnemonic.
+ */
+export function swapMasterKey(newKey: Buffer): void {
+  if (!newKey || newKey.length !== KEY_LEN) {
+    throw new Error(`swapMasterKey: invalid key (expected ${KEY_LEN} bytes)`);
+  }
+  if (masterKey) {
+    // Уже загружен — повторная установка опасна. Если ключ совпадает — silent no-op.
+    // Если отличается — это либо ротация (запрещена), либо bug, либо атака.
+    throw new Error('swapMasterKey: master key already loaded; rotation is not supported');
+  }
+  masterKey = newKey;
+}
+
+/**
+ * Проверить, отличается ли свежий fetched-ключ от установленного in-memory.
+ * Используется для WARN-логирования при ротации в Vault (операторская ошибка).
+ */
+export function masterKeyMatches(candidate: Buffer): boolean {
+  if (!masterKey || !candidate || candidate.length !== KEY_LEN) return false;
+  return masterKey.equals(candidate);
+}
+
+export function isCryptoReady(): boolean {
+  return masterKey !== null && masterKey.length === KEY_LEN;
+}
+
+/**
+ * Pre-fetch master-key из Vault. НЕ мутирует глобал — возвращает Buffer.
+ * Throws при отсутствии или невалидном формате.
+ */
+export async function fetchMasterKey(
+  addr: string,
+  token: string,
+  mount: string,
+  path: string,
+): Promise<Buffer> {
+  const secrets = await fetchVaultKV2(addr, token, mount, path);
+  if (!secrets) {
+    throw new Error('Failed to load crypto master key from Vault');
+  }
+
+  const raw = secrets.key || secrets.master_key || secrets.MASTER_KEY;
+  if (!raw || typeof raw !== 'string') {
+    throw new Error('Crypto master key invalid: expected hex string in Vault field "key"');
+  }
+
+  // Принимаем только hex 64 chars = 32 bytes
+  if (!/^[0-9a-fA-F]{64}$/.test(raw)) {
+    throw new Error('Crypto master key invalid: must be 64-char hex (32 bytes)');
+  }
+
+  const buf = Buffer.from(raw, 'hex');
+  if (buf.length !== KEY_LEN) {
+    throw new Error(`Crypto master key invalid: got ${buf.length} bytes, expected ${KEY_LEN}`);
+  }
+
+  return buf;
+}
+
+/**
+ * Зашифровать строку (мнемонику) → base64 blob.
+ * Используется при создании коша.
+ */
+export function encryptMnemonic(plaintext: string): string {
+  if (!masterKey) {
+    throw new Error('Crypto service not ready');
+  }
+  if (typeof plaintext !== 'string' || plaintext.length === 0) {
+    throw new Error('encryptMnemonic: plaintext must be non-empty string');
+  }
+
+  const iv = randomBytes(IV_LEN);
+  const cipher = createCipheriv('aes-256-gcm', masterKey, iv);
+  const ct = Buffer.concat([cipher.update(plaintext, 'utf8'), cipher.final()]);
+  const tag = cipher.getAuthTag();
+
+  return Buffer.concat([iv, ct, tag]).toString('base64');
+}
+
+/**
+ * Расшифровать base64 blob → исходная строка.
+ * Используется при send + reveal.
+ */
+export function decryptMnemonic(blob: string): string {
+  if (!masterKey) {
+    throw new Error('Crypto service not ready');
+  }
+  if (typeof blob !== 'string' || blob.length === 0) {
+    throw new Error('decryptMnemonic: blob must be non-empty string');
+  }
+
+  const buf = Buffer.from(blob, 'base64');
+  if (buf.length < IV_LEN + TAG_LEN + 1) {
+    throw new Error('decryptMnemonic: blob too short');
+  }
+
+  const iv = buf.subarray(0, IV_LEN);
+  const tag = buf.subarray(buf.length - TAG_LEN);
+  const ct = buf.subarray(IV_LEN, buf.length - TAG_LEN);
+
+  const decipher = createDecipheriv('aes-256-gcm', masterKey, iv);
+  decipher.setAuthTag(tag);
+
+  try {
+    return Buffer.concat([decipher.update(ct), decipher.final()]).toString('utf8');
+  } catch {
+    // Не пробрасываем оригинальную ошибку — она может содержать sensitive info
+    throw new Error('decryptMnemonic: authentication failed');
+  }
+}
+
+/**
+ * Сравнить два base64-blob'а constant-time (нужно для тестов / sanity).
+ */
+export function constantTimeEqual(a: string, b: string): boolean {
+  const ba = Buffer.from(a);
+  const bb = Buffer.from(b);
+  if (ba.length !== bb.length) return false;
+  return timingSafeEqual(ba, bb);
+}

apps/api/src/services/key-rotation.service.ts

@@ -2,6 +2,7 @@ import { env, getVaultToken } from '../config/env';
 import { vaultAppRoleLogin } from '../config/vault';
 import { fetchJwtKeysFromVault, swapKeyMap, getKeyMapSize } from './jwt.service';
 import { fetchCsrfConfig, swapCsrfConfig } from './csrf.service';
+import { fetchMasterKey, swapMasterKey, masterKeyMatches, isCryptoReady } from './crypto.service';
 import { logger } from '../lib/logger';
 
 const DEFAULT_INTERVAL_MS = 60 * 60 * 1000; // 1 hour
@@ -14,7 +15,7 @@ let currentVaultToken: string | null = null;
  * При любой ошибке оставляем старые значения в памяти, сервис продолжает работать.
  */
 export async function refreshAllKeys(): Promise<void> {
-  const { addr, roleId, secretId, mount, jwtKidPath, jwtKidsPrefix, csrfPath } = env.vault;
+  const { addr, roleId, secretId, mount, jwtKidPath, jwtKidsPrefix, csrfPath, cryptoKeyPath } = env.vault;
 
   if (!addr || !roleId || !secretId) {
     logger.warn('Vault not configured, skipping key refresh');
@@ -33,11 +34,14 @@ export async function refreshAllKeys(): Promise<void> {
     currentVaultToken = fresh;
   }
 
-  // ── Pre-fetch обоих секретов параллельно (НЕ мутируя глобал) ───────────
+  // ── Pre-fetch всех секретов параллельно (НЕ мутируя глобал) ───────────
   const jwtPromise = fetchJwtKeysFromVault(addr, token, mount, jwtKidPath, jwtKidsPrefix);
   const csrfPromise = csrfPath ? fetchCsrfConfig(addr, token, mount, csrfPath) : Promise.resolve(null);
+  // Master-key: первая загрузка обязательна (custodial без него работать не может),
+  // последующие тики толерантны (если упало — оставляем старый ключ).
+  const cryptoPromise = cryptoKeyPath ? fetchMasterKey(addr, token, mount, cryptoKeyPath) : Promise.resolve(null);
 
-  const [jwtResult, csrfResult] = await Promise.allSettled([jwtPromise, csrfPromise]);
+  const [jwtResult, csrfResult, cryptoResult] = await Promise.allSettled([jwtPromise, csrfPromise, cryptoPromise]);
 
   // ── Атомарность: если хоть один обязательный fetch упал — НИЧЕГО не меняем ──
   if (jwtResult.status === 'rejected') {
@@ -48,16 +52,36 @@ export async function refreshAllKeys(): Promise<void> {
     logger.error(`Key refresh ABORTED — CSRF fetch failed: ${csrfResult.reason?.message || csrfResult.reason}`);
     return;
   }
+  // Master-key: если он ещё не загружен — это критическая ошибка (отказ при первом запуске).
+  // Если уже был — оставляем старый (ротация ключа = ломает всю расшифровку, не делаем on rotation).
+  if (cryptoKeyPath && !isCryptoReady() && cryptoResult.status === 'rejected') {
+    logger.error(`Key refresh ABORTED — Crypto master key fetch failed: ${cryptoResult.reason?.message || cryptoResult.reason}`);
+    return;
+  }
 
   // ── Atomic swap (синхронные операции, нельзя прервать) ──────────────────
   swapKeyMap(jwtResult.value);
   if (csrfResult.status === 'fulfilled' && csrfResult.value) {
     swapCsrfConfig(csrfResult.value);
   }
+  // Master-key загружаем ТОЛЬКО при первой инициализации (потом не ротируем — иначе сломаем расшифровку).
+  // Если в Vault положили НОВЫЙ ключ — WARN-log, операторская ошибка.
+  if (cryptoResult.status === 'fulfilled' && cryptoResult.value) {
+    if (!isCryptoReady()) {
+      swapMasterKey(cryptoResult.value);
+      logger.info('Crypto master key loaded');
+    } else if (!masterKeyMatches(cryptoResult.value)) {
+      logger.warn(
+        'Vault crypto/master key DIFFERS from in-memory key. Service continues with old key. ' +
+        'Rotating master-key bricks all existing encrypted_mnemonic — revert Vault or plan re-encryption migration.'
+      );
+    }
+  }
 
   logger.info(
     `Keys refreshed atomically: JWT keys=${getKeyMapSize()}` +
-    (csrfPath ? `, CSRF=${csrfResult.status === 'fulfilled' ? 'updated' : 'unchanged'}` : '')
+    (csrfPath ? `, CSRF=${csrfResult.status === 'fulfilled' ? 'updated' : 'unchanged'}` : '') +
+    `, Crypto=${isCryptoReady() ? 'ready' : 'NOT-READY'}`
   );
 }
 

apps/api/src/services/wallet-generator.service.ts

@@ -0,0 +1,121 @@
+/**
+ * Wallet generation: BIP39 mnemonic + multi-chain address derivation.
+ * Server-side для custodial-флоу.
+ *
+ * Поддерживаемые chains (BIP44):
+ *   ETH/BSC — m/44'/60'/0'/0/0  (secp256k1, EIP-55 checksum)
+ *   BTC     — m/84'/0'/0'/0/0   (P2WPKH bech32)
+ *   TRX     — m/44'/195'/0'/0/0 (secp256k1, base58check + prefix 0x41)
+ *   SOL     — m/44'/501'/0'/0'  (ed25519)
+ */
+
+import { ethers } from 'ethers';
+import { createHash } from 'crypto';
+import bs58 from 'bs58';
+import * as bip39 from 'bip39';
+import { BIP32Factory } from 'bip32';
+import * as ecc from 'tiny-secp256k1';
+import * as bitcoin from 'bitcoinjs-lib';
+import { Keypair } from '@solana/web3.js';
+import { derivePath } from 'ed25519-hd-key';
+import type { ChainCode } from '../lib/address-validators';
+
+const bip32 = BIP32Factory(ecc);
+
+export const DERIVATION_PATHS: Record<ChainCode, string> = {
+  ETH: "m/44'/60'/0'/0/0",
+  BSC: "m/44'/60'/0'/0/0",
+  BTC: "m/84'/0'/0'/0/0",
+  TRX: "m/44'/195'/0'/0/0",
+  SOL: "m/44'/501'/0'/0'",
+};
+
+export const ALL_CHAINS: ChainCode[] = ['ETH', 'BSC', 'BTC', 'TRX', 'SOL'];
+
+export interface DerivedWallet {
+  chain: ChainCode;
+  address: string;
+  derivationPath: string;
+}
+
+/**
+ * Сгенерить 12-словную BIP39 мнемонику.
+ */
+export function generateMnemonic(): string {
+  return bip39.generateMnemonic(128);
+}
+
+/**
+ * Валидация существующей mnemonic (не используется в текущем флоу — оставлено на будущее).
+ */
+export function validateMnemonic(m: string): boolean {
+  return bip39.validateMnemonic(m);
+}
+
+/**
+ * Деривить адреса для всех chains из одной mnemonic.
+ */
+export async function deriveAllAddresses(mnemonic: string): Promise<DerivedWallet[]> {
+  if (!bip39.validateMnemonic(mnemonic)) {
+    throw new Error('Invalid mnemonic');
+  }
+
+  const seed = await bip39.mnemonicToSeed(mnemonic);
+  const seedHex = seed.toString('hex');
+
+  // ETH (BSC использует тот же адрес)
+  const ethWallet = ethers.Wallet.fromMnemonic(mnemonic, DERIVATION_PATHS.ETH);
+  const ethAddress = ethers.utils.getAddress(ethWallet.address); // EIP-55 checksum
+
+  // BTC (P2WPKH bech32)
+  const btcRoot = bip32.fromSeed(seed);
+  const btcChild = btcRoot.derivePath(DERIVATION_PATHS.BTC);
+  if (!btcChild.publicKey) {
+    throw new Error('BTC derivation failed: no public key');
+  }
+  const btcPayment = bitcoin.payments.p2wpkh({
+    pubkey: Buffer.from(btcChild.publicKey),
+    network: bitcoin.networks.bitcoin,
+  });
+  if (!btcPayment.address) {
+    throw new Error('BTC derivation failed: no address');
+  }
+
+  // TRX (derive privkey same curve as ETH, convert pubkey → TRX base58check address)
+  const trxWallet = ethers.Wallet.fromMnemonic(mnemonic, DERIVATION_PATHS.TRX);
+  const trxAddress = ethAddressToTron(trxWallet.address);
+
+  // SOL (ed25519 derivation)
+  const { key: solKey } = derivePath(DERIVATION_PATHS.SOL, seedHex);
+  if (!solKey || solKey.length !== 32) {
+    throw new Error('SOL derivation produced invalid seed length');
+  }
+  const solKeypair = Keypair.fromSeed(solKey);
+  const solAddress = solKeypair.publicKey.toBase58();
+
+  return [
+    { chain: 'ETH', address: ethAddress,                   derivationPath: DERIVATION_PATHS.ETH },
+    { chain: 'BSC', address: ethAddress,                   derivationPath: DERIVATION_PATHS.BSC },
+    { chain: 'BTC', address: btcPayment.address,           derivationPath: DERIVATION_PATHS.BTC },
+    { chain: 'TRX', address: trxAddress,                   derivationPath: DERIVATION_PATHS.TRX },
+    { chain: 'SOL', address: solAddress,                   derivationPath: DERIVATION_PATHS.SOL },
+  ];
+}
+
+/**
+ * ETH-style address (0x...) → TRX base58check (T...).
+ * TRX и ETH используют одну curve и одну keccak256-логику для получения 20-байтного хеша.
+ * Различие только в префиксе (0x41 vs ничего) и в кодировке (base58check vs hex).
+ */
+export function ethAddressToTron(ethAddr: string): string {
+  const hex = ethAddr.toLowerCase().replace(/^0x/, '');
+  if (hex.length !== 40) {
+    throw new Error('ethAddressToTron: invalid input length');
+  }
+  const bytes = Buffer.from(hex, 'hex');
+  const prefixed = Buffer.concat([Buffer.from([0x41]), bytes]); // 21 байт
+  const h1 = createHash('sha256').update(prefixed).digest();
+  const h2 = createHash('sha256').update(h1).digest();
+  const checksum = h2.subarray(0, 4);
+  return bs58.encode(new Uint8Array(Buffer.concat([prefixed, checksum])));
+}

apps/api/src/services/wallet-signer.service.ts

@@ -0,0 +1,442 @@
+/**
+ * Server-side signing + broadcasting для custodial flow.
+ * Caller передаёт расшифрованную mnemonic, мы деривим privkey, подписываем, broadcast'им.
+ *
+ * Никогда не логируем mnemonic / privkey / signed tx hex.
+ */
+
+import { ethers } from 'ethers';
+import { createHash } from 'crypto';
+import * as bip39 from 'bip39';
+import { BIP32Factory } from 'bip32';
+import * as ecc from 'tiny-secp256k1';
+import * as bitcoin from 'bitcoinjs-lib';
+import { Keypair, Connection, PublicKey, SystemProgram, Transaction } from '@solana/web3.js';
+import { derivePath } from 'ed25519-hd-key';
+import { env } from '../config/env';
+import { DERIVATION_PATHS, ethAddressToTron } from './wallet-generator.service';
+import type { ChainCode } from '../lib/address-validators';
+
+const bip32 = BIP32Factory(ecc);
+
+const ETH_RPC = 'https://ethereum-rpc.publicnode.com';
+const BSC_RPC = 'https://bsc-dataseed.binance.org';
+const SOL_RPC = 'https://api.mainnet-beta.solana.com';
+const TRONGRID = 'https://api.trongrid.io';
+const BLOCKSTREAM = 'https://blockstream.info/api';
+
+const USDT_TRC20 = 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t';
+const USDT_BEP20 = '0x55d398326f99059fF775485246999027B3197955';
+const USDT_ERC20 = '0xdAC17F958D2ee523a2206206994597C13D831ec7';
+
+const ERC20_ABI = [
+  'function transfer(address to, uint256 amount) returns (bool)',
+];
+
+const HTTP_TIMEOUT_MS = 20_000;
+
+export interface SendParams {
+  chain: ChainCode;
+  mnemonic: string;
+  to: string;
+  amount: string; // smallest units (wei / sat / sun / lamport)
+  token?: string;
+  /**
+   * Адрес из БД (wallets.address) для текущего юзера+chain.
+   * Signer верифицирует: derived(mnemonic, path) === expectedFromAddress.
+   * Если нет — отказ от подписи. Защита от случайной смены DERIVATION_PATHS
+   * или подмены mnemonic в БД (например в результате backup-восстановления).
+   */
+  expectedFromAddress: string;
+}
+
+export async function signAndBroadcast(p: SendParams): Promise<{ txid: string }> {
+  switch (p.chain) {
+    case 'ETH': return sendEvm(p, ETH_RPC, 1, USDT_ERC20);
+    case 'BSC': return sendEvm(p, BSC_RPC, 56, USDT_BEP20);
+    case 'BTC': return sendBtc(p);
+    case 'TRX': return sendTrx(p);
+    case 'SOL': return sendSol(p);
+  }
+}
+
+function assertAddressMatch(derived: string, expected: string, chain: ChainCode): void {
+  // EVM адреса case-insensitive (EIP-55 — только display)
+  const norm = (s: string) =>
+    chain === 'ETH' || chain === 'BSC' ? s.toLowerCase() : s;
+  if (norm(derived) !== norm(expected)) {
+    throw new Error(`Derived ${chain} address ${derived} does not match stored ${expected}`);
+  }
+}
+
+// ─── EVM (ETH / BSC) ───
+
+// Жёсткий cap на gas price — защита от fee-storm. ETH historically peaks at ~500 gwei,
+// нормальный диапазон 5-50 gwei. BSC ~3-10 gwei.
+const MAX_GAS_PRICE_GWEI = 500;
+
+async function sendEvm(p: SendParams, rpc: string, chainId: number, usdtAddr: string): Promise<{ txid: string }> {
+  const wallet = ethers.Wallet.fromMnemonic(p.mnemonic, DERIVATION_PATHS.ETH);
+  assertAddressMatch(wallet.address, p.expectedFromAddress, p.chain);
+  const provider = new ethers.providers.StaticJsonRpcProvider(rpc, chainId);
+  const signer = wallet.connect(provider);
+
+  // 1) Fee cap — fetch feeData и режем по верхней границе
+  const feeData = await provider.getFeeData();
+  const capWei = ethers.utils.parseUnits(String(MAX_GAS_PRICE_GWEI), 'gwei');
+  const effectiveGasPrice = feeData.maxFeePerGas ?? feeData.gasPrice;
+  if (!effectiveGasPrice || effectiveGasPrice.gt(capWei)) {
+    throw new Error(`Gas price exceeds cap (${MAX_GAS_PRICE_GWEI} gwei)`);
+  }
+
+  // 2) Явный nonce — fail loud если provider лажает
+  const nonce = await provider.getTransactionCount(wallet.address, 'pending');
+
+  // 3) Fee fields для tx — закрепляем cap, чтобы ethers не сходил за свежими ценами
+  // во время broadcast (TOCTOU).
+  const isEip1559 = !!feeData.maxFeePerGas;
+  const feeFields: Partial<ethers.providers.TransactionRequest> = isEip1559
+    ? {
+        type: 2,
+        maxFeePerGas: feeData.maxFeePerGas!,
+        maxPriorityFeePerGas: feeData.maxPriorityFeePerGas ?? ethers.BigNumber.from(0),
+      }
+    : { gasPrice: effectiveGasPrice };
+
+  let tx: ethers.providers.TransactionRequest;
+  if (!p.token) {
+    // Native: pre-check balance >= value + gas estimate
+    const value = ethers.BigNumber.from(p.amount);
+    const balance = await provider.getBalance(wallet.address);
+    const estGas = ethers.BigNumber.from(21000);  // simple native transfer
+    const totalNeeded = value.add(effectiveGasPrice.mul(estGas));
+    if (balance.lt(totalNeeded)) {
+      throw new Error('Insufficient balance (value + gas)');
+    }
+    tx = { to: p.to, value, chainId, nonce, gasLimit: estGas, ...feeFields };
+  } else if (p.token.toUpperCase() === 'USDT') {
+    // ERC20: pre-check token balance + native gas balance
+    const iface = new ethers.utils.Interface([
+      ...ERC20_ABI,
+      'function balanceOf(address) view returns (uint256)',
+    ]);
+    const erc20 = new ethers.Contract(usdtAddr, iface, provider);
+    const tokenBal: ethers.BigNumber = await erc20.balanceOf(wallet.address);
+    if (tokenBal.lt(ethers.BigNumber.from(p.amount))) {
+      throw new Error('Insufficient token balance');
+    }
+    const nativeBal = await provider.getBalance(wallet.address);
+    const estGas = ethers.BigNumber.from(80000);  // ERC20 transfer ~50-65k, запас
+    if (nativeBal.lt(effectiveGasPrice.mul(estGas))) {
+      throw new Error('Insufficient native balance for gas');
+    }
+
+    const data = iface.encodeFunctionData('transfer', [p.to, p.amount]);
+    tx = { to: usdtAddr, data, value: 0, chainId, nonce, gasLimit: estGas, ...feeFields };
+  } else {
+    throw new Error(`Token ${p.token} not supported on chainId ${chainId}`);
+  }
+
+  const sent = await signer.sendTransaction(tx);
+  return { txid: sent.hash };
+}
+
+// ─── SOLANA ───
+
+async function sendSol(p: SendParams): Promise<{ txid: string }> {
+  if (p.token) {
+    throw new Error('SOL SPL-token signing не реализовано (только native SOL)');
+  }
+
+  const seed = await bip39.mnemonicToSeed(p.mnemonic);
+  const { key } = derivePath(DERIVATION_PATHS.SOL, seed.toString('hex'));
+  if (!key || key.length !== 32) {
+    throw new Error('SOL derivation produced invalid seed length');
+  }
+  const keypair = Keypair.fromSeed(key);
+  assertAddressMatch(keypair.publicKey.toBase58(), p.expectedFromAddress, 'SOL');
+
+  const conn = new Connection(SOL_RPC, 'confirmed');
+  const toPk = new PublicKey(p.to);
+  const { blockhash, lastValidBlockHeight } = await conn.getLatestBlockhash();
+
+  const tx = new Transaction({
+    feePayer: keypair.publicKey,
+    blockhash,
+    lastValidBlockHeight,
+  });
+  tx.add(
+    SystemProgram.transfer({
+      fromPubkey: keypair.publicKey,
+      toPubkey: toPk,
+      lamports: BigInt(p.amount),
+    }),
+  );
+  tx.sign(keypair);
+
+  const sig = await conn.sendRawTransaction(tx.serialize());
+
+  // Wait for confirmation — иначе sendRawTransaction только подтверждает что leader увидел.
+  // Solana дропает 5-15% unconfirmed во время congestion.
+  try {
+    await conn.confirmTransaction({ signature: sig, blockhash, lastValidBlockHeight }, 'confirmed');
+  } catch (err: any) {
+    // Tx уже broadcastнут — может ещё пройти. Audit-log в caller'е покажет txid для reconciliation.
+    throw new Error(`SOL tx submitted but confirmation timed out (sig=${sig}): ${err.message}`);
+  }
+
+  return { txid: sig };
+}
+
+// ─── BITCOIN (P2WPKH bech32) ───
+
+async function sendBtc(p: SendParams): Promise<{ txid: string }> {
+  if (p.token) throw new Error('BTC tokens не поддерживаются');
+
+  const seed = await bip39.mnemonicToSeed(p.mnemonic);
+  const root = bip32.fromSeed(seed);
+  const child = root.derivePath(DERIVATION_PATHS.BTC);
+  if (!child.publicKey) throw new Error('BTC derivation failed');
+
+  const network = bitcoin.networks.bitcoin;
+  const pubkeyBuf = Buffer.from(child.publicKey);
+  const payment = bitcoin.payments.p2wpkh({ pubkey: pubkeyBuf, network });
+  if (!payment.address || !payment.output) throw new Error('BTC payment build failed');
+
+  const fromAddr = payment.address;
+  assertAddressMatch(fromAddr, p.expectedFromAddress, 'BTC');
+
+  // Fetch UTXOs + fee estimate
+  const [utxosRes, feesRes] = await Promise.all([
+    fetchJson(`${BLOCKSTREAM}/address/${fromAddr}/utxo`),
+    fetchJson(`${BLOCKSTREAM}/fee-estimates`),
+  ]);
+  const utxos = ((utxosRes as any[]) || []).filter((u) => u.status?.confirmed);
+  // Fee fallback приоритеты: 1 блок > 3 блока > 6 блоков > 15 sat/vB (защита от
+  // отказа broadcast по min-relay-fee на загруженном mempool).
+  const feeMap = feesRes as Record<string, number>;
+  const feeRate = Math.ceil(feeMap['1'] ?? feeMap['3'] ?? feeMap['6'] ?? 15);
+
+  const amountSat = BigInt(p.amount);
+  if (amountSat > BigInt(Number.MAX_SAFE_INTEGER)) {
+    throw new Error('BTC amount exceeds safe integer range');
+  }
+
+  // Сортируем UTXO по убыванию value — greedy выбор
+  utxos.sort((a, b) => b.value - a.value);
+
+  const psbt = new bitcoin.Psbt({ network });
+  let totalIn = 0n;
+
+  // Оценка fee для P2WPKH: input ≈ 68 vB, output ≈ 31 vB, overhead ≈ 11 vB.
+  // * 1.1 safety multiplier — защита от незначительных изменений mempool fee
+  // между fetch и broadcast.
+  const feeFor = (ins: number, outs: number) =>
+    BigInt(Math.ceil((ins * 68 + outs * 31 + 11) * feeRate * 1.1));
+
+  const selectedUtxos: typeof utxos = [];
+  for (const u of utxos) {
+    selectedUtxos.push(u);
+    totalIn += BigInt(u.value);
+    if (totalIn >= amountSat + feeFor(selectedUtxos.length, 2)) break;
+  }
+
+  if (totalIn < amountSat + feeFor(selectedUtxos.length, 2)) {
+    throw new Error('Insufficient BTC balance (incl. fee)');
+  }
+
+  for (const u of selectedUtxos) {
+    psbt.addInput({
+      hash: u.txid,
+      index: u.vout,
+      witnessUtxo: { script: payment.output, value: u.value },
+    });
+  }
+
+  psbt.addOutput({ address: p.to, value: Number(amountSat) });
+
+  const fee = feeFor(selectedUtxos.length, 2);
+  const change = totalIn - amountSat - fee;
+  // P2WPKH dust threshold = 294 sat (vs 546 для legacy P2PKH).
+  // Если change < dust — донатим miner'у как extra fee.
+  if (change > 294n) {
+    psbt.addOutput({ address: fromAddr, value: Number(change) });
+  }
+
+  for (let i = 0; i < selectedUtxos.length; i++) {
+    psbt.signInput(i, {
+      publicKey: pubkeyBuf,
+      sign: (hash: Buffer) => Buffer.from(child.sign(hash)),
+    });
+  }
+  psbt.finalizeAllInputs();
+
+  const txHex = psbt.extractTransaction().toHex();
+
+  // Broadcast с явным timeout + content-type (иначе fetch может зависнуть навечно)
+  const broadcastController = new AbortController();
+  const tBroadcast = setTimeout(() => broadcastController.abort(), HTTP_TIMEOUT_MS);
+  let broadcast: Response;
+  try {
+    broadcast = await fetch(`${BLOCKSTREAM}/tx`, {
+      method: 'POST',
+      body: txHex,
+      headers: { 'Content-Type': 'text/plain' },
+      signal: broadcastController.signal,
+    });
+  } finally {
+    clearTimeout(tBroadcast);
+  }
+  if (!broadcast.ok) {
+    const body = await broadcast.text().catch(() => '');
+    throw new Error(`BTC broadcast failed (${broadcast.status}): ${body.slice(0, 200)}`);
+  }
+  const txid = (await broadcast.text()).trim();
+  return { txid };
+}
+
+// ─── TRON ───
+
+async function sendTrx(p: SendParams): Promise<{ txid: string }> {
+  const wallet = ethers.Wallet.fromMnemonic(p.mnemonic, DERIVATION_PATHS.TRX);
+  const fromTronAddr = ethAddressToTron(wallet.address);
+  assertAddressMatch(fromTronAddr, p.expectedFromAddress, 'TRX');
+
+  const headers: Record<string, string> = { 'Content-Type': 'application/json' };
+  if (env.tronApiKey) headers['TRON-PRO-API-KEY'] = env.tronApiKey;
+
+  let txBody: any;
+  if (!p.token) {
+    const built = await fetchJson(`${TRONGRID}/wallet/createtransaction`, {
+      method: 'POST',
+      headers,
+      body: JSON.stringify({
+        owner_address: fromTronAddr,
+        to_address: p.to,
+        amount: Number(p.amount),
+        visible: true,
+      }),
+    });
+    txBody = built;
+  } else if (p.token.toUpperCase() === 'USDT') {
+    const param =
+      tronAddressToHex(p.to).padStart(64, '0') +
+      BigInt(p.amount).toString(16).padStart(64, '0');
+    const built = await fetchJson(`${TRONGRID}/wallet/triggersmartcontract`, {
+      method: 'POST',
+      headers,
+      body: JSON.stringify({
+        owner_address: fromTronAddr,
+        contract_address: USDT_TRC20,
+        function_selector: 'transfer(address,uint256)',
+        parameter: param,
+        fee_limit: 100_000_000,
+        call_value: 0,
+        visible: true,
+      }),
+    });
+    txBody = built.transaction;
+  } else {
+    throw new Error(`Token ${p.token} not supported on TRX`);
+  }
+
+  if (!txBody?.txID || !txBody?.raw_data_hex || !txBody?.raw_data) {
+    throw new Error('TRX tx build failed (incomplete response)');
+  }
+
+  // ── ВЕРИФИКАЦИЯ против скомпрометированного RPC / MITM ────────────────────
+  // 1. Recompute txID локально: SHA256(raw_data_hex) должен совпасть с тем что прислал RPC.
+  //    Если не совпало — RPC лжёт о txID и мог подсунуть raw_data, дренирующее на attacker.
+  const expectedTxId = createHash('sha256')
+    .update(Buffer.from(txBody.raw_data_hex, 'hex'))
+    .digest('hex');
+  if (expectedTxId !== txBody.txID) {
+    throw new Error('TRX txID mismatch — possible MITM/compromised RPC');
+  }
+
+  // 2. Verify что raw_data действительно содержит наш intent (to_address + amount)
+  const contractValue = txBody.raw_data?.contract?.[0]?.parameter?.value;
+  if (!contractValue) {
+    throw new Error('TRX tx malformed (no contract value)');
+  }
+  if (!p.token) {
+    // Native TRX: visible=true → to_address это base58 строка
+    if (contractValue.to_address !== p.to) {
+      throw new Error(`TRX to_address mismatch: expected ${p.to}, got ${contractValue.to_address}`);
+    }
+    if (String(contractValue.amount) !== String(p.amount)) {
+      throw new Error(`TRX amount mismatch: expected ${p.amount}, got ${contractValue.amount}`);
+    }
+  } else {
+    // TRC20: contract_address и parameter (encoded to+amount). Проверяем что contract правильный.
+    if (contractValue.contract_address !== USDT_TRC20) {
+      throw new Error(`TRX contract mismatch: expected ${USDT_TRC20}, got ${contractValue.contract_address}`);
+    }
+    // Decode parameter: первые 32 байта = to (TRX-hex prefixed by 0x41 padded), вторые = amount
+    const data = String(contractValue.data || '');
+    if (data.length !== 128 + 8) {
+      // method id (8 hex chars) + 2 * 32 bytes (64 hex chars each)
+      throw new Error('TRX trc20 data length wrong');
+    }
+    const expectedParam =
+      tronAddressToHex(p.to).padStart(64, '0') +
+      BigInt(p.amount).toString(16).padStart(64, '0');
+    const actualParam = data.slice(8); // strip method id
+    if (actualParam.toLowerCase() !== expectedParam.toLowerCase()) {
+      throw new Error('TRX trc20 parameter mismatch (to/amount tampering)');
+    }
+  }
+
+  // Подпись txID (теперь верифицированного локально)
+  const sk = new ethers.utils.SigningKey(wallet.privateKey);
+  const sig = sk.signDigest('0x' + txBody.txID);
+  const sigHex =
+    sig.r.slice(2) +
+    sig.s.slice(2) +
+    (sig.recoveryParam ?? 0).toString(16).padStart(2, '0');
+
+  txBody.signature = [sigHex];
+
+  const broadcast = await fetchJson(`${TRONGRID}/wallet/broadcasttransaction`, {
+    method: 'POST',
+    headers,
+    body: JSON.stringify(txBody),
+  });
+
+  if (!broadcast?.result) {
+    const msg = (broadcast?.message && Buffer.from(broadcast.message, 'hex').toString()) || 'unknown';
+    throw new Error(`TRX broadcast failed: ${msg.slice(0, 200)}`);
+  }
+
+  return { txid: txBody.txID };
+}
+
+// ─── HELPERS ───
+
+const BASE58_ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+
+function tronAddressToHex(address: string): string {
+  let num = 0n;
+  for (const ch of address) {
+    const i = BASE58_ALPHABET.indexOf(ch);
+    if (i === -1) throw new Error('Invalid base58 character in TRON address');
+    num = num * 58n + BigInt(i);
+  }
+  const hex = num.toString(16).padStart(50, '0');
+  return hex.slice(2, 42); // strip 0x41 prefix + checksum bytes
+}
+
+async function fetchJson(url: string, init?: RequestInit): Promise<any> {
+  const controller = new AbortController();
+  const t = setTimeout(() => controller.abort(), HTTP_TIMEOUT_MS);
+  try {
+    const res = await fetch(url, { ...init, signal: controller.signal });
+    if (!res.ok) {
+      const body = await res.text().catch(() => '');
+      throw new Error(`Upstream ${res.status}: ${body.slice(0, 200)}`);
+    }
+    return await res.json();
+  } finally {
+    clearTimeout(t);
+  }
+}