@o1-labs/mina-archive-node-graphql 0.0.6

package/build/tests/unit/blockchain-utils.test.js

@@ -0,0 +1,106 @@
+import { describe, test } from 'node:test';
+import assert from 'node:assert';
+import { createBlockInfo, createTransactionInfo, createEvent, createAction, } from '../../src/blockchain/utils.js';
+const baseRow = {
+    state_hash: 'state_hash_abc',
+    parent_hash: 'parent_hash_xyz',
+    height: '42',
+    global_slot_since_genesis: '100',
+    global_slot_since_hard_fork: '50',
+    authorization_kind: 'Proof',
+    timestamp: '1700000000000',
+    chain_status: 'canonical',
+    sequence_number: 3,
+    ledger_hash: 'ledger_hash_def',
+    distance_from_max_block_height: '10',
+    zkapp_account_updates_ids: [7, 8, 9],
+    status: 'applied',
+    memo: 'E4YM2vTHhWEg66xpj52JErHUBU4pZ1yageL4TVDDpTTSsv8mK6YaH',
+    hash: 'CkpZZMFyrBAnKidFoHxLiGbfeKKTFVFNJRhS3y3UUc5rVaoEMi8sZ',
+    last_vrf_output: 'AABBCCDD',
+};
+describe('Blockchain Utils', () => {
+    describe('createBlockInfo', () => {
+        test('maps all database row fields to BlockInfo', () => {
+            const result = createBlockInfo(baseRow);
+            assert.strictEqual(result.height, 42);
+            assert.strictEqual(result.stateHash, 'state_hash_abc');
+            assert.strictEqual(result.parentHash, 'parent_hash_xyz');
+            assert.strictEqual(result.ledgerHash, 'ledger_hash_def');
+            assert.strictEqual(result.chainStatus, 'canonical');
+            assert.strictEqual(result.timestamp, '1700000000000');
+            assert.strictEqual(result.globalSlotSinceHardfork, 50);
+            assert.strictEqual(result.globalSlotSinceGenesis, 100);
+            assert.strictEqual(result.distanceFromMaxBlockHeight, 10);
+            assert.strictEqual(result.lastVrfOutput, 'AABBCCDD');
+        });
+        test('converts string height to number', () => {
+            const row = { ...baseRow, height: '99999' };
+            assert.strictEqual(createBlockInfo(row).height, 99999);
+        });
+        test('handles zero height', () => {
+            const row = { ...baseRow, height: '0' };
+            assert.strictEqual(createBlockInfo(row).height, 0);
+        });
+    });
+    describe('createTransactionInfo', () => {
+        test('maps all database row fields to TransactionInfo', () => {
+            const result = createTransactionInfo(baseRow);
+            assert.strictEqual(result.status, 'applied');
+            assert.strictEqual(result.hash, 'CkpZZMFyrBAnKidFoHxLiGbfeKKTFVFNJRhS3y3UUc5rVaoEMi8sZ');
+            assert.strictEqual(result.memo, 'E4YM2vTHhWEg66xpj52JErHUBU4pZ1yageL4TVDDpTTSsv8mK6YaH');
+            assert.strictEqual(result.authorizationKind, 'Proof');
+            assert.strictEqual(result.sequenceNumber, 3);
+            assert.deepStrictEqual(result.zkappAccountUpdateIds, [7, 8, 9]);
+        });
+        test('preserves sequence_number as number', () => {
+            const row = { ...baseRow, sequence_number: 0 };
+            assert.strictEqual(createTransactionInfo(row).sequenceNumber, 0);
+        });
+    });
+    describe('createEvent', () => {
+        test('creates event with all properties', () => {
+            const txInfo = {
+                status: 'applied',
+                hash: 'tx_hash',
+                memo: 'memo',
+                authorizationKind: 'Proof',
+                sequenceNumber: 1,
+                zkappAccountUpdateIds: [1],
+            };
+            const event = createEvent('42', ['field1', 'field2'], txInfo);
+            assert.strictEqual(event.accountUpdateId, '42');
+            assert.deepStrictEqual(event.data, ['field1', 'field2']);
+            assert.strictEqual(event.transactionInfo, txInfo);
+        });
+        test('creates event with empty data', () => {
+            const txInfo = {
+                status: 'applied',
+                hash: 'h',
+                memo: '',
+                authorizationKind: 'None_given',
+                sequenceNumber: 0,
+                zkappAccountUpdateIds: [],
+            };
+            const event = createEvent('1', [], txInfo);
+            assert.deepStrictEqual(event.data, []);
+        });
+    });
+    describe('createAction', () => {
+        test('creates action with all properties', () => {
+            const txInfo = {
+                status: 'applied',
+                hash: 'tx_hash',
+                memo: 'memo',
+                authorizationKind: 'Signature',
+                sequenceNumber: 2,
+                zkappAccountUpdateIds: [10, 11],
+            };
+            const action = createAction('99', ['val1'], txInfo);
+            assert.strictEqual(action.accountUpdateId, '99');
+            assert.deepStrictEqual(action.data, ['val1']);
+            assert.strictEqual(action.transactionInfo, txInfo);
+        });
+    });
+});
+//# sourceMappingURL=blockchain-utils.test.js.map

package/build/tests/unit/blockchain-utils.test.js.map

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

package/build/tests/unit/consensus.test.js

@@ -0,0 +1,154 @@
+import { describe, test } from 'node:test';
+import assert from 'node:assert';
+import { select, getAllPredicate, filterBestTip, } from '../../src/consensus/mina-consensus.js';
+function makeBlockInfo(overrides = {}) {
+    return {
+        height: 100,
+        stateHash: 'default_state_hash',
+        parentHash: 'default_parent_hash',
+        ledgerHash: 'default_ledger_hash',
+        chainStatus: 'canonical',
+        timestamp: '1700000000000',
+        globalSlotSinceHardfork: 100,
+        globalSlotSinceGenesis: 100,
+        distanceFromMaxBlockHeight: 0,
+        lastVrfOutput: 'AABBCCDD',
+        ...overrides,
+    };
+}
+function makeEntry(blockInfo) {
+    return { blockInfo, data: [] };
+}
+describe('Mina Consensus', () => {
+    describe('getAllPredicate', () => {
+        test('returns all elements matching predicate', () => {
+            const arr = [1, 2, 3, 4, 5];
+            const result = getAllPredicate(arr, (x) => x > 3);
+            assert.deepStrictEqual(result, [4, 5]);
+        });
+        test('returns empty array when nothing matches', () => {
+            const arr = [1, 2, 3];
+            const result = getAllPredicate(arr, (x) => x > 10);
+            assert.deepStrictEqual(result, []);
+        });
+        test('returns all elements when everything matches', () => {
+            const arr = [1, 2, 3];
+            const result = getAllPredicate(arr, () => true);
+            assert.deepStrictEqual(result, [1, 2, 3]);
+        });
+        test('handles empty array', () => {
+            const result = getAllPredicate([], () => true);
+            assert.deepStrictEqual(result, []);
+        });
+    });
+    describe('select', () => {
+        test('selects candidate when existing state hash is smaller', () => {
+            const existing = makeEntry(makeBlockInfo({ stateHash: 'aaa', lastVrfOutput: 'AA', height: 100 }));
+            const candidate = makeEntry(makeBlockInfo({ stateHash: 'zzz', lastVrfOutput: 'AA', height: 100 }));
+            const result = select(existing, candidate);
+            assert.strictEqual(result, candidate);
+        });
+        test('deterministically selects one of two blocks', () => {
+            const a = makeEntry(makeBlockInfo({
+                stateHash: '3NKabc',
+                lastVrfOutput: '1122334455',
+                height: 100,
+            }));
+            const b = makeEntry(makeBlockInfo({
+                stateHash: '3NKxyz',
+                lastVrfOutput: '5566778899',
+                height: 100,
+            }));
+            const result1 = select(a, b);
+            const result2 = select(a, b);
+            assert.strictEqual(result1, result2);
+        });
+        test('prefers longer chain when VRF and hash are equal', () => {
+            const shorter = makeEntry(makeBlockInfo({
+                stateHash: 'same_hash',
+                lastVrfOutput: 'AABB',
+                height: 100,
+            }));
+            const longer = makeEntry(makeBlockInfo({
+                stateHash: 'same_hash',
+                lastVrfOutput: 'AABB',
+                height: 200,
+            }));
+            const result = select(shorter, longer);
+            assert.strictEqual(result.blockInfo.height, 200);
+        });
+    });
+    describe('filterBestTip', () => {
+        test('does nothing when no blocks at distance 0', () => {
+            const data = [
+                makeEntry(makeBlockInfo({ distanceFromMaxBlockHeight: 1 })),
+                makeEntry(makeBlockInfo({ distanceFromMaxBlockHeight: 2 })),
+            ];
+            filterBestTip(data);
+            assert.strictEqual(data.length, 2);
+        });
+        test('does nothing when exactly one block at distance 0', () => {
+            const data = [
+                makeEntry(makeBlockInfo({ distanceFromMaxBlockHeight: 1 })),
+                makeEntry(makeBlockInfo({ distanceFromMaxBlockHeight: 0 })),
+            ];
+            filterBestTip(data);
+            assert.strictEqual(data.length, 2);
+        });
+        test('reduces multiple blocks at distance 0 to one', () => {
+            const data = [
+                makeEntry(makeBlockInfo({
+                    distanceFromMaxBlockHeight: 5,
+                    height: 95,
+                    stateHash: 'older',
+                })),
+                makeEntry(makeBlockInfo({
+                    distanceFromMaxBlockHeight: 0,
+                    height: 100,
+                    stateHash: 'tip_a',
+                    lastVrfOutput: 'AA11',
+                })),
+                makeEntry(makeBlockInfo({
+                    distanceFromMaxBlockHeight: 0,
+                    height: 100,
+                    stateHash: 'tip_b',
+                    lastVrfOutput: 'BB22',
+                })),
+            ];
+            filterBestTip(data);
+            assert.strictEqual(data.length, 2);
+            assert.strictEqual(data[0].blockInfo.height, 95);
+            assert.strictEqual(data[1].blockInfo.distanceFromMaxBlockHeight, 0);
+        });
+        test('reduces three blocks at distance 0 to one', () => {
+            const data = [
+                makeEntry(makeBlockInfo({
+                    distanceFromMaxBlockHeight: 0,
+                    stateHash: 'a',
+                    lastVrfOutput: 'AA',
+                    height: 100,
+                })),
+                makeEntry(makeBlockInfo({
+                    distanceFromMaxBlockHeight: 0,
+                    stateHash: 'b',
+                    lastVrfOutput: 'BB',
+                    height: 100,
+                })),
+                makeEntry(makeBlockInfo({
+                    distanceFromMaxBlockHeight: 0,
+                    stateHash: 'c',
+                    lastVrfOutput: 'CC',
+                    height: 100,
+                })),
+            ];
+            filterBestTip(data);
+            assert.strictEqual(data.length, 1);
+        });
+        test('handles empty array', () => {
+            const data = [];
+            filterBestTip(data);
+            assert.strictEqual(data.length, 0);
+        });
+    });
+});
+//# sourceMappingURL=consensus.test.js.map

package/build/tests/unit/consensus.test.js.map

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

package/build/tests/unit/error-handling.test.js

@@ -0,0 +1,52 @@
+import { describe, test } from 'node:test';
+import assert from 'node:assert';
+import { GraphQLError } from 'graphql';
+import { throwGraphQLError, throwActionStateError, throwBlockRangeError, } from '../../src/errors/error.js';
+describe('Error Handling', () => {
+    describe('throwGraphQLError', () => {
+        test('throws GraphQLError with message', () => {
+            assert.throws(() => throwGraphQLError('test message'), (err) => {
+                assert.ok(err instanceof GraphQLError);
+                assert.strictEqual(err.message, 'test message');
+                return true;
+            });
+        });
+        test('throws GraphQLError with code and status', () => {
+            assert.throws(() => throwGraphQLError('msg', 'MY_CODE', 422), (err) => {
+                assert.strictEqual(err.extensions.code, 'MY_CODE');
+                assert.strictEqual(err.extensions.status, 422);
+                return true;
+            });
+        });
+        test('throws with undefined code and status when not provided', () => {
+            assert.throws(() => throwGraphQLError('msg'), (err) => {
+                assert.strictEqual(err.extensions.code, undefined);
+                assert.strictEqual(err.extensions.status, undefined);
+                return true;
+            });
+        });
+    });
+    describe('throwActionStateError', () => {
+        test('throws with ACTION_STATE_NOT_FOUND code and 400 status', () => {
+            assert.throws(() => throwActionStateError('state xyz does not exist'), (err) => {
+                assert.ok(err instanceof GraphQLError);
+                assert.strictEqual(err.message, 'state xyz does not exist');
+                assert.strictEqual(err.extensions.code, 'ACTION_STATE_NOT_FOUND');
+                assert.strictEqual(err.extensions.status, 400);
+                return true;
+            });
+        });
+    });
+    describe('throwBlockRangeError', () => {
+        test('throws with BLOCK_RANGE_ERROR code and 400 status', () => {
+            assert.throws(() => throwBlockRangeError('range too large'), (err) => {
+                assert.ok(err instanceof GraphQLError);
+                assert.strictEqual(err.message, 'range too large');
+                assert.strictEqual(err.extensions.code, 'BLOCK_RANGE_ERROR');
+                assert.strictEqual(err.extensions.status, 400);
+                return true;
+            });
+        });
+    });
+});
+//# sourceMappingURL=error-handling.test.js.map

package/build/tests/unit/error-handling.test.js.map

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

package/build/tests/utils.test.js

@@ -0,0 +1,313 @@
+import { describe, test } from 'node:test';
+import assert from 'node:assert';
+import { partitionBlocks, getElementIdFieldValues, removeRedundantEmittedFields, mapActionOrEvent, sortAndFilterBlocks, } from '../src/services/data-adapters/database-row-adapters.js';
+describe('utils', () => {
+    describe('partitionBlocks', () => {
+        test('should partition rows by block hash and transaction hash', () => {
+            const rows = [
+                { state_hash: 'state_hash_1', hash: 'hash_1' },
+                { state_hash: 'state_hash_1', hash: 'hash_2' },
+                { state_hash: 'state_hash_2', hash: 'hash_3' },
+                { state_hash: 'state_hash_2', hash: 'hash_4' },
+            ];
+            const result = partitionBlocks(rows);
+            const stateHash1 = result.get('state_hash_1');
+            const stateHash2 = result.get('state_hash_2');
+            assert(stateHash1);
+            assert(stateHash2);
+            assert.strictEqual(stateHash1.size, 2);
+            assert.strictEqual(stateHash2.size, 2);
+        });
+        test('should return empty array if no rows', () => {
+            const rows = [];
+            const result = partitionBlocks(rows);
+            assert.strictEqual(result.size, 0);
+        });
+        test('should accumulate multiple rows for the same transaction', () => {
+            const rows = [
+                { state_hash: 'b1', hash: 'tx1', field_id: 1 },
+                { state_hash: 'b1', hash: 'tx1', field_id: 2 },
+            ];
+            const result = partitionBlocks(rows);
+            assert.strictEqual(result.size, 1);
+            assert.strictEqual(result.get('b1').get('tx1').length, 2);
+        });
+    });
+    describe('getElementIdFieldValues', () => {
+        test('should map id to field for each row', () => {
+            const rows = [
+                { field_id: 1, field_value: 'field_1' },
+                { field_id: 2, field_value: 'field_2' },
+                { field_id: 3, field_value: 'field_3' },
+            ];
+            const result = getElementIdFieldValues(rows);
+            assert.equal(result.get('1'), 'field_1');
+            assert.equal(result.get('2'), 'field_2');
+            assert.equal(result.get('3'), 'field_3');
+        });
+        test('should handle empty rows', () => {
+            const rows = [];
+            const result = getElementIdFieldValues(rows);
+            assert(result.size === 0);
+        });
+        test('later row should overwrite earlier for same field_id', () => {
+            const rows = [
+                { field_id: 1, field_value: 'first' },
+                { field_id: 1, field_value: 'second' },
+            ];
+            const result = getElementIdFieldValues(rows);
+            assert.strictEqual(result.size, 1);
+            assert.strictEqual(result.get('1'), 'second');
+        });
+    });
+    describe('removeRedundantEmittedFields', () => {
+        test('should remove duplicate rows based on unique event ID', () => {
+            const rows = [
+                {
+                    event_field_elements_id: 1,
+                    event_element_ids: [1, 2],
+                    zkapp_account_update_id: 10,
+                    zkapp_account_updates_ids: [10, 12],
+                },
+                {
+                    event_field_elements_id: 1,
+                    event_element_ids: [1, 2],
+                    zkapp_account_update_id: 10,
+                    zkapp_account_updates_ids: [10, 12],
+                },
+                {
+                    event_field_elements_id: 2,
+                    event_element_ids: [1, 2],
+                    zkapp_account_update_id: 12,
+                    zkapp_account_updates_ids: [10, 12],
+                },
+            ];
+            const result = removeRedundantEmittedFields(rows);
+            assert.strictEqual(result.length, 2);
+        });
+        test('should throw an error for a missing matching account update', () => {
+            const rows = [
+                {
+                    event_field_elements_id: 1,
+                    event_field_element_ids: [1, 2],
+                    zkapp_account_update_id: 99,
+                    zkapp_account_updates_ids: [10, 11],
+                },
+            ];
+            assert.throws(() => removeRedundantEmittedFields(rows)),
+                /No matching account update found/;
+        });
+        test('should keep rows for different events in same account update', () => {
+            const rows = [
+                {
+                    event_field_elements_id: 100,
+                    event_element_ids: [100, 101],
+                    zkapp_account_update_id: 10,
+                    zkapp_account_updates_ids: [10],
+                },
+                {
+                    event_field_elements_id: 101,
+                    event_element_ids: [100, 101],
+                    zkapp_account_update_id: 10,
+                    zkapp_account_updates_ids: [10],
+                },
+            ];
+            const result = removeRedundantEmittedFields(rows);
+            assert.strictEqual(result.length, 2);
+        });
+        test('should preserve ordering by account update index', () => {
+            const rows = [
+                {
+                    event_field_elements_id: 200,
+                    event_element_ids: [200],
+                    zkapp_account_update_id: 10,
+                    zkapp_account_updates_ids: [20, 10],
+                },
+                {
+                    event_field_elements_id: 100,
+                    event_element_ids: [100],
+                    zkapp_account_update_id: 20,
+                    zkapp_account_updates_ids: [20, 10],
+                },
+            ];
+            const result = removeRedundantEmittedFields(rows);
+            assert.strictEqual(result.length, 2);
+            assert.strictEqual(result[0].zkapp_account_update_id, 20);
+            assert.strictEqual(result[1].zkapp_account_update_id, 10);
+        });
+        test('should handle multiple events per account update with correct ordering', () => {
+            const rows = [
+                {
+                    event_field_elements_id: 102,
+                    event_element_ids: [100, 101, 102],
+                    zkapp_account_update_id: 10,
+                    zkapp_account_updates_ids: [10],
+                },
+                {
+                    event_field_elements_id: 100,
+                    event_element_ids: [100, 101, 102],
+                    zkapp_account_update_id: 10,
+                    zkapp_account_updates_ids: [10],
+                },
+                {
+                    event_field_elements_id: 101,
+                    event_element_ids: [100, 101, 102],
+                    zkapp_account_update_id: 10,
+                    zkapp_account_updates_ids: [10],
+                },
+            ];
+            const result = removeRedundantEmittedFields(rows);
+            assert.strictEqual(result.length, 3);
+            assert.strictEqual(result[0].event_field_elements_id, 100);
+            assert.strictEqual(result[1].event_field_elements_id, 101);
+            assert.strictEqual(result[2].event_field_elements_id, 102);
+        });
+        describe('mapActionOrEvent', () => {
+            const mockElementIdFieldValues = new Map();
+            mockElementIdFieldValues.set('1', 'value1');
+            mockElementIdFieldValues.set('2', 'value2');
+            describe('when kind is "event"', () => {
+                test('map rows to an array of events', () => {
+                    const rows = [
+                        {
+                            zkapp_account_update_id: 1,
+                            event_field_element_ids: [1, 2],
+                        },
+                    ];
+                    const result = mapActionOrEvent('event', rows, mockElementIdFieldValues);
+                    assert(result[0].data);
+                    assert(result[0].transactionInfo);
+                });
+                test('should map rows with correct data values', () => {
+                    const rows = [
+                        {
+                            zkapp_account_update_id: 5,
+                            event_field_element_ids: [1, 2],
+                            status: 'applied',
+                            hash: 'tx_abc',
+                            memo: 'test memo',
+                            authorization_kind: 'Proof',
+                            sequence_number: 3,
+                            zkapp_account_updates_ids: [5, 6],
+                        },
+                    ];
+                    const result = mapActionOrEvent('event', rows, mockElementIdFieldValues);
+                    assert.deepStrictEqual(result[0].data, ['value1', 'value2']);
+                    assert.strictEqual(result[0].transactionInfo.hash, 'tx_abc');
+                    assert.strictEqual(result[0].transactionInfo.status, 'applied');
+                    assert.strictEqual(result[0].transactionInfo.authorizationKind, 'Proof');
+                    assert.strictEqual(result[0].transactionInfo.sequenceNumber, 3);
+                });
+            });
+            describe('when kind is "action"', () => {
+                test('should map rows to an array of actions', () => {
+                    const rows = [
+                        {
+                            event_field_element_ids: [1, 2],
+                            zkapp_account_update_id: 123,
+                            account_update_event_id: 456,
+                        },
+                    ];
+                    const result = mapActionOrEvent('action', rows, mockElementIdFieldValues);
+                    assert(result[0].data);
+                    assert(result[0].transactionInfo);
+                    assert(result[0].accountUpdateId);
+                });
+            });
+            test('should skip field ids not found in the map', () => {
+                const fieldValues = new Map([
+                    ['1', 'value1'],
+                    ['2', 'value2'],
+                ]);
+                const rows = [
+                    { zkapp_account_update_id: 1, event_field_element_ids: [1, 999, 2] },
+                ];
+                const result = mapActionOrEvent('event', rows, fieldValues);
+                assert.deepStrictEqual(result[0].data, ['value1', 'value2']);
+            });
+            test('should handle empty element ids', () => {
+                const rows = [
+                    { zkapp_account_update_id: 1, event_field_element_ids: [] },
+                ];
+                const result = mapActionOrEvent('event', rows, mockElementIdFieldValues);
+                assert.deepStrictEqual(result[0].data, []);
+            });
+            test('should map multiple rows', () => {
+                const rows = [
+                    { zkapp_account_update_id: 1, event_field_element_ids: [1], hash: 'tx1' },
+                    { zkapp_account_update_id: 2, event_field_element_ids: [1, 2], hash: 'tx2' },
+                ];
+                const result = mapActionOrEvent('event', rows, mockElementIdFieldValues);
+                assert.strictEqual(result.length, 2);
+                assert.deepStrictEqual(result[0].data, ['value1']);
+                assert.deepStrictEqual(result[1].data, ['value1', 'value2']);
+            });
+        });
+    });
+    describe('sortAndFilterBlocks', () => {
+        function makeBlockEntry(height, timestamp, distanceFromMax, stateHash = 'sh' + height, lastVrfOutput = 'AA') {
+            return {
+                blockInfo: {
+                    height,
+                    stateHash,
+                    parentHash: 'ph',
+                    ledgerHash: 'lh',
+                    chainStatus: 'canonical',
+                    timestamp,
+                    globalSlotSinceHardfork: height,
+                    globalSlotSinceGenesis: height,
+                    distanceFromMaxBlockHeight: distanceFromMax,
+                    lastVrfOutput,
+                },
+                eventData: [],
+            };
+        }
+        test('should sort blocks by height ascending', () => {
+            const data = [
+                makeBlockEntry(300, '1000', 1),
+                makeBlockEntry(100, '1000', 3),
+                makeBlockEntry(200, '1000', 2),
+            ];
+            sortAndFilterBlocks(data);
+            assert.strictEqual(data[0].blockInfo.height, 100);
+            assert.strictEqual(data[1].blockInfo.height, 200);
+            assert.strictEqual(data[2].blockInfo.height, 300);
+        });
+        test('should use timestamp as tiebreaker for equal heights', () => {
+            const data = [
+                makeBlockEntry(100, '3000', 1),
+                makeBlockEntry(100, '1000', 1),
+                makeBlockEntry(100, '2000', 1),
+            ];
+            sortAndFilterBlocks(data);
+            assert.strictEqual(data[0].blockInfo.timestamp, '1000');
+            assert.strictEqual(data[1].blockInfo.timestamp, '2000');
+            assert.strictEqual(data[2].blockInfo.timestamp, '3000');
+        });
+        test('should filter best tip when multiple blocks at distance 0', () => {
+            const data = [
+                makeBlockEntry(100, '1000', 5),
+                makeBlockEntry(200, '2000', 0, 'hash_a', 'AA'),
+                makeBlockEntry(200, '2000', 0, 'hash_b', 'BB'),
+            ];
+            sortAndFilterBlocks(data);
+            assert.strictEqual(data.length, 2);
+            assert.strictEqual(data[0].blockInfo.height, 100);
+            assert.strictEqual(data[1].blockInfo.distanceFromMaxBlockHeight, 0);
+        });
+        test('should not filter when only one block at distance 0', () => {
+            const data = [
+                makeBlockEntry(100, '1000', 5),
+                makeBlockEntry(200, '2000', 0),
+            ];
+            sortAndFilterBlocks(data);
+            assert.strictEqual(data.length, 2);
+        });
+        test('should handle empty array', () => {
+            const data = [];
+            sortAndFilterBlocks(data);
+            assert.strictEqual(data.length, 0);
+        });
+    });
+});
+//# sourceMappingURL=utils.test.js.map