@canton-network/core-provider-ledger 0.2.0

package/README.md

@@ -0,0 +1,74 @@
+# provider-ledger
+
+This package provides a SpliceProvider (see https://github.com/hyperledger-labs/splice-wallet-kernel/tree/main/core/splice-provider) implementation intended for direct Ledger usage. It is suitable for both NodeJS and browser environments, but if you are building a Canton dApp, then you likely want to use the [`dapp-sdk`](https://www.npmjs.com/package/@canton-network/dapp-sdk) instead, which gives a `DappProvider`.
+
+This provider only supports a single method, `ledgerApi`, which proxies request through to an underlying Ledger JSON-API client. Due to the nature of the Canton Ledger JSON-API, the only supported transport is HTTP.
+
+## usage
+
+```ts
+import { LedgerProvider } from '@canton-network/core-provider-ledger'
+
+const provider = new LedgerProvider({
+    baseUrl: 'https://ledger-api.example.com',
+    accessToken: 'jwt...',
+})
+
+const version = await provider.request({
+    method: 'ledgerApi',
+    params: {
+        resource: '/v2/version',
+        requestMethod: 'get',
+    },
+})
+```
+
+## types
+
+Due to some type inference limitations, the return type of request collapses to `unknown`. In order to aid the compiler, you can supply an optional type argument corresponding to the operation you are using on the ledgerApi. Afterwards, the response is cleanly typed:
+
+```ts
+import { LedgerProvider, Ops } from '@canton-network/core-provider-ledger'
+
+// ...
+
+const party = await provider.request<Ops.PostV2Parties>({
+    method: 'ledgerApi',
+    params: {
+        resource: '/v2/parties',
+        requestMethod: 'post',
+        body: {
+            partyHint: 'my-party',
+        },
+    },
+})
+
+console.log(party.partyDetails?.party)
+```
+
+## data
+
+There are various ways to pass data into the request, depending on the operation. Let type inference guide you, but know there are three possibilities:
+
+```ts
+
+provider.request({
+    method: 'ledgerApi',
+    params: {
+        ...,
+        body?: {
+            // usually for POST requests (JSON object body)
+        },
+        path?: {
+            // `path` arguments, usually for GET requests (i.e., `/v2/parties/{party-id}`)
+            "party-id": "some-party-id"
+        },
+        query?: {
+            // `query` params, usually for GET requests (i.e., `/v2/...?param=data`)
+            "param": "data"
+        }
+    }
+})
+```
+
+Any particular operation may require just one, none, or multiple client data inputs.

package/dist/LedgerProvider.d.ts

@@ -0,0 +1,33 @@
+import { AbstractProvider } from '@canton-network/core-splice-provider';
+import { RequestArgs } from '@canton-network/core-types';
+import { LedgerTypes } from '@canton-network/core-ledger-client-types';
+export declare class LedgerProvider extends AbstractProvider<LedgerTypes> {
+    private client;
+    constructor({ baseUrl, accessToken, }: {
+        baseUrl: string | URL;
+        accessToken: string;
+    });
+    /**
+     *
+     * Example usage:
+     *
+     * const provider = new LedgerProvider(...)
+     *
+     * // Caveat: TypeScript can infer the correct params body based on the method + API path, but the result will be typed as `unknown` without a type argument:
+     *
+     * const result1 = await provider.request({ method: 'ledgerApi', params: { ... } });
+     * //    ^ type = `unknown`
+     *
+     *
+     * // Specify an operation type to get a fully typed result:
+     *
+     * const result2 = await provider.request<Ops.PostV2Parties>({ method: 'ledgerApi', params: { ... } });
+     * //    ^ type = `PostV2Parties['ledgerApi']['result']`
+     *
+     * @param args
+     * @returns
+     */
+    request<L extends LedgerTypes>(args: RequestArgs<L, 'ledgerApi'>): Promise<L['ledgerApi']['result']>;
+    private getLedgerParams;
+}
+//# sourceMappingURL=LedgerProvider.d.ts.map

package/dist/LedgerProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LedgerProvider.d.ts","sourceRoot":"","sources":["../src/LedgerProvider.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAA;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAA;AAQtE,qBAAa,cAAe,SAAQ,gBAAgB,CAAC,WAAW,CAAC;IAC7D,OAAO,CAAC,MAAM,CAAc;gBAEhB,EACR,OAAO,EACP,WAAW,GACd,EAAE;QACC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAA;QACrB,WAAW,EAAE,MAAM,CAAA;KACtB;IAUD;;;;;;;;;;;;;;;;;;;OAmBG;IACU,OAAO,CAAC,CAAC,SAAS,WAAW,EACtC,IAAI,EAAE,WAAW,CAAC,CAAC,EAAE,WAAW,CAAC,GAClC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAC;IAuCpC,OAAO,CAAC,eAAe;CAgB1B"}

package/dist/index.cjs

@@ -0,0 +1,105 @@
+'use strict';
+
+var coreSpliceProvider = require('@canton-network/core-splice-provider');
+var coreLedgerClient = require('@canton-network/core-ledger-client');
+var pino = require('pino');
+var coreLedgerClientTypes = require('@canton-network/core-ledger-client-types');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var pino__default = /*#__PURE__*/_interopDefault(pino);
+
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, key + "" , value);
+var LedgerProvider = class extends coreSpliceProvider.AbstractProvider {
+  constructor({
+    baseUrl,
+    accessToken
+  }) {
+    super();
+    __publicField(this, "client");
+    this.client = new coreLedgerClient.LedgerClient({
+      baseUrl: typeof baseUrl === "string" ? new URL(baseUrl) : baseUrl,
+      accessToken,
+      // TODO: use some generalized logger
+      logger: pino__default.default({ name: "LedgerProvider" })
+    });
+  }
+  /**
+   *
+   * Example usage:
+   *
+   * const provider = new LedgerProvider(...)
+   *
+   * // Caveat: TypeScript can infer the correct params body based on the method + API path, but the result will be typed as `unknown` without a type argument:
+   *
+   * const result1 = await provider.request({ method: 'ledgerApi', params: { ... } });
+   * //    ^ type = `unknown`
+   *
+   *
+   * // Specify an operation type to get a fully typed result:
+   *
+   * const result2 = await provider.request<Ops.PostV2Parties>({ method: 'ledgerApi', params: { ... } });
+   * //    ^ type = `PostV2Parties['ledgerApi']['result']`
+   *
+   * @param args
+   * @returns
+   */
+  async request(args) {
+    console.log("Received request:", args);
+    if (args.method === "ledgerApi" && "params" in args) {
+      switch (args.params.requestMethod) {
+        case "get": {
+          const params = this.getLedgerParams(args.params);
+          return await this.client.getWithRetry(
+            args.params.resource,
+            // TODO: casting is necessary b/c of v3.3/v3.4 differences
+            void 0,
+            params
+          );
+        }
+        case "post": {
+          const params = this.getLedgerParams(args.params);
+          const body = "body" in args.params ? args.params.body : {};
+          return await this.client.postWithRetry(
+            args.params.resource,
+            // TODO: casting is necessary b/c of v3.3/v3.4 differences
+            body,
+            // TODO: need to fix client typing
+            void 0,
+            params
+          );
+        }
+        // TODO: generalize LedgerClient to support any HTTP method
+        case "delete":
+        case "patch":
+        default: {
+          throw new Error(
+            `Unsupported request method: ${args.params.requestMethod}`
+          );
+        }
+      }
+    } else {
+      throw new Error(`Unsupported method: ${args.method}`);
+    }
+  }
+  getLedgerParams(params) {
+    const extracted = {};
+    if ("path" in params) {
+      Object.assign(extracted, { path: params.path });
+    }
+    if ("query" in params) {
+      Object.assign(extracted, { query: params.query });
+    }
+    return extracted;
+  }
+};
+
+Object.defineProperty(exports, "Ops", {
+  enumerable: true,
+  get: function () { return coreLedgerClientTypes.Provider; }
+});
+exports.LedgerProvider = LedgerProvider;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/LedgerProvider.ts"],"names":["AbstractProvider","LedgerClient","pino"],"mappings":";;;;;;;;;;;;;;AAaO,IAAM,cAAA,GAAN,cAA6BA,mCAAA,CAA8B;AAAA,EAG9D,WAAA,CAAY;AAAA,IACR,OAAA;AAAA,IACA;AAAA,GACJ,EAGG;AACC,IAAA,KAAA,EAAM;AATV,IAAA,aAAA,CAAA,IAAA,EAAQ,QAAA,CAAA;AAUJ,IAAA,IAAA,CAAK,MAAA,GAAS,IAAIC,6BAAA,CAAa;AAAA,MAC3B,SAAS,OAAO,OAAA,KAAY,WAAW,IAAI,GAAA,CAAI,OAAO,CAAA,GAAI,OAAA;AAAA,MAC1D,WAAA;AAAA;AAAA,MAEA,MAAA,EAAQC,qBAAA,CAAK,EAAE,IAAA,EAAM,kBAAkB;AAAA,KAC1C,CAAA;AAAA,EACL;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAsBA,MAAa,QACT,IAAA,EACiC;AACjC,IAAA,OAAA,CAAQ,GAAA,CAAI,qBAAqB,IAAI,CAAA;AAErC,IAAA,IAAI,IAAA,CAAK,MAAA,KAAW,WAAA,IAAe,QAAA,IAAY,IAAA,EAAM;AACjD,MAAA,QAAQ,IAAA,CAAK,OAAO,aAAA;AAAe,QAC/B,KAAK,KAAA,EAAO;AACR,UAAA,MAAM,MAAA,GAAS,IAAA,CAAK,eAAA,CAAgB,IAAA,CAAK,MAAM,CAAA;AAE/C,UAAA,OAAO,MAAM,KAAK,MAAA,CAAO,YAAA;AAAA,YACrB,KAAK,MAAA,CAAO,QAAA;AAAA;AAAA,YACZ,MAAA;AAAA,YACA;AAAA,WACJ;AAAA,QACJ;AAAA,QACA,KAAK,MAAA,EAAQ;AACT,UAAA,MAAM,MAAA,GAAS,IAAA,CAAK,eAAA,CAAgB,IAAA,CAAK,MAAM,CAAA;AAC/C,UAAA,MAAM,OAAO,MAAA,IAAU,IAAA,CAAK,SAAS,IAAA,CAAK,MAAA,CAAO,OAAO,EAAC;AAEzD,UAAA,OAAO,MAAM,KAAK,MAAA,CAAO,aAAA;AAAA,YACrB,KAAK,MAAA,CAAO,QAAA;AAAA;AAAA,YACZ,IAAA;AAAA;AAAA,YACA,MAAA;AAAA,YACA;AAAA,WACJ;AAAA,QACJ;AAAA;AAAA,QAEA,KAAK,QAAA;AAAA,QACL,KAAK,OAAA;AAAA,QACL,SAAS;AACL,UAAA,MAAM,IAAI,KAAA;AAAA,YACN,CAAA,4BAAA,EAA+B,IAAA,CAAK,MAAA,CAAO,aAAa,CAAA;AAAA,WAC5D;AAAA,QACJ;AAAA;AACJ,IACJ,CAAA,MAAO;AACH,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,oBAAA,EAAuB,IAAA,CAAK,MAAM,CAAA,CAAE,CAAA;AAAA,IACxD;AAAA,EACJ;AAAA,EAEQ,gBAAgB,MAAA,EAGtB;AACE,IAAA,MAAM,YAAY,EAAC;AAEnB,IAAA,IAAI,UAAU,MAAA,EAAQ;AAClB,MAAA,MAAA,CAAO,OAAO,SAAA,EAAW,EAAE,IAAA,EAAM,MAAA,CAAO,MAAM,CAAA;AAAA,IAClD;AAEA,IAAA,IAAI,WAAW,MAAA,EAAQ;AACnB,MAAA,MAAA,CAAO,OAAO,SAAA,EAAW,EAAE,KAAA,EAAO,MAAA,CAAO,OAAO,CAAA;AAAA,IACpD;AAEA,IAAA,OAAO,SAAA;AAAA,EACX;AACJ","file":"index.cjs","sourcesContent":["// Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { AbstractProvider } from '@canton-network/core-splice-provider'\nimport { RequestArgs } from '@canton-network/core-types'\nimport { LedgerTypes } from '@canton-network/core-ledger-client-types'\nimport {\n    GetEndpoint,\n    LedgerClient,\n    PostEndpoint,\n} from '@canton-network/core-ledger-client'\nimport pino from 'pino'\n\nexport class LedgerProvider extends AbstractProvider<LedgerTypes> {\n    private client: LedgerClient\n\n    constructor({\n        baseUrl,\n        accessToken,\n    }: {\n        baseUrl: string | URL\n        accessToken: string\n    }) {\n        super()\n        this.client = new LedgerClient({\n            baseUrl: typeof baseUrl === 'string' ? new URL(baseUrl) : baseUrl,\n            accessToken,\n            // TODO: use some generalized logger\n            logger: pino({ name: 'LedgerProvider' }),\n        })\n    }\n\n    /**\n     *\n     * Example usage:\n     *\n     * const provider = new LedgerProvider(...)\n     *\n     * // Caveat: TypeScript can infer the correct params body based on the method + API path, but the result will be typed as `unknown` without a type argument:\n     *\n     * const result1 = await provider.request({ method: 'ledgerApi', params: { ... } });\n     * //    ^ type = `unknown`\n     *\n     *\n     * // Specify an operation type to get a fully typed result:\n     *\n     * const result2 = await provider.request<Ops.PostV2Parties>({ method: 'ledgerApi', params: { ... } });\n     * //    ^ type = `PostV2Parties['ledgerApi']['result']`\n     *\n     * @param args\n     * @returns\n     */\n    public async request<L extends LedgerTypes>(\n        args: RequestArgs<L, 'ledgerApi'>\n    ): Promise<L['ledgerApi']['result']> {\n        console.log('Received request:', args)\n\n        if (args.method === 'ledgerApi' && 'params' in args) {\n            switch (args.params.requestMethod) {\n                case 'get': {\n                    const params = this.getLedgerParams(args.params)\n\n                    return await this.client.getWithRetry(\n                        args.params.resource as GetEndpoint, // TODO: casting is necessary b/c of v3.3/v3.4 differences\n                        undefined,\n                        params\n                    )\n                }\n                case 'post': {\n                    const params = this.getLedgerParams(args.params)\n                    const body = 'body' in args.params ? args.params.body : {}\n\n                    return await this.client.postWithRetry(\n                        args.params.resource as PostEndpoint, // TODO: casting is necessary b/c of v3.3/v3.4 differences\n                        body as never, // TODO: need to fix client typing\n                        undefined,\n                        params\n                    )\n                }\n                // TODO: generalize LedgerClient to support any HTTP method\n                case 'delete':\n                case 'patch':\n                default: {\n                    throw new Error(\n                        `Unsupported request method: ${args.params.requestMethod}`\n                    )\n                }\n            }\n        } else {\n            throw new Error(`Unsupported method: ${args.method}`)\n        }\n    }\n\n    private getLedgerParams(params: object): {\n        path?: Record<string, string>\n        query?: Record<string, string>\n    } {\n        const extracted = {}\n\n        if ('path' in params) {\n            Object.assign(extracted, { path: params.path })\n        }\n\n        if ('query' in params) {\n            Object.assign(extracted, { query: params.query })\n        }\n\n        return extracted\n    }\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './LedgerProvider';
+import { Provider as Ops } from '@canton-network/core-ledger-client-types';
+export { Ops };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,kBAAkB,CAAA;AAChC,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,MAAM,0CAA0C,CAAA;AAE1E,OAAO,EAAE,GAAG,EAAE,CAAA"}

package/dist/index.js

@@ -0,0 +1,95 @@
+import { AbstractProvider } from '@canton-network/core-splice-provider';
+import { LedgerClient } from '@canton-network/core-ledger-client';
+import pino from 'pino';
+export { Provider as Ops } from '@canton-network/core-ledger-client-types';
+
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, key + "" , value);
+var LedgerProvider = class extends AbstractProvider {
+  constructor({
+    baseUrl,
+    accessToken
+  }) {
+    super();
+    __publicField(this, "client");
+    this.client = new LedgerClient({
+      baseUrl: typeof baseUrl === "string" ? new URL(baseUrl) : baseUrl,
+      accessToken,
+      // TODO: use some generalized logger
+      logger: pino({ name: "LedgerProvider" })
+    });
+  }
+  /**
+   *
+   * Example usage:
+   *
+   * const provider = new LedgerProvider(...)
+   *
+   * // Caveat: TypeScript can infer the correct params body based on the method + API path, but the result will be typed as `unknown` without a type argument:
+   *
+   * const result1 = await provider.request({ method: 'ledgerApi', params: { ... } });
+   * //    ^ type = `unknown`
+   *
+   *
+   * // Specify an operation type to get a fully typed result:
+   *
+   * const result2 = await provider.request<Ops.PostV2Parties>({ method: 'ledgerApi', params: { ... } });
+   * //    ^ type = `PostV2Parties['ledgerApi']['result']`
+   *
+   * @param args
+   * @returns
+   */
+  async request(args) {
+    console.log("Received request:", args);
+    if (args.method === "ledgerApi" && "params" in args) {
+      switch (args.params.requestMethod) {
+        case "get": {
+          const params = this.getLedgerParams(args.params);
+          return await this.client.getWithRetry(
+            args.params.resource,
+            // TODO: casting is necessary b/c of v3.3/v3.4 differences
+            void 0,
+            params
+          );
+        }
+        case "post": {
+          const params = this.getLedgerParams(args.params);
+          const body = "body" in args.params ? args.params.body : {};
+          return await this.client.postWithRetry(
+            args.params.resource,
+            // TODO: casting is necessary b/c of v3.3/v3.4 differences
+            body,
+            // TODO: need to fix client typing
+            void 0,
+            params
+          );
+        }
+        // TODO: generalize LedgerClient to support any HTTP method
+        case "delete":
+        case "patch":
+        default: {
+          throw new Error(
+            `Unsupported request method: ${args.params.requestMethod}`
+          );
+        }
+      }
+    } else {
+      throw new Error(`Unsupported method: ${args.method}`);
+    }
+  }
+  getLedgerParams(params) {
+    const extracted = {};
+    if ("path" in params) {
+      Object.assign(extracted, { path: params.path });
+    }
+    if ("query" in params) {
+      Object.assign(extracted, { query: params.query });
+    }
+    return extracted;
+  }
+};
+
+export { LedgerProvider };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/LedgerProvider.ts"],"names":[],"mappings":";;;;;;;;AAaO,IAAM,cAAA,GAAN,cAA6B,gBAAA,CAA8B;AAAA,EAG9D,WAAA,CAAY;AAAA,IACR,OAAA;AAAA,IACA;AAAA,GACJ,EAGG;AACC,IAAA,KAAA,EAAM;AATV,IAAA,aAAA,CAAA,IAAA,EAAQ,QAAA,CAAA;AAUJ,IAAA,IAAA,CAAK,MAAA,GAAS,IAAI,YAAA,CAAa;AAAA,MAC3B,SAAS,OAAO,OAAA,KAAY,WAAW,IAAI,GAAA,CAAI,OAAO,CAAA,GAAI,OAAA;AAAA,MAC1D,WAAA;AAAA;AAAA,MAEA,MAAA,EAAQ,IAAA,CAAK,EAAE,IAAA,EAAM,kBAAkB;AAAA,KAC1C,CAAA;AAAA,EACL;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAsBA,MAAa,QACT,IAAA,EACiC;AACjC,IAAA,OAAA,CAAQ,GAAA,CAAI,qBAAqB,IAAI,CAAA;AAErC,IAAA,IAAI,IAAA,CAAK,MAAA,KAAW,WAAA,IAAe,QAAA,IAAY,IAAA,EAAM;AACjD,MAAA,QAAQ,IAAA,CAAK,OAAO,aAAA;AAAe,QAC/B,KAAK,KAAA,EAAO;AACR,UAAA,MAAM,MAAA,GAAS,IAAA,CAAK,eAAA,CAAgB,IAAA,CAAK,MAAM,CAAA;AAE/C,UAAA,OAAO,MAAM,KAAK,MAAA,CAAO,YAAA;AAAA,YACrB,KAAK,MAAA,CAAO,QAAA;AAAA;AAAA,YACZ,MAAA;AAAA,YACA;AAAA,WACJ;AAAA,QACJ;AAAA,QACA,KAAK,MAAA,EAAQ;AACT,UAAA,MAAM,MAAA,GAAS,IAAA,CAAK,eAAA,CAAgB,IAAA,CAAK,MAAM,CAAA;AAC/C,UAAA,MAAM,OAAO,MAAA,IAAU,IAAA,CAAK,SAAS,IAAA,CAAK,MAAA,CAAO,OAAO,EAAC;AAEzD,UAAA,OAAO,MAAM,KAAK,MAAA,CAAO,aAAA;AAAA,YACrB,KAAK,MAAA,CAAO,QAAA;AAAA;AAAA,YACZ,IAAA;AAAA;AAAA,YACA,MAAA;AAAA,YACA;AAAA,WACJ;AAAA,QACJ;AAAA;AAAA,QAEA,KAAK,QAAA;AAAA,QACL,KAAK,OAAA;AAAA,QACL,SAAS;AACL,UAAA,MAAM,IAAI,KAAA;AAAA,YACN,CAAA,4BAAA,EAA+B,IAAA,CAAK,MAAA,CAAO,aAAa,CAAA;AAAA,WAC5D;AAAA,QACJ;AAAA;AACJ,IACJ,CAAA,MAAO;AACH,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,oBAAA,EAAuB,IAAA,CAAK,MAAM,CAAA,CAAE,CAAA;AAAA,IACxD;AAAA,EACJ;AAAA,EAEQ,gBAAgB,MAAA,EAGtB;AACE,IAAA,MAAM,YAAY,EAAC;AAEnB,IAAA,IAAI,UAAU,MAAA,EAAQ;AAClB,MAAA,MAAA,CAAO,OAAO,SAAA,EAAW,EAAE,IAAA,EAAM,MAAA,CAAO,MAAM,CAAA;AAAA,IAClD;AAEA,IAAA,IAAI,WAAW,MAAA,EAAQ;AACnB,MAAA,MAAA,CAAO,OAAO,SAAA,EAAW,EAAE,KAAA,EAAO,MAAA,CAAO,OAAO,CAAA;AAAA,IACpD;AAEA,IAAA,OAAO,SAAA;AAAA,EACX;AACJ","file":"index.js","sourcesContent":["// Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { AbstractProvider } from '@canton-network/core-splice-provider'\nimport { RequestArgs } from '@canton-network/core-types'\nimport { LedgerTypes } from '@canton-network/core-ledger-client-types'\nimport {\n    GetEndpoint,\n    LedgerClient,\n    PostEndpoint,\n} from '@canton-network/core-ledger-client'\nimport pino from 'pino'\n\nexport class LedgerProvider extends AbstractProvider<LedgerTypes> {\n    private client: LedgerClient\n\n    constructor({\n        baseUrl,\n        accessToken,\n    }: {\n        baseUrl: string | URL\n        accessToken: string\n    }) {\n        super()\n        this.client = new LedgerClient({\n            baseUrl: typeof baseUrl === 'string' ? new URL(baseUrl) : baseUrl,\n            accessToken,\n            // TODO: use some generalized logger\n            logger: pino({ name: 'LedgerProvider' }),\n        })\n    }\n\n    /**\n     *\n     * Example usage:\n     *\n     * const provider = new LedgerProvider(...)\n     *\n     * // Caveat: TypeScript can infer the correct params body based on the method + API path, but the result will be typed as `unknown` without a type argument:\n     *\n     * const result1 = await provider.request({ method: 'ledgerApi', params: { ... } });\n     * //    ^ type = `unknown`\n     *\n     *\n     * // Specify an operation type to get a fully typed result:\n     *\n     * const result2 = await provider.request<Ops.PostV2Parties>({ method: 'ledgerApi', params: { ... } });\n     * //    ^ type = `PostV2Parties['ledgerApi']['result']`\n     *\n     * @param args\n     * @returns\n     */\n    public async request<L extends LedgerTypes>(\n        args: RequestArgs<L, 'ledgerApi'>\n    ): Promise<L['ledgerApi']['result']> {\n        console.log('Received request:', args)\n\n        if (args.method === 'ledgerApi' && 'params' in args) {\n            switch (args.params.requestMethod) {\n                case 'get': {\n                    const params = this.getLedgerParams(args.params)\n\n                    return await this.client.getWithRetry(\n                        args.params.resource as GetEndpoint, // TODO: casting is necessary b/c of v3.3/v3.4 differences\n                        undefined,\n                        params\n                    )\n                }\n                case 'post': {\n                    const params = this.getLedgerParams(args.params)\n                    const body = 'body' in args.params ? args.params.body : {}\n\n                    return await this.client.postWithRetry(\n                        args.params.resource as PostEndpoint, // TODO: casting is necessary b/c of v3.3/v3.4 differences\n                        body as never, // TODO: need to fix client typing\n                        undefined,\n                        params\n                    )\n                }\n                // TODO: generalize LedgerClient to support any HTTP method\n                case 'delete':\n                case 'patch':\n                default: {\n                    throw new Error(\n                        `Unsupported request method: ${args.params.requestMethod}`\n                    )\n                }\n            }\n        } else {\n            throw new Error(`Unsupported method: ${args.method}`)\n        }\n    }\n\n    private getLedgerParams(params: object): {\n        path?: Record<string, string>\n        query?: Record<string, string>\n    } {\n        const extracted = {}\n\n        if ('path' in params) {\n            Object.assign(extracted, { path: params.path })\n        }\n\n        if ('query' in params) {\n            Object.assign(extracted, { query: params.query })\n        }\n\n        return extracted\n    }\n}\n"]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@canton-network/core-provider-ledger",
+  "version": "0.2.0",
+  "type": "module",
+  "description": "A Splice Provider implementation for direct ledger access.",
+  "license": "Apache-2.0",
+  "author": "Alex Matson <alex.matson@digitalasset.com>",
+  "packageManager": "yarn@4.9.4",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup && tsc -p tsconfig.types.json",
+    "dev": "tsup --watch --onSuccess \"tsc -p tsconfig.types.json\"",
+    "test": "jest",
+    "flatpack": "yarn pack --out \"$FLATPACK_OUTDIR\"",
+    "clean": "tsc -b --clean; rm -rf dist"
+  },
+  "devDependencies": {
+    "@jest/globals": "^30.2.0",
+    "@swc/core": "^1.15.11",
+    "@swc/jest": "^0.2.39",
+    "@types/jest": "^30.0.0",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6",
+    "ts-jest-resolver": "^2.0.1",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@canton-network/core-ledger-client": "^0.28.1",
+    "@canton-network/core-ledger-client-types": "^0.21.0",
+    "@canton-network/core-splice-provider": "^0.25.0",
+    "@canton-network/core-types": "^0.19.0",
+    "pino": "^10.3.1"
+  },
+  "files": [
+    "dist/**"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hyperledger-labs/splice-wallet-kernel.git",
+    "directory": "core/provider-ledger"
+  }
+}