autrace 0.0.5 → 0.0.6

package/build/src/BlockchainFlowAnalyzer.js

@@ -0,0 +1,284 @@
+export class BlockchainFlowAnalyzer {
+    constructor() {
+        this.analyzeTransactionFlow = (blockchainTx) => {
+            const txMeta = {
+                txHash: blockchainTx.txHash,
+                status: blockchainTx.txStatus,
+                blockHeight: blockchainTx.blockHeight,
+                timestamp: blockchainTx.timestamp,
+                fee: blockchainTx.fee,
+                feePayerAddress: blockchainTx.feePayerAddress,
+                memo: blockchainTx.memo || ''
+            };
+            const accountUpdates = this.processAccountUpdates(blockchainTx.updatedAccounts);
+            this.mapFailureInfo(accountUpdates, blockchainTx.failures);
+            const relationships = [
+                // Various relationship types in order of precedence
+                this.buildCallDepthRelationships(accountUpdates),
+                this.buildStateDepRelationships(accountUpdates),
+                this.buildTokenRelationships(accountUpdates),
+                this.buildFeepayerRelationships(accountUpdates, txMeta.feePayerAddress),
+                this.buildCallDataRelationships(accountUpdates),
+                this.buildTemporalRelationships(accountUpdates)
+            ];
+            const edges = this.mergeRelationships(relationships);
+            return {
+                metadata: txMeta,
+                nodes: accountUpdates,
+                edges: edges
+            };
+        };
+        this.processAccountUpdates = (rawAccounts) => {
+            return rawAccounts.map((account, index) => ({
+                id: `au-${index}`,
+                index,
+                address: account.accountAddress,
+                shortAddress: account.accountAddress.substring(0, 12) + '...',
+                isContract: account.isZkappAccount || !!account.update?.verificationKey,
+                callDepth: account.callDepth || 0,
+                tokenId: account.tokenId,
+                tokenSymbol: this.extractTokenSymbol(account),
+                balanceChange: account.totalBalanceChange || 0,
+                failed: false, // Will be updated in mapFailureInfo
+                failureReason: null,
+                stateValues: this.extractStateValues(account.update?.appState),
+                callData: account.callData !== '0' ? account.callData : null,
+                permissions: account.update?.permissions || {}
+            }));
+        };
+        this.mapFailureInfo = (accounts, failures) => {
+            if (!failures || !Array.isArray(failures))
+                return;
+            failures.forEach(failure => {
+                // Adjust for 0-based vs 1-based indexing if needed
+                const accountIndex = failure.index - 1;
+                if (accountIndex >= 0 && accountIndex < accounts.length) {
+                    accounts[accountIndex].failed = true;
+                    accounts[accountIndex].failureReason = failure.failureReason;
+                }
+            });
+            // Find root cause of failure to highlight it
+            const rootFailure = accounts.find(a => a.failed);
+            if (rootFailure) {
+                rootFailure.isRootFailure = true;
+            }
+        };
+        this.buildCallDepthRelationships = (accounts) => {
+            const relationships = [];
+            // Group accounts by call depth
+            const accountsByDepth = new Map();
+            accounts.forEach(account => {
+                if (!accountsByDepth.has(account.callDepth)) {
+                    accountsByDepth.set(account.callDepth, []);
+                }
+                accountsByDepth.get(account.callDepth).push(account);
+            });
+            // Process accounts with depth > 0
+            for (let depth = 1; depth <= Math.max(...accountsByDepth.keys()); depth++) {
+                const highDepthAccounts = accountsByDepth.get(depth) || [];
+                const lowerDepthAccounts = accountsByDepth.get(depth - 1) || [];
+                highDepthAccounts.forEach(highAccount => {
+                    // Find potential parent account(s) with same address at lower depth
+                    const potentialParents = lowerDepthAccounts.filter(lowAccount => lowAccount.address === highAccount.address);
+                    if (potentialParents.length > 0) {
+                        // Use the closest previous parent in sequence
+                        const validParents = potentialParents.filter(p => p.index < highAccount.index);
+                        if (validParents.length > 0) {
+                            const parent = validParents.reduce((prev, curr) => (curr.index > prev.index) ? curr : prev);
+                            relationships.push({
+                                from: parent.id,
+                                to: highAccount.id,
+                                type: 'call_depth',
+                                label: 'calls (depth)',
+                                color: 'blue'
+                            });
+                        }
+                    }
+                });
+            }
+            return relationships;
+        };
+        this.buildStateDepRelationships = (accounts) => {
+            const relationships = [];
+            const stateValues = new Map();
+            // Track all non-zero state values
+            accounts.forEach(account => {
+                if (account.stateValues) {
+                    account.stateValues.forEach((value, index) => {
+                        if (value && value !== '0') {
+                            const valueStr = value.toString();
+                            if (!stateValues.has(valueStr)) {
+                                stateValues.set(valueStr, []);
+                            }
+                            stateValues.get(valueStr).push({ accountId: account.id, index });
+                        }
+                    });
+                }
+            });
+            // Create relationships for accounts that share state values
+            stateValues.forEach((appearances, value) => {
+                if (appearances.length > 1) {
+                    // Sort by account index to get chronological order
+                    appearances.sort((a, b) => {
+                        const accountA = accounts.find(acc => acc.id === a.accountId);
+                        const accountB = accounts.find(acc => acc.id === b.accountId);
+                        return accountA.index - accountB.index;
+                    });
+                    // Create edges between consecutive appearances
+                    for (let i = 0; i < appearances.length - 1; i++) {
+                        relationships.push({
+                            from: appearances[i].accountId,
+                            to: appearances[i + 1].accountId,
+                            type: 'state_dependency',
+                            label: 'state dep',
+                            color: 'black'
+                        });
+                    }
+                }
+            });
+            return relationships;
+        };
+        this.buildTokenRelationships = (accounts) => {
+            const relationships = [];
+            const defaultTokenId = 'wSHV2S4qX9jFsLjQo8r1BsMLH2ZRKsZx6EJd1sbozGPieEC4Jf'; // Mina default token
+            // Group accounts by token ID
+            const accountsByToken = new Map();
+            accounts.forEach(account => {
+                if (!accountsByToken.has(account.tokenId)) {
+                    accountsByToken.set(account.tokenId, []);
+                }
+                accountsByToken.get(account.tokenId).push(account);
+            });
+            // Create relationships for non-default tokens
+            accountsByToken.forEach((tokenAccounts, tokenId) => {
+                if (tokenId !== defaultTokenId && tokenAccounts.length > 1) {
+                    // Sort by account index
+                    tokenAccounts.sort((a, b) => a.index - b.index);
+                    // Create a chain of token operations
+                    for (let i = 0; i < tokenAccounts.length - 1; i++) {
+                        relationships.push({
+                            from: tokenAccounts[i].id,
+                            to: tokenAccounts[i + 1].id,
+                            type: 'token_operation',
+                            label: 'token op',
+                            color: 'purple'
+                        });
+                    }
+                }
+            });
+            return relationships;
+        };
+        this.buildFeepayerRelationships = (accounts, feePayerAddress) => {
+            const relationships = [];
+            const feePayer = accounts.find(account => account.address === feePayerAddress);
+            if (!feePayer)
+                return relationships;
+            // Connect fee payer to the first non-fee-payer account update
+            const firstOp = accounts.find(account => account.address !== feePayerAddress);
+            if (firstOp) {
+                relationships.push({
+                    from: feePayer.id,
+                    to: firstOp.id,
+                    type: 'fee_payer',
+                    label: 'initiates',
+                    color: 'green'
+                });
+            }
+            return relationships;
+        };
+        this.buildCallDataRelationships = (accounts) => {
+            const relationships = [];
+            accounts.forEach((account, i) => {
+                if (account.callData) {
+                    // Connect to next account in sequence as a heuristic
+                    // More sophisticated matching could be done based on actual callData analysis
+                    if (i < accounts.length - 1) {
+                        relationships.push({
+                            from: account.id,
+                            to: accounts[i + 1].id,
+                            type: 'call_data',
+                            label: 'calls (data)',
+                            color: 'orange'
+                        });
+                    }
+                }
+            });
+            return relationships;
+        };
+        this.buildTemporalRelationships = (accounts) => {
+            const relationships = [];
+            for (let i = 0; i < accounts.length - 1; i++) {
+                relationships.push({
+                    from: accounts[i].id,
+                    to: accounts[i + 1].id,
+                    type: 'sequence',
+                    label: 'sequence',
+                    color: 'gray'
+                });
+            }
+            return relationships;
+        };
+        this.mergeRelationships = (relationshipSets) => {
+            const merged = [];
+            const edgeMap = new Map();
+            // Process each set of relationships in priority order
+            relationshipSets.forEach(relationships => {
+                relationships.forEach(rel => {
+                    const edgeKey = `${rel.from}-${rel.to}`;
+                    if (!edgeMap.has(edgeKey)) {
+                        edgeMap.set(edgeKey, true);
+                        merged.push(rel);
+                    }
+                });
+            });
+            return merged;
+        };
+        this.applyFailureStatus = (relationships, accounts) => {
+            return relationships.map(rel => {
+                const fromAccount = accounts.find(acc => acc.id === rel.from);
+                const toAccount = accounts.find(acc => acc.id === rel.to);
+                if ((fromAccount && fromAccount.failed) || (toAccount && toAccount.failed)) {
+                    return {
+                        ...rel,
+                        failed: true,
+                        style: 'dashed'
+                    };
+                }
+                return rel;
+            });
+        };
+        this.extractTokenSymbol = (account) => {
+            if (account.update?.tokenSymbol) {
+                return account.update.tokenSymbol;
+            }
+            // Default Mina token
+            if (account.tokenId === 'wSHV2S4qX9jFsLjQo8r1BsMLH2ZRKsZx6EJd1sbozGPieEC4Jf') {
+                return 'MINA';
+            }
+            return 'Custom';
+        };
+        this.extractStateValues = (appState) => {
+            if (!appState || !Array.isArray(appState)) {
+                return [];
+            }
+            return appState.map(state => state ? state.toString() : '0');
+        };
+        this.enhanceTransactionState = (txState, blockchainTx) => {
+            // Only proceed if this is a blockchain transaction
+            if (!blockchainTx || !blockchainTx.txHash) {
+                return txState; // Return unchanged if not a blockchain transaction
+            }
+            // Generate flow graph
+            const flowGraph = this.analyzeTransactionFlow(blockchainTx);
+            // Create a new transaction state with the original data plus flow graph
+            return {
+                ...txState,
+                blockchainData: {
+                    ...(txState.blockchainData || {}),
+                    flowGraph: flowGraph
+                }
+            };
+        };
+    }
+}
+//# sourceMappingURL=BlockchainFlowAnalyzer.js.map

package/build/src/BlockchainFlowAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockchainFlowAnalyzer.js","sourceRoot":"","sources":["../../src/BlockchainFlowAnalyzer.ts"],"names":[],"mappings":"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"}

package/build/src/Interface.d.ts

@@ -32,6 +32,11 @@ interface TransactionNode {
     contractType?: string;
     features?: Record<string, any>;
     contractMetadata?: ContractMetadata;
+    failed?: boolean;
+    failureReason?: string;
+    tokenId?: string;
+    callDepth?: number;
+    balanceChange?: number;
 }
 interface TransactionState {
     nodes: Map<string, TransactionNode>;
@@ -44,6 +49,7 @@ interface TransactionState {
         accountUpdates: number;
     };
     relationships: Map<string, AccountUpdateRelationship>;
+    blockchainData?: BlockchainData;
 }
 interface Edge {
     id: string;
@@ -59,6 +65,8 @@ interface Edge {
         };
         fee?: string;
     };
+    failed?: boolean;
+    failureReason?: string;
 }
 interface AUMetadata {
     id: string;
@@ -68,6 +76,9 @@ interface AUMetadata {
     balanceChange: string;
     methodName?: string;
     args?: any[];
+    failed?: boolean;
+    tokenId?: string;
+    callDepth?: number;
 }
 type AccountType = 'account' | 'contract';
 interface ContractMetadata {
@@ -148,6 +159,9 @@ interface AccountUpdateRelationship {
         field: string;
         value: any;
     }[];
+    tokenId?: string;
+    failed?: boolean;
+    failureReason?: string;
 }
 interface PlainRelationshipMap {
     [key: string]: AccountUpdateRelationship;
@@ -169,4 +183,56 @@ interface FlowOperation {
     status?: string;
     parameters?: Record<string, string>;
 }
-export { TreeSnapshot, EntityInfo, FlowOperation, PlainRelationshipMap, AccountUpdateRelationship, TreeOperation, ContractAnalysis, ChangeLog, ContractMethod, MethodAccountUpdate, AUMetadata, Edge, TransactionNode, TransactionState, AccountType, ContractMetadata, MethodAnalysis, EnhancedTransactionState, ParsedAccountUpdate };
+interface BlockchainData {
+    blockHeight?: number;
+    txHash?: string;
+    timestamp?: number;
+    memo?: string;
+    status?: string;
+    failures?: Array<{
+        index: number;
+        failureReason: string;
+    }>;
+    flowGraph?: TransactionFlowGraph;
+    feePayerAddress?: string;
+}
+interface ProcessedAccount {
+    id: string;
+    index: number;
+    address: string;
+    shortAddress: string;
+    isContract: boolean;
+    callDepth: number;
+    tokenId: string;
+    tokenSymbol: string;
+    balanceChange: number;
+    failed: boolean;
+    failureReason: string | null;
+    isRootFailure?: boolean;
+    stateValues: string[];
+    callData: string | null;
+    permissions: any;
+}
+interface Relationship {
+    from: string;
+    to: string;
+    type: string;
+    label: string;
+    color: string;
+    failed?: boolean;
+    style?: string;
+}
+interface TransactionFlowGraph {
+    metadata: {
+        txHash: string;
+        status: string;
+        blockHeight: number;
+        timestamp: number;
+        fee: number;
+        feePayerAddress: string;
+        memo: string;
+    };
+    nodes: ProcessedAccount[];
+    edges: Relationship[];
+}
+export { Relationship, ProcessedAccount, TransactionFlowGraph, TreeSnapshot, BlockchainData, EntityInfo, FlowOperation, PlainRelationshipMap, AccountUpdateRelationship, TreeOperation, ContractAnalysis, ChangeLog, ContractMethod, MethodAccountUpdate, AUMetadata, Edge, TransactionNode, TransactionState, AccountType, ContractMetadata, MethodAnalysis, EnhancedTransactionState, ParsedAccountUpdate };

package/build/src/Visualiser.d.ts

@@ -1,3 +1,4 @@
+import { TransactionState } from './Interface.js';
 export declare class AUVisualizer {
     private stateHistory;
     private entities;
@@ -23,4 +24,17 @@ export declare class AUVisualizer {
     generateSVG(outputPath?: string): Promise<void>;
     generatePNG(outputPath?: string): Promise<void>;
     generateMarkdownFile(outputPath?: string): Promise<void>;
+    private generateBlockchainSection;
+    generateBlockchainMarkdown(txState: TransactionState): string;
+    private buildEdgesIfMissing;
+    private findFeePayer;
+    private groupNodesByToken;
+    private generateBlockchainFlowSVG;
+    private convertSvgToPngWithSharp;
+    generateBlockchainFlowWithPng: (txState: TransactionState, svgPath?: string, pngPath?: string) => Promise<{
+        svgPath: string;
+        pngPath: string;
+    }>;
+    generateBlockchainVisualization(txState: TransactionState, outputFormat?: 'svg' | 'png' | 'md', outputPath?: string): Promise<string>;
+    generateTransactionVisualization: (txState: TransactionState, outputFormat?: "svg" | "png", outputPath?: string) => Promise<void>;
 }