Developers

Composed from
open contracts.

Stock Cards is glue, not a new primitive. A Safe vault holds your assets, a Zodiac guard cages the agent, an on-chain lending market provides liquidity, and Gnosis Pay turns the balance into a Visa card. Every hop is inspectable.

01 — Architecture

Four components, one flow.

Nothing here is bespoke custody or a black-box balance. The value moves through well-known contracts in a fixed direction.

Safe vault — smart-account that holds Stock Tokens + dollars; owner = you
Zodiac Roles + Delay — permission module; grants the agent a narrow, timelocked role
Lending market — supplies liquidity against your collateral at a live rate
Card account (Gnosis Pay) — receives top-ups and settles Visa authorizations

02 — The top-up flow

What happens when the buffer runs low.

The agent watches the card buffer. When it drops under target and the live rate is under your ceiling, it executes one bounded transaction — and never touches an external address.

// agent (off-chain) → guard (on-chain), one bounded call function topUpCard(uint256 amount) external onlyAgent { require(amount <= buffer(), "OVER_BUFFER"); require(rate() <= userCeiling, "RATE_TOO_HIGH"); lending.borrow(marketParams, amount, cardAccount); // → card, not a wallet } // external transfers are structurally impossible function withdrawTo(address) external pure { revert Forbidden(); }

Repayment runs the same way in reverse when a merchant hold is released — the loan shrinks, nothing is sold.

03 — Guard interface

The role the agent is allowed to play.

The Zodiac Roles module encodes an allow-list of targets and selectors. The agent's key can only call what the role permits; a Delay module timelocks any change to that role.

// Roles allow-list (illustrative) role.allow(LENDING, borrow.selector); // draw liquidity role.allow(LENDING, repay.selector); // repay from holds role.allow(CARD, fund.selector); // top up the card // everything else → not on the list → reverts delay.setTxCooldown(48 hours); // changes are timelocked

04 — Integrate

Building on the same rails.

The vault, guard, and market are standard contracts — if you build on-chain, you already know most of this stack. Full SDK, ABIs, and deployed addresses ship at launch.

Contract addresses & ABIs — see Transparency
Read the guard config directly from any explorer
SDK (TypeScript) for reading buffer, rate, and backing — coming at launch
Webhooks for card authorizations & agent events — coming at launch

See the live parameters.