PHP如何使用比特幣Coinbase錢包庫
這是Coinbase Wallet API v2的官方客戶端庫。我們提供直觀,穩定的介面,將Coinbase Wallet整合到的PHP專案中。
重要提示:由於此庫是針對較新的API v2的,因此需要v2許可權(即wallet:accounts:read
)。如果你仍在使用v1,請使用此庫的舊版本。
安裝
使用Composer/">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' => '[email protected]', '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的完整文件。有關更多詳細資訊,請參閱ofollow,noindex">官方文件 。
市場資料
列出支援的本地貨幣
$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工程師不可多得的比特幣開發學習課程。
- php以太坊,主要是介紹使用php進行智慧合約開發互動,進行賬號建立、交易、轉賬、代幣開發以及過濾器和交易等內容。
- java比特幣開發教程,本課程面向初學者,內容即涵蓋比特幣的核心概念,例如區塊鏈儲存、去中心化共識機制、金鑰與指令碼、交易與UTXO等,同時也詳細講解如何在Java程式碼中整合比特幣支援功能,例如建立地址、管理錢包、構造裸交易等,是Java工程師不可多得的比特幣開發學習課程。
- java以太坊開發教程,主要是針對java和android程式設計師進行區塊鏈以太坊開發的web3j詳解。
- 以太坊入門教程,主要介紹智慧合約與dapp應用開發,適合入門。
- 以太坊開發進階教程,主要是介紹使用node.js、mongodb、區塊鏈、ipfs實現去中心化電商DApp實戰,適合進階。
- python以太坊,主要是針對python工程師使用web3.py進行區塊鏈以太坊開發的詳解。
- C#以太坊,主要講解如何使用C#開發基於.Net的以太坊應用,包括賬戶管理、狀態與交易、智慧合約開發與互動、過濾器和交易等。
- EOS入門教程,本課程幫助你快速入門EOS區塊鏈去中心化應用的開發,內容涵蓋EOS工具鏈、賬戶與錢包、發行代幣、智慧合約開發與部署、使用程式碼與智慧合約互動等核心知識點,最後綜合運用各知識點完成一個便籤DApp的開發。
匯智網原創翻譯,轉載請標明出處。這裡是原文