feat(api): add displayName and keywords to perpAnnotation

Author: github-actions[bot]

docs/SUMMARY.md

@@ -391,6 +391,17 @@
           kind: openapi
           spec: hl-info-outcomeMeta
     ```
+  - ```yaml
+    type: builtin:openapi
+    props:
+      models: false
+      downloadLink: false
+    dependencies:
+      spec:
+        ref:
+          kind: openapi
+          spec: hl-info-perpAnnotation
+    ```
   - ```yaml
     type: builtin:openapi
     props:

src/api/exchange/_methods/perpDeploy.ts

@@ -200,6 +200,10 @@ export const PerpDeployRequest = /* @__PURE__ */ (() => {
           category: v.string(),
           /** Detailed description (max 400 characters). */
           description: v.string(),
+          /** Display name for frontends to use instead of the L1 name, or null to ignore. */
+          displayName: v.nullable(v.string()),
+          /** Keywords used as hints to match against searches. */
+          keywords: v.array(v.string()),
         }),
       }),
     ]),

src/api/info/_methods/perpAnnotation.ts

@@ -27,6 +27,10 @@ export type PerpAnnotationResponse = {
   category: string;
   /** Human-readable description of the category. */
   description: string;
+  /** Display name for frontends to use instead of the L1 name. */
+  displayName?: string;
+  /** Keywords used as hints to match against searches. */
+  keywords?: string[];
 } | null;
 
 // ============================================================

tests/api/exchange/perpDeploy.test.ts

@@ -148,7 +148,15 @@ runTest({
       { setMarginModes: [["TEST0", "noCross"], ["TEST1", "strictIsolated"]] },
       { setFeeScale: { dex: "test", scale: "2.5" } },
       { setGrowthModes: [["TEST0", true]] },
-      { setPerpAnnotation: { coin: "TEST0", category: "other", description: "other perps" } },
+      {
+        setPerpAnnotation: {
+          coin: "TEST0",
+          category: "other",
+          description: "other perps",
+          displayName: null,
+          keywords: [],
+        },
+      },
     ];
 
     await Promise.all(params.map((p) =>