coinbase-bitmonet-sdk

KO | EN

gitlite — search

#python #llm #go #machine-learning #deep-learning #linux #docker #nodejs #java #kubernetes #vue #security #pytorch #open-source

coinbase-bitmonet-sdk

(★ 64)

DEPRECATED — Library to accept bitcoin payments in your Android App

File Explorer

Download Latest Version (.zip)

- - org.eclipse.jdt.core.prefs
- - android-support-v4.jar
  - gson-2.2.4.jar
- AndroidManifest.xml
- lint.xml
- proguard-project.txt
- project.properties
- - org.eclipse.jdt.core.prefs
- - android-support-v4.jar
- AndroidManifest.xml
- ic_launcher-web.png
- proguard-project.txt
.gitignore
LICENSE
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Coinbase Android SDK developed in collaboration with [Bitmonet Open-source project](http://www.bitmonet.com) is the first SDK that allows any Android developer to monetize their Android app with Bitcoins.

## Features
 1. Monetize virtually anything with Bitcoins
 2. Accept payments with just one click
 3. Transfer money without showing the modal after receiving the authorization   
 4. Seamless OAuth and token management

## Set-up

1. Create a Coinbase account and Register an App
 2. `git clone git@github.com:coinbase/coinbase-android-sdk.git`
 3.	Import the code into your Android Workspace: File > Import... > Android > Existing Code into Android Workspace
 4.	Add the bitmonet project as a library project to the App that you wish to monetize: Properties > Android > Library > Add
 5. Add the following two lines of code in your manifest file

```xml
<activity android:name="com.bitmonet.coinbase.CoinbaseWebView"
	android:theme="@android:style/Theme.NoTitleBar" />
```

## Usage

1. Initialize the SDK, when you initialize your app using the `initialize` API call
2. Set the receiving address using the `setReceivingAddress` API call
3. Request the user to access their wallet using `requestWalletAuthorization` call and implement the `BitmonetOAuthStatusListener` interface to get the status of OAuth process. 
4. To execute a transaction use the `sendMoney` or the `sendMoneyInBackground` API and implement the `BitmonetPaymentStatusListener` interface to get the status of a transaction

Sample implementation:

```java

public class MainActivity extends Activity implements BitmonetPaymentStatusListener, BitmonetOAuthStatusListener {

@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);

setContentView(R.layout.oauth_launcher);

// Initialize the Bitmonet SDK
		Bitmonet.initialize(getApplicationContext(), "YOUR CLIENT ID", "YOUR CLIENT SECRET", "YOUR CALLBACK URL");

// Set the address where you want to receive your Bitcoins
		Bitmonet.setReceivingAddress("YOUR RECEIVING ADDRESS");

// Set the transaction currency
		Bitmonet.setTransactionCurrency("BTC");

Button authorize = (Button) findViewById(R.id.button1);
		authorize.setOnClickListener(new OnClickListener() {
			@Override
			public void onClick(View v) {
				// Request Wallet Authorization
				Bitmonet.requestWalletAuthorization(MainActivity.this);
			}
		});

Button sendMoney = (Button) findViewById(R.id.button2);
		sendMoney.setOnClickListener(new OnClickListener() {
			@Override
			public void onClick(View v) {
				// Send money and ask the user for a confirmation
				Bitmonet.sendMoney(MainActivity.this, "1000 Gold", 0.001);
			}
		});

Button sendMoneyInBackground = (Button) findViewById(R.id.button3);
		sendMoneyInBackground.setOnClickListener(new OnClickListener() {
			@Override
			public void onClick(View v) {
				// Send money in the background
				Bitmonet.sendMoneyInBackground(MainActivity.this, "1000 Gold", 0.001);
			}
		});
		
		Button sendMoneyError = (Button) findViewById(R.id.button4);
		sendMoneyError.setOnClickListener(new OnClickListener() {
			@Override
			public void onClick(View v) {
				// Generate an error in the sendmoney call
				Bitmonet.sendMoney(MainActivity.this, "1000 Gold", 0.00000001);
			}
		});

}

@Override
	public void paymentFailure(String[] errors) {
		String displayError = "";

for (int i = 0; i < errors.length; i++) {
			displayError = displayError + errors[i] + " ";
		}

Toast.makeText(getApplicationContext(), "Errors: " + displayError, Toast.LENGTH_LONG).show();
	}

@Override
	public void walletOAuthStatusListener(boolean status) {
		Toast.makeText(getApplicationContext(), "OAuth Complete: " + String.valueOf(status), Toast.LENGTH_LONG).show();
	}

@Override
	public void paymentSuccess(String hash) {
		Toast.makeText(getApplicationContext(), "Transaction Hash: " + hash, Toast.LENGTH_LONG).show();
	}

```

## API

* Initialize the SDK
``` java 
/*
	 * Call this function to initialize the Bitmonet SDK. This function needs to
	 * be call before any API call.
	 * 
	 * @param context Context of the application usign Bitmonet
	 * 
	 * @param clientId ClientId value obtained from Coinbase
	 * 
	 * @param clientSecret ClientSecret obtained from Coinbase
	 * 
	 * @param callbackUrl Callback URL registered at Coinbase. Please ensure
	 * that the scheme used for the URL is unique to your application. The
	 * test application uses bitmonet://bitmonet. This is required to
	 * successfully redirect the user back to the app during the OAuth2 process
	 */
	public static void initialize(Context activtityContenxt, String clientId, String clientSecret, String callbackUrl)
```

* Set the receiving address
```java
/*
	 * Set the receiving address. This needs to set to the receive the Bitcoins.
	 * 
	 * @param receivingAddress Bitcoin public address where all the bitcoins
	 * would be sent
	 */
	public static void setReceivingAddress(String receivingAddress)
```

* Set the transaction currency
```java
/*
	 * Set the transaction currency. The default currency is USD. But you can
	 * use any currency supported by Coinbase
	 * 
	 * @param currency Currency to be shown to the customer and used during
	 * transactions
	 */
	public static void setTransactionCurrency(String currency)
```

* Request Authorization to access the wallet
```java
/*
	 * Request an Authorization from the user to access the wallet. This needs
	 * to be done only once, and Bitmonet takes care of refreshing the access
	 * token. Implement the BitmonetOAuthPaymentStatuslistener to get a
	 * notification on the completion of OAuth2 process.
	 * 
	 * Before this method is called, ensure that Bitmonet has been initialized
	 * and CoinbaseWebview activity is declared in your manifest file.
	 * 
	 * @param context Context of the activity from where this method is called.
	 */
  public static void requestWalletAuthorization(Context activityContext) 
```

* Transfer money from the user account to the specified receiving address
```java
/*
	 * Send money to the specified address after asking for a confirmation from
	 * the user. This method transfers the money from the user's account to the
	 * receiving address set by the merchant. A modal is shown asking the user
	 * to confirm the transaction. Implement the BitmonetPaymentStatusListener
	 * to get the status of this call.
	 * 
	 * Before this method can be called, ensure that Bitmonet is initialized,
	 * OAuth has been done, and a receiving address has been set.
	 * 
	 * @param context Context of the calling activity. For e.g. use
	 * YourActivity.this as the value when calling this method.
	 * 
	 * @param itemName Name of the item being purchased
	 * 
	 * @param amount Amount to charged
	 */
	public static void sendMoney(Context activityContext, String itemName, double amount)
```

* Transfer money from the user account to the specified receiving address without showing the modal
```java
	/*
	 * Send money to the specified address without showing the confirmation
	 * modal. This method transfers the money from the user's account to the
	 * receiving address set by the merchant. A modal is shown asking the user
	 * to confirm the transaction. Implement the BitmonetPaymentStatusListener
	 * to get the status of this call.
	 * 
	 * Before this method can be called, ensure that Bitmonet is initialized,
	 * OAuth has been done, and a receiving address has been set.
	 * 
	 * @param context Context of the calling activity. For e.g. use
	 * YourActivity.this as the value when calling this method.
	 * 
	 * @param itemName Name of the item being purchased
	 * 
	 * @param amount Amount to charged
	 */
	public static void sendMoneyInBackground(Context activityContext, String itemName, double amount)
```

## Warning

Please use the SDK at your own discretion, and read the Google Play guidelines before publishing your app

coinbase-bitmonet-sdk

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

coinbase-bitmonet-sdk

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README