Kinetic Migration

Code Changes

If you're upgrading to Kinetic from Agora, there'll be some code changes for you to deal with.

Follow the links below to see how the Kinetic API differs from previous Kin SDK versions.

TypeScript

See the TypeScript API changes

Python

See the Python API changes

iOS

See the iOS API changes

Android

See the Android API changes

Hosting Kinetic

When you transact with Kinetic on Mainnet, you'll need a Kinetic instance to connect to. This can be your own self-hosted instance or a 3rd party Kinetic As A Service option.

See here for more details.

Transaction Fees

On Agora, transaction fees were paid directly by the Kin Foundation who were / are hosting the Agora service.

In Kinetic, developers will be responsible for paying for transaction fees for their own apps, unless they are using a 3rd party Kinetic As A Service provider that chooses to cover those costs as part of the service.

Support towards these payments can come from the Kin Foundation in terms of KRE payments and grant requests.

Kin Rewards Engine

Earn Kin by using it in your App

Kin Catalyst Fund

Grants! Kin offers a range of grants to help great ideas become reality.

Upgrading Keypairs

As apps upgrade to Kinetic, we recommend that developers migrate their users to the new Kinetic Keypairs.

These Keypairs are standard Solana Keypairs and give users greater control of their funds through mnemonics that allow them to access their funds with any Solana wallet. E.g. Phantom, Solflare, etc.

We recommend a process where user's Kin is moved from their previous Stellar Keypair to a new Solana Keypair.

Step 1 - Access the existing Stellar Keypair in Kinetic

We have compatibilty tools that allow you to generate a Keypair in Kinetic from a Stellar secret.

TypeScript

Use Stellar Keypairs in Kinetic with Node / Typescript

See how to implement this in your code here. Pop into kinetic-typescript on Discord if you need assistance.

Python

Use Stellar Keypairs in Kinetic with Python

See how to implement this in your code here. Pop into kinetic-python on Discord if you need assistance.

iOS

Convert Stellar Keypairs to Solan Keypairs on iOS

Pop into kinetic-ios on Discord if you need assistance.

Android

Convert Stellar Keypairs to Solan Keypairs on Android

Pop into kinetic-android on Discord if you need assistance.

Use the compatability tool to use your Stellar secret in Kinetic and get a Keypair.

Step 2 - Create a new Solana Keypair

Create a new Solana Keypair with a mnemonic using a Kinetic SDK and use this as the user's new Keypair going forward.

Step 3 - Move all of the user's Kin to the new Keypair

Use the Stellar Keypair to sign a transaction moving all of the users' Kin to their new Solana Keypair.

Step 4 - Claim back any Sol from the empty accounts

On a monthly basis, we will pay app owners back the value of their closed empty accounts in Sol. Get in touch once you're ready to reclaim your funds.

What If I Get Stuck?

Pop into the kinetic-general channel on Discord or one of the SDK specific channels and we'll give you a hand.

Getting Help

Stuck? No problem, we have an amazing community waiting to help out.

Developer Discord

Join our fantastic developer community.


Was this page helpful to you?
Provide feedback