more fixes

Author: joaquim-verges

apps/portal/src/app/wallets/pregenerate-wallets/page.mdx

@@ -24,7 +24,7 @@ Create wallets for users before they authenticate, enabling smoother onboarding
 
 ## API Reference
 
-<OpenApiEndpoint path="/v1/wallets/user/pregenerate" method="POST" />
+<OpenApiEndpoint path="/v1/wallets/user" method="POST" />
 
 <Callout variant='info' title='Ecosystem Requirements'>
 For ecosystem wallets, the secret key must be from the same account as the ecosystem owner.

apps/portal/src/components/Document/APIEndpointMeta/ApiEndpoint.tsx

@@ -247,8 +247,20 @@ function createCurlCommand(params: { metadata: ApiEndpointMeta }) {
     url += `?${queryParams}`;
   }
 
-  const headers = params.metadata.request.headers
-    .filter((h) => h.example !== undefined)
+  const displayHeaders = params.metadata.request.headers.filter(
+    (h) => h.example !== undefined,
+  );
+
+  // always show secret key header in examples
+  displayHeaders.push({
+    name: "x-secret-key",
+    example: "<your-project-secret-key>",
+    description:
+      "Project secret key - for backend usage only. Should not be used in frontend code.",
+    required: false,
+  });
+
+  const headers = displayHeaders
     .map((h) => {
       return `-H "${h.name}:${
         typeof h.example === "object" && h !== null
@@ -290,7 +302,28 @@ function createFetchCommand(params: { metadata: ApiEndpointMeta }) {
     url += `?${queryParams}`;
   }
 
-  for (const param of request.headers) {
+  const displayHeaders = request.headers.filter((h) => h.example !== undefined);
+
+  // always show secret key header in examples
+  if (params.metadata.path.includes("/v1/auth")) {
+    displayHeaders.push({
+      name: "x-client-id",
+      example: "<your-project-client-id>",
+      description:
+        "Project client ID - for frontend usage on authorized domains.",
+      required: false,
+    });
+  } else {
+    displayHeaders.push({
+      name: "x-secret-key",
+      example: "<your-project-secret-key>",
+      description:
+        "Project secret key - for backend usage only. Should not be used in frontend code.",
+      required: false,
+    });
+  }
+
+  for (const param of displayHeaders) {
     if (param.example !== undefined) {
       headersObj[param.name] = param.example;
     }

apps/portal/src/components/Document/APIEndpointMeta/OpenApiEndpoint.tsx

@@ -309,6 +309,34 @@ function transformOpenApiToApiEndpointMeta(
     }
   }
 
+  // push default headers hardcoded for now
+  headers.push({
+    name: "x-secret-key",
+    type: "backend",
+    description:
+      "Project secret key - for backend usage only. Should not be used in frontend code.",
+    required: false,
+    example: undefined,
+  });
+  headers.push({
+    name: "x-client-id",
+    type: "frontend",
+    description:
+      "Project client ID - for frontend usage on authorized domains.",
+    required: false,
+    example: undefined,
+  });
+
+  if (method === "POST" && !path.includes("/v1/contracts/read")) {
+    headers.push({
+      name: "Authorization",
+      type: "frontend",
+      description: "Bearer token (JWT) for user wallet authentication",
+      required: false,
+      example: undefined,
+    });
+  }
+
   // Transform request body parameters
   const bodyParameters: APIParameter[] = [];