n8n-nodes-agnicwallet 1.0.2 → 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
 
@@ -61,7 +65,7 @@ Not yet available. This node must first be approved as a community node by the N
 
 ### 1. Create AgnicWallet Account
 
-1. Go to [AgnicWallet](https://agnicwallet-project.vercel.app)
+1. Go to [AgnicWallet](https://app.agnicpay.xyz)
 2. Sign up with email/social login
 3. Your embedded wallet is created automatically
 
@@ -77,7 +81,7 @@ Not yet available. This node must first be approved as a community node by the N
 
 #### Option B: API Key
 
-1. Log in to [AgnicWallet](https://agnicwallet-project.vercel.app)
+1. Log in to [AgnicWallet](https://app.agnicpay.xyz)
 2. Go to **Settings** → **API Tokens**
 3. Generate a new token
 4. In N8N, select **API Key** authentication
@@ -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"
@@ -185,7 +243,7 @@ JSON body for sending data to the API
 
 **Solutions:**
 1. Reconnect credentials in N8N
-2. Check balance at [AgnicWallet](https://agnicwallet-project.vercel.app)
+2. Check balance at [AgnicWallet](https://app.agnicpay.xyz)
 3. Check backend status
 
 ### "Request failed after payment"
@@ -220,20 +278,34 @@ 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
 
 - **X402 Standard:** [x402.org](https://www.x402.org/)
-- **AgnicWallet:** [Dashboard](https://agnicwallet-project.vercel.app)
+- **AgnicWallet:** [Dashboard](https://app.agnicpay.xyz)
 
 ## License
 
@@ -242,21 +314,26 @@ MIT License
 ## Links
 
 - [NPM Package](https://www.npmjs.com/package/n8n-nodes-agnicwallet)
-- [AgnicWallet Dashboard](https://agnicwallet-project.vercel.app)
+- [AgnicWallet Dashboard](https://app.agnicpay.xyz)
 - [X402 Protocol](https://www.x402.org/)
 - [N8N Documentation](https://docs.n8n.io)
 
 ## 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/dist/credentials/AgnicWalletApi.credentials.js

@@ -5,7 +5,7 @@ class AgnicWalletApi {
     constructor() {
         this.name = 'agnicWalletApi';
         this.displayName = 'AgnicWallet API';
-        this.documentationUrl = 'https://docs.agnicwallet.com/n8n';
+        this.documentationUrl = 'https://github.com/agnicpay/agnicwallet-project#setup';
         this.properties = [
             {
                 displayName: 'User ID',

package/dist/credentials/AgnicWalletOAuth2Api.credentials.js

@@ -6,7 +6,7 @@ class AgnicWalletOAuth2Api {
         this.name = 'agnicWalletOAuth2Api';
         this.extends = ['oAuth2Api'];
         this.displayName = 'AgnicWallet OAuth2 API';
-        this.documentationUrl = 'https://docs.agnicwallet.com/oauth';
+        this.documentationUrl = 'https://github.com/agnicpay/agnicwallet-project/blob/main/OAUTH_COMPLETE_GUIDE.md';
         this.properties = [
             {
                 displayName: 'Grant Type',
@@ -18,7 +18,7 @@ class AgnicWalletOAuth2Api {
                 displayName: 'Authorization URL',
                 name: 'authUrl',
                 type: 'string',
-                default: 'https://agnicwallet-project.onrender.com/oauth/authorize',
+                default: 'https://api.agnicpay.xyz/oauth/authorize',
                 required: true,
                 description: 'The OAuth2 authorization endpoint',
             },
@@ -26,7 +26,7 @@ class AgnicWalletOAuth2Api {
                 displayName: 'Access Token URL',
                 name: 'accessTokenUrl',
                 type: 'string',
-                default: 'https://agnicwallet-project.onrender.com/oauth/token',
+                default: 'https://api.agnicpay.xyz/oauth/token',
                 required: true,
                 description: 'The OAuth2 token endpoint',
             },

package/dist/nodes/X402HttpRequest/X402HttpRequest.node.js

@@ -148,7 +148,7 @@ class X402HttpRequest {
                 let authHeader;
                 // Use AgnicWallet backend API endpoint (production cloud by default)
                 // Can override with AGNICWALLET_API_URL environment variable for local development
-                apiBaseUrl = process.env.AGNICWALLET_API_URL || 'https://agnicwallet-project.onrender.com';
+                apiBaseUrl = process.env.AGNICWALLET_API_URL || 'https://api.agnicpay.xyz';
                 if (authentication === 'oAuth2') {
                     // OAuth2 authentication
                     const credentials = await this.getCredentials('agnicWalletOAuth2Api', itemIndex);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-agnicwallet",
-  "version": "1.0.2",
+  "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://agnicwallet.com",
+  "homepage": "https://github.com/agnicpay/n8n-X402-AgnicWallet#readme",
   "author": {
     "name": "AgnicWallet",
-    "email": "support@agnicwallet.com"
+    "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": {
@@ -28,7 +37,7 @@
     "format": "prettier nodes credentials --write",
     "lint": "tslint -p tsconfig.json -c tslint.json",
     "lintfix": "tslint --fix -p tsconfig.json -c tslint.json",
-    "prepublishOnly": "npm run build && npm run lint -c .eslintrc.prepublish.js nodes credentials package.json",
+    "prepublishOnly": "npm run build",
     "test": "jest"
   },
   "files": [