piercetech/coinbase-oauth2

There is no license information available for the latest version (0.1.0) of this package.

Coinbase Provider for the OAuth 2.0 Client

0.1.0 2019-02-16 21:25 UTC

Requires

• league/oauth2-client: 2.4.*

Unknown License

README

Implementation of a Coinbase API v2 OAuth 2.0 provider for the league/oauth2-client client.

Installing

To install, use composer:

composer require piercetech/coinbase-oauth2

Usage

Usage is the same as the normal client, using PierceTech\OAuth2\Client\Provider\Coinbase as the provider:

Authorization Code Flow

$provider = new Openclerk\OAuth2\Client\Provider\Coinbase([
  'clientId'      => 'XXXXXXXX',
  'clientSecret'  => 'XXXXXXXX',
  'redirectUri'   => 'https://your-registered-redirect-uri/',
  'scopes'        => ['wallet:accounts:read', 'wallet:transactions:read', '...'],
]);

if (!isset($_GET['code'])) {

  // If we don't have an authorization code then get one
  $authUrl = $provider->getAuthorizationUrl();
  $_SESSION['oauth2state'] = $provider->state;
  header('Location: '.$authUrl);
  exit;

} else {

  // Try to get an access token (using the authorization code grant)
  $token = $provider->getAccessToken('authorization_code', [
      'code' => $_GET['code']
  ]);

  // Optional: Now you have a token you can look up a users profile data
  try {

    // We got an access token, let's now get the user's details
    $userDetails = $provider->getUserDetails($token);

    // Use these details to create a new profile
    printf('Hello %s!', $userDetails->data->firstName);

  } catch (Exception $e) {

    // Failed to get user details
    exit('Oh dear...');
  }

  // Use this to interact with an API on the users behalf
  echo $token->accessToken;

  // Use this to get a new access token when the old one expires (2 hours from initial handshake)
  echo $token->refreshToken;

  // The Unix Epoch Timestamp when the Coinbase Token will expire
  echo $token->expires;
}

Refreshing a Token

$provider = new PierceTech\OAuth2\Client\Provider\Coinbase([
  'clientId'      => 'XXXXXXXX',
  'clientSecret'  => 'XXXXXXXX',
  'redirectUri'   => 'https://your-registered-redirect-uri/',
]);

$grant = new \League\OAuth2\Client\Grant\RefreshToken();
$token = $provider->getAccessToken($grant, ['refresh_token' => $refreshToken]);

Testing

Since this requires user interaction, no actual Coinbase interaction testing is done, but some basic component quality tests can be run:

vendor/bin/phpunit