{"_id":"@blockchainhq-xyz/n8n-nodes-solana-x402","_rev":"2-063a6a4581028a3116c748a8c54d143e","name":"@blockchainhq-xyz/n8n-nodes-solana-x402","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@blockchainhq-xyz/n8n-nodes-solana-x402","version":"1.0.0","keywords":["n8n-community-node-package","n8n","solana","x402","payment","http-402"],"author":{"name":"Mahima Thacker"},"license":"MIT","_id":"@blockchainhq-xyz/n8n-nodes-solana-x402@1.0.0","maintainers":[{"name":"blockchainhq-xyz","email":"gmblockchainhq@gmail.com"}],"homepage":"https://github.com/blockchain-hq/x402-n8n-mock-node","bugs":{"url":"https://github.com/blockchain-hq/x402-n8n-mock-node/issues"},"n8n":{"nodes":["dist/nodes/SolanaX402/SolanaX402.node.js"],"credentials":["dist/credentials/SolanaX402Api.credentials.js"],"n8nNodesApiVersion":1},"dist":{"shasum":"09d109311516dc3f462820d821e3b93e14f3b69c","tarball":"https://registry.npmjs.org/@blockchainhq-xyz/n8n-nodes-solana-x402/-/n8n-nodes-solana-x402-1.0.0.tgz","fileCount":8,"integrity":"sha512-zHBBSXcti9NIUhc5ZmUYMzJv4mlKsBoZQuqRwVym6kLzDcKyT3f0E7HeTZTTcC3woq0+DDEwdN7vPaImY4EpFg==","signatures":[{"sig":"MEUCIBmH8p/065B7TtvtyaVylUmw47PoLaVP+enuxdTfNh3LAiEAqoKq49i6s93E2p0WSxUkfbMxnpBbJE2uy8cOPEgM0Sw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16838},"main":"index.js","gitHead":"b3741af95b7ec359eb4cec97a7b5940951f87f89","scripts":{"dev":"tsc --watch","lint":"eslint nodes credentials package.json","test":"npx @n8n/scan-community-package n8n-nodes-solana-x402","build":"tsc && cp -r nodes/**/*.{json,svg} dist/nodes/","format":"prettier nodes credentials --write","lintfix":"eslint nodes credentials package.json --fix","prepublishOnly":"npm run build"},"_npmUser":{"name":"blockchainhq-xyz","email":"gmblockchainhq@gmail.com"},"repository":{"url":"git+https://github.com/blockchain-hq/x402-n8n-mock-node.git","type":"git"},"_npmVersion":"11.4.2","description":"n8n node for Solana x402 payment protocol - Return HTTP 402 Payment Required","directories":{},"_nodeVersion":"24.3.0","dependencies":{"x402-server-sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.9.3","@types/node":"^24.10.0","n8n-workflow":"*","@types/express":"^5.0.5"},"_npmOperationalInternal":{"tmp":"tmp/n8n-nodes-solana-x402_1.0.0_1762405551304_0.2304700400273143","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@blockchainhq-xyz/n8n-nodes-solana-x402","version":"1.0.1","description":"n8n node for Solana x402 payment protocol - Return HTTP 402 Payment Required","keywords":["n8n-community-node-package","n8n","solana","x402","payment","http-402"],"license":"MIT","homepage":"https://github.com/blockchain-hq/x402-n8n-mock-node","repository":{"type":"git","url":"git+https://github.com/blockchain-hq/x402-n8n-mock-node.git"},"author":{"name":"Mahima Thacker"},"main":"index.js","scripts":{"build":"tsc && cp nodes/SolanaX402/solana.svg dist/nodes/SolanaX402/ && cp nodes/SolanaX402/SolanaX402.node.json dist/nodes/SolanaX402/ 2>/dev/null || true","dev":"tsc --watch","format":"prettier nodes credentials --write","lint":"eslint nodes credentials package.json","lintfix":"eslint nodes credentials package.json --fix","prepublishOnly":"npm run build","test":"npx @n8n/scan-community-package n8n-nodes-solana-x402"},"n8n":{"n8nNodesApiVersion":1,"credentials":["dist/credentials/SolanaX402Api.credentials.js"],"nodes":["dist/nodes/SolanaX402/SolanaX402.node.js"]},"devDependencies":{"@types/express":"^5.0.5","@types/node":"^24.10.0","n8n-workflow":"*","ts-node":"^10.9.2","typescript":"^5.9.3"},"dependencies":{"x402-server-sdk":"^1.0.0"},"_id":"@blockchainhq-xyz/n8n-nodes-solana-x402@1.0.1","gitHead":"da9a2c4a8f0c55e88e5e19fbf0e20513b00daa33","bugs":{"url":"https://github.com/blockchain-hq/x402-n8n-mock-node/issues"},"_nodeVersion":"24.3.0","_npmVersion":"11.4.2","dist":{"integrity":"sha512-pfDMAoIerQs74tevxi+tOhQ8/rceG7Qyr0CxWb5xDOG+ejjTGPALMyPySIFzwKRQsD2Y4aRoghxBQ2ZI2JKiRw==","shasum":"2a8afb377cdb68d23332f9d0e99e489f5883a58e","tarball":"https://registry.npmjs.org/@blockchainhq-xyz/n8n-nodes-solana-x402/-/n8n-nodes-solana-x402-1.0.1.tgz","fileCount":8,"unpackedSize":16939,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIF3rLpjnGNyouH0D93c/71gNWHS/eM02aA7+LlYmITDbAiEAxQvrapSUAcsLMQzjE4GXARzHiEhroIaOb75e3LqE3PQ="}]},"_npmUser":{"name":"blockchainhq-xyz","email":"gmblockchainhq@gmail.com"},"directories":{},"maintainers":[{"name":"blockchainhq-xyz","email":"gmblockchainhq@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/n8n-nodes-solana-x402_1.0.1_1762407137191_0.4131693603658062"},"_hasShrinkwrap":false}},"time":{"created":"2025-11-06T05:05:51.181Z","modified":"2025-11-06T05:32:17.591Z","1.0.0":"2025-11-06T05:05:51.520Z","1.0.1":"2025-11-06T05:32:17.393Z"},"bugs":{"url":"https://github.com/blockchain-hq/x402-n8n-mock-node/issues"},"author":{"name":"Mahima Thacker"},"license":"MIT","homepage":"https://github.com/blockchain-hq/x402-n8n-mock-node","keywords":["n8n-community-node-package","n8n","solana","x402","payment","http-402"],"repository":{"type":"git","url":"git+https://github.com/blockchain-hq/x402-n8n-mock-node.git"},"description":"n8n node for Solana x402 payment protocol - Return HTTP 402 Payment Required","maintainers":[{"name":"blockchainhq-xyz","email":"gmblockchainhq@gmail.com"}],"readme":"# n8n-nodes-solana-x402\n\n**Mock server node** for testing x402 payment flows in n8n. Test payment logic without creating actual APIs!\n\n[![npm version](https://badge.fury.io/js/n8n-nodes-solana-x402.svg)](https://www.npmjs.com/package/n8n-nodes-solana-x402)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## 🎯 What It Does\n\nThis is a **mock server node** that simulates a payment-required API server directly in n8n:\n\n- ✅ Return HTTP 402 Payment Required (without building an API)\n- ✅ Verify SOL payments on-chain\n- ✅ Test payment flows in n8n\n- ✅ No separate API server needed\n- ✅ Perfect for development and prototyping\n\n**Why Mock?** Test your payment logic end-to-end in n8n without deploying actual APIs. Great for learning, testing, and prototyping!\n\n## 📦 Installation\n\n### In n8n (Recommended)\n\n1. Go to **Settings > Community Nodes**\n2. Click **Install**\n3. Enter: `n8n-nodes-solana-x402`\n4. Click **Install**\n\n### Manual Installation\n\n```bash\n# 1. Install the package\nnpm install x402-server-sdk\n\n# 2. Link for development\nnpm link\n\n# 3. Set custom extensions path\nexport N8N_CUSTOM_EXTENSIONS=\"$HOME/x402-n8n-nodes\"\n\n# 4. Start n8n\nn8n start\n\n# 5. In n8n, search for: \"Solana x402\"\n# The node will appear with a Solana icon\n```\n\n## 🚀 Operations\n\n### 1. Return 402 Payment Required\n\nReturns 402 response requiring SOL payment.\n\n**Input:**\n- Amount (SOL): e.g., 0.01\n- Resource ID: optional\n\n**Output:**\n```json\n{\n  \"statusCode\": 402,\n  \"body\": {\n    \"paymentOptions\": [{\n      \"amount\": \"0.01\",\n      \"recipient\": \"YOUR_WALLET\",\n      \"token\": \"native\"\n    }]\n  }\n}\n```\n\n### 2. Verify Payment\n\nVerifies SOL payment on-chain.\n\n**Input:**\n- Transaction Signature\n- Expected Amount (SOL)\n- Max Age (seconds)\n\n**Output:**\n```json\n{\n  \"valid\": true,\n  \"signature\": \"5VERv8...\",\n  \"amount\": 0.01,\n  \"from\": \"PAYER_ADDRESS\",\n  \"to\": \"YOUR_WALLET\"\n}\n```\n\n## 🔐 Credentials\n\n**Solana x402 API:**\n- Network: Devnet or Mainnet\n- Recipient Address: Your wallet\n- RPC URL: (optional)\n\n## 📋 Mock Server Workflow\n\n**Test payment flows without building an API:**\n\n```\nManual Trigger → Solana x402 (Mock Server)\n                  Return 402 with requirements\n    ↓\nSolana x402 Client → Parse and Pay\n                      (makes real payment on devnet)\n    ↓\nSolana x402 (Mock Server) → Verify Payment\n                             (checks real transaction)\n    ↓\nIF Valid → Return Mock Content ✅\n    ↓\nIF Invalid → Return 403 Error\n```\n\n**This simulates:** Client requesting paid content → Server requiring payment → Client paying → Server verifying → Access granted\n\n**No real API needed!** Perfect for testing, learning, and prototyping.\n\n## 🎓 Use Cases\n\n| Use Case | Description |\n|----------|-------------|\n| **Learning x402** | Understand payment protocol without APIs |\n| **Testing Payment Flows** | Validate payment logic in n8n |\n| **Prototyping** | Quick proof-of-concept for paid features |\n| **Development** | Test before building real API |\n| **Demo** | Show payment flows to stakeholders |\n\n**Real-world deployment:** Use the x402 Server SDK in your actual Node.js/Express API. This mock node is for testing!\n\n## 🔒 Security\n\n**Always:**\n- Set Max Age (recommended: 300s)\n- Store used signatures in database\n- Use environment variables for wallet\n- Enable rate limiting\n\n**Example:**\n```javascript\nMax Age: 300  // 5 minutes\n```\n\n## 🌐 Networks\n\n**Devnet (Testing):**\n```bash\nsolana airdrop 2 YOUR_ADDRESS --url devnet\n```\n\n**Mainnet (Production):**\n- Use real wallet\n- Test on devnet first\n\n## 🐛 Troubleshooting\n\n| Issue | Fix |\n|-------|-----|\n| Node not visible | Restart n8n, clear browser cache |\n| Transaction not found | Wait, check network |\n| Amount mismatch | Verify exact amount |\n| Transaction too old | Increase Max Age |\n\n## 📚 Resources\n\n- [n8n Docs](https://docs.n8n.io/)\n- [Example Workflows](https://github.com/YOUR_USERNAME/n8n-nodes-solana-x402/tree/main/examples)\n- [x402 Protocol](https://x402.org/)\n\n## 🎯 Requirements\n\n- n8n: v0.220.0+\n- Node.js: v18+\n\n## 📄 License\n\nMIT\n\n## 💬 Support\n\n- [GitHub Issues](https://github.com/blockchain-hq/x402-n8n-mock-node/issues)\n- [n8n Community](https://community.n8n.io/)\n\n---\n\n**⭐ Star if useful!**","readmeFilename":"ReadMe.md"}