Skip to content
This repository has been archived by the owner on Nov 22, 2022. It is now read-only.

kinecosystem/kin-android

Repository files navigation

Deprecation Warning

Kins's Agora powered SDKs have been deprecated and Agora replaced with Kinetic.

Kinetic

Kinetic is an open-source suite of tools that make it easy to build apps that integrate Solana.

It provides a consistent and clean abstraction over the Solana SDKs and enhances it with some commonly requested features like paying Solana fees on behalf of the user, tracking and timing the users transactions and sending out webhooks.

Kinetic is aimed at developers that want to build crypto-experiences for the users of their app, hiding a lot of the details about the blockchain out of sight for both the developer and the end user.

Learn more about Kinetic here.

See our new suite of Kinetic SDK's here.

Kin Logo Kin SDK Android

codecov CircleCI KDoc Maven Central

Use the Kin SDK for Android to enable the use of Kin in your app. Include only the functionality you need to provide the right experience to your users. Use just the base library to access the lightest-weight wrapper over the Kin cryptocurrency. The design library provides a set of basic UI elements to ensure the user experience offered to your users is consistent and high-quality. The spend library provides a flow for users to pay invoices with Kin. The base-compat library adds support for a pre-built wallet backup solution.

Library                              Support Path                     Description
base   /base The foundation library used by all other libraries in the system to support basic Kin operations:
  • Wallet creation and management
  • Send and receive Kin
  • Metrics interfaces
base-compat   /base-compat The :base-compat library now only contains the backup & restore flow retrofitted on top of base. If you're using an old version of base-compat please consider upgrading to base. If you want to support backup & restore, you must include base and base-compat.
design   /design Shared :design library components for creating consistent Kin user experiences. When creating a custom Kin experience, this library can be used to include standard UI components for displaying Kin prices, transactions, etc.
spend   /spend The :spend library provides an out of the box model UI for spending Kin within an Android application. Specificy what you're buying, your account, tap confirm. Success.

*Note: base-storage, base-viewmodel, & base-viewmodel-impl are internal dependencies to other libraries that are not meant to be directly consumed at this time.

Installation

buildscript {
    // ...
    ext {
        versions = [:]

        versions.kin = "2.1.2"
    }
}
repositories {
    // ...
    mavenCentral()
}
dependencies {
    // ...

    implementation "org.kin.sdk.android:base:${versions.kin}"
    // Optional libraries, add as needed, see their respective READMEs for additional implementation details
    // implementation "org.kin.sdk.android:base-compat:${versions.kin}"
    // implementation "org.kin.sdk.android:design:${versions.kin}"
    // implementation "org.kin.sdk.android:spend:${versions.kin}"
}

Demo App

The demo directory includes a demo application, showcasing a Kin wallet.

Design Showcase App

The design-showcase directory includes an application showcasing the UI widgets that are both: used in our full screen experiences, and also publicly available for all developers to use from the design library.

Documentation

KDoc Documentation for all classes in all modules located here