DecentralChain (DCC) icon

DecentralChain (DCC)

Create, sign and broadcast DecentralChain transactions, plus query blockchain data

Actions25

Overview

This node interacts with the DecentralChain (DCC) blockchain to retrieve account-related information. Specifically, for the Account resource and Get Account Balance operation, it fetches the balance details of a given DCC address from the blockchain.

Common scenarios where this node is beneficial include:

  • Monitoring wallet balances in real-time.
  • Integrating blockchain account balance checks into workflows for financial reconciliation or alerts.
  • Building dashboards that display user token holdings on the DecentralChain network.

Practical example:

  • A workflow triggers periodically to check the balance of a specific DCC address and sends a notification if the balance falls below a threshold.

Properties

Name Meaning
Base URL The base URL of the DecentralChain node API endpoint to query. Defaults to https://nodes.decentralchain.io. Used if no credential base URL is supplied.
Address The DecentralChain (DCC) address whose account balance you want to retrieve.

Output

The output JSON contains the response from the DecentralChain node API for the account balance request. It typically includes fields such as:

  • balance: The current balance of the account in the smallest unit of DCC.
  • regular: Regular balance amount.
  • generating: Generating balance amount.
  • available: Available balance amount.
  • Other metadata related to the account's balance state.

Example output structure (simplified):

{
  "balance": 123456789,
  "regular": 123456789,
  "generating": 0,
  "available": 123456789
}

No binary data output is produced by this operation.

Dependencies

  • Requires access to a DecentralChain node API endpoint, either via the provided Base URL property or through credentials supplying a base URL.
  • Uses HTTP requests to communicate with the blockchain node.
  • No additional external services or environment variables are required beyond standard HTTP connectivity.

Troubleshooting

  • Common issues:

    • Incorrect or malformed DCC address will cause the API request to fail or return an error.
    • Network connectivity problems to the specified Base URL can result in timeouts or connection errors.
    • Using an outdated or incorrect Base URL may lead to unexpected responses or failures.

  • Error messages:

    • If the node throws an error related to HTTP request failure, verify the Base URL and network connectivity.
    • Errors indicating invalid address format suggest checking the input address for correctness.
    • If the node returns empty or missing balance data, confirm that the address exists on the blockchain and has transaction history.

  • Resolution tips:

    • Double-check the DCC address format before running the node.
    • Ensure the Base URL points to a valid and accessible DecentralChain node.
    • Use the node’s "Continue On Fail" option to handle occasional API errors gracefully within workflows.

Links and References

Discussion