@solana/kit-plugin-airdrop 0.0.0 → 0.3.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Anza
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,58 @@
+# Kit Plugins ➤ Airdrop
+
+[![npm][npm-image]][npm-url]
+[![npm-downloads][npm-downloads-image]][npm-url]
+
+[npm-downloads-image]: https://img.shields.io/npm/dm/@solana/kit-plugin-airdrop.svg?style=flat
+[npm-image]: https://img.shields.io/npm/v/@solana/kit-plugin-airdrop.svg?style=flat&label=%40solana%2Fkit-plugin-airdrop
+[npm-url]: https://www.npmjs.com/package/@solana/kit-plugin-airdrop
+
+This package provides a plugin that adds an `airdrop` helper function to your Kit client.
+
+## Installation
+
+```sh
+pnpm install @solana/kit-plugin-airdrop
+```
+
+> [!NOTE]
+> This package is included in the main [`@solana/kit-plugins`](../kit-plugins) package.
+>
+> ```sh
+> pnpm install @solana/kit-plugins
+> ```
+
+## `airdrop` plugin
+
+The `airdrop` plugin provides an `airdrop` function that allows you to request SOL airdrops to a specified account.
+
+### Installation
+
+In order to use the `airdrop` plugin, the client must be configured with either an RPC plugin or a LiteSVM plugin. You will get a TypeScript error if neither is provided before using the `airdrop` plugin.
+
+#### Using an RPC
+
+```ts
+import { createEmptyClient } from '@solana/kit';
+import { airdrop, localhostRpc } from '@solana/kit-plugins';
+
+const client = createEmptyClient().use(localhostRpc()).use(airdrop());
+```
+
+Note that you will get a TypeScript error when using the `rpc` plugin with a mainnet URL such as `mainnet("https://api.mainnet-beta.solana.com")`, because airdrop RPC methods are not supported on mainnet.
+
+#### Using a LiteSVM instance
+
+```ts
+import { createEmptyClient } from '@solana/kit';
+import { airdrop, litesvm } from '@solana/kit-plugins';
+
+const client = createEmptyClient().use(litesvm()).use(airdrop());
+```
+
+### Features
+
+- `airdrop`: An asynchronous helper function that airdrops a specified amount of lamports to a given address.
+    ```ts
+    client.airdrop(address('HQVxiMVDoV9jzG4tpoxmDZsNfWvaHXm8DGGv93Gka75v'), lamports(1_000_000_000n));
+    ```

package/dist/index.browser.cjs

@@ -0,0 +1,32 @@
+'use strict';
+
+var kit = require('@solana/kit');
+
+// src/index.ts
+function airdrop() {
+  return (client) => {
+    if ("svm" in client) {
+      const airdrop3 = (address, amount) => {
+        client.svm.airdrop(address, amount);
+        return Promise.resolve();
+      };
+      return { ...client, airdrop: airdrop3 };
+    }
+    const airdropInternal = kit.airdropFactory({
+      rpc: client.rpc,
+      rpcSubscriptions: client.rpcSubscriptions
+    });
+    const airdrop2 = (address, amount, abortSignal) => airdropInternal({
+      abortSignal,
+      commitment: "confirmed",
+      lamports: amount,
+      recipientAddress: address
+    }).then(() => {
+    });
+    return { ...client, airdrop: airdrop2 };
+  };
+}
+
+exports.airdrop = airdrop;
+//# sourceMappingURL=index.browser.cjs.map
+//# sourceMappingURL=index.browser.cjs.map

package/dist/index.browser.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["airdrop","airdropFactory"],"mappings":";;;;;AA0DO,SAAS,OAAA,GAAU;AACtB,EAAA,OAAO,CAAsC,MAAA,KAAgD;AACzF,IAAA,IAAI,SAAS,MAAA,EAAQ;AACjB,MAAA,MAAMA,QAAAA,GAA2B,CAAC,OAAA,EAAS,MAAA,KAAW;AAClD,QAAA,MAAA,CAAO,GAAA,CAAI,OAAA,CAAQ,OAAA,EAAS,MAAM,CAAA;AAClC,QAAA,OAAO,QAAQ,OAAA,EAAQ;AAAA,MAC3B,CAAA;AACA,MAAA,OAAO,EAAE,GAAG,MAAA,EAAQ,OAAA,EAAAA,QAAAA,EAAQ;AAAA,IAChC;AACA,IAAA,MAAM,kBAAkBC,kBAAA,CAAe;AAAA,MACnC,KAAK,MAAA,CAAO,GAAA;AAAA,MACZ,kBAAkB,MAAA,CAAO;AAAA,KAC5B,CAAA;AACD,IAAA,MAAMD,QAAAA,GAA2B,CAAC,OAAA,EAAS,MAAA,EAAQ,gBAC/C,eAAA,CAAgB;AAAA,MACZ,WAAA;AAAA,MACA,UAAA,EAAY,WAAA;AAAA,MACZ,QAAA,EAAU,MAAA;AAAA,MACV,gBAAA,EAAkB;AAAA,KACrB,CAAA,CAAE,IAAA,CAAK,MAAM;AAAA,IAAC,CAAC,CAAA;AACpB,IAAA,OAAO,EAAE,GAAG,MAAA,EAAQ,OAAA,EAAAA,QAAAA,EAAQ;AAAA,EAChC,CAAA;AACJ","file":"index.browser.cjs","sourcesContent":["import { Address, airdropFactory, Lamports } from '@solana/kit';\n\ntype LiteSVMClient = {\n    svm: { airdrop: (address: Address, lamports: Lamports) => unknown };\n};\ntype RpcClient = {\n    rpc: Parameters<typeof airdropFactory>[0]['rpc'];\n    rpcSubscriptions: Parameters<typeof airdropFactory>[0]['rpcSubscriptions'];\n};\n\n/**\n * Function type for the `airdrop` method added to the client.\n *\n * @param address - The address to which the airdrop will be sent.\n * @param amount - The amount of lamports to airdrop.\n * @param abortSignal - Optional signal to abort the airdrop operation.\n */\nexport type AirdropFunction = (address: Address, amount: Lamports, abortSignal?: AbortSignal) => Promise<void>;\n\n/**\n * A plugin that adds an `airdrop` method to the client.\n *\n * This will use the LiteSVM's internal airdrop method if the\n * client has LiteSVM installed. Otherwise, it will rely on the\n * `Rpc` and `RpcSubscriptions` clients to perform the airdrop.\n *\n * @example\n * RPC-based airdrop.\n * ```ts\n * import { createEmptyClient } from '@solana/kit';\n * import { airdrop, localhostRpc } from '@solana/kit-plugins';\n *\n * // Install the airdrop plugin using a localhost RPC.\n * const client = createEmptyClient()\n *     .use(localhostRpc())\n *     .use(airdrop());\n *\n * // Use the airdrop method.\n * client.airdrop(myAddress, lamports(1_000_000_000n));\n * ```\n *\n * @example\n * LiteSVM-based airdrop.\n * ```ts\n * import { createEmptyClient } from '@solana/kit';\n * import { airdrop, litesvm } from '@solana/kit-plugins';\n *\n * // Install the airdrop plugin using a LiteSVM instance.\n * const client = createEmptyClient()\n *     .use(litesvm())\n *     .use(airdrop());\n *\n * // Use the airdrop method.\n * client.airdrop(myAddress, lamports(1_000_000_000n));\n * ```\n *\n * @see {@link AirdropFunction}\n */\nexport function airdrop() {\n    return <T extends LiteSVMClient | RpcClient>(client: T): T & { airdrop: AirdropFunction } => {\n        if ('svm' in client) {\n            const airdrop: AirdropFunction = (address, amount) => {\n                client.svm.airdrop(address, amount);\n                return Promise.resolve();\n            };\n            return { ...client, airdrop };\n        }\n        const airdropInternal = airdropFactory({\n            rpc: client.rpc,\n            rpcSubscriptions: client.rpcSubscriptions,\n        });\n        const airdrop: AirdropFunction = (address, amount, abortSignal) =>\n            airdropInternal({\n                abortSignal,\n                commitment: 'confirmed',\n                lamports: amount,\n                recipientAddress: address,\n            }).then(() => {});\n        return { ...client, airdrop };\n    };\n}\n"]}

package/dist/index.browser.mjs

@@ -0,0 +1,30 @@
+import { airdropFactory } from '@solana/kit';
+
+// src/index.ts
+function airdrop() {
+  return (client) => {
+    if ("svm" in client) {
+      const airdrop3 = (address, amount) => {
+        client.svm.airdrop(address, amount);
+        return Promise.resolve();
+      };
+      return { ...client, airdrop: airdrop3 };
+    }
+    const airdropInternal = airdropFactory({
+      rpc: client.rpc,
+      rpcSubscriptions: client.rpcSubscriptions
+    });
+    const airdrop2 = (address, amount, abortSignal) => airdropInternal({
+      abortSignal,
+      commitment: "confirmed",
+      lamports: amount,
+      recipientAddress: address
+    }).then(() => {
+    });
+    return { ...client, airdrop: airdrop2 };
+  };
+}
+
+export { airdrop };
+//# sourceMappingURL=index.browser.mjs.map
+//# sourceMappingURL=index.browser.mjs.map

package/dist/index.browser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["airdrop"],"mappings":";;;AA0DO,SAAS,OAAA,GAAU;AACtB,EAAA,OAAO,CAAsC,MAAA,KAAgD;AACzF,IAAA,IAAI,SAAS,MAAA,EAAQ;AACjB,MAAA,MAAMA,QAAAA,GAA2B,CAAC,OAAA,EAAS,MAAA,KAAW;AAClD,QAAA,MAAA,CAAO,GAAA,CAAI,OAAA,CAAQ,OAAA,EAAS,MAAM,CAAA;AAClC,QAAA,OAAO,QAAQ,OAAA,EAAQ;AAAA,MAC3B,CAAA;AACA,MAAA,OAAO,EAAE,GAAG,MAAA,EAAQ,OAAA,EAAAA,QAAAA,EAAQ;AAAA,IAChC;AACA,IAAA,MAAM,kBAAkB,cAAA,CAAe;AAAA,MACnC,KAAK,MAAA,CAAO,GAAA;AAAA,MACZ,kBAAkB,MAAA,CAAO;AAAA,KAC5B,CAAA;AACD,IAAA,MAAMA,QAAAA,GAA2B,CAAC,OAAA,EAAS,MAAA,EAAQ,gBAC/C,eAAA,CAAgB;AAAA,MACZ,WAAA;AAAA,MACA,UAAA,EAAY,WAAA;AAAA,MACZ,QAAA,EAAU,MAAA;AAAA,MACV,gBAAA,EAAkB;AAAA,KACrB,CAAA,CAAE,IAAA,CAAK,MAAM;AAAA,IAAC,CAAC,CAAA;AACpB,IAAA,OAAO,EAAE,GAAG,MAAA,EAAQ,OAAA,EAAAA,QAAAA,EAAQ;AAAA,EAChC,CAAA;AACJ","file":"index.browser.mjs","sourcesContent":["import { Address, airdropFactory, Lamports } from '@solana/kit';\n\ntype LiteSVMClient = {\n    svm: { airdrop: (address: Address, lamports: Lamports) => unknown };\n};\ntype RpcClient = {\n    rpc: Parameters<typeof airdropFactory>[0]['rpc'];\n    rpcSubscriptions: Parameters<typeof airdropFactory>[0]['rpcSubscriptions'];\n};\n\n/**\n * Function type for the `airdrop` method added to the client.\n *\n * @param address - The address to which the airdrop will be sent.\n * @param amount - The amount of lamports to airdrop.\n * @param abortSignal - Optional signal to abort the airdrop operation.\n */\nexport type AirdropFunction = (address: Address, amount: Lamports, abortSignal?: AbortSignal) => Promise<void>;\n\n/**\n * A plugin that adds an `airdrop` method to the client.\n *\n * This will use the LiteSVM's internal airdrop method if the\n * client has LiteSVM installed. Otherwise, it will rely on the\n * `Rpc` and `RpcSubscriptions` clients to perform the airdrop.\n *\n * @example\n * RPC-based airdrop.\n * ```ts\n * import { createEmptyClient } from '@solana/kit';\n * import { airdrop, localhostRpc } from '@solana/kit-plugins';\n *\n * // Install the airdrop plugin using a localhost RPC.\n * const client = createEmptyClient()\n *     .use(localhostRpc())\n *     .use(airdrop());\n *\n * // Use the airdrop method.\n * client.airdrop(myAddress, lamports(1_000_000_000n));\n * ```\n *\n * @example\n * LiteSVM-based airdrop.\n * ```ts\n * import { createEmptyClient } from '@solana/kit';\n * import { airdrop, litesvm } from '@solana/kit-plugins';\n *\n * // Install the airdrop plugin using a LiteSVM instance.\n * const client = createEmptyClient()\n *     .use(litesvm())\n *     .use(airdrop());\n *\n * // Use the airdrop method.\n * client.airdrop(myAddress, lamports(1_000_000_000n));\n * ```\n *\n * @see {@link AirdropFunction}\n */\nexport function airdrop() {\n    return <T extends LiteSVMClient | RpcClient>(client: T): T & { airdrop: AirdropFunction } => {\n        if ('svm' in client) {\n            const airdrop: AirdropFunction = (address, amount) => {\n                client.svm.airdrop(address, amount);\n                return Promise.resolve();\n            };\n            return { ...client, airdrop };\n        }\n        const airdropInternal = airdropFactory({\n            rpc: client.rpc,\n            rpcSubscriptions: client.rpcSubscriptions,\n        });\n        const airdrop: AirdropFunction = (address, amount, abortSignal) =>\n            airdropInternal({\n                abortSignal,\n                commitment: 'confirmed',\n                lamports: amount,\n                recipientAddress: address,\n            }).then(() => {});\n        return { ...client, airdrop };\n    };\n}\n"]}

package/dist/index.node.cjs

@@ -0,0 +1,32 @@
+'use strict';
+
+var kit = require('@solana/kit');
+
+// src/index.ts
+function airdrop() {
+  return (client) => {
+    if ("svm" in client) {
+      const airdrop3 = (address, amount) => {
+        client.svm.airdrop(address, amount);
+        return Promise.resolve();
+      };
+      return { ...client, airdrop: airdrop3 };
+    }
+    const airdropInternal = kit.airdropFactory({
+      rpc: client.rpc,
+      rpcSubscriptions: client.rpcSubscriptions
+    });
+    const airdrop2 = (address, amount, abortSignal) => airdropInternal({
+      abortSignal,
+      commitment: "confirmed",
+      lamports: amount,
+      recipientAddress: address
+    }).then(() => {
+    });
+    return { ...client, airdrop: airdrop2 };
+  };
+}
+
+exports.airdrop = airdrop;
+//# sourceMappingURL=index.node.cjs.map
+//# sourceMappingURL=index.node.cjs.map

package/dist/index.node.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["airdrop","airdropFactory"],"mappings":";;;;;AA0DO,SAAS,OAAA,GAAU;AACtB,EAAA,OAAO,CAAsC,MAAA,KAAgD;AACzF,IAAA,IAAI,SAAS,MAAA,EAAQ;AACjB,MAAA,MAAMA,QAAAA,GAA2B,CAAC,OAAA,EAAS,MAAA,KAAW;AAClD,QAAA,MAAA,CAAO,GAAA,CAAI,OAAA,CAAQ,OAAA,EAAS,MAAM,CAAA;AAClC,QAAA,OAAO,QAAQ,OAAA,EAAQ;AAAA,MAC3B,CAAA;AACA,MAAA,OAAO,EAAE,GAAG,MAAA,EAAQ,OAAA,EAAAA,QAAAA,EAAQ;AAAA,IAChC;AACA,IAAA,MAAM,kBAAkBC,kBAAA,CAAe;AAAA,MACnC,KAAK,MAAA,CAAO,GAAA;AAAA,MACZ,kBAAkB,MAAA,CAAO;AAAA,KAC5B,CAAA;AACD,IAAA,MAAMD,QAAAA,GAA2B,CAAC,OAAA,EAAS,MAAA,EAAQ,gBAC/C,eAAA,CAAgB;AAAA,MACZ,WAAA;AAAA,MACA,UAAA,EAAY,WAAA;AAAA,MACZ,QAAA,EAAU,MAAA;AAAA,MACV,gBAAA,EAAkB;AAAA,KACrB,CAAA,CAAE,IAAA,CAAK,MAAM;AAAA,IAAC,CAAC,CAAA;AACpB,IAAA,OAAO,EAAE,GAAG,MAAA,EAAQ,OAAA,EAAAA,QAAAA,EAAQ;AAAA,EAChC,CAAA;AACJ","file":"index.node.cjs","sourcesContent":["import { Address, airdropFactory, Lamports } from '@solana/kit';\n\ntype LiteSVMClient = {\n    svm: { airdrop: (address: Address, lamports: Lamports) => unknown };\n};\ntype RpcClient = {\n    rpc: Parameters<typeof airdropFactory>[0]['rpc'];\n    rpcSubscriptions: Parameters<typeof airdropFactory>[0]['rpcSubscriptions'];\n};\n\n/**\n * Function type for the `airdrop` method added to the client.\n *\n * @param address - The address to which the airdrop will be sent.\n * @param amount - The amount of lamports to airdrop.\n * @param abortSignal - Optional signal to abort the airdrop operation.\n */\nexport type AirdropFunction = (address: Address, amount: Lamports, abortSignal?: AbortSignal) => Promise<void>;\n\n/**\n * A plugin that adds an `airdrop` method to the client.\n *\n * This will use the LiteSVM's internal airdrop method if the\n * client has LiteSVM installed. Otherwise, it will rely on the\n * `Rpc` and `RpcSubscriptions` clients to perform the airdrop.\n *\n * @example\n * RPC-based airdrop.\n * ```ts\n * import { createEmptyClient } from '@solana/kit';\n * import { airdrop, localhostRpc } from '@solana/kit-plugins';\n *\n * // Install the airdrop plugin using a localhost RPC.\n * const client = createEmptyClient()\n *     .use(localhostRpc())\n *     .use(airdrop());\n *\n * // Use the airdrop method.\n * client.airdrop(myAddress, lamports(1_000_000_000n));\n * ```\n *\n * @example\n * LiteSVM-based airdrop.\n * ```ts\n * import { createEmptyClient } from '@solana/kit';\n * import { airdrop, litesvm } from '@solana/kit-plugins';\n *\n * // Install the airdrop plugin using a LiteSVM instance.\n * const client = createEmptyClient()\n *     .use(litesvm())\n *     .use(airdrop());\n *\n * // Use the airdrop method.\n * client.airdrop(myAddress, lamports(1_000_000_000n));\n * ```\n *\n * @see {@link AirdropFunction}\n */\nexport function airdrop() {\n    return <T extends LiteSVMClient | RpcClient>(client: T): T & { airdrop: AirdropFunction } => {\n        if ('svm' in client) {\n            const airdrop: AirdropFunction = (address, amount) => {\n                client.svm.airdrop(address, amount);\n                return Promise.resolve();\n            };\n            return { ...client, airdrop };\n        }\n        const airdropInternal = airdropFactory({\n            rpc: client.rpc,\n            rpcSubscriptions: client.rpcSubscriptions,\n        });\n        const airdrop: AirdropFunction = (address, amount, abortSignal) =>\n            airdropInternal({\n                abortSignal,\n                commitment: 'confirmed',\n                lamports: amount,\n                recipientAddress: address,\n            }).then(() => {});\n        return { ...client, airdrop };\n    };\n}\n"]}

package/dist/index.node.mjs

@@ -0,0 +1,30 @@
+import { airdropFactory } from '@solana/kit';
+
+// src/index.ts
+function airdrop() {
+  return (client) => {
+    if ("svm" in client) {
+      const airdrop3 = (address, amount) => {
+        client.svm.airdrop(address, amount);
+        return Promise.resolve();
+      };
+      return { ...client, airdrop: airdrop3 };
+    }
+    const airdropInternal = airdropFactory({
+      rpc: client.rpc,
+      rpcSubscriptions: client.rpcSubscriptions
+    });
+    const airdrop2 = (address, amount, abortSignal) => airdropInternal({
+      abortSignal,
+      commitment: "confirmed",
+      lamports: amount,
+      recipientAddress: address
+    }).then(() => {
+    });
+    return { ...client, airdrop: airdrop2 };
+  };
+}
+
+export { airdrop };
+//# sourceMappingURL=index.node.mjs.map
+//# sourceMappingURL=index.node.mjs.map

package/dist/index.node.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["airdrop"],"mappings":";;;AA0DO,SAAS,OAAA,GAAU;AACtB,EAAA,OAAO,CAAsC,MAAA,KAAgD;AACzF,IAAA,IAAI,SAAS,MAAA,EAAQ;AACjB,MAAA,MAAMA,QAAAA,GAA2B,CAAC,OAAA,EAAS,MAAA,KAAW;AAClD,QAAA,MAAA,CAAO,GAAA,CAAI,OAAA,CAAQ,OAAA,EAAS,MAAM,CAAA;AAClC,QAAA,OAAO,QAAQ,OAAA,EAAQ;AAAA,MAC3B,CAAA;AACA,MAAA,OAAO,EAAE,GAAG,MAAA,EAAQ,OAAA,EAAAA,QAAAA,EAAQ;AAAA,IAChC;AACA,IAAA,MAAM,kBAAkB,cAAA,CAAe;AAAA,MACnC,KAAK,MAAA,CAAO,GAAA;AAAA,MACZ,kBAAkB,MAAA,CAAO;AAAA,KAC5B,CAAA;AACD,IAAA,MAAMA,QAAAA,GAA2B,CAAC,OAAA,EAAS,MAAA,EAAQ,gBAC/C,eAAA,CAAgB;AAAA,MACZ,WAAA;AAAA,MACA,UAAA,EAAY,WAAA;AAAA,MACZ,QAAA,EAAU,MAAA;AAAA,MACV,gBAAA,EAAkB;AAAA,KACrB,CAAA,CAAE,IAAA,CAAK,MAAM;AAAA,IAAC,CAAC,CAAA;AACpB,IAAA,OAAO,EAAE,GAAG,MAAA,EAAQ,OAAA,EAAAA,QAAAA,EAAQ;AAAA,EAChC,CAAA;AACJ","file":"index.node.mjs","sourcesContent":["import { Address, airdropFactory, Lamports } from '@solana/kit';\n\ntype LiteSVMClient = {\n    svm: { airdrop: (address: Address, lamports: Lamports) => unknown };\n};\ntype RpcClient = {\n    rpc: Parameters<typeof airdropFactory>[0]['rpc'];\n    rpcSubscriptions: Parameters<typeof airdropFactory>[0]['rpcSubscriptions'];\n};\n\n/**\n * Function type for the `airdrop` method added to the client.\n *\n * @param address - The address to which the airdrop will be sent.\n * @param amount - The amount of lamports to airdrop.\n * @param abortSignal - Optional signal to abort the airdrop operation.\n */\nexport type AirdropFunction = (address: Address, amount: Lamports, abortSignal?: AbortSignal) => Promise<void>;\n\n/**\n * A plugin that adds an `airdrop` method to the client.\n *\n * This will use the LiteSVM's internal airdrop method if the\n * client has LiteSVM installed. Otherwise, it will rely on the\n * `Rpc` and `RpcSubscriptions` clients to perform the airdrop.\n *\n * @example\n * RPC-based airdrop.\n * ```ts\n * import { createEmptyClient } from '@solana/kit';\n * import { airdrop, localhostRpc } from '@solana/kit-plugins';\n *\n * // Install the airdrop plugin using a localhost RPC.\n * const client = createEmptyClient()\n *     .use(localhostRpc())\n *     .use(airdrop());\n *\n * // Use the airdrop method.\n * client.airdrop(myAddress, lamports(1_000_000_000n));\n * ```\n *\n * @example\n * LiteSVM-based airdrop.\n * ```ts\n * import { createEmptyClient } from '@solana/kit';\n * import { airdrop, litesvm } from '@solana/kit-plugins';\n *\n * // Install the airdrop plugin using a LiteSVM instance.\n * const client = createEmptyClient()\n *     .use(litesvm())\n *     .use(airdrop());\n *\n * // Use the airdrop method.\n * client.airdrop(myAddress, lamports(1_000_000_000n));\n * ```\n *\n * @see {@link AirdropFunction}\n */\nexport function airdrop() {\n    return <T extends LiteSVMClient | RpcClient>(client: T): T & { airdrop: AirdropFunction } => {\n        if ('svm' in client) {\n            const airdrop: AirdropFunction = (address, amount) => {\n                client.svm.airdrop(address, amount);\n                return Promise.resolve();\n            };\n            return { ...client, airdrop };\n        }\n        const airdropInternal = airdropFactory({\n            rpc: client.rpc,\n            rpcSubscriptions: client.rpcSubscriptions,\n        });\n        const airdrop: AirdropFunction = (address, amount, abortSignal) =>\n            airdropInternal({\n                abortSignal,\n                commitment: 'confirmed',\n                lamports: amount,\n                recipientAddress: address,\n            }).then(() => {});\n        return { ...client, airdrop };\n    };\n}\n"]}

package/dist/index.react-native.mjs

@@ -0,0 +1,30 @@
+import { airdropFactory } from '@solana/kit';
+
+// src/index.ts
+function airdrop() {
+  return (client) => {
+    if ("svm" in client) {
+      const airdrop3 = (address, amount) => {
+        client.svm.airdrop(address, amount);
+        return Promise.resolve();
+      };
+      return { ...client, airdrop: airdrop3 };
+    }
+    const airdropInternal = airdropFactory({
+      rpc: client.rpc,
+      rpcSubscriptions: client.rpcSubscriptions
+    });
+    const airdrop2 = (address, amount, abortSignal) => airdropInternal({
+      abortSignal,
+      commitment: "confirmed",
+      lamports: amount,
+      recipientAddress: address
+    }).then(() => {
+    });
+    return { ...client, airdrop: airdrop2 };
+  };
+}
+
+export { airdrop };
+//# sourceMappingURL=index.react-native.mjs.map
+//# sourceMappingURL=index.react-native.mjs.map

package/dist/index.react-native.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["airdrop"],"mappings":";;;AA0DO,SAAS,OAAA,GAAU;AACtB,EAAA,OAAO,CAAsC,MAAA,KAAgD;AACzF,IAAA,IAAI,SAAS,MAAA,EAAQ;AACjB,MAAA,MAAMA,QAAAA,GAA2B,CAAC,OAAA,EAAS,MAAA,KAAW;AAClD,QAAA,MAAA,CAAO,GAAA,CAAI,OAAA,CAAQ,OAAA,EAAS,MAAM,CAAA;AAClC,QAAA,OAAO,QAAQ,OAAA,EAAQ;AAAA,MAC3B,CAAA;AACA,MAAA,OAAO,EAAE,GAAG,MAAA,EAAQ,OAAA,EAAAA,QAAAA,EAAQ;AAAA,IAChC;AACA,IAAA,MAAM,kBAAkB,cAAA,CAAe;AAAA,MACnC,KAAK,MAAA,CAAO,GAAA;AAAA,MACZ,kBAAkB,MAAA,CAAO;AAAA,KAC5B,CAAA;AACD,IAAA,MAAMA,QAAAA,GAA2B,CAAC,OAAA,EAAS,MAAA,EAAQ,gBAC/C,eAAA,CAAgB;AAAA,MACZ,WAAA;AAAA,MACA,UAAA,EAAY,WAAA;AAAA,MACZ,QAAA,EAAU,MAAA;AAAA,MACV,gBAAA,EAAkB;AAAA,KACrB,CAAA,CAAE,IAAA,CAAK,MAAM;AAAA,IAAC,CAAC,CAAA;AACpB,IAAA,OAAO,EAAE,GAAG,MAAA,EAAQ,OAAA,EAAAA,QAAAA,EAAQ;AAAA,EAChC,CAAA;AACJ","file":"index.react-native.mjs","sourcesContent":["import { Address, airdropFactory, Lamports } from '@solana/kit';\n\ntype LiteSVMClient = {\n    svm: { airdrop: (address: Address, lamports: Lamports) => unknown };\n};\ntype RpcClient = {\n    rpc: Parameters<typeof airdropFactory>[0]['rpc'];\n    rpcSubscriptions: Parameters<typeof airdropFactory>[0]['rpcSubscriptions'];\n};\n\n/**\n * Function type for the `airdrop` method added to the client.\n *\n * @param address - The address to which the airdrop will be sent.\n * @param amount - The amount of lamports to airdrop.\n * @param abortSignal - Optional signal to abort the airdrop operation.\n */\nexport type AirdropFunction = (address: Address, amount: Lamports, abortSignal?: AbortSignal) => Promise<void>;\n\n/**\n * A plugin that adds an `airdrop` method to the client.\n *\n * This will use the LiteSVM's internal airdrop method if the\n * client has LiteSVM installed. Otherwise, it will rely on the\n * `Rpc` and `RpcSubscriptions` clients to perform the airdrop.\n *\n * @example\n * RPC-based airdrop.\n * ```ts\n * import { createEmptyClient } from '@solana/kit';\n * import { airdrop, localhostRpc } from '@solana/kit-plugins';\n *\n * // Install the airdrop plugin using a localhost RPC.\n * const client = createEmptyClient()\n *     .use(localhostRpc())\n *     .use(airdrop());\n *\n * // Use the airdrop method.\n * client.airdrop(myAddress, lamports(1_000_000_000n));\n * ```\n *\n * @example\n * LiteSVM-based airdrop.\n * ```ts\n * import { createEmptyClient } from '@solana/kit';\n * import { airdrop, litesvm } from '@solana/kit-plugins';\n *\n * // Install the airdrop plugin using a LiteSVM instance.\n * const client = createEmptyClient()\n *     .use(litesvm())\n *     .use(airdrop());\n *\n * // Use the airdrop method.\n * client.airdrop(myAddress, lamports(1_000_000_000n));\n * ```\n *\n * @see {@link AirdropFunction}\n */\nexport function airdrop() {\n    return <T extends LiteSVMClient | RpcClient>(client: T): T & { airdrop: AirdropFunction } => {\n        if ('svm' in client) {\n            const airdrop: AirdropFunction = (address, amount) => {\n                client.svm.airdrop(address, amount);\n                return Promise.resolve();\n            };\n            return { ...client, airdrop };\n        }\n        const airdropInternal = airdropFactory({\n            rpc: client.rpc,\n            rpcSubscriptions: client.rpcSubscriptions,\n        });\n        const airdrop: AirdropFunction = (address, amount, abortSignal) =>\n            airdropInternal({\n                abortSignal,\n                commitment: 'confirmed',\n                lamports: amount,\n                recipientAddress: address,\n            }).then(() => {});\n        return { ...client, airdrop };\n    };\n}\n"]}

package/dist/types/index.d.ts

@@ -0,0 +1,62 @@
+import { Address, airdropFactory, Lamports } from '@solana/kit';
+type LiteSVMClient = {
+    svm: {
+        airdrop: (address: Address, lamports: Lamports) => unknown;
+    };
+};
+type RpcClient = {
+    rpc: Parameters<typeof airdropFactory>[0]['rpc'];
+    rpcSubscriptions: Parameters<typeof airdropFactory>[0]['rpcSubscriptions'];
+};
+/**
+ * Function type for the `airdrop` method added to the client.
+ *
+ * @param address - The address to which the airdrop will be sent.
+ * @param amount - The amount of lamports to airdrop.
+ * @param abortSignal - Optional signal to abort the airdrop operation.
+ */
+export type AirdropFunction = (address: Address, amount: Lamports, abortSignal?: AbortSignal) => Promise<void>;
+/**
+ * A plugin that adds an `airdrop` method to the client.
+ *
+ * This will use the LiteSVM's internal airdrop method if the
+ * client has LiteSVM installed. Otherwise, it will rely on the
+ * `Rpc` and `RpcSubscriptions` clients to perform the airdrop.
+ *
+ * @example
+ * RPC-based airdrop.
+ * ```ts
+ * import { createEmptyClient } from '@solana/kit';
+ * import { airdrop, localhostRpc } from '@solana/kit-plugins';
+ *
+ * // Install the airdrop plugin using a localhost RPC.
+ * const client = createEmptyClient()
+ *     .use(localhostRpc())
+ *     .use(airdrop());
+ *
+ * // Use the airdrop method.
+ * client.airdrop(myAddress, lamports(1_000_000_000n));
+ * ```
+ *
+ * @example
+ * LiteSVM-based airdrop.
+ * ```ts
+ * import { createEmptyClient } from '@solana/kit';
+ * import { airdrop, litesvm } from '@solana/kit-plugins';
+ *
+ * // Install the airdrop plugin using a LiteSVM instance.
+ * const client = createEmptyClient()
+ *     .use(litesvm())
+ *     .use(airdrop());
+ *
+ * // Use the airdrop method.
+ * client.airdrop(myAddress, lamports(1_000_000_000n));
+ * ```
+ *
+ * @see {@link AirdropFunction}
+ */
+export declare function airdrop(): <T extends LiteSVMClient | RpcClient>(client: T) => T & {
+    airdrop: AirdropFunction;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEhE,KAAK,aAAa,GAAG;IACjB,GAAG,EAAE;QAAE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAA;KAAE,CAAC;CACvE,CAAC;AACF,KAAK,SAAS,GAAG;IACb,GAAG,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACjD,gBAAgB,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;CAC9E,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE/G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,OAAO,KACX,CAAC,SAAS,aAAa,GAAG,SAAS,EAAE,QAAQ,CAAC,KAAG,CAAC,GAAG;IAAE,OAAO,EAAE,eAAe,CAAA;CAAE,CAqB5F"}

package/package.json

@@ -1,14 +1,66 @@
 {
   "name": "@solana/kit-plugin-airdrop",
-  "version": "0.0.0",
-  "description": "",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "scripts": {
-    "build": "tsc",
-    "test": "echo \"Error: no test specified\" && exit 1"
+  "version": "0.3.0",
+  "description": "Airdrop helpers for Kit clients",
+  "exports": {
+    "types": "./dist/types/index.d.ts",
+    "react-native": "./dist/index.react-native.mjs",
+    "browser": {
+      "import": "./dist/index.browser.mjs",
+      "require": "./dist/index.browser.cjs"
+    },
+    "node": {
+      "import": "./dist/index.node.mjs",
+      "require": "./dist/index.node.cjs"
+    }
+  },
+  "browser": {
+    "./dist/index.node.cjs": "./dist/index.browser.cjs",
+    "./dist/index.node.mjs": "./dist/index.browser.mjs"
+  },
+  "main": "./dist/index.node.cjs",
+  "module": "./dist/index.node.mjs",
+  "react-native": "./dist/index.react-native.mjs",
+  "types": "./dist/types/index.d.ts",
+  "type": "commonjs",
+  "files": [
+    "./dist/types",
+    "./dist/index.*"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "solana",
+    "kit",
+    "plugin",
+    "airdrop"
+  ],
+  "peerDependencies": {
+    "@solana/kit": "^6.0.0"
+  },
+  "devDependencies": {
+    "@solana/kit-plugin-litesvm": "0.3.0",
+    "@solana/kit-plugin-rpc": "0.3.0"
   },
-  "keywords": [],
-  "author": "",
-  "license": "Apache-2.0"
-}
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/anza-xyz/kit-plugins"
+  },
+  "bugs": {
+    "url": "http://github.com/anza-xyz/kit-plugins/issues"
+  },
+  "browserslist": [
+    "supports bigint and not dead",
+    "maintained node versions"
+  ],
+  "scripts": {
+    "build": "rimraf dist && tsup && tsc -p ./tsconfig.declarations.json",
+    "dev": "vitest --project node",
+    "lint": "eslint . && prettier --check .",
+    "lint:fix": "eslint --fix . && prettier --write .",
+    "test": "pnpm test:types && pnpm test:treeshakability && pnpm test:unit",
+    "test:treeshakability": "for file in dist/index.*.mjs; do agadoo $file; done",
+    "test:types": "tsc --noEmit",
+    "test:unit": "vitest run"
+  }
+}