feat: TX collateral inputs support (#605)

This adds support for returning the collateral inputs (if any) from a
transaction body.

Fixes #338

Author: agaffney

ledger/allegra.go

@@ -158,6 +158,10 @@ func (t AllegraTransaction) ReferenceInputs() []TransactionInput {
 	return t.Body.ReferenceInputs()
 }
 
+func (t AllegraTransaction) Collateral() []TransactionInput {
+	return t.Body.Collateral()
+}
+
 func (t AllegraTransaction) CollateralReturn() TransactionOutput {
 	return t.Body.CollateralReturn()
 }

ledger/alonzo.go

@@ -129,7 +129,7 @@ type AlonzoTransactionBody struct {
 		Epoch                uint64
 	} `cbor:"6,keyasint,omitempty"`
 	ScriptDataHash  Blake2b256                `cbor:"11,keyasint,omitempty"`
-	Collateral      []ShelleyTransactionInput `cbor:"13,keyasint,omitempty"`
+	TxCollateral    []ShelleyTransactionInput `cbor:"13,keyasint,omitempty"`
 	RequiredSigners []Blake2b224              `cbor:"14,keyasint,omitempty"`
 	NetworkId       uint8                     `cbor:"15,keyasint,omitempty"`
 }
@@ -147,6 +147,14 @@ func (b *AlonzoTransactionBody) Outputs() []TransactionOutput {
 	return ret
 }
 
+func (b *AlonzoTransactionBody) Collateral() []TransactionInput {
+	ret := []TransactionInput{}
+	for _, collateral := range b.TxCollateral {
+		ret = append(ret, collateral)
+	}
+	return ret
+}
+
 type AlonzoTransactionOutput struct {
 	cbor.StructAsArray
 	cbor.DecodeStoreCbor
@@ -260,6 +268,10 @@ func (t AlonzoTransaction) ReferenceInputs() []TransactionInput {
 	return t.Body.ReferenceInputs()
 }
 
+func (t AlonzoTransaction) Collateral() []TransactionInput {
+	return t.Body.Collateral()
+}
+
 func (t AlonzoTransaction) CollateralReturn() TransactionOutput {
 	return t.Body.CollateralReturn()
 }

ledger/babbage.go

@@ -434,6 +434,10 @@ func (t BabbageTransaction) ReferenceInputs() []TransactionInput {
 	return t.Body.ReferenceInputs()
 }
 
+func (t BabbageTransaction) Collateral() []TransactionInput {
+	return t.Body.Collateral()
+}
+
 func (t BabbageTransaction) CollateralReturn() TransactionOutput {
 	return t.Body.CollateralReturn()
 }

ledger/byron.go

@@ -175,6 +175,11 @@ func (t *ByronTransaction) ReferenceInputs() []TransactionInput {
 	return nil
 }
 
+func (t *ByronTransaction) Collateral() []TransactionInput {
+	// No collateral in Byron
+	return nil
+}
+
 func (t *ByronTransaction) CollateralReturn() TransactionOutput {
 	// No collateral in Byron
 	return nil

ledger/conway.go

@@ -164,6 +164,10 @@ func (t ConwayTransaction) ReferenceInputs() []TransactionInput {
 	return t.Body.ReferenceInputs()
 }
 
+func (t ConwayTransaction) Collateral() []TransactionInput {
+	return t.Body.Collateral()
+}
+
 func (t ConwayTransaction) CollateralReturn() TransactionOutput {
 	return t.Body.CollateralReturn()
 }

ledger/mary.go

@@ -175,6 +175,10 @@ func (t MaryTransaction) ReferenceInputs() []TransactionInput {
 	return t.Body.ReferenceInputs()
 }
 
+func (t MaryTransaction) Collateral() []TransactionInput {
+	return t.Body.Collateral()
+}
+
 func (t MaryTransaction) CollateralReturn() TransactionOutput {
 	return t.Body.CollateralReturn()
 }

ledger/shelley.go

@@ -221,6 +221,11 @@ func (b *ShelleyTransactionBody) ReferenceInputs() []TransactionInput {
 	return []TransactionInput{}
 }
 
+func (b *ShelleyTransactionBody) Collateral() []TransactionInput {
+	// No collateral in Shelley
+	return nil
+}
+
 func (b *ShelleyTransactionBody) CollateralReturn() TransactionOutput {
 	// No collateral in Shelley
 	return nil
@@ -364,6 +369,10 @@ func (t ShelleyTransaction) ReferenceInputs() []TransactionInput {
 	return t.Body.ReferenceInputs()
 }
 
+func (t ShelleyTransaction) Collateral() []TransactionInput {
+	return t.Body.Collateral()
+}
+
 func (t ShelleyTransaction) CollateralReturn() TransactionOutput {
 	return t.Body.CollateralReturn()
 }

ledger/tx.go

@@ -39,8 +39,9 @@ type TransactionBody interface {
 	Outputs() []TransactionOutput
 	TTL() uint64
 	ReferenceInputs() []TransactionInput
-	Utxorpc() *utxorpc.Tx
+	Collateral() []TransactionInput
 	CollateralReturn() TransactionOutput
+	Utxorpc() *utxorpc.Tx
 }
 
 type TransactionInput interface {