Security

Who can
move what.

The keys, the contracts, what you sign, and the limits. Written to be checked, not trusted.

The short version

  • Your agent's money sits in a contract that only the owner address can withdraw from. Zero Lux cannot send it to an address of our choosing.
  • Zero Lux's billing key can charge a wallet up to its daily limit, and charges go to our fee contract. The contract cannot tell a real run from a made-up one, so a stolen or dishonest billing key could move money sitting in a wallet into the fee contract, one daily limit per day. The owner sets that limit and can lower it or withdraw at any time. See Known limits.
  • A customer signs one payment for one exact amount to one wallet. It is not an open-ended approval.
  • The contracts are public and source-verified. No outside firm has audited them.
  • Zero Lux never asks for a seed phrase, a private key or a password. There are no accounts.

Who can do what

WhoCanCannot
The agent's ownerWithdraw earnings, set spending limits, pause the agent, pledge profit, hand the wallet to a new owner.Cancel a pledge, or withdraw money held for a run that has not been billed.
Zero Lux's billing keyTake a customer's signed payment into the agent's wallet, and charge the wallet for a run, up to the amount held for that run and the daily limit.Send a wallet's money anywhere except the fee contract, change its owner, charge more than the limits allow, or charge a paused wallet for new runs.
Zero Lux's factory keyReplace the billing key at once on wallet versions 1 and 2 (a two-day wait on version 3), set the fee rate for agents made in future (never above 50%), and change the fee contract after a two-day wait.Withdraw from any agent's wallet, change its owner, or raise the fee on an existing agent without that owner's agreement.
AnyoneRead every agent's books, send a pledged share to the person it is pledged to, and release a hold left open for more than a day.Move an agent's money anywhere except where the contract already owes it.

The factory key is a single key today. Moving it to shared control is on the roadmap.

What a customer signs

To hire an agent you sign one USDG transfer authorisation (the EIP-3009 standard). Read it in your wallet before you sign. It should show:

  • The exact price of the agent, in USDG, and nothing more.
  • The agent's wallet contract as the receiver. The same address is on the agent's page and in its identity card.
  • An expiry a few minutes away, never more than 15.

It cannot be used twice, for a different amount, or to a different address. You are never asked to approve spending, connect a new network you did not expect, or send gas.

To confirm a wallet really is a Zero Lux agent, call isAgentWallet(address) on the factory.

What an agent can reach

  • An agent can read public web pages over HTTPS. It cannot reach private or internal addresses, and redirects are checked the same way.
  • An agent can read Robinhood Chain: balances, tokens, read-only contract calls and transactions. It cannot send a transaction.
  • An agent has no keys. It cannot move money, sign anything, or change anything on chain. Billing is done by a separate service.
  • Web pages and chain data reach the agent as material to work on, marked off from its instructions, and an agent cannot save notes in a run that has read outside content. This lowers the risk of a page hijacking an agent; it does not remove it.
  • An agent's notes are kept per customer. One customer's notes are not shown to another customer's run.
  • What you send an agent is processed by an AI model. Do not send secrets, keys or anything you would not put in an email to a stranger.

Contracts

Source-verified on Robinhood Chain (chain id 4663) and public on XGitHub.

Factory0xd2c83835f26Da34059e2156FD725F436444D224A
Wallet code0x07f8EB55E74Dd6773B5139A247024e05236c39c4
Every agent's wallet runs this code.
Fee contract0xd6c53788C600fB99051417ab72E07E42eE5112C7
First factory0xc9C8b726e73c78eb688e19f0b686CbBDE9F0985B
Retired. New agents are no longer made on it.

Testing and review

  • The contracts have more than 170 automated tests, including tests run against a copy of the live chain and stress tests that fire tens of thousands of random actions at a wallet and check its books after each one.
  • Those stress tests confirmed that a run is never charged twice or beyond its hold, that an owner can never withdraw held or pledged money, and that a pledge never pays more than its limit. They also found the pledge gap listed under known limits.
  • The contracts and the billing service went through repeated rounds of adversarial review before they were deployed, and the problems found were fixed and retested.
  • None of that is an outside audit. No audit firm has examined this code. An audit is on the roadmap.

Known limits

  • Run costs are reported by Zero Lux. The contract caps them, but inside the cap the figure comes from our billing service. Every run has a public receipt so the charge can be recomputed.
  • Income can be inflated. An owner can pay their own agent. Payments from the owner, a pledge holder and our own test wallets are shown separately, but a fresh wallet looks like an outside customer.
  • The work happens off chain. The chain proves what was paid and charged, not that an answer was right.
  • No refunds. A payment that is not collected within 15 minutes, or whose three tries all fail, stays with the agent.
  • If the service is down, agents do not run. Owners can still withdraw, because that needs only the contract.
  • The code that runs agents is public, in the same repository as the contracts, and each agent's instructions are fingerprinted on chain. Today only Zero Lux's billing key can charge a wallet, so agents cannot yet be run by anyone else.
  • Our billing key can eat into a pledge. Stress tests found that if the billing key sets a run's cost aside against money already in a wallet, instead of against a new payment, that cost can come out of money owed to a pledge holder. The billing key can also mark profit as final early. An owner cannot do either; it takes our key. Both are being closed in wallet version 3. No agent has a pledge today.
  • Our billing key can charge money that is sitting in a wallet. A charge needs a hold, and the billing key can open a hold against any money in a wallet that is not already promised, not only against a new payment. It can then charge that hold to our fee contract, which Zero Lux can withdraw from. The contract limits this to the wallet's daily limit (two limits across midnight UTC) and to one run's limit per hold; it does not check that a run happened. Every such charge is a public Opened and Charged event with no matching payment. This is how billing works on every wallet version, and all agents live today are version 2, where the factory key can also replace the billing key at once. Version 3 adds a two-day wait on replacing the key and a stop switch, both still held by the same single key today. What an owner can do: withdraw earnings often, keep the daily limit near what the agent really spends, or pause the wallet, which blocks new holds.
  • One key controls the factory, with the powers listed above.
  • USDG and Robinhood Chain are operated by other parties.

Report a problem

Found something that could put money at risk? Please report it privately first: on the GitHub repository, open the Security tab and choose "Report a vulnerability". Only the maintainers can read it.

For ordinary bugs, open an issue.