feat: function to generate bridge URL

Author: nattb8

src/Packages/Marketplace/Runtime/Bridge.meta

@@ -0,0 +1,53 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+
+namespace Immutable.Marketplace.Bridge
+{
+    /// <summary>
+    /// Provides functionality for generating a link to the bridge flow, 
+    /// simplifying the process of moving tokens from and to the Immutable zkEVM network.
+    /// </summary>
+    public class Bridge
+    {
+        private readonly string _environment;
+        private static readonly Dictionary<string, string> BaseUrls = new()
+        {
+            { "sandbox", "https://checkout-playground.sandbox.immutable.com/checkout/squid" },
+            { "production", "https://toolkit.immutable.com/checkout/squid" }
+        };
+
+        /// <summary>
+        /// Initialises a new instance of the <see cref="Bridge"/> class.
+        /// </summary>
+        /// <param name="environment">Specifies the environment (<c>sandbox</c> or <c>production</c>).</param>
+        public Bridge(string environment)
+        {
+            _environment = environment;
+        }
+        
+        /// <summary>
+        /// Generates a link for the bridge flow.
+        /// </summary>
+        /// <param name="fromTokenAddress">The address of the token being moved from.</param>
+        /// <param name="fromChain">The ID of the source blockchain.</param>
+        /// <param name="toTokenAddress">The address of the token being moved to.</param>
+        /// <param name="toChain">The ID of the destination blockchain.</param>
+        /// <returns>A URL string for the bridge flow, including all necessary query parameters.</returns>
+        public string GetLink(string fromTokenAddress, string fromChain, string toTokenAddress, string toChain)
+        {
+            var baseUrl = BaseUrls[_environment];
+
+            var queryParams = new Dictionary<string, string>
+        {
+            {"fromToken", fromTokenAddress},
+            {"fromChain", fromChain},
+            {"toTokenAddress", toTokenAddress},
+            {"toChain", toChain}
+        };
+
+            var queryString = string.Join("&", queryParams.Select(kvp => $"{kvp.Key}={Uri.EscapeDataString(kvp.Value)}").ToArray());
+            return $"{baseUrl}?{queryString}";
+        }
+    }
+}