apinow-sdk 0.1.0

package/README.md

@@ -0,0 +1,105 @@
+# ApiNow SDK
+
+The endpoint vending machine - SDK for interacting with ApiNow endpoints.
+
+## Installation
+
+```bash
+npm install apinow-sdk
+```
+
+## Quick Start
+
+```ts
+import apiNow from 'apinow-sdk';
+
+// One-shot purchase and response
+const response = await apiNow.infoBuyResponse(
+  'https://apinow.fun/api/endpoints/my-endpoint',
+  '0x123...private-key',
+  'https://eth-mainnet.g.alchemy.com/v2/YOUR-API-KEY'
+);
+```
+
+## API Reference
+
+### info(endpoint)
+Fetches endpoint metadata like required ETH amount and wallet address.
+
+```ts
+const info = await apiNow.info('https://apinow.fun/api/endpoints/my-endpoint');
+// Returns: { 
+//   requiredEth: "0.1",
+//   walletAddress: "0x123...", 
+//   httpMethod: "POST" 
+// }
+```
+
+### buy(walletAddress, amount, privateKey, rpcUrl)
+Sends an ETH transaction to purchase endpoint access.
+
+```ts
+const txHash = await apiNow.buy(
+  "0x123...wallet",  // Destination wallet
+  ethers.parseEther("0.1"), // Amount in ETH
+  "0x456...private-key", // Your private key
+  "https://eth-mainnet.g.alchemy.com/v2/YOUR-API-KEY" // RPC URL
+);
+```
+
+### txResponse(endpoint, txHash, options?)
+Gets the API response using your transaction hash.
+
+```ts
+const response = await apiNow.txResponse(
+  "https://apinow.fun/api/endpoints/my-endpoint",
+  "0x789...txhash",
+  {
+    method: "POST", // Optional, defaults to GET
+    data: { foo: "bar" } // Optional request body
+  }
+);
+```
+
+### infoBuyResponse(endpoint, privateKey, rpcUrl, options?)
+Combines all steps: fetches info, sends payment, and gets response.
+
+```ts
+// Complete example with all parameters
+const response = await apiNow.infoBuyResponse(
+  "https://apinow.fun/api/endpoints/my-endpoint",
+  "0x123...private-key",
+  "https://eth-mainnet.g.alchemy.com/v2/YOUR-API-KEY",
+  {
+    method: "POST", // Optional, defaults to endpoint's httpMethod
+    data: { // Optional request body
+      query: "example",
+      limit: 10
+    }
+  }
+);
+```
+
+## License
+
+MIT
+
+Copyright (c) 2024 Your Name
+
+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 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/dist/index.d.ts

@@ -0,0 +1,17 @@
+interface TxResponseOptions {
+    method?: string;
+    data?: any;
+}
+interface InfoResponse {
+    requiredEth: string;
+    walletAddress: string;
+    httpMethod: string;
+}
+declare class ApiNow {
+    info(endpoint: string): Promise<InfoResponse>;
+    buy(walletAddress: string, amount: bigint, pkey: string, rpc: string): Promise<string>;
+    txResponse(endpoint: string, txHash: string, opts?: TxResponseOptions): Promise<any>;
+    infoBuyResponse(endpoint: string, pkey: string, rpc: string, opts?: TxResponseOptions): Promise<any>;
+}
+declare const _default: ApiNow;
+export default _default;

package/dist/index.js

@@ -0,0 +1,87 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const ethers_1 = require("ethers");
+const node_fetch_1 = __importDefault(require("node-fetch"));
+class ApiNow {
+    async info(endpoint) {
+        if (!endpoint.startsWith('https://apinow.fun/api/endpoints/')) {
+            throw new Error('Invalid endpoint URL format');
+        }
+        console.log(`Fetching info from ${endpoint}`);
+        const response = await (0, node_fetch_1.default)(`${endpoint}`);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch endpoint info: ${response.status}`);
+        }
+        return response.json();
+    }
+    async buy(walletAddress, amount, pkey, rpc) {
+        if (!rpc || typeof rpc !== 'string') {
+            throw new Error('Invalid RPC URL');
+        }
+        if (!walletAddress || !ethers_1.ethers.isAddress(walletAddress)) {
+            throw new Error('Invalid wallet address');
+        }
+        const provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+        const wallet = new ethers_1.ethers.Wallet(pkey, provider);
+        try {
+            await provider.getNetwork();
+            const balance = await provider.getBalance(wallet.address);
+            console.log('Sender balance:', ethers_1.ethers.formatEther(balance), 'ETH');
+            const nonce = await provider.getTransactionCount(wallet.address, 'latest');
+            const gasLimit = wallet.address.toLowerCase() === walletAddress.toLowerCase()
+                ? 30000
+                : 21000;
+            const tx = await wallet.sendTransaction({
+                to: walletAddress,
+                value: amount,
+                type: 2,
+                maxFeePerGas: ethers_1.ethers.parseUnits('0.1', 'gwei'),
+                maxPriorityFeePerGas: ethers_1.ethers.parseUnits('0.1', 'gwei'),
+                gasLimit,
+                nonce
+            });
+            console.log('tx:', JSON.stringify(tx));
+            console.log('Transaction sent:', tx.hash);
+            return tx.hash;
+        }
+        catch (error) {
+            console.error('Detailed error:', error);
+            throw new Error(`Transaction failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async txResponse(endpoint, txHash, opts = {}) {
+        if (!endpoint.startsWith('https://apinow.fun/api/endpoints/')) {
+            throw new Error('Invalid endpoint URL format');
+        }
+        console.log('txResponse:', { endpoint, txHash, ...opts });
+        const options = {
+            method: opts.method || 'GET',
+            headers: {
+                'x-transaction-hash': txHash,
+                ...(opts.data && { 'Content-Type': 'application/json' })
+            },
+            ...(opts.data && { body: JSON.stringify(opts.data) })
+        };
+        const response = await (0, node_fetch_1.default)(endpoint, options);
+        if (!response.ok) {
+            throw new Error(`API request failed: ${response.status}`);
+        }
+        return response.json();
+    }
+    async infoBuyResponse(endpoint, pkey, rpc, opts = {}) {
+        const info = await this.info(endpoint);
+        const amount = ethers_1.ethers.parseEther(info.requiredEth);
+        const txHash = await this.buy(info.walletAddress, amount, pkey, rpc);
+        console.log('infoBuyResponse:', { endpoint, txHash, ...opts });
+        const response = await this.txResponse(endpoint, txHash, {
+            method: opts.method || info.httpMethod,
+            data: opts.data
+        });
+        console.log('response:', response);
+        return response;
+    }
+}
+exports.default = new ApiNow();

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "apinow-sdk",
+  "version": "0.1.0",
+  "description": "ApiNow SDK · The endpoint vending machine",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "api",
+    "ethereum",
+    "web3"
+  ],
+  "author": "Your Name",
+  "license": "MIT",
+  "dependencies": {
+    "ethers": "^6.13.5",
+    "node-fetch": "^3.3.2"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.11.24",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.3.3"
+  }
+}