feat: batch run examples

Author: jaymansfield

jot-examples/README.md

@@ -1,7 +1,10 @@
 # 🧩 Jot Examples
 
-Runnable examples that demonstrate how to use the **Jot (Polkadot Java SDK)** to connect to a node, query on-chain data, and submit transactions.  
-These examples are configured to run against the **Westend** test network and are intended to **succeed when run** using a funded test account.
+Runnable examples demonstrating how to use the Jot (Polkadot Java SDK) to connect to a node, query on-chain data, and submit transactions.
+
+All examples are configured for the **Westend** test network and are designed to run successfully when using a **funded** test account.
+
+> 💡 Note: For examples that submit extrinsics, **successfully** means the transaction is broadcast to the blockchain and a valid transaction hash is returned. Some calls may still fail at the protocol level (for example, attempting Staking.unbond on an account that is not currently staking).
 
 ---
 
@@ -29,11 +32,14 @@ From the `jot-examples` module:
 # Build everything
 mvn -q -DskipTests package
 
-# Run any example (Replace <ExampleClass> with one below)
-mvn exec:java -Dexec.mainClass="<ExampleClass>"
+# Run a specific example (Replace class with one below)
+mvn exec:java -Dexec.mainClass="com.method5.jot.examples.query.QueryAccountAndBalanceExample"
+
+# Run all examples not requiring funds
+mvn exec:java -Dexec.mainClass="com.method5.jot.util.RunAllReadOnly"
 
-# For example:
-# mvn exec:java -Dexec.mainClass="com.method5.jot.examples.query.QueryAccountAndBalanceExample"
+# Run all examples
+mvn exec:java -Dexec.mainClass="com.method5.jot.util.RunAll"
 ```
 
 ---

jot-examples/src/main/java/com/method5/jot/examples/extrinsic/BalancesTransferAllExample.java

@@ -21,8 +21,9 @@ public static void main(String[] args) throws Exception {
         }
     }
 
-    private static void execute(PolkadotWs api, SigningProvider signingProvider) throws Exception {
+    public static void execute(PolkadotWs api, SigningProvider signingProvider) throws Exception {
         logger.info("Balances Transfer Example");
+        logger.info("------------------------");
 
         // Destination address
         AccountId destination = AccountId.fromSS58("13NHcoGFJsHJoCYVsJrrv2ygLtz2XJSR17KrnA9QTNYz3Zkz");

jot-examples/src/main/java/com/method5/jot/examples/extrinsic/BalancesTransferAllowDeathExample.java

@@ -23,8 +23,9 @@ public static void main(String[] args) throws Exception {
         }
     }
 
-    private static void execute(PolkadotWs api, SigningProvider signingProvider) throws Exception {
+    public static void execute(PolkadotWs api, SigningProvider signingProvider) throws Exception {
         logger.info("Balances Transfer Allow Death Example");
+        logger.info("------------------------");
 
         // Destination address
         AccountId destination = AccountId.fromSS58("13NHcoGFJsHJoCYVsJrrv2ygLtz2XJSR17KrnA9QTNYz3Zkz");

jot-examples/src/main/java/com/method5/jot/examples/extrinsic/BalancesTransferKeepAliveExample.java

@@ -23,8 +23,9 @@ public static void main(String[] args) throws Exception {
         }
     }
 
-    private static void execute(PolkadotWs api, SigningProvider signingProvider) throws Exception {
+    public static void execute(PolkadotWs api, SigningProvider signingProvider) throws Exception {
         logger.info("Balances Transfer Keep Alive Example");
+        logger.info("------------------------");
 
         // Destination address
         AccountId destination = AccountId.fromSS58("13NHcoGFJsHJoCYVsJrrv2ygLtz2XJSR17KrnA9QTNYz3Zkz");

jot-examples/src/main/java/com/method5/jot/examples/extrinsic/ConvictionVotingRemoveVoteExample.java

@@ -20,8 +20,9 @@ public static void main(String[] args) throws Exception {
         }
     }
 
-    private static void execute(PolkadotWs api, SigningProvider signingProvider) throws Exception {
+    public static void execute(PolkadotWs api, SigningProvider signingProvider) throws Exception {
         logger.info("Conviction Voting Remove Vote Example");
+        logger.info("------------------------");
 
         // Referendum index
         int referendumIndex = 12345;

jot-examples/src/main/java/com/method5/jot/examples/extrinsic/ConvictionVotingVoteExample.java

@@ -24,8 +24,9 @@ public static void main(String[] args) throws Exception {
         }
     }
 
-    private static void execute(PolkadotWs api, SigningProvider signingProvider) throws Exception {
+    public static void execute(PolkadotWs api, SigningProvider signingProvider) throws Exception {
         logger.info("Conviction Voting Vote Example");
+        logger.info("------------------------");
 
         // Referendum index
         int referendumIndex = 12345;

jot-examples/src/main/java/com/method5/jot/examples/extrinsic/MultisigApproveAsMultiExample.java

@@ -27,8 +27,9 @@ public static void main(String[] args) throws Exception {
         }
     }
 
-    private static void execute(PolkadotWs api, SigningProvider signingProvider) throws Exception {
+    public static void execute(PolkadotWs api, SigningProvider signingProvider) throws Exception {
         logger.info("Multisig Approve As Multi Example");
+        logger.info("------------------------");
 
         // Multisig participants
         List<AccountId> signers = Arrays.asList(

jot-examples/src/main/java/com/method5/jot/examples/extrinsic/MultisigAsMultiExample.java

@@ -27,8 +27,9 @@ public static void main(String[] args) throws Exception {
         }
     }
 
-    private static void execute(PolkadotWs api, SigningProvider signingProvider) throws Exception {
+    public static void execute(PolkadotWs api, SigningProvider signingProvider) throws Exception {
         logger.info("Multisig As Multi Example");
+        logger.info("------------------------");
 
         // Multisig participants
         List<AccountId> signers = Arrays.asList(

jot-examples/src/main/java/com/method5/jot/examples/extrinsic/OfflineSigningExample.java

@@ -26,15 +26,18 @@ public static void main(String[] args) throws Exception {
         }
     }
 
-    private static void execute(OfflineApi api, SigningProvider signingProvider) throws Exception {
+    public static void execute(OfflineApi api, SigningProvider signingProvider) throws Exception {
+        logger.info("Offline Signing Example");
+        logger.info("------------------------");
+
         // Call to submit and retrieve results for
         Call call = api.tx().system().remark("test");
 
         // Submit to RPC and wait for result
         String signedExtrinsic = call.signOffline(signingProvider, nonce);
 
         // Result
-        logger.info("Signed extrinsic: {}", signedExtrinsic);
+        logger.info("Created signed extrinsic for System.remark(\"test\"): {}", signedExtrinsic);
     }
 
     static

jot-examples/src/main/java/com/method5/jot/examples/extrinsic/ReceiveExtrinsicResultExample.java

@@ -21,14 +21,21 @@ public static void main(String[] args) throws Exception {
         }
     }
 
-    private static void execute(PolkadotWs api, SigningProvider signingProvider) throws Exception {
+    public static void execute(PolkadotWs api, SigningProvider signingProvider) throws Exception {
+        logger.info("Retrieve Extrinsic Result Example");
+        logger.info("------------------------");
+
         // Call to submit and retrieve results for
         Call call = api.tx().system().remark("test");
 
+        logger.info("Submitting extrinsic..");
+
         // Submit to RPC and wait for result
         ExtrinsicResult result = call.signAndWaitForResults(signingProvider);
 
         // Result
+        logger.info("Hash: {}", result.getHash());
+
         logger.info("Successful: {}", result.isSuccess());
 
         // Individual events related to extrinsic