Struct Transaction 

pub struct Transaction { /* private fields */ }

Domain Entity: Transaction

Represents a payment transaction for article access in the paywall system. Transactions are immutable once confirmed - any changes create new events.

Domain Rules:

• Transaction must have a valid blockchain signature
• Amount must be positive and match article price
• Reader wallet must be valid
• Only pending transactions can be confirmed or failed
• Only confirmed transactions can be refunded or disputed

Implementations

impl Transaction

pub fn new( tenant_id: TenantId, article_id: ArticleId, creator_id: CreatorId, reader_wallet: WalletAddress, amount: Money, platform_fee_percentage: u64, blockchain: Blockchain, tx_signature: String, ) -> Result<Self>

Create a new pending transaction

pub fn reconstruct( id: TransactionId, tenant_id: TenantId, article_id: ArticleId, creator_id: CreatorId, reader_wallet: WalletAddress, amount: Money, platform_fee: Money, creator_amount: Money, blockchain: Blockchain, tx_signature: String, status: TransactionStatus, created_at: DateTime<Utc>, confirmed_at: Option<DateTime<Utc>>, refunded_at: Option<DateTime<Utc>>, metadata: Value, ) -> Self

Reconstruct transaction from storage (bypasses validation)

pub fn id(&self) -> &TransactionId

pub fn tenant_id(&self) -> &TenantId

pub fn article_id(&self) -> &ArticleId

pub fn creator_id(&self) -> &CreatorId

pub fn reader_wallet(&self) -> &WalletAddress

pub fn amount(&self) -> &Money

pub fn amount_cents(&self) -> u64

pub fn platform_fee(&self) -> &Money

pub fn platform_fee_cents(&self) -> u64

pub fn creator_amount(&self) -> &Money

pub fn creator_amount_cents(&self) -> u64

pub fn blockchain(&self) -> Blockchain

pub fn tx_signature(&self) -> &str

pub fn status(&self) -> TransactionStatus

pub fn created_at(&self) -> DateTime<Utc>

pub fn confirmed_at(&self) -> Option<DateTime<Utc>>

pub fn refunded_at(&self) -> Option<DateTime<Utc>>

pub fn metadata(&self) -> &Value

pub fn is_confirmed(&self) -> bool

Check if transaction is confirmed

pub fn is_pending(&self) -> bool

Check if transaction is pending

pub fn grants_access(&self) -> bool

Check if transaction can grant access (confirmed and not refunded)

pub fn confirm(&mut self) -> Result<()>

Confirm the transaction (payment verified on-chain)

pub fn fail(&mut self, reason: &str) -> Result<()>

Mark transaction as failed

pub fn refund(&mut self, refund_tx_signature: &str) -> Result<()>

Refund the transaction

pub fn dispute(&mut self, reason: &str) -> Result<()>

Mark transaction as disputed

pub fn resolve_dispute(&mut self, resolution: &str) -> Result<()>

Resolve a dispute (back to confirmed)

pub fn explorer_url(&self) -> String

Get explorer URL for the transaction

Trait Implementations

impl Clone for Transaction

fn clone(&self) -> Transaction

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Transaction

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Transaction

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&Transaction> for TransactionDto

fn from(tx: &Transaction) -> Self

Converts to this type from the input type.

impl From<Transaction> for TransactionDto

fn from(tx: Transaction) -> Self

Converts to this type from the input type.

impl Serialize for Transaction

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

where __S: Serializer,

Serialize this value into the given Serde serializer.