@net-protocol/bazaar

Status: In Development - This package is under active development. APIs may change without notice.

SDK for Net Bazaar - a decentralized bazaar storing all orders onchain via Seaport.

What is Net Bazaar?

Net Bazaar is a decentralized bazaar built on Net Protocol. All orders are stored onchain. It uses Seaport for order execution and Net Protocol for order storage and indexing.

Key features:
- NFT Listings: Buy and sell NFTs with native currency
- Collection Offers: Make offers on any NFT in a collection
- ERC20 Offers: Make offers to buy ERC20 tokens (Base and HyperEVM only)

What can you do with this package?

- Read listings: Get valid NFT listings for a collection
- Read collection offers: Get valid offers for any NFT in a collection
- Read ERC20 offers: Get valid offers for ERC20 tokens
- Cancel orders: Prepare transactions to cancel your listings or offers
- Create listings: Prepare and sign Seaport orders for NFT listings
- Create offers: Prepare and sign collection offers
- Fulfill orders: Buy listings or accept offers
- Query ownership: Check which tokens an address owns on-chain

This package provides both React hooks (for UI) and a client class (for non-React code).

Installation

``bash
npm install @net-protocol/bazaar @net-protocol/core viem


or

For React hooks, also install:
`bash
npm install react wagmi @tanstack/react-query
`

Usage

$3

`typescript
import { useBazaarListings, useBazaarCollectionOffers, useBazaarErc20Offers } from "@net-protocol/bazaar/react";

// Get NFT listings for a collection
function ListingsComponent() {
const { listings, isLoading, error } = useBazaarListings({
chainId: 8453,
nftAddress: "0x...",
});

if (isLoading) return

`typescript
import { BazaarClient } from "@net-protocol/bazaar";

const client = new BazaarClient({ chainId: 8453 });

// Get listings
const listings = await client.getListings({
nftAddress: "0x...",
});

// Get collection offers
const collectionOffers = await client.getCollectionOffers({
nftAddress: "0x...",
});

// Get ERC20 offers (Base and HyperEVM only)
const erc20Offers = await client.getErc20Offers({
tokenAddress: "0x...",
});

// Cancel a listing
const cancelTx = client.prepareCancelListing(listing);
// Use with wagmi's useWriteContract or viem's writeContract

// Create a listing (prepare EIP-712 data + approvals)
const prepared = await client.prepareCreateListing({
nftAddress: "0x...",
tokenId: "42",
priceWei: 100000000000000n, // 0.0001 ETH
offerer: "0x...",
});
// prepared.eip712 contains the typed data to sign
// prepared.approvals contains approval txs to send first

// Submit a signed listing on-chain
const submitTx = client.prepareSubmitListing(
prepared.eip712.orderParameters,
prepared.eip712.counter,
signature
);

// Fulfill a listing (buy an NFT)
const fulfillment = await client.prepareFulfillListing(listing, buyerAddress);
// fulfillment.approvals + fulfillment.fulfillment contain the txs

// Fulfill a collection offer (sell your NFT)
const offerFulfillment = await client.prepareFulfillCollectionOffer(offer, tokenId, sellerAddress);

// Get token IDs owned by an address
const tokenIds = await client.getOwnedTokens({
nftAddress: "0x...",
ownerAddress: "0x...",
startTokenId: 0n,
endTokenId: 10000n,
});

// Get recent sales
const sales = await client.getSales({ nftAddress: "0x..." });
`

API Reference

$3

`typescript
interface Listing {
maker: 0x${string};
nftAddress: 0x${string};
tokenId: string;
priceWei: bigint;
price: number;
currency: string;
expirationDate: number;
orderHash: string;
orderStatus: SeaportOrderStatus;
messageData: 0x${string};
orderComponents?: SeaportOrderComponents;
}

interface CollectionOffer {
maker: 0x${string};
nftAddress: 0x${string};
priceWei: bigint;
price: number;
currency: string;
expirationDate: number;
orderHash: string;
orderStatus: SeaportOrderStatus;
messageData: 0x${string};
orderComponents?: SeaportOrderComponents;
}

interface Erc20Offer {
maker: 0x${string};
tokenAddress: 0x${string};
tokenAmount: bigint;
priceWei: bigint;
pricePerTokenWei: bigint;
price: number;
pricePerToken: number;
currency: string;
expirationDate: number;
orderHash: 0x${string};
orderStatus: SeaportOrderStatus;
messageData: 0x${string};
orderComponents?: SeaportOrderComponents;
}
``

$3

All returned listings and offers are automatically validated:
- Order status is OPEN (not filled, cancelled, or expired)
- Not expired
- For listings: seller still owns the NFT
- For offers: buyer has sufficient WETH balance

$3

- Listings: Sorted by price (lowest first), deduplicated per token
- Collection offers: Sorted by price (highest first)
- ERC20 offers: Sorted by price per token (highest first)

Supported Chains

| Chain | Listings | Collection Offers | ERC20 Offers |
|-------|----------|-------------------|--------------|
| Base (8453) | Yes | Yes | Yes |
| Base Sepolia (84532) | Yes | Yes | No |
| Degen (666666666) | Yes | Yes | No |
| Ham (5112) | Yes | Yes | No |
| Ink (57073) | Yes | Yes | No |
| Unichain (130) | Yes | Yes | No |
| HyperEVM (999) | Yes | Yes | Yes |
| Plasma (9745) | Yes | Yes | No |
| Monad (143) | Yes | Yes | No |

License

MIT