Android In-Dapp Crypto Payment SDK for Naika Ecosystem.

Getting Started

To start working with NaikaPay, you need to add its dependency into your build.gradle file:

Dependency

dependencies {
    implementation "com.github.naika.naikapay:naikapay:[latest_version]"
}

Then you need to add jitpack as your maven repository in build.gradle file:

repositories {
        google()
        jcenter()
        maven { url 'https://jitpack.io' }
    }

How to use

For more information regarding the usage of Poolakey, please check out the wiki page.

Sample

There is a fully functional sample Android Dapp that demonstrates the usage of NaikaPay, all you have to do is cloning the project and running the app module. Sample Dapp is a coin toss game that operates in Ethereum Goerli test network. Here is the coin toss Dapp Smart Contract.

Coin toss Dapp is a simple game, you can buy a chance with your ETH in your wallet. Each chance let you toss the coin 3 times. you should predict the coin toss result before every toss. If you can predict all results correctly, you will win the 3 time of your investment in ETH otherwise you may want to buy another chance to play again.

Coin toss Dapp game crypto features that enables using NaikaPay SDK:

1. Connect Wallet functionality.
2. Sign a Smart Contract transaction to Buy a chance with ETH in your connected wallet.
3. Sign a Smart Contract transaction to Claim your winning rewards to your wallet.

Usage

Prerequisites

Naika Pay Android SDK is a library that enables mobile native Dapp developers to have in-Dapp crypto payments. Naika Pay Android SDK needs to sign Smart Contract transactions using user's private key, but it does not keeps or store user's private key as it is a unsecure approach. So Naika Pay should interact with another Naika Ecosystem product named Naika Signer, Naika Signer is a light weight Ethereum wallet that user can create/import Ethereum wallets. Naika Signer is an Android native application that stores wallet's private key securely on device storage. Naika Pay Android SDK never ask user's private key or your password for decrypting stored private key, instead it is the Naika Signer responsibility to show pop-up dialogs to ask your password for unlocking the private key. For recap, Naika Pay Android SDK is a payment gateway that uses Naika Signer to sign transactions. So it is necessary for users to have Naika Signer installed alongside with your Dapp(which is using Naika Pay Android SDK for in-Dapp crypto payments) in their Android phone.

Initialize NaikaPay SDK

private val payment by lazy(LazyThreadSafetyMode.NONE) {
    Payment(context = this)
}

private lateinit var paymentConnection: Connection

paymentConnection = payment.initialize(NetworkType.ETH_MAIN) {
    connectionSucceed {
        Log.d("Payment", "connectionSucceed")
    }
    connectionFailed {
        //You can find out why the connection fails.
        Log.d("Payment", it.message.toString())
    }
    disconnected {
        Log.d("Payment", "disconnected")
    }
}

Disconnect from NaikaPay SDK and free up resources

override fun onDestroy() {
    paymentConnection.disconnect()
    super.onDestroy()
}

Connect Wallet Functionality

if (paymentConnection.getState() == ConnectionState.Connected) {
    connectWallet()
}
private fun connectWallet() {
    payment.connectWallet(
        registry = activityResultRegistry
    ) {
        connectWalletSucceed { accountInfo ->
            Log.d("Payment", "connectWalletSucceed")
        }
        connectWalletCanceled {
            Log.d("Payment", "connectWalletCanceled")
        }
        connectWalletFailed {
            Log.d("Payment", it.message!!)
        }
    }
}

MIT License

Copyright (c) 2022 Naika DAO

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.