cantonjs 0.0.1

package/dist/esm/clients/createAdminClient.js

@@ -0,0 +1,202 @@
+/**
+ * Factory for creating an Admin API client.
+ *
+ * The AdminClient provides party/user/package management operations.
+ * Requires a privileged JWT token with admin rights.
+ *
+ * Request/response shapes match the Canton JSON Ledger API V2 OpenAPI spec (3.4+).
+ */
+export function createAdminClient(config) {
+    const { transport } = config;
+    return {
+        async allocateParty(request) {
+            const response = await transport.request({
+                method: 'POST',
+                path: '/v2/parties',
+                body: {
+                    partyIdHint: request?.partyIdHint,
+                    localMetadata: request?.localMetadata,
+                    identityProviderId: request?.identityProviderId,
+                    synchronizerId: request?.synchronizerId,
+                    userId: request?.userId,
+                },
+            });
+            return response.partyDetails;
+        },
+        async listParties(filter, pagination) {
+            const params = new URLSearchParams();
+            if (filter !== undefined)
+                params.set('filter-party', filter);
+            if (pagination?.pageSize !== undefined)
+                params.set('page_size', String(pagination.pageSize));
+            if (pagination?.pageToken !== undefined)
+                params.set('page_token', pagination.pageToken);
+            const qs = params.toString();
+            const response = await transport.request({
+                method: 'GET',
+                path: `/v2/parties${qs ? `?${qs}` : ''}`,
+            });
+            return {
+                items: response.partyDetails ?? [],
+                nextPageToken: response.nextPageToken,
+            };
+        },
+        async getParty(party) {
+            const response = await transport.request({
+                method: 'GET',
+                path: `/v2/parties/${encodeURIComponent(party)}`,
+            });
+            return response.partyDetails;
+        },
+        async getParticipantId() {
+            const response = await transport.request({
+                method: 'GET',
+                path: '/v2/parties/participant-id',
+            });
+            return response.participantId;
+        },
+        async createUser(request) {
+            const response = await transport.request({
+                method: 'POST',
+                path: '/v2/users',
+                body: {
+                    user: request.user,
+                    rights: request.rights,
+                },
+            });
+            return response.user;
+        },
+        async getUser(userId) {
+            const response = await transport.request({
+                method: 'GET',
+                path: `/v2/users/${encodeURIComponent(userId)}`,
+            });
+            return response.user;
+        },
+        async listUsers(pagination) {
+            const params = new URLSearchParams();
+            if (pagination?.pageSize !== undefined)
+                params.set('page_size', String(pagination.pageSize));
+            if (pagination?.pageToken !== undefined)
+                params.set('page_token', pagination.pageToken);
+            const qs = params.toString();
+            const response = await transport.request({
+                method: 'GET',
+                path: `/v2/users${qs ? `?${qs}` : ''}`,
+            });
+            return {
+                items: response.users ?? [],
+                nextPageToken: response.nextPageToken,
+            };
+        },
+        async deleteUser(userId) {
+            await transport.request({
+                method: 'DELETE',
+                path: `/v2/users/${encodeURIComponent(userId)}`,
+            });
+        },
+        async grantRights(userId, rights) {
+            const response = await transport.request({
+                method: 'POST',
+                path: `/v2/users/${encodeURIComponent(userId)}/rights`,
+                body: { rights },
+            });
+            return response.newlyGrantedRights ?? [];
+        },
+        async revokeRights(userId, rights) {
+            const response = await transport.request({
+                method: 'POST',
+                path: `/v2/users/${encodeURIComponent(userId)}/rights`,
+                body: { rights, revoke: true },
+            });
+            return response.newlyRevokedRights ?? [];
+        },
+        async uploadDar(darBytes, options) {
+            const params = new URLSearchParams();
+            if (options?.vetAllPackages !== undefined) {
+                params.set('vetAllPackages', String(options.vetAllPackages));
+            }
+            const qs = params.toString();
+            await transport.request({
+                method: 'POST',
+                path: `/v2/dars${qs ? `?${qs}` : ''}`,
+                body: darBytes,
+                headers: { 'Content-Type': 'application/octet-stream' },
+            });
+        },
+        async listPackages() {
+            const response = await transport.request({
+                method: 'GET',
+                path: '/v2/packages',
+            });
+            return response.packageIds ?? [];
+        },
+        async validateDar(darBytes) {
+            await transport.request({
+                method: 'POST',
+                path: '/v2/dars/validate',
+                body: darBytes,
+                headers: { 'Content-Type': 'application/octet-stream' },
+            });
+        },
+        async getLedgerApiVersion() {
+            const response = await transport.request({
+                method: 'GET',
+                path: '/v2/version',
+            });
+            return response.version;
+        },
+        async createIdentityProvider(request) {
+            const response = await transport.request({
+                method: 'POST',
+                path: '/v2/identity-provider-configs',
+                body: request,
+            });
+            return response.identityProviderConfig;
+        },
+        async getIdentityProvider(id) {
+            const response = await transport.request({
+                method: 'GET',
+                path: `/v2/identity-provider-configs/${encodeURIComponent(id)}`,
+            });
+            return response.identityProviderConfig;
+        },
+        async updateIdentityProvider(request) {
+            const id = request.identityProviderConfig.identityProviderId;
+            const response = await transport.request({
+                method: 'PATCH',
+                path: `/v2/identity-provider-configs/${encodeURIComponent(id)}`,
+                body: request,
+            });
+            return response.identityProviderConfig;
+        },
+        async deleteIdentityProvider(id) {
+            await transport.request({
+                method: 'DELETE',
+                path: `/v2/identity-provider-configs/${encodeURIComponent(id)}`,
+            });
+        },
+        async listIdentityProviders() {
+            const response = await transport.request({
+                method: 'GET',
+                path: '/v2/identity-provider-configs',
+            });
+            return response.identityProviderConfigs ?? [];
+        },
+        async getVettedPackages() {
+            const response = await transport.request({
+                method: 'GET',
+                path: '/v2/package-vetting',
+            });
+            return response.packageIds ?? [];
+        },
+        async updateVettedPackages(packageIds) {
+            await transport.request({
+                method: 'POST',
+                path: '/v2/package-vetting',
+                body: { packageIds },
+            });
+        },
+    };
+}
+//# sourceMappingURL=createAdminClient.js.map

package/dist/esm/clients/createAdminClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAdminClient.js","sourceRoot":"","sources":["../../../src/clients/createAdminClient.ts"],"names":[],"mappings":"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"}

package/dist/esm/clients/createLedgerClient.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Factory for creating a party-scoped Ledger API client.
+ *
+ * The LedgerClient provides contract operations: create, exercise, query.
+ * Each client is scoped to a party via its JWT token.
+ *
+ * Request/response shapes match the Canton JSON Ledger API V2 OpenAPI spec (3.4+).
+ */
+import type { Transport } from '../transport/types.js';
+import type { Party } from '../types/party.js';
+import type { CreatedEvent, ActiveContract } from '../types/contract.js';
+import type { JsTransaction } from '../types/transaction.js';
+import type { Reassignment, ReassignmentCommand } from '../types/reassignment.js';
+import type { PrepareSubmissionResponse, PartySignatures } from '../types/interactive.js';
+import type { LedgerOffset, EventFormat } from '../types/command.js';
+export type LedgerClientConfig = {
+    /** Transport to communicate with the Canton node. */
+    readonly transport: Transport;
+    /** The party this client acts as. */
+    readonly actAs: Party;
+    /** Additional parties this client can read as. */
+    readonly readAs?: readonly Party[];
+};
+export type LedgerClient = {
+    /** The party this client acts as. */
+    readonly actAs: Party;
+    /** Additional parties this client can read as. */
+    readonly readAs: readonly Party[];
+    /** Create a new contract on the ledger. */
+    createContract: (templateId: string, createArguments: Record<string, unknown>, options?: CommandOptions) => Promise<CreatedEvent>;
+    /** Exercise a choice on an existing contract. */
+    exerciseChoice: (templateId: string, contractId: string, choice: string, choiceArgument: Record<string, unknown>, options?: CommandOptions) => Promise<JsTransaction>;
+    /** Query active contracts matching a template. */
+    queryContracts: (templateId: string, options?: QueryOptions) => Promise<readonly ActiveContract[]>;
+    /** Get a transaction by its update ID. */
+    getTransactionById: (updateId: string) => Promise<JsTransaction>;
+    /** Get the current ledger end offset. */
+    getLedgerEnd: () => Promise<LedgerOffset>;
+    /** Get events for a specific contract. */
+    getEventsByContractId: (contractId: string) => Promise<unknown>;
+    /** Get connected synchronizer IDs. */
+    getConnectedSynchronizers: () => Promise<readonly ConnectedSynchronizer[]>;
+    /** Get the latest pruned offsets. */
+    getLatestPrunedOffsets: () => Promise<PrunedOffsets>;
+    /** Submit a reassignment command and wait for completion. */
+    submitReassignment: (command: ReassignmentCommand, options?: CommandOptions) => Promise<Reassignment>;
+    /**
+     * Prepare a transaction for external signing.
+     * Returns the prepared transaction and hash to sign.
+     */
+    prepareSubmission: (templateId: string, createArguments: Record<string, unknown>, options?: CommandOptions) => Promise<PrepareSubmissionResponse>;
+    /**
+     * Execute a previously prepared and externally signed transaction.
+     */
+    executeSubmission: (preparedTransaction: string, partySignatures: readonly PartySignatures[], options?: {
+        readonly submissionId?: string;
+        readonly signal?: AbortSignal;
+    }) => Promise<JsTransaction>;
+};
+/** A connected synchronizer (domain). */
+export type ConnectedSynchronizer = {
+    readonly synchronizerId: string;
+    readonly permission: 'SUBMISSION' | 'OBSERVATION' | 'UNSPECIFIED';
+};
+/** Pruned offset information. */
+export type PrunedOffsets = {
+    readonly participantPrunedUpToInclusive?: number;
+    readonly allDivulgedContractsPrunedUpToInclusive?: number;
+};
+export type CommandOptions = {
+    readonly commandId?: string;
+    readonly workflowId?: string;
+    readonly signal?: AbortSignal;
+};
+export type QueryOptions = {
+    readonly signal?: AbortSignal;
+    /** Event format for filtering. Defaults to verbose wildcard filter for actAs party. */
+    readonly eventFormat?: EventFormat;
+    /** Offset to snapshot at. 0 = empty ledger. Defaults to 0. */
+    readonly activeAtOffset?: LedgerOffset;
+};
+export declare function createLedgerClient(config: LedgerClientConfig): LedgerClient;
+//# sourceMappingURL=createLedgerClient.d.ts.map

package/dist/esm/clients/createLedgerClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createLedgerClient.d.ts","sourceRoot":"","sources":["../../../src/clients/createLedgerClient.ts"],"names":[],"mappings":"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"}

package/dist/esm/clients/createLedgerClient.js

@@ -0,0 +1,237 @@
+/**
+ * Factory for creating a party-scoped Ledger API client.
+ *
+ * The LedgerClient provides contract operations: create, exercise, query.
+ * Each client is scoped to a party via its JWT token.
+ *
+ * Request/response shapes match the Canton JSON Ledger API V2 OpenAPI spec (3.4+).
+ */
+/** Generate a random UUID, compatible with Node.js 18+ and browsers. */
+function generateUUID() {
+    if (typeof globalThis.crypto?.randomUUID === 'function') {
+        return globalThis.crypto.randomUUID();
+    }
+    // Fallback for Node.js 18 where globalThis.crypto.randomUUID may not exist
+    const bytes = new Uint8Array(16);
+    if (typeof globalThis.crypto?.getRandomValues === 'function') {
+        globalThis.crypto.getRandomValues(bytes);
+    }
+    else {
+        for (let i = 0; i < 16; i++)
+            bytes[i] = Math.floor(Math.random() * 256);
+    }
+    bytes[6] = (bytes[6] & 0x0f) | 0x40;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('');
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+export function createLedgerClient(config) {
+    const { transport, actAs, readAs = [] } = config;
+    function defaultEventFormat() {
+        return {
+            filtersByParty: {
+                [actAs]: {
+                    cumulative: [
+                        {
+                            identifierFilter: {
+                                WildcardFilter: { value: { includeCreatedEventBlob: false } },
+                            },
+                        },
+                    ],
+                },
+            },
+            verbose: true,
+        };
+    }
+    function templateEventFormat(templateId) {
+        return {
+            filtersByParty: {
+                [actAs]: {
+                    cumulative: [
+                        {
+                            identifierFilter: {
+                                TemplateFilter: {
+                                    value: { templateId, includeCreatedEventBlob: false },
+                                },
+                            },
+                        },
+                    ],
+                },
+            },
+            verbose: true,
+        };
+    }
+    function defaultTransactionFormat() {
+        return {
+            transactionShape: 'TRANSACTION_SHAPE_ACS_DELTA',
+            eventFormat: defaultEventFormat(),
+        };
+    }
+    return {
+        actAs,
+        readAs,
+        async createContract(templateId, createArguments, options) {
+            const request = {
+                method: 'POST',
+                path: '/v2/commands/submit-and-wait-for-transaction',
+                body: {
+                    commands: {
+                        commands: [{ CreateCommand: { templateId, createArguments } }],
+                        commandId: options?.commandId ?? generateUUID(),
+                        actAs: [actAs],
+                        readAs: readAs.length > 0 ? readAs : undefined,
+                        workflowId: options?.workflowId,
+                    },
+                    transactionFormat: defaultTransactionFormat(),
+                },
+            };
+            if (options?.signal)
+                request.signal = options.signal;
+            const response = await transport.request(request);
+            const created = extractCreatedEvent(response.transaction.events);
+            if (created === undefined) {
+                throw new Error('No created event in transaction response');
+            }
+            return created;
+        },
+        async exerciseChoice(templateId, contractId, choice, choiceArgument, options) {
+            const request = {
+                method: 'POST',
+                path: '/v2/commands/submit-and-wait-for-transaction',
+                body: {
+                    commands: {
+                        commands: [
+                            { ExerciseCommand: { templateId, contractId, choice, choiceArgument } },
+                        ],
+                        commandId: options?.commandId ?? generateUUID(),
+                        actAs: [actAs],
+                        readAs: readAs.length > 0 ? readAs : undefined,
+                        workflowId: options?.workflowId,
+                    },
+                    transactionFormat: defaultTransactionFormat(),
+                },
+            };
+            if (options?.signal)
+                request.signal = options.signal;
+            const response = await transport.request(request);
+            return response.transaction;
+        },
+        async queryContracts(templateId, options) {
+            const request = {
+                method: 'POST',
+                path: '/v2/state/active-contracts',
+                body: {
+                    activeAtOffset: options?.activeAtOffset ?? 0,
+                    eventFormat: options?.eventFormat ?? templateEventFormat(templateId),
+                },
+            };
+            if (options?.signal)
+                request.signal = options.signal;
+            const response = await transport.request(request);
+            return response
+                .map((entry) => {
+                if ('JsActiveContract' in entry.contractEntry) {
+                    return entry.contractEntry.JsActiveContract;
+                }
+                return undefined;
+            })
+                .filter((c) => c !== undefined);
+        },
+        async getTransactionById(updateId) {
+            const response = await transport.request({
+                method: 'POST',
+                path: '/v2/updates/transaction-by-id',
+                body: {
+                    updateId,
+                    requestingParties: [actAs, ...readAs],
+                },
+            });
+            return response.transaction;
+        },
+        async getLedgerEnd() {
+            const response = await transport.request({
+                method: 'GET',
+                path: '/v2/state/ledger-end',
+            });
+            return response.offset;
+        },
+        async getEventsByContractId(contractId) {
+            return transport.request({
+                method: 'POST',
+                path: '/v2/events/events-by-contract-id',
+                body: { contractId, requestingParties: [actAs, ...readAs] },
+            });
+        },
+        async getConnectedSynchronizers() {
+            const response = await transport.request({
+                method: 'GET',
+                path: '/v2/state/connected-synchronizers',
+            });
+            return response.connectedSynchronizers ?? [];
+        },
+        async getLatestPrunedOffsets() {
+            const response = await transport.request({
+                method: 'GET',
+                path: '/v2/state/latest-pruned-offsets',
+            });
+            return response;
+        },
+        async submitReassignment(command, options) {
+            const request = {
+                method: 'POST',
+                path: '/v2/commands/submit-and-wait-for-reassignment',
+                body: {
+                    reassignmentCommand: command,
+                    commandId: options?.commandId ?? generateUUID(),
+                    submitter: actAs,
+                    workflowId: options?.workflowId,
+                },
+            };
+            if (options?.signal)
+                request.signal = options.signal;
+            const response = await transport.request(request);
+            return response.reassignment;
+        },
+        async prepareSubmission(templateId, createArguments, options) {
+            const request = {
+                method: 'POST',
+                path: '/v2/interactive-submission/prepare',
+                body: {
+                    commands: [{ CreateCommand: { templateId, createArguments } }],
+                    commandId: options?.commandId ?? generateUUID(),
+                    actAs: [actAs],
+                    readAs: readAs.length > 0 ? readAs : undefined,
+                    workflowId: options?.workflowId,
+                },
+            };
+            if (options?.signal)
+                request.signal = options.signal;
+            return transport.request(request);
+        },
+        async executeSubmission(preparedTransaction, partySignatures, options) {
+            const request = {
+                method: 'POST',
+                path: '/v2/interactive-submission/execute',
+                body: {
+                    preparedTransaction,
+                    partySignatures,
+                    submissionId: options?.submissionId,
+                },
+            };
+            if (options?.signal)
+                request.signal = options.signal;
+            const response = await transport.request(request);
+            return response.transaction;
+        },
+    };
+}
+/** Extract the first CreatedEvent from a list of tagged events. */
+function extractCreatedEvent(events) {
+    for (const event of events) {
+        if ('CreatedEvent' in event) {
+            return event.CreatedEvent;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=createLedgerClient.js.map

package/dist/esm/clients/createLedgerClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createLedgerClient.js","sourceRoot":"","sources":["../../../src/clients/createLedgerClient.ts"],"names":[],"mappings":"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"}

package/dist/esm/clients/createTestClient.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Factory for creating a test client for Canton sandbox.
+ *
+ * The TestClient provides sandbox lifecycle management, party allocation,
+ * and time manipulation for testing. Extends LedgerClient + AdminClient.
+ */
+import type { Transport } from '../transport/types.js';
+import type { Party, PartyDetails } from '../types/party.js';
+import { type LedgerClient } from './createLedgerClient.js';
+import { type AdminClient } from './createAdminClient.js';
+export type TestClientConfig = {
+    readonly transport: Transport;
+    /** Default party for ledger operations. If not provided, one will be allocated. */
+    readonly party?: Party;
+};
+export type TestClient = LedgerClient & AdminClient & {
+    /** Get the current ledger time (static-time sandbox only). */
+    getTime: () => Promise<Date>;
+    /** Set the ledger time (static-time sandbox only). */
+    setTime: (currentTime: Date, newTime: Date) => Promise<void>;
+    /** Advance ledger time by a duration in seconds (static-time sandbox only). */
+    advanceTime: (seconds: number) => Promise<void>;
+    /** Allocate multiple parties at once. */
+    allocateParties: (hints: readonly string[]) => Promise<readonly PartyDetails[]>;
+};
+export declare function createTestClient(config: TestClientConfig): TestClient;
+//# sourceMappingURL=createTestClient.d.ts.map

package/dist/esm/clients/createTestClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTestClient.d.ts","sourceRoot":"","sources":["../../../src/clients/createTestClient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC5D,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC/E,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAE5E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,mFAAmF;IACnF,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,YAAY,GACnC,WAAW,GAAG;IACZ,8DAA8D;IAC9D,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAE5B,sDAAsD;IACtD,OAAO,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAE5D,+EAA+E;IAC/E,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAE/C,yCAAyC;IACzC,eAAe,EAAE,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAAA;CAChF,CAAA;AAEH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CA2CrE"}

package/dist/esm/clients/createTestClient.js

@@ -0,0 +1,43 @@
+/**
+ * Factory for creating a test client for Canton sandbox.
+ *
+ * The TestClient provides sandbox lifecycle management, party allocation,
+ * and time manipulation for testing. Extends LedgerClient + AdminClient.
+ */
+import { createLedgerClient } from './createLedgerClient.js';
+import { createAdminClient } from './createAdminClient.js';
+export function createTestClient(config) {
+    const { transport, party = 'test-party' } = config;
+    const ledger = createLedgerClient({ transport, actAs: party });
+    const admin = createAdminClient({ transport });
+    return {
+        ...ledger,
+        ...admin,
+        async getTime() {
+            const response = await transport.request({
+                method: 'GET',
+                path: '/v2/time',
+            });
+            return new Date(response.currentTime);
+        },
+        async setTime(currentTime, newTime) {
+            await transport.request({
+                method: 'POST',
+                path: '/v2/time',
+                body: {
+                    currentTime: currentTime.toISOString(),
+                    newTime: newTime.toISOString(),
+                },
+            });
+        },
+        async advanceTime(seconds) {
+            const current = await this.getTime();
+            const newTime = new Date(current.getTime() + seconds * 1000);
+            await this.setTime(current, newTime);
+        },
+        async allocateParties(hints) {
+            return Promise.all(hints.map((hint) => admin.allocateParty({ partyIdHint: hint })));
+        },
+    };
+}
+//# sourceMappingURL=createTestClient.js.map

package/dist/esm/clients/createTestClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTestClient.js","sourceRoot":"","sources":["../../../src/clients/createTestClient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,kBAAkB,EAAqB,MAAM,yBAAyB,CAAA;AAC/E,OAAO,EAAE,iBAAiB,EAAoB,MAAM,wBAAwB,CAAA;AAuB5E,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,MAAM,EAAE,SAAS,EAAE,KAAK,GAAG,YAAqB,EAAE,GAAG,MAAM,CAAA;IAE3D,MAAM,MAAM,GAAG,kBAAkB,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;IAC9D,MAAM,KAAK,GAAG,iBAAiB,CAAC,EAAE,SAAS,EAAE,CAAC,CAAA;IAE9C,OAAO;QACL,GAAG,MAAM;QACT,GAAG,KAAK;QAER,KAAK,CAAC,OAAO;YACX,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,OAAO,CAA0B;gBAChE,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE,UAAU;aACjB,CAAC,CAAA;YACF,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;QACvC,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO;YAChC,MAAM,SAAS,CAAC,OAAO,CAAC;gBACtB,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE;oBACJ,WAAW,EAAE,WAAW,CAAC,WAAW,EAAE;oBACtC,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE;iBAC/B;aACF,CAAC,CAAA;QACJ,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,OAAO;YACvB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;YACpC,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,OAAO,GAAG,IAAI,CAAC,CAAA;YAC5D,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACtC,CAAC;QAED,KAAK,CAAC,eAAe,CAAC,KAAK;YACzB,OAAO,OAAO,CAAC,GAAG,CAChB,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACjB,KAAK,CAAC,aAAa,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAC3C,CACF,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/esm/clients/index.d.ts

@@ -0,0 +1,4 @@
+export { createLedgerClient, type LedgerClient, type LedgerClientConfig, type CommandOptions, type QueryOptions, } from './createLedgerClient.js';
+export { createAdminClient, type AdminClient, type AdminClientConfig, } from './createAdminClient.js';
+export { createTestClient, type TestClient, type TestClientConfig, } from './createTestClient.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/clients/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/clients/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACL,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAA"}

package/dist/esm/clients/index.js

@@ -0,0 +1,4 @@
+export { createLedgerClient, } from './createLedgerClient.js';
+export { createAdminClient, } from './createAdminClient.js';
+export { createTestClient, } from './createTestClient.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/clients/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/clients/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GAKnB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EACL,iBAAiB,GAGlB,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACL,gBAAgB,GAGjB,MAAM,uBAAuB,CAAA"}