Cli
Rpc CLI
Command-line interface reference for rpc.do - Remote Procedure Call (RPC) services
Rpc CLI
Remote Procedure Call (RPC) services
Installation
# Install globally
npm install -g do
# Or use via npx
npx do --versionQuick Start
# Basic usage
do protocol rpc connect wss://server.comCommands
Main Command
do protocol rpc connect wss://server.comDescription: Remote Procedure Call (RPC) services
Usage:
do rpc [options]Options
Global Options
--help, -h- Show help--version, -v- Show version--verbose- Verbose output--quiet, -q- Quiet mode--json- JSON output--config <file>- Config file path
Command-Specific Options
do rpc \
--option1=value1 \
--option2=value2 \
--verboseUsage Examples
Basic Example
# Simple usage
do protocol rpc connect wss://server.comWith Options
# With configuration
do protocol rpc connect wss://server.com --verbose --jsonInteractive Mode
# Interactive prompts
do rpc --interactiveBatch Operations
# Process multiple items
do rpc --batch items.jsonPipeline Integration
# Use with pipes
cat data.json | do rpc --stdin | jq '.'Configuration
Config File
Create .doconfig in your project:
{
"rpc": {
"option1": "value1",
"option2": "value2"
}
}Environment Variables
export DO_RPC_OPTION1=value1
export DO_RPC_OPTION2=value2
do protocol rpc connect wss://server.comOutput Formats
Default Output
do protocol rpc connect wss://server.com
# ✓ Operation completed
# Result: ...JSON Output
do protocol rpc connect wss://server.com --json
# {
# "success": true,
# "result": { ... }
# }Verbose Output
do protocol rpc connect wss://server.com --verbose
# → Starting operation...
# → Processing...
# → Completed in 1.2sScripting
Bash Scripts
#!/bin/bash
# Check if successful
if do protocol rpc connect wss://server.com; then
echo "Success!"
else
echo "Failed!"
exit 1
fiCI/CD Integration
# GitHub Actions
- name: Run Rpc
run: |
do protocol rpc connect wss://server.com \
--config prod.json \
--quietError Handling
Exit Codes
0- Success1- General error2- Invalid arguments3- Timeout4- Not found
Error Messages
# Capture errors
do protocol rpc connect wss://server.com 2>errors.log
# Handle errors
if ! do protocol rpc connect wss://server.com; then
echo "Error occurred, check errors.log"
exit 1
fiDebugging
# Debug mode
DEBUG=* do protocol rpc connect wss://server.com
# Dry run
do protocol rpc connect wss://server.com --dry-run
# Verbose + timing
time do protocol rpc connect wss://server.com --verboseBest Practices
- Use Config Files - Store configuration in
.doconfig - Environment Variables - Use for sensitive data
- Error Handling - Check exit codes in scripts
- JSON Output - Use
--jsonfor parsing results - Verbose Mode - Use
--verbosefor debugging