feat: #490 Add new methods getFirst(), clone() to AddressIterator

core-api/src/main/java/com/bloxbean/cardano/client/api/AddressIterator.java

@@ -9,9 +9,25 @@
  * UtxoSelectionStrategy implementation.
  */
 public interface AddressIterator extends Iterator<Address> {
+
+    /**
+     * Retrieves the first address in the iterator's list of addresses without moving the cursor.
+     *
+     * @return the first {@link Address} in the list, or null if the list is empty.
+     */
+    Address getFirst();
+
     /**
      * Reset the pointer to the beginning
      */
     void reset();
 
+    /**
+     * Creates and returns a copy of this AddressIterator.
+     * The cloned instance is independent of the original and can be used separately.
+     *
+     * @return a new AddressIterator instance that is a copy of the current iterator.
+     */
+    AddressIterator clone();
+
 }

core-api/src/main/java/com/bloxbean/cardano/client/api/common/AddressIterators.java

@@ -12,6 +12,10 @@ public static AddressIterator of(Address address) {
         return new SingleAddressIterator(address);
     }
 
+    public static AddressIterator of(String address) {
+        return new SingleAddressIterator(new Address(address));
+    }
+
     static class SingleAddressIterator implements AddressIterator {
         private Address address;
         private Iterator<Address> iterator;
@@ -31,9 +35,19 @@ public Address next() {
             return iterator.next();
         }
 
+        @Override
+        public Address getFirst() {
+            return address;
+        }
+
         @Override
         public void reset() {
             this.iterator = List.of(address).iterator();
         }
+
+        @Override
+        public AddressIterator clone() {
+            return new SingleAddressIterator(address);
+        }
     }
 }