Struct ContractDeploymentHashPreimage 

#[repr(C)]
pub struct ContractDeploymentHashPreimage {
    pub deployer_address: ContractAddress,
    pub nonce: SHA256Hash,
    pub contract_hash: SHA256Hash,
}

Hash preimage for deriving deployed contract addresses.

When a contract deploys another contract, the new contract’s address is deterministically computed as:

ContractAddress = SHA256(ContractDeploymentHashPreimage)

Under XDR encoding, this struct serializes as the concatenation of its fields: deployer_address || nonce || contract_hash.

This is Thruput’s analogue of Ethereum’s CREATE2 opcode, allowing deterministic address derivation. The deployer controls the nonce to create addresses at will.

Example

Contract A address:  0x1234...
Contract B hash:     0xabcd...   (= SHA256(XDR(Contract B)))
Deployment nonce:    0x5678...
Result: SHA256(0x1234... || 0x5678... || 0xabcd...) = Contract B address

Fields

deployer_address: ContractAddress

The address of the contract performing the deployment.

nonce: SHA256Hash

Arbitrary 32-byte value chosen by the deployer.

Allows creating multiple instances of the same contract code at different addresses.

contract_hash: SHA256Hash

SHA-256 hash of the XDR-encoded Contract being deployed.

This hashes the entire union, not the bare code blob:

contract_hash = SHA256(XDR(Contract))

The encoding covers the 4-byte ContractType discriminant followed by the selected arm, so identical code deployed under a different contract type yields a different hash. For kRv32 the arm is a ContractBlob, which is itself a 4-byte length prefix followed by the code padded to a 4-byte boundary – hashing the raw code alone does not reproduce this value.

Native and mock contracts are hashed the same way, over a union whose arm holds a contract identifier instead of a blob. They do not use separately predefined hash constants.

Trait Implementations

impl Clone for ContractDeploymentHashPreimage

fn clone(&self) -> ContractDeploymentHashPreimage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ConstMaxSize for ContractDeploymentHashPreimage

const MAX_SIZE: Option<usize>

Worst-case CXS encoded size in bytes, or None if unbounded.

impl ConstMaxSize for ContractDeploymentHashPreimage

const MAX_SIZE: Option<usize>

Worst-case TXS encoded size in bytes, or None if unbounded.

impl Debug for ContractDeploymentHashPreimage

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

Formats the value using the given formatter.

impl EncodesAs<ContractDeploymentHashPreimage> for ContractDeploymentHashPreimage

impl Eq for ContractDeploymentHashPreimage

impl Hash for ContractDeploymentHashPreimage

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl JsonSchema for ContractDeploymentHashPreimage

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Ord for ContractDeploymentHashPreimage

fn cmp(&self, other: &ContractDeploymentHashPreimage) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for ContractDeploymentHashPreimage

fn eq(&self, other: &ContractDeploymentHashPreimage) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for ContractDeploymentHashPreimage

fn partial_cmp( &self, other: &ContractDeploymentHashPreimage, ) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'_r> ReadXDR<'_r> for ContractDeploymentHashPreimage

fn read_xdr<R>(r: &mut R) -> Result<ContractDeploymentHashPreimage, ReadError>

where R: Reader<'_r>,

Reads an XDR value from the reader.

fn read_xdr_in_place<R, '__xdrs_s>( r: &mut R, __xdrs_slot: Slot<'__xdrs_s, ContractDeploymentHashPreimage>, ) -> Result<Init<'__xdrs_s, ContractDeploymentHashPreimage>, ReadError>

where R: Reader<'_r>,

Reads an XDR value directly into slot, without first building it on the stack.

impl StructuralPartialEq for ContractDeploymentHashPreimage

impl WriteXDR for ContractDeploymentHashPreimage

fn write_xdr<F, W>(&self, w: &mut W) -> Result<(), WriteError>

where W: Writer<F>,

Writes this value as XDR data to the writer.

unsafe fn write_xdr_unchecked<F, W>(&self, w: &mut W)

where W: WriterUnchecked<F>,

Writes this value as XDR data to the writer, without runtime checks.