Getting Started

The following steps should be followed before integrating the Samsung Blockchain Platform SDK:

Prepare Samsung Galaxy device to run your apk.
Check your development environment.
- Android minimum API level for Samsung Blockchain Platform SDK : 24
Note :
Minimum build level for Samsung Blockchain Platform SDK is 21, but will properly work from level 24.

Configure your IDE to integrate Samsung Blockchain Platform SDK with your Android app.
Create an “aar” directory if you don’t have one, and add the BlockchainPlatformSDK_1.2.01.aar to ”aar” directory in your Android project.
Go to Gradle Scripts > build.gradle and enter the following dependencies:

dependencies {
    repositories {
        flatDir{
            dirs 'aar'
        }
    }
    implementation name: 'BlockchainPlatformSDK_1.2.01', ext: 'aar'
    
    // network
    implementation 'com.squareup.retrofit2:retrofit:2.6.0'
    implementation 'com.squareup.retrofit2:converter-gson:2.6.0'
    implementation 'com.squareup.okhttp3:logging-interceptor:3.8.0'
    implementation 'com.google.code.gson:gson:2.8.5'
    
    // web3j
    implementation 'org.web3j:core:4.8.8-android'
    
    // for check developer mode
    implementation 'org.ini4j:ini4j:0.5.4'
    
    // dagger
    implementation 'com.google.dagger:dagger:2.21'
    annotationProcessor 'com.google.dagger:dagger-compiler:2.21'
        
    implementation "io.reactivex.rxjava2:rxjava:2.2.8"
    implementation "io.reactivex.rxjava2:rxandroid:2.1.1"
        
    // Protobuf
    implementation 'com.google.protobuf:protobuf-java:3.9.1'
    implementation 'com.google.protobuf:protobuf-gradle-plugin:0.8.10'
    annotationProcessor "org.eclipse.sisu:org.eclipse.sisu.inject:0.0.0.M5"
}

Import the package into your code.

import com.samsung.android.sdk.blockchain.*;

Samsung Blockchain Platform SDK supports 2 kinds of hardware wallet:

Samsung Blockchain Keystore
Ledger's devices like Nano X, Nano S.

Note :

Transactions on EVM-Compatible networks Binance Smart Chain, Klaytn, Polygon, Avalanche (C-chain) and Fantom are signed from the Hardware Wallets using the same pathway as that of Ethereum. For these transactions, currency unit displayed on HardwareWallet, such as Samsung Keystore or Ledger, will show ETH as currency unit instead of BNB, KLAY, MATIC, AVAX and FTM.

Development setting guide for each environment is as follows:

Integration with Samsung Blockchain Keystore

Samsung Blockchain Keystore is compatible with selected Samsung devices only.

You need to have one of selected Samsung devices to run your app with Samsung Blockchain Keystore. Please refer to the restrictions.

Check your development environment.
- Android minimum API level for Samsung Blockchain Keystore : 28
Note :
Samsung Blockchain Platform SDK requires Samsung Blockchain Keystore that is higher than 1.5.1.

Download the Samsung Blockchain Keystore SDK.
Set 'Developer Mode' to test your app without App ID verification.
You can find more information about App ID (scw_app_id), here.
Add "KeystoreSDK_v1.5.1.aar to "aar" directory in your Android project.
Go to Gradle Script > build.gradle and add below dependency:

dependencies {
     ...   
    // KeyStore SDK
    implementation name: 'KeystoreSDK_v1.5.1', ext: 'aar'
    ...
 }

Integration with Nano X or Nano S by Ledger

There is no restrictions to link with Ledger device.

So any Samsung Galaxy mobile is ok to test your app which is integrated with Samsung Blockchain Platform SDK when you sign with Ledger device.

Note :

Connecting to Ledger Nano X with firmware 2.0.0 over Bluetooth might not work properly.
To resolve this issue, please checkout Bluetooth Pairing Documentation from Ledger. If the issue still persists, please reach out to Ledger's support channel.

Check your development environment.

Ledger Nano X : 1.2.4-1 or higher
Ledger Nano S : 1.6 or higher
Ledger : Ethereum App: 1.9.8 or higher

You can refer Ledger's guide page to get started.

Go to Gradle > build.gradle and add below dependency:

dependencies {
    ...
    // ledger
    implementation 'com.ledger.lib:ledger-android-library:1.2.2'
}