@superise/market-sustain-cli
v0.0.1
Published
Standalone sustain CLI for SupeRISE Market.
Downloads
19
Readme
@superise/market-sustain-cli
Standalone sustain CLI for SupeRISE Market.
This package exists so the market sustain capability can be moved out of the wallet monorepo while standardizing invocation under superise market-sustain. It keeps the sustain part only: balance observation, burn forecast, model listing, top-up orchestration, pending-order retry, and local config/session management.
Boundary
The boundary is the same as the old sustain skill:
- The CLI provides primitive operations only.
- The caller decides when to observe, when to top up, and when to retry.
In other words, this package does not "self-plan". It exposes the operations an agent or operator needs to run an observe -> decide -> act loop.
Compared with the upstream wallet monorepo sustain implementation, this extracted package intentionally keeps only the primitive sustain surface, plus a one-click setup openclaw flow for recurring sustain checks. It still does not restore set-model or mcp-server.
Commands
superise market-sustain health-check
superise market-sustain forecast
superise market-sustain list-models
superise market-sustain top-up <amount>
superise market-sustain retry-orders
superise market-sustain setup openclaw
superise market-sustain config show|get|set|unset|reset
superise market-sustain logoutRecommended sustain loop:
- Observe current state with
superise market-sustain health-check --jsonandsuperise market-sustain forecast --json. - Read guardrails with
superise market-sustain config showorsuperise market-sustain config get <key>. - If needed, inspect pricing with
superise market-sustain list-models --json. - If balance is too low, choose a recharge amount and run
superise market-sustain top-up <amount>. - If a top-up partially failed after transfer submission, run
superise market-sustain retry-orders --json. - If you want recurring self-supervision, run
superise market-sustain setup openclaw.
superise market-sustain setup openclaw registers two OpenClaw cron jobs by default: a keepalive review loop every 5m, and a pending-order retry loop every 10m. The default OpenClaw target is isolated so the jobs can announce results back to chat. Use --tick-every, --retry-every, or --session to customize the schedule target.
If OpenClaw is not available or you explicitly prefer app-managed scheduling, you can still use app-level automations to run the same observe -> decide -> act loop on a schedule.
Runtime Assumptions
This package talks to two systems:
- Wallet MCP, for address lookup, signing, transfer, and wallet metadata
- SupeRISE Market, for balance, model catalog, top-up order creation, and tx-hash submission
Current auth assumption:
marketPublicKeycan be configured explicitly, or- wallet MCP exposes Nervos public identity through
nervos.identity, includingaddressandpublicKey
The sustain package does not derive the wallet public key locally.
Top-up amount policy is now enforced by the wallet side. The sustain CLI only validates that <amount> is a positive CKB amount and forwards the transfer request.
Current local state:
~/.superise/sustain/config.json~/.superise/market-session.json~/.superise/sustain/observations.json~/.superise/sustain/pending-orders.json~/.superise/sustain/manual-review-orders.json
Default storage can also be overridden with SUPERISE_SUSTAIN_HOME or SUPERISE_HOME.
Config
Main config keys:
platformBaseUrlwalletMcpUrlmarketPublicKeycriticalBalancelowBalancerequestTimeoutMs
Use superise market-sustain config show to inspect the effective configuration.
