autrace 0.0.5 → 0.0.6

package/README.md

@@ -102,6 +102,16 @@ const summary = asciiVisuals.visualizeChangeSummary(snapshots);
 console.log(summary);
 ```
 
+### Visualising onchain transactions
+
+Visualize any zkapp transaction from the chain like so
+
+```bash
+BLOCKBERRY_API_KEY=your_api_key npx aucli --tx 5JttgfFUzZXfYYksdbZHms7eDvqwvzvf65GuirsAcNaZpFC5BC5z
+```
+This will generate a `transaction_visualization.png` with the visulaisation.
+
+
 ### Important Notes
 
 - This package uses ES modules. Ensure your project's package.json has `"type": "module"`.

package/build/src/AccountUpdateAnalyzer.d.ts

@@ -4,14 +4,19 @@ export declare class AccountUpdateAnalyzer {
     private auRelationships;
     private currentDepth;
     private parentStack;
+    private tokenMap;
     constructor();
+    reset(): void;
     processAccountUpdate(au: AccountUpdate): void;
     private extractMethodInfo;
     private extractStateChanges;
+    private processTokenRelationships;
     getRelationships(): Map<string, AccountUpdateRelationship>;
     getHierarchicalView(): {
         id: string;
         label: string;
         children: any[];
+        tokenId?: string;
+        failed?: boolean;
     }[];
 }

package/build/src/AccountUpdateAnalyzer.js

@@ -2,11 +2,34 @@ export class AccountUpdateAnalyzer {
     constructor() {
         this.currentDepth = 0;
         this.parentStack = []; // Stack to track parent AUs
+        this.tokenMap = new Map();
         this.auRelationships = new Map();
+        this.tokenMap = new Map();
+    }
+    reset() {
+        this.auRelationships = new Map();
+        this.currentDepth = 0;
+        this.parentStack = [];
+        this.tokenMap = new Map();
     }
     processAccountUpdate(au) {
         const auId = au.id.toString();
-        const callDepth = au.body.callDepth || 0;
+        //const callDepth = au.body.callDepth || 0;
+        let callDepth = 0;
+        if (au.metadata?.callDepth !== undefined) {
+            callDepth = au.metadata.callDepth;
+        }
+        else if (au.body.callDepth !== undefined) {
+            callDepth = au.body.callDepth;
+        }
+        // Extract failure information if present
+        const failed = au.metadata?.failed || false;
+        const failureReason = au.metadata?.failureReason;
+        const tokenId = au.metadata?.tokenId || au.body.tokenId || 'default';
+        if (!this.tokenMap.has(tokenId)) {
+            this.tokenMap.set(tokenId, []);
+        }
+        this.tokenMap.get(tokenId).push(auId);
         // Manage parent stack based on call depth
         while (this.currentDepth >= callDepth && this.parentStack.length > 0) {
             this.parentStack.pop();
@@ -14,15 +37,23 @@ export class AccountUpdateAnalyzer {
         }
         const parentId = this.parentStack.length > 0 ? this.parentStack[this.parentStack.length - 1] : undefined;
         const methodInfo = this.extractMethodInfo(au);
+        // Get label, handle failure info
+        let label = au.label || 'Unnamed Update';
+        if (failed) {
+            label = `[FAILED] ${label}`;
+        }
         // Create relationship entry
         const relationship = {
             id: auId,
-            label: au.label || 'Unnamed Update',
+            label: label,
             parentId,
             children: [],
             depth: callDepth,
             method: this.extractMethodInfo(au),
-            stateChanges: this.extractStateChanges(au)
+            stateChanges: this.extractStateChanges(au),
+            tokenId: tokenId,
+            failed: failed,
+            failureReason: failureReason
         };
         // Update parent's children array
         if (parentId) {
@@ -33,10 +64,19 @@ export class AccountUpdateAnalyzer {
         }
         this.auRelationships.set(auId, relationship);
         // Update stack for next iterations
-        this.parentStack.push(auId);
-        this.currentDepth = callDepth;
+        if (!failed) { // Only use non-failed operations as potential parents
+            this.parentStack.push(auId);
+            this.currentDepth = callDepth;
+        }
     }
     extractMethodInfo(au) {
+        // First check blockchain format
+        if (au.lazyAuthorization?.methodName) {
+            return {
+                contract: au.label || 'Unknown',
+                name: au.lazyAuthorization.methodName
+            };
+        }
         if (!au.label)
             return undefined;
         const parts = au.label.split('.');
@@ -49,6 +89,13 @@ export class AccountUpdateAnalyzer {
         return undefined;
     }
     extractStateChanges(au) {
+        // Check blockchain format first
+        if (au.metadata?.stateUpdates) {
+            return au.metadata.stateUpdates.map((update) => ({
+                field: update.type || 'unknown',
+                value: update.value
+            }));
+        }
         const changes = [];
         if (au.body?.update?.appState) {
             au.body.update.appState.forEach((state, index) => {
@@ -62,10 +109,42 @@ export class AccountUpdateAnalyzer {
         }
         return changes.length > 0 ? changes : undefined;
     }
+    processTokenRelationships() {
+        // For each token, identify operations that should be related
+        for (const [tokenId, operations] of this.tokenMap.entries()) {
+            if (operations.length <= 1)
+                continue;
+            // Find operations without parents that can be related
+            const orphans = operations.filter(id => {
+                const rel = this.auRelationships.get(id);
+                return rel && !rel.parentId && !rel.failed;
+            });
+            if (orphans.length <= 1)
+                continue;
+            // Use first operation as a root for others
+            const rootId = orphans[0];
+            if (!rootId)
+                continue;
+            const rootRel = this.auRelationships.get(rootId);
+            if (!rootRel)
+                continue;
+            // Connect other orphans to the root
+            for (let i = 1; i < orphans.length; i++) {
+                const orphanId = orphans[i];
+                const orphanRel = this.auRelationships.get(orphanId);
+                if (orphanRel && !orphanRel.parentId) {
+                    orphanRel.parentId = rootId;
+                    rootRel.children.push(orphanId);
+                }
+            }
+        }
+    }
     getRelationships() {
+        this.processTokenRelationships();
         return this.auRelationships;
     }
     getHierarchicalView() {
+        this.processTokenRelationships();
         // Get root level AUs (those without parents)
         const roots = Array.from(this.auRelationships.values())
             .filter(r => !r.parentId);
@@ -76,6 +155,9 @@ export class AccountUpdateAnalyzer {
                 label: auRelationship.label,
                 method: auRelationship.method,
                 stateChanges: auRelationship.stateChanges,
+                tokenId: auRelationship.tokenId,
+                failed: auRelationship.failed,
+                failureReason: auRelationship.failureReason,
                 children: auRelationship.children.map(childId => {
                     const child = this.auRelationships.get(childId);
                     return child ? buildTree(child) : null;

package/build/src/AccountUpdateAnalyzer.js.map

@@ -1 +1 @@
-{"version":3,"file":"AccountUpdateAnalyzer.js","sourceRoot":"","sources":["../../src/AccountUpdateAnalyzer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AccountUpdateAnalyzer.js","sourceRoot":"","sources":["../../src/AccountUpdateAnalyzer.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,qBAAqB;IAM9B;QAJQ,iBAAY,GAAW,CAAC,CAAC;QACzB,gBAAW,GAAa,EAAE,CAAC,CAAE,4BAA4B;QACzD,aAAQ,GAA0B,IAAI,GAAG,EAAE,CAAC;QAGhD,IAAI,CAAC,eAAe,GAAG,IAAI,GAAG,EAAE,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;IAC9B,CAAC;IAEM,KAAK;QACR,IAAI,CAAC,eAAe,GAAG,IAAI,GAAG,EAAE,CAAC;QACjC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;IAC9B,CAAC;IAEM,oBAAoB,CAAC,EAAiB;QACzC,MAAM,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC;QAC9B,2CAA2C;QAC3C,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAK,EAAU,CAAC,QAAQ,EAAE,SAAS,KAAK,SAAS,EAAE,CAAC;YAChD,SAAS,GAAI,EAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC/C,CAAC;aAAM,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACzC,SAAS,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC;QAClC,CAAC;QAED,yCAAyC;QACzC,MAAM,MAAM,GAAI,EAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,CAAC;QACrD,MAAM,aAAa,GAAI,EAAU,CAAC,QAAQ,EAAE,aAAa,CAAC;QAE1D,MAAM,OAAO,GAAI,EAAU,CAAC,QAAQ,EAAE,OAAO,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,SAAS,CAAC;QAE9E,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEvC,0CAA0C;QAC1C,OAAO,IAAI,CAAC,YAAY,IAAI,SAAS,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnE,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;YACvB,IAAI,CAAC,YAAY,EAAE,CAAC;QACxB,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACzG,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAA;QAE7C,iCAAiC;QACjC,IAAI,KAAK,GAAG,EAAE,CAAC,KAAK,IAAI,gBAAgB,CAAC;QACzC,IAAI,MAAM,EAAE,CAAC;YACT,KAAK,GAAG,YAAY,KAAK,EAAE,CAAC;QAChC,CAAC;QAED,4BAA4B;QAC5B,MAAM,YAAY,GAA8B;YAC5C,EAAE,EAAE,IAAI;YACR,KAAK,EAAE,KAAK;YACZ,QAAQ;YACR,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAClC,YAAY,EAAE,IAAI,CAAC,mBAAmB,CAAC,EAAE,CAAC;YAC1C,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,MAAM;YACd,aAAa,EAAE,aAAa;SAC/B,CAAC;QAEF,iCAAiC;QACjC,IAAI,QAAQ,EAAE,CAAC;YACX,MAAM,kBAAkB,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC9D,IAAI,kBAAkB,EAAE,CAAC;gBACrB,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3C,CAAC;QACL,CAAC;QAED,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAE7C,mCAAmC;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAE,sDAAsD;YAClE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAClC,CAAC;IACL,CAAC;IAEO,iBAAiB,CAAC,EAAiB;QACvC,gCAAgC;QAChC,IAAK,EAAU,CAAC,iBAAiB,EAAE,UAAU,EAAE,CAAC;YAC5C,OAAO;gBACH,QAAQ,EAAE,EAAE,CAAC,KAAK,IAAI,SAAS;gBAC/B,IAAI,EAAG,EAAU,CAAC,iBAAiB,CAAC,UAAU;aACjD,CAAC;QACN,CAAC;QAED,IAAI,CAAC,EAAE,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAEhC,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACpB,OAAO;gBACH,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAE;gBACnB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;aACpC,CAAC;QACN,CAAC;QACD,OAAO,SAAS,CAAC;IACrB,CAAC;IAEO,mBAAmB,CAAC,EAAiB;QACzC,gCAAgC;QAChC,IAAK,EAAU,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC;YACrC,OAAQ,EAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,MAAW,EAAE,EAAE,CAAC,CAAC;gBAC3D,KAAK,EAAE,MAAM,CAAC,IAAI,IAAI,SAAS;gBAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;aACtB,CAAC,CAAC,CAAC;QACR,CAAC;QAED,MAAM,OAAO,GAAQ,EAAE,CAAC;QAExB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YAC5B,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;gBAC7C,IAAI,KAAK,EAAE,CAAC;oBACR,OAAO,CAAC,IAAI,CAAC;wBACT,KAAK,EAAE,YAAY,KAAK,GAAG;wBAC3B,KAAK,EAAE,KAAK;qBACf,CAAC,CAAC;gBACP,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC;QAED,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACpD,CAAC;IAEO,yBAAyB;QAC7B,6DAA6D;QAC7D,KAAK,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1D,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC;gBAAE,SAAS;YAErC,sDAAsD;YACtD,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;gBACnC,MAAM,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACzC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;YAC/C,CAAC,CAAC,CAAC;YAEH,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC;gBAAE,SAAS;YAElC,2CAA2C;YAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,CAAC,MAAM;gBAAE,SAAS;YAEtB,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACjD,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,oCAAoC;YACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;gBAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAErD,IAAI,SAAS,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;oBACnC,SAAS,CAAC,QAAQ,GAAG,MAAM,CAAC;oBAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACpC,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IAEM,gBAAgB;QACnB,IAAI,CAAC,yBAAyB,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,eAAe,CAAC;IAChC,CAAC;IAEM,mBAAmB;QAOtB,IAAI,CAAC,yBAAyB,EAAE,CAAC;QAEjC,6CAA6C;QAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC;aAClD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAE9B,yBAAyB;QACzB,MAAM,SAAS,GAAQ,CAAC,cAAyC,EAAE,EAAE;YACjE,OAAO;gBACH,EAAE,EAAE,cAAc,CAAC,EAAE;gBACrB,KAAK,EAAE,cAAc,CAAC,KAAK;gBAC3B,MAAM,EAAE,cAAc,CAAC,MAAM;gBAC7B,YAAY,EAAE,cAAc,CAAC,YAAY;gBACzC,OAAO,EAAE,cAAc,CAAC,OAAO;gBAC/B,MAAM,EAAE,cAAc,CAAC,MAAM;gBAC7B,aAAa,EAAE,cAAc,CAAC,aAAa;gBAC3C,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;oBAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBAChD,OAAO,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBAC3C,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;aACpB,CAAC;QACN,CAAC,CAAC;QAEF,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,CAAC;CAEJ"}

package/build/src/BlockchainAdapter.d.ts

@@ -0,0 +1 @@
+export declare const adaptBlockchainTransaction: (blockchainTx: any) => any;

package/build/src/BlockchainAdapter.js

@@ -0,0 +1,184 @@
+export const adaptBlockchainTransaction = (blockchainTx) => {
+    // If the transaction is already in the expected format, return it as is
+    if (blockchainTx?.transaction?.accountUpdates) {
+        return blockchainTx;
+    }
+    const accountUpdates = [];
+    if (blockchainTx.updatedAccounts && Array.isArray(blockchainTx.updatedAccounts)) {
+        blockchainTx.updatedAccounts.forEach((account, index) => {
+            // Create an account update object similar to what o1js would generate
+            const accountUpdate = createAUFromBlockchainData(account, index, blockchainTx);
+            accountUpdates.push(accountUpdate);
+        });
+    }
+    return {
+        transaction: {
+            accountUpdates,
+            hash: blockchainTx.txHash,
+            blockHeight: blockchainTx.blockHeight,
+            memo: blockchainTx.memo || '',
+            status: blockchainTx.txStatus,
+            failures: blockchainTx.failures || []
+        },
+        originalBlockchainData: blockchainTx // Keep the original data for reference
+    };
+};
+const createAUFromBlockchainData = (account, index, tx) => {
+    // Check if this update failed
+    const isFailedUpdate = tx.failures && tx.failures.some((f) => f.index === index);
+    const failureReason = isFailedUpdate
+        ? tx.failures.find((f) => f.index === index)?.failureReason
+        : undefined;
+    const isProof = account.update?.permissions?.editState === 'proof' ||
+        account.update?.permissions?.send === 'proof';
+    const isSignature = account.update?.permissions?.incrementNonce === 'signature' ||
+        account.update?.permissions?.setDelegate === 'signature';
+    // Generate unique ID similar to what o1js would use
+    const id = `${tx.txHash}-${index}`;
+    // Determine if this is a contract
+    const isContract = account.isZkappAccount ||
+        account.update?.verificationKey !== null ||
+        isProof;
+    // Create a label for the account update
+    let label = isContract ? `Contract-${account.accountAddress.substring(0, 8)}` :
+        `Account-${account.accountAddress.substring(0, 8)}`;
+    // Add status to label if failed
+    if (isFailedUpdate) {
+        label = `[FAILED] ${label}`;
+    }
+    // Create authorization based on permissions
+    const authorization = {};
+    if (isProof) {
+        authorization.proof = true;
+    }
+    else if (isSignature) {
+        authorization.signature = true;
+    }
+    // Extract and process state updates
+    const stateUpdates = extractStateUpdates(account.update);
+    // Create balance change info
+    const balanceChange = account.totalBalanceChange || 0;
+    const isNegative = balanceChange < 0;
+    return {
+        id,
+        label,
+        lazyAuthorization: {
+            kind: isProof ? 'lazy-proof' : isSignature ? 'lazy-signature' : 'none',
+            methodName: account.callData && account.callData !== '0' ? 'methodCall' : undefined,
+            args: account.callData && account.callData !== '0' ? [account.callData] : undefined
+        },
+        authorization,
+        body: {
+            publicKey: {
+                toBase58: () => account.accountAddress
+            },
+            balanceChange: {
+                magnitude: Math.abs(balanceChange).toString(),
+                isNegative: () => isNegative,
+                toString: () => (isNegative ? '-' : '') + Math.abs(balanceChange).toString()
+            },
+            update: {
+                appState: extractAppState(account.update),
+                verificationKey: {
+                    value: {
+                        hash: account.verificationKeyHash,
+                        data: account.update?.verificationKey
+                    }
+                },
+                permissions: {
+                    value: mapPermissions(account.update?.permissions)
+                }
+            }
+        },
+        // Additional metadata for blockchain-specific information
+        metadata: {
+            callDepth: account.callDepth || 0,
+            tokenId: account.tokenId,
+            isZkappAccount: account.isZkappAccount,
+            incrementNonce: account.incrementNonce,
+            failed: isFailedUpdate,
+            failureReason: failureReason,
+            stateUpdates: stateUpdates
+        }
+    };
+};
+const extractAppState = (update) => {
+    if (!update || !update.appState || !Array.isArray(update.appState)) {
+        return [];
+    }
+    return update.appState.map((state) => state || '0');
+};
+const extractStateUpdates = (update) => {
+    if (!update)
+        return [];
+    const stateUpdates = [];
+    // Check appState
+    if (update.appState && Array.isArray(update.appState)) {
+        stateUpdates.push({
+            type: 'appState',
+            value: update.appState
+        });
+    }
+    // Check for delegate changes
+    if (update.delegatee) {
+        stateUpdates.push({
+            type: 'delegate',
+            value: update.delegatee
+        });
+    }
+    // Check for timing changes
+    if (update.timing) {
+        stateUpdates.push({
+            type: 'timing',
+            value: update.timing
+        });
+    }
+    // Check for token symbol changes
+    if (update.tokenSymbol) {
+        stateUpdates.push({
+            type: 'tokenSymbol',
+            value: update.tokenSymbol
+        });
+    }
+    // Check for other updates like votingFor or zkappUri
+    if (update.votingFor) {
+        stateUpdates.push({
+            type: 'votingFor',
+            value: update.votingFor
+        });
+    }
+    if (update.zkappUri) {
+        stateUpdates.push({
+            type: 'zkappUri',
+            value: update.zkappUri
+        });
+    }
+    return stateUpdates;
+};
+const mapPermissions = (permissions) => {
+    if (!permissions)
+        return {};
+    const createPermission = (type) => {
+        const isProof = permissions[type] === 'proof';
+        const isSignature = permissions[type] === 'signature';
+        return {
+            constant: { toBoolean: () => permissions[type] === 'none' },
+            signatureNecessary: { toBoolean: () => isSignature },
+            signatureSufficient: { toBoolean: () => isSignature },
+            proof: { toBoolean: () => isProof }
+        };
+    };
+    const permissionTypes = [
+        'editState', 'send', 'receive', 'setDelegate', 'setPermissions',
+        'setVerificationKey', 'setZkappUri', 'editActionState', 'setTokenSymbol',
+        'incrementNonce', 'setVotingFor', 'setTiming'
+    ];
+    const mappedPermissions = {};
+    permissionTypes.forEach(type => {
+        if (permissions[type] !== undefined) {
+            mappedPermissions[type] = createPermission(type);
+        }
+    });
+    return mappedPermissions;
+};
+//# sourceMappingURL=BlockchainAdapter.js.map

package/build/src/BlockchainAdapter.js.map

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

package/build/src/BlockchainFlowAnalyzer.d.ts

@@ -0,0 +1,17 @@
+import { TransactionState, TransactionFlowGraph } from './Interface.js';
+export declare class BlockchainFlowAnalyzer {
+    analyzeTransactionFlow: (blockchainTx: any) => TransactionFlowGraph;
+    private processAccountUpdates;
+    private mapFailureInfo;
+    private buildCallDepthRelationships;
+    private buildStateDepRelationships;
+    private buildTokenRelationships;
+    private buildFeepayerRelationships;
+    private buildCallDataRelationships;
+    private buildTemporalRelationships;
+    private mergeRelationships;
+    private applyFailureStatus;
+    private extractTokenSymbol;
+    private extractStateValues;
+    enhanceTransactionState: (txState: TransactionState, blockchainTx: any) => TransactionState;
+}