gitwtfhub

wtf is aureon-sdk?

buildaureon/aureon-sdk — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · developerComplexity · 4/5LicenseSetup · moderate

TL;DR

A TypeScript client library for AUREON, a hosted service that watches crypto portfolios against rules you set and suggests rebalancing transactions to keep them in line.

Mindmap

mindmap
  root((AUREON SDK))
    What it does
      Monitors crypto portfolios
      Detects rule violations
      Suggests rebalances
    Tech stack
      TypeScript
      Node.js
      Viem
    Use cases
      Define financial objectives
      Authenticate with wallet
      Trigger restore plans
    Audience
      Developers
      Bot builders
      Onchain agent creators

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

Why would anyone build with this?

REASON 1

Connect a wallet or bot to the AUREON API to monitor a crypto portfolio's balance against defined rules.

REASON 2

Register objectives like maintaining a target percentage of stable coins in a portfolio.

REASON 3

Receive suggested rebalancing transactions when a portfolio drifts out of its target range.

REASON 4

Sign in with a wallet address and verify ownership through a message signature before using the API.

What's in the stack?

TypeScriptNode.jsViem

How it stacks up

buildaureon/aureon-sdk0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardeasy
Complexity4/54/52/5
Audiencedeveloperdeveloperdeveloper

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Node.js 20+, an API key or wallet signature for authentication, and Viem if you plan to sign transactions.

You can use, modify, and distribute this freely, including for commercial purposes, as long as you keep the original copyright notice.

Wtf does this do

This repository is the official TypeScript client library for a service called AUREON, which describes itself as a financial intelligence layer for onchain AI agents running on Robinhood Chain, a blockchain network. In plain terms, it is a way for a program or a wallet operator to define rules about how a pool of crypto assets should be kept balanced, and then have a hosted service watch those assets and tell you when to act. The core idea is what the README calls Financial Compass Objectives. Instead of sending one crypto transaction at a time and forgetting about it afterward, a developer registers an ongoing rule, such as keeping a certain percentage of a portfolio in stable coins. The AUREON service then continuously checks the value of the holdings using public market prices, watches for the rule being broken, and produces suggested recovery transactions, like swapping assets back into balance. It also keeps a tamper resistant log of these checks over time. Importantly, the README is clear that private keys and actual transaction signing always stay on the user's own machine or wallet. The hosted AUREON service only handles monitoring, price calculations, and building the recovery instructions. It never holds a user's funds directly. To use this SDK, you install it with a package manager like pnpm, npm, or yarn, and you need Node.js version 20 or newer. If you plan to actually sign and send transactions, you also need a library called Viem. The README walks through logging in by proving you control a wallet address through a signed message, then using the SDK to check your positions, define objectives, and trigger rebalances when needed. This project is aimed at developers building crypto trading bots, portfolio tools, or automated agents that need to keep digital asset holdings within defined limits, rather than at general audiences or non-technical users.

Yoink these prompts

Prompt 1
Show me how to install this SDK and initialize the AUREON client in a TypeScript project using this README's quickstart.
Prompt 2
Explain how the wallet authentication flow in this SDK works, based on the sequence diagram in the README.
Prompt 3
Help me write a script using this SDK that checks my portfolio's health and logs any rebalance suggestions.
Prompt 4
Walk me through what a Financial Compass Objective is and how I would define one using this SDK.
Prompt 5
Compare the trust boundary this SDK describes between the client and the hosted API, and explain why private keys never leave my machine.

Frequently asked questions

wtf is aureon-sdk?

A TypeScript client library for AUREON, a hosted service that watches crypto portfolios against rules you set and suggests rebalancing transactions to keep them in line.

What language is aureon-sdk written in?

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

What license does aureon-sdk use?

You can use, modify, and distribute this freely, including for commercial purposes, as long as you keep the original copyright notice.

How hard is aureon-sdk to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is aureon-sdk for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.