這是Coinbase Wallet API v2的官方客戶端庫。我們提供直觀，穩定的界面，將Coinbase Wallet集成到的PHP項目中。

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

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

 require : { coinbase/coinbase : ~2.0 }

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

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

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

use CoinbaseWalletClient;use CoinbaseWalletConfiguration;// with a refresh token$configuration = Configuration::oauth($accessToken, $refreshToken);// without a refresh token$configuration = Configuration::oauth($accessToken);$client = Client::create($configuration);

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

use CoinbaseWalletEnumParam;use CoinbaseWalletExceptionTwoFactorRequiredException;use CoinbaseWalletResourceTransaction;$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 CoinbaseWalletEnumParam;$transactions = $client- getAccountTransactions($account, [ Param::FETCH_ALL = true,]);

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

use CoinbaseWalletClient;use CoinbaseWalletConfiguration;$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 CoinbaseWalletEnumParam;$deposit = $this- client- getAccountDeposit($account, $depositId, [ Param::EXPAND = [ transaction ],]);

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

use CoinbaseWalletResourceDeposit;use CoinbaseWalletResourcePaymentMethod;$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();

該庫包括對資源對象上的活動記錄方法的支持。你必須在引導html' target='_blank'>應用程序時啟用此功能。

$client- enableActiveRecord();

啟用后，你可以在資源對象上調用活動記錄方法。

use CoinbaseWalletEnumParam;$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 CoinbaseWalletResourceAccount;$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 CoinbaseWalletResourceAddress;$address = new Address([ name = New Address $client- createAccountAddress($account, $address);

列出交易清單

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

獲取交易信息

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

發送資金

use CoinbaseWalletEnumCurrencyCode;use CoinbaseWalletResourceTransaction;use CoinbaseWalletValueMoney;$transaction = Transaction::send([ toBitcoinAddress = ADDRESS , amount = new Money(5, CurrencyCode::USD), description = Your first bitcoin! , fee = 0.0001 // only required for transactions under BTC0.0001try { $client- createAccountTransaction($account, $transaction); }catch(Exception $e) { echo $e- getMessage(); }

將資金轉入新帳戶

use CoinbaseWalletResourceTransaction;use CoinbaseWalletResourceAccount;$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 CoinbaseWalletEnumCurrencyCode;use CoinbaseWalletResourceTransaction;use CoinbaseWalletValueMoney;$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 CoinbaseWalletResourceBuy;$buy = new Buy([ bitcoinAmount = 1$client- createAccountBuy($account, $buy);

購買確認

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

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

出售清單

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

獲取銷售信息

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

賣比特幣

use CoinbaseWalletResourceSell;$sell = new Sell([ bitcoinAmount = 1$client- createAccountSell($account, $sell);

出售確認

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

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

列出存款清單

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

獲取存款信息

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

存款

use CoinbaseWalletEnumCurrencyCode;use CoinbaseWalletResourceDeposit;use CoinbaseWalletValueMoney;$deposit = new Deposit([ amount = new Money(10, CurrencyCode::USD)$client- createAccountDeposit($account, $deposit);

提交押金

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

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

列出提款單

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

取消

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

提款

use CoinbaseWalletEnumCurrencyCode;use CoinbaseWalletResourceWithdrawal;use CoinbaseWalletValueMoney;$withdrawal = new Withdrawal([ amount = new Money(10, CurrencyCode::USD)$client- createAccountWithdrawal($account, $withdrawal);

提交退出

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

use CoinbaseWalletEnumParam;$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 CoinbaseWalletResourceOrder;use CoinbaseWalletValueMoney;$order = new Order([ name = Order #1234 , amount = Money::btc(1)$client- createOrder($order);

退款訂單

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

列出結帳單

$checkouts = $client- getCheckouts();

創建結帳單

use CoinbaseWalletResourceCheckout;$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);

$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如何使用比特幣Coinbase錢包庫開發應用（詳細步驟）的詳細內容，PHP教程

鄭重聲明：本文版權歸原作者所有，轉載文章僅為傳播更多信息之目的，如作者信息標記有誤，請第一時間聯系我們修改或刪除，多謝。