@dropsy/airdrop 0.2.6 → 0.3.0

package/package.json

@@ -1,59 +1,66 @@
-{
-  "name": "@dropsy/airdrop",
-  "version": "0.2.6",
-  "description": "Dropsy - The Token Districution Layer on SOLANA",
-  "main": "./dist/index.js",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
-  "publishConfig": {
-    "access": "public"
-  },
-  "homepage": "https://docs.dropsy.xyz/",
-  "repository": {
-    "url": "https://github.com/scoolmb/dropsy-airdrop"
-  },
-  "scripts": {
-    "test": "ts-node index.ts",
-    "build": "tsup"
-  },
-  "keywords": [
-    "solana",
-    "solana airdrop",
-    "web3",
-    "create airdrop",
-    "solana web3",
-    "dropsy",
-    "solana devtools",
-    "token distribution",
-    "airdrop protocol",
-    "solana sdk",
-    "merkle airdrop",
-    "gasless airdrop",
-    "solana token launch",
-    "nft airdrop",
-    "decentralized distribution",
-    "solana-program-library",
-    "anchor program",
-    "spl token",
-    "solana crypto",
-    "airdrop automation",
-    "web3 rewards",
-    "solana developer tools"
-  ],
-  "author": "MBK Official",
-  "license": "MIT",
-  "devDependencies": {
-    "@solana-program/token": "^0.9.0",
-    "@solana/kit": "^5.0.0",
-    "@types/node": "^22.15.29",
-    "merkletreejs": "^0.6.0",
-    "tsup": "^8.5.0",
-    "typedoc": "^0.28.5",
-    "typescript": "^5.8.3"
-  },
-  "peerDependencies": {
-    "@solana-program/token": "^0.9.0",
-    "@solana/kit": "^5.0.0",
-    "merkletreejs": "^0.6.0"
-  }
-}
+{
+  "name": "@dropsy/airdrop",
+  "type": "module",
+  "version": "0.3.0",
+  "description": "Dropsy - The Token Distribution Layer on SOLANA - A powerful and flexible airdrop protocol for seamless token distribution on the Solana blockchain.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://docs.dropsy.org/",
+  "repository": {
+    "url": "https://github.com/scoolmb/dropsy-airdrop"
+  },
+  "scripts": {
+    "test": "ts-node index.ts",
+    "build": "tsup"
+  },
+  "keywords": [
+    "solana",
+    "solana airdrop",
+    "web3",
+    "create airdrop",
+    "solana web3",
+    "dropsy",
+    "solana devtools",
+    "token distribution",
+    "airdrop protocol",
+    "solana sdk",
+    "merkle airdrop",
+    "gasless airdrop",
+    "solana token launch",
+    "nft airdrop",
+    "decentralized distribution",
+    "solana-program-library",
+    "anchor program",
+    "spl token",
+    "solana crypto",
+    "airdrop automation",
+    "web3 rewards",
+    "solana developer tools",
+    "solana token distribution",
+    "solana airdrop protocol",
+    "solana token airdrop",
+    "solana token distribution protocol",
+    "solana token launchpad",
+    "solana token marketing",
+    "solana token rewards",
+    "solana token giveaway",
+    "solana token raffles"
+  ],
+  "author": "MBK Official",
+  "license": "MIT",
+  "peerDependencies": {
+    "@solana-program/token": "^0.13.0",
+    "@solana/kit": "^6.8.0",
+    "merkletreejs": "^0.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}

package/readme.md

@@ -1,153 +1,60 @@
-# dropsy-airdrop beta
-
-[![npm version](https://img.shields.io/npm/v/@dropsy/airdrop.svg)](https://www.npmjs.com/package/@dropsy/airdrop)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Docs](https://img.shields.io/badge/docs-online-blue)](https://scoolmb.github.io/dropsy-airdrop/)
-
-A modern client SDK for interacting with the **Dropsy Airdrop Protocol** on Solana, built with:
-
-- ✅ TypeScript
-- ⚙️ [tsup](https://github.com/egoist/tsup) for fast bundling
-- 🔀 Dual CJS (`require`) and ESM (`import`) support
-- 📦 Auto-generated type declarations
-
-## 🚨 Important Notes
-
-⚠️ This SDK is in active development  
-⚠️ All program addresses are temporary  
-⚠️ Instruction formats may change without warning  
-⚠️ Devnet only - no mainnet support yet
-
-## 🛠 What's New ??
-
-New instructions :
-
-1 - delegate_airdrop
-This instruction allows a designated authority to manage airdrop allocations on behalf of the original distributor. It is particularly useful for delegating airdrop responsibilities to trusted parties or third-party services, enabling decentralized management of token distributions.
-
-2 - update_airdrop
-The update_airdrop instruction enables the modification of existing airdrop configurations. This includes updating the list of eligible recipients (via the Merkle root) and adjusting the timing (start/end dates).
-This provides flexibility for creating Quest-based airdrops on top of Snapshot-based airdrops, delegated by third parties such as Quest platforms or NFT platforms.
-
-update on airdrop Account :
-Airdrop = {
-discriminator: ReadonlyUint8Array;
-authority: Address;
-mint: Address;
-controller: Address;
-delegateAuthority: Address; // recently adedd
-merkleRoot: Array<number>;
-supply: bigint;
-startsAt: bigint;
-endsAt: bigint;
-bitmapCount: number;
-delegatePermissions: number; // recently adedd
-version: number;
-bump: number;
-};
-
-**📖 Interactive Documentation**  
-Full API docs with live examples
-
-**🧪 Testnet Sandbox**  
-Try before you integrate
-
-**🎮 CLI Interface**  
-Command-line airdrop management
-
-## 🔭 Current Status (v0.β)
-
-- **Network**: Devnet only
-- **Stability**: Experimental
-- **Program ID**: Subject to change
-- **Roadmap**: Mainnet launch
-
-> Full API documentation: [https://docs.dropsy.xyz/](https://docs.dropsy.xyz/)
-
-## Installation
-
-```bash
-npm install @dropsy/airdrop
-# or
-yarn add @dropsy/airdrop
-# or
-pnpm add @dropsy/airdrop
-```
-
-The @solana/kit is required if not already installed:
-
-# Using npm
-
-npm install @solana/kit
-
-# Using yarn
-
-yarn add @solana/kit
-
-## Examples
-
-Examples are available in the [examples](./examples) folder.  
-Feel free to explore, modify, and use them as a starting point for your own work.
-
-## Features
-
-🚀 Controller – The Heart of Your Airdrop Platform
-One of the most exciting parts of our protocol is the Controller.
-
-A Controller acts as the foundation for creating and managing airdrops. By initializing your own controller, you can build a fully self-managed airdrop platform — and alse earn protocol fees from all the airdrops created using it.
-
-What is a Controller?
-A Controller is a special on-chain account that:
-
-Registers ownership over a set of airdrops.
-
-Collects protocol-level fees.
-
-Allows anyone to create token airdrops under your control.
-
-Why Use a Controller?
-
-💸 Monetize: Earn fees from every airdrop created using your controller.
-
-🛠️ Customize: Tailor your airdrop platform around it.
-
-🌐 Permissionless: Anyone can initialize a controller and start building.
-
-How to Initialize a Controller :
-
-```bash
-import * as dropsy from "@dropsy/airdrop";
-
-// Create the instruction to initialize your controller
-const ix = await dropsy.getInitializeControllerInstructionAsync({
-authority: wallet, // the owner of the controller (the signer )
-feeLamports: BigInt(5000), // The fee lamports others will pay when c using your controller
-});
-```
-
-Get initialize airdrop instruction :
-
-```bash
-import * as dropsy from "@dropsy/airdrop";
-
-// Create the instruction to initialize your controller
-const ix = dropsy.getInitializeAirdropInstructionAsync({
-    authority: wallet,   // signer (airdrop creator)
-    mint: mint,       // token mint address
-    controller: controller,     // controller ( fee collector )
-    merkleRoot: merkleRootArray,    // merkle root as an array where all eligible wallets with amount
-    startsTime: null,  // BigInt(.....)   // time when the airdrop will start (default is now )
-    endTime: null,   // BigInt(.....)    // time when the airdrop will end (default is after 60 days  )
-});
-```
-
-checkout the init-airdrop.ts in the examples folder to discover how to create merkleRoot
-
-## 📚 Documentation
-
-Full API documentation is available at
-👉 [https://docs.dropsy.xyz/](https://docs.dropsy.xyz/)
-
-```
-
-```
+# dropsy-airdrop
+
+## What is Dropsy ?
+
+Dropsy Protocol is the token distribution layer for Solana, enabling creators, protocols, and teams to distribute tokens with zero friction.
+
+With Airdrop Master, teams can create their own airdrop systems, customize fee models, and even build entire token-distribution products on top of Dropsy.
+
+## What You Can Build ?
+
+- Airdrop launchpads
+- Claim portals
+- Community reward apps
+- Platform-level distribution tools (with your own fee model)
+- Growth, referral, or engagement incentive systems
+  **Dropsy** is built to unlock a wild range of Web3 opportunities, empowering teams to launch incentives, boost growth, and create meaningful reward experiences with ease.
+
+## 🚨 Important Notes
+
+⚠️ This SDK is in active development  
+⚠️ All program addresses are temporary  
+⚠️ Instruction formats may change without warning  
+⚠️ Devnet only - no mainnet support yet
+
+## 🔭 Current Status (v0.β)
+
+- **Network**: Devnet only
+- **Stability**: Experimental
+- **Program ID**: Subject to change
+
+> Full API documentation: [https://docs.dropsy.org/](https://docs.dropsy.org/)
+
+## Installation
+
+```bash
+npm install @dropsy/airdrop
+# or
+yarn add @dropsy/airdrop
+# or
+pnpm add @dropsy/airdrop
+```
+
+The @solana/kit and @solana-program/token are required if not already installed:
+
+# Using npm
+
+npm install @solana/kit @solana-program/token
+
+# Using yarn
+
+yarn add @solana/kit @solana-program/token
+
+## Examples
+
+**Examples** under update (coming soon)
+
+## 📚 Documentation
+
+Full documentation is available at
+👉 [https://docs.dropsy.org/](https://docs.dropsy.org/)

package/generate-md.js

@@ -1,71 +0,0 @@
-// generate-instruction-mdx.js
-const fs = require("fs");
-const path = require("path");
-
-const instructionsDir = path.join(__dirname, "src", "accounts");
-
-function toTitle(name) {
-  return name
-    .replace(/\.mdx$/, "")
-    .replace(/\.ts$/, "")
-    .replace(/([A-Z])/g, " $1")
-    .replace(/^./, (str) => str.toUpperCase())
-    .trim();
-}
-
-function createMDXTemplate(name) {
-  const title = toTitle(name);
-
-  return `---
-title: "${title}"
-sidebar_position: 1
----
-
-# ${title}
-
-This page documents the **\`${name.replace(
-    ".ts",
-    ""
-  )}\`** instruction of the Dropsy protocol.
-
-## Overview
-
-Describe what this instruction does.
-
-## Parameters
-
-(Add a list of parameters extracted from the TypeScript file.)
-
-## Example (TypeScript)
-
-\`\`\`ts
-import { ${name.replace(".ts", "")} } from "@dropsy/sdk";
-
-// Example usage:
-\`\`\`
-
-## On-Chain Accounts
-
-(Add the required accounts here.)
-
-## Events
-
-(Add emitted events if any.)
-`;
-}
-
-fs.readdirSync(instructionsDir).forEach((file) => {
-  if (!file.endsWith(".ts")) return;
-  if (file === "index.ts") return;
-
-  const mdxName = file.replace(".ts", ".mdx");
-  const mdxPath = path.join(instructionsDir, mdxName);
-
-  if (!fs.existsSync(mdxPath)) {
-    const content = createMDXTemplate(file);
-    fs.writeFileSync(mdxPath, content, "utf-8");
-    console.log("✅ Created:", mdxName);
-  } else {
-    console.log("⏩ Skipped (already exists):", mdxName);
-  }
-});