Kin iOS SDK

A library responsible for creating a new Kin account and managing balance and transactions in Kin.

End-of-Life

This SDK is no longer supported for new users. Please see kin-core-ios for the current SDK.

Installation

In the meantime, we don't support yet CocoaPods or Carthage. The recommended setup is adding the KinSDK project as a subproject, and having the SDK as a target dependencies. Here is a step by step that we recommend:

Clone this repo (as a submodule or in a different directory, it's up to you);
Drag KinSDK.xcodeproj as a subproject;
In your main .xcodeproj file, select the desired target(s);
Go to Build Phases, expand Target Dependencies, and add KinSDK;
In Swift, import KinSDK and you are good to go! (We haven't tested yet Obj-C)

This is how we did the Sample App - you might look at the setup for a concrete example.

API Usage

`KinClient`

KinClient is where you start from. In order to initialize it, a ServiceProvider must be passed. We recommend using InfuraTestProvider (please go to infura.io and generate an API token) for the test environment:

let kinClient = try? KinClient(provider: InfuraTestProvider(apiKey: "YourApiToken"))

No activity can take place until an account is created. To do so, call createAccountIfNeeded(with passphrase: String). To check if an account already exists, you can inspect the account property. The passphrase used to encrypt the account is the same one used to get the key store and send transactions.

Parity service provider

Unfortunately there is no guarantee that getPendingBalance will work when working with an Infura provider because of an existing known issue with the geth implementation of the ethereum protocol.
In order for getPendingBalance to work as expected you will need to connect to a node running a parity implementation of the protocol.

`KinAccount`

Public Address and Private Key

var publicAddress: String: returns the hex string of the account's public address.
func exportKeyStore(passphrase: String, exportPassphrase: String) throws -> String?: returns the account's keystore file as JSON. The first parameter - passphrase - is the passphrase of the account, used in the other methods; and second parameter - exportPassphrase - is the password that the user should input to encrypt his account before exporting it as JSON. Throws an error in case the passphrase is wrong.

Note For the methods below, a sync and an async version are both available. The sync versions will block the current thread until a value is returned (so you should call them from the main thread). The async versions will call the completion block once finished, but it is the developer's responsibility to dispatch to desired queue.

Checking Balance

func balance() throws -> Balance: returns the current balance of the account.
func pendingBalance() throws -> Balance: returns the pending balance of the account that is waiting for confirmation.

Sending transactions

func sendTransaction(to: String, kin: Double, passphrase: String) throws -> TransactionId: Sends a specific amount to an account's address, given the passphrase. Throws an error in case the passphrase is wrong. Returns the transaction ID. Currently returns a hardcoded value of MockTransactionId

Testing

We use ethereumjs/testrpc and Truffle framework unit tests.

For the SDK tests target, pre-actions and post-actions scripts in the KinTestHost scheme will setup truffle and testrpc running for the duration of the test.

Requirements

Node.js and NPM. You can install these using homebrew:

$ brew install node

Next, install specific npm packages using:

$ cd truffle
$ npm install

Next, initialize and update git submodules. This will include truffle/kin-token.

$ git submodule init && git submodule update

To run the tests, use (from the root directory):

$ make test

Contributing

Please review our CONTRIBUTING.md guide before opening issues and pull requests.

License

This repository is licensed under the MIT license.

kinecosystem / kin-core-ios-ethereum