هذه مكتبة PHP لتمكين Bitcoin Cash (BCH) و SLP المدفوعة الرمز المميز. يمكنك بسهولة استخدام هذا مع WordPress و Laravel وغيرها من أطر PHP.
مع الملحن (موصى به):
composer require "ekliptor/cashp"
التثبيت اليدوي:
cashp.php من الدليل الجذر لهذه المكتبة.src/phpqrcode PHP >= 7.1
ألقِ نظرة على أمثلة الكود.
إنشاء فئة API الرئيسية.
CashpOptions $options - (اختياري) خيارات واجهة برمجة التطبيقات (انظر أدناه) إرجاع سعر الصرف API.
إرجاع واجهة برمجة تطبيقات blockchain لإنشاء عناوين ، والتحقق من الأرصدة ، والمعاملات ، ...
إنشاء رمز الاستجابة السريعة للدفع.
string $fileLocal - مسار على نظام الملفات المحلي لتخزين ملف رمز QR. يجب الوصول إلى هذا من الويب إذا كنت ترغب في عرض رمز الاستجابة السريعة للمستخدمين. إذا كان الملف المحدد موجودًا بالفعل ، فلن يتم الكتابة فوقه (من المفترض إنشاء رموز QR وتخزينها مؤقتًا في دليل TEMP الخاص بك).string $address - عنوان BCH (أو SLP) (أو SLP) الذي تم إنشاؤه لهذا الدفع.float $amountBCH - المبلغ في BCH. يمكن أن يكون 0 إذا دفع المستخدم المبلغ الكامل في الرموز SLP.float $amountToken - (اختياري) مبلغ الرمز المميز الاختياري المراد استلامه.string $tokenID - (اختياري) معرف Hex لرمز SLP. مطلوب إذا $ textoken> 0. إرجاع bool - صحيح على النجاح ، خطأ خلاف ذلك
إرجاع دفعة URI (بدءًا من "Bitcoincash:" أو "SimpleleDger:" إذا كان $ textoken> 0) لعنوان $ المحدد.
string $address - عنوان BCH (أو SLP).float $amountBCH - المبلغ في BCH لتلقيه.float $amountToken - (اختياري) مبلغ الرموز المميزة SLP لتلقيها.string $tokenID - (اختياري) معرف Hex لرمز SLP. مطلوب إذا $ textoken> 0. إرجاع string
احصل على رمز HTML من Badgerbutton. انظر https://badger.bitcoin.com/
array $btnConf - صفيف ترابط مع تكوين buttomstring $address - عنوان BCH (أو SLP).float $amountBCH - المبلغ في BCH لتلقيه.float $amountToken - (اختياري) مبلغ الرموز المميزة SLP لتلقيها.string $tokenID - (اختياري) معرف Hex لرمز SLP. مطلوب إذا $ textoken> 0. إرجاع string - الزر HTML.
تحقق مما إذا كان عنوان BCH صالحًا.
string $bchAddress - العنوان في تنسيق CashAddress بدءًا من "Bitcoincash:" إرجاع bool - صحيح إذا كان العنوان صالحًا ، خطأ خلاف ذلك.
تحقق مما إذا كان عنوان SLP صالحًا.
string $slpAddress - العنوان الذي يبدأ بـ "SimpleleDger:" إرجاع bool - صحيح إذا كان العنوان صالحًا ، خطأ خلاف ذلك.
يحصل على عنوان BCH الإرجاع (ينتمي إلى عنوان المرسلون) المعرّفة على أنه العنوان الأخير في مخرجات المعاملات.
Transaction $tx - المعاملة من GetTransaction () استدعاء. إرجاع string - العنوان
يحصل على عنوان SLP الإرجاع (ينتمي إلى عنوان المرسلون) المعرّفة على أنه العنوان الأخير في مخرجات المعاملات.
Transaction $tx - المعاملة من GetTransaction () استدعاء. إرجاع string - العنوان
مجموعة من خصائص التكوين المتقدمة.
$httpAgent = null - تطبيق HTTP المستخدم لاتخاذ طلبات HTTP. القيم: basichttpagent | curlhttpagent | WordPresshttpagent الافتراضيات إلى basichttpagent ، ولكن يجب عليك استخدام واحد أفضل وفقا لإعداد php الخاص بك.$exchangeRateExpirationMin = 60 - كم من الوقت يجب أن يظل سعر الصرف المزروع في ذاكرة التخزين المؤقت. لا يتم حفظ الأسعار حاليًا بما يتجاوز تنفيذ البرنامج النصي.$httpTimeoutSec = 10 - مهلة طلبات HTTP إلى الواجهة الخلفية لـ REST API.$blockchainApiImplementation = "BitcoinComRestApi" - تطبيق BREAS API الخلفي للاستخدام. القيم المسموح بها: bitcoincomrestapi | bchdprotogatewayapi | slpdbapi واجهة برمجة تطبيقات للحصول على أسعار تبادل BCH إلى عملات فيات.
احصل على سعر الصرف الحالي لـ BCH.
string $currency - عملة فيات مثل USD | EUR | JPY يعود float
واجهة برمجة تطبيقات blockchain لإنشاء عناوين ، والتحقق من الأرصدة ، والمعاملات ، ...
تعيين وظيفة المسجل للأخطاء وإخراج التصحيح. استخدم هذا للكتابة إلى ملف تسجيل أو قاعدة بيانات. إذا لم يتم توفير وظيفة ، فسيتم طباعة كل شيء باستخدام "صدى".
callable $loggerFn(string $subject, mixed $error, mixed $data = null) - معلمات PHP القابلة للاتصال قم بتعيين تطبيق AA HTTP للطلبات (Curl ، WordPress HTTP API ، ...)
AbstractHttpAgent $agent - إرجاع عدد التأكيد لمعرف معاملة blockchain المعطى.
string $transactionID - إرجاع int - عدد التأكيدات أو -1 إذا لم يكن هناك $ TransactionId.
يخلق عنوانًا جديدًا من XPUB.
string $xPub - المفتاح العام الموسع. يسمى "Master Public Key" في Cash Electron.int $addressCount - عدد العنوان التالي لإنشاء عنوان فريد. عادة ما يكون هذا عدد صحيح متزايد.string $hdPathFormat - (اختياري) مسار HD لاستخدامه لإنشاء الأطفال العنوان. إرجاع BchAddress - العنوان أو null من الفشل
احصل على معلومات عامة (على مستوى الشبكة) حول رمز SLP.
string $tokenID - إرجاع SlpToken - الرمز المميز أو null عند الفشل
إرجاع رصيد BCH للعنوان المحدد (بما في ذلك المعاملات غير المؤكدة).
string $address - عنوان BCH بتنسيق CashAddress. إرجاع float - الرصيد أو -1 إذا لم يكن العنوان موجودًا.
إرجاع الرصيد الرمزي لعنوان SLP المعطى (بما في ذلك المعاملات غير المؤكدة).
string $address -string $tokenID - إرجاع float - الرصيد أو -1 إذا لم يكن العنوان موجودًا.
أعد عنوان BCH مع جميع خصائصه مثل التوازن ، txids ، ...
string $address - عنوان BCH بتنسيق CashAddress. إرجاع BchAddress - العنوان أو null من الفشل
إرجاع تفاصيل رمز SLP لعنوان معين تشمل الرصيد ، txids ، ...
string $address -string $tokenID - إرجاع SlpTokenAddress - الرمز المميز أو null عند الفشل
إرجاع معاملة مع جميع المدخلات والمخرجات بما في ذلك بيانات SLP.
string $transactionID - Transaction إرجاع - المعاملة أو null عند الفشل
لتشغيل اختبارات الوحدة ، اكتب الأمر التالي في دليل جذر المشروع (يتطلب phpunit ، مثبتًا تلقائيًا مع الملحن):
./vendor/bin/phpunit --bootstrap vendor/autoload.php tests
تغريد
البرنامج المساعد WordPress