feat(generator): build full SDK generation foundation

.gitignore

@@ -22,6 +22,7 @@ dependency-reduced-pom.xml
 tmp/
 
 ai-docs/
+docs/
 
 # SDK generator download + OpenAPI CLI output
 generated/

Makefile

@@ -1,10 +1,20 @@
-.PHONY: fetch-spec compile format
+.PHONY: fetch-spec compile format generate check-generated generate-live-diff
+
 fetch-spec:
-	@mkdir -p apiSpec
-	@curl -fsSL -o apiSpec/prime-public-spec.yaml https://api.prime.coinbase.com/v1/openapi.yaml
+	mvn -B -f tools/model-generator/pom.xml compile exec:java@generate-models -Dexec.args="--fetch-spec"
 
 compile:
 	mvn -B compile
 
 format:
 	mvn -B spotless:apply
+
+generate:
+	mvn -B -f tools/model-generator/pom.xml compile exec:java@generate-models
+	mvn -B spotless:apply
+
+check-generated:
+	mvn -B -f tools/model-generator/pom.xml compile exec:java@generate-models -Dexec.args="--check"
+
+generate-live-diff:
+	mvn -B -f tools/model-generator/pom.xml compile exec:java@generate-models -Dexec.args="--live-diff"

src/main/java/com/coinbase/prime/client/CoinbasePrimeClient.java

@@ -29,21 +29,31 @@
 import java.util.List;
 
 public class CoinbasePrimeClient extends CoinbaseNetHttpClient {
+  private final String baseUrl;
+
   public CoinbasePrimeClient(CoinbasePrimeCredentials credentials, String baseUrl) {
     super(credentials, baseUrl);
+    this.baseUrl = baseUrl;
   }
 
   public CoinbasePrimeClient(
       CoinbasePrimeCredentials credentials, String baseUrl, HttpClient client) {
     super(credentials, baseUrl, client);
+    this.baseUrl = baseUrl;
   }
 
   public CoinbasePrimeClient(CoinbasePrimeCredentials credentials) {
     super(credentials, Constants.CB_PRIME_BASE_URL);
+    this.baseUrl = Constants.CB_PRIME_BASE_URL;
   }
 
   public CoinbasePrimeClient(CoinbasePrimeCredentials credentials, HttpClient client) {
     super(credentials, Constants.CB_PRIME_BASE_URL, client);
+    this.baseUrl = Constants.CB_PRIME_BASE_URL;
+  }
+
+  public String getBaseUrl() {
+    return baseUrl;
   }
 
   /**

tools/model-generator/.openapi-generator-ignore

@@ -6,12 +6,9 @@
 src/main/java/com/coinbase/prime/model/*Request.java
 src/main/java/com/coinbase/prime/model/*Response.java
 
-# Per-operation typed error payloads and codes (not consumed by the SDK yet)
+# Per-operation typed error payloads are not consumed by the SDK yet. ErrorCode and
+# Subcode enums are intentionally generated and routed to model/errors by PostProcessor.
 src/main/java/com/coinbase/prime/model/*ErrorResponse.java
-src/main/java/com/coinbase/prime/model/*ErrorCode.java
-src/main/java/com/coinbase/prime/model/*Subcode.java
-src/main/java/com/coinbase/prime/model/enums/*ErrorCode.java
-src/main/java/com/coinbase/prime/model/enums/*Subcode.java
 
 # Google infrastructure types (google.type.Date is generated as GoogleTypeDate and renamed to DateOfBirth)
 src/main/java/com/coinbase/prime/model/GoogleProtobufAny.java

tools/model-generator/config/generator-config.json

@@ -0,0 +1,26 @@
+{
+  "specUrl": "https://api.prime.coinbase.com/v1/openapi.yaml",
+  "committedSpecPath": "apiSpec/prime-public-spec.yaml",
+  "tagToFolderOverrides": {
+    "Travel Rule": "transactions"
+  },
+  "modelTypeMappings": {
+    "CreateOnchainTransactionRequestEVMParams": "EvmParams",
+    "CreateOnchainTransactionRequestEvmParams": "EvmParams",
+    "FcmFuturesSweepRequestAmount": "SweepAmount",
+    "FcmFuturesSweep": "FuturesSweep",
+    "EvmParam": "EvmParams",
+    "RPC": "RpcConfig",
+    "XMControlStatus": "PrimeXMControlStatus",
+    "XMMarginLevel": "PrimeXMMarginLevel"
+  },
+  "sharedModelMappings": {
+    "PaginatedResponse": "com.coinbase.prime.common.Pagination"
+  },
+  "protectedCompatibilityFiles": [
+    "com/coinbase/prime/portfolios/GetPortfolioCounterpartyIdRequest.java",
+    "com/coinbase/prime/portfolios/GetPortfolioCounterpartyIdResponse.java",
+    "com/coinbase/prime/portfolios/PortfoliosService.java",
+    "com/coinbase/prime/portfolios/PortfoliosServiceImpl.java"
+  ]
+}

tools/model-generator/config/naming-parity.json

@@ -0,0 +1,100 @@
+[
+  {
+    "operationId": "PrimeRESTAPI_CreateWalletTransfer",
+    "canonicalJavaMethod": "createTransfer",
+    "legacyJavaAliases": ["createWalletTransfer"],
+    "serviceFolder": "transactions",
+    "aliasBehavior": "requestResponseSubclass"
+  },
+  {
+    "operationId": "PrimeRESTAPI_CreateWalletWithdrawal",
+    "canonicalJavaMethod": "createWithdrawal",
+    "legacyJavaAliases": ["createWalletWithdrawal"],
+    "serviceFolder": "transactions",
+    "aliasBehavior": "requestResponseSubclass"
+  },
+  {
+    "operationId": "PrimeRESTAPI_GetOrder",
+    "canonicalJavaMethod": "getOrder",
+    "legacyJavaAliases": ["getOrderByOrderId"],
+    "serviceFolder": "orders",
+    "aliasBehavior": "requestResponseSubclass"
+  },
+  {
+    "operationId": "PrimeRESTAPI_StakingClaimRewards",
+    "canonicalJavaMethod": "claimStakingRewards",
+    "legacyJavaAliases": ["claimRewards"],
+    "serviceFolder": "staking",
+    "aliasBehavior": "requestResponseSubclass"
+  },
+  {
+    "operationId": "PrimeRESTAPI_PortfolioStakingInitiate",
+    "canonicalJavaMethod": "createPortfolioStake",
+    "legacyJavaAliases": ["portfolioStakingInitiate"],
+    "serviceFolder": "staking",
+    "aliasBehavior": "requestResponseSubclass"
+  },
+  {
+    "operationId": "PrimeRESTAPI_PortfolioStakingUnstake",
+    "canonicalJavaMethod": "createPortfolioUnstake",
+    "legacyJavaAliases": ["portfolioStakingUnstake"],
+    "serviceFolder": "staking",
+    "aliasBehavior": "requestResponseSubclass"
+  },
+  {
+    "operationId": "PrimeRESTAPI_GetEntityPaymentMethods",
+    "canonicalJavaMethod": "listEntityPaymentMethods",
+    "legacyJavaAliases": ["listPaymentMethods"],
+    "serviceFolder": "paymentmethods",
+    "aliasBehavior": "requestResponseSubclass"
+  },
+  {
+    "operationId": "PrimeRESTAPI_GetEntityPaymentMethodDetails",
+    "canonicalJavaMethod": "getEntityPaymentMethod",
+    "legacyJavaAliases": ["getPaymentMethodDetails"],
+    "serviceFolder": "paymentmethods",
+    "aliasBehavior": "requestResponseSubclass"
+  },
+  {
+    "operationId": "PrimeRESTAPI_GetPortfolioActivities",
+    "canonicalJavaMethod": "listActivities",
+    "legacyJavaAliases": ["listPortfolioActivities"],
+    "serviceFolder": "activities",
+    "aliasBehavior": "requestResponseSubclass"
+  },
+  {
+    "operationId": "PrimeRESTAPI_GetPortfolioAddressBook",
+    "canonicalJavaMethod": "getAddressBook",
+    "legacyJavaAliases": ["listAddressBook"],
+    "serviceFolder": "addressbook",
+    "aliasBehavior": "requestResponseSubclass"
+  },
+  {
+    "operationId": "PrimeRESTAPI_GetAllocationsByClientNettingId",
+    "canonicalJavaMethod": "getAllocationsByClientNettingId",
+    "legacyJavaAliases": ["listAllocationsByNettingId"],
+    "serviceFolder": "allocations",
+    "aliasBehavior": "requestResponseSubclass"
+  },
+  {
+    "operationId": "PrimeRESTAPI_GetEntityUsers",
+    "canonicalJavaMethod": "listEntityUsers",
+    "legacyJavaAliases": [],
+    "serviceFolder": "users",
+    "aliasBehavior": "none"
+  },
+  {
+    "operationId": "PrimeRESTAPI_GetFcmBalance",
+    "canonicalJavaMethod": "getEntityFcmBalance",
+    "legacyJavaAliases": [],
+    "serviceFolder": "futures",
+    "aliasBehavior": "none"
+  },
+  {
+    "operationId": "PrimeRESTAPI_GetPortfolioCounterpartyID",
+    "canonicalJavaMethod": "getPortfolioCounterpartyId",
+    "legacyJavaAliases": [],
+    "serviceFolder": "advancedtransfer",
+    "aliasBehavior": "none"
+  }
+]