Contract reference

QUIVER is one contract on Robinhood Chain (id 4663), at 0x2866D49f364a70383591a958354A89F6BDf050f2 ↗. It is an ERC721Enumerable, so the full ERC-721 surface is available alongside the streaming functions.

What getStreamreturns. Timestamps are absolute Unix seconds. Amounts are in the streamed token's own decimals.

sender address

Who funded the stream. Set at creation, never changes.

start uint40

When accrual begins.

cliff uint40

Nothing withdrawable before this. Equal to start means no cliff.

cancelable bool

Whether the sender can still cancel. Only ever goes true to false.

canceled bool

Whether it has been cancelled.

token address

The ERC-20 being streamed.

end uint40

When fully vested. Reset to the cancellation instant if cancelled.

deposited uint128

What the contract actually received, which is what the stream promises. Reduced to the vested amount on cancellation, so it is not a record of the original grant.

withdrawn uint128

How much has been taken out so far.

QUIVER is a standard ERC721Enumerable. Everything below behaves exactly as the standard says, which is the entire point: a stream is tradable because it needs no special handling.

ownerOf(uint256 tokenId) view returns (address)

The current recipient. The only address that can withdraw, aside from operators they approved.

balanceOf(address owner) view returns (uint256)

How many streams an address holds.

tokenURI(uint256 id) view returns (string)

The stream card, as a data URI built on-chain at read time. Returns an empty string if no descriptor is set. Reverts ERC721NonexistentToken for an unminted id.

approve(address to, uint256 tokenId)

Approve one address for one stream. Cleared on transfer.

getApproved(uint256 tokenId) view returns (address)

Who is approved for this stream.

setApprovalForAll(address operator, bool approved)

Approve an operator for every stream you hold, now and later.

isApprovedForAll(address owner, address operator) view returns (bool)

Whether an operator is approved for all of an owner's streams.

transferFrom(address from, address to, uint256 tokenId)

Move a stream. Does not check the receiver can hold NFTs.

safeTransferFrom(address from, address to, uint256 tokenId)

Move a stream, checking the receiver accepts ERC-721. Prefer this.

safeTransferFrom(address from, address to, uint256 tokenId, bytes data)

Same, with a data payload passed to the receiver hook.

totalSupply() view returns (uint256)

How many streams exist in total.

tokenByIndex(uint256 index) view returns (uint256)

Enumerate all streams globally.

tokenOfOwnerByIndex(address owner, uint256 index) view returns (uint256)

Enumerate one holder's streams. What `streamsOfHolder` loops over.

supportsInterface(bytes4 interfaceId) view returns (bool)

ERC-165. True for ERC721, ERC721Enumerable and ERC721Metadata.

name() view returns (string)

The collection name.

symbol() view returns (string)

The collection symbol.

nextId() view returns (uint256)

The id the next stream will get. Starts at 1, so it is also one more than the number of streams ever created.

creationFee() view returns (uint256)

The fee, in wei, charged on the next creation. Read this rather than hardcoding it.

MAX_CREATION_FEE() view returns (uint256)

The hard cap on the fee. A compile-time constant, so nothing can raise it.

accruedFees() view returns (uint256)

Creation fees held by the contract, waiting to be swept. Accounted separately from escrowed stream tokens.

treasury() view returns (address)

Where `sweepFees` sends the accrued fees.

descriptor() view returns (IQuiverDescriptor)

The renderer that draws the stream card. Can change how a stream looks, never what it pays.

owner() view returns (address)

The protocol owner. Their reach is the fee, the treasury and the descriptor. Nothing else.

The complete owner surface. There is no admin withdraw, no pause, no upgrade, and no way for the owner to cancel a stream or touch an escrowed token.

Everything the contract emits, generated from the ABI. Streams can be reconstructed from these alone if you would rather index than poll.

Approval(address indexed owner, address indexed approved, uint256 indexed tokenId)

Standard ERC-721 single-token approval.

ApprovalForAll(address indexed owner, address indexed operator, bool approved)

Standard ERC-721 operator approval.

CancelRenounced(uint256 indexed id)

The sender permanently gave up the right to cancel this stream.

CreationFeeSet(uint256 fee)

The owner changed the fee for future creations. Existing streams are unaffected.

DescriptorSet(address descriptor)

The owner swapped the card renderer.

FeesSwept(address indexed to, uint256 amount)

Accrued creation fees were sent to the treasury.

OwnershipTransferred(address indexed previousOwner, address indexed newOwner)

Standard Ownable. Emitted at deployment and on every ownership change.

StreamCanceled(uint256 indexed id, address indexed sender, uint128 refunded, uint128 vested)

A stream was stopped. `refunded` went back to the sender, `vested` stays owed to the holder.

StreamCreated(uint256 indexed id, address indexed sender, address indexed recipient, address token, uint128 amount, uint40 start, uint40 cliff, uint40 end, bool cancelable)

A stream was funded and its NFT minted. `amount` is the net amount received, which can be below the amount requested for a fee-on-transfer token.

Transfer(address indexed from, address indexed to, uint256 indexed tokenId)

Standard ERC-721. A stream changed hands, which changes who can withdraw. Minting shows as a transfer from the zero address.

TreasurySet(address treasury)

The owner changed where swept fees go.

Withdrawn(uint256 indexed id, address indexed to, uint128 amount)

Tokens were taken out of a stream, to the `to` address the caller chose.

QUIVER reverts with custom errors, never with strings. The selector is the first four bytes of the revert data, which is what you match on when decoding a failure.