Скачать cashp - скачать исходный код cashp

cashp

Другие категории

optional SLP address prefix

Скачать

Камп - библиотека PHP за биткойн наличные (BCH) и платежи токенов SLP

Это библиотека PHP, чтобы включить платежи Bitcoin Cash (BCH) и SLP. Вы можете легко использовать это с WordPress, Laravel и другими PHP -каркасами.

Установка

С композитором (рекомендуется):

 composer require "ekliptor/cashp"

Ручная установка:

Загрузите исходный код и включите cashp.php из корневого каталога этой библиотеки.
Загрузите источник этого пакета PHP QR-Code и извлечь его в src/phpqrcode

Требования

 PHP >= 7.1

Функции

Платежи на цепь, не проходя через третью сторону
настраиваемые бэкники с открытым исходным кодом, такие как: rest.bitcoin.com или BCHD
1-кратная генерация адресов для платежей с использованием xpub (поэтому закрытый ключ вашего кошелька не хранится на сервере)
генерировать QR -коды с BCH и SLP платеж URI

Док

Посмотрите на примеры кода.

КНАЙСКАЯ КРАСКА

__construct (CashPoptions $ Options = NULL)

Создайте основной класс API.

CashpOptions $options - (Необязательно) Опции API (см. Ниже)

getRate (): обменять

Вернуть API обменного курса.

GetBlockChain (): AbstractBlockChainapi

Верните API блокчейна, чтобы сгенерировать адреса, проверить балансы, транзакции, ...

GenerateQrcodeforAddress (String $ fileLocal, строка $ Adder, float $ summ

Создайте QR -код для оплаты.

string $fileLocal - путь в вашей локальной файловой системе для хранения файла QR -кода. Это должно быть доступно в Интернете, если вы хотите отобразить QR -код для пользователей. Если данный файл уже существует, он не будет перезаписан (QR -коды предназначены для создания и кэширования в вашем каталоге Temp Web).
string $address - (1 -кратный) адрес BCH (или SLP), созданный для этого платежа.
float $amountBCH - сумма в BCH. Может быть 0, если пользователь платит полную сумму в токенах SLP.
float $amountToken - (необязательно) сумма дополнительного токена, который будет получен.
string $tokenID - (необязательно) идентификатор шестигранника токена SLP. Требуется, если $ outtoken> 0.

Возвращает bool - true на успех, неверно в противном случае

CreatePaymenturi (строка $ Adder, float $ ummerbch, float $ ummenttoken = 0,0, string $ tokenid = ""): строка

Верните платежный URI (начиная с «Bitcoincash:» или «Sommerledger:», если $ umbertoken> 0) для данного адреса $.

string $address - адрес приема BCH (или SLP).
float $amountBCH - сумма в BCH для получения.
float $amountToken - (необязательно) сумма токенов SLP для получения.
string $tokenID - (необязательно) идентификатор шестигранника токена SLP. Требуется, если $ outtoken> 0.

возвращает string

getbadgerbutton (массив $ btnconf, string $ address, float $ summerbch, float $ ummertoken = 0,0, string $ tokenid = ""): строка

Получите HTML -код Badgerbutton. Смотрите https://badger.bitcoin.com/

array $btnConf - ассоциативный массив с конфигурацией Buttom
- Текст (строка) текст кнопки
- Callback (String, необязательно) Имя функции обратного вызова, присутствующей в глобальном окне, для вызова после оплаты. Параметры: String Chaintxid
- CSSClass (строка, необязательно) Дополнительные классы CSS для кнопки.
- forsiindludejs (bool, необязательно) по умолчанию false - включите библиотеку JavaScript снова. Используйте это только в том случае, если вы генерируете HTML для нескольких страниц.
string $address - адрес приема BCH (или SLP).
float $amountBCH - сумма в BCH для получения.
float $amountToken - (необязательно) сумма токенов SLP для получения.
string $tokenID - (необязательно) идентификатор шестигранника токена SLP. Требуется, если $ outtoken> 0.

Возвращает string - кнопка HTML.

isvalidbchaddress (String $ bchaddress): bool

Проверьте, действителен ли адрес BCH.

string $bchAddress - адрес в формате CashAddress, начиная с «Bitcoincash: '

Возвращает bool - true, если адрес действителен, False в противном случае.

isvalidslpaddress (String $ slpaddress): bool

Проверьте, действителен ли адрес SLP.

string $slpAddress - адрес, начиная с «Simpleedger: '

Возвращает bool - true, если адрес действителен, False в противном случае.

getReturnAddress (транзакция $ tx): строка

Получает возвратный адрес BCH (принадлежащий адресу отправителя), определяемый как последний адрес в выходах транзакции.

Transaction $tx - транзакция от вызова getTransaction ().

Возвращает string - адрес

getReturnSlpaddress (транзакция $ tx): строка

Получает обратный адрес SLP (принадлежащий адресу отправителя), определяемый как последний адрес в выходах транзакции.

Transaction $tx - транзакция от вызова getTransaction ().

Возвращает string - адрес

Кэспопции класс

Набор расширенных свойств конфигурации.

$httpAgent = null - реализация HTTP, используемая для выполнения HTTP -запросов. Значения: basichttpagent | curlhttpagent | wordpresshttpagent по умолчанию в Basichttpagent, но вы должны использовать лучший в соответствии с вашей настройкой PHP.
$exchangeRateExpirationMin = 60 - Как долго ползанный обменный курс должен оставаться в кэше. В настоящее время ставки не сохранены за пределами выполнения сценариев.
$httpTimeoutSec = 10 - тайм -аут для HTTP -запросов на бэкэнд API REST.
$blockchainApiImplementation = "BitcoinComRestApi" - реализация бэкэнд API REST для использования. Разрешенные значения: bitcoincomrestapi | bchdprotogatewayapi | slpdbapi

Обменять класс

API, чтобы получить ставки обмена BCH в фиатные валюты.

getRate (String $ currency = "usd"): float

Получите текущий обменный курс для BCH.

string $currency - Fiat Vurrance, такая как USD | EUR | JPY

возвращает float

Блокчайнапи класс

API блокчейна для генерации адресов, проверки балансов, транзакций, ...

static setlogger (Callible $ loggerfn): void

Установите функцию регистратора для ошибок и вывода отладки. Используйте это, чтобы записать в файл журнала или базу данных. Если функция не будет предоставлена, все будет напечатано с использованием «echo».

callable $loggerFn(string $subject, mixed $error, mixed $data = null) - параметры Callable PHP

Sethttpagent (Abstractttpagent $ Agent): void

Установите реализацию http для запросов (curl, wordpress http api, ...)

AbstractHttpAgent $agent -

GetConfirmationCount (String $ TransactionId): Int

Вернуть количество подтверждения для данного идентификатора транзакции блокчейна.

string $transactionID -

Возвращает int - количество подтверждений или -1, если $ transactionID не существует.

CreateNewAddress (String $ xpub, int $ addresscount, string $ hdpathformat = '0/%d'):? bchaddress

Создает новый адрес из Xpub.

string $xPub - расширенный открытый ключ. Называется «Мастер открытого ключа» в электронах.
int $addressCount - номер следующего адреса для создания уникального адреса. Обычно это должно быть целым числом увеличения.
string $hdPathFormat - (необязательно) Путь HD, который будет использоваться для создания адреса детей.

Возвращает BchAddress - адрес или null при сбое

getTokenInfo (String $ tokenid):? Slptoken

Получить общую (по всей сети) информацию о токене SLP.

string $tokenID -

Возвращает SlpToken - токен или null на неудачу

GetAddressBalance (строка $ адрес): float

Вернуть баланс BCH данного адреса (включая неподтвержденные транзакции).

string $address - адрес BCH в формате CashAddress.

Возвращает float - баланс или -1, если адрес не существует.

GetAddressTokenBalance (строка $ Adder, String $ tokenid): float

Вернуть баланс токена данного адреса SLP (включая неподтвержденные транзакции).

string $address -
string $tokenID -

Возвращает float - баланс или -1, если адрес не существует.

getAddressdetails (строка $ адрес):? BChaddress

Верните адрес BCH со всеми его свойствами, такими как баланс, txids, ...

string $address - адрес BCH в формате CashAddress.

Возвращает BchAddress - адрес или null при сбое

getslpaddressdetails (строка $ address, string $ tokenid):? slptokenddress

Верните токен токена SLP данного адреса, включайте баланс, TXIDS, ...

string $address -
string $tokenID -

Возвращает SlpTokenAddress - токен или null на неудаче

getTransaction (String $ TransactionId):? Транзакция

Возвращает транзакцию со всеми входами и выходами, включая данные SLP.

string $transactionID -

Возвращает Transaction - транзакция или null при сбое

Тестирование

Чтобы запустить модульные тесты введите следующую команду в корневом каталоге проекта (требуется PhpUnit, автоматически установлен с помощью композитора):

./vendor/bin/phpunit --bootstrap vendor/autoload.php tests