Moloch Agent CLI

CLI runtime for autonomous DAOhaus/Moloch agents.

This package is the local agent command surface. It uses the hosted moloch service for Graph reads and IPFS pinning, while wallet signing stays local.

Default hosted service:

https://moloch-service-production.up.railway.app

Override when needed:

export MOLOCH_SERVICE_URL=https://moloch-service-production.up.railway.app

Install

Local development:

npm install
npm run build
node dist/cli.js help

Future package install:

npm install -g @raidguild/meta-clawtel
moloch-agent help

Transaction commands broadcast by default. Use --build-only on a transaction command when an unsigned transaction is wanted instead.

Set this only for a dry-run harness:

export MOLOCH_SEND_DEFAULT=false

Publish

The package is published under the public @raidguild npm scope.

One-time npm login:

npm login
npm whoami

Verify package contents:

npm run typecheck
npm test
npm pack --dry-run

Publish:

npm publish --access public

If npm requires two-factor auth, pass the OTP from your authenticator:

npm publish --access public --otp 123456

Commands

moloch-agent health
moloch-agent capabilities
moloch-agent account
moloch-agent dao --dao 0xDAO
moloch-agent proposals --dao 0xDAO
moloch-agent proposal --dao 0xDAO --proposal 1
moloch-agent daohaus-url --dao 0xDAO
moloch-agent links --dao 0xDAO --address 0xCONTRACT --tx 0xHASH
moloch-agent read-dao --dao 0xDAO
moloch-agent balances --dao 0xDAO
moloch-agent balances --address 0xADDRESS --token 0xERC20
moloch-agent treasury-tokens --dao 0xDAO
moloch-agent read-proposal --dao 0xDAO --proposal 1
moloch-agent proposal-lifecycle --dao 0xDAO --proposal 1
moloch-agent process-queue --dao 0xDAO
moloch-agent wrap-eth --amount 0.01
moloch-agent approve-token --token 0xERC20 --amount 1000000
moloch-agent ragequit --dao 0xDAO --to 0xRECIPIENT --shares 1 --loot 0 --tokens ETH,0xERC20 --confirm-ragequit
moloch-agent members --dao 0xDAO
moloch-agent records --dao 0xDAO --table communityMemory
moloch-agent pin-json --file community-state.json --name community-state-v1
moloch-agent workspace-create --kind dao --dao 0xDAO --title "DAO Workspace"
moloch-agent workspace-create --kind proposal --dao 0xDAO --title "Proposal Workspace"
moloch-agent summon --params summon.json
moloch-agent memory-post --dao 0xDAO --thread-id proposal-1 --body "Reason for vote"
moloch-agent signal --dao 0xDAO --title "Signal" --description "Body"
moloch-agent dao-meta --dao 0xDAO --community-memory-uri ipfs://...
moloch-agent gov-settings --dao 0xDAO --params gov-settings.json
moloch-agent token-settings --dao 0xDAO --pause-shares false --pause-loot false
moloch-agent custom-proposal --dao 0xDAO --title "Custom action" --actions actions.json
moloch-agent join-dao --dao 0xDAO --token 0xERC20 --amount 1000000 --shares 10000
moloch-agent tribute --dao 0xDAO --token 0xERC20 --amount 1000000 --shares 10000
moloch-agent swap --dao 0xDAO --token 0xERC20 --amount 1000000 --shares 0 --loot 100
moloch-agent payment --dao 0xDAO --recipient 0xPAYEE --amount 0.01
moloch-agent payment --dao 0xDAO --recipient 0xPAYEE --token 0xERC20 --amount 100 --decimals 6
moloch-agent mint-shares --dao 0xDAO --to 0xMEMBER --amount 1
moloch-agent mint-loot --dao 0xDAO --to 0xMEMBER --amount 100
moloch-agent sponsor --dao 0xDAO --proposal 1
moloch-agent vote --dao 0xDAO --proposal 1 --approved true --reason "Aligned with the current mandate."
moloch-agent cancel --dao 0xDAO --proposal 1
moloch-agent process --dao 0xDAO --proposal 1 --proposal-data 0x...
moloch-agent process-ready --dao 0xDAO

Minimal summon params:

{
  "daoName": "Example DAO",
  "description": "Agent-operated DAO on Base.",
  "memberAddresses": ["0x0000000000000000000000000000000000000001"],
  "memberShares": ["10000000000000000000000"],
  "memberLoot": ["0"],
  "tokenName": "Example DAO Shares",
  "tokenSymbol": "EXAMPLE",
  "lootTokenName": "Example DAO Loot",
  "lootTokenSymbol": "EXAMPLELOOT",
  "votingPeriodInSeconds": 14400,
  "gracePeriodInSeconds": 14400,
  "newOffering": "0",
  "quorum": 30,
  "sponsorThreshold": "1000000000000000000",
  "minRetention": 66,
  "communityMemoryURI": "ipfs://..."
}

Summon share, loot, offering, and sponsor threshold values are raw integer base units. Percent fields are whole-number percentages.

If any of communityMemoryURI, proposalWorkspaceURI, or sharedStateURI are omitted, summon pins a starter DAO workspace and fills the missing metadata pointers with its ipfs://... URI.

Proposal commands (signal, dao-meta, gov-settings, token-settings, custom-proposal, join-dao, tribute, swap, payment, mint-shares, mint-loot) pin a proposal workspace automatically and put that URI in proposal details when no --link or --content-uri is supplied. Proposal links use ipfs://... by default. Set IPFS_GATEWAY_URL when a browser gateway URL should be used instead.

Agents should normally omit --link and --content-uri so the CLI can create the proposal workspace. Use those flags only when passing an already-pinned workspace URI.

gov-settings reads a JSON file with votingPeriodInSeconds, gracePeriodInSeconds, newOffering, quorum, sponsorThreshold, and minRetention. quorum and minRetention are whole-number percentages.

token-settings changes Baal share/loot pause state with setAdminConfig.

custom-proposal is the generic Baal proposal escape hatch. Pass an actions JSON array like [{"to":"0x...","value":"0","data":"0x...","operation":0}].

Proposal commands read the DAO proposalOffering and include it as transaction value unless --value or --proposal-offering is provided.

tribute, join-dao, swap, and token-swap all use the DAOhaus Tribute Minion path for requesting voting shares and/or non-voting loot in exchange for ERC-20 tokens. Native ETH and zero-address token tribute are not supported by the DAOhaus Tribute Minion. --amount is raw ERC-20 token units.

For native ETH-to-shares flows, use WETH: run wrap-eth --amount 0.01, approve the Tribute Minion with approve-token --token 0x4200000000000000000000000000000000000006 --amount 0.01, then run tribute / join-dao / swap with that WETH token address. approve-token defaults spender to the DAOhaus Tribute Minion and token to Base WETH; pass --amount-raw or --decimals for non-WETH ERC-20 units.

payment creates a treasury transfer proposal. Without --token, --amount is a human ETH decimal. With --token, pass either raw token units with --amount-raw or provide --decimals so the CLI can parse human token units.

ragequit is a direct member action, not a proposal. Treat it as an irreversible DAO exit action: it burns the caller's shares and/or loot and claims proportional treasury assets to --to. Broadcast requires --confirm-ragequit; build-only inspection does not. The --tokens list must be sorted ascending as Baal requires. Run treasury-tokens --dao 0xDAO and use ragequitTokensCsv as the --tokens value. Use ETH or NATIVE for Baal's native ETH sentinel when building a token list manually.

mint-shares creates a direct voting-share issuance proposal. mint-loot creates a direct non-voting loot issuance proposal. Both use human 18-decimal DAO token units by default; use --amount-raw only for exact base units.

vote --reason posts a vote-reason memory record linked to the proposal, then submits the vote transaction. The CLI reads the proposal contentURI when available and includes it as workspaceURI on the memory record.

Transaction commands wait for receipts by default before returning. This reduces stale nonce races when agents run back-to-back writes such as sponsor then vote, or vote-reason then vote. Use --wait to make that explicit, --confirmations N to wait longer, or --no-wait only for fire-and-forget operation. MOLOCH_WAIT_DEFAULT=false remains a fallback for older wrappers.

Use moloch-agent account to print the exact signer address derived from PRIVATE_KEY. Never expand shortened addresses such as 0x1234...abcd; use only full addresses from account, environment variables, chain reads, or explicit user input.

DAOhaus admin URL helper:

moloch-agent daohaus-url --dao 0xf58be4395defe88ca261c2d869642c06baccec16
moloch-agent links --dao 0xf58be4395defe88ca261c2d869642c06baccec16 --proposal 1
moloch-agent links --address 0xf58be4395defe88ca261c2d869642c06baccec16

Boundaries

• The hosted service handles Graph reads and Pinata uploads.
• The CLI owns local signing commands.
• The service must never receive private keys.
• process-queue and process-ready use direct chain state and do not rely on indexed passed as the execution gate.
• RPC_URL defaults to https://mainnet.base.org so the CLI works out of the box.
• Always-on agents should set a managed Base RPC URL for reliability.

Transaction commands sign and broadcast by default. Use --build-only to build unsigned summaries, and --full to print calldata. Signing and broadcasting require PRIVATE_KEY; RPC_URL is optional but recommended.