Class DropCopyOperation

Single-use handle for applied drop-copy bookkeeping.

lock(), accountAdjustments(), accountBlock(), and isAccountBlocked() may be read while the operation is live. commit() and rollback() each consume the handle; calling either a second time (or after the other) throws LifecycleError.

Account-control operations published by the drop-copy pipeline and consumed rate-limit attempts stay outside that finalization boundary.

Mutation finalizers carry the same contract as on Reservation: a callback that throws is re-surfaced here as PolicyCallbackError without stopping the batch, and independently arms the engine kill switch, which blocks every account for a Mutation registered from JavaScript. Later pre-trade calls are rejected with SystemUnavailable until an operator calls engine.accounts().unblockAll().

Methods

[dispose] accountAdjustments accountBlock commit free isAccountBlocked lock rollback

Methods

[dispose]

  • [dispose](): void

  • Returns void

accountAdjustments

  • accountAdjustments(): AccountAdjustmentOutcome[]

  • Returns the account adjustments produced by this operation.

    Errors

    Throws LifecycleError when the operation has been finalized.

    Returns AccountAdjustmentOutcome[]

accountBlock

  • accountBlock(): undefined | AccountBlock

  • Returns the first account block requested by this operation, or undefined.

    This request-local history may differ from the apply-time registry snapshot reported by isAccountBlocked().

    Errors

    Throws LifecycleError when the operation has been finalized.

    Returns undefined | AccountBlock

commit

  • commit(): void

  • Commits the applied bookkeeping.

    Errors

    Throws PolicyCallbackError when a mutation commit callback throws, or LifecycleError when the operation has already been finalized or its owning engine is re-entered from one of its callbacks.

    Returns void

free

  • free(): void

  • Returns void

isAccountBlocked

  • isAccountBlocked(): boolean

  • Returns the apply-time blocked-state snapshot for the order account.

    The snapshot was captured before applyDropCopy returned and does not track later registry changes.

    Errors

    Throws LifecycleError when the operation has been finalized.

    Returns boolean

lock

  • lock(): Lock

  • Returns the lock payload accumulated for this operation.

    Errors

    Throws LifecycleError when the operation has been finalized.

    Returns Lock

rollback

  • rollback(): void

  • Rolls the applied bookkeeping back.

    Errors

    Throws PolicyCallbackError when a mutation rollback callback throws, or LifecycleError when the operation has already been finalized or its owning engine is re-entered from one of its callbacks.

    Returns void

Settings

Member Visibility

On This Page

Methods