@wopr-network/platform-core 1.49.5 → 1.50.0

package/dist/billing/crypto/__tests__/key-server.test.js

@@ -67,6 +67,7 @@ function mockDeps() {
                 displayName: "Bitcoin",
                 contractAddress: null,
                 confirmations: 6,
+                iconUrl: null,
             },
             {
                 id: "base-usdc",
@@ -76,6 +77,7 @@ function mockDeps() {
                 displayName: "USDC on Base",
                 contractAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                 confirmations: 12,
+                iconUrl: null,
             },
         ]),
         listAll: vi.fn(),
@@ -91,12 +93,14 @@ function mockDeps() {
             oracleAddress: "0x64c911996D3c6aC71f9b455B1E8E7266BcbD848F",
             xpub: null,
             displayOrder: 0,
+            iconUrl: null,
             enabled: true,
             rpcUrl: null,
         }),
         listByType: vi.fn(),
         upsert: vi.fn().mockResolvedValue(undefined),
         setEnabled: vi.fn().mockResolvedValue(undefined),
+        patchMetadata: vi.fn().mockResolvedValue(true),
     };
     return {
         db: createMockDb(),

package/dist/billing/crypto/client.d.ts

@@ -46,6 +46,7 @@ export interface ChainInfo {
     displayName: string;
     contractAddress: string | null;
     confirmations: number;
+    iconUrl: string | null;
 }
 /**
  * Client for the shared crypto key server.

package/dist/billing/crypto/key-server.js

@@ -218,6 +218,7 @@ export function createKeyServerApp(deps) {
             displayName: m.displayName,
             contractAddress: m.contractAddress,
             confirmations: m.confirmations,
+            iconUrl: m.iconUrl,
         })));
     });
     // --- Admin API ---
@@ -282,7 +283,8 @@ export function createKeyServerApp(deps) {
             decimals: body.decimals,
             displayName: body.display_name ?? `${body.token} on ${body.network}`,
             enabled: true,
-            displayOrder: 0,
+            displayOrder: body.display_order ?? 0,
+            iconUrl: body.icon_url ?? null,
             rpcUrl: body.rpc_url,
             oracleAddress: body.oracle_address ?? null,
             xpub: body.xpub,
@@ -291,6 +293,19 @@ export function createKeyServerApp(deps) {
         });
         return c.json({ id: body.id, path: `m/44'/${body.coin_type}'/${body.account_index}'` }, 201);
     });
+    /** PATCH /admin/chains/:id — update metadata (icon_url, display_order, display_name) */
+    app.patch("/admin/chains/:id", async (c) => {
+        const id = c.req.param("id");
+        const body = await c.req.json();
+        const updated = await deps.methodStore.patchMetadata(id, {
+            iconUrl: body.icon_url,
+            displayOrder: body.display_order,
+            displayName: body.display_name,
+        });
+        if (!updated)
+            return c.json({ id, updated: false }, 200);
+        return c.json({ id, updated: true });
+    });
     /** DELETE /admin/chains/:id — soft disable */
     app.delete("/admin/chains/:id", async (c) => {
         await deps.methodStore.setEnabled(c.req.param("id"), false);

package/dist/billing/crypto/payment-method-store.d.ts

@@ -9,6 +9,7 @@ export interface PaymentMethodRecord {
     displayName: string;
     enabled: boolean;
     displayOrder: number;
+    iconUrl: string | null;
     rpcUrl: string | null;
     oracleAddress: string | null;
     xpub: string | null;
@@ -28,6 +29,12 @@ export interface IPaymentMethodStore {
     upsert(method: PaymentMethodRecord): Promise<void>;
     /** Enable or disable a payment method (admin). */
     setEnabled(id: string, enabled: boolean): Promise<void>;
+    /** Partial update of metadata fields (no read-modify-write needed). */
+    patchMetadata(id: string, patch: {
+        iconUrl?: string | null;
+        displayOrder?: number;
+        displayName?: string;
+    }): Promise<boolean>;
 }
 export declare class DrizzlePaymentMethodStore implements IPaymentMethodStore {
     private readonly db;
@@ -38,4 +45,9 @@ export declare class DrizzlePaymentMethodStore implements IPaymentMethodStore {
     listByType(type: string): Promise<PaymentMethodRecord[]>;
     upsert(method: PaymentMethodRecord): Promise<void>;
     setEnabled(id: string, enabled: boolean): Promise<void>;
+    patchMetadata(id: string, patch: {
+        iconUrl?: string | null;
+        displayOrder?: number;
+        displayName?: string;
+    }): Promise<boolean>;
 }

package/dist/billing/crypto/payment-method-store.js

@@ -42,6 +42,7 @@ export class DrizzlePaymentMethodStore {
             displayName: method.displayName,
             enabled: method.enabled,
             displayOrder: method.displayOrder,
+            iconUrl: method.iconUrl,
             rpcUrl: method.rpcUrl,
             oracleAddress: method.oracleAddress,
             xpub: method.xpub,
@@ -59,6 +60,7 @@ export class DrizzlePaymentMethodStore {
                 displayName: method.displayName,
                 enabled: method.enabled,
                 displayOrder: method.displayOrder,
+                iconUrl: method.iconUrl,
                 rpcUrl: method.rpcUrl,
                 oracleAddress: method.oracleAddress,
                 xpub: method.xpub,
@@ -70,6 +72,19 @@ export class DrizzlePaymentMethodStore {
     async setEnabled(id, enabled) {
         await this.db.update(paymentMethods).set({ enabled }).where(eq(paymentMethods.id, id));
     }
+    async patchMetadata(id, patch) {
+        const set = {};
+        if (patch.iconUrl !== undefined)
+            set.iconUrl = patch.iconUrl;
+        if (patch.displayOrder !== undefined)
+            set.displayOrder = patch.displayOrder;
+        if (patch.displayName !== undefined)
+            set.displayName = patch.displayName;
+        if (Object.keys(set).length === 0)
+            return false;
+        const result = (await this.db.update(paymentMethods).set(set).where(eq(paymentMethods.id, id)));
+        return result.rowCount > 0;
+    }
 }
 function toRecord(row) {
     return {
@@ -82,6 +97,7 @@ function toRecord(row) {
         displayName: row.displayName,
         enabled: row.enabled,
         displayOrder: row.displayOrder,
+        iconUrl: row.iconUrl,
         rpcUrl: row.rpcUrl,
         oracleAddress: row.oracleAddress,
         xpub: row.xpub,

package/dist/db/schema/crypto.d.ts

@@ -597,6 +597,23 @@ export declare const paymentMethods: import("drizzle-orm/pg-core").PgTableWithCo
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        iconUrl: import("drizzle-orm/pg-core").PgColumn<{
+            name: "icon_url";
+            tableName: "payment_methods";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         rpcUrl: import("drizzle-orm/pg-core").PgColumn<{
             name: "rpc_url";
             tableName: "payment_methods";

package/dist/db/schema/crypto.js

@@ -71,6 +71,7 @@ export const paymentMethods = pgTable("payment_methods", {
     displayName: text("display_name").notNull(),
     enabled: boolean("enabled").notNull().default(true),
     displayOrder: integer("display_order").notNull().default(0),
+    iconUrl: text("icon_url"),
     rpcUrl: text("rpc_url"), // chain node RPC endpoint
     oracleAddress: text("oracle_address"), // Chainlink feed address for price (null = 1:1 stablecoin)
     xpub: text("xpub"), // HD wallet extended public key for deposit address derivation

package/drizzle/migrations/0019_icon_url_column.sql

@@ -0,0 +1,4 @@
+-- Add icon_url column to payment_methods.
+-- Stores URL for chain/token icon displayed in checkout UI.
+
+ALTER TABLE "payment_methods" ADD COLUMN IF NOT EXISTS "icon_url" text;

package/drizzle/migrations/meta/_journal.json

@@ -134,6 +134,13 @@
       "when": 1743177600000,
       "tag": "0018_address_type_column",
       "breakpoints": true
+    },
+    {
+      "idx": 19,
+      "version": "7",
+      "when": 1743264000000,
+      "tag": "0019_icon_url_column",
+      "breakpoints": true
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wopr-network/platform-core",
-  "version": "1.49.5",
+  "version": "1.50.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/billing/crypto/__tests__/key-server.test.ts

@@ -76,6 +76,7 @@ function mockDeps(): KeyServerDeps & {
         displayName: "Bitcoin",
         contractAddress: null,
         confirmations: 6,
+        iconUrl: null,
       },
       {
         id: "base-usdc",
@@ -85,6 +86,7 @@ function mockDeps(): KeyServerDeps & {
         displayName: "USDC on Base",
         contractAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
         confirmations: 12,
+        iconUrl: null,
       },
     ]),
     listAll: vi.fn(),
@@ -100,12 +102,14 @@ function mockDeps(): KeyServerDeps & {
       oracleAddress: "0x64c911996D3c6aC71f9b455B1E8E7266BcbD848F",
       xpub: null,
       displayOrder: 0,
+      iconUrl: null,
       enabled: true,
       rpcUrl: null,
     }),
     listByType: vi.fn(),
     upsert: vi.fn().mockResolvedValue(undefined),
     setEnabled: vi.fn().mockResolvedValue(undefined),
+    patchMetadata: vi.fn().mockResolvedValue(true),
   };
   return {
     db: createMockDb() as never,

package/src/billing/crypto/client.ts

@@ -51,6 +51,7 @@ export interface ChainInfo {
   displayName: string;
   contractAddress: string | null;
   confirmations: number;
+  iconUrl: string | null;
 }
 
 /**

package/src/billing/crypto/key-server.ts

@@ -266,6 +266,7 @@ export function createKeyServerApp(deps: KeyServerDeps): Hono {
         displayName: m.displayName,
         contractAddress: m.contractAddress,
         confirmations: m.confirmations,
+        iconUrl: m.iconUrl,
       })),
     );
   });
@@ -328,6 +329,8 @@ export function createKeyServerApp(deps: KeyServerDeps): Hono {
       display_name?: string;
       oracle_address?: string;
       address_type?: string;
+      icon_url?: string;
+      display_order?: number;
     }>();
 
     if (!body.id || !body.xpub || !body.token) {
@@ -362,7 +365,8 @@ export function createKeyServerApp(deps: KeyServerDeps): Hono {
       decimals: body.decimals,
       displayName: body.display_name ?? `${body.token} on ${body.network}`,
       enabled: true,
-      displayOrder: 0,
+      displayOrder: body.display_order ?? 0,
+      iconUrl: body.icon_url ?? null,
       rpcUrl: body.rpc_url,
       oracleAddress: body.oracle_address ?? null,
       xpub: body.xpub,
@@ -373,6 +377,25 @@ export function createKeyServerApp(deps: KeyServerDeps): Hono {
     return c.json({ id: body.id, path: `m/44'/${body.coin_type}'/${body.account_index}'` }, 201);
   });
 
+  /** PATCH /admin/chains/:id — update metadata (icon_url, display_order, display_name) */
+  app.patch("/admin/chains/:id", async (c) => {
+    const id = c.req.param("id");
+    const body = await c.req.json<{
+      icon_url?: string | null;
+      display_order?: number;
+      display_name?: string;
+    }>();
+
+    const updated = await deps.methodStore.patchMetadata(id, {
+      iconUrl: body.icon_url,
+      displayOrder: body.display_order,
+      displayName: body.display_name,
+    });
+
+    if (!updated) return c.json({ id, updated: false }, 200);
+    return c.json({ id, updated: true });
+  });
+
   /** DELETE /admin/chains/:id — soft disable */
   app.delete("/admin/chains/:id", async (c) => {
     await deps.methodStore.setEnabled(c.req.param("id"), false);

package/src/billing/crypto/payment-method-store.ts

@@ -12,6 +12,7 @@ export interface PaymentMethodRecord {
   displayName: string;
   enabled: boolean;
   displayOrder: number;
+  iconUrl: string | null;
   rpcUrl: string | null;
   oracleAddress: string | null;
   xpub: string | null;
@@ -32,6 +33,11 @@ export interface IPaymentMethodStore {
   upsert(method: PaymentMethodRecord): Promise<void>;
   /** Enable or disable a payment method (admin). */
   setEnabled(id: string, enabled: boolean): Promise<void>;
+  /** Partial update of metadata fields (no read-modify-write needed). */
+  patchMetadata(
+    id: string,
+    patch: { iconUrl?: string | null; displayOrder?: number; displayName?: string },
+  ): Promise<boolean>;
 }
 
 export class DrizzlePaymentMethodStore implements IPaymentMethodStore {
@@ -78,6 +84,7 @@ export class DrizzlePaymentMethodStore implements IPaymentMethodStore {
         displayName: method.displayName,
         enabled: method.enabled,
         displayOrder: method.displayOrder,
+        iconUrl: method.iconUrl,
         rpcUrl: method.rpcUrl,
         oracleAddress: method.oracleAddress,
         xpub: method.xpub,
@@ -95,6 +102,7 @@ export class DrizzlePaymentMethodStore implements IPaymentMethodStore {
           displayName: method.displayName,
           enabled: method.enabled,
           displayOrder: method.displayOrder,
+          iconUrl: method.iconUrl,
           rpcUrl: method.rpcUrl,
           oracleAddress: method.oracleAddress,
           xpub: method.xpub,
@@ -107,6 +115,21 @@ export class DrizzlePaymentMethodStore implements IPaymentMethodStore {
   async setEnabled(id: string, enabled: boolean): Promise<void> {
     await this.db.update(paymentMethods).set({ enabled }).where(eq(paymentMethods.id, id));
   }
+
+  async patchMetadata(
+    id: string,
+    patch: { iconUrl?: string | null; displayOrder?: number; displayName?: string },
+  ): Promise<boolean> {
+    const set: Record<string, unknown> = {};
+    if (patch.iconUrl !== undefined) set.iconUrl = patch.iconUrl;
+    if (patch.displayOrder !== undefined) set.displayOrder = patch.displayOrder;
+    if (patch.displayName !== undefined) set.displayName = patch.displayName;
+    if (Object.keys(set).length === 0) return false;
+    const result = (await this.db.update(paymentMethods).set(set).where(eq(paymentMethods.id, id))) as {
+      rowCount: number;
+    };
+    return result.rowCount > 0;
+  }
 }
 
 function toRecord(row: typeof paymentMethods.$inferSelect): PaymentMethodRecord {
@@ -120,6 +143,7 @@ function toRecord(row: typeof paymentMethods.$inferSelect): PaymentMethodRecord
     displayName: row.displayName,
     enabled: row.enabled,
     displayOrder: row.displayOrder,
+    iconUrl: row.iconUrl,
     rpcUrl: row.rpcUrl,
     oracleAddress: row.oracleAddress,
     xpub: row.xpub,

package/src/db/schema/crypto.ts

@@ -78,6 +78,7 @@ export const paymentMethods = pgTable("payment_methods", {
   displayName: text("display_name").notNull(),
   enabled: boolean("enabled").notNull().default(true),
   displayOrder: integer("display_order").notNull().default(0),
+  iconUrl: text("icon_url"),
   rpcUrl: text("rpc_url"), // chain node RPC endpoint
   oracleAddress: text("oracle_address"), // Chainlink feed address for price (null = 1:1 stablecoin)
   xpub: text("xpub"), // HD wallet extended public key for deposit address derivation