Merge upstream/main into feat/dart-bindings

Resolves conflicts with C# bindings that were merged separately.
Keeps Lua and Dart documentation in README.

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

Author: Nic-dorman

csharp/AntFfi/Client.cs

@@ -282,9 +282,11 @@ public async Task FileDownloadAsync(DataMapChunk dataMapChunk, string destPath,
     /// Estimates the cost to upload a file to the network.
     /// </summary>
     /// <param name="filePath">The path to the file.</param>
+    /// <param name="followSymlinks">Whether to follow symbolic links (default: true).</param>
+    /// <param name="includeHidden">Whether to include hidden files (default: false).</param>
     /// <param name="cancellationToken">Cancellation token.</param>
     /// <returns>The estimated cost as a string (in tokens).</returns>
-    public async Task<string> FileCostAsync(string filePath, CancellationToken cancellationToken = default)
+    public async Task<string> FileCostAsync(string filePath, bool followSymlinks = true, bool includeHidden = false, CancellationToken cancellationToken = default)
     {
         ThrowIfDisposed();
         ArgumentNullException.ThrowIfNull(filePath);
@@ -293,7 +295,7 @@ public async Task<string> FileCostAsync(string filePath, CancellationToken cance
             throw new FileNotFoundException("File not found", filePath);
 
         var pathBuffer = UniFFIHelpers.StringToRustBuffer(filePath);
-        var futureHandle = NativeMethods.ClientFileCost(CloneHandle(), pathBuffer);
+        var futureHandle = NativeMethods.ClientFileCost(CloneHandle(), pathBuffer, followSymlinks ? (sbyte)1 : (sbyte)0, includeHidden ? (sbyte)1 : (sbyte)0);
         var buffer = await AsyncFutureHelper.PollRustBufferAsync(futureHandle, cancellationToken);
         return UniFFIHelpers.StringFromRustBuffer(buffer);
     }

csharp/AntFfi/Native/NativeMethods.cs

@@ -735,7 +735,7 @@ internal static partial class NativeMethods
     public static extern IntPtr NetworkNew(sbyte isLocal, ref RustCallStatus status);
 
     [DllImport(LibName, CallingConvention = CallingConvention.Cdecl, EntryPoint = "uniffi_ant_ffi_fn_constructor_network_custom")]
-    public static extern IntPtr NetworkCustom(RustBuffer rpcUrl, RustBuffer paymentTokenAddress, RustBuffer dataPaymentsAddress, ref RustCallStatus status);
+    public static extern IntPtr NetworkCustom(RustBuffer rpcUrl, RustBuffer paymentTokenAddress, RustBuffer dataPaymentsAddress, RustBuffer royaltiesPkHex, ref RustCallStatus status);
 
     [DllImport(LibName, CallingConvention = CallingConvention.Cdecl, EntryPoint = "uniffi_ant_ffi_fn_free_network")]
     public static extern void FreeNetwork(IntPtr ptr, ref RustCallStatus status);
@@ -842,7 +842,7 @@ internal static partial class NativeMethods
     /// Async: Estimates the cost to upload a file to the network.
     /// </summary>
     [DllImport(LibName, CallingConvention = CallingConvention.Cdecl, EntryPoint = "uniffi_ant_ffi_fn_method_client_file_cost")]
-    public static extern ulong ClientFileCost(IntPtr ptr, RustBuffer filePath);
+    public static extern ulong ClientFileCost(IntPtr ptr, RustBuffer filePath, sbyte followSymlinks, sbyte includeHidden);
 
     #endregion
 

csharp/AntFfi/Native/UniFFIHelpers.cs

@@ -405,4 +405,34 @@ internal static string ReadStringFromRecordBuffer(RustBuffer buffer, bool freeBu
             }
         }
     }
+
+    /// <summary>
+    /// Creates a RustBuffer from an optional string in UniFFI Option format.
+    /// None: 1 byte (0), Some: 1 byte (1) + 4-byte BE length + UTF-8 bytes.
+    /// </summary>
+    /// <param name="str">The optional string to convert.</param>
+    /// <returns>A RustBuffer containing the serialized Option&lt;String&gt;.</returns>
+    public static RustBuffer OptionStringToRustBuffer(string? str)
+    {
+        byte[] rawBytes;
+        if (str == null)
+        {
+            // None variant: just a 0 byte
+            rawBytes = new byte[] { 0 };
+        }
+        else
+        {
+            // Some variant: 1 byte + 4-byte BE length + UTF-8 data
+            var utf8Bytes = System.Text.Encoding.UTF8.GetBytes(str);
+            rawBytes = new byte[1 + 4 + utf8Bytes.Length];
+            rawBytes[0] = 1; // Some
+            rawBytes[1] = (byte)(utf8Bytes.Length >> 24);
+            rawBytes[2] = (byte)(utf8Bytes.Length >> 16);
+            rawBytes[3] = (byte)(utf8Bytes.Length >> 8);
+            rawBytes[4] = (byte)utf8Bytes.Length;
+            Buffer.BlockCopy(utf8Bytes, 0, rawBytes, 5, utf8Bytes.Length);
+        }
+
+        return RawToRustBuffer(rawBytes);
+    }
 }

csharp/AntFfi/Network.cs

@@ -46,15 +46,17 @@ public static Network Create(bool isLocal)
     /// <param name="rpcUrl">RPC URL for the EVM network (e.g., "http://10.0.2.2:61611").</param>
     /// <param name="paymentTokenAddress">Payment token contract address (hex string).</param>
     /// <param name="dataPaymentsAddress">Data payments contract address (hex string).</param>
+    /// <param name="royaltiesPkHex">Optional royalties public key (hex string).</param>
     /// <returns>A new Network instance.</returns>
-    public static Network CreateCustom(string rpcUrl, string paymentTokenAddress, string dataPaymentsAddress)
+    public static Network CreateCustom(string rpcUrl, string paymentTokenAddress, string dataPaymentsAddress, string? royaltiesPkHex = null)
     {
         var rpcUrlBuffer = UniFFIHelpers.StringToRustBuffer(rpcUrl);
         var paymentTokenBuffer = UniFFIHelpers.StringToRustBuffer(paymentTokenAddress);
         var dataPaymentsBuffer = UniFFIHelpers.StringToRustBuffer(dataPaymentsAddress);
+        var royaltiesBuffer = UniFFIHelpers.OptionStringToRustBuffer(royaltiesPkHex);
 
         var status = RustCallStatus.Create();
-        var handle = NativeMethods.NetworkCustom(rpcUrlBuffer, paymentTokenBuffer, dataPaymentsBuffer, ref status);
+        var handle = NativeMethods.NetworkCustom(rpcUrlBuffer, paymentTokenBuffer, dataPaymentsBuffer, royaltiesBuffer, ref status);
         if (status.IsError)
             throw new NetworkException("Failed to create custom network", status);
         return new Network(handle, true);