@xyo-network/chain-api 1.20.29 → 1.21.0

package/dist/node/ApiActor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ApiActor.d.ts","sourceRoot":"","sources":["../../src/ApiActor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAA;AACtG,OAAO,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAA;AAc1D,MAAM,MAAM,cAAc,GAAG,aAAa,CAAC;IACzC,MAAM,EAAE,SAAS,CAAA;CAClB,CAAC,CAAA;AAEF,qBACa,QAAS,SAAQ,OAAO,CAAC,cAAc,CAAC;IACnD,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAU1C;IAED,OAAO,CAAC,MAAM,CAAC,CAAQ;IAER,aAAa;IAIb,YAAY;IAMZ,WAAW;YAKZ,WAAW;IAIzB,OAAO,CAAC,UAAU;CAInB"}
+{"version":3,"file":"ApiActor.d.ts","sourceRoot":"","sources":["../../src/ApiActor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,oBAAoB,EAAE,aAAa,EAAE,SAAS,EAC/C,MAAM,kCAAkC,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAA;AAc1D,MAAM,MAAM,cAAc,GAAG,aAAa,CAAC;IACzC,MAAM,EAAE,SAAS,CAAA;CAClB,CAAC,CAAA;AAEF,qBACa,QAAS,SAAQ,OAAO,CAAC,cAAc,CAAC;IACnD,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAU1C;IAED,OAAO,CAAC,MAAM,CAAC,CAAQ;IAER,aAAa;IAIb,YAAY;IAMZ,WAAW;YAKZ,WAAW;IAIzB,OAAO,CAAC,UAAU;CAInB"}

package/dist/node/command.d.ts

@@ -0,0 +1,5 @@
+import type { GetLocatorsFromConfig } from '@xyo-network/chain-orchestration';
+import type { Config } from '@xyo-network/xl1-sdk';
+import type { CommandModule } from 'yargs';
+export declare function apiCommand(getConfiguration: () => Config, getLocatorsFromConfig: GetLocatorsFromConfig): CommandModule;
+//# sourceMappingURL=command.d.ts.map

package/dist/node/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/command.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAA;AAK7E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAI1C,wBAAgB,UAAU,CAAC,gBAAgB,EAAE,MAAM,MAAM,EAAE,qBAAqB,EAAE,qBAAqB,GAAG,aAAa,CA0BtH"}

package/dist/node/index.d.ts

@@ -1,5 +1,6 @@
 export * from './ApiActor.ts';
+export * from './command.ts';
 export * from './model.ts';
-export * from './runApi.ts';
+export * from './run.ts';
 export * from './server/index.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,mBAAmB,CAAA"}

package/dist/node/index.mjs

@@ -155,17 +155,48 @@ var addDataLakeRoutes = /* @__PURE__ */ __name((app) => {
 // src/server/routes/rpc/routes/addRpcRoutes.ts
 import { setRawResponseFormat as setRawResponseFormat5 } from "@xylabs/express";
 import { rpcServerFromConnection, XyoConnectionMoniker } from "@xyo-network/xl1-sdk";
+
+// src/server/routes/rpc/connectionSubsetBySurface.ts
+import { connectionSubsetBySurface } from "@xyo-network/xl1-sdk";
+
+// src/server/routes/rpc/routes/addRpcRoutes.ts
 var addRpcRoutes = /* @__PURE__ */ __name(async (app) => {
   const { context } = app;
   const { locator } = context;
+  const apiConfig = context.config;
+  const useLegacyMixed = apiConfig.legacyMixedRpc !== false;
   const connection = await locator.getInstance(XyoConnectionMoniker);
-  const rpcServer = rpcServerFromConnection(connection);
+  const indexedPresent = hasAnyIndexedBranch(connection);
+  if (useLegacyMixed && indexedPresent) {
+    context.logger?.warn("[api] /rpc is serving indexed methods (LEGACY_MIXED_RPC=true). Indexed clients should migrate to /rpc/indexed; flip XL1_ACTORS__API__LEGACY_MIXED_RPC=false to enforce strict node-surface-only at /rpc.");
+  }
+  const rpcConnection = useLegacyMixed ? connection : connectionSubsetBySurface(connection, "node");
+  const rpcServer = rpcServerFromConnection(rpcConnection);
   app.post("/rpc", async (req, res) => {
     setRawResponseFormat5(res);
     const rpcResponse = await rpcServer.handle(req.body);
     res.json(rpcResponse);
   });
+  if (indexedPresent) {
+    const indexedConnection = connectionSubsetBySurface(connection, "indexed");
+    const indexedRpcServer = rpcServerFromConnection(indexedConnection);
+    app.post("/rpc/indexed", async (req, res) => {
+      setRawResponseFormat5(res);
+      const rpcResponse = await indexedRpcServer.handle(req.body);
+      res.json(rpcResponse);
+    });
+  }
 }, "addRpcRoutes");
+function hasAnyIndexedBranch(connection) {
+  if (connection.networkStake) return true;
+  if (connection.storage) return true;
+  if (connection.viewer) {
+    const v = connection.viewer;
+    if (v.networkStake || v.stake || v.step) return true;
+  }
+  return false;
+}
+__name(hasAnyIndexedBranch, "hasAnyIndexedBranch");
 
 // src/server/routes/addRoutes.ts
 var addRoutes = /* @__PURE__ */ __name(async (app) => {
@@ -251,7 +282,12 @@ ApiActor = _ts_decorate([
   creatable()
 ], ApiActor);
 
-// src/runApi.ts
+// src/command.ts
+import { getFinalizerActor } from "@xyo-network/chain-finalizer";
+import { getMempoolActor } from "@xyo-network/chain-mempool";
+import { ApiConfigZod, FinalizerConfigZod, MempoolConfigZod } from "@xyo-network/chain-orchestration";
+
+// src/run.ts
 import { initActorWallet } from "@xyo-network/chain-orchestration";
 var getApiActor = /* @__PURE__ */ __name(async (config, locator) => {
   const account = await initActorWallet({
@@ -275,8 +311,36 @@ var runApi = /* @__PURE__ */ __name(async (config, orchestrator, locator) => {
   }
   await orchestrator.start();
 }, "runApi");
+
+// src/command.ts
+function apiCommand(getConfiguration, getLocatorsFromConfig) {
+  return {
+    command: "api",
+    deprecated: 'Use "start api" instead',
+    describe: "Run a XL1 API Node",
+    handler: /* @__PURE__ */ __name(async () => {
+      const configuration = getConfiguration();
+      const { locators, orchestrator } = await getLocatorsFromConfig([
+        "api",
+        "mempool",
+        "finalizer"
+      ], configuration);
+      const actors = await Promise.all([
+        getApiActor(ApiConfigZod.parse(locators["api"].context.config), locators["api"]),
+        getMempoolActor(MempoolConfigZod.parse(locators["mempool"].context.config), locators["mempool"]),
+        getFinalizerActor(FinalizerConfigZod.parse(locators["finalizer"].context.config), locators["finalizer"])
+      ]);
+      for (const actor of actors) {
+        await orchestrator.registerActor(actor);
+      }
+      await orchestrator.start();
+    }, "handler")
+  };
+}
+__name(apiCommand, "apiCommand");
 export {
   ApiActor,
+  apiCommand,
   getApiActor,
   getApp,
   getServer,

package/dist/node/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/ApiActor.ts","../../src/server/app.ts","../../src/server/instrumentation.ts","../../src/server/routes/livez/get.ts","../../src/server/routes/readyz/get.ts","../../src/server/routes/startupz/get.ts","../../src/server/routes/addProbeRoutes.ts","../../src/server/routes/dataLake/archivistMiddleware.ts","../../src/server/routes/dataLake/addDataLakeRoutes.ts","../../src/server/routes/rpc/routes/addRpcRoutes.ts","../../src/server/routes/addRoutes.ts","../../src/server/server.ts","../../src/runApi.ts"],"sourcesContent":["import type { Server } from 'node:http'\n\nimport { creatable } from '@xylabs/sdk-js'\nimport type { ActorCapabilityNeeds, ActorParamsV3, ApiConfig } from '@xyo-network/chain-orchestration'\nimport { ActorV3 } from '@xyo-network/chain-orchestration'\nimport {\n  AccountBalanceViewerMoniker,\n  asHostActorConfigContext,\n  BlockViewerMoniker,\n  FinalizationViewerMoniker,\n  MempoolViewerMoniker,\n  TransactionViewerMoniker,\n  XyoConnectionMoniker,\n  XyoViewerMoniker,\n} from '@xyo-network/xl1-sdk'\n\nimport { getServer } from './server/index.ts'\n\nexport type ApiActorParams = ActorParamsV3<{\n  config: ApiConfig\n}>\n\n@creatable()\nexport class ApiActor extends ActorV3<ApiActorParams> {\n  static readonly needs: ActorCapabilityNeeds = {\n    required: [\n      AccountBalanceViewerMoniker,\n      BlockViewerMoniker,\n      FinalizationViewerMoniker,\n      MempoolViewerMoniker,\n      TransactionViewerMoniker,\n      XyoConnectionMoniker,\n      XyoViewerMoniker,\n    ],\n  }\n\n  private server?: Server\n\n  override async createHandler() {\n    await super.createHandler()\n  }\n\n  override async startHandler() {\n    await super.startHandler()\n    this.stopServer()\n    await this.startServer()\n  }\n\n  override async stopHandler() {\n    await super.stopHandler()\n    this.stopServer()\n  }\n\n  private async startServer() {\n    this.server = await getServer(asHostActorConfigContext(this.context, true))\n  }\n\n  private stopServer() {\n    this.server?.close()\n    this.server = undefined\n  }\n}\n","import { standardErrors } from '@xylabs/express'\nimport { sharedMiddleware } from '@xyo-network/chain-orchestration'\nimport type { HostActorConfigContext } from '@xyo-network/xl1-sdk'\nimport type { Express } from 'express'\nimport express from 'express'\n\nimport { addInstrumentation } from './instrumentation.ts'\nimport { addRoutes } from './routes/index.ts'\n\nexport const getApp = async (context: HostActorConfigContext): Promise<Express> => {\n  addInstrumentation()\n  const app = express()\n  sharedMiddleware(app)\n  app.context = context\n  await addRoutes(app)\n  app.use(standardErrors)\n  return app\n}\n","import { registerInstrumentations } from '@opentelemetry/instrumentation'\nimport { ExpressInstrumentation } from '@opentelemetry/instrumentation-express'\nimport { HttpInstrumentation } from '@opentelemetry/instrumentation-http'\n\n/**\n * Registers OpenTelemetry instrumentations for HTTP and Express.\n * This function is used to set up the necessary instrumentations for monitoring\n * HTTP requests and Express applications. Since it monkey patches the Express\n * router & middleware system, it should be called before any Express applications\n * are defined.\n */\nexport const addInstrumentation = () => {\n  const instrumentations = [new HttpInstrumentation(), new ExpressInstrumentation()]\n  registerInstrumentations({ instrumentations })\n}\n","import type { NoReqParams } from '@xylabs/express'\nimport { setRawResponseFormat } from '@xylabs/express'\nimport type { RequestHandler } from 'express'\nimport { ReasonPhrases } from 'http-status-codes'\n\nconst message = ReasonPhrases.OK\n\nconst handler: RequestHandler<NoReqParams> = (_req, res) => {\n  setRawResponseFormat(res)\n  res.status(200).send({ message })\n}\n\nexport const getLivez: RequestHandler<NoReqParams> = handler\n","import type { NoReqParams } from '@xylabs/express'\nimport { setRawResponseFormat } from '@xylabs/express'\nimport type { RequestHandler } from 'express'\nimport { ReasonPhrases } from 'http-status-codes'\n\nconst message = ReasonPhrases.OK\n\nconst handler: RequestHandler<NoReqParams> = (_req, res) => {\n  setRawResponseFormat(res)\n  res.status(200).send({ message })\n}\n\nexport const getReadyz: RequestHandler<NoReqParams> = handler\n","import type { NoReqParams } from '@xylabs/express'\nimport { setRawResponseFormat } from '@xylabs/express'\nimport type { RequestHandler } from 'express'\nimport { ReasonPhrases } from 'http-status-codes'\n\nconst message = ReasonPhrases.OK\n\nconst handler: RequestHandler<NoReqParams> = (_req, res) => {\n  setRawResponseFormat(res)\n  res.status(200).send({ message })\n}\n\nexport const getStartupz: RequestHandler<NoReqParams> = handler\n","import type { Express } from 'express'\n\nimport { getLivez } from './livez/index.ts'\nimport { getReadyz } from './readyz/index.ts'\nimport { getStartupz } from './startupz/index.ts'\n\nexport const addProbeRoutes = (app: Express) => {\n  app.get('/livez', getLivez)\n  app.get('/readyz', getReadyz)\n  app.get('/startupz', getStartupz)\n}\n","import { setRawResponseFormat } from '@xylabs/express'\nimport { asHash, isDefined } from '@xylabs/sdk-js'\nimport type {\n  ArchivistInstance,\n  ArchivistNextOptions, ModuleIdentifier,\n  NextOptions, NodeInstance, Payload,\n} from '@xyo-network/sdk-js'\nimport {\n  asArchivistInstance, isAnyPayload, isSequence, PayloadBuilder,\n} from '@xyo-network/sdk-js'\nimport type { Request, Router } from 'express'\nimport express from 'express'\n\nconst resolveArchivist = async (node: NodeInstance, archivistModuleIdentifier: ModuleIdentifier): Promise<ArchivistInstance> => {\n  const mod = await node.resolve(archivistModuleIdentifier)\n  return asArchivistInstance(mod, { required: true })\n}\n\nlet archivistInstance: ArchivistInstance | undefined\n\nconst getArchivist = async (node: NodeInstance, archivistModuleIdentifier: ModuleIdentifier): Promise<ArchivistInstance> => {\n  if (isDefined(archivistInstance)) return archivistInstance\n  archivistInstance = await resolveArchivist(node, archivistModuleIdentifier)\n  return archivistInstance\n}\n\ninterface ArchivistMiddlewareOptions {\n  archivistModuleIdentifier: ModuleIdentifier\n  node: NodeInstance\n}\n\nexport const archivistMiddleware = (options: ArchivistMiddlewareOptions): Router => {\n  const { node, archivistModuleIdentifier } = options\n  const router = express.Router({ mergeParams: true })\n\n  router.post('/insert', async (req, res) => {\n    setRawResponseFormat(res)\n    const body = Array.isArray(req.body) ? req.body : [req.body]\n    const payloads = (await PayloadBuilder.hashPairs<Payload>(body)).map(p => p[0])\n    const archivist = await getArchivist(node, archivistModuleIdentifier)\n    const result = await archivist.insert(payloads)\n    res.status(200).json(result)\n  })\n\n  router.get('/next', async (req: Request<Partial<NextOptions>>, res) => {\n    setRawResponseFormat(res)\n    const cursor = isSequence(req.query.cursor) ? req.query.cursor : undefined\n    const limit = isDefined(req.query.limit) ? Number(req.query.limit) : undefined\n    const open = isDefined(req.query.open) ? Boolean(req.query.open) : undefined\n    const order = req.query.order === 'asc' ? 'asc' : 'desc'\n    const options: ArchivistNextOptions = {\n      limit, open, order, cursor,\n    }\n    const archivist = await getArchivist(node, archivistModuleIdentifier)\n    const result = await archivist.next(options)\n    res.status(200).json(result)\n  })\n  router.post('/next', async (req: Request<{}, {}, ArchivistNextOptions | undefined>, res) => {\n    setRawResponseFormat(res)\n    const options = req.body\n    const archivist = await getArchivist(node, archivistModuleIdentifier)\n    const result = await (isDefined(options) ? archivist.next(options) : archivist.next())\n    res.status(200).json(result)\n  })\n\n  router.get('/get/:hash', async (req, res) => {\n    setRawResponseFormat(res)\n    const { hash: rawHash } = req.params\n    const hash = asHash(rawHash)\n    if (isDefined(hash)) {\n      const archivist = await getArchivist(node, archivistModuleIdentifier)\n      const [payload] = await archivist.get([hash])\n      if (isAnyPayload(payload)) {\n        res.json(payload)\n        return\n      }\n    }\n    res.status(400).send()\n  })\n\n  return router\n}\n","import type { Express } from 'express'\n\nimport { archivistMiddleware } from './archivistMiddleware.ts'\n\nexport const addDataLakeRoutes = (app: Express) => {\n  const { node } = app.context\n  const archivistModuleIdentifier = 'Chain:Finalized'\n  app.use('/chain', archivistMiddleware({ node, archivistModuleIdentifier }))\n}\n","import { setRawResponseFormat } from '@xylabs/express'\nimport type { XyoConnection } from '@xyo-network/xl1-sdk'\nimport { rpcServerFromConnection, XyoConnectionMoniker } from '@xyo-network/xl1-sdk'\nimport type { Express } from 'express'\n\nexport const addRpcRoutes = async (\n  app: Express,\n) => {\n  const { context } = app\n  const { locator } = context\n\n  const connection = await locator.getInstance<XyoConnection>(XyoConnectionMoniker)\n  const rpcServer = rpcServerFromConnection(connection)\n\n  app.post('/rpc', async (req, res) => {\n    setRawResponseFormat(res)\n    const rpcResponse = await rpcServer.handle(req.body)\n    res.json(rpcResponse)\n  })\n}\n","import type { Express } from 'express'\n\nimport { addProbeRoutes } from './addProbeRoutes.ts'\nimport { addDataLakeRoutes } from './dataLake/index.ts'\nimport { addRpcRoutes } from './rpc/index.ts'\n\nexport const addRoutes = async (\n  app: Express,\n) => {\n  addProbeRoutes(app)\n  await addRpcRoutes(app)\n  addDataLakeRoutes(app)\n}\n","import type { HostActorConfigContext } from '@xyo-network/xl1-sdk'\n\nimport { getApp } from './app.ts'\n\nconst hostname = '::'\n\nexport async function getServer(context: HostActorConfigContext) {\n  const { logger, config } = context\n  const { port } = config\n\n  const app = await getApp(context)\n  const server = await new Promise<ReturnType<typeof app.listen>>((resolve, reject) => {\n    const srv = app.listen(port, hostname, () => {\n      logger?.info(`[API] Server listening at http://${hostname}:${port}`)\n      resolve(srv)\n    })\n    srv.once('error', reject)\n  })\n  server.setTimeout(20_000)\n  return server\n}\n","import type { ApiConfig, OrchestratorInstance } from '@xyo-network/chain-orchestration'\nimport { initActorWallet } from '@xyo-network/chain-orchestration'\nimport type { ProviderFactoryLocatorInstance } from '@xyo-network/xl1-sdk'\n\nimport { ApiActor } from './ApiActor.ts'\n\nexport const getApiActor = async (\n  config: ApiConfig,\n  locator: ProviderFactoryLocatorInstance,\n) => {\n  const account = await initActorWallet({\n    config, singletons: {}, caches: {},\n  })\n  const params = {\n    account, config, locator,\n  }\n  // Create actors\n  return await ApiActor.create(params)\n}\n\nexport const runApi = async (\n  config: ApiConfig,\n  orchestrator: OrchestratorInstance,\n  locator: ProviderFactoryLocatorInstance,\n) => {\n  const actors = [await getApiActor(config, locator)]\n\n  // Register the actors with the orchestrator\n  for (const actor of actors) {\n    await orchestrator.registerActor(actor)\n  }\n\n  // Start the orchestrator => automatically activates the actors\n  await orchestrator.start()\n}\n"],"mappings":"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","names":["creatable","ActorV3","AccountBalanceViewerMoniker","asHostActorConfigContext","BlockViewerMoniker","FinalizationViewerMoniker","MempoolViewerMoniker","TransactionViewerMoniker","XyoConnectionMoniker","XyoViewerMoniker","standardErrors","sharedMiddleware","express","registerInstrumentations","ExpressInstrumentation","HttpInstrumentation","addInstrumentation","instrumentations","HttpInstrumentation","ExpressInstrumentation","registerInstrumentations","setRawResponseFormat","ReasonPhrases","message","ReasonPhrases","OK","handler","_req","res","setRawResponseFormat","status","send","getLivez","setRawResponseFormat","ReasonPhrases","message","ReasonPhrases","OK","handler","_req","res","setRawResponseFormat","status","send","getReadyz","setRawResponseFormat","ReasonPhrases","message","ReasonPhrases","OK","handler","_req","res","setRawResponseFormat","status","send","getStartupz","addProbeRoutes","app","get","getLivez","getReadyz","getStartupz","setRawResponseFormat","asHash","isDefined","asArchivistInstance","isAnyPayload","isSequence","PayloadBuilder","express","resolveArchivist","node","archivistModuleIdentifier","mod","resolve","asArchivistInstance","required","archivistInstance","getArchivist","isDefined","archivistMiddleware","options","router","express","Router","mergeParams","post","req","res","setRawResponseFormat","body","Array","isArray","payloads","PayloadBuilder","hashPairs","map","p","archivist","result","insert","status","json","get","cursor","isSequence","query","undefined","limit","Number","open","Boolean","order","next","hash","rawHash","params","asHash","payload","isAnyPayload","send","addDataLakeRoutes","app","node","context","archivistModuleIdentifier","use","archivistMiddleware","setRawResponseFormat","rpcServerFromConnection","XyoConnectionMoniker","addRpcRoutes","app","context","locator","connection","getInstance","XyoConnectionMoniker","rpcServer","rpcServerFromConnection","post","req","res","setRawResponseFormat","rpcResponse","handle","body","json","addRoutes","app","addProbeRoutes","addRpcRoutes","addDataLakeRoutes","getApp","context","addInstrumentation","app","express","sharedMiddleware","addRoutes","use","standardErrors","hostname","getServer","context","logger","config","port","app","getApp","server","Promise","resolve","reject","srv","listen","info","once","setTimeout","ApiActor","ActorV3","needs","required","AccountBalanceViewerMoniker","BlockViewerMoniker","FinalizationViewerMoniker","MempoolViewerMoniker","TransactionViewerMoniker","XyoConnectionMoniker","XyoViewerMoniker","server","createHandler","startHandler","stopServer","startServer","stopHandler","getServer","asHostActorConfigContext","context","close","undefined","initActorWallet","getApiActor","config","locator","account","initActorWallet","singletons","caches","params","ApiActor","create","runApi","orchestrator","actors","actor","registerActor","start"]}
+{"version":3,"sources":["../../src/ApiActor.ts","../../src/server/app.ts","../../src/server/instrumentation.ts","../../src/server/routes/livez/get.ts","../../src/server/routes/readyz/get.ts","../../src/server/routes/startupz/get.ts","../../src/server/routes/addProbeRoutes.ts","../../src/server/routes/dataLake/archivistMiddleware.ts","../../src/server/routes/dataLake/addDataLakeRoutes.ts","../../src/server/routes/rpc/routes/addRpcRoutes.ts","../../src/server/routes/rpc/connectionSubsetBySurface.ts","../../src/server/routes/addRoutes.ts","../../src/server/server.ts","../../src/command.ts","../../src/run.ts"],"sourcesContent":["import type { Server } from 'node:http'\n\nimport { creatable } from '@xylabs/sdk-js'\nimport type {\n  ActorCapabilityNeeds, ActorParamsV3, ApiConfig,\n} from '@xyo-network/chain-orchestration'\nimport { ActorV3 } from '@xyo-network/chain-orchestration'\nimport {\n  AccountBalanceViewerMoniker,\n  asHostActorConfigContext,\n  BlockViewerMoniker,\n  FinalizationViewerMoniker,\n  MempoolViewerMoniker,\n  TransactionViewerMoniker,\n  XyoConnectionMoniker,\n  XyoViewerMoniker,\n} from '@xyo-network/xl1-sdk'\n\nimport { getServer } from './server/index.ts'\n\nexport type ApiActorParams = ActorParamsV3<{\n  config: ApiConfig\n}>\n\n@creatable()\nexport class ApiActor extends ActorV3<ApiActorParams> {\n  static readonly needs: ActorCapabilityNeeds = {\n    required: [\n      AccountBalanceViewerMoniker,\n      BlockViewerMoniker,\n      FinalizationViewerMoniker,\n      MempoolViewerMoniker,\n      TransactionViewerMoniker,\n      XyoConnectionMoniker,\n      XyoViewerMoniker,\n    ],\n  }\n\n  private server?: Server\n\n  override async createHandler() {\n    await super.createHandler()\n  }\n\n  override async startHandler() {\n    await super.startHandler()\n    this.stopServer()\n    await this.startServer()\n  }\n\n  override async stopHandler() {\n    await super.stopHandler()\n    this.stopServer()\n  }\n\n  private async startServer() {\n    this.server = await getServer(asHostActorConfigContext(this.context, true))\n  }\n\n  private stopServer() {\n    this.server?.close()\n    this.server = undefined\n  }\n}\n","import { standardErrors } from '@xylabs/express'\nimport { sharedMiddleware } from '@xyo-network/chain-orchestration'\nimport type { HostActorConfigContext } from '@xyo-network/xl1-sdk'\nimport type { Express } from 'express'\nimport express from 'express'\n\nimport { addInstrumentation } from './instrumentation.ts'\nimport { addRoutes } from './routes/index.ts'\n\nexport const getApp = async (context: HostActorConfigContext): Promise<Express> => {\n  addInstrumentation()\n  const app = express()\n  sharedMiddleware(app)\n  app.context = context\n  await addRoutes(app)\n  app.use(standardErrors)\n  return app\n}\n","import { registerInstrumentations } from '@opentelemetry/instrumentation'\nimport { ExpressInstrumentation } from '@opentelemetry/instrumentation-express'\nimport { HttpInstrumentation } from '@opentelemetry/instrumentation-http'\n\n/**\n * Registers OpenTelemetry instrumentations for HTTP and Express.\n * This function is used to set up the necessary instrumentations for monitoring\n * HTTP requests and Express applications. Since it monkey patches the Express\n * router & middleware system, it should be called before any Express applications\n * are defined.\n */\nexport const addInstrumentation = () => {\n  const instrumentations = [new HttpInstrumentation(), new ExpressInstrumentation()]\n  registerInstrumentations({ instrumentations })\n}\n","import type { NoReqParams } from '@xylabs/express'\nimport { setRawResponseFormat } from '@xylabs/express'\nimport type { RequestHandler } from 'express'\nimport { ReasonPhrases } from 'http-status-codes'\n\nconst message = ReasonPhrases.OK\n\nconst handler: RequestHandler<NoReqParams> = (_req, res) => {\n  setRawResponseFormat(res)\n  res.status(200).send({ message })\n}\n\nexport const getLivez: RequestHandler<NoReqParams> = handler\n","import type { NoReqParams } from '@xylabs/express'\nimport { setRawResponseFormat } from '@xylabs/express'\nimport type { RequestHandler } from 'express'\nimport { ReasonPhrases } from 'http-status-codes'\n\nconst message = ReasonPhrases.OK\n\nconst handler: RequestHandler<NoReqParams> = (_req, res) => {\n  setRawResponseFormat(res)\n  res.status(200).send({ message })\n}\n\nexport const getReadyz: RequestHandler<NoReqParams> = handler\n","import type { NoReqParams } from '@xylabs/express'\nimport { setRawResponseFormat } from '@xylabs/express'\nimport type { RequestHandler } from 'express'\nimport { ReasonPhrases } from 'http-status-codes'\n\nconst message = ReasonPhrases.OK\n\nconst handler: RequestHandler<NoReqParams> = (_req, res) => {\n  setRawResponseFormat(res)\n  res.status(200).send({ message })\n}\n\nexport const getStartupz: RequestHandler<NoReqParams> = handler\n","import type { Express } from 'express'\n\nimport { getLivez } from './livez/index.ts'\nimport { getReadyz } from './readyz/index.ts'\nimport { getStartupz } from './startupz/index.ts'\n\nexport const addProbeRoutes = (app: Express) => {\n  app.get('/livez', getLivez)\n  app.get('/readyz', getReadyz)\n  app.get('/startupz', getStartupz)\n}\n","import { setRawResponseFormat } from '@xylabs/express'\nimport { asHash, isDefined } from '@xylabs/sdk-js'\nimport type {\n  ArchivistInstance,\n  ArchivistNextOptions, ModuleIdentifier,\n  NextOptions, NodeInstance, Payload,\n} from '@xyo-network/sdk-js'\nimport {\n  asArchivistInstance, isAnyPayload, isSequence, PayloadBuilder,\n} from '@xyo-network/sdk-js'\nimport type { Request, Router } from 'express'\nimport express from 'express'\n\nconst resolveArchivist = async (node: NodeInstance, archivistModuleIdentifier: ModuleIdentifier): Promise<ArchivistInstance> => {\n  const mod = await node.resolve(archivistModuleIdentifier)\n  return asArchivistInstance(mod, { required: true })\n}\n\nlet archivistInstance: ArchivistInstance | undefined\n\nconst getArchivist = async (node: NodeInstance, archivistModuleIdentifier: ModuleIdentifier): Promise<ArchivistInstance> => {\n  if (isDefined(archivistInstance)) return archivistInstance\n  archivistInstance = await resolveArchivist(node, archivistModuleIdentifier)\n  return archivistInstance\n}\n\ninterface ArchivistMiddlewareOptions {\n  archivistModuleIdentifier: ModuleIdentifier\n  node: NodeInstance\n}\n\nexport const archivistMiddleware = (options: ArchivistMiddlewareOptions): Router => {\n  const { node, archivistModuleIdentifier } = options\n  const router = express.Router({ mergeParams: true })\n\n  router.post('/insert', async (req, res) => {\n    setRawResponseFormat(res)\n    const body = Array.isArray(req.body) ? req.body : [req.body]\n    const payloads = (await PayloadBuilder.hashPairs<Payload>(body)).map(p => p[0])\n    const archivist = await getArchivist(node, archivistModuleIdentifier)\n    const result = await archivist.insert(payloads)\n    res.status(200).json(result)\n  })\n\n  router.get('/next', async (req: Request<Partial<NextOptions>>, res) => {\n    setRawResponseFormat(res)\n    const cursor = isSequence(req.query.cursor) ? req.query.cursor : undefined\n    const limit = isDefined(req.query.limit) ? Number(req.query.limit) : undefined\n    const open = isDefined(req.query.open) ? Boolean(req.query.open) : undefined\n    const order = req.query.order === 'asc' ? 'asc' : 'desc'\n    const options: ArchivistNextOptions = {\n      limit, open, order, cursor,\n    }\n    const archivist = await getArchivist(node, archivistModuleIdentifier)\n    const result = await archivist.next(options)\n    res.status(200).json(result)\n  })\n  router.post('/next', async (req: Request<{}, {}, ArchivistNextOptions | undefined>, res) => {\n    setRawResponseFormat(res)\n    const options = req.body\n    const archivist = await getArchivist(node, archivistModuleIdentifier)\n    const result = await (isDefined(options) ? archivist.next(options) : archivist.next())\n    res.status(200).json(result)\n  })\n\n  router.get('/get/:hash', async (req, res) => {\n    setRawResponseFormat(res)\n    const { hash: rawHash } = req.params\n    const hash = asHash(rawHash)\n    if (isDefined(hash)) {\n      const archivist = await getArchivist(node, archivistModuleIdentifier)\n      const [payload] = await archivist.get([hash])\n      if (isAnyPayload(payload)) {\n        res.json(payload)\n        return\n      }\n    }\n    res.status(400).send()\n  })\n\n  return router\n}\n","import type { Express } from 'express'\n\nimport { archivistMiddleware } from './archivistMiddleware.ts'\n\nexport const addDataLakeRoutes = (app: Express) => {\n  const { node } = app.context\n  const archivistModuleIdentifier = 'Chain:Finalized'\n  app.use('/chain', archivistMiddleware({ node, archivistModuleIdentifier }))\n}\n","import { setRawResponseFormat } from '@xylabs/express'\nimport type { ApiConfigContext } from '@xyo-network/chain-orchestration'\nimport type { XyoConnection } from '@xyo-network/xl1-sdk'\nimport { rpcServerFromConnection, XyoConnectionMoniker } from '@xyo-network/xl1-sdk'\nimport type { Express } from 'express'\n\nimport { connectionSubsetBySurface } from '../connectionSubsetBySurface.ts'\n\n/**\n * Mounts the JSON-RPC route(s) on the Express app.\n *\n * Two endpoints are exposed:\n * - `POST /rpc` — gated by `ApiConfig.legacyMixedRpc`:\n *   - `legacyMixedRpc=true` (default): serves the full `XyoConnection`\n *     including indexed-surface methods (stake/networkStake/step). Preserves\n *     pre-Phase-7 behavior for clients that haven't migrated to `/rpc/indexed`.\n *   - `legacyMixedRpc=false`: serves only node-surface methods\n *     (block, transaction, mempool, finality, account-balance, time-sync).\n * - `POST /rpc/indexed` — indexed-surface methods only (cross-key/aggregate\n *   queries). Mounted independently of `legacyMixedRpc` whenever the locator's\n *   connection has indexed branches; omitted otherwise to keep the advertised\n *   surface honest.\n *\n * Both endpoints share the same underlying `XyoConnection`; surface filters\n * are applied via `connectionSubsetBySurface` immediately before constructing\n * each endpoint's RPC server. The downstream `rpcMethodHandlersFromConnection`\n * walker doesn't need to know about surfaces — it naturally produces a smaller\n * method set when handed a smaller connection.\n */\nexport const addRpcRoutes = async (\n  app: Express,\n) => {\n  const { context } = app\n  const { locator } = context\n  const apiConfig = (context as unknown as ApiConfigContext).config\n  const useLegacyMixed = apiConfig.legacyMixedRpc !== false\n\n  const connection = await locator.getInstance<XyoConnection>(XyoConnectionMoniker)\n  const indexedPresent = hasAnyIndexedBranch(connection)\n\n  if (useLegacyMixed && indexedPresent) {\n    context.logger?.warn(\n      '[api] /rpc is serving indexed methods (LEGACY_MIXED_RPC=true). '\n      + 'Indexed clients should migrate to /rpc/indexed; flip XL1_ACTORS__API__LEGACY_MIXED_RPC=false to enforce strict node-surface-only at /rpc.',\n    )\n  }\n\n  const rpcConnection = useLegacyMixed ? connection : connectionSubsetBySurface(connection, 'node')\n  const rpcServer = rpcServerFromConnection(rpcConnection)\n  app.post('/rpc', async (req, res) => {\n    setRawResponseFormat(res)\n    const rpcResponse = await rpcServer.handle(req.body)\n    res.json(rpcResponse)\n  })\n\n  if (indexedPresent) {\n    const indexedConnection = connectionSubsetBySurface(connection, 'indexed')\n    const indexedRpcServer = rpcServerFromConnection(indexedConnection)\n    app.post('/rpc/indexed', async (req, res) => {\n      setRawResponseFormat(res)\n      const rpcResponse = await indexedRpcServer.handle(req.body)\n      res.json(rpcResponse)\n    })\n  }\n}\n\nfunction hasAnyIndexedBranch(connection: XyoConnection): boolean {\n  if (connection.networkStake) return true\n  if (connection.storage) return true\n  if (connection.viewer) {\n    const v = connection.viewer\n    if (v.networkStake || v.stake || v.step) return true\n  }\n  return false\n}\n","/**\n * The canonical implementation of `connectionSubsetBySurface` lives in\n * `@xyo-network/xl1-protocol-sdk` (re-exported via `@xyo-network/xl1-sdk`).\n * This file re-exports it so existing imports inside this package keep\n * working without churn.\n */\nexport { connectionSubsetBySurface } from '@xyo-network/xl1-sdk'\n","import type { Express } from 'express'\n\nimport { addProbeRoutes } from './addProbeRoutes.ts'\nimport { addDataLakeRoutes } from './dataLake/index.ts'\nimport { addRpcRoutes } from './rpc/index.ts'\n\nexport const addRoutes = async (\n  app: Express,\n) => {\n  addProbeRoutes(app)\n  await addRpcRoutes(app)\n  addDataLakeRoutes(app)\n}\n","import type { HostActorConfigContext } from '@xyo-network/xl1-sdk'\n\nimport { getApp } from './app.ts'\n\nconst hostname = '::'\n\nexport async function getServer(context: HostActorConfigContext) {\n  const { logger, config } = context\n  const { port } = config\n\n  const app = await getApp(context)\n  const server = await new Promise<ReturnType<typeof app.listen>>((resolve, reject) => {\n    const srv = app.listen(port, hostname, () => {\n      logger?.info(`[API] Server listening at http://${hostname}:${port}`)\n      resolve(srv)\n    })\n    srv.once('error', reject)\n  })\n  server.setTimeout(20_000)\n  return server\n}\n","import { getFinalizerActor } from '@xyo-network/chain-finalizer'\nimport { getMempoolActor } from '@xyo-network/chain-mempool'\nimport type { GetLocatorsFromConfig } from '@xyo-network/chain-orchestration'\nimport {\n  ApiConfigZod, FinalizerConfigZod,\n  MempoolConfigZod,\n} from '@xyo-network/chain-orchestration'\nimport type { Config } from '@xyo-network/xl1-sdk'\nimport type { CommandModule } from 'yargs'\n\nimport { getApiActor } from './run.ts'\n\nexport function apiCommand(getConfiguration: () => Config, getLocatorsFromConfig: GetLocatorsFromConfig): CommandModule {\n  return {\n    command: 'api',\n    deprecated: 'Use \"start api\" instead',\n    describe: 'Run a XL1 API Node',\n    handler: async () => {\n      const configuration = getConfiguration()\n      const { locators, orchestrator } = await getLocatorsFromConfig(['api', 'mempool', 'finalizer'], configuration)\n      const actors = await Promise.all([getApiActor(\n        ApiConfigZod.parse(locators['api'].context.config),\n        locators['api'],\n      ), getMempoolActor(\n        MempoolConfigZod.parse(locators['mempool'].context.config),\n        locators['mempool'],\n      ), getFinalizerActor(\n        FinalizerConfigZod.parse(locators['finalizer'].context.config),\n        locators['finalizer'],\n      )])\n\n      for (const actor of actors) {\n        await orchestrator.registerActor(actor)\n      }\n\n      await orchestrator.start()\n    },\n  }\n}\n","import type { ApiConfig, OrchestratorInstance } from '@xyo-network/chain-orchestration'\nimport { initActorWallet } from '@xyo-network/chain-orchestration'\nimport type { ProviderFactoryLocatorInstance } from '@xyo-network/xl1-sdk'\n\nimport { ApiActor } from './ApiActor.ts'\n\nexport const getApiActor = async (\n  config: ApiConfig,\n  locator: ProviderFactoryLocatorInstance,\n) => {\n  const account = await initActorWallet({\n    config, singletons: {}, caches: {},\n  })\n  const params = {\n    account, config, locator,\n  }\n  // Create actors\n  return await ApiActor.create(params)\n}\n\nexport const runApi = async (\n  config: ApiConfig,\n  orchestrator: OrchestratorInstance,\n  locator: ProviderFactoryLocatorInstance,\n) => {\n  const actors = [await getApiActor(config, locator)]\n\n  // Register the actors with the orchestrator\n  for (const actor of actors) {\n    await orchestrator.registerActor(actor)\n  }\n\n  // Start the orchestrator => automatically activates the actors\n  await orchestrator.start()\n}\n"],"mappings":"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","names":["creatable","ActorV3","AccountBalanceViewerMoniker","asHostActorConfigContext","BlockViewerMoniker","FinalizationViewerMoniker","MempoolViewerMoniker","TransactionViewerMoniker","XyoConnectionMoniker","XyoViewerMoniker","standardErrors","sharedMiddleware","express","registerInstrumentations","ExpressInstrumentation","HttpInstrumentation","addInstrumentation","instrumentations","HttpInstrumentation","ExpressInstrumentation","registerInstrumentations","setRawResponseFormat","ReasonPhrases","message","ReasonPhrases","OK","handler","_req","res","setRawResponseFormat","status","send","getLivez","setRawResponseFormat","ReasonPhrases","message","ReasonPhrases","OK","handler","_req","res","setRawResponseFormat","status","send","getReadyz","setRawResponseFormat","ReasonPhrases","message","ReasonPhrases","OK","handler","_req","res","setRawResponseFormat","status","send","getStartupz","addProbeRoutes","app","get","getLivez","getReadyz","getStartupz","setRawResponseFormat","asHash","isDefined","asArchivistInstance","isAnyPayload","isSequence","PayloadBuilder","express","resolveArchivist","node","archivistModuleIdentifier","mod","resolve","asArchivistInstance","required","archivistInstance","getArchivist","isDefined","archivistMiddleware","options","router","express","Router","mergeParams","post","req","res","setRawResponseFormat","body","Array","isArray","payloads","PayloadBuilder","hashPairs","map","p","archivist","result","insert","status","json","get","cursor","isSequence","query","undefined","limit","Number","open","Boolean","order","next","hash","rawHash","params","asHash","payload","isAnyPayload","send","addDataLakeRoutes","app","node","context","archivistModuleIdentifier","use","archivistMiddleware","setRawResponseFormat","rpcServerFromConnection","XyoConnectionMoniker","connectionSubsetBySurface","addRpcRoutes","app","context","locator","apiConfig","config","useLegacyMixed","legacyMixedRpc","connection","getInstance","XyoConnectionMoniker","indexedPresent","hasAnyIndexedBranch","logger","warn","rpcConnection","connectionSubsetBySurface","rpcServer","rpcServerFromConnection","post","req","res","setRawResponseFormat","rpcResponse","handle","body","json","indexedConnection","indexedRpcServer","networkStake","storage","viewer","v","stake","step","addRoutes","app","addProbeRoutes","addRpcRoutes","addDataLakeRoutes","getApp","context","addInstrumentation","app","express","sharedMiddleware","addRoutes","use","standardErrors","hostname","getServer","context","logger","config","port","app","getApp","server","Promise","resolve","reject","srv","listen","info","once","setTimeout","ApiActor","ActorV3","needs","required","AccountBalanceViewerMoniker","BlockViewerMoniker","FinalizationViewerMoniker","MempoolViewerMoniker","TransactionViewerMoniker","XyoConnectionMoniker","XyoViewerMoniker","server","createHandler","startHandler","stopServer","startServer","stopHandler","getServer","asHostActorConfigContext","context","close","undefined","getFinalizerActor","getMempoolActor","ApiConfigZod","FinalizerConfigZod","MempoolConfigZod","initActorWallet","getApiActor","config","locator","account","initActorWallet","singletons","caches","params","ApiActor","create","runApi","orchestrator","actors","actor","registerActor","start","apiCommand","getConfiguration","getLocatorsFromConfig","command","deprecated","describe","handler","configuration","locators","orchestrator","actors","Promise","all","getApiActor","ApiConfigZod","parse","context","config","getMempoolActor","MempoolConfigZod","getFinalizerActor","FinalizerConfigZod","actor","registerActor","start"]}

package/dist/node/{runApi.d.ts → run.d.ts}

@@ -3,4 +3,4 @@ import type { ProviderFactoryLocatorInstance } from '@xyo-network/xl1-sdk';
 import { ApiActor } from './ApiActor.ts';
 export declare const getApiActor: (config: ApiConfig, locator: ProviderFactoryLocatorInstance) => Promise<ApiActor>;
 export declare const runApi: (config: ApiConfig, orchestrator: OrchestratorInstance, locator: ProviderFactoryLocatorInstance) => Promise<void>;
-//# sourceMappingURL=runApi.d.ts.map
+//# sourceMappingURL=run.d.ts.map

package/dist/node/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AAEvF,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAA;AAE1E,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,eAAO,MAAM,WAAW,GACtB,QAAQ,SAAS,EACjB,SAAS,8BAA8B,sBAUxC,CAAA;AAED,eAAO,MAAM,MAAM,GACjB,QAAQ,SAAS,EACjB,cAAc,oBAAoB,EAClC,SAAS,8BAA8B,kBAWxC,CAAA"}

package/dist/node/server/routes/rpc/connectionSubsetBySurface.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The canonical implementation of `connectionSubsetBySurface` lives in
+ * `@xyo-network/xl1-protocol-sdk` (re-exported via `@xyo-network/xl1-sdk`).
+ * This file re-exports it so existing imports inside this package keep
+ * working without churn.
+ */
+export { connectionSubsetBySurface } from '@xyo-network/xl1-sdk';
+//# sourceMappingURL=connectionSubsetBySurface.d.ts.map

package/dist/node/server/routes/rpc/connectionSubsetBySurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectionSubsetBySurface.d.ts","sourceRoot":"","sources":["../../../../../src/server/routes/rpc/connectionSubsetBySurface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/node/server/routes/rpc/routes/addRpcRoutes.d.ts

@@ -1,3 +1,24 @@
 import type { Express } from 'express';
+/**
+ * Mounts the JSON-RPC route(s) on the Express app.
+ *
+ * Two endpoints are exposed:
+ * - `POST /rpc` — gated by `ApiConfig.legacyMixedRpc`:
+ *   - `legacyMixedRpc=true` (default): serves the full `XyoConnection`
+ *     including indexed-surface methods (stake/networkStake/step). Preserves
+ *     pre-Phase-7 behavior for clients that haven't migrated to `/rpc/indexed`.
+ *   - `legacyMixedRpc=false`: serves only node-surface methods
+ *     (block, transaction, mempool, finality, account-balance, time-sync).
+ * - `POST /rpc/indexed` — indexed-surface methods only (cross-key/aggregate
+ *   queries). Mounted independently of `legacyMixedRpc` whenever the locator's
+ *   connection has indexed branches; omitted otherwise to keep the advertised
+ *   surface honest.
+ *
+ * Both endpoints share the same underlying `XyoConnection`; surface filters
+ * are applied via `connectionSubsetBySurface` immediately before constructing
+ * each endpoint's RPC server. The downstream `rpcMethodHandlersFromConnection`
+ * walker doesn't need to know about surfaces — it naturally produces a smaller
+ * method set when handed a smaller connection.
+ */
 export declare const addRpcRoutes: (app: Express) => Promise<void>;
 //# sourceMappingURL=addRpcRoutes.d.ts.map

package/dist/node/server/routes/rpc/routes/addRpcRoutes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addRpcRoutes.d.ts","sourceRoot":"","sources":["../../../../../../src/server/routes/rpc/routes/addRpcRoutes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtC,eAAO,MAAM,YAAY,GACvB,KAAK,OAAO,kBAab,CAAA"}
+{"version":3,"file":"addRpcRoutes.d.ts","sourceRoot":"","sources":["../../../../../../src/server/routes/rpc/routes/addRpcRoutes.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAItC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,YAAY,GACvB,KAAK,OAAO,kBAkCb,CAAA"}

package/dist/node/server/routes/rpc/surfaceMap.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The canonical surface map lives in `@xyo-network/xl1-protocol-sdk`
+ * (re-exported via `@xyo-network/xl1-sdk`). This file re-exports the
+ * artifacts so existing imports inside this package keep working.
+ */
+export type { Surface } from '@xyo-network/xl1-sdk';
+export { surfaceForBranch, VIEWER_BRANCH_KEYS } from '@xyo-network/xl1-sdk';
+//# sourceMappingURL=surfaceMap.d.ts.map

package/dist/node/server/routes/rpc/surfaceMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceMap.d.ts","sourceRoot":"","sources":["../../../../../src/server/routes/rpc/surfaceMap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,YAAY,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyo-network/chain-api",
-  "version": "1.20.29",
+  "version": "1.21.0",
   "description": "XYO Layer One API",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -35,11 +35,13 @@
     "README.md"
   ],
   "dependencies": {
-    "@xyo-network/chain-orchestration": "~1.20.29"
+    "@xyo-network/chain-finalizer": "~1.21.0",
+    "@xyo-network/chain-mempool": "~1.21.0",
+    "@xyo-network/chain-orchestration": "~1.21.0"
   },
   "devDependencies": {
     "@bitauth/libauth": "~3.0.0",
-    "@metamask/json-rpc-engine": "^10.2.4",
+    "@metamask/json-rpc-engine": "^10.3.0",
     "@metamask/providers": "^22.1.1",
     "@metamask/utils": "~11.11.0",
     "@opentelemetry/api": "^1.9.1",
@@ -62,42 +64,43 @@
     "@scure/bip39": "~2.2.0",
     "@types/express": "^5.0.6",
     "@types/node": "^25.6.0",
-    "@xylabs/express": "^5.0.101",
-    "@xylabs/geo": "^5.0.101",
-    "@xylabs/mongo": "^5.0.101",
-    "@xylabs/sdk-js": "^5.0.101",
-    "@xylabs/threads": "~5.0.101",
-    "@xylabs/toolchain": "~7.12.3",
-    "@xylabs/tsconfig": "~7.12.3",
-    "@xyo-network/account": "~5.5.2",
-    "@xyo-network/account-model": "~5.5.2",
-    "@xyo-network/api": "~5.5.2",
-    "@xyo-network/api-models": "~5.5.2",
-    "@xyo-network/archivist-lmdb": "~5.5.6",
-    "@xyo-network/archivist-mongodb": "~5.5.6",
-    "@xyo-network/archivist-view": "~5.5.6",
+    "@types/yargs": "^17.0.35",
+    "@xylabs/express": "^5.1.1",
+    "@xylabs/fetch": "~5.1.1",
+    "@xylabs/geo": "^5.1.1",
+    "@xylabs/mongo": "^5.1.1",
+    "@xylabs/sdk-js": "^5.1.1",
+    "@xylabs/threads": "~5.1.1",
+    "@xylabs/toolchain": "~7.13.7",
+    "@xylabs/tsconfig": "~7.13.7",
+    "@xyo-network/account": "~5.6.1",
+    "@xyo-network/account-model": "~5.6.2",
+    "@xyo-network/api": "~5.6.1",
+    "@xyo-network/api-models": "~5.6.2",
+    "@xyo-network/archivist-lmdb": "~5.6.3",
+    "@xyo-network/archivist-mongodb": "~5.6.3",
+    "@xyo-network/archivist-view": "~5.6.3",
     "@xyo-network/bios-model": "~7.3.0",
-    "@xyo-network/boundwitness-builder": "~5.5.2",
-    "@xyo-network/boundwitness-model": "~5.5.2",
-    "@xyo-network/boundwitness-validator": "~5.5.2",
-    "@xyo-network/boundwitness-wrapper": "~5.5.2",
-    "@xyo-network/config-payload-plugin": "~5.5.2",
-    "@xyo-network/huri": "~5.5.2",
-    "@xyo-network/manifest-model": "~5.5.2",
-    "@xyo-network/payload-builder": "~5.5.2",
-    "@xyo-network/payload-model": "~5.5.2",
-    "@xyo-network/payload-plugin": "~5.5.2",
-    "@xyo-network/payload-wrapper": "~5.5.2",
-    "@xyo-network/query-payload-plugin": "~5.5.2",
-    "@xyo-network/sdk-js": "^5.5.6",
-    "@xyo-network/sdk-protocol-js": "~5.5.2",
+    "@xyo-network/boundwitness-builder": "~5.6.1",
+    "@xyo-network/boundwitness-model": "~5.6.2",
+    "@xyo-network/boundwitness-wrapper": "~5.6.1",
+    "@xyo-network/config-payload-plugin": "~5.6.2",
+    "@xyo-network/huri": "~5.6.1",
+    "@xyo-network/manifest-model": "~5.6.2",
+    "@xyo-network/payload-builder": "~5.6.1",
+    "@xyo-network/payload-model": "~5.6.2",
+    "@xyo-network/payload-plugin": "~5.6.2",
+    "@xyo-network/payload-wrapper": "~5.6.1",
+    "@xyo-network/query-payload-plugin": "~5.6.2",
+    "@xyo-network/sdk-js": "^5.6.3",
+    "@xyo-network/sdk-protocol-js": "~5.6.2",
     "@xyo-network/typechain": "^4.1.3",
-    "@xyo-network/wallet": "~5.5.2",
-    "@xyo-network/wallet-model": "^5.5.2",
-    "@xyo-network/xl1-sdk": "^1.26.44",
+    "@xyo-network/wallet": "~5.6.1",
+    "@xyo-network/wallet-model": "^5.6.2",
+    "@xyo-network/xl1-protocol-sdk": "~1.27.1",
+    "@xyo-network/xl1-sdk": "^1.27.1",
     "ajv": "^8.20.0",
     "async-mutex": "^0.5.0",
-    "axios": "^1.15.2",
     "bn.js": "^5.2.3",
     "body-parser": "~2.2.2",
     "buffer": "^6.0.3",
@@ -108,8 +111,7 @@
     "cosmiconfig": "^9.0.1",
     "debug": "~4.4.3",
     "dotenv": "~17.4.2",
-    "esbuild": "^0.28.0",
-    "eslint": "^10.2.1",
+    "eslint": "^10.3.0",
     "ethers": "^6.16.0",
     "express": "^5.2.1",
     "express-mung": "~0.5.1",
@@ -117,8 +119,8 @@
     "http-status-codes": "~2.3.0",
     "idb": "^8.0.3",
     "lmdb": "^3.5.4",
-    "lru-cache": "^11.3.5",
-    "mapbox-gl": "^3.23.0",
+    "lru-cache": "^11.3.6",
+    "mapbox-gl": "^3.23.1",
     "mongodb": "^7.2.0",
     "nodemon": "~3.1.14",
     "observable-fns": "~0.6.1",
@@ -136,11 +138,12 @@
     "webextension-polyfill": "^0.12.0",
     "winston": "~3.19.0",
     "winston-transport": "~4.9.0",
-    "zod": "~4.4.2"
+    "yargs": "~18.0.0",
+    "zod": "~4.4.3"
   },
   "peerDependencies": {
     "@bitauth/libauth": ">=3.0.0 <3.1",
-    "@metamask/json-rpc-engine": ">=10.2.4 <11",
+    "@metamask/json-rpc-engine": ">=10.3.0 <11",
     "@metamask/providers": ">=22.1.1 <23",
     "@metamask/utils": ">=11.11.0 <11.12",
     "@opentelemetry/api": ">=1.9.1 <2",
@@ -161,40 +164,40 @@
     "@opentelemetry/semantic-conventions": ">=1.40.0 <1.41",
     "@scure/base": ">=2.2.0 <2.3",
     "@scure/bip39": ">=2.2.0 <2.3",
-    "@xylabs/express": ">=5.0.101 <6",
-    "@xylabs/geo": ">=5.0.101 <6",
-    "@xylabs/mongo": ">=5.0.101 <6",
-    "@xylabs/sdk-js": ">=5.0.101 <6",
-    "@xylabs/threads": ">=5.0.101 <5.1",
-    "@xyo-network/account": ">=5.5.2 <5.6",
-    "@xyo-network/account-model": ">=5.5.2 <5.6",
-    "@xyo-network/api": ">=5.5.2 <5.6",
-    "@xyo-network/api-models": ">=5.5.2 <5.6",
-    "@xyo-network/archivist-lmdb": ">=5.5.6 <5.6",
-    "@xyo-network/archivist-mongodb": ">=5.5.6 <5.6",
-    "@xyo-network/archivist-view": ">=5.5.6 <5.6",
+    "@xylabs/express": ">=5.1.1 <6",
+    "@xylabs/fetch": ">=5.1.1 <5.2",
+    "@xylabs/geo": ">=5.1.1 <6",
+    "@xylabs/mongo": ">=5.1.1 <6",
+    "@xylabs/sdk-js": ">=5.1.1 <6",
+    "@xylabs/threads": ">=5.1.1 <5.2",
+    "@xyo-network/account": ">=5.6.1 <5.7",
+    "@xyo-network/account-model": ">=5.6.2 <5.7",
+    "@xyo-network/api": ">=5.6.1 <5.7",
+    "@xyo-network/api-models": ">=5.6.2 <5.7",
+    "@xyo-network/archivist-lmdb": ">=5.6.3 <5.7",
+    "@xyo-network/archivist-mongodb": ">=5.6.3 <5.7",
+    "@xyo-network/archivist-view": ">=5.6.3 <5.7",
     "@xyo-network/bios-model": ">=7.3.0 <7.4",
-    "@xyo-network/boundwitness-builder": ">=5.5.2 <5.6",
-    "@xyo-network/boundwitness-model": ">=5.5.2 <5.6",
-    "@xyo-network/boundwitness-validator": ">=5.5.2 <5.6",
-    "@xyo-network/boundwitness-wrapper": ">=5.5.2 <5.6",
-    "@xyo-network/config-payload-plugin": ">=5.5.2 <5.6",
-    "@xyo-network/huri": ">=5.5.2 <5.6",
-    "@xyo-network/manifest-model": ">=5.5.2 <5.6",
-    "@xyo-network/payload-builder": ">=5.5.2 <5.6",
-    "@xyo-network/payload-model": ">=5.5.2 <5.6",
-    "@xyo-network/payload-plugin": ">=5.5.2 <5.6",
-    "@xyo-network/payload-wrapper": ">=5.5.2 <5.6",
-    "@xyo-network/query-payload-plugin": ">=5.5.2 <5.6",
-    "@xyo-network/sdk-js": ">=5.5.6 <6",
-    "@xyo-network/sdk-protocol-js": ">=5.5.2 <5.6",
+    "@xyo-network/boundwitness-builder": ">=5.6.1 <5.7",
+    "@xyo-network/boundwitness-model": ">=5.6.2 <5.7",
+    "@xyo-network/boundwitness-wrapper": ">=5.6.1 <5.7",
+    "@xyo-network/config-payload-plugin": ">=5.6.2 <5.7",
+    "@xyo-network/huri": ">=5.6.1 <5.7",
+    "@xyo-network/manifest-model": ">=5.6.2 <5.7",
+    "@xyo-network/payload-builder": ">=5.6.1 <5.7",
+    "@xyo-network/payload-model": ">=5.6.2 <5.7",
+    "@xyo-network/payload-plugin": ">=5.6.2 <5.7",
+    "@xyo-network/payload-wrapper": ">=5.6.1 <5.7",
+    "@xyo-network/query-payload-plugin": ">=5.6.2 <5.7",
+    "@xyo-network/sdk-js": ">=5.6.3 <6",
+    "@xyo-network/sdk-protocol-js": ">=5.6.2 <5.7",
     "@xyo-network/typechain": ">=4.1.3 <5",
-    "@xyo-network/wallet": ">=5.5.2 <5.6",
-    "@xyo-network/wallet-model": ">=5.5.2 <6",
-    "@xyo-network/xl1-sdk": ">=1.26.44 <2",
+    "@xyo-network/wallet": ">=5.6.1 <5.7",
+    "@xyo-network/wallet-model": ">=5.6.2 <6",
+    "@xyo-network/xl1-protocol-sdk": ">=1.27.1 <1.28",
+    "@xyo-network/xl1-sdk": ">=1.27.1 <2",
     "ajv": ">=8.20.0 <9",
     "async-mutex": ">=0.5.0 <1",
-    "axios": ">=1.15.2 <2",
     "bn.js": ">=5.2.3 <6",
     "body-parser": ">=2.2.2 <2.3",
     "buffer": ">=6.0.3 <7",
@@ -211,21 +214,22 @@
     "http-status-codes": ">=2.3.0 <2.4",
     "idb": ">=8.0.3 <9",
     "lmdb": ">=3.5.4 <4",
-    "lru-cache": ">=11.3.5 <12",
-    "mapbox-gl": ">=3.23.0 <4",
+    "lru-cache": ">=11.3.6 <12",
+    "mapbox-gl": ">=3.23.1 <4",
     "mongodb": ">=7.2.0 <8",
     "observable-fns": ">=0.6.1 <0.7",
     "pako": ">=2.1.0 <3",
     "rollbar": ">=3.1.0 <4",
     "shallowequal": ">=1.1.0 <1.2",
     "store2": ">=2.14.4 <2.15",
-    "typescript": ">=5.9.3 <5.10",
     "uuid": ">=14.0.0 <14.1",
     "wasm-feature-detect": ">=1.8.0 <1.9",
     "web3-types": ">=1.10.0 <1.11",
+    "webextension-polyfill": ">=0.12.0 <1",
     "winston": ">=3.19.0 <3.20",
     "winston-transport": ">=4.9.0 <4.10",
-    "zod": ">=4.4.2 <4.5"
+    "yargs": ">=18.0.0 <18.1",
+    "zod": ">=4.4.3 <4.5"
   },
   "engines": {
     "node": ">=24"

package/dist/node/runApi.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"runApi.d.ts","sourceRoot":"","sources":["../../src/runApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AAEvF,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAA;AAE1E,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,eAAO,MAAM,WAAW,GACtB,QAAQ,SAAS,EACjB,SAAS,8BAA8B,sBAUxC,CAAA;AAED,eAAO,MAAM,MAAM,GACjB,QAAQ,SAAS,EACjB,cAAc,oBAAoB,EAClC,SAAS,8BAA8B,kBAWxC,CAAA"}