{"_id":"@blockchainhq-xyz/n8n-nodes-solana-x402-client","name":"@blockchainhq-xyz/n8n-nodes-solana-x402-client","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@blockchainhq-xyz/n8n-nodes-solana-x402-client","version":"1.0.0","description":"n8n node for making SOL payments via x402 protocol","keywords":["n8n-community-node-package","n8n","solana","x402","payment","client"],"license":"MIT","homepage":"https://github.com/blockchain-hq/x402-n8n-client-node","author":{"name":"Mahima Thacker"},"repository":{"type":"git","url":"git+https://github.com/blockchain-hq/x402-n8n-client-node.git"},"main":"index.js","scripts":{"build":"tsc && gulp build:icons","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"},"n8n":{"n8nNodesApiVersion":1,"credentials":["dist/credentials/SolanaX402ClientApi.credentials.js"],"nodes":["dist/nodes/SolanaX402Client/SolanaX402Client.node.js"]},"dependencies":{"x402-client-sdk":"^1.0.0","@solana/web3.js":"^1.95.0","bs58":"^5.0.0"},"devDependencies":{"@types/node":"^20.0.0","n8n-workflow":"^1.0.0","typescript":"^5.0.0","gulp":"^4.0.2","prettier":"^3.0.0","eslint":"^8.0.0"},"_id":"@blockchainhq-xyz/n8n-nodes-solana-x402-client@1.0.0","gitHead":"b2380d484e5d319e8f60f72ea0bbb1eb7db703a9","bugs":{"url":"https://github.com/blockchain-hq/x402-n8n-client-node/issues"},"_nodeVersion":"24.3.0","_npmVersion":"11.4.2","dist":{"integrity":"sha512-Ms/ts1xkNFJ3SJwh9bSKmtylQy+BjrnOJIB23IQE0p/+oednOoflq5hC6aQzklh4dJm7p9EivPoggqm3ELshzw==","shasum":"1fc28789cfff03f337a430451ff893e075c846f0","tarball":"https://registry.npmjs.org/@blockchainhq-xyz/n8n-nodes-solana-x402-client/-/n8n-nodes-solana-x402-client-1.0.0.tgz","fileCount":42,"unpackedSize":53478,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQChnq0el99NkT/nglD3mCMNASoIe/dRVaQ5CzUpE1qnSwIgR389Qa+TQEZSiL7tLUDxOYtbUgzzbvQ31XdVmEGD5ZQ="}]},"_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-client_1.0.0_1762405676682_0.16117517339654297"},"_hasShrinkwrap":false}},"time":{"created":"2025-11-06T05:07:56.611Z","1.0.0":"2025-11-06T05:07:56.894Z","modified":"2025-11-06T05:07:57.272Z"},"maintainers":[{"name":"blockchainhq-xyz","email":"gmblockchainhq@gmail.com"}],"description":"n8n node for making SOL payments via x402 protocol","homepage":"https://github.com/blockchain-hq/x402-n8n-client-node","keywords":["n8n-community-node-package","n8n","solana","x402","payment","client"],"repository":{"type":"git","url":"git+https://github.com/blockchain-hq/x402-n8n-client-node.git"},"author":{"name":"Mahima Thacker"},"bugs":{"url":"https://github.com/blockchain-hq/x402-n8n-client-node/issues"},"license":"MIT","readme":"# n8n-nodes-solana-x402-client\n\nn8n community node for making SOL payments in response to HTTP 402 errors. Client-side implementation of x402 protocol.\n\n[![npm version](https://badge.fury.io/js/n8n-nodes-solana-x402-client.svg)](https://www.npmjs.com/package/n8n-nodes-solana-x402-client)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## 🎯 What It Does\n\n- ✅ Parse 402 payment requirements\n- ✅ Make SOL payments automatically\n- ✅ Return transaction signatures\n- ✅ Integrate with any 402-enabled API\n\n## 📦 Installation\n\n### In n8n (Recommended)\n\n1. Go to **Settings > Community Nodes**\n2. Click **Install**\n3. Enter: `n8n-nodes-solana-x402-client`\n4. Click **Install**\n\n### Manual Installation\n\n```bash\n# 1. Install the package\nnpm install x402-client-sdk\n\n# 2. Link for development\nnpm link x402-client-sdk\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 Client\"\n# The node will appear with a Solana icon\n```\n\n## 🚀 Operations\n\n### 1. Parse 402 Response\n\nExtracts payment details from 402 response.\n\n**Input:** 402 response body\n**Output:** Payment details (amount, recipient)\n\n### 2. Make Payment\n\nSends SOL to specified address.\n\n**Input:**\n- Recipient address\n- Amount (SOL)\n- Payment ID (optional)\n\n**Output:** Transaction signature\n\n### 3. Parse and Pay ⭐\n\nParse and pay in one step (recommended!)\n\n**Input:** 402 response body\n**Output:** Transaction signature\n\n## 🔐 Credentials\n\n**Solana x402 Client API:**\n- Network: Devnet or Mainnet\n- Wallet Private Key: Base58 encoded\n- RPC URL: (optional)\n\n**Get Private Key:**\n```bash\nsolana address -k ~/wallet.json\ncat ~/wallet.json\n```\n\n## 📋 Example Workflow\n\n**Works with Mock Server node for testing:**\n\n```\nSolana x402 (Mock Server) → Returns 402\n    ↓\nSolana x402 Client → Parse and Pay\n    ↓\nSolana x402 (Mock Server) → Verify Payment\n    ↓\nGet Content ✅\n```\n\n**Or with real API:**\n\n```\nHTTP Request → Get 402 from real API\n    ↓\nSolana x402 Client → Parse and Pay (sends SOL)\n    ↓\nHTTP Request → Retry with X-Payment signature\n    ↓\nGet Content ✅\n```\n\n## 🎓 Use Cases\n\n| Use Case | Description |\n|----------|-------------|\n| **Testing with Mock** | Use with Solana x402 Mock Server node |\n| **Auto-pay APIs** | Automatic payment on 402 |\n| **Content Access** | Pay for premium content |\n| **Subscription** | Automated renewal |\n| **Pay-per-use** | Pay as you go |\n\n**Perfect combo:** Use with the Solana x402 Mock Server node to test complete payment flows in n8n without building APIs!\n\n## 💰 Wallet Setup\n\n**Devnet (Testing):**\n```bash\n# Generate wallet\nsolana-keygen new -o ~/devnet-wallet.json\n\n# Get SOL\nsolana airdrop 2 YOUR_ADDRESS --url devnet\n\n# Get private key\ncat ~/devnet-wallet.json\n```\n\n**Mainnet (Production):**\n- Use existing wallet\n- Ensure sufficient SOL balance\n- Keep private key secure\n\n## 🔄 Full Payment Flow\n\n```\n1. Request API\n2. Get 402 response\n3. Use \"Parse and Pay\"\n4. Get signature\n5. Retry request with X-Payment header\n6. Access granted ✅\n```\n\n## 🔒 Security\n\n**Best Practices:**\n- Never commit private keys\n- Use environment variables\n- Start with small amounts on devnet\n- Test thoroughly before mainnet\n\n## 🐛 Troubleshooting\n\n| Issue | Fix |\n|-------|-----|\n| Node not visible | Restart n8n, clear cache |\n| Invalid private key | Use base58 format |\n| Insufficient balance | Get more SOL (airdrop/purchase) |\n| Transaction failed | Check network and balance |\n\n## 🌐 Networks\n\n**Devnet:**\n- Free testing\n- Get SOL via airdrop\n- Same as mainnet\n\n**Mainnet:**\n- Real SOL\n- Purchase from exchange\n- Production ready\n\n## 📚 Resources\n\n- [n8n Docs](https://docs.n8n.io/)\n- [Example Workflows](https://github.com/YOUR_USERNAME/n8n-nodes-solana-x402-client/tree/main/examples)\n- [x402 Protocol](https://x402.org/)\n\n## 🎯 Requirements\n\n- n8n: v0.220.0+\n- Node.js: v18+\n- SOL balance for payments\n\n## 📄 License\n\nMIT\n\n## 🤝 Contributing\n\nPRs welcome! See [CONTRIBUTING.md](CONTRIBUTING.md)\n\n## 💬 Support\n\n- [GitHub Issues](https://github.com/blockchain-hq/x402-n8n-client-node/issues)\n- [n8n Community](https://community.n8n.io/)\n\n---\n\n**⭐ Star if useful!**","readmeFilename":"README.md","_rev":"1-ac91b3bc40b1ec8a28329dfdb40ebef4"}