Crowd BF Explorer icon

Crowd BF Explorer

Explore Cardano blockchain data via Blockfrost API

Actions3

Overview

The "Crowd BF Explorer" node allows users to explore Cardano blockchain data using the Blockfrost API. It supports three main operations:

  • Get Address Info: Retrieves balance, assets, UTXOs, and recent transactions for a given Cardano address.
  • Get Transaction: Fetches detailed information about a specific transaction by its hash.
  • Get Recent Orders: Detects recent decentralized exchange (DEX) orders related to a wallet by analyzing transaction metadata, focusing on platforms like Minswap and other DEXs.

This node is beneficial for blockchain developers, analysts, or enthusiasts who want to integrate Cardano blockchain data into their workflows without manually querying the blockchain. For example, it can be used to monitor wallet activity, track DEX trades, or audit transaction details programmatically.

Properties

Name Meaning
Network The Cardano network to use. Options: Mainnet, Testnet.
Address The Cardano address to query. Required for "Get Address Info" and "Get Recent Orders" operations. Example format: addr1qxy...
Limit Maximum number of transactions to check for orders. Used only in "Get Recent Orders". Range: 1 to 100. Default is 20.
Operation The operation to perform. Options: Get Address Info, Get Transaction, Get Recent Orders.
Transaction Hash The transaction hash to query. Required for "Get Transaction" operation. Example: abc123def456...

Output

The output JSON structure varies depending on the selected operation:

  • Get Address Info:

    • operation: "getAddressInfo"
    • network: Selected network
    • address: Queried address
    • balance: ADA balance in both ADA and lovelace units
    • assets: List of non-ADA assets held by the address
    • utxos: Array of unspent transaction outputs with details (txHash, outputIndex, amount, dataHash)
    • recentTransactions: Up to 5 most recent transactions involving the address
    • totalUtxos: Number of UTXOs
    • totalTransactions: Total number of transactions found
    • success: Boolean indicating success
    • note: Optional note if address not found (likely unused)

  • Get Transaction:

    • operation: "getTransaction"
    • network: Selected network
    • transactionHash: Queried transaction hash
    • transaction: Object containing transaction details such as hash, block info, fees, size, validity intervals, and contract validation status
    • inputs: Array of input UTXOs with address, amount, txHash, outputIndex, dataHash, collateral flag
    • outputs: Array of output UTXOs with address, amount, outputIndex, dataHash
    • metadata: Transaction metadata if available, otherwise null
    • success: Boolean indicating success

  • Get Recent Orders:

    • operation: "getRecentOrders"
    • network: Selected network
    • address: Wallet address queried
    • totalOrders: Number of detected DEX orders
    • transactionsScanned: Number of transactions scanned to find orders
    • orders: Array of detected orders, each including transaction hash, timestamp, fee, size, block info, metadata, DEX detection details, order type, inputs, and outputs
    • walletAddress: Same as queried address
    • queryTime: ISO timestamp of query execution
    • note: Explanation that orders are detected via transaction metadata analysis
    • success: Boolean indicating success

The 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.
  • Supports both Mainnet and Testnet endpoints of Blockfrost.
  • No additional external dependencies beyond the Blockfrost API and n8n environment.

Troubleshooting

  • Common Issues:

    • Invalid or missing API key credential will cause authentication failures.
    • Querying an unused or invalid Cardano address may return empty results with a note indicating the address was not found on-chain.
    • Exceeding the limit of transactions to scan (max 100) for recent orders may result in incomplete data.
    • Network selection mismatch (e.g., querying a Mainnet address on Testnet) will yield no results or errors.

  • Error Messages:

    • Errors from the Blockfrost API are caught and reported with messages like "Cardano operation failed: <error message>".
    • If the node is set to continue on fail, errors are returned in the output JSON with success: false and error details.
    • HTTP 404 errors when fetching address info indicate the address likely has no on-chain activity.

  • Resolution Tips:

    • Ensure the API key credential is valid and has access to the correct network.
    • Verify the Cardano address format and network compatibility.
    • Adjust the "Limit" property within allowed bounds to control transaction scanning.
    • Enable "Continue On Fail" in the node settings to handle partial failures gracefully.

Links and References

Discussion