Skip to content
Docs

Security

Security model

Who can change what, what nobody can change, and which outside contracts Fillmark depends on.

Client funds

USDG and assets stay in the client's own account, and only the owner wallet can move them out. The router can only swap the account's tokens for an allowed asset in a Uniswap v3 pool, within the client's limits, with the output paid back to the same account. No Fillmark key, the Safe and the guardian included, can withdraw from a client account or change its limits.

What can change, and how

The router has no owner and no upgrade path: its rules, and the addresses it reads (the price feeds contract, the ERC-8004 registries, the Uniswap v3 factory and USDG), are fixed in its code.

FillmarkFeeds is add-only. Through the timelock, with at least 2 days' notice, the Safe can add new assets with their feeds, future US market session periods, and market closures. Nothing already added can be changed or removed, so a feed or a max age set for an asset stays as it is.

The Safe can also add a market closure of any length, with the same 2 days' notice. A closure stops trading in stock tokens for as long as it lasts.

A pending change is public on chain for the whole delay, so anyone can see it before it takes effect, and a client who disagrees has 2 days to remove the permission or withdraw.

Outside contracts

Some contracts the router reads are run by others and can be upgraded by their owners: the ERC-8004 Identity and Reputation Registries, USDG, the stock tokens and the Chainlink feeds. An upgrade there could stop fills or change what is recorded. It cannot change which agent wallet a client's permission accepts, because the router stores that wallet itself.

The guardian

One key, the guardian (0x534e…cBc3), can stop trading at once, without the timelock, for an unscheduled market closure or a price feed failure. It can only add stock market closures and crypto halts. Each one must start within the hour, and together they may cover at most 3 days in each fixed 30-day window, so at most 6 days in a row across two windows. A stop only blocks fills; it cannot move funds or change limits.

Price feed age

Each fill is compared with the asset's Chainlink price feed. If the latest answer is older than the asset's max age, the router rejects the fill. Feeds that update through the day have a short limit; feeds that only update on their daily heartbeat have the heartbeat plus a margin.

6 hours
AAPL, AMD, AMZN, ASML, BABA, COIN, CRCL, DELL, GLD, GME, GOOGL, INTC, META, MSFT, MSTR, MU, NVDA, PLTR, QQQ, SLV, SNDK, SPCX, SPY, TSLA, TSM, USAR, USO
25 hours
SGOV, cbBTC, WETH

Stock fills are also rejected while the stock token reports its own oracle as paused, and right after a change of the token's multiplier until the feed has priced it.

Audit status

The contracts have not been audited by an outside firm. They are open source, verified, and tested against the live Robinhood Chain contracts on a fork. A bug could still stop trading or lose funds. Read the risks and terms of use before using Fillmark.

Loading the search index…