estimatePowerFromModel maps a few well-known GPU model names to their typical board power so power-aware matching and billing degrade gracefully when

findProviderGPUType extracts the GPU model name from a provider

isCommandAvailable checks if a command exists in PATH

Utility functions

recordLoginAttempt records a login attempt

writeErrorResponse writes error response

CalculateCurrentCost calculates the current cost of the session

CanSpend checks if the wallet has sufficient available balance

ConfirmTransaction waits for transaction confirmation

Rental Session operations CreateRentalSession creates a new rental session

Usage Record operations CreateUsageRecord creates a new usage record

DeductFunds deducts the specified amount from the wallet

DetectGPUs detects all available GPUs on the system

DisputeSession opens a Covenant dispute on a session's escrow, posting the platform bond. The metering receipt already submitted is the evidence the b

Helper methods EndRentalSession ends a rental session and processes final billing

Exists checks if a session exists

GetBillingHistory retrieves billing history with pagination

GetCorrelationID retrieves the correlation ID from the context

GetCurrentUsage gets current usage and cost for an active session

GetPricingRates gets current pricing rates for all supported GPU models

GetTransactionHistory retrieves transaction history for a wallet

GetUserBalance resolves a user's primary wallet then returns its balance, reconciling against Solana the same way GetWalletBalance does.

HasRole checks if the token has a specific role

Initialize creates the necessary database tables

ListAvailableProviders retrieves available GPU providers

ListObjects lists objects in the specified bucket, optionally filtered by a prefix.

NewClient creates a Covenant HTTP client.

NewLoginHandler creates a new login handler

NewRegistrationHandler creates a new registration handler

PlatformWallet returns the platform public key (the custodial poster).

ProcessUsageUpdate processes real-time usage data from provider daemon

SetupLogger creates a structured logger with consistent configuration

SubmitWork records the provider's delivery (POST /api/jobs/{id}/submit) after the on-chain submit_work instruction is signed.

Validate validates the configuration

cacheSession caches session information in Redis

calculateNodePriority calculates priority score for a node

cleanup removes the socket file

----- PDA derivations -----

endBillingSession ends the billing session

extractEmail extracts email from user traits

extractIORegNumber reads the numeric value that follows a marker in ioreg output (for example `"Device Utilization %"=12`). Returns -1 if absent.

extractRole extracts role from user traits

generateMockProcesses creates mock GPU processes

getAvailableGPUCount returns the number of available GPUs on a node

initializeWorkerPool creates worker goroutines for task execution

invalidateCachedAddress clears the last known address, forcing a new Consul lookup on next call.

mapToCustomError maps database errors to our custom error types

printProviders displays provider information

runRocmSMI runs rocm-smi in JSON mode and returns the per-card field maps.

scanJobRows is a helper function to scan multiple rows into a slice of JobRecord.

supportsFractionalGPU checks if a node supports fractional GPU allocation

validateSession validates the session using Ory Kratos

validateToken validates a token with the given secret

AddFunds adds the specified amount to the wallet

BroadcastToAll sends message to all connected clients

BuildDatabaseURL constructs a database URL from individual components This allows us to store credentials separately from the connection string

BuildSpec assembles the canonical rental spec.