Net Public SDK
Public TypeScript SDK packages for the Net Protocol. Provides React hooks and client classes for interacting with Net smart contracts and storage systems.
What is Net Protocol?
Net Protocol is a decentralized onchain messaging system that stores all data permanently on the blockchain. Think of it as a public bulletin board where:
- Anyone can post (permissionless)
- Posts are permanent (immutable blockchain storage)
- Everything is transparent (publicly verifiable)
- Works across multiple chains (same contract address everywhere)
Net uses sophisticated multi-dimensional indexing, allowing you to query messages by:
- App: All messages from a specific application contract
- User: Messages from a specific user address
- Topic: Messages with a specific category/topic
- Combinations: App + User + Topic for precise queries
This SDK provides TypeScript/React tools to interact with Net Protocol and build applications on top of it.
Documentation
For complete Net Protocol documentation, visit docs.netprotocol.app.
Package Status
Packages
Core messaging primitives - Read and write Net Protocol messages. This is the foundation for everything else.
What you can do:
- Query messages by app, user, topic, or combinations
- Get message counts
- Send messages via app contracts
- Build custom applications on Net Protocol
Onchain key-value storage - Store data permanently on the blockchain with complete version history.
What you can do:
- Store small data (< 20KB) with Regular Storage
- Store medium files (20KB-80KB) with Chunked Storage
- Store large files (multi-MB) with XML Storage pattern
- Access complete version history of all changes
- Build applications that need permanent, verifiable data storage
Transaction relay service - Submit on-chain transactions without holding ETH by paying with USDC via x402.
What you can do:
- Submit transactions via relay service (backend wallet pays gas)
- Fund backend wallets via x402 payments (USDC)
- Batch transactions automatically to respect API limits
- Retry failed transactions with exponential backoff
- Create session tokens for authenticated batch requests
- Check backend wallet balance before submitting
- Wait for transaction confirmations on-chain
- Build applications that allow users to interact without ETH
On-chain user profiles - Read and write user profile data on Net Protocol.
What you can do:
- Read profile data: profile picture, X username, bio, display name, token address, canvas
- Write profile data with utilities to prepare Storage.put() transactions
- Batch-read multiple profile fields efficiently
- Build applications with decentralized user identity
Decentralized NFT marketplace - Buy, sell, and trade NFTs via Seaport on Net Protocol.
What you can do:
