[AI] Rename Chat API to Blockchain LLM and add transaction execution docs

Author: joaquim-verges

apps/playground-web/src/app/ai/chat/page.tsx

@@ -13,6 +13,6 @@ export default function ChatPage() {
 }
 
 export const metadata = {
-  title: "AI Chat API - Playground",
+  title: "Blockchain LLM - Playground",
   description: "Chat with thirdweb AI for blockchain interactions",
 };

apps/playground-web/src/app/navLinks.ts

@@ -18,7 +18,7 @@ const ai: ShadcnSidebarLink = {
   links: [
     {
       href: "/ai/chat",
-      label: "Chat API",
+      label: "Blockchain LLM",
     },
   ],
 };

apps/portal/src/app/Header.tsx

@@ -144,7 +144,7 @@ const apisLinks = [
 const aiLinks = [
   {
     href: "/ai/chat",
-    name: "Chat API",
+    name: "Blockchain LLM",
   },
   {
     href: "/ai/mcp",

apps/portal/src/app/ai/chat/execution/page.mdx

@@ -0,0 +1,59 @@
+import {OpenApiEndpoint} from "@doc";
+
+# Transaction Execution
+
+thirdweb AI can either auto execute transactions or prepare them for signing.
+
+- **Auto Execute**: The API will auto execute the transaction. Requires wallet authentication.
+- **Prepare for Signing**: The API will only prepare the transaction for signing. The user will need to sign the transaction manually.
+
+## Auto Execute
+
+Requirements:
+
+- The context object must be set with:
+  - `from` set to the wallet address to execute the transaction from
+  - `auto_execute_transaction` set to `true`
+  - (Optional) `chain_ids` set to the chain IDs to execute the transaction on
+- The API must be called with either:
+  - your `x-secret-key` header for server wallet authentication
+  - OR a `Authorization` header with a valid wallet JWT for user wallet authentication
+
+Model behavior:
+
+If all the requirements are met, the transaction will be executed automatically and the model will return a message with the transaction ID.
+
+It will also include an `actions` array with a `monitor_transaction` action. This action can be used to monitor the transaction status and get the transaction receipt via the thirdweb API.
+
+<OpenApiEndpoint path="/ai/chat" method="POST" requestBodyOverride={{
+  "messages": [
+    {
+      "role": "user",
+      "content": "Transfer 10 USDC to vitalik.eth"
+    }
+  ],
+  "context": {
+    "from": "0x...",
+    "auto_execute_transaction": true,
+    "chain_ids": [8453]
+  }
+}} responseExampleOverride={{
+  "message": "I've sent 10 USDC to Vitalik's wallet with transaction ID 11cd95e3-c0ee-4468-97c1-fd05dc919cdb. It should be confirmed in a few seconds.",
+  "session_id": "123",
+  "request_id": "456",
+  "actions": [{
+    "session_id": "8d1bfac4-e6c0-473b-bbb6-649f459d37e6",
+    "request_id": "79066871-b86f-4814-8027-5f34d99df389",
+    "source": "model",
+    "type": "monitor_transaction",
+    "data": {
+        "transaction_id": "11cd95e3-c0ee-4468-97c1-fd05dc919cdb"
+    }
+}]
+}} />
+
+## Prepare for Signing
+
+When the `auto_execute` parameter is set to `false` or omitted, the API will prepare the transaction for signing and return the transaction data in the `actions` array as a 'sign_transaction' action type.
+
+<OpenApiEndpoint path="/ai/chat" method="POST" />

apps/portal/src/app/ai/chat/page.mdx

@@ -1,14 +1,14 @@
 import { Tabs, TabsContent, TabsList, TabsTrigger, OpenApiEndpoint } from "@doc";
 
-# Chat API
+# Blockchain LLM
 
-The thirdweb AI chat API is a standard OpenAI-compatible chat completion API that allows you to interact with the thirdweb AI model, optimized for blockchain interactions.
+The thirdweb API exposes a standard OpenAI-compatible chat completion API that allows you to interact with the thirdweb AI model, optimized for blockchain interactions.
 
 - Query real-time data from the blockchain
 - Analyze transactions
 - Fetch token balances, prices and metadata
-- Prepare any contract call or transaction for signing
-- Prepare swaps from/to any token pair
+- Execute or prepare any contract call or transaction
+- Execute or prepare swaps from/to any token pair
 - Deploy contracts
 - Generate images
 - Search the web

apps/portal/src/app/ai/sidebar.tsx

@@ -4,7 +4,7 @@ import type { SideBar } from "@/components/Layouts/DocLayout";
 export const sidebar: SideBar = {
   links: [
     {
-      name: "Chat API",
+      name: "Blockchain LLM",
       isCollapsible: false,
       links: [
         {
@@ -17,6 +17,10 @@ export const sidebar: SideBar = {
           href: "https://playground.thirdweb.com/ai/chat",
           icon: <ExternalLinkIcon />,
         },
+        {
+          name: "Transaction Execution",
+          href: "/ai/chat/execution",
+        },
         {
           name: "Streaming Responses",
           href: "/ai/chat/streaming",

apps/portal/src/app/page.tsx

@@ -84,7 +84,7 @@ function AISection() {
           description="Integrate the most advanced blockchain model into your applications"
           href="/ai/chat"
           icon={MessageCircleIcon}
-          title="Chat API"
+          title="Blockchain LLM"
         />
         <ArticleCardIndex
           description="For agents and humans. Use the thirdweb API with natural language"