common

Nov 22, 2025

Changes in this version

+ var ResourceUsageFlag = &cli.StringFlag

Nov 21, 2025

Changes in this version

+ func GetAppNameFromLocalRegistry(context, appID string) string

+ func InvalidateProfileCache() error

+ func LoadProfileCache(environment string) (profiles map[string]string, timestamp int64, err error)

+ func SaveProfileCache(environment string, profiles map[string]string) error

type ContractCaller

+ Resolver iface.AppNameResolver

type GlobalConfig

+ LastProfileCacheUpdate int64

+ ProfileCache map[string]map[string]string

Nov 13, 2025

Changes in this version

+ var CanUpdateAppProfilePermission = [4]byte

+ var DescriptionFlag = &cli.StringFlag

+ var ImageFlag = &cli.StringFlag

+ var WebsiteFlag = &cli.StringFlag

+ var XURLFlag = &cli.StringFlag

Nov 7, 2025

Changes in this version

+ const EigenXPrivateKeyEnvVar

Nov 6, 2025

Changes in this version

+ const AppStatusSuspended

+ var CanManageBillingPermission = [4]byte

+ var TemplateRepoFlag = &cli.StringFlag

+ func CreateTempDir(prefix string) (string, error)

type AppStatus

+ const ContractAppStatusSuspended

type ContractCaller

+ func (cc *ContractCaller) GetActiveAppCount(ctx context.Context, user common.Address) (uint32, error)

+ func (cc *ContractCaller) GetAppsByCreator(ctx context.Context, creator common.Address, offset uint64, limit uint64) ([]common.Address, []appcontrollerV1.IAppControllerAppConfig, error)

+ func (cc *ContractCaller) GetMaxActiveAppsPerUser(ctx context.Context, user common.Address) (uint32, error)

+ func (cc *ContractCaller) Suspend(ctx context.Context, account common.Address, apps []common.Address) error

Oct 21, 2025

Changes in this version

+ const EigenMachineTypeEnvVar

+ var InstanceTypeFlag = &cli.StringFlag

Oct 7, 2025

Changes in this version

+ const VersionCheckInterval

+ var BuildDownloadURL = func(version, arch, distro string) string

+ var GetS3VersionURL = func() string

+ func GetLatestVersionFromS3(version string) (string, error)

+ func PrintUpdateNotification(info *UpdateInfo)

type GlobalConfig

+ LastKnownVersion string

+ LastVersionCheck int64

+ type UpdateInfo struct

+ Available bool

+ CurrentVersion string

+ LatestVersion string

+ func CheckForUpdate(logger iface.Logger) (*UpdateInfo, error)

Oct 1, 2025

Changes in this version

+ const WatchPollIntervalSeconds

+ var WatchFlag = &cli.BoolFlag

Sep 29, 2025

Changes in this version

+ const AppRegistryFile

+ const AppRegistryVersion

+ const AppStatusCreated

+ const AppStatusDeploying

+ const AppStatusExited

+ const AppStatusFailed

+ const AppStatusResuming

+ const AppStatusRunning

+ const AppStatusStopped

+ const AppStatusStopping

+ const AppStatusTerminated

+ const AppStatusTerminating

+ const AppStatusUpgrading

+ const Build

+ const BuildSuffix

+ const ContractsDir

+ const ContractsMakefile

+ const DockerOpenRetryIntervalMilliseconds

+ const DockerOpenTimeoutSeconds

+ const FallbackEnvironment

+ const GlobalConfigFile

+ const KeyPrefix

+ const KeyringServiceName

+ const L1

+ const MainnetChainID

+ const Makefile

+ const MnemonicEnvVar

+ const SepoliaChainID

+ var AddressCountFlag = &cli.IntFlag

+ var AllFlag = &cli.BoolFlag

+ var AnyoneCanCallAddress = ethcommon.HexToAddress("0x493219d9949348178af1f58740655951a8cd110c")

+ var ApiPermissionsTarget = ethcommon.HexToAddress("0x57ee1fb74c1087e26446abc4fb87fd8f07c43d8d")

+ var CanViewAppLogsPermission = [4]byte

+ var CanViewSensitiveAppInfoPermission = [4]byte

+ var ChainAddresses = map[uint64]ChainAddr

+ var CommonAddresses = CommonAddr

+ var DefaultEnvironmentForChainID = map[uint64]string

+ var EnvFlag = &cli.StringFlag

+ var EnvironmentConfigs = map[string]EnvironmentConfig

+ var EnvironmentFlag = &cli.StringFlag

+ var ErrKeyNotFound = errors.New("key not found")

+ var FileFlag = &cli.StringFlag

+ var ForceFlag = &cli.BoolFlag

+ var GlobalFlags = []cli.Flag

+ var ImageNameFlag = &cli.StringFlag

+ var LogVisibilityFlag = &cli.StringFlag

+ var NameFlag = &cli.StringFlag

+ var PrivateKeyFlag = &cli.StringFlag

+ var RpcUrlFlag = &cli.StringFlag

+ var TemplateFlag = &cli.StringFlag

+ var TemplateVersionFlag = &cli.StringFlag

+ func DeletePrivateKey(environment string) error

+ func EncodeExecutions(executions []erc7702delegatorV2.Execution) ([]byte, error)

+ func EnsureDockerIsRunning(cCtx *cli.Context) error

+ func ForceFlagWithUsage(usage string) *cli.BoolFlag

+ func FormatAppDisplay(context string, appID common.Address) string

+ func FormatETH(weiAmount *big.Int) string

+ func GetAddressFromPrivateKey(privateKeyHex string) (string, error)

+ func GetAppName(context, appID string) string

+ func GetAppRegistryPath(context string) (string, error)

+ func GetDefaultEnvironment() (string, error)

+ func GetGlobalConfigDir() (string, error)

+ func GetGlobalConfigPath() (string, error)

+ func GetGlobalTelemetryPreference() (*bool, error)

+ func GetLogger(verbose bool) (iface.Logger, iface.ProgressTracker)

+ func GetLoggerFromCLIContext(cCtx *cli.Context) (iface.Logger, iface.ProgressTracker)

+ func GetPrivateKey(environment string) (string, error)

+ func IsFirstRun() (bool, error)

+ func IsMainnetEnvironment(env string) bool

+ func ListApps(context string) (map[string]App, error)

+ func LoggerFromContext(cCtx *cli.Context) iface.Logger

+ func MarkFirstRunComplete() error

+ func Parallel[T1, T2 any](fn1 func() (T1, error), fn2 func() (T2, error)) (T1, T2, error)

+ func PeelBoolFromFlags(args []string, longFlag, shortFlag string) bool

+ func ProgressTrackerFromContext(ctx context.Context) iface.ProgressTracker

+ func ResolveAppID(context, nameOrID string) (string, error)

+ func SaveAppRegistry(context string, registry *AppRegistry) error

+ func SaveGlobalConfig(config *GlobalConfig) error

+ func SaveUserId(userUuid string) error

+ func SetAppName(context, appIDOrName, newName string) error

+ func SetDefaultEnvironment(environment string) error

+ func SetGlobalTelemetryPreference(enabled bool) error

+ func ShowTelemetryNotice(logger iface.Logger, opts TelemetryPromptOptions) bool

+ func StorePrivateKey(environment, privateKey string) error

+ func ValidateAppName(name string) error

+ func ValidatePrivateKey(key string) error

+ func WithAppEnvironment(ctx *cli.Context)

+ func WithLogger(ctx context.Context, logger iface.Logger) context.Context

+ func WithProgressTracker(ctx context.Context, tracker iface.ProgressTracker) context.Context

+ func WithShutdown(ctx context.Context) context.Context

+ type App struct

+ AppID string

+ CreatedAt time.Time

+ UpdatedAt time.Time

+ type AppEnvironment struct

+ Arch string

+ CLIVersion string

+ OS string

+ UserUUID string

+ func AppEnvironmentFromContext(ctx context.Context) (*AppEnvironment, bool)

+ func NewAppEnvironment(os, arch, userUuid string) *AppEnvironment

+ type AppRegistry struct

+ Apps map[string]App

+ Version string

+ func LoadAppRegistry(context string) (*AppRegistry, error)

+ type AppStatus uint8

+ const ContractAppStatusNone

+ const ContractAppStatusStarted

+ const ContractAppStatusStopped

+ const ContractAppStatusTerminated

+ type ChainAddr struct

+ PermissionController common.Address

+ type CommonAddr struct

+ ERC7702Delegator common.Address

+ type ContractCaller struct

+ SelfAddress common.Address

+ func NewContractCaller(privateKeyHex string, chainID *big.Int, environmentConfig EnvironmentConfig, ...) (*ContractCaller, error)

+ func (cc *ContractCaller) CheckERC7702Delegation(ctx context.Context, account common.Address) (bool, error)

+ func (cc *ContractCaller) DeployApp(ctx context.Context, salt [32]byte, ...) (appID common.Address, err error)

+ func (cc *ContractCaller) ExecuteBatch(ctx context.Context, executions []erc7702delegatorV2.Execution, ...) error

+ func (cc *ContractCaller) SendAndWaitForTransaction(ctx context.Context, txDescription string, callMsg *ethereum.CallMsg, ...) error

+ func (cc *ContractCaller) StartApp(ctx context.Context, appAddress common.Address) error

+ func (cc *ContractCaller) StopApp(ctx context.Context, appAddress common.Address) error

+ func (cc *ContractCaller) TerminateApp(ctx context.Context, appAddress common.Address, force bool) error

+ func (cc *ContractCaller) Undelegate(ctx context.Context) error

+ func (cc *ContractCaller) UpgradeApp(ctx context.Context, appAddress common.Address, ...) error

+ type EnvironmentConfig struct

+ AppControllerAddress common.Address

+ DefaultRPCURL string

+ ERC7702DelegatorAddress common.Address

+ KMSServerURL string

+ Name string

+ PermissionControllerAddress common.Address

+ UserApiServerURL string

+ type GlobalConfig struct

+ DefaultEnvironment string

+ FirstRun bool

+ TelemetryEnabled *bool

+ UserUUID string

+ func LoadGlobalConfig() (*GlobalConfig, error)

+ type KeyringStore interface

+ DeletePrivateKey func(environment string) error

+ GetPrivateKey func(environment string) (string, error)

+ StorePrivateKey func(environment, privateKey string) error

+ var DefaultKeyringStore KeyringStore = &OSKeyringStore{}

+ type OSKeyringStore struct

+ func (o *OSKeyringStore) DeletePrivateKey(environment string) error

+ func (o *OSKeyringStore) GetPrivateKey(environment string) (string, error)

+ func (o *OSKeyringStore) StorePrivateKey(environment, privateKey string) error

+ type TelemetryPromptOptions struct

+ DisableTelemetry bool

+ EnableTelemetry bool

+ SkipPromptInCI bool