@0xmonaco/core 1.0.33 → 1.0.34

package/dist/api/pitpass/api.d.ts

@@ -33,13 +33,36 @@
  * console.log(`Rewards remaining: ${result.rewardsBalance}`);
  * ```
  */
-import type { GetRewardsBalanceResponse, PitpassAPI, TraderCodeInfoResponse, TraderCodeResponse, TransferRewardsParams, TransferRewardsResponse } from "@0xmonaco/types";
+import type { GetRewardsBalanceResponse, PitpassAPI, TraderCodeAvailabilityResponse, TraderCodeInfoResponse, TraderCodeResponse, TransferRewardsParams, TransferRewardsResponse } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 export declare class PitpassAPIImpl extends BaseAPI implements PitpassAPI {
     /**
-     * Return the authenticated caller's TraderCode (their normalized wallet address).
+     * Return the authenticated caller's TraderCode.
+     *
+     * The response carries both the permanent wallet-derived `code` and the
+     * custom-handle fields (`customCode`, `isCustom`, `display`).
      */
     getMyTraderCode(): Promise<TraderCodeResponse>;
+    /**
+     * Claim or edit the caller's custom (vanity) TraderCode handle.
+     *
+     * The handle is validated client-side (letter-first `[A-Za-z0-9_]`, length
+     * 5–20) and sent exactly as entered — casing is preserved. The server is the
+     * authoritative gate (409 taken, 422 invalid, 429 rate-limited, 403 disabled).
+     */
+    setTraderCode(code: string): Promise<TraderCodeResponse>;
+    /**
+     * Clear the caller's custom TraderCode handle, reverting to the wallet-derived
+     * default. The freed handle enters a cooldown before it can be reclaimed.
+     */
+    clearTraderCode(): Promise<TraderCodeResponse>;
+    /**
+     * Public advisory check of whether a custom TraderCode handle is available.
+     *
+     * As-you-type UX helper only; the authoritative gate is the atomic claim in
+     * {@link setTraderCode}. Returns `available` and, when unavailable, a `reason`.
+     */
+    checkTraderCodeAvailability(code: string): Promise<TraderCodeAvailabilityResponse>;
     /**
      * Public lookup of a TraderCode by wallet address.
      * Accepts the bare address or the `Monaco - <address>` display form.

package/dist/api/pitpass/api.js

@@ -33,15 +33,57 @@
  * console.log(`Rewards remaining: ${result.rewardsBalance}`);
  * ```
  */
-import { TransferRewardsParamsSchema, validate } from "@0xmonaco/types";
+import { SetTraderCodeParamsSchema, TransferRewardsParamsSchema, validate } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 export class PitpassAPIImpl extends BaseAPI {
     /**
-     * Return the authenticated caller's TraderCode (their normalized wallet address).
+     * Return the authenticated caller's TraderCode.
+     *
+     * The response carries both the permanent wallet-derived `code` and the
+     * custom-handle fields (`customCode`, `isCustom`, `display`).
      */
     async getMyTraderCode() {
         return await this.makeAuthenticatedRequest("/api/v1/pitpass/codes/me", { method: "GET" });
     }
+    /**
+     * Claim or edit the caller's custom (vanity) TraderCode handle.
+     *
+     * The handle is validated client-side (letter-first `[A-Za-z0-9_]`, length
+     * 5–20) and sent exactly as entered — casing is preserved. The server is the
+     * authoritative gate (409 taken, 422 invalid, 429 rate-limited, 403 disabled).
+     */
+    async setTraderCode(code) {
+        const validated = validate(SetTraderCodeParamsSchema, { code });
+        return await this.makeAuthenticatedRequest("/api/v1/pitpass/codes/me/custom", {
+            method: "PUT",
+            body: JSON.stringify({ code: validated.code }),
+        });
+    }
+    /**
+     * Clear the caller's custom TraderCode handle, reverting to the wallet-derived
+     * default. The freed handle enters a cooldown before it can be reclaimed.
+     */
+    async clearTraderCode() {
+        return await this.makeAuthenticatedRequest("/api/v1/pitpass/codes/me/custom", { method: "DELETE" });
+    }
+    /**
+     * Public advisory check of whether a custom TraderCode handle is available.
+     *
+     * As-you-type UX helper only; the authoritative gate is the atomic claim in
+     * {@link setTraderCode}. Returns `available` and, when unavailable, a `reason`.
+     */
+    async checkTraderCodeAvailability(code) {
+        // Trim to mirror the claim path (setTraderCode validates a trimmed handle),
+        // so the advisory check and the eventual claim agree on padded input.
+        const query = new URLSearchParams({ code: code.trim() }).toString();
+        const raw = await this.makePublicRequest(`/api/v1/pitpass/codes/available?${query}`, {
+            method: "GET",
+        });
+        // The API always serializes `reason`, sending "" (proto3 string default)
+        // when the handle is available; surface that as an omitted `reason` so
+        // callers can rely on the documented ergonomic shape.
+        return { available: raw.available, reason: raw.reason ? raw.reason : undefined };
+    }
     /**
      * Public lookup of a TraderCode by wallet address.
      * Accepts the bare address or the `Monaco - <address>` display form.

package/dist/coverage.d.ts

@@ -34,6 +34,9 @@ export declare const COVERED: {
     get_my_trader_code: string;
     get_rewards_balance: string;
     get_trader_code_info: string;
+    set_trader_code: string;
+    clear_trader_code: string;
+    check_trader_code_availability: string;
     get_open_interest: string;
     get_order_by_id: string;
     get_orderbook_snapshot: string;

package/dist/coverage.js

@@ -34,6 +34,9 @@ export const COVERED = {
     get_my_trader_code: "pitpass.getMyTraderCode",
     get_rewards_balance: "pitpass.getRewardsBalance",
     get_trader_code_info: "pitpass.getTraderCodeInfo",
+    set_trader_code: "pitpass.setTraderCode",
+    clear_trader_code: "pitpass.clearTraderCode",
+    check_trader_code_availability: "pitpass.checkTraderCodeAvailability",
     get_open_interest: "getOpenInterest",
     get_order_by_id: "getOrder",
     get_orderbook_snapshot: "getOrderbook",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/core",
-	"version": "1.0.33",
+	"version": "1.0.34",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -23,8 +23,8 @@
 		"viem": "^2.45.2"
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.33",
-		"@0xmonaco/types": "1.0.33",
+		"@0xmonaco/contracts": "1.0.34",
+		"@0xmonaco/types": "1.0.34",
 		"@noble/curves": "^1.9.1",
 		"@noble/hashes": "^1.8.0",
 		"http-status-codes": "^2.3.0"