whatisgithub

What is orcus?

hoomanbuilds/orcus — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 5/5Setup · hard

In one sentence

A hackathon trading agent that encrypts trade instructions so they stay hidden until the trade is already settled.

Mindmap

mindmap
  root((Orcus))
    What it does
      Encrypt trade intent
      Decide via secure enclave
      Settle swap on chain
    Tech stack
      TypeScript
      Next.js
      0G blockchain
    Use cases
      Avoid sandwich attacks
      Private DeFi trading
      Hackathon demo
    Audience
      Blockchain developers
      Hackathon judges
    Components
      Strategy Vault contract
      Autonomous agent
      Web dashboard

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

Submit an encrypted trading instruction that stays hidden until the trade settles on chain.

USE CASE 2

Study how a Trusted Execution Environment can be used to run private trading decisions.

USE CASE 3

Use as a hackathon reference for combining encrypted intents, an AI decision agent, and on-chain settlement.

USE CASE 4

Explore how audit receipts stored on 0G Storage can prove what an agent decided without leaking the intent.

What is it built with?

TypeScriptNext.jsSolidity0G Compute0G Storage

How does it compare?

hoomanbuilds/orcus0xradioac7iv/tempfsabboskhonov/hermium
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardmoderatemoderate
Complexity5/53/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+

Requires 0G testnet access, deployed contracts, and a TEE-backed 0G Compute setup to run the agent end to end.

The README excerpt does not state a license.

So what is it?

Orcus is an experimental trading agent built for the 0G blockchain, submitted as a working testnet entry to the 0G APAC Hackathon. Its goal is to let someone trade tokens without their intended trade being visible to anyone before it settles, protecting against a type of attack called sandwiching, where bots watch pending trades in the public queue and profit by trading just before and after them. The system has three parts. A smart contract on the 0G Galileo network, called the Strategy Vault, holds user deposits and encrypted trading instructions, and only lets a designated automated agent trigger execution, while letting users withdraw their funds at any time. That agent is a TypeScript program that watches the vault for new encrypted instructions, decrypts them using a private key, and decides whether to execute the trade. A web dashboard, built with Next.js, is where a user types a plain instruction such as swap my token to USDC now, which gets encrypted in the browser before anything is sent anywhere, then lets the user deposit funds, watch the status of their instruction, and see proof of what happened afterward. The decryption itself happens inside what is called a Trusted Execution Environment, a secure area of a computer chip designed so that not even the operator running it can see the data inside. There, the agent also checks current market prices from CoinGecko and sends the decrypted instruction plus that market data to a language model running inside the same secure environment, which decides whether to execute the trade now or wait. If it decides to execute, the agent records a proof of that decision to 0G's storage network, then calls the vault contract to carry out the swap and send the result to the user's wallet. The README states this is a working testnet build with verified trade executions on 0G Galileo testnet, not just a design proposal, and includes a table of contents pointing to further detail on the encryption layer, the contracts, the dashboard, the project's 0G integrations, and a security model section aimed at hackathon reviewers. The project is written primarily in TypeScript.

Copy-paste prompts

Prompt 1
Walk me through how Orcus encrypts a trading instruction before it leaves the browser.
Prompt 2
Explain how Orcus's agent decides whether to execute or wait on a trade inside its secure enclave.
Prompt 3
Set up the Orcus dashboard and deposit funds into the Strategy Vault on the 0G Galileo testnet.
Prompt 4
Describe how sandwich attacks work and how Orcus's design prevents them.

Frequently asked questions

What is orcus?

A hackathon trading agent that encrypts trade instructions so they stay hidden until the trade is already settled.

What language is orcus written in?

Mainly TypeScript. The stack also includes TypeScript, Next.js, Solidity.

What license does orcus use?

The README excerpt does not state a license.

How hard is orcus to set up?

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

Who is orcus for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.