Build on Note

Note is a permissionless structuring desk on Robinhood Chain. Other products embed it at one of three depths, and every depth pays the integrator through the same on-chain fee split. The Build on Note page gives the visual tour; this section is the reference.

Three ways in

Depth	What your product does	Contract calls	Status
Embed a vault	One ERC-4626 deposit. The vault allocates across in-band series, harvests coupons and fills redemptions at one share price	deposit, requestRedeem, claimRedeem, previewDeposit	live on testnet
Distribute notes	Surface live series and let users pick a COUPON or SHIELD leg; the desk fills at the discovered coupon	openSeriesOf, getSeries, depositCoupon, accruedCoupon, claim, redeem	live on testnet
Lend against legs	Wrap COUPON legs into ERC-20 collateral and post them to a Credit market	wrap, harvest, unwrap	live on testnet

What every depth has in common

• Nothing is self reported. Coupons, barriers, observations and fees are read from NoteCore and RollPolicy. Your interface renders what the contracts enforce.
• No custody. Deposits go to the protocol’s escrow or to a vault the depositor holds shares in. Your product never holds user funds.
• Bounded reads. Every list is paged (vaults(start, count), requestsOf(owner, start, count), openSeriesOf(underlying)), so a wallet can render positions without an indexer.
• One attribution field. Deposits into a vault carry a partnerId; fees earned on the deposits you bring are paid to your payee on every collection. See Economics.

The SDK

TypeScript integrations use @note-systems/sdk, a typed client over viem covering the vault depth end to end: discover, verify, quote, deposit with attribution, track, exit, create. Releases are tarballs served from note.systems/sdk/ with a published sha512, and npm pins the integrity in your lockfile.

npm install viem https://note.systems/sdk/note-systems-sdk-0.1.1.tgz

The SDK guide covers the client, the releases table the digests, and examples/partner-integration.ts inside the package walks the six steps against testnet.

Where to start

1. Read Economics to see what an integration earns and how the treasury share works.
2. Pick a depth and follow its guide. For the vault depth in TypeScript, install the SDK above and run the bundled example against testnet.
3. Run the checklist before you ship.

Addresses for every network are on the Addresses page; audits are listed under Security.