feat: TX total collateral support (#622)

This provides a method for returning the total collateral of a
transaction

Fixes #341

ledger/allegra.go

@@ -166,6 +166,10 @@ func (t AllegraTransaction) CollateralReturn() TransactionOutput {
 	return t.Body.CollateralReturn()
 }
 
+func (t AllegraTransaction) TotalCollateral() uint64 {
+	return t.Body.TotalCollateral()
+}
+
 func (t AllegraTransaction) Certificates() []Certificate {
 	return t.Body.Certificates()
 }

ledger/alonzo.go

@@ -276,6 +276,10 @@ func (t AlonzoTransaction) CollateralReturn() TransactionOutput {
 	return t.Body.CollateralReturn()
 }
 
+func (t AlonzoTransaction) TotalCollateral() uint64 {
+	return t.Body.TotalCollateral()
+}
+
 func (t AlonzoTransaction) Certificates() []Certificate {
 	return t.Body.Certificates()
 }

ledger/babbage.go

@@ -182,7 +182,7 @@ type BabbageTransactionBody struct {
 		Epoch                uint64
 	} `cbor:"6,keyasint,omitempty"`
 	TxCollateralReturn *BabbageTransactionOutput `cbor:"16,keyasint,omitempty"`
-	TotalCollateral    uint64                    `cbor:"17,keyasint,omitempty"`
+	TxTotalCollateral  uint64                    `cbor:"17,keyasint,omitempty"`
 	TxReferenceInputs  []ShelleyTransactionInput `cbor:"18,keyasint,omitempty"`
 }
 
@@ -218,6 +218,10 @@ func (b *BabbageTransactionBody) CollateralReturn() TransactionOutput {
 	return b.TxCollateralReturn
 }
 
+func (b *BabbageTransactionBody) TotalCollateral() uint64 {
+	return b.TxTotalCollateral
+}
+
 func (b *BabbageTransactionBody) Utxorpc() *utxorpc.Tx {
 	var txi, txri []*utxorpc.TxInput
 	var txo []*utxorpc.TxOutput
@@ -448,6 +452,10 @@ func (t BabbageTransaction) CollateralReturn() TransactionOutput {
 	return t.Body.CollateralReturn()
 }
 
+func (t BabbageTransaction) TotalCollateral() uint64 {
+	return t.Body.TotalCollateral()
+}
+
 func (t BabbageTransaction) Certificates() []Certificate {
 	return t.Body.Certificates()
 }

ledger/babbage_test.go

@@ -19,7 +19,7 @@ func TestBabbageBlockTransactions(t *testing.T) {
 
 	for i := 0; i < txsCount; i++ {
 		b.TransactionBodies[i] = BabbageTransactionBody{
-			TotalCollateral: 1 << i,
+			TxTotalCollateral: 1 << i,
 		}
 		b.TransactionWitnessSets[i] = BabbageTransactionWitnessSet{
 			AlonzoTransactionWitnessSet: AlonzoTransactionWitnessSet{

ledger/byron.go

@@ -185,6 +185,11 @@ func (t *ByronTransaction) CollateralReturn() TransactionOutput {
 	return nil
 }
 
+func (t *ByronTransaction) TotalCollateral() uint64 {
+	// No collateral in Byron
+	return 0
+}
+
 func (t *ByronTransaction) Certificates() []Certificate {
 	// No certificates in Byron
 	return nil

ledger/conway.go

@@ -172,6 +172,10 @@ func (t ConwayTransaction) CollateralReturn() TransactionOutput {
 	return t.Body.CollateralReturn()
 }
 
+func (t ConwayTransaction) TotalCollateral() uint64 {
+	return t.Body.TotalCollateral()
+}
+
 func (t ConwayTransaction) Certificates() []Certificate {
 	return t.Body.Certificates()
 }

ledger/mary.go

@@ -183,6 +183,10 @@ func (t MaryTransaction) CollateralReturn() TransactionOutput {
 	return t.Body.CollateralReturn()
 }
 
+func (t MaryTransaction) TotalCollateral() uint64 {
+	return t.Body.TotalCollateral()
+}
+
 func (t MaryTransaction) Certificates() []Certificate {
 	return t.Body.Certificates()
 }

ledger/shelley.go

@@ -230,6 +230,11 @@ func (b *ShelleyTransactionBody) CollateralReturn() TransactionOutput {
 	return nil
 }
 
+func (b *ShelleyTransactionBody) TotalCollateral() uint64 {
+	// No collateral in Shelley
+	return 0
+}
+
 func (b *ShelleyTransactionBody) Certificates() []Certificate {
 	ret := make([]Certificate, len(b.TxCertificates))
 	for i, cert := range b.TxCertificates {
@@ -384,6 +389,10 @@ func (t ShelleyTransaction) CollateralReturn() TransactionOutput {
 	return t.Body.CollateralReturn()
 }
 
+func (t ShelleyTransaction) TotalCollateral() uint64 {
+	return t.Body.TotalCollateral()
+}
+
 func (t ShelleyTransaction) Certificates() []Certificate {
 	return t.Body.Certificates()
 }

ledger/tx.go

@@ -43,6 +43,7 @@ type TransactionBody interface {
 	ReferenceInputs() []TransactionInput
 	Collateral() []TransactionInput
 	CollateralReturn() TransactionOutput
+	TotalCollateral() uint64
 	Certificates() []Certificate
 	Utxorpc() *utxorpc.Tx
 }