Skip to main content
Version: Next

Getting Started

The primary goal of a Keypom drop is to send assets to users with the click of a link regardless of whether they have a wallet or not. These assets can come in many forms which will be broken down below.

The basic tutorials are meant as introductory guides that will help you create your first Keypom drops and understand the differences between the types of Keypom drops and the assets they contain.

There are four types of drops, each with different types of assets. These drops can be claimed either with a brand new NEAR account or an existing one.

Drop TypeAssets
Simple Drop$NEAR
Non-Fungible Token DropNFT and optionally $NEAR
Fungible Token DropFungible Tokens and optionally $NEAR
Function Call DropSet of function-calls and optionally $NEAR

The Simple Drop is the most basic type of drop, it allows you to send $NEAR via a link to new or existing users.

NFT Drops and FT Drops are extensions of the Simple drop, they allow you to send NFTs and FTs in addition to $NEAR.

The Function Call Drop is Keypom's most powerful type of drop. It allows you send a link that is capable of calling almost any function on any smart contract that you predefine. A simple example of this is auto-registering users into a DAO as part of the onboarding process.

While there are many drop configurations available to developers such as multi-use keys or time-based restrictions, in these basic tutorials, a single use key with no additional configurations will be created.

Throughout each tutorial, two simple NodeJS scripts will be created that use both NEAR's native NEAR-API-JS library, and Keypom's JS-SDK.


Prerequisites

For the basic tutorials, you can choose to run the scripts on your own machine. To do so, you must have the following:

  1. Node JS
  2. NEAR-API-JS
  3. Keypom JS SDK

At this point, you are ready to start the tutorials.

Alternatively, if you wish to use ready-to-use scripts that can be customized to your liking in order to quickly create Keypom drops, visit the Keypom Protocol.