test(runtime): add DOT integration tests (runtimeVersion + account storage) with logging and network guards; docs: strengthen testing and local.properties guidance

Author: WRRicht3r

AGENTS.md

@@ -43,6 +43,8 @@
 - Run: module `testDebugUnitTest` (or `testDevelopDebugUnitTest`), or root `runTest`.
 - Coverage: maintain/raise JaCoCo coverage for changed code.
 - New code policy: every time you add a function, create at least one unit test for it (minimum), placed in the corresponding module under `src/test`.
+- Integration (DOT): add instrumentation/integration tests that hit a reachable Polkadot node and log key responses (e.g., runtimeVersion, balances, fees). Guard with assumptions so tests skip when network is unavailable.
+- Logs: when testing DOT, log the raw RPC response and parsed model to aid debugging; never log secrets.
 
 ## Commit & Pull Requests
 - Commits: imperative, concise subject; reference issues (`#123`). Prefer Conventional Commits (`feat:`, `fix:`, `refactor:`) when possible.
@@ -67,6 +69,12 @@
 - Create a root-level `local.properties` with the required secrets and service credentials. Do NOT commit this file.
 - See `docs/samples/local.properties.example` and create a private `local.properties` at the repo root; replace placeholders with your real values.
 - Typical keys include: MoonPay, PayWings (Sora Card), X1 plugin, Google Web Client IDs, Ethereum providers (Blast, Etherscan/BscScan/PolygonScan/OKLink), WalletConnect, Alchemy, Dwellir, TON API.
+- Formats: use `key=value` per line; avoid trailing spaces. Strings may be unquoted; if values contain special characters or spaces, wrap in double quotes. Set `sdk.dir=/absolute/path/to/Android/sdk` to avoid SDK lookup errors.
+- Runtime overrides (mirrors recommended for first run):
+  - `TYPES_URL_OVERRIDE=https://cdn.jsdelivr.net/gh/soramitsu/shared-features-utils@master/chains/all_chains_types_android.json`
+  - `DEFAULT_V13_TYPES_URL_OVERRIDE=https://cdn.jsdelivr.net/gh/soramitsu/shared-features-utils@master/chains/default_v13_types.json`
+  - `CHAINS_URL_OVERRIDE=https://cdn.jsdelivr.net/gh/soramitsu/shared-features-utils@master/chains/v13/chains.json`
+- Verify config: `./gradlew printPolkadotSdkAlignment` prints effective URLs and any shared_features pin before you run the app/tests.
 
 ## Utils Integration
 - Gradle maps the GitHub repo `soramitsu/fearless-utils-Android` as a source dependency and builds `jp.co.soramitsu.fearless-utils:fearless-utils` from source (requires network).

runtime/src/androidTest/java/jp/co/soramitsu/runtime/integration/DotBalanceIntegrationTest.kt

@@ -0,0 +1,82 @@
+package jp.co.soramitsu.runtime.integration
+
+import android.util.Log
+import org.junit.Assume.assumeTrue
+import org.junit.Test
+import java.io.BufferedReader
+import java.io.OutputStreamWriter
+import java.net.HttpURLConnection
+import java.net.URL
+
+/**
+ * Balance integration logger for Polkadot (DOT).
+ * This test logs the raw result of `state_getStorage` for a provided System.Account storage key.
+ *
+ * Usage:
+ *  - Provide a reachable RPC URL via system property or env var `DOT_RPC_URL`.
+ *  - Provide a precomputed storage key for System.Account(<SS58 accountId>) via `DOT_ACCOUNT_STORAGE_KEY`.
+ *    The key is SCALE-encoded and hashed as per substrate (pallet: "System", storage: "Account").
+ *  - Example run:
+ *      ./gradlew \
+ *        -Pandroid.testInstrumentationRunnerArguments.DOT_RPC_URL=https://polkadot-rpc.publicnode.com \
+ *        -Pandroid.testInstrumentationRunnerArguments.DOT_ACCOUNT_STORAGE_KEY=0x26aa394eea5630e07c48ae0c9558cef702a5...
+ *        :runtime:connectedDebugAndroidTest
+ */
+class DotBalanceIntegrationTest {
+
+    private fun hasNetwork(): Boolean = try {
+        val url = URL("https://www.google.com/generate_204")
+        (url.openConnection() as HttpURLConnection).run {
+            connectTimeout = 2000
+            readTimeout = 2000
+            requestMethod = "GET"
+            connect()
+            val ok = responseCode in 200..399
+            disconnect()
+            ok
+        }
+    } catch (_: Exception) { false }
+
+    @Test
+    fun testPolkadotAccountStorage_logsResponseOrSkips() {
+        assumeTrue("No network; skipping", hasNetwork())
+
+        val rpcUrl = System.getProperty("DOT_RPC_URL")
+            ?: System.getenv("DOT_RPC_URL")
+            ?: "https://polkadot-rpc.publicnode.com"
+
+        val storageKey = System.getProperty("DOT_ACCOUNT_STORAGE_KEY") ?: System.getenv("DOT_ACCOUNT_STORAGE_KEY")
+        assumeTrue("No DOT_ACCOUNT_STORAGE_KEY provided; skipping", !storageKey.isNullOrBlank())
+
+        val payload = """
+            {"jsonrpc":"2.0","method":"state_getStorage","params":["$storageKey"],"id":2}
+        """.trimIndent()
+
+        val response = httpPost(rpcUrl, payload)
+        Log.i("DotBalanceIntegrationTest", "RPC URL: $rpcUrl")
+        Log.i("DotBalanceIntegrationTest", "state_getStorage(Account) => $response")
+
+        // Basic sanity: expect non-empty hex or null
+        assumeTrue("Unexpected storage response", response.contains("result"))
+    }
+
+    private fun httpPost(urlStr: String, body: String): String {
+        val url = URL(urlStr)
+        val conn = (url.openConnection() as HttpURLConnection).apply {
+            requestMethod = "POST"
+            connectTimeout = 5000
+            readTimeout = 10000
+            doOutput = true
+            setRequestProperty("Content-Type", "application/json")
+        }
+
+        OutputStreamWriter(conn.outputStream, Charsets.UTF_8).use { it.write(body) }
+
+        val code = conn.responseCode
+        val stream = if (code in 200..299) conn.inputStream else conn.errorStream
+        val text = BufferedReader(stream.reader(Charsets.UTF_8)).use { it.readText() }
+        conn.disconnect()
+        return text
+    }
+}
+