@n8n-dev/n8n-nodes-zapper 1.0.0

package/README.md

@@ -0,0 +1,95 @@
+# @n8n-dev/n8n-nodes-zapper
+
+[![npm version](https://img.shields.io/npm/v/@n8n-dev/n8n-nodes-zapper.svg)](https://www.npmjs.com/package/@n8n-dev/n8n-nodes-zapper)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+**Stop writing zapper API integrations by hand.**
+
+Every time you connect n8n to zapper, you waste hours mapping endpoints, defining parameters, and debugging schemas. You copy-paste from docs, fix edge cases, and pray nothing breaks.
+
+**What if connecting n8n to zapper took 5 minutes, not half a day?**
+
+This node gives you **1+ resources** out of the box: **Zapper Tools**: with full CRUD operations, typed parameters, and zero manual configuration.
+
+---
+
+## What You Get
+
+- **Zero boilerplate**: Resources, operations, and fields are pre-configured and ready to use
+- **Full CRUD**: Create, read, update, and delete support where the API allows it
+- **Typed parameters**: No more guessing field types
+- **Built-in auth**: API key authentication, ready to go
+- **Declarative**: Native n8n performance, no custom execute() overhead
+
+---
+
+## Install
+
+```bash
+npm install @n8n-dev/n8n-nodes-zapper
+```
+
+**Or in n8n:**
+1. **Settings → Community Nodes → Install**
+2. Search: `@n8n-dev/n8n-nodes-zapper`
+3. Click **Install**
+
+---
+
+## Quick Start
+
+1. Install the node (above)
+2. Add credentials: **zapper API** → paste your API key
+3. Drag the **zapper** node into your workflow
+4. Pick a resource → pick an operation → done.
+
+That's it. No configuration files. No code. It just works.
+
+---
+
+## Resources
+
+| Resource | Operations |
+|----------|------------|
+| Zapper Tools | POST Get real-time token price and market cap, POST Search for ERC20 tokens, NFTs, Users, Apps, or Gas Tokens., POST Get detailed metadata, traits, media, and holder info for a specific NFT, POST Get NFT collection data including market stats, holders, events, and a sample of NFTs., POST Get aggregated portfolio totals (Tokens, Apps, NFTs) broken down by network for a single address, or a list of addresses., POST Get detailed token balances for a single address, or a list of addresses, optionally filtering by chain., POST Get DeFi balances (Liquidity Pools, Yield Farming, Lending, etc.) for a single address, or a list of addresses., POST Get individual NFT balances and estimated values for a single address, or a list of addresses., POST Get the price of a token at a specific point in time., POST Get human-readable interpretation, metadata, and balance changes for a specific transaction., POST Get transaction history with interpretations and metadata for a single address, or a list of addresses., POST Get token holders with balances and identity information for a specific token., POST Get a ranked list of tokens based on swap activity and velocity of adoption, optionally tailored for a farcaster user., POST Get a ranked list of NFT collections based on rading activity and collection popularity, optionally tailored for a farcaster user., POST Get social identity (ENS, Farcaster, Lens, Basenames) for a specific address., POST Get a real-time feed of swap activity across Farcaster, including token trades, volume, and social context., POST Get a combined activity feed for a specific token, including swaps and top Farcaster casts, personalized for a given user. |
+
+---
+
+## Why This Node?
+
+**Without this node:**
+- Hours of manual API integration
+- Copy-pasting from zapper docs
+- Debugging auth, pagination, error handling
+- Maintaining your own client code
+
+**With this node:**
+- Install → configure → use. 5 minutes.
+- Auto-generated from the official zapper OpenAPI spec
+- Always up to date when the API changes
+- Native n8n performance
+
+---
+
+## Auto-Generated
+This node was auto-generated from the official **zapper** OpenAPI specification using
+[@n8n-dev/n8n-openapi-node-ultimate](https://github.com/kelvinzer0/n8n-openapi-node-ultimate),
+then validated against the live API so you get accurate types and real parameters, not guesswork.
+
+When the zapper API updates, this node updates too.
+
+---
+
+## Support This Project
+
+If this node saved you hours of work, consider supporting continued development, new APIs, better error handling, and faster updates.
+
+[![Keep It Moving.](https://crypto-donate.insidexofficial.workers.dev/eyJ0aXRsZSI6IktlZXAgSXQgTW92aW5nIiwiZGVzYyI6Ik9uZSBkZXZlbG9wZXIgYnVpbHQgYSB0b29sIHRoYXQgYXV0by1nZW5lcmF0ZXNcbm44biBub2RlcyBmcm9tIGFueSBPcGVuQVBJIHNwZWMuXG5cbllvdXIgZG9uYXRpb24gZnVuZHMgbmV3IGZlYXR1cmVzLCBtb3JlIEFQSSBzdXBwb3J0LFxuYW5kIGJldHRlciB0b29saW5nIGZvciBldmVyeSBkZXZlbG9wZXIgYWZ0ZXIgeW91LiIsInRhcmdldCI6NTAwMCwiYWRkcmVzc2VzIjp7ImV0aGVyZXVtIjoiMHhmMDU1NWQ0MGRiRkI0ZTNCZjA3MDQ0MjgyQjc4RjJmRTFmNTFFZjcyIiwic29sYW5hIjoiNlpEVk5BYmpZZExEcXo4cGt3VUNHYllaNVV3QlFranB0QzU1Wk5vTFcybVUifSwiZGlzY29yZCI6Imh0dHBzOi8vZGlzY29yZC5nZy9wdERaOGU0aDkzIn0/badge)](https://n8n-code.github.io/membership/#/eyJ0aXRsZSI6IktlZXAgSXQgTW92aW5nIiwiZGVzYyI6Ik9uZSBkZXZlbG9wZXIgYnVpbHQgYSB0b29sIHRoYXQgYXV0by1nZW5lcmF0ZXNcbm44biBub2RlcyBmcm9tIGFueSBPcGVuQVBJIHNwZWMuXG5cbllvdXIgZG9uYXRpb24gZnVuZHMgbmV3IGZlYXR1cmVzLCBtb3JlIEFQSSBzdXBwb3J0LFxuYW5kIGJldHRlciB0b29saW5nIGZvciBldmVyeSBkZXZlbG9wZXIgYWZ0ZXIgeW91LiIsInRhcmdldCI6NTAwMCwiYWRkcmVzc2VzIjp7ImV0aGVyZXVtIjoiMHhmMDU1NWQ0MGRiRkI0ZTNCZjA3MDQ0MjgyQjc4RjJmRTFmNTFFZjcyIiwic29sYW5hIjoiNlpEVk5BYmpZZExEcXo4cGt3VUNHYllaNVV3QlFranB0QzU1Wk5vTFcybVUifSwiZGlzY29yZCI6Imh0dHBzOi8vZGlzY29yZC5nZy9wdERaOGU0aDkzIn0)
+
+---
+
+## License
+
+MIT © [kelvinzer0](https://github.com/n8n-code)

package/dist/credentials/ZapperApi.credentials.d.ts

@@ -0,0 +1,10 @@
+import type { IAuthenticateGeneric, Icon, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class ZapperApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    icon: Icon;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/ZapperApi.credentials.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZapperApi = void 0;
+class ZapperApi {
+    constructor() {
+        this.name = 'N8nDevZapperApi';
+        this.displayName = 'zapper API';
+        this.icon = { light: 'file:../nodes/Zapper/zapper.svg', dark: 'file:../nodes/Zapper/zapper.dark.svg' };
+        this.documentationUrl = '';
+        this.properties = [
+            {
+                displayName: 'Base URL',
+                name: 'url',
+                type: 'string',
+                default: '',
+                required: true,
+                placeholder: 'https://api.example.com',
+                description: 'The base URL of your zapper API server',
+            },
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+            },
+            {
+                "displayName": "❤️ Keep It Moving: One developer built a tool that auto-generates n8n nodes from any OpenAPI spec. Your donation funds new features, more API support, and better tooling for every developer after you. <a href=\"https://n8n-code.github.io/membership/#/eyJ0aXRsZSI6IktlZXAgSXQgTW92aW5nIiwiZGVzYyI6Ik9uZSBkZXZlbG9wZXIgYnVpbHQgYSB0b29sIHRoYXQgYXV0by1nZW5lcmF0ZXNcbm44biBub2RlcyBmcm9tIGFueSBPcGVuQVBJIHNwZWMuXG5cbllvdXIgZG9uYXRpb24gZnVuZHMgbmV3IGZlYXR1cmVzLCBtb3JlIEFQSSBzdXBwb3J0LFxuYW5kIGJldHRlciB0b29saW5nIGZvciBldmVyeSBkZXZlbG9wZXIgYWZ0ZXIgeW91LiIsInRhcmdldCI6NTAwMCwiYWRkcmVzc2VzIjp7ImV0aGVyZXVtIjoiMHhmMDU1NWQ0MGRiRkI0ZTNCZjA3MDQ0MjgyQjc4RjJmRTFmNTFFZjcyIiwic29sYW5hIjoiNlpEVk5BYmpZZExEcXo4cGt3VUNHYllaNVV3QlFranB0QzU1Wk5vTFcybVUifSwiZGlzY29yZCI6Imh0dHBzOi8vZGlzY29yZC5nZy9wdERaOGU0aDkzIn0\" target=\"_blank\">☕ Buy me a coffee</a>",
+                "name": "n8nCodeNotice",
+                "type": "notice",
+                "default": "",
+                "displayOptions": {
+                    "show": {}
+                }
+            }
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.apiKey}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.url}}',
+                url: '/',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.ZapperApi = ZapperApi;
+//# sourceMappingURL=ZapperApi.credentials.js.map

package/dist/credentials/ZapperApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZapperApi.credentials.js","sourceRoot":"","sources":["../../credentials/ZapperApi.credentials.ts"],"names":[],"mappings":";;;AAQA,MAAa,SAAS;IAAtB;QACC,SAAI,GAAG,iBAAiB,CAAC;QAEzB,gBAAW,GAAG,YAAY,CAAC;QAE3B,SAAI,GAAS,EAAE,KAAK,EAAE,iCAAiC,EAAE,IAAI,EAAE,sCAAsC,EAAE,CAAC;QAExG,qBAAgB,GAAG,EAAE,CAAC;QAEtB,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,KAAK;gBACX,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,yBAAyB;gBACtC,WAAW,EAAE,wCAAwC;aACrD;YACD;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;aACd;YACD;gBACC,aAAa,EAAE,k0BAAk0B;gBACj1B,MAAM,EAAE,eAAe;gBACvB,MAAM,EAAE,QAAQ;gBAChB,SAAS,EAAE,EAAE;gBACb,gBAAgB,EAAE;oBACjB,MAAM,EAAE,EAAE;iBACV;aACD;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,aAAa,EAAE,iCAAiC;iBAChD;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,uBAAuB;gBAChC,GAAG,EAAE,GAAG;gBACR,MAAM,EAAE,KAAK;aACb;SACD,CAAC;IACH,CAAC;CAAA;AAtDD,8BAsDC"}

package/dist/icons/zapper.dark.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 60 60" fill="none">
+  <rect width="60" height="60" rx="8" fill="#2D2D2D"/>
+  <text x="30" y="36" text-anchor="middle" fill="#FF6D5A" font-family="Arial,sans-serif" font-size="24" font-weight="bold">Z</text>
+</svg>

package/dist/icons/zapper.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 60 60" fill="none">
+  <rect width="60" height="60" rx="8" fill="#FF6D5A"/>
+  <text x="30" y="36" text-anchor="middle" fill="white" font-family="Arial,sans-serif" font-size="24" font-weight="bold">Z</text>
+</svg>

package/dist/nodes/Zapper/Zapper.node.d.ts

@@ -0,0 +1,4 @@
+import { type INodeType, type INodeTypeDescription } from 'n8n-workflow';
+export declare class Zapper implements INodeType {
+    description: INodeTypeDescription;
+}

package/dist/nodes/Zapper/Zapper.node.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Zapper = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const zapper_tools_1 = require("./resources/zapper-tools");
+class Zapper {
+    constructor() {
+        this.description = {
+            displayName: 'zapper',
+            name: 'N8nDevZapper',
+            icon: { light: 'file:./zapper.svg', dark: 'file:./zapper.dark.svg' },
+            group: ['input'],
+            version: 1,
+            subtitle: '={{\$parameter["operation"] + ": " + \$parameter["resource"]}}',
+            description: 'Zapper blockchain portfolio tracker and DeFi dashboard for managing assets across 60+ chains with real-time prices',
+            defaults: { name: 'zapper' },
+            usableAsTool: true,
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            credentials: [
+                {
+                    name: 'N8nDevZapperApi',
+                    required: true,
+                },
+            ],
+            requestDefaults: {
+                baseURL: '={{\$credentials.url}}',
+                headers: {
+                    Accept: 'application/json',
+                    'Content-Type': 'application/json',
+                },
+            },
+            properties: [
+                {
+                    "displayName": "Resource",
+                    "name": "resource",
+                    "type": "options",
+                    "noDataExpression": true,
+                    "options": [
+                        {
+                            "name": "Zapper Tools",
+                            "value": "Zapper Tools",
+                            "description": ""
+                        }
+                    ],
+                    "default": ""
+                },
+                ...zapper_tools_1.zapperToolsDescription
+            ],
+        };
+    }
+}
+exports.Zapper = Zapper;
+//# sourceMappingURL=Zapper.node.js.map

package/dist/nodes/Zapper/Zapper.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Zapper.node.js","sourceRoot":"","sources":["../../../nodes/Zapper/Zapper.node.ts"],"names":[],"mappings":";;;AAAA,+CAA8F;AAC9F,2DAAkE;AAElE,MAAa,MAAM;IAAnB;QACC,gBAAW,GAAyB;YACnC,WAAW,EAAE,QAAQ;YACrB,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,wBAAwB,EAAE;YACpE,KAAK,EAAE,CAAC,OAAO,CAAC;YAChB,OAAO,EAAE,CAAC;YACV,QAAQ,EAAE,gEAAgE;YAC1E,WAAW,EAAE,oHAAoH;YACjI,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC5B,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,CAAC,kCAAmB,CAAC,IAAI,CAAC;YAClC,OAAO,EAAE,CAAC,kCAAmB,CAAC,IAAI,CAAC;YACnC,WAAW,EAAE;gBACZ;oBACC,IAAI,EAAE,iBAAiB;oBACvB,QAAQ,EAAE,IAAI;iBACd;aACD;YACD,eAAe,EAAE;gBAChB,OAAO,EAAE,wBAAwB;gBACjC,OAAO,EAAE;oBACR,MAAM,EAAE,kBAAkB;oBAC1B,cAAc,EAAE,kBAAkB;iBAClC;aACD;YACD,UAAU,EAAE;gBACZ;oBACC,aAAa,EAAE,UAAU;oBACzB,MAAM,EAAE,UAAU;oBAClB,MAAM,EAAE,SAAS;oBACjB,kBAAkB,EAAE,IAAI;oBACxB,SAAS,EAAE;wBACV;4BACC,MAAM,EAAE,cAAc;4BACtB,OAAO,EAAE,cAAc;4BACvB,aAAa,EAAE,EAAE;yBACjB;qBACD;oBACD,SAAS,EAAE,EAAE;iBACb;gBACD,GAAG,qCAAsB;aACxB;SACD,CAAC;IACH,CAAC;CAAA;AA5CD,wBA4CC"}

package/dist/nodes/Zapper/Zapper.node.json

@@ -0,0 +1,20 @@
+{
+    "node": "N8nDevZapper",
+    "nodeVersion": "1.0",
+    "codexVersion": "1.0",
+    "categories": [
+        "Development"
+    ],
+    "resources": {
+        "primaryDocumentation": [
+            {
+                "url": "https://github.com/n8n-code/n8n-nodes-zapper"
+            }
+        ],
+        "credentialDocumentation": [
+            {
+                "url": "https://github.com/n8n-code/n8n-nodes-zapper?tab=readme-ov-file#credentials"
+            }
+        ]
+    }
+}

package/dist/nodes/Zapper/resources/index.d.ts

@@ -0,0 +1 @@
+export { zapperToolsDescription } from './zapper-tools';

package/dist/nodes/Zapper/resources/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zapperToolsDescription = void 0;
+var zapper_tools_1 = require("./zapper-tools");
+Object.defineProperty(exports, "zapperToolsDescription", { enumerable: true, get: function () { return zapper_tools_1.zapperToolsDescription; } });
+//# sourceMappingURL=index.js.map

package/dist/nodes/Zapper/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../nodes/Zapper/resources/index.ts"],"names":[],"mappings":";;;AAAA,+CAAwD;AAA/C,sHAAA,sBAAsB,OAAA"}

package/dist/nodes/Zapper/resources/zapper-tools/index.d.ts

@@ -0,0 +1,2 @@
+import type { INodeProperties } from 'n8n-workflow';
+export declare const zapperToolsDescription: INodeProperties[];