testutil

func BuildDecodableConwayBlockBytes ¶ added in v0.70.0

func BuildDecodableConwayBlockBytes(
	t *testing.T,
	slot, blockNumber uint64,
) []byte

BuildDecodableConwayBlockBytes constructs a minimal, valid (10-field header), individually decodable Conway block with a correct block body hash and empty transaction components, for the given slot and block number. It is shared by tests across packages (database/models, ledger) that need a cheap, uniquely-identifiable, real Conway block rather than a hand-rolled mock.

func FreePort ¶ added in v0.70.0

func FreePort(t *testing.T) string

FreePort reserves a loopback port and releases it, returning the bound address ("host:port"). The port is not guaranteed to still be free when the caller binds it -- retry up to BindAttempts times instead of treating one bind failure as a test failure.

func GenerateTestTLSCertKey ¶ added in v0.70.0

func GenerateTestTLSCertKey(t *testing.T) (certPath, keyPath string)

GenerateTestTLSCertKey generates a throwaway self-signed certificate/key pair valid for 127.0.0.1 and writes them as PEM files under a fresh t.TempDir(), returning their paths. Used to exercise a listener's TLS startup path (Blockfrost, Mesh, UTxORPC, Bark) without depending on any fixed certificate checked into the repo.

func InsecureHTTPClient ¶ added in v0.70.0

func InsecureHTTPClient() *http.Client

InsecureHTTPClient returns an *http.Client that skips TLS certificate verification, for exercising a listener's throwaway self-signed test certificate (see GenerateTestTLSCertKey).

func MakeDirectoryUnwritable ¶ added in v0.70.1

func MakeDirectoryUnwritable(t testing.TB, path string)

MakeDirectoryUnwritable removes write permission from a test directory and restores it before the test's temporary-directory cleanup runs.

Both modes are derived from what the directory already has rather than written literally: t.TempDir() creates 0o700, so restoring a fixed 0o755 would hand the caller a more permissive directory than it passed in, and clearing to a fixed 0o555 would do the same for anything created stricter.

func RequireNoReceive ¶

func RequireNoReceive[T any](
	t *testing.T,
	ch <-chan T,
	duration time.Duration,
	msg string,
)

RequireNoReceive verifies that no value is received on the given channel within the specified duration. This replaces the pattern of time.Sleep followed by a non-blocking channel read to confirm that nothing was sent.

func RequireReceive ¶

func RequireReceive[T any](
	t *testing.T,
	ch <-chan T,
	timeout time.Duration,
	msg string,
) T

RequireReceive waits for a value on the given channel or fails the test if the timeout expires. This replaces the common pattern of time.Sleep followed by reading a channel.

func RestrictFileToCurrentUser ¶ added in v0.70.0

func RestrictFileToCurrentUser(t testing.TB, path string)

RestrictFileToCurrentUser makes a test fixture acceptable to secret-key permission checks on Unix.

func WaitForCondition ¶

func WaitForCondition(
	t *testing.T,
	condition func() bool,
	timeout time.Duration,
	msg string,
)

WaitForCondition polls the given condition function until it returns true or the timeout expires. This replaces the common pattern of time.Sleep followed by an assertion check.

func WaitForConditionWithInterval ¶

func WaitForConditionWithInterval(
	t *testing.T,
	condition func() bool,
	timeout time.Duration,
	interval time.Duration,
	msg string,
)

WaitForConditionWithInterval is like WaitForCondition but allows specifying a custom polling interval.