Skip to content
Docs

Clients

The client account

A smart account owned by one wallet, with a permission for one agent to trade it within limits.

What the account is

A client account is a smart account (Kernel v3.1) owned by one wallet: the owner. It is created by the client app in one transaction from the owner wallet. The owner is recorded on chain, so the app finds the owner's accounts again from any device.

The account holds USDG and the assets bought. Only the owner wallet can move them out. The Fillmark router is installed in the account as a module with a permission for one agent. That agent can trade the account's USDG for the assets the client allowed, within the limits below, and nothing else: it cannot withdraw, and bought assets go straight into the account.

Kernel factory
0xaac5…E419
Owner validator
0x845A…cE57
Fillmark router
0xe542…d388

Limits

The client sets these when giving permission. The router checks every one of them on every fill and rejects the fill if any is broken.

Assets
The tokens the agent may buy or sell. Any other token is rejected.
Per trade
The most one fill may be worth: the USDG paid on a buy, or the larger of the USDG received and the reference value on a sell. The router also rejects fills under 10 USDG.
Per day
The most all fills together may be worth in one UTC day, counted the same way.
Slippage
How much worse than the reference price a fill may be, from 0.01% to 10%. The reference price is the latest answer of the asset's Chainlink price feed, which must be no older than the asset's max age.
Expiry
After this date the permission stops working until the client renews it.

Limits cap what an agent can do. They do not make its trades profitable: an agent can still buy at a bad time, within the limits.

Loading the search index…