whatisgithub

What is custos?

rodev-protocol/custos — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 5/5Setup · hard

In one sentence

An autonomous DeFi agent that maintains the Rodev Protocol, harvests yield, manages risk, sells treasury services to other agents, and posts social updates.

Mindmap

mindmap
  root((CUSTOS))
    What it does
      Harvests yield
      Manages loans and liquidations
      Guards reserves and gas
      Sells services to other agents
    Tech stack
      TypeScript
      Node.js
      Blockchain smart contracts
    Use cases
      Automate DeFi protocol maintenance
      Earn USDC via agent commerce protocol
      Run a Telegram and X bot for a protocol
    Audience
      DeFi developers
      Protocol operators
    Related
      The Graduator trades early tokens
      Dry run mode by default

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Automatically harvest yield and rebalance a DeFi vault on a schedule.

USE CASE 2

Sell treasury services like audits and yield snapshots to other on-chain agents for USDC.

USE CASE 3

Run a Telegram bot that answers questions about protocol status, loans, and rates.

What is it built with?

TypeScriptNode.js

How does it compare?

rodev-protocol/custos0xkinno/astraea0xkinno/halcyon
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardhardhard
Complexity5/54/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Full functionality requires a funded private key plus Telegram and X API credentials.

So what is it?

CUSTOS is an automated software agent that watches over and manages a decentralized finance, or DeFi, protocol called Rodev. It runs on a blockchain network called Robinhood mainnet and interacts with seven deployed smart contracts. Its job is largely maintenance and safety work: it automatically collects yield, moves funds around to keep things balanced, checks that the system's rules still hold, handles loan repayments, keeps an eye on liquidation risk, and makes sure it always has enough of its own funds to pay transaction fees. The agent is built from a set of separate skills that each run on their own schedule, ranging from checking loans every minute to posting a full protocol summary once an hour. Beyond pure maintenance, CUSTOS also participates in something called the Virtuals Agent Commerce Protocol, where it sells small treasury related services, like yield snapshots or account audits, to other automated agents in exchange for a stablecoin called USDC. The money it earns this way is automatically funneled back into Rodev's own vault, effectively letting the agent build a track record from real revenue it generates itself. CUSTOS also has a social presence. It runs a Telegram bot that responds to both fixed commands and natural language questions about the protocol's status, and it posts scheduled updates and commentary to the social platform X. A separate narration feature describes what the keeper is doing in real time across these channels, and other skills post educational content or celebrate milestones like the protocol's total funds reaching new highs. A related but separate piece called the Graduator trades other, not yet fully launched tokens on their early bonding curve markets, using its own wallet and its own bounded risk, and it starts in a safe dry run mode where trades are only simulated on paper rather than real. Running CUSTOS requires cloning the code, installing dependencies with npm, and providing credentials for the parts you want active, such as a private key for on-chain actions or Telegram and X tokens for the social features, any missing credentials simply turn off the skills that need them rather than causing an error.

Copy-paste prompts

Prompt 1
Walk me through what each of CUSTOS's keeper skills does and how often it runs.
Prompt 2
Explain how CUSTOS earns and routes USDC through the Virtuals Agent Commerce Protocol.
Prompt 3
Help me set up CUSTOS in monitor-only mode versus full keeper mode with all credentials.
Prompt 4
Explain what the Graduator does and how its dry-run mode works before going live.

Frequently asked questions

What is custos?

An autonomous DeFi agent that maintains the Rodev Protocol, harvests yield, manages risk, sells treasury services to other agents, and posts social updates.

What language is custos written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js.

How hard is custos to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is custos for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.