net-protocol

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.

• Getting Started Guide
• How Net Works
• Smart Contract Reference

Package Status

Package	Status	Description
@net-protocol/core	Alpha	Usable but may have breaking changes over time
@net-protocol/storage	Alpha	Usable but may have breaking changes over time
@net-protocol/cli	Alpha	Usable but may have breaking changes over time
@net-protocol/netr	Alpha	Usable but may have breaking changes over time
@net-protocol/profiles	Alpha	Usable but may have breaking changes over time
@net-protocol/bazaar	In Development	Do not use yet. Will have breaking changes
@net-protocol/relay	In Development	Do not use yet. Will have breaking changes
@net-protocol/feeds	In Development	Do not use yet. Will have breaking changes
@net-protocol/score	In Development	Do not use yet. Will have breaking changes

Packages

@net-protocol/core

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

@net-protocol/storage

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

@net-protocol/relay

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

@net-protocol/profiles

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

@net-protocol/bazaar

Decentralized NFT marketplace - Buy, sell, and trade NFTs via Seaport on Net Protocol.

What you can do: