Add BlockTreeEntry.Equals() method

Expose `btck_block_tree_entry_equals` from the C API as `BlockTreeEntry.Equals()` to enable comparison of block tree entries.

Add unit test.

Author: stringintech

kernel/block_tree_entry.go

@@ -40,3 +40,12 @@ func (bi *BlockTreeEntry) Previous() *BlockTreeEntry {
 	prevIndex := &BlockTreeEntry{ptr: ptr}
 	return prevIndex
 }
+
+// Equals compares two block tree entries for equality.
+// Returns true if both entries point to the same block in the tree.
+func (bi *BlockTreeEntry) Equals(other *BlockTreeEntry) bool {
+	if other == nil {
+		return false
+	}
+	return C.btck_block_tree_entry_equals(bi.ptr, other.ptr) != 0
+}

kernel/block_tree_entry_test.go

@@ -36,3 +36,35 @@ func TestBlockTreeEntryGetPrevious(t *testing.T) {
 		t.Error("Genesis block should not have a previous block")
 	}
 }
+
+func TestBlockTreeEntryEquals(t *testing.T) {
+	suite := ChainstateManagerTestSuite{
+		MaxBlockHeightToImport: 2,
+	}
+	suite.Setup(t)
+
+	chain := suite.Manager.GetActiveChain()
+
+	// Same entry should equal itself
+	entry1 := chain.GetByHeight(1)
+	if !entry1.Equals(entry1) {
+		t.Error("Entry should equal itself")
+	}
+
+	// Different retrievals of same height should be equal
+	entry1Again := chain.GetByHeight(1)
+	if !entry1.Equals(entry1Again) {
+		t.Error("Same height entries should be equal")
+	}
+
+	// Different heights should not be equal
+	entry0 := chain.GetByHeight(0)
+	if entry1.Equals(entry0) {
+		t.Error("Different height entries should not be equal")
+	}
+
+	// Nil comparison should return false
+	if entry1.Equals(nil) {
+		t.Error("Entry should not equal nil")
+	}
+}