Terms and Concepts

Account

Accounts are a fundamental component of Kin - it holds Kin balances and allows its owners to send and receive payments. An account is associated with a keypair: the keypair's public address is used as the identifier for the account, while its private seed is used to authenticate transactions for the account.

App Index

An App Index is a unique index assigned to apps who are registered. When you initialize your Kin SDK with your App Index, it automatically gets included in the memo of transactions sent by your users and/or backend server. It gets used to track the activity your application generates so you can be rewarded from the Kin Rewards engine. An App Index is an unsigned 16-bit integer.

Commitment

Commitment is the level of certainty that a specific block has been written permanently to the blockchain. E.g. a 'Processed' block could in theory end up being rejected and so the transaction wouldn't go through. This is rare. 'Finalized' gives total certainty but takes longer to return. 'Confirmed' is a middle option. See here for more details.

Earn

An earn is a payment from an app to a user (e.g. as a reward for a specific behaviour).

Keypair

A keypair is a combination of a public key (i.e. public address) and private key (i.e. private/secret seed). There is a one-to-one correspondence between the private key and the public key created by means of a cryptographic algorithm. This correspondence is asymmetrical, that is, the public key can be easily derived from the private key, but the private key cannot be obtained from the public key. This property of a keypair is used for securing Kin transactions on the blockchain. The private key is supposed to be stored securely by the owner of the account, while the public key serves as the identifier of the account on the blockchain and thus can be freely exposed to anyone. Each transaction sent from an account to the blockchain is signed with a signature derived from the private key (without disclosing it). The blockchain then uses the public key held by the blockchain account to verify that the signature is valid, i.e. created by the owner of the corresponding private key.

Kin

Kin is token on the Solana blockchain. 1 Kin = 100000 Quarks.

Kin is a token on the Solana blockchain. Solana is a consumer grade blockchain built for scale. It can currently handle 65,000 transactions per second, on par with Visa. Solana transaction times are roughly 400 milliseconds making it perfect for the consumer applications of all sizes. Solana is also extremely decentralized and secure. Read more at Solana.

Kin Rewards Engine

Each participating developer is compensated by the Kin Foundation for their contribution to the growth of the Kin ecosystem. When the rewards engine goes live it will transfer Kin directly from the foundation to the app account on the Kin Blockchain. For more information, see here

Payment

A payment in Agora simply refers to a transfer of money from one account to another. Payments do not necessarily correspond 1:1 to transactions - a transaction can sometimes contain multiple payments.

P2P

A P2P transaction is a payment from a user to another user.

Public Key (Public Address)

A public key is the address (identifier) of an account on the blockchain, which holds the account’s balance and has access to the blockchain data.

Private Key (Private Seed)

A private key is used for authentication and encryption. It allows unlocking and accessing the Kin blockchain account it belongs to. As such, it should be stored securely by the user or their client device. To be processed by the blockchain, any transactions on a blockchain account have to be signed with its private key (without disclosing the private key itself).

Quark

The smallest currency denomination of the Kin blockchain. 1 Quark = 0.00001 Kin.

Spend

A spend is a payment from a user to an app (e.g. to purchase something).

Solana

The blockchain on which the Kin 4 token is stored and transacted.

Token Account

An account that holds token balances. On Solana, a wallet can own multiple token accounts, which may have different addresses from the owner wallet. Kin is a token on Solana, so Kin balances are held in token accounts.

Transaction

A transaction modifies the state of a blockchain ledger. A Kin transaction can contain multiple independent operations. Most transactions are used to create accounts or submit payments.

Transaction Fee

These are the fees (in SOL) charged by Solana the blockchain for every transaction. The minimum required fee is dictated by the blockchain. Fees on the Solana are used to:

  • provide unit compensation to the validator network for the CPU/GPU resources necessary to process the state transaction
  • reduce network spam by introducing real cost to transactions
  • open avenues for a transaction market to incentivize validation-client to collect and process submitted transactions in their function as leader
  • and provide potential long-term economic stability of the network through a protocol-captured minimum fee amount per transaction, as described below.

Registered Kin apps currently have their fees subsidized by the Kin Foundation when approving transactions via the Sign Transaction webhook. At some point in the future the apps will be responsible for these fees but will be notified well in advance.

Transaction Type

Kin Transactions can be recorded as a number of different types: Spend, Earn, P2P.

What If I Get Stuck?

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