Merge feat/exchange-info: public rake % endpoint

Author: miikkij

aimeat/src/routes/exchange-market.ts

@@ -19,6 +19,7 @@ import type { Storage } from '../storage/interface.js';
 import { requireAuth } from '../auth/middleware.js';
 import { success, error } from '../middleware/envelope.js';
 import { resolveIdentity } from '../utils/gaii.js';
+import { commerceFeePercent } from '../services/marketplace-fee.js';
 import { createEntitlement, readEntitlementForCall } from '../services/metered-entitlements.js';
 import {
   type Offering, type Need, type Bid, type ActionCommercial,
@@ -33,6 +34,17 @@ const posOrNull = (v: unknown): number | null => (typeof v === 'number' && Numbe
 export function exchangeMarketRouter(config: AimeatConfig, storage: Storage): Router {
   const router = Router();
 
+  // ── INFO — the marketplace's public economics (rake, currencies) ─────────────
+  /** Public: what the platform takes on each metered call + the units in play. */
+  router.get('/v1/exchange/info', (_req: Request, res: Response) => {
+    return res.json(success(config.nodeId, {
+      rake_percent: commerceFeePercent(config),
+      rake_note: 'Platform fee applied to each metered call (provider keeps the rest). Set by the node operator.',
+      units: ['morsels', 'EUR', 'USD'],
+      morsel_note: 'Morsels are the node’s throttle unit (plain integers); real money settles in EUR/USD.',
+    }));
+  });
+
   // ── OFFERINGS (supply) ─────────────────────────────────────────────────────
   /** List a supply offering for an action the caller's extension owns. Pricing is read from the action. */
   router.post('/v1/exchange/offerings', requireAuth(), async (req: Request, res: Response) => {

openapi.yaml

@@ -8080,6 +8080,18 @@ paths:
         '404':
           $ref: '#/components/responses/AimeatError'
 
+  /v1/exchange/info:
+    get:
+      operationId: exchangeInfo
+      summary: EXCHANGE marketplace economics — the platform rake + units (EXCHANGE / TARGET-045)
+      description: >
+        Public. Returns `{ rake_percent, rake_note, units, morsel_note }` — the platform fee applied to
+        each metered call (the provider keeps the rest), set by the node operator via
+        AIMEAT_COMMERCE_FEE_PERCENT / AIMEAT_MARKETPLACE_TX_FEE_PERCENT.
+      tags: [Commerce]
+      responses:
+        '200': { $ref: '#/components/responses/AimeatSuccess' }
+
   /v1/exchange/offerings:
     post:
       operationId: exchangeListOffering