AirdropRoot is the primary management contract that controls all configurations and settings for each airdrop instance, ensuring seamless token distribution. Key functions of AirdropRoot include:

• Activation and Deactivation of Airdrop: AirdropRoot can start or pause an airdrop at any time with a toggle function, allowing for maintenance and emergency adjustments.

• Batch Token Funding: Instead of preloading the entire token supply, AirdropRoot allows tokens to be added in batches, facilitating gradual token distribution and reducing upfront capital requirements.

• Deterministic Recipient Address Generation: AirdropRoot calculates a unique claim contract address for each user based on user data, enabling secure claim transactions and preventing duplicates.

By centralizing these functions, AirdropRoot acts as the “command center” for airdrop operations, orchestrating all aspects of token distribution.

GigaDrop is an innovative token distribution solution designed to work on the TON blockchain, enabling the token drop process at a massive scale. Built to handle high volumes of users, GigaDrop offers speed, reliability, and security, allowing our partners to focus on audience growth without the technical complexity of airdrop logistics. This documentation will help you understand and implement GigaDrop for your token distribution needs.

GigaDrop’s architecture is purpose-built to ensure secure, efficient, and scalable token distributions, leveraging a modular system of smart contracts and TON’s shard-based structure. Each component plays a unique role, from managing claim processes to optimizing transaction throughput across the TON network.

The two major components of the system are:

• AirdropRoot - the master control contract;

• AirdropClaim - the verification and security contract.

AirdropClaim is responsible for processing individual claims, safeguarding against duplicate claims and providing core security features. Key elements of AirdropClaim include:

• Duplicate Claim Protection: Each AirdropClaim contract is assigned a unique, deterministic address based on user and claim data, preventing multiple claims from the same user within a single airdrop.

• Automatic Creation and Self-Destruction: The AirdropClaim contract is created upon each claim request to prevent duplicate claims. In the event of an unsuccessful claim, the contract self-destructs, freeing resources and allowing the user to attempt the claim again if needed.

• TON Refund Handling: In case of a failed claim due to insufficient funds or other errors, remaining TON (minus network fees) is refunded to the user, ensuring minimal cost impact.

Together, these mechanisms make AirdropClaim the core layer of GigaDrop’s security, allowing for efficient and protected claim processing.

Challenges of Traditional Airdrops

Projects launching airdrops frequently face several technical limitations:

1. Network Congestion: Distributing tokens to millions of users creates network strain, leading to delays and increased transaction fees.

2. Limited Throughput: Conventional platforms often lack the capacity to handle a high volume of simultaneous requests, resulting in delays and uneven token distribution.

3. Risk of Duplicate Claims: In mass token distributions, users may attempt to claim tokens multiple times, complicating accounting and requiring enhanced security measures.

GigaDrop’s Solution

GigaDrop addresses these issues with a smart contract system and sharding architecture on TON, providing high throughput, duplicate claim protection, and automated queue processing through an intuitive SDK. With GigaDrop, partners can scale their airdrops while minimizing risks, making token distribution simpler and more reliable.

The SDK is designed with robust security features, automatically handling verification and fraud prevention. This ensures that each token claim is secure, protected from duplicate claims, and verified according to GigaDrop’s built-in safeguards. The widget’s backend logic manages these validations, so developers don’t need to worry about implementing separate security layers.

GigaDrop capitalizes on TON’s multi-shard architecture to maximize performance, reducing congestion and latency across the network. Shard optimization enables each transaction to process quickly and independently across multiple shards.

Shard Optimization Advantages:

• Parallel Processing: AirdropRoot contracts operate in separate shards, enabling simultaneous claims across multiple shards and increasing system throughput.

• Reduced Cross-Shard Communication: To minimize latency, AirdropRoot and user wallets are matched within the same shard whenever possible, lowering cross-shard interaction.

• High Throughput: GigaDrop’s shard-optimized design supports up to 120 claims per second, making it ideal for large-scale airdrops.

With shard optimization, GigaDrop can efficiently handle large volumes of claims, maintaining speed and consistency.

The technical foundation of GigaDrop is designed to ensure secure, efficient, and scalable token distribution for projects of any size. Below, we explore the core technical features that enable GigaDrop to deliver a seamless and reliable airdrop experience for both users and project teams.

GigaDrop operates through a “checkbook” system, which simplifies token distribution and enhances user experience. This system allows projects to generate and sign tokenized claim checks for future redemption. Each check comprises:

• Recipient Address: The user’s wallet receiving the tokens.

• Token Amount: The specific token amount allocated to the user.

• Unique Claim Contract: A unique, deterministic contract address for each user claim, ensuring secure and controlled token retrieval.

• Salt: A service field for shard optimizations. Calculated deterministically based on recipient

• ClaimId: This field is utilized for flexible customization of Airdrop operations. It is particularly applicable in scenarios where it is necessary to issue multiple checks to the same address, or in cases where user engagement fluctuates during an active Airdrop campaign, necessitating the execution of multiple batches, among other situations.

To prevent network congestion during peak traffic, GigaDrop includes a built-in queue management system within AirdropRoot. The queue follows a FIFO (First-In, First-Out) model to ensure fairness and efficient claim processing. Key queue parameters include:

• Throughput Control: Dynamically managed, the queue can handle between 1 and 120 claims per second, depending on network conditions.

• Session Timeouts: Users inactive for more than 10 minutes are automatically removed, freeing up resources for active users.

• Claim Window: Once users reach the front of the queue, they have up to one hour to complete their claim, ensuring flexibility and accessibility.

This queue system maintains stable performance even during high-traffic periods, offering a smooth user experience.

The SDK offers ready-made examples that clients can easily integrate into their sites or applications, providing a user-friendly interface for token claims without requiring users to navigate away. These examples are highly customizable in terms of appearance, layout, and specific claim parameters, allowing developers to adjust the design to seamlessly match their site or application’s aesthetic.

Read the full description of our library capabilities:

GigaDrop provides an SDK designed for easy and flexible integration, enabling clients to incorporate a seamless token claim experience directly into their websites or applications. The SDK includes the @gigadrop/airdrop-ui package, which allows users to set up a customizable, secure claim widget that can be embedded on any platform using popular frameworks and technologies such as React, Vanilla JavaScript, Vite, and Vue.

The monitoring solution offers Prometheus-based endpoints to collect data on claim metrics. This enables seamless integration with existing monitoring systems, providing clients with actionable insights and helping them monitor the airdrop’s performance and user engagement.

Queue Monitoring

• Queue Size: Current number of users in the queue.

• Cache Size: Number of users currently eligible to submit a transaction, including those who have already submitted.

• Enqueue: Number of new users entering the queue per second.

• Touch: Requests to obtain or save a position in the queue.

• Dequeue: Number of users who have reached the front of the queue.

Airdrop Status Monitoring

• Claimed Amount: Total tokens claimed by users.

• Success Claims Count: Total number of successful claims.

• Total Token Amount: Total tokens allocated to airdrop contracts.

• Current Token Balance: Remaining token balance in the contracts.