PHP 如何使用比特幣 Coinbase 錢包庫

geeker發表於2018-10-19

這是Coinbase Wallet API v2的官方客戶端庫。我們提供直觀，穩定的介面，將Coinbase Wallet整合到的PHP專案中。

重要提示：由於此庫是針對較新的API v2的，因此需要v2許可權（即wallet:accounts:read）。如果你仍在使用v1，請使用此庫的舊版本。

安裝

使用Composer安裝庫。如果你不熟悉Composer或依賴管理器，請閱讀Composer文件。

"require": {
    "coinbase/coinbase": "~2.0"
}

認證

API金鑰

使用API金鑰和金鑰訪問你自己的Coinbase帳戶。

use Coinbase\Wallet\Client;
use Coinbase\Wallet\Configuration;

$configuration = Configuration::apiKey($apiKey, $apiSecret);
$client = Client::create($configuration);

OAuth2

使用OAuth2身份驗證訪問你自己以外的使用者帳戶。此庫不處理握手過程，並假定你在初始化時具有訪問token。你可以使用OAuth2客戶端（例如league/oauth2-client）處理握手過程。

use Coinbase\Wallet\Client;
use Coinbase\Wallet\Configuration;

// with a refresh token
$configuration = Configuration::oauth($accessToken, $refreshToken);

// without a refresh token
$configuration = Configuration::oauth($accessToken);

$client = Client::create($configuration);

雙因素身份驗證

傳送資金端點在某些情況下需要2FA令牌（在此處閱讀更多內容）。如果需要，則丟擲特定異常。

use Coinbase\Wallet\Enum\Param;
use Coinbase\Wallet\Exception\TwoFactorRequiredException;
use Coinbase\Wallet\Resource\Transaction;

$transaction = Transaction::send([
    'toEmail' => 'test@test.com',
    'bitcoinAmount' => 1
]);

$account = $client->getPrimaryAccount();
try {
    $client->createAccountTransaction($account, $transaction);
} catch (TwoFactorRequiredException $e) {
    // show 2FA dialog to user and collect 2FA token

    // retry call with token
    $client->createAccountTransaction($account, $transaction, [
        Param::TWO_FACTOR_TOKEN => '123456',
    ]);
}

分頁

幾個端點是分頁的。預設情況下，庫只會獲取給定請求的第一頁資料。你可以輕鬆載入不僅僅是第一頁結果。

$transactions = $client->getAccountTransactions($account);
while ($transactions->hasNextPage()) {
    $client->loadNextTransactions($transactions);
}

你還可以使用fetch_all引數讓庫發出載入完整集合的所有必要請求。

use Coinbase\Wallet\Enum\Param;

$transactions = $client->getAccountTransactions($account, [
    Param::FETCH_ALL => true,
]);

　警告

注意警告是明智的。如果配置了一個標準PSR-3記錄器，庫將記錄所有警告。

use Coinbase\Wallet\Client;
use Coinbase\Wallet\Configuration;

$configuration = Configuration::apiKey($apiKey, $apiSecret);
$configuration->setLogger($logger);
$client = Client::create($configuration);

資源引用

在某些情況下，API將返回資源引用來代替擴充套件的資源物件。可以透過重新整理來擴充套件這些引用。

$deposit = $this->client->getAccountDeposit($account, $depositId);
$transaction = $deposit->getTransaction();
if (!$transaction->isExpanded()) {
    $this->client->refreshTransaction($transaction);
}

你還可以使用expand引數請求API在初始請求中返回擴充套件資源。

use Coinbase\Wallet\Enum\Param;

$deposit = $this->client->getAccountDeposit($account, $depositId, [
    Param::EXPAND = ['transaction'],
]);

建立新資源時可以使用資源引用，從而避免從API請求資源的開銷。

use Coinbase\Wallet\Resource\Deposit;
use Coinbase\Wallet\Resource\PaymentMethod;

$deposit = new Deposit([
    'paymentMethod' => PaymentMethod::reference($paymentMethodId)
]);

// or use the convenience method
$deposit = new Deposit([
    'paymentMethodId' => $paymentMethodId
]);

響應

有多種方法可以訪問原始響應資料。首先，每個資源物件都有一個getRawData()方法，你可以使用該方法訪問未對映到物件屬性的任何欄位。

$data = $deposit->getRawData();

來自最後一個HTTP響應的原始資料也可在客戶端物件上使用。

$data = $client->decodeLastResponse();

活動記錄方法

該庫包括對資源物件上的活動記錄方法的支援。你必須在引導應用程式時啟用此功能。

$client->enableActiveRecord();

啟用後，你可以在資源物件上呼叫活動記錄方法。

use Coinbase\Wallet\Enum\Param;

$transactions = $account->getTransactions([
    Param::FETCH_ALL => true,
]);

用法

這並不是為了提供API的完整文件。有關更多詳細資訊，請參閱官方文件。

市場資料

列出支援的本地貨幣

$currencies = $client->getCurrencies();

列出匯率

$rates = $client->getExchangeRates();

買入價

$buyPrice = $client->getBuyPrice('BTC-USD');

賣出價

$sellPrice = $client->getSellPrice('BTC-USD');

現貨價格

$spotPrice = $client->getSpotPrice('BTC-USD');

當前伺服器時間

$time = $client->getTime();

使用者

獲取授權資訊

$auth = $client->getCurrentAuthorization();

查詢使用者資訊

$auth = $client->getCurrentAuthorization();

獲取當前使用者

$user = $client->getCurrentUser();

更新當前使用者

$user->setName('New Name');
$client->updateCurrentUser($user);

帳號

列出所有帳戶

$accounts = $client->getAccounts();

列出帳戶詳細資訊

$account = $client->getAccount($accountId);

列出主要帳戶詳細資訊

$account = $client->getPrimaryAccount();

將帳戶設為主要帳戶

$client->setPrimaryAccount($account);

建立一個新的比特幣賬戶

use Coinbase\Wallet\Resource\Account;

$account = new Account([
    'name' => 'New Account'
]);
$client->createAccount($account);

更新帳戶

$account->setName('New Account Name');
$client->updateAccount($account):

刪除帳戶

$client->deleteAccount($account);

地址

列出帳戶的接收地址

$addresses = $client->getAccountAddresses($account);

獲取接收地址資訊

$address = $client->getAccountAddress($account, $addressId);

列出地址的交易

$transactions = $client->getAddressTransactions($address);

建立一個新的接收地址

use Coinbase\Wallet\Resource\Address;

$address = new Address([
    'name' => 'New Address'
]);
$client->createAccountAddress($account, $address);

交易

列出交易清單

$transactions = $client->getAccountTransactions($account);

獲取交易資訊

$transaction = $client->getAccountTransaction($account, $transactionId);

傳送資金

use Coinbase\Wallet\Enum\CurrencyCode;
use Coinbase\Wallet\Resource\Transaction;
use Coinbase\Wallet\Value\Money;

$transaction = Transaction::send([
    'toBitcoinAddress' => 'ADDRESS',
    'amount'           => new Money(5, CurrencyCode::USD),
    'description'      => 'Your first bitcoin!',
    'fee'              => '0.0001' // only required for transactions under BTC0.0001
]);

try { $client->createAccountTransaction($account, $transaction); }
catch(Exception $e) {
     echo $e->getMessage(); 
}

將資金轉入新帳戶

use Coinbase\Wallet\Resource\Transaction;
use Coinbase\Wallet\Resource\Account;

$fromAccount = Account::reference($accountId);

$toAccount = new Account([
    'name' => 'New Account'
]);
$client->createAccount($toAccount);

$transaction = Transaction::transfer([
    'to'            => $toAccount,
    'bitcoinAmount' => 1,
    'description'   => 'Your first bitcoin!'
]);

$client->createAccountTransaction($fromAccount, $transaction);

申請資金

use Coinbase\Wallet\Enum\CurrencyCode;
use Coinbase\Wallet\Resource\Transaction;
use Coinbase\Wallet\Value\Money;

$transaction = Transaction::request([
    'amount'      => new Money(8, CurrencyCode::USD),
    'description' => 'Burrito'
]);

$client->createAccountTransaction($transaction);

重新傳送請求

$account->resendTransaction($transaction);

取消請求

$account->cancelTransaction($transaction);

完成請求

$account->completeTransaction($transaction);

買入

列出購買清單

$buys = $client->getAccountBuys($account);

獲取購買資訊

$buy = $client->getAccountBuy($account, $buyId);

買入比特幣

use Coinbase\Wallet\Resource\Buy;

$buy = new Buy([
    'bitcoinAmount' => 1
]);

$client->createAccountBuy($account, $buy);

購買確認

如果在建立購買時傳遞commit=false，則只需執行此操作。

use Coinbase\Wallet\Enum\Param;

$client->createAccountBuy($account, $buy, [Param::COMMIT => false]);
$client->commitBuy($buy);

賣出

出售清單

$sells = $client->getAccountSells($account);

獲取銷售資訊

$sell = $client->getAccountSell($account, $sellId);

賣比特幣

use Coinbase\Wallet\Resource\Sell;

$sell = new Sell([
    'bitcoinAmount' => 1
]);

$client->createAccountSell($account, $sell);

出售確認

如果在建立sell時傳遞commit=false，則只需執行此操作。

use Coinbase\Wallet\Enum\Param;

$client->createAccountSell($account, $sell, [Param::COMMIT => false]);
$client->commitSell($sell);

存款

列出存款清單

$deposits = $client->getAccountDeposits($account);

獲取存款資訊

$deposit = $client->getAccountDeposit($account, $depositId);

存款

use Coinbase\Wallet\Enum\CurrencyCode;
use Coinbase\Wallet\Resource\Deposit;
use Coinbase\Wallet\Value\Money;

$deposit = new Deposit([
    'amount' => new Money(10, CurrencyCode::USD)
]);

$client->createAccountDeposit($account, $deposit);

提交押金

如果在建立存款時傳遞commit=false，則只需執行此操作。

use Coinbase\Wallet\Enum\Param;

$client->createAccountDeposit($account, $deposit, [Param::COMMIT => false]);
$client->commitDeposit($deposit);

取款

列出提款單

$withdrawals = $client->getAccountWithdrawals($account);

取消

$withdrawal = $client->getAccountWithdrawal($account, $withdrawalId);

提款

use Coinbase\Wallet\Enum\CurrencyCode;
use Coinbase\Wallet\Resource\Withdrawal;
use Coinbase\Wallet\Value\Money;

$withdrawal = new Withdrawal([
    'amount' => new Money(10, CurrencyCode::USD)
]);

$client->createAccountWithdrawal($account, $withdrawal);

提交退出

如果在呼叫提款方法時傳遞commit=true，則只需執行此操作。

use Coinbase\Wallet\Enum\Param;

$client->createAccountWithdrawal($account, $withdrawal, [Param::COMMIT => false]);
$client->commitWithdrawal($withdrawal);

支付方式

列出付款方式

$paymentMethods = $client->getPaymentMethods();

獲取付款方式

$paymentMethod = $client->getPaymentMethod($paymentMethodId);

商家

獲得商家

$merchant = $client->getMerchant($merchantId);

訂單

列出訂單

$orders = $client->getOrders();

獲得訂單

$order = $client->getOrder($orderId);

建立訂單

use Coinbase\Wallet\Resource\Order;
use Coinbase\Wallet\Value\Money;

$order = new Order([
    'name' => 'Order #1234',
    'amount' => Money::btc(1)
]);

$client->createOrder($order);

退款訂單

use Coinbase\Wallet\Enum\CurrencyCode;

$client->refundOrder($order, CurrencyCode::BTC);

結賬

列出結帳單

$checkouts = $client->getCheckouts();

建立結帳單

use Coinbase\Wallet\Resource\Checkout;

$params = array(
    'name'               => 'My Order',
    'amount'             => new Money(100, 'USD'),
    'metadata'           => array( 'order_id' => $custom_order_id )
);

$checkout = new Checkout($params);
$client->createCheckout($checkout);
$code = $checkout->getEmbedCode();
$redirect_url = "https://www.coinbase.com/checkouts/$code";

結帳

$checkout = $client->getCheckout($checkoutId);

獲取結帳的訂單

$orders = $client->getCheckoutOrders($checkout);

建立結帳訂單

$order = $client->createNewCheckoutOrder($checkout);

通知webhook和驗證

$raw_body = file_get_contents('php://input');
$signature = $_SERVER['HTTP_CB_SIGNATURE'];
$authenticity = $client->verifyCallback($raw_body, $signature); // boolean

貢獻和測試

測試套件使用PHPUnit構建。透過執行phpunit命令執行單元測試套件。

phpunit

還有一組整合測試，它們向API發出實際請求並檢查生成的物件。要執行這些測試，必須將phpunit.xml.dist複製到phpunit.xml，為CB_API_KEY和CB_API_SECRET變數提供值，並在執行測試套件時指定integration組。

phpunit --group integration

建議你瀏覽我們匯智網的各種程式語言的區塊鏈教程和區塊鏈技術部落格，深入瞭解區塊鏈，比特幣，加密貨幣，以太坊，和智慧合約。

php比特幣開發教程，本課程面向初學者，內容即涵蓋比特幣的核心概念，例如區塊鏈儲存、去中心化共識機制、金鑰與指令碼、交易與UTXO等，同時也詳細講解如何在Php程式碼中整合比特幣支援功能，例如建立地址、管理錢包、構造裸交易等，是Php工程師不可多得的比特幣開發學習課程。

這裡是原文

本作品採用《CC 協議》，轉載必須註明作者和本文連結

PHP如何使用比特幣Coinbase錢包庫開發應用
2019-02-16
PHP比特幣
PHP如何對接比特幣錢包
2018-09-22
PHP比特幣
比特幣入門 ② - 錢包
2023-01-09
比特幣
如何在Java中生成比特幣錢包地址
2019-01-19
Java比特幣
使用Java生成比特幣錢包地址的過程
2018-03-13
Java比特幣
精通比特幣(第五章)【錢包】
2018-10-09
比特幣
Electrum 比特幣錢包的 Python 程式碼分析
2018-11-12
比特幣Python
比特幣學習筆記——————4、金鑰、地址、錢包
2018-06-12
比特幣筆記
黑客攻擊 Electrum 錢包竊取到 200 多比特幣
2018-12-29
黑客比特幣
PHP 如何進行比特幣開發
2018-09-17
PHP比特幣
黑客向熱門JavaScript庫注入惡意程式碼竊取Copay錢包的比特幣
2018-11-28
黑客JavaScript比特幣
第四章自己動手寫比特幣之錢包
2019-06-24
比特幣
Python 比特幣教程第三課：建立比特幣錢包，讀餘額，極速免費轉賬，標準轉賬
2019-02-26
Python比特幣
NFT原力星球系統——Coinbase錢包系統（搭建）
2022-06-16
Coinbase：2021年Q2比特幣交易量環比下降14%
2021-07-19
比特幣
PHP工程師如何基於比特幣進行開發
2018-09-17
PHP工程師比特幣
Coinbase專利表明加密交易正在改進比特幣支付的安全性
2018-08-25
加密比特幣
篡改 npm 包盜取比特幣始末
2018-12-04
NPM比特幣
使用 PHP 生成以太坊錢包和金鑰對
2018-10-29
PHP
HTC將推出區塊鏈手機Exodus，內建數字錢包支援比特幣
2018-07-11
區塊鏈比特幣
如何使用比特幣享受俄羅斯世界盃
2018-04-22
比特幣
比特幣錢包Electrum遭遇大規模DOS攻擊已造成數百萬美元損失
2019-04-10
比特幣
洗錢新渠道：25億美元黑錢通過比特幣洗白白
2018-10-12
比特幣
Coinbase：2021上半年以太坊市場增長速度是比特幣的3倍
2021-07-29
比特幣
[譯] 數字貨幣錢包詳解
2018-04-27
澳大利亞比特幣交易所反洗錢新規今起生效
2018-04-05
比特幣
比特幣與山寨幣的數字貨幣交易庫 CCXT——CryptoCurrency eXchange
2018-11-30
比特幣
精通比特幣(第十一章)【比特幣安全】
2018-10-09
比特幣
精通比特幣(第二章)【比特幣原理】
2018-09-29
比特幣
比特幣學習筆記——————2、比特幣原理
2018-06-12
比特幣筆記
比特幣學習筆記————10、比特幣安全
2018-06-13
比特幣筆記
區塊鏈錢包開發，數字貨幣錢包開發的型別
2022-06-24
區塊鏈型別
最安全的SRM錢包，SRM冷錢包使用教程
2020-11-30
最安全的PMEER錢包，PMEER冷錢包使用教程
2020-12-06
Glassnode：30%流通中比特幣的買家現在正在賠錢
2022-01-20
比特幣
數字貨幣TP錢包/ImToken錢包/MetaMask小狐狸錢包系統開發（開發流程）丨原始碼分析
2023-04-03
原始碼
精通比特幣(第三章)【比特幣核心】
2018-09-29
比特幣
比特幣學習筆記——————1、比特幣簡介
2018-06-12
比特幣筆記