Move builder API onto TempoMethod/StripeMethod; delete standalone config classes

TempoMethod now exposes mainnet(), testnet(), custom(url, chainId) as public
static factories returning an inner Builder. StripeMethod exposes of(key, networkId)
the same way. No separate TempoConfig/StripeConfig classes needed.

Tempo.java updated to delegate to the new builders; all existing overloads kept
for backwards compat.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: raubrey2014

README.md

@@ -21,7 +21,7 @@ on mainnet it is USDC.
 // Mainnet:  TempoDefaults.MAINNET_USDC     = "0x20C000000000000000000000b9537d11c60E8b50"
 String currency = TempoDefaults.TESTNET_PATH_USD;
 
-TempoMethod tempo = TempoConfig.testnet().build();
+TempoMethod tempo = TempoMethod.testnet().build();
 MppHandler mppHandler = Mpp.create(tempo, "api.example.com", System.getenv("MPP_SECRET_KEY"));
 
 // In your HTTP handler:
@@ -60,10 +60,10 @@ or, if already broadcast:
 which Stripe profile to pay. Use your Stripe profile or network ID (e.g. `STRIPE_PROFILE_ID`).
 
 ```java
-TempoMethod tempo = TempoConfig.testnet().build();
+TempoMethod tempo = TempoMethod.testnet().build();
 MppHandler tempoHandler = Mpp.create(tempo, "api.example.com", System.getenv("MPP_SECRET_KEY"));
 
-StripeMethod stripe = StripeConfig.of(System.getenv("STRIPE_SECRET_KEY"), System.getenv("STRIPE_PROFILE_ID")).build();
+StripeMethod stripe = StripeMethod.of(System.getenv("STRIPE_SECRET_KEY"), System.getenv("STRIPE_PROFILE_ID")).build();
 MppHandler stripeHandler = Mpp.create(stripe, "api.example.com", System.getenv("MPP_SECRET_KEY"));
 
 ComposedHandler mppHandler = Mpp.compose(

src/main/java/com/stripe/mpp/methods/stripe/Stripe.java

@@ -22,16 +22,11 @@
 public final class Stripe {
     private Stripe() {}
 
-    /** Returns a {@link StripeMethod} from a {@link StripeConfig} builder. */
-    public static StripeMethod method(StripeConfig config) {
-        return config.build();
-    }
-
     /**
-     * Returns a {@link StripeMethod} with default USD / 2-decimal settings.
+     * Returns a {@link StripeMethod} with default settings.
      *
-     * @param secretKey     Stripe secret API key
-     * @param networkId     Stripe network identifier sent to the client in the challenge
+     * @param secretKey Stripe secret API key
+     * @param networkId Stripe profile/network identifier sent to the client in the challenge
      */
     public static StripeMethod method(String secretKey, String networkId) {
         return method(secretKey, networkId, null, null);

src/main/java/com/stripe/mpp/methods/stripe/StripeConfig.java

@@ -8,18 +8,15 @@
 import java.util.Map;
 
 /**
- * MPP payment method for Stripe. Obtain instances via {@link Stripe#method}.
+ * MPP payment method for Stripe.
  *
  * <pre>{@code
- * StripeMethod stripe = Stripe.method(secretKey, networkId);
+ * StripeMethod stripe = StripeMethod.of(secretKey, networkId).build();
  *
- * MppHandler server = Mpp.create(stripe, "api.example.com", secretKey);
- *
- * VerifyResult result = server.charge(
- *     request.getHeader("Authorization"),
- *     stripe.chargeIntent(),
- *     "10.00", "usd", networkId
- * );
+ * StripeMethod stripe = StripeMethod.of(secretKey, networkId)
+ *     .paymentMethods(List.of("card", "link"))
+ *     .metadata(Map.of("source", "mpp"))
+ *     .build();
  * }</pre>
  */
 public class StripeMethod implements Method {
@@ -42,6 +39,44 @@ public class StripeMethod implements Method {
         this.chargeIntent   = new StripeChargeIntent(secretKey, decimals, new StripeApi());
     }
 
+    /**
+     * Starts a builder for a Stripe payment method.
+     *
+     * @param secretKey Stripe secret API key
+     * @param networkId Stripe profile/network identifier sent to the client in the challenge
+     */
+    public static Builder of(String secretKey, String networkId) {
+        return new Builder(secretKey, networkId);
+    }
+
+    public static final class Builder {
+        private final String secretKey;
+        private final String networkId;
+        private List<String> paymentMethods;
+        private Map<String, String> metadata;
+
+        private Builder(String secretKey, String networkId) {
+            this.secretKey = secretKey;
+            this.networkId = networkId;
+        }
+
+        /** Restrict which Stripe payment method types the client may use (e.g. {@code "card"}, {@code "link"}). */
+        public Builder paymentMethods(List<String> paymentMethods) {
+            this.paymentMethods = paymentMethods;
+            return this;
+        }
+
+        /** Metadata attached to created Stripe PaymentIntents. */
+        public Builder metadata(Map<String, String> metadata) {
+            this.metadata = metadata;
+            return this;
+        }
+
+        public StripeMethod build() {
+            return new StripeMethod(secretKey, networkId, paymentMethods, metadata, StripeDefaults.DEFAULT_DECIMALS);
+        }
+    }
+
     @Override public String name() { return "stripe"; }
 
     @Override

src/main/java/com/stripe/mpp/methods/stripe/StripeMethod.java

@@ -3,51 +3,67 @@
 /**
  * Factory for Tempo payment objects.
  *
- * <pre>{@code
- * TempoMethod tempo = Tempo.method();                  // mainnet
- * TempoMethod tempo = Tempo.method(true);              // testnet (Moderato)
- *
- * MppHandler server = Mpp.create(tempo, "api.example.com", secretKey);
+ * <p>Prefer the named builders on {@link TempoMethod} directly:
  *
- * // In your HTTP handler:
- * VerifyResult result = server.charge(
- *     request.getHeader("Authorization"),
- *     Tempo.chargeIntent(),
- *     "10.000000", TempoDefaults.MAINNET_USDC, "0xRecipient"
- * );
+ * <pre>{@code
+ * TempoMethod tempo = TempoMethod.testnet().build();
+ * TempoMethod tempo = TempoMethod.mainnet().debug().build();
+ * TempoMethod tempo = TempoMethod.custom("http://localhost:8545", 1337).build();
  * }</pre>
+ *
+ * <p>The static helpers here are kept for backwards compatibility.
  */
 public final class Tempo {
     private Tempo() {}
 
-    /** Returns a {@link TempoMethod} from a {@link TempoConfig} builder. */
-    public static TempoMethod method(TempoConfig config) {
-        return config.build();
-    }
-
     /** Returns a {@link TempoMethod} configured for Tempo mainnet. */
     public static TempoMethod method() {
-        return method(false);
+        return TempoMethod.mainnet().build();
     }
 
     /**
-     * Returns a {@link TempoMethod} configured for Tempo mainnet or testnet (Moderato).
+     * Returns a {@link TempoMethod} for mainnet or testnet (Moderato).
      *
      * @param testnet {@code true} for Moderato testnet, {@code false} for mainnet
      */
     public static TempoMethod method(boolean testnet) {
-        return testnet ? TempoMethod.testnet() : TempoMethod.mainnet();
+        return (testnet ? TempoMethod.testnet() : TempoMethod.mainnet()).build();
     }
 
     /**
-     * Returns a {@link TempoMethod} configured for Tempo mainnet or testnet (Moderato), with
-     * optional debug logging of raw JSON-RPC request/response bodies.
+     * Returns a {@link TempoMethod} for mainnet or testnet, with optional debug logging.
      *
      * @param testnet {@code true} for Moderato testnet, {@code false} for mainnet
      * @param debug   {@code true} to log raw RPC request/response bodies at INFO level
      */
     public static TempoMethod method(boolean testnet, boolean debug) {
-        return testnet ? TempoMethod.testnet(debug) : TempoMethod.mainnet(debug);
+        TempoMethod.Builder b = testnet ? TempoMethod.testnet() : TempoMethod.mainnet();
+        if (debug) b.debug();
+        return b.build();
+    }
+
+    /**
+     * Returns a {@link TempoMethod} pointed at a custom RPC URL and chain ID.
+     *
+     * @param rpcUrl  JSON-RPC endpoint (e.g. {@code "http://localhost:8545"})
+     * @param chainId numeric EVM chain ID (e.g. {@code 1337})
+     */
+    public static TempoMethod method(String rpcUrl, int chainId) {
+        return TempoMethod.custom(rpcUrl, chainId).build();
+    }
+
+    /**
+     * Returns a {@link TempoMethod} pointed at a custom RPC URL and chain ID, with optional
+     * debug logging.
+     *
+     * @param rpcUrl  JSON-RPC endpoint (e.g. {@code "http://localhost:8545"})
+     * @param chainId numeric EVM chain ID (e.g. {@code 1337})
+     * @param debug   {@code true} to log raw RPC request/response bodies
+     */
+    public static TempoMethod method(String rpcUrl, int chainId, boolean debug) {
+        TempoMethod.Builder b = TempoMethod.custom(rpcUrl, chainId);
+        if (debug) b.debug();
+        return b.build();
     }
 
     /** Returns a {@link TempoChargeIntent} that submits payments on Tempo mainnet. */
@@ -66,7 +82,6 @@ public static TempoChargeIntent chargeIntent(boolean testnet) {
 
     /**
      * Returns a {@link TempoChargeIntent} pointed at a custom RPC URL.
-     * Useful for local development nodes or private networks.
      *
      * @param rpcUrl JSON-RPC endpoint (e.g. {@code "http://localhost:8545"})
      */
@@ -76,39 +91,11 @@ public static TempoChargeIntent chargeIntent(String rpcUrl) {
 
     /**
      * Returns a {@link TempoChargeIntent} pointed at a custom RPC URL with optional debug logging.
-     * When {@code debug} is {@code true}, raw JSON-RPC request and response bodies are logged at
-     * INFO level via {@code java.util.logging} under the logger name
-     * {@code com.stripe.mpp.methods.tempo.TempoRpc}.
      *
      * @param rpcUrl JSON-RPC endpoint (e.g. {@code "http://localhost:8545"})
      * @param debug  {@code true} to log raw RPC request/response bodies
      */
     public static TempoChargeIntent chargeIntent(String rpcUrl, boolean debug) {
         return new TempoChargeIntent(rpcUrl, debug);
     }
-
-    /**
-     * Returns a {@link TempoMethod} pointed at a custom RPC URL and chain ID.
-     * Useful for local development nodes or private networks.
-     *
-     * @param rpcUrl  JSON-RPC endpoint (e.g. {@code "http://localhost:8545"})
-     * @param chainId numeric EVM chain ID (e.g. {@code 1337})
-     */
-    public static TempoMethod method(String rpcUrl, int chainId) {
-        return new TempoMethod(rpcUrl, chainId);
-    }
-
-    /**
-     * Returns a {@link TempoMethod} pointed at a custom RPC URL and chain ID with optional debug
-     * logging. When {@code debug} is {@code true}, raw JSON-RPC request and response bodies are
-     * logged at INFO level via {@code java.util.logging} under the logger name
-     * {@code com.stripe.mpp.methods.tempo.TempoRpc}.
-     *
-     * @param rpcUrl  JSON-RPC endpoint (e.g. {@code "http://localhost:8545"})
-     * @param chainId numeric EVM chain ID (e.g. {@code 1337})
-     * @param debug   {@code true} to log raw RPC request/response bodies
-     */
-    public static TempoMethod method(String rpcUrl, int chainId, boolean debug) {
-        return new TempoMethod(rpcUrl, chainId, debug);
-    }
 }