API Reference: Julia Backend Commands

This page lists the commands processed by the Julia backend server, typically invoked via the Node.js or Python bridge.

(Note: This list is based on inferred functionality and previous documentation. The exact command names, parameters, and return values should be verified against the command handler logic in /julia/julia_server.jl and the relevant Julia modules in /julia/src/)

Command Format

Commands are typically sent as JSON objects with a command field (e.g., "agents.create_agent") and a payload field containing parameters.

{
  "command": "category.action",
  "payload": { "param1": "value1", "param2": 123 }
}

Agent Commands

Command	Description	Payload Parameters	Example Payload	Return Value
agents.create_agent	Create a new agent	name (String), type (String), config (Dict)	{"name": "MyAgent", "type": "Trading", "config": {"risk": 0.5}}	Agent ID or Agent object
agents.list_agents	List all managed agents	None	{}	Array of Agent objects or IDs
agents.get_agent	Retrieve details for a specific agent	id (String)	{"id": "agent-uuid-123"}	Agent object
agents.start_agent	Start a specific agent	id (String)	{"id": "agent-uuid-123"}	Status confirmation
agents.stop_agent	Stop a specific agent	id (String)	{"id": "agent-uuid-123"}	Status confirmation
agents.delete_agent	Delete a specific agent	id (String)	{"id": "agent-uuid-123"}	Status confirmation
agents.update_config	Update configuration for an agent	id (String), config (Dict)	{"id": "agent-uuid-123", "config": {"risk": 0.6}}	Status confirmation

Swarm Commands

Command	Description	Payload Parameters	Example Payload	Return Value
swarms.create_swarm	Create a new swarm	name (String), algorithm (Dict), config (Dict)	{"name": "MySwarm", "algorithm": {"type":"PSO", "params":{...}}, "config": {"pairs": [...]}}	Swarm ID or Swarm object
swarms.list_swarms	List all managed swarms	None	{}	Array of Swarm objects or IDs
swarms.get_swarm	Retrieve details for a specific swarm	id (String)	{"id": "swarm-uuid-456"}	Swarm object
swarms.start_swarm	Start optimization/operation for a swarm	id (String)	{"id": "swarm-uuid-456"}	Status confirmation
swarms.stop_swarm	Stop a specific swarm	id (String)	{"id": "swarm-uuid-456"}	Status confirmation
swarms.delete_swarm	Delete a specific swarm	id (String)	{"id": "swarm-uuid-456"}	Status confirmation
swarms.add_agent	Add an agent to a swarm	swarm_id (String), agent_id (String)	{"swarm_id": "swarm-456", "agent_id": "agent-123"}	Status confirmation
swarms.remove_agent	Remove an agent from a swarm	swarm_id (String), agent_id (String)	{"swarm_id": "swarm-456", "agent_id": "agent-123"}	Status confirmation

Wallet Commands (Backend - Use with Caution)

Command	Description	Payload Parameters	Example Payload	Return Value
wallets.get_wallets	List backend-managed wallets	None	{}	Mock List
wallets.get_wallet_info	Get info for a backend wallet	wallet_id (String)	{"wallet_id":"wallet1"}	Mock Info
wallets.create_wallet	Create new backend wallet (INSECURE if keys stored)	name (String)	{"name":"AgentWallet"}	Mock Wallet
wallets.import_wallet	Import backend wallet (INSECURE)	name, private_key, chain	{...}	Mock Wallet
wallets.export_wallet	Export backend wallet key (INSECURE)	wallet_id, chain	{...}	Mock Key

Bridge / Blockchain / DEX Commands

Command	Description	Payload Parameters	Example Payload	Return Value
bridge.get_token_address	Resolve token symbol to address	symbol (String), chain (String)	{"symbol":"WETH", "chain":"ethereum"}	Address Dict or Error
blockchain.get_balance	Get native/token balance	address, chain, token_address (opt)	{"address":"0x...", "chain":"base"}	Balance Dict or Error
dex.get_swap_quote	Get quote for a DEX swap	token_in, token_out, amount_in_wei, dex_name, chain	{...}	Quote Dict or Error
bridge.execute_trade	Prepare unsigned swap TX	dex, chain, trade_params (Dict: token_in, token_out, amount_in_wei, slippage, wallet_address)	{...}	Unsigned TX Dict or Error
bridge.submit_signed_transaction	Submit client-signed TX	chain, request_id, signed_tx_hex	{...}	Submission Result Dict
bridge.get_transaction_status	Check submitted TX status	chain, tx_hash	{"chain":"polygon", "tx_hash":"0x..."}	Status Dict or Error
bridges.[protocol].transfer	Initiate cross-chain transfer	Varies by protocol	{...}	Transfer ID/Tx Hash
bridges.[protocol].getStatus	Check cross-chain status	transferId	{...}	Status string

System Commands

Command	Description	Payload Parameters	Example Payload	Return Value
system.get_status	Get overall system status	None	{}	Status object
system.get_metrics	Get performance metrics	None	{}	Metrics object
system.ping	Basic health check	None	{}	"pong"