Ora

Live app: https://www.useora.site Repository: https://github.com/Queenxrypt/ora

Ora is a procurement agent for Orbio CREDIT. It checks the live CREDIT market and decides whether to BUY or WAIT based on procurement parameters set by the user.

What is Ora?

Orbio makes inference tradable through CREDIT. Ora treats acquiring that CREDIT as a procurement decision: the user sets parameters, and Ora checks the live market against them. The decision is BUY or WAIT.

How It Works

1. Connect a wallet.
2. Set procurement parameters:
   • CREDIT to procure
   • Spending limit (USDG)
   • Minimum acceptable discount
3. Ora reads the live CREDIT market.
4. Ora evaluates the market with its deterministic decision rules.
5. When the book can fill the request, Ora checks one executable quote for that amount. BUY is returned only if that quote meets the spending limit and minimum discount.
6. If the book or the executable quote does not qualify, Ora returns WAIT.
7. For a BUY decision, Ora retrieves a fresh executable quote again before anything is signed.
8. The user reviews the quote and approves the transaction in their wallet.
9. The purchase is executed through Orbio's CREDIT exchange contract.
10. The transaction is verified after confirmation.
11. Decisions and execution outcomes are recorded in History.
12. Performance can later compare completed purchases against the relevant market baseline.

Ora does not sign transactions or move funds by itself. A purchase proceeds only after the user approves it in their wallet.

Initial parameter defaults are 5 CREDIT, a 25 USDG spending limit, and a 20% minimum discount. Saved settings are stored per wallet.

Decision Logic

The requested amount is floored to the live market's minimum buy size:

requested = max(requestedCredit, market.minBuyCredit)

Ora first checks order-book levels against the configured minimum discount. A level qualifies when its discount is at least that minimum and it has enough available CREDIT for requested. If no qualifying level can fill the request, Ora returns WAIT. That book check does not call the exchange.

A qualifying book is not an executable quote. Before Ora presents BUY, it reads one executable quote for that same requested amount. The quote total includes the exchange fee. BUY is returned only when the quote discount meets the minimum discount and the quote total is within the spending limit. If the quote misses either check, Ora returns WAIT.

That quote is read once per new evaluation, and only after the book already qualifies. It is not read on every render. If the quote cannot be obtained, Ora does not present BUY and does not record a decision.

The purchase still re-reads the market and validates a new quote immediately before signing. The market can move between the decision and that check.

The deterministic rule is authoritative.

Orbio Reasoning

Orbio reasoning is part of Ora's agent workflow. Ora sends the live market context, procurement parameters, and the deterministic BUY or WAIT decision to Orbio, which provides a short explanation for why that decision makes sense.

The deterministic procurement rule remains authoritative for the actual BUY/WAIT decision and execution safety. Orbio provides the reasoning layer without having unchecked control over spending, quotes, wallet actions, or transaction execution.

The flow is:

Market context → deterministic procurement rule → BUY/WAIT → Orbio reasoning → user review and execution.

Ora uses ORBIO_API_KEY on the server for this reasoning layer. If the reasoning service is temporarily unavailable, Ora can still record and act on the deterministic decision. This fallback prevents a reasoning-service failure from blocking the procurement workflow.

Purchase Safety

• A fresh executable quote is fetched from the exchange before a purchase is offered.
• The quote is checked against the user's spending limit and minimum discount. A quote that misses either check is not offered for purchase.
• A quote older than 90 seconds is rejected.
• Before signing, Ora re-reads the book, runs the BUY rule again, and fetches a new quote. A market that is no longer BUY, a moved price, missing liquidity, or a spending-limit breach stops the purchase.
• The connected wallet must be on Robinhood Chain. The user approves any required USDG allowance and the buyAndActivate call.
• Ora records a successful purchase only after the onchain receipt status is success.
• A submitted transaction that has not confirmed stays pending. A reverted transaction, or one that is not a purchase on the exchange, is recorded as failed.

History

History is a read-only audit log of procurement decisions and their execution lifecycle. BUY and WAIT decisions are both recorded, for the connected wallet.

Statuses shown in History:

• Decision: a BUY or WAIT decision was recorded.
• Review: BUY is waiting on quote review.
• Pending: a transaction was submitted and is awaiting confirmation.
• Confirmed: the transaction confirmed onchain.
• Failed: execution did not complete.

Performance

Performance measures completed procurement outcomes from recorded activity and a later market snapshot.

It can evaluate:

• BUY and WAIT activity
• Confirmed purchases
• CREDIT purchased
• Total cost
• Average effective price
• Comparable buy-on-demand cost
• Difference between Ora's purchase and the relevant baseline

The baseline is the cost of buying the same CREDIT size later at the later book's listed CREDIT price. Confirmed fills are included in the cost totals. Reviewed, pending, and failed BUY rows stay unresolved until a purchase confirms. A confirmed purchase stays unresolved until a later market snapshot exists.

Performance does not claim profitability. It reports outcomes from the ledger and later market data.

Architecture

• app/: Next.js App Router pages and API routes (market desk, history, performance, decision, quote, and execution).
• components/: UI components.
• lib/orbio/: Orbio market book, exchange quotes, contracts, and reasoning client.
• lib/ora/: procurement parameters, the BUY/WAIT rule, quote checks, outcomes, and performance.
• lib/db/: Supabase persistence for decisions and settings.
• lib/wallet/: injected-wallet connection on Robinhood Chain.
• types/: shared types.

ORBIO_API_KEY and SUPABASE_SECRET_KEY are read on the server. They are not exposed to the browser.

Orbio Integration

• CREDIT order book from ORBIO_MARKET_ORIGIN at /api/market/book (default https://www.orbio.so).
• Executable quotes from getQuoteForCredit on the CREDIT exchange.
• CREDIT purchase and activation through buyAndActivate, paid in USDG.
• Orbio reasoning through https://api.orbio.so/api/v1.
• Robinhood Chain.
• Chain ID: 4663.
• CREDIT exchange contract: 0x6951ffd32630b05e06f50062aea801625a58ebc0.

CREDIT represents inference usage. In this integration, 1 CREDIT corresponds to $1 of usage. The book price is that face value minus the listed discount, quoted in USDG.

Environment Variables

Copy .env.example to .env.local for local runs. Keep secret values out of the client and out of git.

Variable	Role
ORBIO_API_KEY	Server-side key used by Ora's Orbio reasoning layer.
SUPABASE_URL	Supabase project URL. Required to store decisions and settings.
SUPABASE_SECRET_KEY	Server-side Supabase key. Required with SUPABASE_URL.
ROBINHOOD_RPC_URL	Robinhood Chain RPC. Defaults to https://rpc.mainnet.chain.robinhood.com.
ORBIO_MARKET_ORIGIN	Origin for the CREDIT order book. Defaults to https://www.orbio.so.
ORBIO_REASONING_MODEL	Reasoning model id. Defaults to google/gemini-3.8-flash when unset.
TELEGRAM_BOT_TOKEN	Server-side Telegram bot token. Used to send READY alerts and by the manual npm run telegram:webhook helper. Never sent to the browser.
TELEGRAM_BOT_USERNAME	Bot username (without @) used to build the one-time t.me link. Connect Telegram stays unavailable when unset.
TELEGRAM_WEBHOOK_SECRET	32–256 characters of A-Z a-z 0-9 _ -. Telegram sends it in X-Telegram-Bot-Api-Secret-Token; the webhook rejects every request when it is unset.
TELEGRAM_ALERTS_ENABLED	Set to true to send READY alerts. Any other value, or a missing bot token, keeps delivery off.

Telegram linking: the wallet signs a server-issued message that authorizes no transaction, spending or purchase. Ora then returns a one-time link that expires after 10 minutes. The link is created only when Telegram delivers /start <token> to the authenticated webhook from a private chat. /stop in that chat disconnects it. Register the webhook explicitly with npm run telegram:webhook -- set; with no argument the helper only reads the current webhook.

Telegram READY alerts: the scheduled observation sends at most 10 per run. Before sending, Ora checks that the target is still READY in the same READY period and that the wallet still has an active Telegram link. The message is informational, and its Open Ora button links to /app#targets. Telegram cannot review or buy anything. Delivery failures never affect observation or target evaluation.

ORBIO_API_KEY is required for Ora's Orbio reasoning layer. The deterministic procurement rule remains available if the reasoning service is temporarily unavailable.

Local Development

This repo uses npm (package-lock.json).

npm install

Copy .env.example to .env.local and fill in the variables above.

npm run dev

Production build (Next.js also typechecks during this build):

npm run build

There is no separate typecheck script.

Deployment

Ora is a Next.js application deployed on Vercel. Set the environment variables in the Vercel project so credentials stay on the server.

Current Scope

Ora currently does the following:

• Live CREDIT market checks
• Deterministic BUY/WAIT procurement decisions
• Configurable procurement parameters
• Orbio reasoning layer
• Quote review and validation
• User-approved CREDIT purchase
• Execution confirmation
• Decision history
• Performance measurement

That scope is CREDIT procurement on this desk: check the book, decide BUY or WAIT, and complete a purchase only with the user's wallet.

Roadmap

Not built yet.

One of the directions I want to explore next is prediction markets around CREDIT, giving builders and agents a way to bet on where the price of CREDIT will be in the next hour. We could start with one-hour markets.