fixes

Author: joaquim-verges

apps/portal/src/app/contracts/deploy/page.mdx

@@ -1,3 +1,14 @@
+import { OpenApiEndpoint, createMetadata } from "@doc";
+
+export const metadata = createMetadata({
+	image: {
+		title: "Deploy contracts",
+		icon: "contracts",
+	},
+	title: "Deploy Contracts",
+	description: "Deploy contracts on any EVM chain.",
+});
+
 # Deploy Contracts
 
 You can deploy contracts via CLI or programatically.
@@ -16,8 +27,6 @@ You can also publish your contract to be deployable by anyone on any chain.
 npx thirdweb publish -k <project-secret-key>
 ```
 
-
-
 ## Deploying via SDK
 
 You can deploy contracts from ABI and bytecode.
@@ -26,15 +35,15 @@ You can deploy contracts from ABI and bytecode.
 import { deployContract } from "thirdweb/deploys";
 
 const address = await deployContract({
-  client,
-  chain,
-  bytecode: "0x...",
-  abi: contractAbi,
-  constructorParams: {
-    param1: "value1",
-    param2: 123,
-  },
-  salt, // optional: salt enables deterministic deploys
+	client,
+	chain,
+	bytecode: "0x...",
+	abi: contractAbi,
+	constructorParams: {
+		param1: "value1",
+		param2: 123,
+	},
+	salt, // optional: salt enables deterministic deploys
 });
 ```
 
@@ -44,14 +53,26 @@ Or alternatively, you can deploy a contract from a previously published contract
 import { deployPublishedContract } from "thirdweb/deploys";
 
 const address = await deployPublishedContract({
-  client,
-  chain,
-  account,
-  contractId: "MyPublishedContract",
-  contractParams: {
-    param1: "value1",
-    param2: 123,
-  },
-  publisher: "0x...", // optional, defaults to the thirdweb deployer
+	client,
+	chain,
+	account,
+	contractId: "MyPublishedContract",
+	contractParams: {
+		param1: "value1",
+		param2: 123,
+	},
+	publisher: "0x...", // optional, defaults to the thirdweb deployer
 });
-```
+```
+
+## Deploy via API
+
+You can also deploy contracts via API by passing the contract bytecode and ABI. This will automatically verify the contract on block explorers and add it to your project dashboard.
+
+<OpenApiEndpoint path="/v1/contracts" method="POST" />
+
+## List all deployed contracts
+
+You can list all deployed contracts for your project.
+
+<OpenApiEndpoint path="/v1/contracts" method="GET" />

apps/portal/src/app/contracts/page.mdx

@@ -71,19 +71,15 @@ Read, write, and deploy smart contracts on any EVM compatible blockchain.
 
     ### Read from Contracts
 
+    You can efficiently read data from multiple functions or contracts in a single request.
+
     <OpenApiEndpoint path="/v1/contracts/read" method="POST" />
 
     ### Write to Contracts
 
-	<OpenApiEndpoint path="/v1/contracts/write" method="POST" />
-
-    ### Deploy Contracts
+    You can write multiple functions to multiple contracts on the same chain in a single request atomically, which will result in a single transaction for optimal gas efficiency.
 
-    <OpenApiEndpoint path="/v1/contracts" method="POST" />
-
-    ### List Contracts
-
-    <OpenApiEndpoint path="/v1/contracts" method="GET" />
+	<OpenApiEndpoint path="/v1/contracts/write" method="POST" />
 
   </TabsContent>
 

apps/portal/src/app/transactions/monitor/page.mdx

@@ -39,7 +39,15 @@ Monitor and get notified about transactions in your application, both on your pr
 
   <TabsContent value="http">
 
+  ### Get transaction status
+
+  Get the information about a transaction by its id.
+
   <OpenApiEndpoint path="/v1/transactions/{transactionId}" method="GET" />
+  
+  ### List transactions
+
+  List all transactions for your project with filtering and pagination.
 
 <OpenApiEndpoint path="/v1/transactions" method="GET" />
 

apps/portal/src/app/transactions/sponsor/page.mdx

@@ -57,6 +57,8 @@ Sponsor gas fees using [EIP-7702](https://eips.ethereum.org/EIPS/eip-7702), enab
 
   EIP-7702 is the default execution mode in the [thirdweb API](https://api.thirdweb.com/reference) for your user and server wallets.
 
+Example sponsored contract write request:
+
 <OpenApiEndpoint path="/v1/contracts/write" method="POST" />
 
   </TabsContent>

apps/portal/src/app/wallets/server/page.mdx

@@ -33,9 +33,38 @@ Server wallets are wallets that are managed by your own application, like a trea
 
 Once created, you can use your server wallet by passing it as the `from` field of the [thirdweb API](https://api.thirdweb.com/reference#tag/transactions/post/v1/transactions).
 
+### Create a new Server Wallet
+
+You can create new server wallets via API by just passing an identifier. This can be any string, but we recommend using a descriptive name.
+
 <OpenApiEndpoint path="/v1/wallets/server" method="POST" />
 
-<OpenApiEndpoint path="/v1/wallets/server" method="GET" />
+### List all Server Wallets
+
+You can also list all server wallets for your project to get their addresses and identifiers.
+
+<OpenApiEndpoint path="/v1/wallets/server" method="GET" responseExampleOverride={{
+    result: {
+      pagination: {
+        hasMore: false,
+        limit: 20,
+        page: 1,
+      },
+      wallets: [
+        {
+          address: "string",
+          profiles: [
+            {
+              type: "server",
+              identifier: "string",
+            },
+          ],
+          createdAt: "string",
+          smartWalletAddress: "string",
+        },
+      ],
+    }
+}} />
 
   </TabsContent>
 

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

@@ -62,7 +62,7 @@ export function ApiEndpoint(props: { metadata: ApiEndpointMeta }) {
   return (
     <div>
       <div>
-        <Heading anchorId="request" className="text-lg lg:text-lg" level={2}>
+        <Heading anchorId="request" className="text-lg lg:text-lg" level={3}>
           Request
         </Heading>
         <div className="rounded-lg border">
@@ -116,7 +116,7 @@ export function ApiEndpoint(props: { metadata: ApiEndpointMeta }) {
       </div>
 
       <div>
-        <Heading anchorId="response" className="text-lg lg:text-lg" level={2}>
+        <Heading anchorId="response" className="text-lg lg:text-lg" level={3}>
           Response
         </Heading>
         <div className="overflow-hidden rounded-lg border">

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

@@ -370,7 +370,7 @@ function transformOpenApiToApiEndpointMeta(
 
   // Use override if provided, otherwise generate from OpenAPI spec
   if (responseExampleOverride) {
-    Object.assign(responseExamples, responseExampleOverride);
+    responseExamples["200"] = JSON.stringify(responseExampleOverride, null, 2);
   } else {
     for (const [statusCode, response] of Object.entries(operation.responses)) {
       const content = response.content;