# orbio.bot

> Bids, fleets and drops for orbio CREDIT on Robinhood Chain (chain 4663). Limit bids and recurring buys on orbio's ask-only book, inference budgets that refuel agent wallets, and CREDIT anyone can claim from a link or receive in a batch payout. Three ownerless, fee-free contracts that call orbio's Exchange and CREDIT token.

One CREDIT is one dollar of Orbio inference (orbio.so). USDG and CREDIT use 6 decimals. Book prices are integers where 10000 = 1 USDG per CREDIT.

## Contracts (Robinhood Chain, 4663)

- OrbioBotBids unset
- OrbioBotFleet unset
- OrbioBotDrops unset
- orbio CREDIT 0xE33322DA1380e61E5Ae5DfB21e7f62924c73004C
- orbio Exchange 0x6951fFd32630b05e06F50062AEA801625A58eBC0
- USDG 0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168

Machine-readable: https://orbio.bot/contracts.json. Sources are verified on Sourcify. RPC: https://rpc.mainnet.chain.robinhood.com.

## Bids (OrbioBotBids)

- place(uint256 deposit, (uint32 maxPrice, uint128 perFill, uint64 interval, uint16 tipBps, address recipient, bool activate, address filler) terms) returns (uint256 id). Approve USDG first. deposit >= 1 USDG.
- maxPrice is all-in: (USDG spent + tip) per CREDIT delivered must be <= maxPrice / 10000. It includes orbio's book fee for CREDIT bids and the activation fee for activating bids.
- interval 0 = limit bid (perFill optional cap per fill). interval > 0 = recurring buy: budget grows perFill USDG per interval, capped at one period.
- activate true: inference is activated on recipient's Orbio account (buyAndActivate). false: CREDIT is sent to recipient.
- filler zero = anyone may fill; otherwise only that address or the owner.
- fill(uint256 id, uint256 usdgIn, uint256 maxFills) returns (creditOut, spent, tip). Anyone (unless filler is set). Pays tipBps (<= 100) of spent to the caller. Simulate first: a fill that breaks the limit reverts. usdgIn between 0.01 USDG and fillable(id); maxFills 1 to 64.
- fund(id, amount), update(id, terms), withdraw(id, amount), close(id) (owner gets the rest back).
- Views: getBid(id), bidsOf(owner), fillable(id), budgetOf(id), count().

## Fleets (OrbioBotFleet)

- createFleet(string name) returns (uint256 fleetId). fund(fleetId, creditAmount) (approve CREDIT). fundFromBook(fleetId, usdgIn, minCreditOut, maxFills) buys on orbio's book into the fleet.
- addBot(fleetId, address wallet, uint128 rate, uint32 period, uint128 cap, uint128 initial, bool activate, string label) returns (uint256 botId). The bot earns rate CREDIT per period seconds, banked up to cap.
- refuel(fleetId, botId) pays what the bot earned (>= 0.01 CREDIT) to the bot: activated on its Orbio account, or as CREDIT. Anyone may call; only the bot is paid. refuelAll(fleetId).
- An agent finds its allowances with slotsOf(wallet, skip, limit) (newest first) and available(fleetId, botId) -> (earned, deliverable). Keep only slots whose getBot(fleetId, botId).wallet is this wallet and whose fleet operator you trust.
- Operator: withdraw(fleetId, amount, to), updateBot(...), setBotWallet(fleetId, botId, wallet), rename, proposeOperator(fleetId, to) then acceptOperator(fleetId) by the new operator.

## Drops (OrbioBotDrops)

- create(uint128 perClaim, uint32 claims, uint64 expiry, address signer, string note) (approve CREDIT for perClaim * claims) or createFromBook(perClaim, claims, expiry, signer, note, usdgIn, maxFills) (approve USDG).
- signer is the address of a one-time key carried in the link fragment: https://orbio.bot/claim#<id>.<64 hex key>.
- claim(uint256 id, address recipient, bool activate, bytes signature): signature = the link key's EIP-191 personal-message signature of claimDigest(id, recipient, activate). One claim per wallet. Anyone may relay; only recipient is paid.
- close(id): the sender any time, anyone after expiry; the rest goes to the sender.
- payout(address[] recipients, uint256[] amounts, bool activate, string note): pay up to 200 wallets (approve CREDIT for the total).

## Orbio API access after activation

Sign "Orbio API key · chain 4663 · epoch 0" with the wallet; the key is sk-orb-0- followed by the base64 of the signature bytes. Use it with https://www.orbio.so/api/v1 (OpenAI-compatible). See https://www.orbio.so/llms.txt.

## Links

- Site: https://orbio.bot
- Docs: https://orbio.bot/docs
- X: https://x.com/getorbiobot
- orbio protocol: https://www.orbio.so/protocol/agents.md