Exploded engineering blueprint of a delivery robot

schematic sheet 01 — hoodly technical documentation

Credits

Anchoring draws on two prepaid balances: anchor quota bought by burning $HOODLY, and a gas balance in ETH that covers what those anchors cost on-chain.

Why two balances

They pay for two different things. Quota is the right to use Hoodly — you acquire it by burning $HOODLY, which destroys the tokens rather than sending them to us, so every anchor permanently reduces supply. Gas is the unavoidable cost of putting a transaction on Robinhood Chain, which has to be paid in ETH.

Keeping them apart means the burn can be a real burn. If usage had to fund our gas bill, a share of every payment would have to be sold for ETH instead of destroyed.

Why gas is prepaid

A transaction can only be paid by whoever signs it, and signing needs a private key. Your key lives in your browser wallet, which is not reachable when a robot finishes a task in the middle of the night.

So you fund a balance in advance and Hoodly's server wallet spends it on your behalf, settling each anchor at what it actually cost. You carry your own cost, and robots still need no ETH, no key and no chain tooling.

How a payment finds your account

There is no memo, no reference code and no payment form. A top-up is an ordinary transfer, and the sender address is the only thing that ties it to your account.

That works because an account here is a wallet: you sign in by signing a message with an address, so a transfer from that same address identifies itself. Nothing else about the transaction matters — not the amount, not the timing, not what you write in it.

Send only from the wallet you sign in with

A payment from any other address cannot be matched to you automatically. In particular, do not withdraw directly from an exchange — Coinbase, Binance and the rest send from their own hot wallet, so the payment arrives with an address that has nothing to do with you.

Nothing is lost if it happens. The payment is held as unmatched and can be credited by hand — see below. But it stops being instant, so it is worth getting right the first time.

Topping up, step by step

Both addresses are shown on the billing page of the dashboard. Copy them from there rather than from anywhere else.

To buy anchor quota
1. Open the dashboard, sign in with your wallet
2. Go to Billing and copy the burn address
3. Send $HOODLY to it — from the wallet you just signed in with
4. Wait for the transaction to confirm, then press "check payments"

Quota is credited from the amount in the token's Transfer event,
so it always reflects what actually arrived.
To fund gas
1. Open the dashboard, sign in with your wallet
2. Go to Billing and copy the treasury address
3. Send ETH to it — from the wallet you just signed in with
4. Wait for the transaction to confirm, then press "check payments"

ETH is credited one to one. It is spent on the real cost of your
anchor transactions, nothing else.

Both are on Robinhood Chain. Sending on another network reaches an address we do not control, and nothing on this page can recover that.

Payments are also picked up automatically when you open the billing page and when a robot hits an empty balance, so the button is only there for when you do not want to wait.

If a payment does not show up

First give it a moment and press check payments — the chain has to confirm the transaction before we can see it.

If it still is not there, it almost certainly arrived from an address that is not your sign-in wallet. Those payments are not lost. They are recorded as unmatched, and there are two ways to resolve one:

You sent it yourself, from a wallet you control. Sign in with that wallet and open the billing page. The payment is listed there and you can credit it to that account yourself.

It came from an exchange, a Safe, or someone else. The sender address is not yours, so only we can attribute it. Get in touch with the transaction hash and the account it belongs to.

Two things we genuinely cannot fix

A transfer sent on the wrong network, or to an address that is not one of the two shown on the billing page. Both go somewhere we have no key for. Check the address and the network before you confirm.

How an anchor is charged

On completion Hoodly holds one unit of quota plus a gas ceiling, anchors the proof, then refunds the difference between the ceiling and the real cost. If anchoring never reaches the chain, the entire hold is returned and the task is marked failed. Every movement is recorded in the history on the billing page.

Running out

When a balance is empty, completing a task responds with 402 and the task stays claimed, so nothing is lost — top up and submit the proof again.

402 Payment Required
{
  "error": "no_gas_credit",
  "message": "The owning account has no gas credit left. Send ETH to the treasury address shown on the billing page. See https://hoodly.fun/docs/credits",
  "gas_credit_wei": "0"
}

The public verification endpoint is never metered — anyone can always check a proof, for free. The guided onboarding wizard also sponsors one demo anchor per account so you can land a first proof without topping up; every later robot anchor uses normal quota and gas credit.