أداة ترميز Z85 وفك ترميزه

ما هو Z85؟

يُعرَّف Z85 في المواصفة ZeroMQ RFC 32 (وهي مواصفة من مجتمع ZeroMQ، وليست RFC صادرًا عن IETF). وكغيره من ترميزات Base85، يحوّل كل 4 بايتات إلى 5 أحرف، إذ يقرأ كل مجموعة على أنها عدد من 32 بت بترتيب big-endian ويكتبها على هيئة 5 أرقام بالأساس 85، بدءًا بالرقم الأعلى قيمة. وتزيد المخرجات على المدخلات بنسبة 25%.

ما يميّز Z85 هو أبجديته: 0-9 وa-z وA-Z والرموز الـ 23 .-:+=^!/*?&<>()[]{}@%$#. وهي تستبعد علامتي الاقتباس والشرطة المائلة العكسية وعلامة الاقتباس الخلفية والفاصلة والفاصلة المنقوطة والخط العمودي وعلامة التيلدا والشرطة السفلية. صُمّمت الأبجدية لتكون آمنة داخل السلاسل النصية في الشيفرة المصدرية، لذا يمكن لصق قيمة Z85 بين علامتي اقتباس في C أو Python أو JSON دون أي تهريب.

أين يُستخدم Z85

تستخدم ZeroMQ ترميز Z85 لعرض مفاتيح CurveZMQ. فالمفتاح العام أو السري المكوّن من 32 بايت يصبح سلسلة Z85 من 40 حرفًا، وهي الصيغة التي تُرجعها zmq_curve_keypair() وتقبلها خيارات المقابس الخاصة بأمان CURVE. كما توفّر المكتبة الدالتين zmq_z85_encode() وzmq_z85_decode()، وتوفّر الارتباطات البرمجية مثل pyzmq الدوال نفسها.

// C (libzmq)
char text[41];                       // 32 bytes -> 40 chars + NUL
zmq_z85_encode(text, key, 32);

# Python (pyzmq)
from zmq.utils import z85
z85.encode(bytes.fromhex('864fd26fb559f75b'))   # b'HelloWorld'

السطر الأخير هو متجه الاختبار الوارد في المواصفة.

طول المدخلات: ملاحظة حول هذه الأداة

يشترط RFC 32 أن يكون طول المدخلات الثنائية من مضاعفات 4 بايتات، وطول السلسلة المرمّزة من مضاعفات 5 أحرف. ولا يعرّف أي حشو، وترفض التطبيقات الصارمة مثل zmq_z85_encode() الأطوال الأخرى.

تقبل هذه الأداة الأطوال الأخرى أيضًا، مستخدمةً القاعدة نفسها المتبعة في Ascii85 وBase85: تصبح المجموعة الأخيرة المكوّنة من n بايت n + 1 حرف. وهذا امتداد غير قياسي، وقد ترفض أدوات فك ترميز Z85 الأخرى المخرجات الناتجة بهذه الطريقة، لذا احشُ بياناتك حتى يصبح طولها من مضاعفات 4 بايتات عندما تحتاج إلى التوافق. ومفاتيح CurveZMQ طولها 32 بايت، فهي تستوفي ذلك دائمًا.