n8n-nodes-wax-kit

This is an n8n community node kit. It lets you use the WAX Blockchain in your n8n workflows with advanced capabilities.

The WAX Blockchain is a purpose-built blockchain and protocol token designed to make e-commerce transactions faster, easier, and safer for all participants. It's specifically designed for the transfer of digital assets, including NFTs (Non-Fungible Tokens).

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Coexistence
Compatibility
Usage
Resources
Donations
Version history

Installation

Follow the installation guide in the n8n community nodes documentation.
Package name: n8n-nodes-wax-kit

Operations

This node package provides advanced operations for interacting with the WAX Blockchain:

• WAX Kit: A resource-based node (God Node) containing multiple blockchain operations:
  • Account: Get Info, Buy/Sell RAM, Stake/Unstake resources, Refund.
  • Token: Get Balance, Transfer Tokens.
  • Asset: Get Assets, Transfer NFTs.
  • Governance: Vote for Producers, Set Proxy.
  • History: Get Transaction History (Hyperion), Get Asset History (AtomicAssets).
  • Smart Contract: Get Table Data, Execute Action, Multi-Action.
• Standalone Nodes: Specialized nodes for specific tasks (hidden by default for cleaner UI).

Credentials

For operations that require signing transactions, you'll need the WAX Kit Private Key API credential:

• Account Name: Your WAX account name
• Private Key: The private key associated with your WAX account

Coexistence

This package is designed to coexist with the original n8n-nodes-wax package. All nodes and credentials in this kit are prefixed with "WAX Kit" to avoid name collisions. You can have both installed in the same n8n instance without issues.

Compatibility

This node requires n8n version 1.0.0 or later.

WAX Kit Reference

The WAX Kit node is the central hub for all operations. You select a Resource, and then an Operation.

👤 Account Resource

Manage account status and system resources.

• Get Account Info: Fetch details like balances, resources (RAM/CPU/NET), and permissions.
• Verify Account: Simple check to see if an account exists on-chain.
• Buy RAM: Purchase RAM bytes using WAX.
• Sell RAM: Recover WAX by selling unused RAM.
• Stake (Delegate): Stake WAX to CPU or NET.
• Unstake (Undelegate): Start the 72-hour unstaking process.
• Refund: Reclaim WAX once the unstaking period is complete.

💰 Token Resource

Standard token operations.

• Get Balance: Fetch the balance of any token (default is WAX in eosio.token).
• Transfer Tokens: Send tokens to another account. Supports custom precision and authorizations.

🖼 Asset Resource (NFTs)

Interact with AtomicAssets.

• Get Assets: List NFTs owned by an account with filters (Collection, Schema, Template).
• Transfer Assets: Transfer one or multiple NFTs in a single transaction.

📜 History Resource

Access indexed blockchain data.

• Get Transaction History: Get a list of recent actions for a specific account (v1 Chain API). Supports Position (pos) and Offset (offset).
• Get Asset History: Detailed log of everything that happened to a specific NFT (AtomicAssets).

🏛 Governance Resource

Participate in the chain's decision-making.

• Vote Producers: Submit your vote for up to 30 block producers.
• Set Proxy: Delegate your voting weight to a proxy account.
• Claim GBM Vote: Claim your GBM voting rewards.

🏗 Smart Contract Action

Low-level interaction for any contract.

• Get Table Data: Query rows from any contract table with advanced filtering.
• Execute Action: Send a single action to any contract.
• Multi Action: Send multiple different actions in one single transaction.
• Push Actions: Pass a JSON array of actions for maximum flexibility.

---

Technical Details

Custom Permissions

Available for Transfer Assets and Transfer Tokens. This allows you to sign transactions using a specific permission (e.g., active, owner, or any custom name) instead of assuming active.

API Endpoints

The kit supports both standard RPC endpoints and custom URLs.

• Default (Greymass): https://wax.greymass.com
• History (Hyperion): Requires an endpoint that supports the Hyperion API.
• AtomicAssets: Uses wax.api.atomicassets.io for NFT data consistency.

Resources

• GitHub Repository
• n8n community nodes documentation
• WAX Developer Portal

Donations

If you find these nodes useful and want to support the development of this kit, feel free to send a donation to the developer's WAX address:

WAX Address: shadysapylab

Your support is greatly appreciated! 🙏

Version history

1.4.0

• Alcor Exchange Integration: Added dedicated resource for Alcor DEX (Limit Orderbook):
  • Create Order (Limit): Automated limit orders via token transfer to alcordexmain.
  • Cancel Order: Direct actions to cancel active buy or sell orders.
  • Get Active Orders: Fetch a list of open buy and sell orders for any account on a specific market.
• Improved UI: Focus on Limit orders for precision and clarity.

1.3.1

• Batch Operations: Added Get Multiple Balances and Transfer Multiple Tokens for optimized token management.
• Atomic Transactions: Multi-transfers are executed in a single transaction, ensuring atomicity.
• Improved Reliability: Enhanced error handling for batch fetching.

1.3.0

• NeftyBlocks Support: Added dedicated resource for NeftyBlocks ecosystem:
  • Nefty Blends: Execute Blend (handles the deposit + fuse flow).
  • Nefty Packs: Open Nefty Pack (transfer to neftyblocksp) and Claim Nefty Pack.
• UI Enhancements: Added brand labeling to operations for better identification (AtomicAssets vs. AtomicPacks vs. Nefty).

1.2.0

• NFT Evolution (AtomicAssets): Added complete management for NFTs:
  • Creation: Create Collection, Create Schema, and Create Template.
  • Minting: Mint NFT (single) and Distribute NFTs (Batch/Airdrop).
  • Advanced: Burn NFT and Claim NFTs (v1/v2 support).
• NFT Packs (AtomicPacks): Added specialized actions for opening and claiming packs:
  • Open Pack: Automates the transfer-to-unbox mechanism.
  • Claim Unboxed Pack: Claim results from unboxed packs on atomicpacksx.
• Improved UX: Alphabetized operations for better navigation and refined UI labels.

1.1.3

• Robustness: Implemented automatic failover for RPC endpoints. If the primary endpoint fails, the node will automatically try 5 alternative WAX endpoints (Greymass, Pink.gg, etc.).
• Maintenance: Centralized authorization and asset formatting logic to ensure consistent behavior across all resources.
• UX Improvement: Added a structured list input for Asset IDs in the Transfer Assets operation, making it easier to manage multiple NFTs.
• Improved Error Handling: Enhanced error reporting for account verification and history fetching.

1.1.2

• New Governance Operation: Added claimGbmVote to the Governance resource.
• Enhanced Governance UI: Added predefined lists for Top Proxies and Top Block Producers for easier voting.
• Enhanced Governance: Added support for configurable authorizations (custom permissions) for all governance operations.

1.1.1

• Fix: History API: Switched getTransactionHistory from Hyperion to standard v1 Chain API for better compatibility (uses v1/history/get_actions with pos and offset).

1.1.0

• New Resource: History: Added getTransactionHistory (Hyperion) and getAssetHistory (AtomicAssets) to the main WAX Kit node.
• New Resource: Governance: Added voteProducer and setProxy operations.
• Advanced Account Management: Added undelegatebw (Unstake), sellRam, and refund operations.
• Custom Permissions: Added the ability to specify custom authorizations for Transfer Assets and Transfer Tokens.

1.0.2

• UI Cleanup: Hidden standalone nodes (Multi Action, Push Actions, Smart Contract) to provide a unified experience through the main WAX Kit node.
• God Node: Confirmed WAX Kit as the single entry point for all operations.

1.0.1

• Enhanced Main Node: Integrated Smart Contract Actions directly into the main WAX Kit node.
• New Operations: Get Table, Execute Action, Multi Action, and Push Actions are now available under the Smart Contract Action resource in the main node.
• Bug Fixes: Improved error handling normalization across all resources.

1.0.0

• Official Release of WAX Kit.
• Renamed package to n8n-nodes-wax-kit.
• Pre-fixed all nodes and credentials for coexistence with other WAX node packages.
• Added WAX Kit Push Actions: New node for variable/dynamic actions in a single transaction.
• Improved Security: Masked private keys and standard JsSignatureProvider usage.
• Standardized RPC: Standardized on eosjs for new and core modules.
• Consolidated Architecture: Resource-based "WAX Kit" node for Account, Token, and Asset operations.