n8n-nodes-agnicwallet 1.0.0 → 1.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +20 -50
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# n8n-nodes-agnicwallet
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/n8n-nodes-agnicwallet)
|
|
4
|
-
[](https://
|
|
4
|
+
[](https://www.npmjs.com/package/n8n-nodes-agnicwallet)
|
|
5
5
|
|
|
6
6
|
N8N community node for AgnicWallet - automated Web3 payments for X402-enabled APIs.
|
|
7
7
|
|
|
@@ -13,7 +13,7 @@ Make HTTP requests to X402-enabled APIs with automatic blockchain payment handli
|
|
|
13
13
|
|
|
14
14
|
## What is AgnicWallet?
|
|
15
15
|
|
|
16
|
-
AgnicWallet is a non-custodial Web3 wallet service
|
|
16
|
+
AgnicWallet is a non-custodial Web3 wallet service that handles blockchain payments automatically. Connect once, then all X402 payments happen seamlessly in the background.
|
|
17
17
|
|
|
18
18
|
## Features
|
|
19
19
|
|
|
@@ -62,7 +62,7 @@ Not yet available. This node must first be approved as a community node by the N
|
|
|
62
62
|
### 1. Create AgnicWallet Account
|
|
63
63
|
|
|
64
64
|
1. Go to [AgnicWallet](https://agnicwallet-project.vercel.app)
|
|
65
|
-
2. Sign up with email/social login
|
|
65
|
+
2. Sign up with email/social login
|
|
66
66
|
3. Your embedded wallet is created automatically
|
|
67
67
|
|
|
68
68
|
### 2. Connect to N8N
|
|
@@ -86,44 +86,24 @@ Not yet available. This node must first be approved as a community node by the N
|
|
|
86
86
|
|
|
87
87
|
## Usage
|
|
88
88
|
|
|
89
|
-
### Basic Example:
|
|
89
|
+
### Basic Example: X402 Protected Content
|
|
90
90
|
|
|
91
|
-
|
|
91
|
+
Simple GET request with automatic payment:
|
|
92
92
|
|
|
93
|
-
- **Method:** `
|
|
94
|
-
- **URL:** `https://
|
|
95
|
-
- **Headers:**
|
|
96
|
-
- Name: `X-AgnicBillo-Key`
|
|
97
|
-
- Value: `agb_qroy8w9rb5lnpcla8ydl`
|
|
98
|
-
- **Body:**
|
|
99
|
-
```json
|
|
100
|
-
{
|
|
101
|
-
"model": "gpt-3.5-turbo",
|
|
102
|
-
"messages": [
|
|
103
|
-
{"role": "user", "content": "Hello!"}
|
|
104
|
-
]
|
|
105
|
-
}
|
|
106
|
-
```
|
|
93
|
+
- **Method:** `GET`
|
|
94
|
+
- **URL:** `https://www.x402.org/protected`
|
|
107
95
|
|
|
108
96
|
**What happens:**
|
|
109
|
-
1. Node makes
|
|
110
|
-
2. Receives `402 Payment Required`
|
|
111
|
-
3. Automatically signs payment with your
|
|
112
|
-
4. Retries with payment proof
|
|
113
|
-
5. Returns
|
|
97
|
+
1. Node makes GET request to protected endpoint
|
|
98
|
+
2. Receives `402 Payment Required` with payment details
|
|
99
|
+
3. Automatically signs payment ($0.01 USDC) with your AgnicWallet
|
|
100
|
+
4. Retries request with payment proof
|
|
101
|
+
5. Returns protected content with payment metadata
|
|
114
102
|
|
|
115
103
|
**Response:**
|
|
116
104
|
```json
|
|
117
105
|
{
|
|
118
|
-
"
|
|
119
|
-
"choices": [
|
|
120
|
-
{
|
|
121
|
-
"message": {
|
|
122
|
-
"role": "assistant",
|
|
123
|
-
"content": "Hello! How can I help you?"
|
|
124
|
-
}
|
|
125
|
-
}
|
|
126
|
-
],
|
|
106
|
+
"data": "<!DOCTYPE html>...<h1>Protected Content</h1><p>Your payment was successful!...</p>",
|
|
127
107
|
"_agnicWallet": {
|
|
128
108
|
"paymentMade": true,
|
|
129
109
|
"amountPaid": 0.01,
|
|
@@ -132,14 +112,9 @@ Configure the node:
|
|
|
132
112
|
}
|
|
133
113
|
```
|
|
134
114
|
|
|
135
|
-
### Example:
|
|
115
|
+
### Advanced Example: ChatGPT with X402
|
|
136
116
|
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
- **Method:** `GET`
|
|
140
|
-
- **URL:** `https://www.x402.org/protected`
|
|
141
|
-
|
|
142
|
-
Node automatically handles the $0.01 payment and returns the protected content.
|
|
117
|
+
For POST requests with JSON body, see the advanced integration example in the documentation.
|
|
143
118
|
|
|
144
119
|
### Example: Dynamic Content
|
|
145
120
|
|
|
@@ -193,7 +168,7 @@ JSON body for sending data to the API
|
|
|
193
168
|
|
|
194
169
|
## Security
|
|
195
170
|
|
|
196
|
-
- **Non-custodial** - Your keys, your crypto
|
|
171
|
+
- **Non-custodial** - Your keys, your crypto
|
|
197
172
|
- **OAuth2** - Industry-standard authentication
|
|
198
173
|
- **Spending limits** - Monthly caps prevent overspending
|
|
199
174
|
- **Payment review** - See all payments in AgnicWallet dashboard
|
|
@@ -231,7 +206,7 @@ The body field only appears when Method is **POST** or **PUT**. For GET requests
|
|
|
231
206
|
|
|
232
207
|
## Examples & Workflows
|
|
233
208
|
|
|
234
|
-
|
|
209
|
+
For example workflows and advanced use cases, check the documentation included with this package.
|
|
235
210
|
|
|
236
211
|
## API Reference
|
|
237
212
|
|
|
@@ -251,26 +226,22 @@ See [example workflows](https://github.com/agnicpay/agnicwallet-project/tree/mai
|
|
|
251
226
|
- **Body types:** JSON only (form-encoded coming soon)
|
|
252
227
|
- **Query params:** Use in URL for now (dedicated field coming soon)
|
|
253
228
|
|
|
254
|
-
See [ENHANCEMENT_PLAN.md](https://github.com/agnicpay/agnicwallet-project/blob/main/n8n-nodes-agnicwallet/nodes/X402HttpRequest/ENHANCEMENT_PLAN.md) for upcoming features.
|
|
255
|
-
|
|
256
229
|
## Contributing
|
|
257
230
|
|
|
258
|
-
Contributions welcome! Please
|
|
231
|
+
Contributions welcome! Please contact us for more information.
|
|
259
232
|
|
|
260
233
|
## Support
|
|
261
234
|
|
|
262
|
-
- **Issues:** [GitHub Issues](https://github.com/agnicpay/agnicwallet-project/issues)
|
|
263
|
-
- **Docs:** [Full Documentation](https://github.com/agnicpay/agnicwallet-project)
|
|
264
235
|
- **X402 Standard:** [x402.org](https://www.x402.org/)
|
|
236
|
+
- **AgnicWallet:** [Dashboard](https://agnicwallet-project.vercel.app)
|
|
265
237
|
|
|
266
238
|
## License
|
|
267
239
|
|
|
268
|
-
MIT
|
|
240
|
+
MIT License
|
|
269
241
|
|
|
270
242
|
## Links
|
|
271
243
|
|
|
272
244
|
- [NPM Package](https://www.npmjs.com/package/n8n-nodes-agnicwallet)
|
|
273
|
-
- [GitHub Repository](https://github.com/agnicpay/agnicwallet-project)
|
|
274
245
|
- [AgnicWallet Dashboard](https://agnicwallet-project.vercel.app)
|
|
275
246
|
- [X402 Protocol](https://www.x402.org/)
|
|
276
247
|
- [N8N Documentation](https://docs.n8n.io)
|
|
@@ -296,7 +267,6 @@ MIT - See [LICENSE](https://github.com/agnicpay/agnicwallet-project/blob/main/LI
|
|
|
296
267
|
|
|
297
268
|
Built with:
|
|
298
269
|
- [N8N](https://n8n.io) - Workflow automation
|
|
299
|
-
- [Privy](https://privy.io) - Embedded wallets
|
|
300
270
|
- [X402 Protocol](https://www.x402.org/) - HTTP payment standard
|
|
301
271
|
- [Base](https://base.org) - L2 blockchain
|
|
302
272
|
|