Struct BuilderAttribution 

pub struct BuilderAttribution { /* private fields */ }

Builder attribution of a single order: which builder submitted it and the additive fee rate that builder charges on it.

The rate is what the order requests; what a builder actually earns is reported per fill by the builder_fee of crate::state::OrderEventType::Filled.

A non-zero Self::builder_id does not imply a fee: attribution with a zero fee is valid and expected on close/decrease orders.

Implementations

impl BuilderAttribution

pub fn new(builder_id: BuilderId, fee: UD64) -> Self

Attribution of an order to builder_id, charging an additive fee fraction of the traded amount on the size the order adds.

The fee is bounded by MAX_BUILDER_FEE_PER_100K and quantized to num::FEE_SCALE decimal places on encoding; use Self::encode to detect an out-of-range rate before submitting.

pub fn builder_id(&self) -> BuilderId

Builder code the order is attributed to. Zero means no builder, in which case no envelope is submitted at all.

pub fn fee(&self) -> UD64

Additive builder fee rate requested by the order, as a fraction of the traded amount.

pub fn fee_per_100k(&self) -> U256

Raw Per100K fee rate as submitted on-chain.

pub fn encode(&self) -> Result<Bytes, OrderExtensionError>

Encodes the envelope to submit with a V2 order entrypoint, rejecting a fee rate the contract’s decoder would reject.

Mirrors OrderExtensionLib.decodeOrderExtension: abi.encode(uint16 version, bytes payload) where the version-1 payload is abi.encode(uint256 builderId, uint256 builderFeePer100K).

The contract reverts on an out-of-range fee on the single-order path and skips the order (emitting OrderExtensionRejected) on the batched and forwarded paths, so an envelope is never worth building without the range check.

pub fn decode(extension: &[u8]) -> Result<Option<Self>, OrderExtensionError>

Decodes the envelope emitted with OrderRequestV2.

An empty envelope is the no-builder fast path and yields None. Rejections mirror the contract’s decoder, so an envelope this returns an error for is one the contract itself rejected (see OrderExtensionError for which failures revert and which skip a single order).

Trait Implementations

impl Clone for BuilderAttribution

fn clone(&self) -> BuilderAttribution

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for BuilderAttribution

impl Debug for BuilderAttribution

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

Formats the value using the given formatter.

impl Display for BuilderAttribution

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

Formats the value using the given formatter.

impl Eq for BuilderAttribution

impl PartialEq for BuilderAttribution

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for BuilderAttribution