Safe Haskell	Safe-Inferred
Language	GHC2021

Hydra.Cluster.Faucet

Synopsis

data FaucetException
- = FaucetHasNotEnoughFunds {
  - faucetUTxO :: UTxO
  }
- | FaucetFailedToBuildTx {
  - reason :: TxBodyErrorAutoBalance Era
  }
data FaucetLog
- = TraceResourceExhaustedHandled Text
- | ReturnedFunds {
  - returnAmount :: Coin
  }
seedFromFaucet :: RunningNode -> VerificationKey PaymentKey -> Coin -> Tracer IO FaucetLog -> IO UTxO
findFaucetUTxO :: RunningNode -> Coin -> IO UTxO
seedFromFaucet_ :: RunningNode -> VerificationKey PaymentKey -> Coin -> Tracer IO FaucetLog -> IO ()
returnFundsToFaucet :: Tracer IO FaucetLog -> RunningNode -> Actor -> IO ()
returnFundsToFaucet' :: Tracer IO FaucetLog -> RunningNode -> SigningKey PaymentKey -> IO Coin
createOutputAtAddress :: RunningNode -> AddressInEra -> TxOutDatum CtxTx -> Value -> IO (TxIn, TxOut CtxUTxO)
retryOnExceptions :: (MonadCatch m, MonadDelay m) => Tracer m FaucetLog -> m a -> m a
publishHydraScriptsAs :: RunningNode -> Actor -> IO [TxId]

Documentation

Constructors

FaucetHasNotEnoughFunds
Fields faucetUTxO :: UTxO
FaucetFailedToBuildTx
Fields reason :: TxBodyErrorAutoBalance Era

Instances details

Exception FaucetException Source #
Instance details Defined in Hydra.Cluster.Faucet Methods toException :: FaucetException -> SomeException Source # fromException :: SomeException -> Maybe FaucetException Source # displayException :: FaucetException -> String Source #
Show FaucetException Source #
Instance details Defined in Hydra.Cluster.Faucet Methods showsPrec :: Int -> FaucetException -> ShowS Source # show :: FaucetException -> String Source # showList :: [FaucetException] -> ShowS Source #

Constructors

TraceResourceExhaustedHandled Text
ReturnedFunds
Fields returnAmount :: Coin

Instances details

ToJSON FaucetLog Source #
Instance details Defined in Hydra.Cluster.Faucet Methods toJSON :: FaucetLog -> Value toEncoding :: FaucetLog -> Encoding toJSONList :: [FaucetLog] -> Value toEncodingList :: [FaucetLog] -> Encoding omitField :: FaucetLog -> Bool
Generic FaucetLog Source #
Instance details Defined in Hydra.Cluster.Faucet Associated Types type Rep FaucetLog :: Type -> Type Source # Methods from :: FaucetLog -> Rep FaucetLog x Source # to :: Rep FaucetLog x -> FaucetLog Source #
Show FaucetLog Source #
Instance details Defined in Hydra.Cluster.Faucet Methods showsPrec :: Int -> FaucetLog -> ShowS Source # show :: FaucetLog -> String Source # showList :: [FaucetLog] -> ShowS Source #
Eq FaucetLog Source #
Instance details Defined in Hydra.Cluster.Faucet Methods (==) :: FaucetLog -> FaucetLog -> Bool Source # (/=) :: FaucetLog -> FaucetLog -> Bool Source #
type Rep FaucetLog Source #
Instance details Defined in Hydra.Cluster.Faucet type Rep FaucetLog = D1 ('MetaData "FaucetLog" "Hydra.Cluster.Faucet" "hydra-cluster-0.20.0-D6K2oRkKjHgLx9iLRVHXN7" 'False) (C1 ('MetaCons "TraceResourceExhaustedHandled" 'PrefixI 'False) (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Text)) :+: C1 ('MetaCons "ReturnedFunds" 'PrefixI 'True) (S1 ('MetaSel ('Just "returnAmount") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Coin)))

Arguments

:: RunningNode
-> VerificationKey PaymentKey	Recipient of the funds
-> Coin	Amount to get from faucet
-> Tracer IO FaucetLog
-> IO UTxO

Create a specially marked "seed" UTXO containing requested Lovelace by redeeming funds available to the well-known faucet.

findFaucetUTxO :: RunningNode -> Coin -> IO UTxO Source #

Arguments

:: RunningNode
-> VerificationKey PaymentKey	Recipient of the funds
-> Coin	Amount to get from faucet
-> Tracer IO FaucetLog
-> IO ()

Like seedFromFaucet, but without returning the seeded UTxO'.

Return the remaining funds to the faucet

returnFundsToFaucet' :: Tracer IO FaucetLog -> RunningNode -> SigningKey PaymentKey -> IO Coin Source #

createOutputAtAddress :: RunningNode -> AddressInEra -> TxOutDatum CtxTx -> Value -> IO (TxIn, TxOut CtxUTxO) Source #

retryOnExceptions :: (MonadCatch m, MonadDelay m) => Tracer m FaucetLog -> m a -> m a Source #

Try to submit tx and retry when some caught exception/s take place.

Publish current Hydra scripts as scripts outputs for later referencing them.

The key of the given Actor is used to pay for fees in required transactions, it is expected to have sufficient funds.