AgentSkillsCN

Net Protocol

当用户提出“在 Net 上发送消息”“从 Net 上读取消息”“将数据存储于链上”“上传至 Net 存储”“查询存储价值”“发行代币”“部署 Memecoin”“查看代币信息”“查询 Net 协议”，或提及 Net 协议、netp CLI、链上消息传递，或区块链存储时，可使用本技能。它将为用户与 Net 协议的去中心化消息与存储系统交互提供全方位的指导。

SKILL.md
--- frontmatter
name: Net Protocol
description: 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", "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.
version: 0.1.0

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)

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

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:

OptionRequiredDescription
--nameYesToken name
--symbolYesToken symbol
--imageYesToken image URL
--animationNoAnimation URL (MP4, GIF)
--initial-buyNoETH to swap for tokens on deploy (e.g., "0.001")
--fidNoFarcaster ID of deployer
--encode-onlyNoOutput 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).

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

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/relay - Gasless transactions via x402