@distrohelena/canton-typescript-sdk 0.1.11 → 0.1.12

package/dist/core/transports/transport.interface.d.ts

@@ -188,6 +188,7 @@ import { TransactionObserver } from "../../services/events/transaction-observer.
 import { CommandSigners, ICommandSigner } from "../signing/command-signer.interface.js";
 import { SignCommandResult } from "../signing/sign-command-result.js";
 import { PreparedCommandSubmission } from "../types/prepared-command-submission.js";
+import { SubmitCommandTransactionResponse } from "../types/responses/submit-command-transaction-response.js";
 import { RequestOptions } from "../types/request-options.js";
 import { SubmitCommandRequest } from "../types/requests/submit-command-request.js";
 export interface ITransport {
@@ -383,6 +384,7 @@ export interface ITransport {
      * Supported on JSON and gRPC. External signing is gRPC-only.
      */
     submitCommandAsync(request: SubmitCommandRequest, signer?: ICommandSigner | CommandSigners, options?: RequestOptions): Promise<SubmitCommandResponse>;
+    submitCommandForTransactionAsync?(request: SubmitCommandRequest, options?: RequestOptions): Promise<SubmitCommandTransactionResponse>;
     prepareCommandAsync?(request: SubmitCommandRequest, options?: RequestOptions): Promise<PreparedCommandSubmission>;
     executePreparedCommandAndWaitAsync?(prepared: PreparedCommandSubmission, signatures: Readonly<Record<string, SignCommandResult>>, options?: RequestOptions): Promise<SubmitCommandResponse>;
 }

package/dist/core/types/responses/submit-command-transaction-response.d.ts

@@ -0,0 +1,7 @@
+/** Result of a gRPC command submission that waited for its transaction. */
+export declare class SubmitCommandTransactionResponse {
+    readonly transactionId: string;
+    readonly events: readonly unknown[];
+    readonly transaction: unknown;
+    constructor(transactionId: string, events: readonly unknown[], transaction: unknown);
+}

package/dist/core/types/responses/submit-command-transaction-response.js

@@ -0,0 +1,11 @@
+/** Result of a gRPC command submission that waited for its transaction. */
+export class SubmitCommandTransactionResponse {
+    transactionId;
+    events;
+    transaction;
+    constructor(transactionId, events, transaction) {
+        this.transactionId = transactionId;
+        this.events = events;
+        this.transaction = transaction;
+    }
+}

package/dist/index.d.ts

@@ -210,6 +210,7 @@ export { DisclosedContract } from "./core/types/disclosed-contract.js";
 export { PreparedCommandSubmission } from "./core/types/prepared-command-submission.js";
 export { DamlContractId } from "./core/types/daml-contract-id.js";
 export { DamlUnit, DamlDate, DamlTimestamp, DamlTextMap, DamlGenMap, DamlVariant, DamlEnum, DamlRecord } from "./core/types/daml-values.js";
+export { SubmitCommandTransactionResponse } from "./core/types/responses/submit-command-transaction-response.js";
 export { AddPartyAsyncArguments } from "./core/types/requests/add-party-async-request.js";
 export { AddPartyAsyncRequest } from "./core/types/requests/add-party-async-request.js";
 export { AssembleSignedTopologyTransactionsRequest } from "./core/types/requests/assemble-signed-topology-transactions-request.js";

package/dist/index.js

@@ -197,6 +197,7 @@ export { DisclosedContract } from "./core/types/disclosed-contract.js";
 export { PreparedCommandSubmission } from "./core/types/prepared-command-submission.js";
 export { DamlContractId } from "./core/types/daml-contract-id.js";
 export { DamlUnit, DamlDate, DamlTimestamp, DamlTextMap, DamlGenMap, DamlVariant, DamlEnum, DamlRecord } from "./core/types/daml-values.js";
+export { SubmitCommandTransactionResponse } from "./core/types/responses/submit-command-transaction-response.js";
 export { AddPartyAsyncArguments } from "./core/types/requests/add-party-async-request.js";
 export { AddPartyAsyncRequest } from "./core/types/requests/add-party-async-request.js";
 export { AssembleSignedTopologyTransactionsRequest } from "./core/types/requests/assemble-signed-topology-transactions-request.js";

package/dist/services/command/command-service-client.d.ts

@@ -3,11 +3,13 @@ import { RequestOptions } from "../../core/types/request-options.js";
 import { ITransport } from "../../core/transports/transport.interface.js";
 import { SubmitCommandRequest } from "../../core/types/requests/submit-command-request.js";
 import { SubmitCommandResponse } from "../../core/types/responses/submit-command-response.js";
+import { SubmitCommandTransactionResponse } from "../../core/types/responses/submit-command-transaction-response.js";
 import { PreparedCommandSubmission } from "../../core/types/prepared-command-submission.js";
 import { SignCommandResult } from "../../core/signing/sign-command-result.js";
 export declare class CommandServiceClient {
     private readonly pipeline;
     constructor(transport: ITransport, signer?: ICommandSigner | CommandSigners);
+    submitAndWaitForTransactionAsync(request: SubmitCommandRequest, options?: RequestOptions): Promise<SubmitCommandTransactionResponse>;
     /** Submits a command and waits for the result. Supported on JSON and gRPC. */
     submitAndWaitAsync(request: SubmitCommandRequest, options?: RequestOptions): Promise<SubmitCommandResponse>;
     prepareAsync(request: SubmitCommandRequest, options?: RequestOptions): Promise<PreparedCommandSubmission>;

package/dist/services/command/command-service-client.js

@@ -7,6 +7,7 @@ export class CommandServiceClient {
             signer,
         });
     }
+    submitAndWaitForTransactionAsync(request, options) { return this.pipeline.submitForTransactionAsync(request, options); }
     /** Submits a command and waits for the result. Supported on JSON and gRPC. */
     submitAndWaitAsync(request, options) {
         return this.pipeline.submitAsync(request, options);

package/dist/services/commands/command-submission-pipeline.d.ts

@@ -3,6 +3,7 @@ import { ITransport } from "../../core/transports/transport.interface.js";
 import { RequestOptions } from "../../core/types/request-options.js";
 import { SubmitCommandRequest } from "../../core/types/requests/submit-command-request.js";
 import { SubmitCommandResponse } from "../../core/types/responses/submit-command-response.js";
+import { SubmitCommandTransactionResponse } from "../../core/types/responses/submit-command-transaction-response.js";
 import { PreparedCommandSubmission } from "../../core/types/prepared-command-submission.js";
 import { SignCommandResult } from "../../core/signing/sign-command-result.js";
 export declare class CommandSubmissionPipeline {
@@ -12,6 +13,7 @@ export declare class CommandSubmissionPipeline {
         signer?: ICommandSigner | CommandSigners;
     });
     submitAsync(request: SubmitCommandRequest, options?: RequestOptions): Promise<SubmitCommandResponse>;
+    submitForTransactionAsync(request: SubmitCommandRequest, options?: RequestOptions): Promise<SubmitCommandTransactionResponse>;
     prepareAsync(request: SubmitCommandRequest, options?: RequestOptions): Promise<PreparedCommandSubmission>;
     executeAsync(prepared: PreparedCommandSubmission, signatures: Readonly<Record<string, SignCommandResult>>, options?: RequestOptions): Promise<SubmitCommandResponse>;
 }

package/dist/services/commands/command-submission-pipeline.js

@@ -12,6 +12,8 @@ export class CommandSubmissionPipeline {
         }
         return this.dependencies.transport.submitCommandAsync(request, this.dependencies.signer, options);
     }
+    submitForTransactionAsync(request, options) { if (!this.dependencies.transport.submitCommandForTransactionAsync)
+        throw new NotSupportedError("transaction-returning command submission is not supported by the selected transport"); return this.dependencies.transport.submitCommandForTransactionAsync(request, options); }
     prepareAsync(request, options) { if (!this.dependencies.transport.prepareCommandAsync)
         throw new NotSupportedError("interactive command preparation is not supported by the selected transport"); return this.dependencies.transport.prepareCommandAsync(request, options); }
     executeAsync(prepared, signatures, options) { if (!this.dependencies.transport.executePreparedCommandAndWaitAsync)

package/dist/transports/grpc/grpc-channel-factory.d.ts

@@ -125,6 +125,7 @@ export interface GrpcOperations {
     prepareSubmissionAsync?(request: unknown, options?: RequestOptions): Promise<unknown>;
     executeSubmissionAndWaitAsync?(request: unknown, options?: RequestOptions): Promise<unknown>;
     submitCommandAsync(request: unknown, options?: RequestOptions): Promise<unknown>;
+    submitCommandForTransactionAsync?(request: unknown, options?: RequestOptions): Promise<unknown>;
 }
 export interface GrpcOperationDependencies {
     versionServiceClient?: Pick<IVersionServiceClient, "getLedgerApiVersion">;
@@ -154,6 +155,6 @@ export interface GrpcOperationDependencies {
     updateServiceClient?: Pick<IUpdateServiceClient, "getUpdates" | "getUpdateByOffset" | "getUpdateById" | "getUpdateByHash" | "getUpdatesPage">;
     commandCompletionServiceClient?: Pick<ICommandCompletionServiceClient, "getCompletions">;
     interactiveSubmissionServiceClient?: Pick<IInteractiveSubmissionServiceClient, "prepareSubmission" | "executeSubmissionAndWait">;
-    commandServiceClient?: Pick<ICommandServiceClient, "submitAndWait">;
+    commandServiceClient?: Pick<ICommandServiceClient, "submitAndWait" | "submitAndWaitForTransaction">;
 }
 export declare function createGrpcOperations(options: CantonClientOptions, endpoint: string, grpcChannelSecurity: GrpcChannelSecurity, dependencies?: GrpcOperationDependencies): GrpcOperations;

package/dist/transports/grpc/grpc-channel-factory.js

@@ -463,6 +463,10 @@ export function createGrpcOperations(options, endpoint, grpcChannelSecurity, dep
             const callOptions = await buildCallOptionsForLedgerSurfaceAsync(options, requestOptions);
             return await unwrapUnaryResponse(commandServiceClient.submitAndWait(request, callOptions));
         },
+        async submitCommandForTransactionAsync(request, requestOptions) {
+            const callOptions = await buildCallOptionsForLedgerSurfaceAsync(options, requestOptions);
+            return await unwrapUnaryResponse(commandServiceClient.submitAndWaitForTransaction(request, callOptions));
+        },
         async prepareSubmissionAsync(request, requestOptions) {
             const callOptions = await buildCallOptionsForLedgerSurfaceAsync(options, requestOptions);
             return await unwrapUnaryResponse(interactiveSubmissionServiceClient.prepareSubmission(request, callOptions));

package/dist/transports/grpc/grpc-transport.d.ts

@@ -278,6 +278,7 @@ export declare class GrpcTransport implements ITransport {
     getUpdatesPageAsync(request: GetUpdatesPageRequest, options?: RequestOptions): Promise<GetUpdatesPageResponse>;
     getCompletionsAsync(request: GetCompletionsRequest, observer: CompletionObserver, options?: RequestOptions): Promise<void>;
     submitCommandAsync(request: SubmitCommandRequest, signer?: ICommandSigner | CommandSigners, options?: RequestOptions): Promise<SubmitCommandResponse>;
+    submitCommandForTransactionAsync(request: SubmitCommandRequest, options?: RequestOptions): Promise<import("../../core/types/responses/submit-command-transaction-response.js").SubmitCommandTransactionResponse>;
     prepareCommandAsync(request: SubmitCommandRequest, options?: RequestOptions): Promise<PreparedCommandSubmission>;
     executePreparedCommandAndWaitAsync(prepared: PreparedCommandSubmission, signatures: Readonly<Record<string, SignCommandResult>>, options?: RequestOptions): Promise<SubmitCommandResponse>;
     private throwIfDisposed;

package/dist/transports/grpc/grpc-transport.js

@@ -11,7 +11,7 @@ import { NotSupportedError } from "../../core/errors/not-supported-error.js";
 import { TransportError } from "../../core/errors/transport-error.js";
 import { PackageFormat } from "../../core/types/package-format.js";
 import { createGrpcOperations, } from "./grpc-channel-factory.js";
-import { mapGrpcSubmitCommand, mapGrpcSubmitCommandRequest, } from "./mappers/commands-mapper.js";
+import { mapGrpcSubmitCommand, mapGrpcSubmitCommandForTransactionRequest, mapGrpcSubmitCommandTransaction, mapGrpcSubmitCommandRequest, } from "./mappers/commands-mapper.js";
 import { mapGrpcExecuteSubmissionAndWaitRequest, mapGrpcInteractiveSubmitCommand, mapGrpcPrepareSubmissionRequest, } from "./mappers/interactive-command-mapper.js";
 import { mapGrpcGetContract, mapGrpcGetContractRequest, mapGrpcQueryContracts, mapGrpcQueryContractsRequest, } from "./mappers/contracts-mapper.js";
 import { mapGrpcCompletionStreamResponse, mapGrpcGetCompletionsRequest, } from "./mappers/command-completion-mapper.js";
@@ -617,6 +617,12 @@ export class GrpcTransport {
         }), options);
         return mapGrpcInteractiveSubmitCommand(executed);
     }
+    async submitCommandForTransactionAsync(request, options) {
+        this.throwIfDisposed();
+        if (!this.operations.submitCommandForTransactionAsync)
+            throw new NotSupportedError("transaction-returning command submission is not available on this transport");
+        return mapGrpcSubmitCommandTransaction(await this.operations.submitCommandForTransactionAsync(mapGrpcSubmitCommandForTransactionRequest(request), options));
+    }
     async prepareCommandAsync(request, options) {
         if (!this.operations.prepareSubmissionAsync)
             throw new NotSupportedError("interactive gRPC command signing is not available on this transport");

package/dist/transports/grpc/mappers/commands-mapper.d.ts

@@ -2,10 +2,13 @@ import { CreateCommand } from "../../../core/types/commands/create-command.js";
 import { LedgerCommand } from "../../../core/types/commands/ledger-command.js";
 import { SubmitCommandRequest } from "../../../core/types/requests/submit-command-request.js";
 import { SubmitCommandResponse } from "../../../core/types/responses/submit-command-response.js";
+import { SubmitCommandTransactionResponse } from "../../../core/types/responses/submit-command-transaction-response.js";
 import { Command } from "../generated/canton/com/daml/ledger/api/v2/commands.js";
-import { SubmitAndWaitRequest, SubmitAndWaitResponse } from "../generated/canton/com/daml/ledger/api/v2/command_service.js";
+import { SubmitAndWaitRequest, SubmitAndWaitResponse, SubmitAndWaitForTransactionRequest, SubmitAndWaitForTransactionResponse } from "../generated/canton/com/daml/ledger/api/v2/command_service.js";
 import { Identifier, Record as GrpcRecord, Value } from "../generated/canton/com/daml/ledger/api/v2/value.js";
 export declare function mapGrpcSubmitCommandRequest(request: SubmitCommandRequest): SubmitAndWaitRequest;
+export declare function mapGrpcSubmitCommandForTransactionRequest(request: SubmitCommandRequest): SubmitAndWaitForTransactionRequest;
+export declare function mapGrpcSubmitCommandTransaction(payload: SubmitAndWaitForTransactionResponse): SubmitCommandTransactionResponse;
 export declare function mapGrpcSubmitCommand(payload: {
     commandId?: string;
     transactionId?: string;

package/dist/transports/grpc/mappers/commands-mapper.js

@@ -9,6 +9,7 @@ import { DamlDate, DamlEnum, DamlGenMap, DamlRecord, DamlTextMap, DamlTimestamp,
 import { ExerciseByKeyCommand } from "../../../core/types/commands/exercise-by-key-command.js";
 import { ExerciseCommand } from "../../../core/types/commands/exercise-command.js";
 import { SubmitCommandResponse } from "../../../core/types/responses/submit-command-response.js";
+import { SubmitCommandTransactionResponse } from "../../../core/types/responses/submit-command-transaction-response.js";
 export function mapGrpcSubmitCommandRequest(request) {
     return {
         commands: {
@@ -29,6 +30,8 @@ export function mapGrpcSubmitCommandRequest(request) {
         },
     };
 }
+export function mapGrpcSubmitCommandForTransactionRequest(request) { return { commands: mapGrpcSubmitCommandRequest(request).commands }; }
+export function mapGrpcSubmitCommandTransaction(payload) { const transaction = payload.transaction; return new SubmitCommandTransactionResponse(transaction?.updateId ?? "", transaction?.events ?? [], transaction); }
 function mapGrpcDisclosedContract(value) {
     return { createdEventBlob: value.createdEventBlob, contractId: value.contractId ?? "", synchronizerId: value.synchronizerId ?? "", templateId: value.templateId === undefined ? undefined : { packageId: value.templateId.packageId, moduleName: value.templateId.moduleName, entityName: value.templateId.entityName } };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@distrohelena/canton-typescript-sdk",
-    "version": "0.1.11",
+    "version": "0.1.12",
     "license": "Apache-2.0",
     "type": "module",
     "main": "./dist/index.js",