n8n-nodes-agnicwallet 1.0.3 → 1.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AgnicWallet
+
+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 this 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/README.md

@@ -2,9 +2,13 @@
 
 [![NPM Version](https://img.shields.io/npm/v/n8n-nodes-agnicwallet)](https://www.npmjs.com/package/n8n-nodes-agnicwallet)
 [![License](https://img.shields.io/npm/l/n8n-nodes-agnicwallet)](https://www.npmjs.com/package/n8n-nodes-agnicwallet)
+[![GitHub issues](https://img.shields.io/github/issues/agnicpay/n8n-X402-AgnicWallet)](https://github.com/agnicpay/n8n-X402-AgnicWallet/issues)
+[![GitHub stars](https://img.shields.io/github/stars/agnicpay/n8n-X402-AgnicWallet)](https://github.com/agnicpay/n8n-X402-AgnicWallet/stargazers)
 
 N8N community node for AgnicWallet - automated Web3 payments for X402-enabled APIs.
 
+> ⭐ If you find this node useful, please star the repository on [GitHub](https://github.com/agnicpay/n8n-X402-AgnicWallet)!
+
 Make HTTP requests to X402-enabled APIs with automatic blockchain payment handling via AgnicWallet. No manual wallet management, no complex crypto operations - just authenticate and automate.
 
 ## What is X402?
@@ -25,7 +29,7 @@ AgnicWallet is a non-custodial Web3 wallet service that handles blockchain payme
 - ✅ **JSON body support** - For POST/PUT requests
 - ✅ **Payment metadata** - See exactly what you paid and when
 - ✅ **Monthly spending limits** - Built-in safety controls
-- ✅ **Base Sepolia support** - Currently supports USDC on Base Sepolia testnet
+- ✅ **Multi-chain support** - Base (EVM) and Solana networks, both testnet and mainnet
 
 ## Installation
 
@@ -158,6 +162,30 @@ JSON body for sending data to the API
 4. **Retry request** - Node retries with `X-PAYMENT` header containing payment proof
 5. **Return response** - API validates payment and returns protected resource
 
+## Backend Service
+
+This node requires the AgnicWallet backend API to function. **This is by design and secure.**
+
+### How It Works
+1. You create a free account at [AgnicWallet](https://app.agnicpay.xyz)
+2. You authorize n8n to use your wallet (OAuth2 or API Key)
+3. When making X402 requests, the node calls `api.agnicpay.xyz` to sign payments on your behalf
+4. Your wallet is non-custodial (keys managed by Privy, not stored by AgnicWallet)
+
+### Why This Architecture?
+- **No blockchain complexity** - You don't manage private keys or gas fees
+- **Automatic payments** - Sign once, automate forever
+- **Spending controls** - Set monthly limits for safety
+- **Standard pattern** - Just like Slack, Notion, and other n8n nodes that use external APIs
+
+### Backend API Details
+- **Hosted at:** `api.agnicpay.xyz` (free to use)
+- **Authentication:** OAuth2 or API Key
+- **What it does:** Signs X402 payments with your authorized wallet
+- **Open source:** You can self-host by setting `AGNICWALLET_API_URL` environment variable
+
+This is the same architecture used by most n8n community nodes that interact with external services.
+
 ## Payment Details
 
 - **Network:** Base Sepolia (testnet)
@@ -174,6 +202,36 @@ JSON body for sending data to the API
 - **Payment review** - See all payments in AgnicWallet dashboard
 - **Revocable access** - Disconnect N8N anytime
 
+## FAQ
+
+### Is my wallet safe?
+Yes! AgnicWallet is non-custodial. Your private keys are managed by [Privy](https://privy.io), not stored on AgnicWallet servers. The backend only signs transactions you've authorized.
+
+### Do I need to trust AgnicWallet?
+Yes, but only as much as you trust Slack, Notion, or Google when using their n8n nodes. You're authorizing AgnicWallet to sign X402 payments on your behalf within your spending limits.
+
+### Can I use this node without AgnicWallet?
+No. This node is specifically designed to work with AgnicWallet's backend API. However, you can:
+- Fork this node and modify it to use your own payment service
+- Self-host the AgnicWallet backend (set `AGNICWALLET_API_URL` environment variable)
+
+### Is the backend API free?
+Yes! The AgnicWallet service is free to use. You only pay blockchain transaction costs (USDC payments).
+
+### What if api.agnicpay.xyz goes down?
+- Your workflows will fail with payment signing errors
+- Advanced users can self-host the backend for redundancy
+- Check status at https://app.agnicpay.xyz
+
+### Can n8n approve a node with external dependencies?
+Absolutely! Most popular n8n community nodes depend on external APIs:
+- Slack → api.slack.com
+- GitHub → api.github.com
+- Stripe → api.stripe.com
+- AgnicWallet → api.agnicpay.xyz ✅
+
+This is standard practice and well-documented in the node's README.
+
 ## Troubleshooting
 
 ### "Payment signing failed"
@@ -220,15 +278,29 @@ For example workflows and advanced use cases, check the documentation included w
 | headers | collection | No | Custom headers |
 | body | json | No* | JSON body (*POST/PUT only) |
 
+## Supported Networks
+
+AgnicWallet supports multiple blockchain networks for X402 payments:
+
+- ✅ **Base Sepolia** - EVM testnet (free testing with testnet USDC)
+- ✅ **Base** - EVM mainnet (real USDC payments)
+- ✅ **Solana Devnet** - SVM testnet (free testing with devnet USDC)
+- ✅ **Solana** - SVM mainnet (real USDC payments)
+
+The node automatically selects the appropriate network based on your API token configuration and the X402 payment requirements from the API provider.
+
 ## Limitations
 
-- **Networks:** Currently Base Sepolia only (mainnet coming soon)
 - **Body types:** JSON only (form-encoded coming soon)
 - **Query params:** Use in URL for now (dedicated field coming soon)
 
 ## Contributing
 
-Contributions welcome! Please contact us for more information.
+Contributions are welcome! We appreciate bug reports, feature requests, and pull requests.
+
+- **Bug reports & feature requests:** [Open an issue](https://github.com/agnicpay/n8n-X402-AgnicWallet/issues)
+- **Pull requests:** See our [Contributing Guide](CONTRIBUTING.md)
+- **Questions:** Contact us at support@agnicpay.xyz
 
 ## Support
 
@@ -248,15 +320,20 @@ MIT License
 
 ## Roadmap
 
-### v1.1.0
+### ✅ Completed
+- Multi-chain support (Base EVM + Solana SVM)
+- OAuth2 and API Key authentication
+- Mainnet and testnet support for both chains
+
+### v1.1.0 (Next)
 - Query parameters support
 - Form-encoded body
 - Timeout configuration
 
-### v1.2.0
-- Multiple networks (Base mainnet, Polygon, etc.)
-- Retry logic
-- Rate limiting
+### v1.2.0 (Future)
+- Additional EVM networks (Polygon, Arbitrum, etc.)
+- Retry logic with exponential backoff
+- Enhanced rate limiting
 
 ### v2.0.0
 - File upload support

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-agnicwallet",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "n8n community node for AgnicWallet - automated Web3 payments for X402 APIs",
   "keywords": [
     "n8n-community-node-package",
@@ -9,17 +9,26 @@
     "x402",
     "web3",
     "crypto",
-    "payments"
+    "payments",
+    "blockchain",
+    "usdc",
+    "automation",
+    "workflow",
+    "base",
+    "solana"
   ],
   "license": "MIT",
-  "homepage": "https://app.agnicpay.xyz",
+  "homepage": "https://github.com/agnicpay/n8n-X402-AgnicWallet#readme",
   "author": {
     "name": "AgnicWallet",
     "email": "support@agnicpay.xyz"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/agnicpay/agnicwallet-project.git"
+    "url": "https://github.com/agnicpay/n8n-X402-AgnicWallet.git"
+  },
+  "bugs": {
+    "url": "https://github.com/agnicpay/n8n-X402-AgnicWallet/issues"
   },
   "main": "index.js",
   "scripts": {