Struct JsonCommands 

pub struct JsonCommands { /* private fields */ }

A set of commands to submit over the JSON transport (dynamic path).

Build with JsonCommands::new then add commands (JsonCommands::add_create or JsonCommands::add_command) and optional metadata. command_id defaults to a fresh UUID so ledger-side de-duplication behaves correctly.

Implementations

impl JsonCommands

pub fn new(act_as: Vec<String>) -> Self

Start a command set acting as act_as, with a generated command_id and no commands yet.

pub fn with_command_id(self, command_id: impl Into<String>) -> Self

Set an explicit change-ID command_id (for exactly-once / de-duplication).

pub fn change_id(&self) -> ChangeId

This command set’s complete identity — available before it is sent, and the only way back to the outcome of a submission whose result was lost.

pub fn with_user_id(self, user_id: impl Into<String>) -> Self

Set the acting user id (defaults to the one derived from the token).

pub fn with_read_as(self, read_as: Vec<String>) -> Self

Add read-as parties.

pub fn with_workflow_id(self, workflow_id: impl Into<String>) -> Self

Set the workflow id.

pub fn with_synchronizer_id(self, synchronizer_id: impl Into<String>) -> Self

Pin the submission to a specific synchronizer.

pub fn add_create( self, template_id: impl Into<String>, create_arguments: Value, ) -> Self

Add a CreateCommand for template_id ("<pkg>:<Module>:<Entity>") with create_arguments in Daml-LF JSON (a record is an object keyed by field).

pub fn add_command(self, command: Value) -> Self

Add a raw command value (e.g. an ExerciseCommand), for shapes the convenience builders don’t cover.

pub fn with_submission_id(self, submission_id: impl Into<String>) -> Self

Set an explicit submission id, to correlate this particular submission attempt in completions. Defaults to participant-generated.

pub fn add_disclosed_contract(self, contract: Value) -> Self

Attach a disclosed contract (raw JSON: {"templateId": …, "contractId": …, "createdEventBlob": …, "synchronizerId": …}, with the blob obtained from a read with created-event blobs enabled). May be called repeatedly.

pub fn with_package_id_selection_preference( self, package_ids: Vec<String>, ) -> Self

Restrict package selection for interpretation to these package ids (at most one preference per package name) — the SCU upgrade pin.

pub fn with_deduplication_period(self, period: Value) -> Self

Set the de-duplication period (raw JSON, e.g. {"DeduplicationDuration": {"value": {"duration": "5s"}}}), matching the JSON API’s deduplicationPeriod encoding.

pub fn with_min_ledger_time_abs(self, time: Value) -> Self

Set the absolute lower bound for the ledger-effective time (raw JSON, an ISO-8601 timestamp string). Mutually exclusive with Self::with_min_ledger_time_rel.

pub fn with_min_ledger_time_rel(self, duration: Value) -> Self

Set the relative lower bound for the ledger-effective time (raw JSON, a proto duration like "5s"). Mutually exclusive with Self::with_min_ledger_time_abs.

Trait Implementations

impl Clone for JsonCommands

fn clone(&self) -> JsonCommands

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for JsonCommands

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Serialize for JsonCommands

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.