Transactions & Provenance

Verifiable transaction history management and logging are core requirements for institutional operations — from AML fund flow tracing and regulatory audit reporting to smart contract execution path verification. Nodit normalizes chain-specific data structures to provide transactions, internal transactions, event logs, and asset movement data through a unified standard for querying, auditing, and reconciliation.

---

Use Cases

AML and Anti-Money Laundering
Retrieve the full transaction history and internal transactions per account to trace fund origins and movement paths. Combining account transaction history retrieval with internal transaction tracing captures not only direct transfers but also indirect fund flows routed through smart contracts.

Regulatory Audit Reporting
Extract on-chain transaction history for the audit period using pagination and date filters. The Block and Transaction domain APIs provide data in formats required by regulatory authorities.

Smart Contract Event Monitoring
Use the event log search API to query event logs generated by specific contracts, filtered by topic. This supports DeFi protocol integration, contract state change tracking, and anomalous transaction detection workflows.

Token and NFT Transfer History Tracking
Independently retrieve ERC-20 token transfer history and NFT transfer history for specific accounts. Use this to reconstruct digital asset ownership transfer history and analyze movement patterns per asset.

Post-Submission Tracking Workflow
Combine block inclusion verification and receipt confirmation for submitted transactions with deep execution path analysis for failure root cause analysis, execution path review, and post-hoc auditing.

Key Capabilities

On-chain history retrieval and audit pipelines are organized into two tracks: Indexed History and Real-time Trace. Use them independently or in combination depending on service requirements.

Indexed History History Reconstruction

Account-Based History Reconstruction

Query the full transaction history per account and the internal call flows routed through smart contracts in a unified view. Reconstruct direct transfers and indirect fund flows in a single pipeline to obtain complete history for AML analysis and audit reconciliation.

Token and NFT Transfer History Tracking

Retrieve ERC-20 token transfer history and NFT movement history independently. Use this to reconstruct asset ownership transfer records and analyze movement patterns for specific tokens — delivered in a normalized format without needing to parse chain-specific data structures directly.

Event Log Search

Search event logs generated by specific contracts, filtered by topic. Filter by event type, address, and block range to extract only the data needed for DeFi protocol integration, contract state change tracking, and anomalous transaction detection workflows.

Real-time Trace Real-time Analysis

Transaction Execution Path Analysis

Perform deep analysis of the internal call flows and execution paths of specific transactions. Provides detailed execution context for failure root cause identification, compliance review, and audit tracing — with the ability to query execution traces down to the EVM opcode level.

Block Inclusion and Finality Tracking

Verify block inclusion status and final execution results immediately after transaction submission via direct node calls. This serves as the baseline status check in post-submission tracking workflows and acts as the starting point for settlement integration and post-hoc auditing.

Event-Driven State Change Detection

Receive on-chain activity for specific addresses or contracts asynchronously via Webhook or Stream. Connect audit events and state changes to internal analysis systems without polling, building a real-time response workflow.

Implementation Example

API Use Cases

Scenario	API to Use	Reason
Reconstruct full TX history per account	getTransactionsByAccount	Supports pagination and date filters; suitable for audit report generation
Trace indirect fund flows (AML)	getInternalTransactionsByAccount	Includes internal calls routed through smart contracts; reconstructs fund origins
Analyze internal calls for a specific TX	getInternalTransactionsByTransactionHash	Retrieves internal call list by TX hash
Topic-based event log search	searchEvents	Filter by contract event type, address, and block range
Track ERC-20 transfer history	getTokenTransfersByAccount	Normalized token transfer history for asset movement pattern analysis
Track NFT transfer history	getNftTransfersByAccount	Reconstruct ownership transfer history
Query TXs by block	getTransactionsInBlock	Reconstruct on-chain activity at a specific point in time; block-based auditing
Check TX status after submission	eth_getTransactionByHash, eth_getTransactionReceipt	Immediately retrieve block inclusion status and final execution result
Deep execution path analysis	debug_traceTransaction, trace_transaction	Analyze internal call flows, failure causes, and execution context
On-chain activity alerts for specific address	Webhook — ADDRESS_ACTIVITY	Immediately receive all transaction events for a designated address
TX success alert (settlement integration)	Webhook — SUCCESSFUL_TRANSACTION	Automatically update internal ledger when transaction success is confirmed
TX failure alert (reprocessing)	Webhook — FAILED_TRANSACTION	Detect failure immediately and trigger reprocessing workflow
Contract event detection	Webhook — LOG	Receive contract events based on topic
ERC-20 transfer with condition filtering	Flexible Webhook — erc20.transfer	Pre-filter by specific token and amount criteria using CEL expressions
Real-time status streaming	Stream	Maintain WebSocket connection; receive TX receipts in real time

Indexed History

Account-level history retrieval, fund origin tracing, and regulatory audit reporting:

1. Identify the query target (account address, date range, asset type).

2. Select the API based on the query purpose.

   Query Purpose	API
   Full TX history per account	getTransactionsByAccount
   Fund flows routed through smart contracts	getInternalTransactionsByAccount
   Internal calls for a specific TX	getInternalTransactionsByTransactionHash
   ERC-20 transfer history	getTokenTransfersByAccount
   NFT transfer history	getNftTransfersByAccount
   Event log topic search	searchEvents
   TX list by block	getTransactionsInBlock

3. Use date filters and pagination to precisely select the audit target data. Run any additional tracing needed based on relevant transaction hashes or IDs.

4. Feed the normalized data into audit report generation, AML analysis systems, and risk engines.

Real-time Trace

Post-submission tracking, execution path verification, and failure root cause analysis:

1. Use eth_getTransactionByHash and eth_getTransactionReceipt to check TX status and block inclusion.
2. For deeper analysis, use debug_traceTransaction or trace_transaction to retrieve internal call flows.
3. Configure Webhook or Stream to receive state changes and audit events asynchronously.
4. Connect received event data to internal analysis systems and risk engines.

API References

Parameter specifications and response examples are available in the linked API references.

Domain Interaction	Implementation Option	Nodit Feature	Reference
Transaction submission	Direct JSON-RPC call	eth_sendRawTransaction	API Reference
Transaction status query	Direct JSON-RPC call	eth_getTransactionByHash, eth_getTransactionReceipt	eth_getTransactionByHash, eth_getTransactionReceipt
Block-level query	Direct JSON-RPC call	eth_getBlockByNumber / eth_getBlockByHash	API Reference
Deep execution path analysis	Direct JSON-RPC call	debug_traceTransaction, trace_transaction	debug_traceTransaction, trace_transaction
Account transaction history retrieval	Normalized data	getTransactionsByAccount	API Reference
Internal transaction tracing	Normalized data	getInternalTransactionsByAccount	API Reference
Internal call retrieval for specific TX	Normalized data	getInternalTransactionsByTransactionHash	API Reference
Token transfer history retrieval	Normalized data	getTokenTransfersByAccount	API Reference
NFT transfer history retrieval	Normalized data	getNftTransfersByAccount	API Reference
Event log search	Normalized data	searchEvents	API Reference
Block-level transaction query	Normalized data	getTransactionsInBlock	API Reference

Related Guides

• Elastic Node — Submission, basic tracing, and trace/debug Node APIs
• Web3 Data API — Transaction history retrieval and indexed provenance data
• API Reference — Full API parameter specifications and response schemas