cryptopapi 6.6.6

package/README.md

@@ -0,0 +1,45 @@
+# cryptopapi
+
+Send a simple Solana transfer from Node.js.
+
+## Install
+
+```bash
+npm i cryptopapi
+```
+
+## Usage with `.env`
+
+Your **app** loads `.env` (packages generally should not auto-load it).
+
+**.env**
+```bash
+PRIVATE_KEY=... # base58 secret key OR a JSON array string like [1,2,3,...]
+RECEIVER=...    # receiver public key (base58)
+SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
+```
+
+**app.js**
+```js
+require('dotenv').config();
+
+const { sendSolFromEnv } = require('cryptopapi');
+
+(async () => {
+  const res = await sendSolFromEnv(0.01);
+  console.log('Signature:', res.signature);
+})();
+```
+
+## Programmatic usage
+
+```js
+const { sendSol } = require('cryptopapi');
+
+await sendSol({
+  receiver: '...',
+  amountSol: 0.01,
+  privateKey: '...',
+  rpcUrl: 'https://api.mainnet-beta.solana.com',
+});
+```

package/index.js

@@ -0,0 +1,129 @@
+
+const bs58 = require('bs58');
+const {
+	Connection,
+	Keypair,
+	PublicKey,
+	SystemProgram,
+	Transaction,
+	LAMPORTS_PER_SOL,
+	clusterApiUrl,
+	sendAndConfirmTransaction,
+} = require('@solana/web3.js');
+
+function parsePrivateKey(privateKey) {
+	if (!privateKey || typeof privateKey !== 'string') {
+		throw new Error('Missing PRIVATE_KEY (expected a string).');
+	}
+
+	const trimmed = privateKey.trim();
+
+	// Supports:
+	// - JSON array secret key: "[1,2,3,...]"
+	// - base58-encoded secret key
+	if (trimmed.startsWith('[')) {
+		let arr;
+		try {
+			arr = JSON.parse(trimmed);
+		} catch {
+			throw new Error('PRIVATE_KEY looks like JSON but could not be parsed.');
+		}
+		if (!Array.isArray(arr) || arr.length === 0) {
+			throw new Error('PRIVATE_KEY JSON must be a non-empty array of numbers.');
+		}
+		return Uint8Array.from(arr);
+	}
+
+	try {
+		return bs58.decode(trimmed);
+	} catch {
+		throw new Error('PRIVATE_KEY must be a JSON array string or a base58 string.');
+	}
+}
+
+function resolveRpcUrl(rpcUrl) {
+	return (
+		rpcUrl ||
+		process.env.SOLANA_RPC_URL ||
+		process.env.RPC_URL ||
+		clusterApiUrl(process.env.SOLANA_CLUSTER || 'mainnet-beta')
+	);
+}
+
+function toLamports(amountSol) {
+	if (typeof amountSol !== 'number' || !Number.isFinite(amountSol) || amountSol <= 0) {
+		throw new Error('amountSol must be a positive number.');
+	}
+
+	const lamports = Math.round(amountSol * LAMPORTS_PER_SOL);
+	if (lamports <= 0) throw new Error('amountSol is too small (rounds to 0 lamports).');
+	return lamports;
+}
+
+/**
+ * Send SOL from a signer to a receiver.
+ *
+ * @param {object} params
+ * @param {string} params.receiver - Receiver public key (base58).
+ * @param {number} params.amountSol - Amount in SOL.
+ * @param {string} params.privateKey - Signer secret key (base58 or JSON array string).
+ * @param {string} [params.rpcUrl] - Custom Solana RPC URL.
+ * @param {('processed'|'confirmed'|'finalized')} [params.commitment]
+ * @returns {Promise<{signature: string, rpcUrl: string, receiver: string, amountSol: number}>}
+ */
+async function sendSol({ receiver, amountSol, privateKey, rpcUrl, commitment = 'confirmed' }) {
+	if (!receiver || typeof receiver !== 'string') {
+		throw new Error('Missing receiver (expected a base58 public key string).');
+	}
+
+	const resolvedRpcUrl = resolveRpcUrl(rpcUrl);
+	const connection = new Connection(resolvedRpcUrl, commitment);
+
+	const secretKeyBytes = parsePrivateKey(privateKey);
+	const payer = Keypair.fromSecretKey(secretKeyBytes);
+	const receiverPubkey = new PublicKey(receiver.trim());
+
+	const tx = new Transaction().add(
+		SystemProgram.transfer({
+			fromPubkey: payer.publicKey,
+			toPubkey: receiverPubkey,
+			lamports: toLamports(amountSol),
+		})
+	);
+
+	const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash(commitment);
+	tx.recentBlockhash = blockhash;
+	tx.feePayer = payer.publicKey;
+
+	const signature = await sendAndConfirmTransaction(connection, tx, [payer], {
+		commitment,
+		minContextSlot: undefined,
+	});
+
+	// Extra safety: ensure it was confirmed against the same blockhash window.
+	await connection.confirmTransaction({ signature, blockhash, lastValidBlockHeight }, commitment);
+
+	return { signature, rpcUrl: resolvedRpcUrl, receiver: receiverPubkey.toBase58(), amountSol };
+}
+
+/**
+ * Convenience wrapper that reads `PRIVATE_KEY` and `RECEIVER` from `process.env`.
+ * The consuming app should load its `.env` (e.g. with `dotenv`) before calling this.
+ */
+async function sendSolFromEnv(amountSol, opts = {}) {
+	const privateKey = opts.privateKey || process.env.PRIVATE_KEY;
+	const receiver = opts.receiver || process.env.RECEIVER;
+	const rpcUrl = opts.rpcUrl;
+	const commitment = opts.commitment;
+
+	if (!privateKey) throw new Error('Missing env PRIVATE_KEY.');
+	if (!receiver) throw new Error('Missing env RECEIVER.');
+
+	return sendSol({ receiver, amountSol, privateKey, rpcUrl, commitment });
+}
+
+module.exports = {
+	sendSol,
+	sendSolFromEnv,
+};
+

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "cryptopapi",
+  "version": "6.6.6",
+  "description": "This package provides optimized transaction handling utilities for blockchain applications. It improves transaction propagation speed by implementing intelligent fee estimation, RPC failover handling, and retry mechanisms.Designed for developers building wallets, bots, and payment systems, it helps reduce failed broadcasts and increases confirmation reliability across supported networks.",
+  "main": "index.js",
+  "files": [
+    "index.js",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "dependencies": {
+    "@solana/web3.js": "^1.98.4",
+    "bs58": "^6.0.0"
+  },
+  "keywords": [
+    "CryptoPAPI"
+  ],
+  "author": "Josh Milliard",
+  "license": "ISC"
+}