Package Information
Documentation

DCC Node Api Connector for N8N
Production readiness: early 0.x; expect breaking changes until 1.0. Follow semver guidance below.
The DCC Node REST API offers the ability to read blockchain data such as account data, token data, active leases, blocks, transactions, and other data including feature activation status and block reward voting status. It also provides transaction management functions like broadcasting signed transactions, pre-validating and checking transaction status. Additionally, it offers utilities for generating addresses from public keys, validating addresses, generating random seeds, calculating hashes, and more.
With this N8N you will be able to connect the DCC node api to your workflows, automate blockchain tasks or trigger wallet creations and more.
Installation
Install the community package in your n8n instance (requires enabling Community Nodes):
npm install n8n-nodes-dcc
Restart n8n after installation so it loads the new node bundle.
Enabling Community Nodes (if not already)
- In n8n UI go to Settings > Community Nodes.
- Enable the feature (confirm the security notice).
- Add this package name
n8n-nodes-dccif using the in-app installer or install via CLI as above.
Updating
npm update n8n-nodes-dcc
Check changelog and commit history for potential breaking changes (0.x minor bumps may be breaking until 1.0.0).
Semantic Versioning
This project follows Semantic Versioning principles; however while in 0.x the API surface (parameters, field names) may change in minor releases. Once 1.0.0 is reached:
- MAJOR: Breaking changes to node description/fields/behavior.
- MINOR: Backwards-compatible features (new resources / operations / optional fields).
- PATCH: Backwards-compatible bug fixes and internal maintenance.
Pin exact versions in mission‑critical environments to avoid unexpected changes.
Releasing Manually
- Update
CHANGELOG.mdwith changes. - Bump version in
package.jsonfollowing SemVer guidance. - Commit:
chore(release): vX.Y.Z. - Tag:
git tag -a vX.Y.Z -m "vX.Y.Z"thengit push --tags. - Release workflow (after added) publishes on matching tag.
See detailed steps in CONTRIBUTING.md.
Features / Operations
Resources supported:
- Account
- Get Account: Retrieve balance & basic account info
- Token
- Get Token: Retrieve token / asset metadata
- Transaction
- List Transactions: Paginated list for an address (limit & offset)
- Broadcast Transaction: Broadcast a signed transaction JSON
- Utility
- Generate Address: Derive address from a supplied public key
- Validate Address: Check if an address is valid in the network
Credentials
The node can operate with or without credentials. Create a credential of type DccApi if you want to centrally manage the Base URL and/or include a bearer token for authenticated endpoints (future expansion).
Credential fields:
| Field | Description |
|---|---|
| Base URL | Optional override of default public node endpoint |
| Token | Bearer token (if your node requires auth) |
If no credential is supplied, the node uses the Base URL parameter on the node itself.
Usage Examples
1. Get Account
- Add the DCC node.
- Select Resource = Account, Operation = Get Account.
- Enter the account Address.
- Execute to receive balances and other basic data.
2. List Transactions
- Resource = Transaction, Operation = List Transactions.
- Provide Owner Address, adjust Limit & Offset as needed.
- Execute to return an array of transactions.
3. Broadcast Transaction
- Resource = Transaction, Operation = Broadcast Transaction.
- Paste the signed transaction JSON into the Signed Transaction JSON field.
- Execute; response includes success status or validation errors.
4. Generate Address
- Resource = Utility, Operation = Generate Address.
- Provide a Public Key.
- Execute to get derived address.
5. Validate Address
- Resource = Utility, Operation = Validate Address.
- Provide the address string.
- Execute to get validation result.
Development / Build
Install dependencies and build:
npm install
npm run build
npm run check:dist
Lint & format:
npm run lint
npm run lintfix
npm run format
Project Health
Prerequisites
You need the following installed on your development machine:
- Node API Key, you can get this by running your own node or renting an API from someone else in the network.
More information
Refer to our documentation to get more background on how the DCC node works: DecentralChain Documentation
Contributing
Issues & PRs welcome. Please open security-related issues with the SECURITY prefix (see Security Policy).