Synet CLI — Payments and Wallets

Overview

The Synet CLI offers a plugin-based architecture for blockchain payments and wallet operations.

Each supported blockchain (e.g., SEI, IOTA) is managed through a unified Payment + Wallet Plugin, simplifying both usage and development.

This design ensures agents and services can transact efficiently without bloating the core CLI.

Core Concepts

Concept	Description
Unified Plugin	Each blockchain plugin (e.g., `payment-sei`) handles invoices, deposits, balance checks, and payments.
Standardized Invoices	Cross-chain compatible invoice format for seamless integration.
Non-Custodial Wallets	Users fully control their private keys.
External Exchanges	Fiat onboarding handled off-chain (no exchange built-in).

Core Commands

Command	Description
`synet plugin install payment-sei`	Install SEI payment and wallet plugin.
`synet payment sei create-invoice <amount>`	Create an invoice to receive payment.
`synet payment sei deposit`	Show deposit address for receiving funds.
`synet payment sei balance`	Check on-chain balance.
`synet payment sei pay --to <addr> --amount <amt>`	Send funds to another address.
`synet payment sei track --invoice <id>`	Monitor invoice payment status.

Payment Workflow

Agent A (Service Provider)

synet payment sei create-invoice 10 --memo "Service Payment"
# Outputs: Invoice address and amount

Share invoice with client.
Track payment:

synet payment sei track --invoice sei1xyz...

Agent B (Client)

synet payment sei deposit
# Displays your personal deposit address.

Deposit funds via an external exchange if necessary.
Pay the service provider:

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

Invoice Format Example

{
  "network": "sei",
  "amount": 10,
  "address": "sei1xyz...",
  "memo": "Service Payment",
  "expiry": 3600
}

Network: Blockchain name.
Amount: Payment amount.
Address: Service provider’s receiving address.
Memo: Purpose of payment.
Expiry: Invoice validity in seconds (optional).

Example Full Payment Flow


# Agent B (Client)
synet payment sei create-invoice 10 --memo "AI Service"
> sei1xyz... (10 SEI)

# Agent A (Client)
synet payment sei pay --to sei1xyz... --amount 10

Security Considerations

Keys Stored Locally: CLI stores private keys securely.
No Fiat Onboarding: Users must use external exchanges for fiat-to-crypto.
Invoice Validation: Use synet verify to validate service authenticity.

Learn More

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

:: synet-cli