zeus

README

Zeus

We combine the best parts of infra technology in Kubernetes and merge the configuration of it into highly relational, structured, and uniform SQL models, using Postgres to store infrastructure state, instead of Helm charts, and driving state changes through the Kubernetes API directly using Temporal to orchestrate the states reliably, instead of GitOps. We also merge Kubernetes app design & configuration into natural code letting you build infra like you would with real code, meaning libraries, building in your IDE, making everything much easier to maintain and observe, making complex scalable infrastructure setup, building, and DevOps as simple as 1-click.

Here are some early demo videos of infrastructure building and interfacing with the pods controller (pre-cluster & matrix version). We'll replace them with higher quality demos of the latest cluster building suite over the next few months.

https://drive.google.com/drive/folders/1tACuTADLbmYT7vS8qBqY_l5buZh_cn__?usp=sharing

Zeus K8s Infra as Code Concepts

Here we overview the core concepts needed to understand how you can build, deploy, configure K8s apps using Zeus, with a full walkthrough example of how we created an Ethereum beacon.

https://medium.com/@zeusfyi/zeus-k8s-infra-as-code-concepts-47e690c6e3c5

Ethereum staking from your wallets & private secret managers.

Event driven signature automation for Ethereum staking using our synthetic staking beacon, which bundles middleware like slashing protection and mev into the service which streams validator messages to you on demand to serverless functions, hosted signers, or mobile apps, with the benefit of letting you stake from your wallet without anyone having access to your signing or withdrawal keys and without any infrastructure setup, with only a few lines of code.

How much will staking services cost for Ethereum?

$10/mo solo or large scale enterprise staking for Ethereum per validator.

How do I setup validators?

You can use our automation app to setup your own validators in 1 click, or step by step using the config value. Here's our tutorial on Medium. If you fill out the form on our website at: https://www.zeus.fyi, it'll automatically send you a bearer token to your email address for access. Check your spam if you don't see it.

https://medium.com/@zeusfyi/how-to-setup-serverless-ethereum-validators-on-zeus-17f4af917259

Ephemery explorers

https://beaconchain.ephemery.pk910.de

https://explorer.ephemery.pk910.de

Cookbooks

Contains common web2 & web3 building components like ethereum infra setups with customization driven through code, blurring the line between infra configuration and app development, and contains microservice designs & patterns like api servers and injectable choreography, their setups in kubernetes, golang, docker, and startup commands, and useful tools for debugging, interacting, and automating actions.

Cookbook Structure

Ethereum

protocol/components

Contains smart contract automation kits. This testcase shows a full end-end seed, create, and deposits validators on the Ethereum ephemery testnet.

cookbooks/ethereum/automation

cookbooks/ethereum/automation/deposits_test.go

Cookbook items listed by protocol & component class. Eg. Ethereum has a beacon component group. Contains Kubernetes config setup templates. Here's a few example paths. Also contains an actions folder, which does log dumps, pod restarts, configuration changes on demand for k8s applications, and more.

cookbooks/ethereum/beacons/infra/consensus_client

cookbooks/ethereum/beacons/infra/exec_client

cookbooks/ethereum/validators/infra/validators

cookbooks/ethereum/web3signers/infra/consensys_web3signer

Complete, and powerful Ethereum infra automation

zeus/cookbooks/ethereum/beacons/beacon_cluster_test.go

zeus/cookbooks/ethereum/validators/validator_cluster_test.go

zeus/cookbooks/ethereum/web3signers/web3signer_cluster_test.go

See this test case to see how a beacon cluster class was created, and then extended to support choreography to reset configs on a scheduled interval for the Ephemery testnet, and then added validator clients, and then again to add web3signing integration.

Microservices

Contains full kubernetes infra setup templates for microservices, injectable choreography for clusters, and more continually being added.

zeus/cookbooks/microservices/deployments

zeus/cookbooks/microservices/choreography

Zeus Apps & Clients

Core Zeus Infra Automation Client

pkg/zeus/client

Powerful Cluster Building, Allowing for Large Scale Infra Automation, Customization, Control

pkg/zeus/cluster_config_drivers

pkg/zeus/system_config_drivers

pkg/zeus/workload_config_drivers

API Endpoints

Documentation and code examples are found here API_README.md

How to use the test suite to setup your own api calls README.md

The test directory contains useful mocks and tools for interacting with the API. It also contains a useful config-sample.yaml, convert this to config.yaml and set your bearer token here, which then allows you to use the demo code to create your first api request in seconds

Hera Client

pkg/hera/client

This client uses the OpenAI API to generate code with AI. This service is available at OpenAI cost, so just pay for the token cost, otherwise it is free to use.

Artemis

artemis.zeus.fyi

pkg/artemis/client

Artemis is a tx orchestrator. It reliably submits & confirms ethereum transactions and logs their receipts. Chain with the in memory db for storing web3 signer keys to build highly reliable web3 api actions with other users and smart contracts. You'll need a bearer token to use this client. A more advanced orchestrator that can handle high volume DeFi trading, which manages nonce sequences, sets up event triggers & scheduling, and has queriable event artifacts is in works, targeted release by end of March.

Aegis

pkg/aegis/inmemdbs

pkg/crypto

Aegis is a library for securely managing crypto keys. It currently contains an in memory database for storing ethereum validators and for storing ecdsa, eth1 wallet keys.

Hercules

apps/hercules

pkg/hercules/client

Hercules is web3 middleware that manages web3 infrastructure and connections to other middleware packages. It also contains useful apis to debug and troubleshoot web3 infrastructure.

Snapshots

apps/snapshots

Snapshot app is embedded into the hercules docker app, and it can be used as an init container to download snapshot data on new node creation.

Hades Library

pkg/hades

Hades is used to interact with kubernetes workloads via API, and can apply saved Zeus workloads & cookbooks onto your own in house infrastructure.

Zeus Users

Beacon API

Our ephemeral ethereum testnet beacon is open to anyone, no auth is required. Large Eth quantities for testing is available on request.

https://eth.ephemeral.zeus.fyi

Snapshot download urls for mainnet geth & lighthouse available on request.

Infra configuration is in the 14th century. Introducing the 21st century printing press

By unifying the infra ecosystem tools of today it allows the acceleration of infra development exponentially over time with each new open source cookbook & system template allowing you to glue sophisticated distributed systems together in zero time, which lets decentralized solo & small team builders compete directly against large incumbents at the edge of technology by erasing the need for large investment in infra & devops departments that are needed now to even get started.

Lastly, by solving infra configuration, mobility, and orchestration through remote API driven configuration, it allows you to run sophisticated web apps in virtually zero time on far more cost efficient bare metal cloud providers using commoditized managed kubernetes services and simple middleware we provide, which is up to 6x more cost efficient than AWS, GCP, and comparable cloud companies. Take a look for yourself, then ask yourself why you want to make Jeff Bezos richer than he already is?

You have alternatives

https://www.ibm.com/cloud/kubernetes-service

https://us.ovhcloud.com/public-cloud/kubernetes

https://www.linode.com/products/kubernetes

https://www.digitalocean.com/products/kubernetes

https://www.vultr.com/kubernetes

It doesn't take long to figure it out, here's some pricing links to help you out

https://www.ovhcloud.com/en/public-cloud/prices/

https://www.ibm.com/cloud/virtual-servers/pricing

https://instances.vantage.sh/

AWS, GCP, Azure, type cloud companies purposely have highly confusing pricing models to mislead you on costs using data transfer bills, among other sales tactics like free initial cloud usage until you're locked into their ecosystem complexity, exactly when you realize the cloud spend is outrageous. The vast majority of enterprise users simply need RAM, CPU, Bandwidth Traffic, and a few disk options like RAID setups, and HDD, SSD, NVMes. All major cloud companies have similar performance & online SLAs. Why would you want to spend 100+ engineering hours figuring out some obscure EC2 instance number that they deprecate in a year anyway? The 0.001% of people that have that need already know what they want.

Overview

1. Automates translation of kubernetes yaml configurations into representative SQL models
2. Users upload these infrastructure configurations via API where they are stored in the DB
3. Users can then query the contents of these infrastructure components, deploy, mutate or destroy them on demand

Currently Supported Workload Types

1. Deployments
2. StatefulSets
3. Services
4. ConfigMaps
5. Ingresses
6. ServiceMonitors

Pods Controller

1. GetPods
2. GetPodLogs
3. PortforwardReqToPods
4. DeletePods

Not every possible field type is supported, but the most common ones are, and even a decent amount of the uncommon ones.

See demos section for api calls, you'll need to get a bearer token from us first. More documentation to come. Schedule a demo: https://calendly.com/alex-zeus-fyi/zeus-demo Request a bearer token, email: alex@zeus.fyi

Cluster Topology Class Hierarchy Definitions

Highest to Lowest Level

Deployable Topologies

Network Orchestration Topology

One or many network matrix system topologies that are combined with orchestration workflows from Artemis, and Zeus, to build complex control flows and/or sequenced network states. This could be an enterprise fleet of infrastructure, a complex devops operation done at scale, or a simulation of a large testnet, or a built-in orchestration flow for automating web3 smart contract interactions for users and sending them notifications and prompts.

Matrix Topology

A multi-component cluster topology that accomplishes one or more system components on its own and combined with a Zeus injection deploys this topology onto the network. Some but not all of these topologies can be stacked with another cluster topology or a base topology to create a higher level system component.

It can be any combination of lower level system topologies or components.

Cluster Topology

A fully working single component cluster topology that accomplishes one system component on its own and combined with a Zeus injection deploys this topology onto the network. Some but not all of these topologies can be stacked with another cluster topology or a base topology to create a higher level system component.

Deployable but Incomplete Topologies

Base Topology

A fully working single cluster topology that needs at least one other Base Topology to create a higher level component. An example would be deploying an execution client by itself post-merge on ethereum. It would be able to download chain data, but it wouldn’t be able to fulfill a useful purpose without another piece e.g. a consensus client component.

Not deployable on its own, a mix of these is combined to create a deployable topology

Infrastructure Base

An abstract atomic infrastructure base that needs a Skeleton and Configuration to create a Base Topology

Configuration Base

An abstract atomic configuration base that needs an Infrastructure Base and Skeleton to create a Base Topology

Skeleton Base

An abstract atomic component base that needs additional pieces to create deployable infrastructure like config map, docker image links, etc. Needs an Infrastructure and Configuration Base to create a Base Topology