feat: add equals/hashCode to JSONArray and JSONObject wrappers

Delegate to Jackson's ArrayNode/ObjectNode structural equality,
matching Fastjson's HashMap/ArrayList-based behavior. Add 20 unit
tests covering identity, content, nested, empty, null, and cross-type
comparisons.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: halibobo1205

common/src/main/java/org/tron/json/JSONArray.java

@@ -234,4 +234,20 @@ public String toString() {
   public String toJSONString() {
     return toString();
   }
+
+  @Override
+  public boolean equals(Object o) {
+    if (this == o) {
+      return true;
+    }
+    if (!(o instanceof JSONArray)) {
+      return false;
+    }
+    return node.equals(((JSONArray) o).node);
+  }
+
+  @Override
+  public int hashCode() {
+    return node.hashCode();
+  }
 }

common/src/main/java/org/tron/json/JSONObject.java

@@ -508,4 +508,20 @@ public String toString() {
   public String toJSONString() {
     return toString();
   }
+
+  @Override
+  public boolean equals(Object o) {
+    if (this == o) {
+      return true;
+    }
+    if (!(o instanceof JSONObject)) {
+      return false;
+    }
+    return node.equals(((JSONObject) o).node);
+  }
+
+  @Override
+  public int hashCode() {
+    return node.hashCode();
+  }
 }

framework/src/test/java/org/tron/json/JsonCompatibilityFuzzTest.java

@@ -2,6 +2,7 @@
 
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertFalse;
+import static org.junit.Assert.assertNotEquals;
 import static org.junit.Assert.assertNotNull;
 import static org.junit.Assert.assertNull;
 import static org.junit.Assert.assertTrue;
@@ -2609,4 +2610,140 @@ public void testArrayGetJSONArrayFromStringifiedElement() {
     assertEquals(3, nested.size());
     assertEquals(1, nested.get(0));
   }
+
+  // ── JSONArray equals / hashCode ──────────────────────────────
+
+  @Test
+  public void testArrayEqualsSameContent() {
+    JSONArray a = JSONArray.parseArray("[1,\"two\",true,null]");
+    JSONArray b = JSONArray.parseArray("[1,\"two\",true,null]");
+    assertEquals(a, b);
+    assertEquals(a.hashCode(), b.hashCode());
+  }
+
+  @Test
+  public void testArrayEqualsDifferentContent() {
+    JSONArray a = JSONArray.parseArray("[1,2,3]");
+    JSONArray b = JSONArray.parseArray("[1,2,4]");
+    assertNotEquals(a, b);
+  }
+
+  @Test
+  public void testArrayEqualsBuiltVsParsed() {
+    JSONArray built = new JSONArray();
+    built.add(1);
+    built.add("hello");
+    built.add(true);
+    JSONArray parsed = JSONArray.parseArray("[1,\"hello\",true]");
+    assertEquals(built, parsed);
+    assertEquals(built.hashCode(), parsed.hashCode());
+  }
+
+  @Test
+  public void testArrayEqualsEmpty() {
+    assertEquals(new JSONArray(), JSONArray.parseArray("[]"));
+  }
+
+  @Test
+  public void testArrayEqualsNested() {
+    JSONArray a = JSONArray.parseArray("[[1,2],[3,4]]");
+    JSONArray b = JSONArray.parseArray("[[1,2],[3,4]]");
+    assertEquals(a, b);
+    assertEquals(a.hashCode(), b.hashCode());
+  }
+
+  @Test
+  public void testArrayNotEqualsNull() {
+    assertNotEquals(new JSONArray(), null);
+  }
+
+  @Test
+  public void testArrayNotEqualsOtherType() {
+    assertNotEquals(new JSONArray(), "[]");
+  }
+
+  @Test
+  public void testArrayEqualsSelf() {
+    JSONArray a = JSONArray.parseArray("[1]");
+    assertEquals(a, a);
+  }
+
+  @Test
+  public void testArrayEqualsOrderMatters() {
+    JSONArray a = JSONArray.parseArray("[1,2]");
+    JSONArray b = JSONArray.parseArray("[2,1]");
+    assertNotEquals(a, b);
+  }
+
+  // ── JSONObject equals / hashCode ─────────────────────────────
+
+  @Test
+  public void testObjectEqualsSameContent() {
+    JSONObject a = JSON.parseObject("{\"k\":1,\"v\":\"two\"}");
+    JSONObject b = JSON.parseObject("{\"k\":1,\"v\":\"two\"}");
+    assertEquals(a, b);
+    assertEquals(a.hashCode(), b.hashCode());
+  }
+
+  @Test
+  public void testObjectEqualsDifferentContent() {
+    JSONObject a = JSON.parseObject("{\"k\":1}");
+    JSONObject b = JSON.parseObject("{\"k\":2}");
+    assertNotEquals(a, b);
+  }
+
+  @Test
+  public void testObjectEqualsBuiltVsParsed() {
+    JSONObject built = new JSONObject();
+    built.put("name", "test");
+    built.put("count", 42);
+    JSONObject parsed = JSON.parseObject("{\"name\":\"test\",\"count\":42}");
+    assertEquals(built, parsed);
+    assertEquals(built.hashCode(), parsed.hashCode());
+  }
+
+  @Test
+  public void testObjectEqualsEmpty() {
+    assertEquals(new JSONObject(), JSON.parseObject("{}"));
+  }
+
+  @Test
+  public void testObjectEqualsNested() {
+    JSONObject a = JSON.parseObject("{\"inner\":{\"x\":1}}");
+    JSONObject b = JSON.parseObject("{\"inner\":{\"x\":1}}");
+    assertEquals(a, b);
+    assertEquals(a.hashCode(), b.hashCode());
+  }
+
+  @Test
+  public void testObjectNotEqualsNull() {
+    assertNotEquals(new JSONObject(), null);
+  }
+
+  @Test
+  public void testObjectNotEqualsOtherType() {
+    assertNotEquals(new JSONObject(), "{}");
+  }
+
+  @Test
+  public void testObjectEqualsSelf() {
+    JSONObject a = JSON.parseObject("{\"k\":1}");
+    assertEquals(a, a);
+  }
+
+  @Test
+  public void testObjectEqualsDifferentKeys() {
+    JSONObject a = JSON.parseObject("{\"a\":1}");
+    JSONObject b = JSON.parseObject("{\"b\":1}");
+    assertNotEquals(a, b);
+  }
+
+  @Test
+  public void testObjectEqualsKeyOrderIndependent() {
+    // Jackson ObjectNode.equals is order-independent, same as Fastjson HashMap
+    JSONObject a = JSON.parseObject("{\"x\":1,\"y\":2}");
+    JSONObject b = JSON.parseObject("{\"y\":2,\"x\":1}");
+    assertEquals(a, b);
+    assertEquals(a.hashCode(), b.hashCode());
+  }
 }