DEV Community

Cover image for crypto_wallet_core: نواة محفظة Bitcoin وEthereum صغيرة بلغة Dart خالصة
Abdeldjalil Chougui
Abdeldjalil Chougui

Posted on Originally published at abdeldjalilchougui.biz

crypto_wallet_core: نواة محفظة Bitcoin وEthereum صغيرة بلغة Dart خالصة

المحفظة في أغلبها سلسلة من خطوات صغيرة محددة بدقة. اثنتا عشرة كلمة تصير seed (حسب BIP-39). الـ seed يصير شجرة مفاتيح (BIP-32). المفتاح يصير عنوانًا بإحدى صيغ الترميز. والمعاملة (transaction) تُرمَّز ثم تُحسب بصمتها ثم توقَّع بـ secp256k1. لكل خطوة مواصفة منشورة ومتجهات اختبار (test vectors) منشورة.

في تطبيق Dart، قد تتوزّع هذه الخطوات على عدة اعتماديات (dependencies): مكتبة تشفير عامة، وعميل web3، وحزمة لعبارات الاسترجاع. وكلما زاد عدد الحزم التي تلمس مفاتيحك الخاصة، زاد الكود الذي يجب أن يقرأه أحد قبل أن يثق في مسار التوقيع.

crypto_wallet_core تضع السلسلة كلها في حزمة (package) صغيرة واحدة: عبارات الاسترجاع (mnemonics)، اشتقاق مفاتيح HD، العناوين، توقيع secp256k1، وتوقيع معاملات Ethereum. اعتماديتها الوحيدة وقت التشغيل هي package:crypto، ولا تستعمل web3dart.

وقبل أي شيء، التحذير الموجود في أعلى الـ README: الحزمة غير مدقَّقة أمنيًا (not audited)، ويجب التعامل مع المفاتيح الخاصة بحذر، ولغة Dart الخالصة لا تضمن زمن تنفيذ ثابتًا (constant-time). حسابات المنحنى الإهليلجي تعمل على BigInt في Dart، وزمن تنفيذه يتغيّر حسب القيم التي يعالجها. المفاتيح والـ seeds تبقى في ذاكرة عادية يديرها الـ garbage collector ولا يمكن مسحها بشكل موثوق. كل خوارزمية مفحوصة مقابل متجهات الاختبار الرسمية، لكن لم يراجع أحد هذا الكود من جهة القنوات الجانبية (side channels). قبل أن تحمي بها أموالًا حقيقية، اطلب مراجعة مستقلة، أو استعمل محفظة عتاد (hardware wallet) أو مكتبة native مدقَّقة للتوقيع.

ماذا تقدّم

دوال البصمة (hashes). Keccak-256 (نسخة Ethereum، وليست FIPS-202 SHA3-256)، وRIPEMD-160، وHASH160، وSHA-256 المزدوج، وHMAC-SHA512، وPBKDF2-HMAC-SHA512. خوارزميات SHA-2 وHMAC تأتي من package:crypto. والباقي منفَّذ داخل الحزمة بعمليات 32 بت فقط، فتكون النتائج واحدة على Dart VM وعلى الويب.

BIP-39. قائمة الكلمات الإنجليزية الرسمية، وتوليد العبارة من الـ entropy (بـ Random.secure() افتراضيًا)، والتحقق من الـ checksum، واشتقاق الـ seed مع passphrase.

BIP-32. المفتاح الرئيسي من الـ seed، وCKDpriv وCKDpub، والأبناء المحصَّنون (hardened) وغير المحصَّنين، وتحليل المسارات مثل m/84'/0'/0'/0/0 بالعلامات ' أو h أو H. وتُرمِّز الحزمة وتحلّل بصرامة xprv/xpub وtprv/tpub، وصيغ SLIP-132 وهي yprv/ypub وuprv/upub (BIP-49) وzprv/zpub وvprv/vpub (BIP-84).

عناوين Bitcoin. عناوين BIP-44 القديمة P2PKH (Base58Check)، وBIP-49 P2SH-P2WPKH، وBIP-84 P2WPKH (bech32)، على mainnet وtestnet/signet وregtest. مفاتيح خاصة بصيغة WIF. وترميز وفك ترميز Bech32 وBech32m بشكل عام، وفك عناوين SegWit من v0 إلى v16 إلى scriptPubKey.

secp256k1 ECDSA. قيم nonce حتمية وفق RFC 6979، وتوحيد low-s، واسترجاع المفتاح العام بـ recovery id، والتحقق من التوقيع.

Ethereum. عناوين EIP-55 بالـ checksum، وترميز وفك ترميز RLP بصرامة، ومعاملات legacy مع حماية إعادة الإرسال EIP-155، ومعاملات EIP-1559 (النوع 2) مع access lists، وpersonal_sign وفق EIP-191 مع تحقق مبني على ecrecover، وحساب بصمة وتوقيع البيانات المهيكلة EIP-712.

طريقة الاستعمال

أضِفها من GitHub:

dependencies:
  crypto_wallet_core:
    git: https://github.com/AbdeldjalilChougui/crypto_wallet_core
Enter fullscreen mode Exit fullscreen mode

مثال الـ README ينتقل من عبارة استرجاع إلى عنوان Bitcoin ومعاملة Ethereum موقَّعة:

import 'dart:convert';

import 'package:crypto_wallet_core/crypto_wallet_core.dart';

void main() {
  // The public BIP-39 test mnemonic. Never use it for real funds.
  const mnemonic = 'abandon abandon abandon abandon abandon abandon abandon '
      'abandon abandon abandon abandon about';
  if (!Bip39.validateMnemonic(mnemonic)) throw StateError('bad mnemonic');
  final seed = Bip39.mnemonicToSeed(mnemonic, passphrase: '');

  // Bitcoin, BIP-84 native SegWit.
  final root = HDKey.fromSeed(seed, version: ExtendedKeyVersion.zpub);
  final account = root.derivePath("m/84'/0'/0'");
  print(account.neuter().toExtendedPublicKey()); // zpub6rFR7y4Q2Aij...
  final key = account.derivePath('0/0');
  print(BitcoinAddress.p2wpkh(key.publicKey)); // bc1qcr8te4kr609gcawutmrza0j4xv80jy8z306fyu
  print(Wif.encode(key.privateKey!));

  // Ethereum, m/44'/60'/0'/0/0.
  final ethKey = root.derivePath("m/44'/60'/0'/0/0").privateKey!;
  final from = EthereumAddress.fromPrivateKey(ethKey);

  final signed = Eip1559Transaction(
    chainId: BigInt.one,
    nonce: BigInt.zero,
    maxPriorityFeePerGas: BigInt.from(1500000000),
    maxFeePerGas: BigInt.from(30000000000),
    gasLimit: BigInt.from(21000),
    to: '0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed',
    value: BigInt.from(10).pow(16),
  ).sign(ethKey);
  print(signed.rawHex); // for eth_sendRawTransaction

  final message = utf8.encode('Sign in to example.org');
  final sig = PersonalSign.sign(message, ethKey);
  print(PersonalSign.verify(message, sig, from)); // true
}
Enter fullscreen mode Exit fullscreen mode

الحزمة توقّع فقط. لا تتصل بأي node: القيمة signed.rawHex هي ما ترسله أنت إلى eth_sendRawTransaction بعميل HTTP الخاص بك.

والأجزاء منخفضة المستوى عامة أيضًا: Secp256k1.sign وSecp256k1.verify وSecp256k1.recoverPublicKey وSecp256k1.rfc6979Nonce وRlp.encode وRlp.decode وBech32 وSegwitAddress وBase58 وkeccak256 وripemd160 وpbkdf2HmacSha512. والملف example/main.dart جولة قابلة للتشغيل.

كيف تم التحقق منها

الحزمة تتضمّن مجموعة بيانات واحدة: قائمة كلمات BIP-39 الإنجليزية، منسوخة حرفيًا من مستودع bitcoin/bips. وهناك اختبار يعيد حساب SHA-256 الخاص بها ويقارنه بالقيمة المنشورة.

كل ما عدا ذلك متجهات اختبار، والـ README يسرد كل ملف مع مصدره ورخصته: متجهات BIP-32 من 1 إلى 5، ومتجهات python-mnemonic من Trezor لـ BIP-39، والمتجهات الواردة في نصوص BIP-49 وBIP-84 وBIP-173 وBIP-350، وبيانات Base58 وkey I/O من Bitcoin Core، واختبارات الإجابة المعروفة من فريق Keccak، والقيم الرسمية لـ RIPEMD-160، وقيم nonce وفق RFC 6979 من Trezor وملفات bitcoinjs-lib، واختبارات RLP من ethereum/tests، والأمثلة الواردة في EIP-55 وEIP-155 وEIP-712، ومتجهات EIP-1559 من Hyperledger Besu.

ومجموعتان أُعيد فحصهما قبل إضافتهما: مجموعات RFC 6979 أُعيد حسابها بـ python-ecdsa، والمعاملات العشر الخام لـ EIP-1559 أُعيد توقيعها بـ eth-account 0.14. وتطابقت النتائج في الحالتين.

ما يجب معرفته

  • الأمان. غير مدقَّقة، ولا ضمان لزمن تنفيذ ثابت، والأسرار لا تُمسح من الذاكرة.
  • السرعة. حسابات النقاط تستعمل BigInt بإحداثيات Jacobian. التوقيع أو اشتقاق مفتاح عام يكلّف ميلي ثوانٍ وليس ميكرو ثوانٍ. هذا مقبول لمحفظة، لكنه لا يصلح للعمل بالجملة.
  • توحيد النص في BIP-39. المواصفة تشترط NFKD، وDart ليس فيها توحيد Unicode مدمج. مدخلات ASCII تعمل كما هي. أما العبارة أو الـ passphrase بغير ASCII فترمي خطأ إلا إذا وحّدتها أنت ومرّرت inputIsNfkd: true. والقائمة الإنجليزية فقط هي المضمَّنة.
  • المصفوفات في EIP-712. الأنواع المصفوفية مثل uint256[] أو Person[] ترمي UnsupportedError. مثال الـ EIP نفسه ليس فيه مصفوفات، فلا يوجد متجه رسمي للتحقق منها، ولهذا تُركت بدل تخمينها. والأنواع البسيطة غير string وaddress وuint256 تتبع قواعد الترميز في نص الـ EIP وقورنت بـ eth-account، لكن الـ EIP لا ينشر متجهًا لها.
  • غير مضمَّن. تعديل مفاتيح Taproot (BIP-86)، وSchnorr (BIP-340)، وPSBT وتوقيع معاملات Bitcoin، ومعاملات EIP-2930 من النوع 1، ومعاملات blob وفق EIP-4844، وترميز ABI، والشبكة. Bech32m وSegWit v1+ مدعومان للعناوين فقط.
  • مساران دون متجه مباشر. تقول BIP-32 بالانتقال إلى الفهرس التالي إذا كان المفتاح الابن غير صالح (باحتمال أقل من ‎2^-127). الحزمة تفعل ذلك، لكن لا يوجد متجه يختبره. وBIP-44 لا تنشر متجهات عناوين، فيُختبر P2PKH كتركيب لمتجه HASH160 من BIP-49 مع متجهات Base58 من Bitcoin Core.

لماذا بنيتها

قسم "Dependencies" في الـ README يعطي السبب. الحزمة لا تستعمل pointycastle: آخر إصدار له، 4.0.0، صدر في فبراير 2025، ومستودعه لم يستقبل أي commit منذ ذلك الوقت. وKeccak وRIPEMD-160 وPBKDF2 وsecp256k1 صغيرة بما يكفي لتنفيذها وفحصها مقابل المتجهات المنشورة، وهذا يُبقي كل ما له علاقة بالأمان داخل حزمة واحدة.

هذه هي الفكرة وراء وصف "صغيرة وقابلة للتدقيق". لا يعني ذلك أنها مدقَّقة، والـ README يقول هذا في سطوره الأولى. المعنى أن من يريد مراجعة مسار التوقيع أمامه حزمة واحدة واعتمادية واحدة ليقرأهما، وأن كل خوارزمية فيها تشير إلى ملف المتجهات الذي يختبرها.

الكود

الكود، وجدول المعايير، ومصادر المتجهات، والاختبارات موجودة على GitHub: https://github.com/AbdeldjalilChougui/crypto_wallet_core. الرخصة MIT. وإن كنت تنوي حفظ أموال حقيقية، اقرأ التحذير مرة أخرى أولًا.


نُشر في الأصل على abdeldjalilchougui.biz.

Top comments (0)