Struct Contract 

pub struct Contract<T> { /* private fields */ }

A contract as PQS holds it: the typed payload, plus the ledger facts about it.

Implementations

impl<T> Contract<T>

pub fn contract_id(&self) -> &ContractId<T>

The contract id, typed.

pub fn payload(&self) -> &T

The payload.

pub fn into_payload(self) -> T

Take the payload.

pub fn created_at_offset(&self) -> i64

The offset the contract was created at.

pub fn archived_at_offset(&self) -> Option<i64>

The offset it was archived at, if it has been archived at all.

Being set does not mean the contract was inactive for the read that returned it. active_at(o) selects contracts whose lifetime covers o, so a contract that was live then and archived afterwards comes back with this set — filtering those out would drop exactly the rows the query asked for. Compare it against the offset that was read at: was_active_at does that.

pub fn was_active_at(&self, offset: i64) -> bool

Whether the contract was active at offset.

There is no offset-free answer to “is this active”: it depends on when you are asking about. A contract read by active_at(o) was active at o whatever this says about later offsets.

pub fn created_effective_at(&self) -> Option<OffsetDateTime>

Ledger effective time of the creation.

pub fn archived_effective_at(&self) -> Option<OffsetDateTime>

Ledger effective time of the archival.

pub fn signatories(&self) -> &[String]

The parties that signed it.

pub fn observers(&self) -> &[String]

The parties that observe it.

pub fn witnesses(&self) -> &[String]

Every party that witnessed it — the column Predicate::witness filters on, so selecting by it and then not being able to see it made no sense.

pub fn package_name(&self) -> &str

The Daml package name — stable across an upgrade.

pub fn package_version(&self) -> &str

The package version.

pub fn package_id(&self) -> &str

The package id — the exact build, which a version does not pin.

impl<T: DeserializeOwned> Contract<T>

pub fn from_row(row: &Row) -> Result<Self>

Decode one row.

Errors

Error::UnexpectedResponse if a column is missing or of another type, Error::Payload if the payload does not match T.

Trait Implementations

impl<T: Clone> Clone for Contract<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Contract<T>

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

Formats the value using the given formatter.