@beclab/olaresid 0.1.12 → 0.2.0

package/tests/unit/event-parser.test.ts

@@ -0,0 +1,690 @@
+import {
+	parseEvents,
+	isTransferEvent,
+	isMintEvent,
+	isTagAddedEvent,
+	isTagRemovedEvent,
+	isTagElemUpdatedEvent,
+	isTagElemPushedEvent,
+	isTagElemPoppedEvent,
+	isNewTagTypeEvent,
+	EthLog
+} from '../../src/utils/event-parser';
+
+// ============================================================
+// Mock log builders
+//
+// topics / data were generated by ethers.Interface.encodeEventLog()
+// so they are byte-accurate representations of real on-chain logs.
+// ============================================================
+
+const ALICE = '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266';
+const BOB = '0x70997970C51812dc3A010C7d01b50e0d17dc79C8';
+const ZERO = '0x0000000000000000000000000000000000000000';
+
+// uint256(keccak256(bytes(domain))) — matches the on-chain tokenIdOf() formula
+const TOKEN_ID_MYTERMINUS =
+	19879848525404628335667218519301564776273724019895250627053354759222278526802n;
+const TOKEN_ID_ALICE_MYTERMINUS =
+	24279146203655622512644202787146622025808553749677899566979293689773803127510n;
+
+function makeLog(
+	overrides: Partial<EthLog> & { topics: string[]; data: string }
+): EthLog {
+	return {
+		address: '0x5DA4Fa8E567d86e52Ef8Da860de1be8f54cae97D',
+		blockNumber: '0x12d687', // 1234567
+		transactionHash:
+			'0xaabbccdd00000000000000000000000000000000000000000000000000000001',
+		transactionIndex: '0x0',
+		blockHash:
+			'0xdeadbeef00000000000000000000000000000000000000000000000000000000',
+		logIndex: '0x3', // 3
+		removed: false,
+		...overrides
+	};
+}
+
+// ---- All 16 events ----
+
+// 1. Transfer (mint): from=0x0, to=ALICE, tokenId=1
+const MINT_LOG = makeLog({
+	topics: [
+		'0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
+		'0x0000000000000000000000000000000000000000000000000000000000000000',
+		'0x000000000000000000000000f39fd6e51aad88f6f4ce6ab8827279cfffb92266',
+		'0x0000000000000000000000000000000000000000000000000000000000000001'
+	],
+	data: '0x'
+});
+
+// 2. Transfer (transfer): from=ALICE, to=BOB, tokenId=1
+const TRANSFER_LOG = makeLog({
+	topics: [
+		'0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
+		'0x000000000000000000000000f39fd6e51aad88f6f4ce6ab8827279cfffb92266',
+		'0x00000000000000000000000070997970c51812dc3a010c7d01b50e0d17dc79c8',
+		'0x0000000000000000000000000000000000000000000000000000000000000001'
+	],
+	data: '0x'
+});
+
+// 3. Approval: owner=ALICE, approved=BOB, tokenId=1
+const APPROVAL_LOG = makeLog({
+	topics: [
+		'0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925',
+		'0x000000000000000000000000f39fd6e51aad88f6f4ce6ab8827279cfffb92266',
+		'0x00000000000000000000000070997970c51812dc3a010c7d01b50e0d17dc79c8',
+		'0x0000000000000000000000000000000000000000000000000000000000000001'
+	],
+	data: '0x'
+});
+
+// 4. ApprovalForAll: owner=ALICE, operator=BOB, approved=true
+const APPROVAL_FOR_ALL_LOG = makeLog({
+	topics: [
+		'0x17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31',
+		'0x000000000000000000000000f39fd6e51aad88f6f4ce6ab8827279cfffb92266',
+		'0x00000000000000000000000070997970c51812dc3a010c7d01b50e0d17dc79c8'
+	],
+	data: '0x0000000000000000000000000000000000000000000000000000000000000001'
+});
+
+// 5. Initialized: version=1
+const INITIALIZED_LOG = makeLog({
+	topics: [
+		'0xc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d2'
+	],
+	data: '0x0000000000000000000000000000000000000000000000000000000000000001'
+});
+
+// 6. NewTagType: domain=myterminus.com, name=latestDID, abiType=0x0102, fieldNamesHash=[0xaaaa...aa]
+const NEW_TAG_TYPE_LOG = makeLog({
+	topics: [
+		'0xaa8271025a5ba865c58a2d9769be8780815b52092150b6a75bd0c6f3807ef034'
+	],
+	data: '0x000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000140000000000000000000000000000000000000000000000000000000000000000e6d797465726d696e75732e636f6d00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000096c61746573744449440000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000201020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'
+});
+
+// 7. OffchainStringArray: hash=0xbbbb...bb, value=['field1','field2']
+const OFFCHAIN_LOG = makeLog({
+	topics: [
+		'0xfc4832c7ea86d4e5dc86c34ae4c8c6dec2efca80fbfbf624e31b9d3cc534798f',
+		'0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb'
+	],
+	data: '0x000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000066669656c6431000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000066669656c64320000000000000000000000000000000000000000000000000000'
+});
+
+// 8. OwnershipTransferStarted: previousOwner=ALICE, newOwner=BOB
+const OWNERSHIP_TRANSFER_STARTED_LOG = makeLog({
+	topics: [
+		'0x38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e22700',
+		'0x000000000000000000000000f39fd6e51aad88f6f4ce6ab8827279cfffb92266',
+		'0x00000000000000000000000070997970c51812dc3a010c7d01b50e0d17dc79c8'
+	],
+	data: '0x'
+});
+
+// 9. OwnershipTransferred: previousOwner=ALICE, newOwner=BOB
+const OWNERSHIP_TRANSFERRED_LOG = makeLog({
+	topics: [
+		'0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0',
+		'0x000000000000000000000000f39fd6e51aad88f6f4ce6ab8827279cfffb92266',
+		'0x00000000000000000000000070997970c51812dc3a010c7d01b50e0d17dc79c8'
+	],
+	data: '0x'
+});
+
+// 10. TagAdded: from=myterminus.com, to=alice.myterminus.com, name=latestDID, value=0xdeadbeef
+const TAG_ADDED_LOG = makeLog({
+	topics: [
+		'0x5ca107007c1e738177f10dde04e0ee5abd1509873b6efcf24bd08abd00b2177f'
+	],
+	data: '0x000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000140000000000000000000000000000000000000000000000000000000000000000e6d797465726d696e75732e636f6d0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000014616c6963652e6d797465726d696e75732e636f6d00000000000000000000000000000000000000000000000000000000000000000000000000000000000000096c617465737444494400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004deadbeef00000000000000000000000000000000000000000000000000000000'
+});
+
+// 11. TagElemPopped: from=myterminus.com, to=alice.myterminus.com, name=wallets, elemPath=[0,1]
+const TAG_ELEM_POPPED_LOG = makeLog({
+	topics: [
+		'0x61958e39a2b1ae93cf23e2410af0037a5b3580ce90a793e5f39d1995b6aa8300'
+	],
+	data: '0x000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000140000000000000000000000000000000000000000000000000000000000000000e6d797465726d696e75732e636f6d0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000014616c6963652e6d797465726d696e75732e636f6d000000000000000000000000000000000000000000000000000000000000000000000000000000000000000777616c6c65747300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001'
+});
+
+// 12. TagElemPushed: from=myterminus.com, to=alice.myterminus.com, name=wallets, elemPath=[0], value=0xcafebabe
+const TAG_ELEM_PUSHED_LOG = makeLog({
+	topics: [
+		'0xfea766f86b68d35a2d7a916798fc3ab6f350d5b5c7a96e34549c91d6f9cea85f'
+	],
+	data: '0x00000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000e00000000000000000000000000000000000000000000000000000000000000120000000000000000000000000000000000000000000000000000000000000016000000000000000000000000000000000000000000000000000000000000001a0000000000000000000000000000000000000000000000000000000000000000e6d797465726d696e75732e636f6d0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000014616c6963652e6d797465726d696e75732e636f6d000000000000000000000000000000000000000000000000000000000000000000000000000000000000000777616c6c65747300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004cafebabe00000000000000000000000000000000000000000000000000000000'
+});
+
+// 13. TagElemUpdated: from=myterminus.com, to=alice.myterminus.com, name=wallets, elemPath=[0], value=0xdeadbeef
+const TAG_ELEM_UPDATED_LOG = makeLog({
+	topics: [
+		'0xdf2b75aeecf6e03f270e5ecbe00c9594c7cd49b6f9bcdec6a081bff6bbf29873'
+	],
+	data: '0x00000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000e00000000000000000000000000000000000000000000000000000000000000120000000000000000000000000000000000000000000000000000000000000016000000000000000000000000000000000000000000000000000000000000001a0000000000000000000000000000000000000000000000000000000000000000e6d797465726d696e75732e636f6d0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000014616c6963652e6d797465726d696e75732e636f6d000000000000000000000000000000000000000000000000000000000000000000000000000000000000000777616c6c65747300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004deadbeef00000000000000000000000000000000000000000000000000000000'
+});
+
+// 14. TagRemoved: from=myterminus.com, to=alice.myterminus.com, name=latestDID
+const TAG_REMOVED_LOG = makeLog({
+	topics: [
+		'0x4acaa22e43848ebfca138dbf8d5ee06f44f026980698144a20f74e3805374db2'
+	],
+	data: '0x000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000e0000000000000000000000000000000000000000000000000000000000000000e6d797465726d696e75732e636f6d0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000014616c6963652e6d797465726d696e75732e636f6d00000000000000000000000000000000000000000000000000000000000000000000000000000000000000096c61746573744449440000000000000000000000000000000000000000000000'
+});
+
+// 15. TransferByParentOwner: tokenId=42
+const TRANSFER_BY_PARENT_OWNER_LOG = makeLog({
+	topics: [
+		'0xfbca86852ebd6aae82b21918f5b4c7bd1a60548778b1f1ebc88fbc359e581c3d',
+		'0x000000000000000000000000000000000000000000000000000000000000002a'
+	],
+	data: '0x'
+});
+
+// 16. TransferBySuperAdmin: tokenId=99
+const TRANSFER_BY_SUPER_ADMIN_LOG = makeLog({
+	topics: [
+		'0x2a3326cdbd5e16d47f67bfcb2e3ebce284abaa2d49490956ec56b86cd1454fef',
+		'0x0000000000000000000000000000000000000000000000000000000000000063'
+	],
+	data: '0x'
+});
+
+// 17. Upgraded: implementation=0x9fE46736...
+const UPGRADED_LOG = makeLog({
+	topics: [
+		'0xbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b',
+		'0x0000000000000000000000009fe46736679d2d9a65f0992f2272de9f3c7fa6e0'
+	],
+	data: '0x'
+});
+
+// An unrelated log (unknown topic — will be skipped)
+const UNKNOWN_LOG = makeLog({
+	topics: [
+		'0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff'
+	],
+	data: '0x1234'
+});
+
+// ============================================================
+// Tests
+// ============================================================
+
+describe('parseEvents', () => {
+	it('returns an empty array for empty input', () => {
+		expect(parseEvents([])).toEqual([]);
+	});
+
+	it('skips unknown logs without throwing', () => {
+		expect(parseEvents([UNKNOWN_LOG])).toHaveLength(0);
+	});
+
+	it('skips unknown logs mixed in with valid ones', () => {
+		const result = parseEvents([UNKNOWN_LOG, MINT_LOG, UNKNOWN_LOG]);
+		expect(result).toHaveLength(1);
+	});
+
+	// ---- ERC721 standard events ----
+
+	describe('Transfer (mint)', () => {
+		it('eventName is Transfer', () => {
+			const [e] = parseEvents([MINT_LOG]);
+			expect(e.eventName).toBe('Transfer');
+		});
+
+		it('isTransferEvent returns true', () => {
+			const [e] = parseEvents([MINT_LOG]);
+			expect(isTransferEvent(e)).toBe(true);
+		});
+
+		it('isMintEvent returns true when from is 0x0', () => {
+			const [e] = parseEvents([MINT_LOG]);
+			expect(isMintEvent(e)).toBe(true);
+		});
+
+		it('args: from=0x0, to=ALICE, tokenId=1n', () => {
+			const [e] = parseEvents([MINT_LOG]);
+			if (!isTransferEvent(e)) throw new Error();
+			expect(e.args.from).toBe(ZERO);
+			expect(e.args.to).toBe(ALICE);
+			expect(e.args.tokenId).toBe(1n);
+		});
+
+		it('tokenId field = 1n (direct)', () => {
+			const [e] = parseEvents([MINT_LOG]);
+			expect(e.tokenId).toBe(1n);
+		});
+	});
+
+	describe('Transfer (ownership transfer)', () => {
+		it('isMintEvent returns false when from is not 0x0', () => {
+			const [e] = parseEvents([TRANSFER_LOG]);
+			expect(isMintEvent(e)).toBe(false);
+		});
+
+		it('args: from=ALICE, to=BOB, tokenId=1n', () => {
+			const [e] = parseEvents([TRANSFER_LOG]);
+			if (!isTransferEvent(e)) throw new Error();
+			expect(e.args.from).toBe(ALICE);
+			expect(e.args.to).toBe(BOB);
+			expect(e.args.tokenId).toBe(1n);
+		});
+
+		it('tokenId field = 1n (direct)', () => {
+			const [e] = parseEvents([TRANSFER_LOG]);
+			expect(e.tokenId).toBe(1n);
+		});
+	});
+
+	describe('Approval', () => {
+		it('eventName is Approval', () => {
+			const [e] = parseEvents([APPROVAL_LOG]);
+			expect(e.eventName).toBe('Approval');
+		});
+
+		it('args: owner=ALICE, approved=BOB, tokenId=1n', () => {
+			const [e] = parseEvents([APPROVAL_LOG]);
+			if (e.eventName !== 'Approval') throw new Error();
+			expect(e.args.owner).toBe(ALICE);
+			expect(e.args.approved).toBe(BOB);
+			expect(e.args.tokenId).toBe(1n);
+		});
+
+		it('tokenId field = undefined (Approval does not modify domain state)', () => {
+			const [e] = parseEvents([APPROVAL_LOG]);
+			expect(e.tokenId).toBeUndefined();
+		});
+	});
+
+	describe('ApprovalForAll', () => {
+		it('eventName is ApprovalForAll', () => {
+			const [e] = parseEvents([APPROVAL_FOR_ALL_LOG]);
+			expect(e.eventName).toBe('ApprovalForAll');
+		});
+
+		it('args: owner=ALICE, operator=BOB, approved=true', () => {
+			const [e] = parseEvents([APPROVAL_FOR_ALL_LOG]);
+			if (e.eventName !== 'ApprovalForAll') throw new Error();
+			expect(e.args.owner).toBe(ALICE);
+			expect(e.args.operator).toBe(BOB);
+			expect(e.args.approved).toBe(true);
+		});
+
+		it('tokenId field = undefined (no tokenId in ApprovalForAll)', () => {
+			const [e] = parseEvents([APPROVAL_FOR_ALL_LOG]);
+			expect(e.tokenId).toBeUndefined();
+		});
+	});
+
+	// ---- UUPS / Ownable events ----
+
+	describe('Initialized', () => {
+		it('eventName is Initialized', () => {
+			const [e] = parseEvents([INITIALIZED_LOG]);
+			expect(e.eventName).toBe('Initialized');
+		});
+
+		it('args: version=1n', () => {
+			const [e] = parseEvents([INITIALIZED_LOG]);
+			if (e.eventName !== 'Initialized') throw new Error();
+			expect(e.args.version).toBe(1n);
+		});
+
+		it('tokenId field = undefined', () => {
+			const [e] = parseEvents([INITIALIZED_LOG]);
+			expect(e.tokenId).toBeUndefined();
+		});
+	});
+
+	describe('OwnershipTransferStarted', () => {
+		it('eventName is OwnershipTransferStarted', () => {
+			const [e] = parseEvents([OWNERSHIP_TRANSFER_STARTED_LOG]);
+			expect(e.eventName).toBe('OwnershipTransferStarted');
+		});
+
+		it('args: previousOwner=ALICE, newOwner=BOB', () => {
+			const [e] = parseEvents([OWNERSHIP_TRANSFER_STARTED_LOG]);
+			if (e.eventName !== 'OwnershipTransferStarted') throw new Error();
+			expect(e.args.previousOwner).toBe(ALICE);
+			expect(e.args.newOwner).toBe(BOB);
+		});
+
+		it('tokenId field = undefined', () => {
+			const [e] = parseEvents([OWNERSHIP_TRANSFER_STARTED_LOG]);
+			expect(e.tokenId).toBeUndefined();
+		});
+	});
+
+	describe('OwnershipTransferred', () => {
+		it('eventName is OwnershipTransferred', () => {
+			const [e] = parseEvents([OWNERSHIP_TRANSFERRED_LOG]);
+			expect(e.eventName).toBe('OwnershipTransferred');
+		});
+
+		it('args: previousOwner=ALICE, newOwner=BOB', () => {
+			const [e] = parseEvents([OWNERSHIP_TRANSFERRED_LOG]);
+			if (e.eventName !== 'OwnershipTransferred') throw new Error();
+			expect(e.args.previousOwner).toBe(ALICE);
+			expect(e.args.newOwner).toBe(BOB);
+		});
+
+		it('tokenId field = undefined', () => {
+			const [e] = parseEvents([OWNERSHIP_TRANSFERRED_LOG]);
+			expect(e.tokenId).toBeUndefined();
+		});
+	});
+
+	describe('Upgraded', () => {
+		it('eventName is Upgraded', () => {
+			const [e] = parseEvents([UPGRADED_LOG]);
+			expect(e.eventName).toBe('Upgraded');
+		});
+
+		it('args: implementation address is correct', () => {
+			const [e] = parseEvents([UPGRADED_LOG]);
+			if (e.eventName !== 'Upgraded') throw new Error();
+			expect(e.args.implementation).toBe(
+				'0x9fE46736679d2D9a65F0992F2272dE9f3c7fa6e0'
+			);
+		});
+
+		it('tokenId field = undefined', () => {
+			const [e] = parseEvents([UPGRADED_LOG]);
+			expect(e.tokenId).toBeUndefined();
+		});
+	});
+
+	// ---- Custom transfer events ----
+
+	describe('TransferByParentOwner', () => {
+		it('eventName is TransferByParentOwner', () => {
+			const [e] = parseEvents([TRANSFER_BY_PARENT_OWNER_LOG]);
+			expect(e.eventName).toBe('TransferByParentOwner');
+		});
+
+		it('args: tokenId=42n', () => {
+			const [e] = parseEvents([TRANSFER_BY_PARENT_OWNER_LOG]);
+			if (e.eventName !== 'TransferByParentOwner') throw new Error();
+			expect(e.args.tokenId).toBe(42n);
+		});
+
+		it('tokenId field = 42n (direct)', () => {
+			const [e] = parseEvents([TRANSFER_BY_PARENT_OWNER_LOG]);
+			expect(e.tokenId).toBe(42n);
+		});
+	});
+
+	describe('TransferBySuperAdmin', () => {
+		it('eventName is TransferBySuperAdmin', () => {
+			const [e] = parseEvents([TRANSFER_BY_SUPER_ADMIN_LOG]);
+			expect(e.eventName).toBe('TransferBySuperAdmin');
+		});
+
+		it('args: tokenId=99n', () => {
+			const [e] = parseEvents([TRANSFER_BY_SUPER_ADMIN_LOG]);
+			if (e.eventName !== 'TransferBySuperAdmin') throw new Error();
+			expect(e.args.tokenId).toBe(99n);
+		});
+
+		it('tokenId field = 99n (direct)', () => {
+			const [e] = parseEvents([TRANSFER_BY_SUPER_ADMIN_LOG]);
+			expect(e.tokenId).toBe(99n);
+		});
+	});
+
+	// ---- Tag events ----
+
+	describe('NewTagType', () => {
+		it('eventName is NewTagType', () => {
+			const [e] = parseEvents([NEW_TAG_TYPE_LOG]);
+			expect(e.eventName).toBe('NewTagType');
+			expect(isNewTagTypeEvent(e)).toBe(true);
+		});
+
+		it('args: domain, name, abiType, fieldNamesHash', () => {
+			const [e] = parseEvents([NEW_TAG_TYPE_LOG]);
+			if (!isNewTagTypeEvent(e)) throw new Error();
+			expect(e.args.domain).toBe('myterminus.com');
+			expect(e.args.name).toBe('latestDID');
+			expect(e.args.abiType).toBe('0x0102');
+			expect(e.args.fieldNamesHash).toHaveLength(1);
+			expect(e.args.fieldNamesHash[0]).toBe(
+				'0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'
+			);
+		});
+
+		it('tokenId field = keccak256(domain) = TOKEN_ID_MYTERMINUS', () => {
+			const [e] = parseEvents([NEW_TAG_TYPE_LOG]);
+			expect(e.tokenId).toBe(TOKEN_ID_MYTERMINUS);
+		});
+	});
+
+	describe('TagAdded', () => {
+		it('eventName is TagAdded', () => {
+			const [e] = parseEvents([TAG_ADDED_LOG]);
+			expect(e.eventName).toBe('TagAdded');
+			expect(isTagAddedEvent(e)).toBe(true);
+		});
+
+		it('args: from, to, name, value', () => {
+			const [e] = parseEvents([TAG_ADDED_LOG]);
+			if (!isTagAddedEvent(e)) throw new Error();
+			expect(e.args.from).toBe('myterminus.com');
+			expect(e.args.to).toBe('alice.myterminus.com');
+			expect(e.args.name).toBe('latestDID');
+			expect(e.args.value).toBe('0xdeadbeef');
+		});
+
+		it('tokenId field = keccak256(to) = TOKEN_ID_ALICE_MYTERMINUS', () => {
+			const [e] = parseEvents([TAG_ADDED_LOG]);
+			expect(e.tokenId).toBe(TOKEN_ID_ALICE_MYTERMINUS);
+		});
+	});
+
+	describe('TagRemoved', () => {
+		it('eventName is TagRemoved', () => {
+			const [e] = parseEvents([TAG_REMOVED_LOG]);
+			expect(e.eventName).toBe('TagRemoved');
+			expect(isTagRemovedEvent(e)).toBe(true);
+		});
+
+		it('args: from, to, name', () => {
+			const [e] = parseEvents([TAG_REMOVED_LOG]);
+			if (!isTagRemovedEvent(e)) throw new Error();
+			expect(e.args.from).toBe('myterminus.com');
+			expect(e.args.to).toBe('alice.myterminus.com');
+			expect(e.args.name).toBe('latestDID');
+		});
+
+		it('tokenId field = keccak256(to) = TOKEN_ID_ALICE_MYTERMINUS', () => {
+			const [e] = parseEvents([TAG_REMOVED_LOG]);
+			expect(e.tokenId).toBe(TOKEN_ID_ALICE_MYTERMINUS);
+		});
+	});
+
+	describe('TagElemPopped', () => {
+		it('eventName is TagElemPopped', () => {
+			const [e] = parseEvents([TAG_ELEM_POPPED_LOG]);
+			expect(e.eventName).toBe('TagElemPopped');
+			expect(isTagElemPoppedEvent(e)).toBe(true);
+		});
+
+		it('args: from, to, name, elemPath=[0n,1n]', () => {
+			const [e] = parseEvents([TAG_ELEM_POPPED_LOG]);
+			if (!isTagElemPoppedEvent(e)) throw new Error();
+			expect(e.args.from).toBe('myterminus.com');
+			expect(e.args.to).toBe('alice.myterminus.com');
+			expect(e.args.name).toBe('wallets');
+			expect(e.args.elemPath).toEqual([0n, 1n]);
+		});
+
+		it('tokenId field = keccak256(to) = TOKEN_ID_ALICE_MYTERMINUS', () => {
+			const [e] = parseEvents([TAG_ELEM_POPPED_LOG]);
+			expect(e.tokenId).toBe(TOKEN_ID_ALICE_MYTERMINUS);
+		});
+	});
+
+	describe('TagElemPushed', () => {
+		it('eventName is TagElemPushed', () => {
+			const [e] = parseEvents([TAG_ELEM_PUSHED_LOG]);
+			expect(e.eventName).toBe('TagElemPushed');
+			expect(isTagElemPushedEvent(e)).toBe(true);
+		});
+
+		it('args: from, to, name, elemPath=[0n], value=0xcafebabe', () => {
+			const [e] = parseEvents([TAG_ELEM_PUSHED_LOG]);
+			if (!isTagElemPushedEvent(e)) throw new Error();
+			expect(e.args.from).toBe('myterminus.com');
+			expect(e.args.to).toBe('alice.myterminus.com');
+			expect(e.args.name).toBe('wallets');
+			expect(e.args.elemPath).toEqual([0n]);
+			expect(e.args.value).toBe('0xcafebabe');
+		});
+
+		it('tokenId field = keccak256(to) = TOKEN_ID_ALICE_MYTERMINUS', () => {
+			const [e] = parseEvents([TAG_ELEM_PUSHED_LOG]);
+			expect(e.tokenId).toBe(TOKEN_ID_ALICE_MYTERMINUS);
+		});
+	});
+
+	describe('TagElemUpdated', () => {
+		it('eventName is TagElemUpdated', () => {
+			const [e] = parseEvents([TAG_ELEM_UPDATED_LOG]);
+			expect(e.eventName).toBe('TagElemUpdated');
+			expect(isTagElemUpdatedEvent(e)).toBe(true);
+		});
+
+		it('args: from, to, name, elemPath=[0n], value=0xdeadbeef', () => {
+			const [e] = parseEvents([TAG_ELEM_UPDATED_LOG]);
+			if (!isTagElemUpdatedEvent(e)) throw new Error();
+			expect(e.args.from).toBe('myterminus.com');
+			expect(e.args.to).toBe('alice.myterminus.com');
+			expect(e.args.name).toBe('wallets');
+			expect(e.args.elemPath).toEqual([0n]);
+			expect(e.args.value).toBe('0xdeadbeef');
+		});
+
+		it('tokenId field = keccak256(to) = TOKEN_ID_ALICE_MYTERMINUS', () => {
+			const [e] = parseEvents([TAG_ELEM_UPDATED_LOG]);
+			expect(e.tokenId).toBe(TOKEN_ID_ALICE_MYTERMINUS);
+		});
+	});
+
+	describe('OffchainStringArray', () => {
+		it('eventName is OffchainStringArray', () => {
+			const [e] = parseEvents([OFFCHAIN_LOG]);
+			expect(e.eventName).toBe('OffchainStringArray');
+		});
+
+		it('args: hash=0xbbbb...bb, value=[field1, field2]', () => {
+			const [e] = parseEvents([OFFCHAIN_LOG]);
+			if (e.eventName !== 'OffchainStringArray') throw new Error();
+			expect(e.args.hash).toBe(
+				'0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb'
+			);
+			expect(e.args.value).toEqual(['field1', 'field2']);
+		});
+
+		it('tokenId field = undefined', () => {
+			const [e] = parseEvents([OFFCHAIN_LOG]);
+			expect(e.tokenId).toBeUndefined();
+		});
+	});
+
+	// ---- Metadata checks ----
+
+	describe('log metadata', () => {
+		it('blockNumber is decoded from hex', () => {
+			const log = { ...MINT_LOG, blockNumber: '0x64' }; // 100
+			const [e] = parseEvents([log]);
+			expect(e.blockNumber).toBe(100);
+		});
+
+		it('logIndex is decoded from hex', () => {
+			const log = { ...MINT_LOG, logIndex: '0x5' }; // 5
+			const [e] = parseEvents([log]);
+			expect(e.logIndex).toBe(5);
+		});
+
+		it('transactionHash is preserved as-is', () => {
+			const [e] = parseEvents([MINT_LOG]);
+			expect(e.transactionHash).toBe(MINT_LOG.transactionHash);
+		});
+
+		it('raw field is the original EthLog object', () => {
+			const [e] = parseEvents([MINT_LOG]);
+			expect(e.raw).toBe(MINT_LOG);
+		});
+	});
+
+	// ---- Batch ----
+
+	describe('batch parsing', () => {
+		const ALL_16_LOGS = [
+			MINT_LOG,
+			TRANSFER_LOG,
+			APPROVAL_LOG,
+			APPROVAL_FOR_ALL_LOG,
+			INITIALIZED_LOG,
+			NEW_TAG_TYPE_LOG,
+			OFFCHAIN_LOG,
+			OWNERSHIP_TRANSFER_STARTED_LOG,
+			OWNERSHIP_TRANSFERRED_LOG,
+			TAG_ADDED_LOG,
+			TAG_ELEM_POPPED_LOG,
+			TAG_ELEM_PUSHED_LOG,
+			TAG_ELEM_UPDATED_LOG,
+			TAG_REMOVED_LOG,
+			TRANSFER_BY_PARENT_OWNER_LOG,
+			TRANSFER_BY_SUPER_ADMIN_LOG,
+			UPGRADED_LOG
+		];
+
+		it('parses all 17 logs (Transfer appears twice: mint + transfer)', () => {
+			const result = parseEvents(ALL_16_LOGS);
+			expect(result).toHaveLength(17);
+		});
+
+		it('preserves original order', () => {
+			const result = parseEvents(ALL_16_LOGS);
+			const names = result.map((e) => e.eventName);
+			expect(names).toEqual([
+				'Transfer',
+				'Transfer',
+				'Approval',
+				'ApprovalForAll',
+				'Initialized',
+				'NewTagType',
+				'OffchainStringArray',
+				'OwnershipTransferStarted',
+				'OwnershipTransferred',
+				'TagAdded',
+				'TagElemPopped',
+				'TagElemPushed',
+				'TagElemUpdated',
+				'TagRemoved',
+				'TransferByParentOwner',
+				'TransferBySuperAdmin',
+				'Upgraded'
+			]);
+		});
+
+		it('unknown logs interspersed with valid ones are skipped', () => {
+			const mixed = [
+				UNKNOWN_LOG,
+				MINT_LOG,
+				UNKNOWN_LOG,
+				TAG_ADDED_LOG,
+				UNKNOWN_LOG
+			];
+			const result = parseEvents(mixed);
+			expect(result).toHaveLength(2);
+			expect(result[0].eventName).toBe('Transfer');
+			expect(result[1].eventName).toBe('TagAdded');
+		});
+	});
+});