Xquity docs

Get paid on X, in real stock. On BNB Chain.

What is Xquity

Xquity lets anyone be paid to their X handle in tokenized stock. You pair a handle to a stock, value that gets routed to you accrues on chain, and you claim it into your own wallet by proving the handle with X sign in. The payout is a real tokenized equity, an xStock BEP-20 token on BNB Chain, backed one to one by the underlying share.

How it works

Three moves, then it just accrues:

Pair your X handle to the stock you want to be paid in.
Value routes in. Tips, fees, or backers pay your handle, converted to your stock, with a public receipt each time.
Claim. Sign in with X to prove the handle, connect a wallet, and sweep the stock into it.

Pairing

A pairing points a handle at one stock token. Anyone can set the pairing for a handle, since it only tells routers what to convert into. The handle still controls the funds, because only an X verified wallet can ever claim them.

pair(bytes32 handleHash, address stock)

The handle is stored as keccak256(lowercased handle), never the raw string.

Routing

Routing is the act of paying a handle. A router, a tipper, or a backer converts value into the stock token off chain or through a swap, then calls route. The amount accrues to the handle net of a small protocol fee, and a public Routed receipt is emitted.

route(bytes32 handleHash, address stock, uint256 amount)

Claiming

To claim, you sign in with X. Our signer confirms the wallet you name belongs to the handle that owns the balance, and signs a single use authorization bound to the current per handle nonce. The vault then releases the full balance to that wallet. Anyone can relay the transaction, the funds only ever go to the signed wallet.

claim(bytes32 handleHash, address stock, address to, uint256 deadline, bytes sig)

The contract

One contract, Xquity.sol, holds every balance. It has no function that lets an admin move funds. The only ways a stock leaves the vault are a claim to the signed wallet, and there is no other path out. The signer can be rotated by the owner, and nothing else.

Protocol fee is capped at 5 percent, set at deploy, immutable.
Per handle nonce makes every claim authorization single use.
Balances are read openly with owed(handleHash, stock) and totalPaidOut.

Trust and safety

The backend signer is trusted to answer one question honestly, did the person holding this wallet just sign in as this handle. It never custodies or moves funds. The vault is the only thing that holds stock, and it releases only to a signed wallet. Self custody, always.

FAQ

Do I need a wallet to receive? No. Value is addressed to your handle, so people can pay you before you ever connect one. You connect a wallet only when you claim.

What stocks can I be paid in? Any xStock on BNB Chain, 60 plus tokenized US equities and ETFs including Apple, Nvidia, the S and P.

What if a handle is never claimed? The balance sits in the vault until that handle is verified and claims it. Nobody else can take it.