package legacytx import ( errorsmod "cosmossdk.io/errors" "cosmossdk.io/math" "github.com/cosmos/cosmos-sdk/codec/legacy" codectypes "github.com/cosmos/cosmos-sdk/codec/types" cryptotypes "github.com/cosmos/cosmos-sdk/crypto/types" sdk "github.com/cosmos/cosmos-sdk/types" "github.com/cosmos/cosmos-sdk/types/tx/signing" ) // Interface implementation checks var ( _ codectypes.UnpackInterfacesMessage = (*StdTx)(nil) _ codectypes.UnpackInterfacesMessage = (*StdSignature)(nil) ) // StdFee includes the amount of coins paid in fees and the maximum // gas to be used by the transaction. The ratio yields an effective "gasprice", // which must be above some miminum to be accepted into the mempool. // [Deprecated] type StdFee struct { Amount sdk.Coins `json:"amount" yaml:"amount"` Gas uint64 `json:"gas" yaml:"gas"` Payer string `json:"payer,omitempty" yaml:"payer"` Granter string `json:"granter,omitempty" yaml:"granter"` } // Deprecated: NewStdFee returns a new instance of StdFee func NewStdFee(gas uint64, amount sdk.Coins) StdFee { return StdFee{ Amount: amount, Gas: gas, } } // GetGas returns the fee's (wanted) gas. func (fee StdFee) GetGas() uint64 { return fee.Gas } // GetAmount returns the fee's amount. func (fee StdFee) GetAmount() sdk.Coins { return fee.Amount } // Bytes returns the encoded bytes of a StdFee. func (fee StdFee) Bytes() []byte { if len(fee.Amount) == 0 { fee.Amount = sdk.NewCoins() } bz, err := legacy.Cdc.MarshalJSON(fee) if err != nil { panic(err) } return bz } // GasPrices returns the gas prices for a StdFee. // // NOTE: The gas prices returned are not the true gas prices that were // originally part of the submitted transaction because the fee is computed // as fee = ceil(gasWanted * gasPrices). func (fee StdFee) GasPrices() sdk.DecCoins { return sdk.NewDecCoinsFromCoins(fee.Amount...).QuoDec(math.LegacyNewDec(int64(fee.Gas))) } // StdTip is the tips used in a tipped transaction. type StdTip struct { Amount sdk.Coins `json:"amount" yaml:"amount"` Tipper string `json:"tipper" yaml:"tipper"` } // StdTx is the legacy transaction format for wrapping a Msg with Fee and Signatures. // It only works with Amino, please prefer the new protobuf Tx in types/tx. // NOTE: the first signature is the fee payer (Signatures must not be nil). // Deprecated type StdTx struct { Msgs []sdk.Msg `json:"msg" yaml:"msg"` Fee StdFee `json:"fee" yaml:"fee"` Signatures []StdSignature `json:"signatures" yaml:"signatures"` Memo string `json:"memo" yaml:"memo"` TimeoutHeight uint64 `json:"timeout_height" yaml:"timeout_height"` } // Deprecated func NewStdTx(msgs []sdk.Msg, fee StdFee, sigs []StdSignature, memo string) StdTx { return StdTx{ Msgs: msgs, Fee: fee, Signatures: sigs, Memo: memo, } } // GetMsgs returns the all the transaction's messages. func (tx StdTx) GetMsgs() []sdk.Msg { return tx.Msgs } // Deprecated: AsAny implements intoAny. It doesn't work for protobuf serialization, // so it can't be saved into protobuf configured storage. We are using it only for API // compatibility. func (tx *StdTx) AsAny() *codectypes.Any { return codectypes.UnsafePackAny(tx) } // GetMemo returns the memo func (tx StdTx) GetMemo() string { return tx.Memo } // GetTimeoutHeight returns the transaction's timeout height (if set). func (tx StdTx) GetTimeoutHeight() uint64 { return tx.TimeoutHeight } // GetSignatures returns the signature of signers who signed the Msg. // CONTRACT: Length returned is same as length of // pubkeys returned from MsgKeySigners, and the order // matches. // CONTRACT: If the signature is missing (ie the Msg is // invalid), then the corresponding signature is // .Empty(). func (tx StdTx) GetSignatures() [][]byte { sigs := make([][]byte, len(tx.Signatures)) for i, stdSig := range tx.Signatures { sigs[i] = stdSig.Signature } return sigs } // GetSignaturesV2 implements SigVerifiableTx.GetSignaturesV2 func (tx StdTx) GetSignaturesV2() ([]signing.SignatureV2, error) { res := make([]signing.SignatureV2, len(tx.Signatures)) for i, sig := range tx.Signatures { var err error res[i], err = StdSignatureToSignatureV2(legacy.Cdc, sig) if err != nil { return nil, errorsmod.Wrapf(err, "Unable to convert signature %v to V2", sig) } } return res, nil } // GetPubkeys returns the pubkeys of signers if the pubkey is included in the signature // If pubkey is not included in the signature, then nil is in the slice instead func (tx StdTx) GetPubKeys() ([]cryptotypes.PubKey, error) { pks := make([]cryptotypes.PubKey, len(tx.Signatures)) for i, stdSig := range tx.Signatures { pks[i] = stdSig.GetPubKey() } return pks, nil } // GetGas returns the Gas in StdFee func (tx StdTx) GetGas() uint64 { return tx.Fee.Gas } // GetFee returns the FeeAmount in StdFee func (tx StdTx) GetFee() sdk.Coins { return tx.Fee.Amount } // FeeGranter always returns nil for StdTx func (tx StdTx) FeeGranter() sdk.AccAddress { return nil } func (tx StdTx) UnpackInterfaces(unpacker codectypes.AnyUnpacker) error { for _, m := range tx.Msgs { err := codectypes.UnpackInterfaces(m, unpacker) if err != nil { return err } } // Signatures contain PubKeys, which need to be unpacked. for _, s := range tx.Signatures { err := s.UnpackInterfaces(unpacker) if err != nil { return err } } return nil }