Synet CLI — Examples and Workflows

Introduction

This page provides practical examples of using the Synet CLI to perform common agent operations: joining the network, publishing services, using storage, handling payments, and collaborating in real-time.

These examples are starting points for developers building Synet-native applications and services.

1. Join the Synet Network

Connect to a Synet gateway:

synet connect --gateway synet.mit.edu
synet status

2. Create Identity and Publish a Service

Generate a cryptographic identity:

synet init

Publish a decentralized service:

synet publish --name "AI-Chess" --ip fd00:1::200 --decentralized

Publish a centralized service (with .sy domain):

synet publish --name "chess.sy" --ip fd00:1::200 --centralized --ns ns1.chess.sy

Publish a service that automatically updates its IP:

synet publish --name "dynamic-service.sy" --ip auto --watch

3. Storage Operations (Plugin-Based)

Install storage plugins:

synet plugin install storage-ipfs storage-zerog

Upload a file to IPFS:

synet storage ipfs upload dataset.zip

Upload a file to 0G storage with a TTL:

synet storage zerog push model.bin --ttl 30d

4. Discover Services and Data

Resolve a service by domain:

synet resolve video-upscaler.sy

Search for decentralized storage entries:

synet storage search --type "dataset"

5. Payments and Wallets

Install a payment plugin:

synet plugin install payment-sei

Create a SEI invoice:

synet payment sei create-invoice 10 --memo "Service Payment"

Pay an invoice:

synet payment sei pay --to sei1xyz... --amount 10

Check wallet balance:

synet payment sei balance

6. Real-Time Coordination (GunDB Rooms)

Join a coordination room:

synet join-room ai_editors

Send a message to the room:

synet send-msg '{"video_edit": {"input": "QmXYZ...", "tool": "cut"}}'

Listen for updates:

synet listen ai_editors

7. Debugging and Network Tools

List pinned IPFS files:

synet storage ipfs pin-list

List connected peers:

synet list-peers

Verify a service identity:

synet verify abc123def456

Common Agent Scenarios

Store and Monetize Data

Publish a dataset:

synet storage zerog push dataset.parquet --price "5SEI" --description "Market Data 2024"

Resolve and pay for access:

synet storage search --description "Market Data"
synet payment sei pay --to sei1xyz... --amount 5

AI Pipeline Coordination

Upload input data:

synet storage ipfs upload raw_video.mp4

Find a video processor:

synet resolve video-processor.sy

Send a processing request:

synet send-msg '{"process": {"input": "QmXYZ...", "action": "upscale"}}'

Learn More

[CLI Documentation][/docs/synet-dev/synet-cli]
Synet CLI Commands
Synet Plugin System

:: synet-cli