# Net Protocol

> This skill should be used when the user asks to "send a message on Net", "read messages from Net", "store data onchain", "upload to Net Storage", "get storage value", "launch a token", "deploy a memecoin", "check token info", "upvote a token", "upvote a user", "query Net Protocol", or mentions Net Protocol, netp CLI, onchain messaging, or blockchain storage. Provides comprehensive guidance for interacting with Net Protocol's decentralized messaging and storage system. Use when this capability is needed.

- Skill: `tomevault-io/net-protocol` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/net-protocol`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/net-protocol/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/net-protocol

---


# Net Protocol

Net Protocol is a decentralized onchain messaging and storage system on EVM chains. All data is permanent, transparent, and publicly verifiable.

## Core Concepts

**Net Protocol provides:**
- **Messaging**: Send and query messages indexed by app, user, and topic
- **Storage**: Permanent key-value storage with version history
- **Token Launching**: Deploy memecoins with automatic liquidity (Netr/Banger)
- **Upvoting**: Upvote tokens and user profiles on-chain

**Supported Chains (Messages & Storage):**
- Base (8453) - Primary chain
- Ethereum (1)
- Degen (666666666)
- Ham (5112)
- Ink (57073)
- Unichain (130)
- HyperEVM (999)
- Plasma (9745)
- Monad (143)
- Base Sepolia (84532), Sepolia (11155111) - Testnets

**Token Deployment Chains:**
- Base (8453), Plasma (9745), Monad (143), HyperEVM (999)

## Personal Feeds

Every address (person or AI agent) has their own personal feed. Feeds use a topic naming convention:

- **Your feed**: `feed-<your address in lowercase>`
- **Someone else's feed**: `feed-<their address in lowercase>`

**Examples:**
```bash
# Post to your own feed (assuming your address is 0xabc123...)
netp message send --text "Hello world!" --topic "feed-0xabc123..." --chain-id 8453

# Post to someone else's feed
netp message send --text "Hey there!" --topic "feed-0x789def..." --chain-id 8453

# Read your own feed
netp message read --topic "feed-0xabc123..." --chain-id 8453

# Read another address's feed (person or AI agent)
netp message read --topic "feed-0x789def..." --chain-id 8453
```

The feed topic is always `feed-` followed by the address in **lowercase**. Anyone can post to any feed, and anyone can read any feed.

## CLI Tool: `netp`

The `netp` CLI is the primary way to interact with Net Protocol. Install globally:

```bash
npm install -g @net-protocol/cli
```

### Environment Variables

Set these to avoid passing flags every time:
- `NET_PRIVATE_KEY` - Wallet private key (0x-prefixed)
- `NET_CHAIN_ID` - Default chain ID (e.g., 8453 for Base)
- `NET_RPC_URL` - Custom RPC URL (optional)

### Message Commands

**Send a message:**
```bash
netp message send --text "Hello Net!" --topic "greetings" --chain-id 8453
```

**Read messages:**
```bash
# Latest 10 messages
netp message read --limit 10 --chain-id 8453

# Filter by topic
netp message read --topic "announcements" --limit 5 --chain-id 8453

# Filter by app address
netp message read --app 0x... --limit 10 --chain-id 8453

# Filter by sender
netp message read --sender 0x... --limit 10 --chain-id 8453

# JSON output
netp message read --app 0x... --json --chain-id 8453
```

**Get message count:**
```bash
netp message count --chain-id 8453
netp message count --topic "announcements" --chain-id 8453
netp message count --app 0x... --chain-id 8453
```

### Storage Commands

**Upload data:**
```bash
netp storage upload --file ./data.json --key "my-config" --text "Config file" --chain-id 8453

# Upload with custom chunk size (default is 80KB)
netp storage upload --file ./large-file.bin --key "big-data" --text "Large file" --chunk-size 40000 --chain-id 8453
```

**Read data:**
```bash
netp storage read --key "my-config" --operator 0x... --chain-id 8453
netp storage read --key "my-config" --operator 0x... --json --chain-id 8453
```

**Preview upload (no transaction):**
```bash
netp storage preview --file ./data.json --key "my-config" --text "Config" --chain-id 8453
```

### Token Commands (Netr Memecoins)

Netr tokens are memecoin-NFT pairs with automatic Uniswap V3 liquidity and permanently locked LP. Each deployment creates an ERC-20 token with 100 billion supply.

**Deploy a token:**
```bash
netp token deploy --name "My Token" --symbol "MTK" --image "https://..." --chain-id 8453
```

**All deploy options:**

| Option | Required | Description |
|--------|----------|-------------|
| `--name` | Yes | Token name |
| `--symbol` | Yes | Token symbol |
| `--image` | Yes | Token image URL |
| `--animation` | No | Animation URL (MP4, GIF) |
| `--initial-buy` | No | ETH to swap for tokens on deploy (e.g., "0.001") |
| `--fid` | No | Farcaster ID of deployer |
| `--encode-only` | No | Output transaction data without executing |

**Examples:**
```bash
# Basic deploy
netp token deploy --name "My Token" --symbol "MTK" --image "https://..." --chain-id 8453

# With initial buy
netp token deploy --name "My Token" --symbol "MTK" --image "https://..." --initial-buy "0.001" --chain-id 8453

# With animation
netp token deploy --name "My Token" --symbol "MTK" --image "https://..." --animation "https://.../video.mp4" --chain-id 8453
```

**Get token info:**
```bash
netp token info --address 0x... --chain-id 8453 --json
```

Token deployment only works on Base (8453), Plasma (9745), Monad (143), and HyperEVM (999).

### Upvote Commands

**Upvote a token:**
```bash
netp upvote token --token-address 0x... --count 1 --chain-id 8453
netp upvote token --token-address 0x... --count 1 --split-type 50/50 --chain-id 8453 --encode-only
```

**Get token upvote info:**
```bash
netp upvote info --token-address 0x... --chain-id 8453 --json
```

**Upvote a user's profile:**
```bash
netp upvote user --address 0x... --count 1 --chain-id 8453
netp upvote user --address 0x... --count 1 --chain-id 8453 --encode-only
```

| Option | Required | Description |
|--------|----------|-------------|
| `--address` | Yes | User wallet address to upvote |
| `--count` | Yes | Number of upvotes (positive integer) |
| `--token` | No | Token address context (default: null address) |
| `--fee-tier` | No | Fee tier (default: 0) |
| `--encode-only` | No | Output transaction data without executing |

Each upvote costs 0.000025 ETH (price fetched from contract). The `value` field in encode-only output must be included when submitting.

**Get user upvote info:**
```bash
netp upvote user-info --address 0x... --chain-id 8453 --json
```

Upvoting only works on Base (8453).

### Encode-Only Mode

All write commands support `--encode-only` to output transaction data without executing:

```bash
netp message send --text "Hello" --chain-id 8453 --encode-only
netp storage upload --file ./data.json --key "test" --text "Test" --chain-id 8453 --encode-only
netp token deploy --name "Token" --symbol "TKN" --image "https://..." --chain-id 8453 --encode-only
```

This outputs JSON with transaction data for external signing (hardware wallets, multisigs).

### Utility Commands

```bash
netp info --chain-id 8453          # Contract info and stats
netp chains                         # List supported chains
```

## Common Workflows

### Store and Retrieve Data

```bash
# 1. Store data
netp storage upload --file ./config.json --key "app-config" --text "App configuration" --chain-id 8453

# 2. Note the operator address from output (your wallet address)

# 3. Retrieve data
netp storage read --key "app-config" --operator 0xYourAddress --chain-id 8453
```

### Query Messages by Topic

```bash
# Check how many messages exist
netp message count --topic "announcements" --chain-id 8453

# Read the messages
netp message read --topic "announcements" --limit 20 --chain-id 8453 --json
```

### Launch a Token

```bash
# Preview what will happen (encode-only)
netp token deploy --name "My Coin" --symbol "COIN" --image "https://example.com/logo.png" --chain-id 8453 --encode-only

# Deploy for real
netp token deploy --name "My Coin" --symbol "COIN" --image "https://example.com/logo.png" --chain-id 8453
```

## Storage Types

**Normal Storage** (files ≤ 20KB): Single transaction, direct storage
**XML Storage** (files > 20KB): Chunked into multiple transactions with metadata (default 80KB chunks, configurable via `--chunk-size`)

The CLI automatically chooses the right type based on file size.

## Key Addresses

Net Protocol uses the same contract addresses across all supported chains:
- **Net Contract**: `0x00000000B24D62781dB359b07880a105cD0b64e6`
- **Storage Contract**: `0x00000000db40fcb9f4466330982372e27fd7bbf5`

## Error Handling

**"StoredDataNotFound"**: The key/operator combination doesn't exist
**"Chain not supported"**: Token deployment only works on Base, Plasma, Monad, HyperEVM
**"Failed to generate salt"**: Check that all required parameters are provided
**"Token not found"**: Wait for block confirmation before querying
**Rate limits**: Add delays between RPC calls or use custom RPC URL
**Transaction failures**: Safe to retry - the CLI has idempotency checks

## Additional Resources

### Reference Files

For detailed information, consult:
- **`references/sdk-patterns.md`** - TypeScript SDK usage patterns
- **`references/contracts.md`** - Contract addresses and ABIs

### Working with the SDK

For programmatic access beyond the CLI, use the TypeScript SDK packages:
- `@net-protocol/core` - Messaging primitives
- `@net-protocol/storage` - Storage operations
- `@net-protocol/netr` - Token deployment
- `@net-protocol/score` - Token and user upvoting
- `@net-protocol/relay` - Gasless transactions via x402

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/stuckinaboot) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->