Crowd BF Explorer

Overview

The node "Crowd BF Explorer" enables users to explore Cardano blockchain data by interacting with the Blockfrost API. It supports multiple operations such as retrieving detailed information about a Cardano address, fetching transaction details by hash, and obtaining recent decentralized exchange (DEX) orders related to a wallet.

This node is beneficial for developers and analysts who want to integrate Cardano blockchain insights into their workflows without manually querying the blockchain. For example, it can be used to monitor wallet balances, track specific transactions, or analyze recent DEX activity on popular platforms like Minswap.

Practical examples:

• Fetching the balance and UTXOs of a given Cardano address to display in a dashboard.
• Retrieving detailed metadata and inputs/outputs of a transaction for auditing purposes.
• Listing recent swap or liquidity pool orders made by a wallet on Cardano DEXs.

Properties

Note on properties relevant to "Get Address Info" operation:

• Network: Selects which Cardano network's data to fetch.
• Address: The Cardano address whose info will be retrieved.

Output

The output JSON structure varies depending on the operation:

For "Get Address Info":

• operation: The string "getAddressInfo".
• network: The selected network (mainnet or testnet).
• address: The queried Cardano address.
• balance: An object containing:
  • ada: The ADA balance as a floating-point number.
  • lovelace: The balance in lovelace (smallest ADA unit).
• assets: Array of additional assets held by the address (beyond ADA).
• utxos: Array of unspent transaction outputs with fields:
  • txHash, outputIndex, amount, dataHash.
• recentTransactions: Up to 5 most recent transactions involving the address.
• totalUtxos: Total count of UTXOs.
• totalTransactions: Total number of transactions involving the address.
• success: Boolean indicating if the request succeeded.
• Optional note: Present if the address is not found on-chain (likely unused).

Binary Data

This node does not output binary data.

Dependencies

• Requires an API key credential for the Blockfrost API service.
• Uses the official Blockfrost JavaScript SDK to interact with the Cardano blockchain.
• The user must configure the node with a valid Blockfrost API key.
• Supports both Mainnet and Testnet endpoints of Blockfrost.

Troubleshooting

• Common issues:

  • Invalid or missing API key will cause authentication failures.
  • Querying an unused or invalid Cardano address returns a note indicating no on-chain data.
  • Network selection mismatch may lead to empty or unexpected results.
  • Rate limiting from Blockfrost API if too many requests are made in a short time.

• Error messages:

  • Errors from the Blockfrost API are caught and reported with their status codes.
  • If the node is set to continue on fail, errors are returned in the output JSON with success: false and error details.
  • Otherwise, the node throws an error with a message prefixed by "Cardano operation failed:" followed by the original error message.

• Resolution tips:

  • Ensure the API key is correctly configured and has access to the requested network.
  • Verify the Cardano address format and existence on the chosen network.
  • Use the "continue on fail" option to handle intermittent API errors gracefully.

Links and References

• Blockfrost API Documentation
• Cardano Blockchain Explorer
• Minswap DEX (referenced in metadata detection logic)