Source code for fleetmesh_node.commands.compute_cmds

"""Compute market, order book, DVM gateway, and settlement rails."""
from __future__ import annotations

import argparse

from fleetmesh_node.config.parameter import Parameter
from fleetmesh_node.planes.services.compute.compartment import Compute
from fleetmesh_node.planes.services.dvm.gateway import DVMGateway
from fleetmesh_node.planes.services.settle.compartment import Settlement
from fleetmesh_node.planes.transport.bridge.compartment import RelayBridge
from .adapter import CommandDispatcher
from .base import _ask, add_command, emit, fail, load_json_arg


# ---- 1. Relay Bridge --------------------------------------------------------

def _bridge_status(r: dict) -> None:
    print('Relay Bridge: %s' % ('enabled' if r.get('enabled') else 'disabled'))
    print('  relays configured: %d, connected: %d' % (r.get('relays_configured', 0), r.get('relays_connected', 0)))
    ing = r.get('ingress', {})
    egr = r.get('egress', {})
    print('  ingress: stored=%d, duplicates=%d, refused=%d' % (ing.get('stored', 0), ing.get('duplicates', 0), ing.get('refused', 0)))
    print('  egress:  sent=%d, failed=%d, pending=%d' % (egr.get('sent', 0), egr.get('failed', 0), egr.get('pending', 0)))
    relays = r.get('relays', {})
    if relays:
        print('\n  Relays:')
        for url, stats in relays.items():
            print('    %-30s  %s (in=%d, out=%d, errs=%d)' % (
                url, 'UP' if stats.get('connected') else 'DOWN',
                stats.get('ingress_count', 0), stats.get('egress_count', 0), stats.get('errors_count', 0)))


def _bridge_cursor(res: list) -> None:
    if not res:
        print('No relay bridge checkpoints recorded.')
        return
    print('Bridge Checkpoints:')
    for c in res:
        print(f"  {c.get('relay')}: last_reconciled={c.get('last_reconciled_at', 0)} last_event={c.get('last_event_at', 0)} (events={c.get('events_reconciled', 0)})")


def _cmd_bridge_publish(a: argparse.Namespace) -> int:
    if not a.event:
        fail('publish requires --event <json>')
    targets = [a.relay] if a.relay else None
    res = _ask(a.dir, 'bridge.publish', event=load_json_arg(a.event, '--event'), relays=targets, timeout=15)
    return emit(a, res, lambda res: print(str(res)))


def _cmd_bridge_add_relay(a: argparse.Namespace) -> int:
    if not a.relay:
        fail('add-relay requires --relay <url>')
    res = _ask(a.dir, 'bridge.add_relay', url=a.relay, timeout=10)
    return emit(a, res, lambda res: print(f"added {a.relay}"))


def _cmd_bridge_remove_relay(a: argparse.Namespace) -> int:
    if not a.relay:
        fail('remove-relay requires --relay <url>')
    res = _ask(a.dir, 'bridge.remove_relay', url=a.relay, timeout=10)
    return emit(a, res, lambda res: print(f"removed {a.relay}"))


def _cmd_bridge_sync(a: argparse.Namespace) -> int:
    f = load_json_arg(a.filter, '--filter') if a.filter else None
    res = _ask(a.dir, 'bridge.sync', filter=f, relay=a.relay, timeout=30)
    return emit(a, res, lambda res: print(f"sync complete: {res.get('ingested', 0)} ingested, {res.get('events_found', 0)} found"))


def _cmd_bridge_reconcile(a: argparse.Namespace) -> int:
    f = load_json_arg(a.filter, '--filter') if a.filter else None
    res = _ask(a.dir, 'bridge.reconcile', filter=f, relay=a.relay, timeout=30)
    return emit(a, res, lambda res: print(f"reconcile complete: {res.get('stored', 0)} stored, {res.get('examined', 0)} examined from {res.get('relay')}"))


_bridge_map = {c.key: c for c in RelayBridge.COMMANDS}
bridge_dispatcher = CommandDispatcher('bridge', default_action='status')
bridge_dispatcher.add_command('status', _bridge_map['show'], human=_bridge_status, timeout=10)
bridge_dispatcher.add_command('cursor', _bridge_map['cursor'], human=_bridge_cursor, timeout=10)
bridge_dispatcher.add_custom('publish', _cmd_bridge_publish, parameters=(
    Parameter(key='relay', name='relay', description='relay URL for bridge action', type=str, default=''),
    Parameter(key='event', name='event', description='event JSON string for publish', type=str, default=''),
))
bridge_dispatcher.add_custom('add-relay', _cmd_bridge_add_relay, parameters=(
    Parameter(key='relay', name='relay', description='relay URL for bridge action', type=str, default=''),
))
bridge_dispatcher.add_custom('remove-relay', _cmd_bridge_remove_relay, parameters=(
    Parameter(key='relay', name='relay', description='relay URL for bridge action', type=str, default=''),
))
bridge_dispatcher.add_custom('sync', _cmd_bridge_sync, parameters=(
    Parameter(key='filter', name='filter', description='filter JSON string for sync or reconcile', type=str, default=''),
    Parameter(key='relay', name='relay', description='relay URL for bridge action', type=str, default=''),
))
bridge_dispatcher.add_custom('reconcile', _cmd_bridge_reconcile, parameters=(
    Parameter(key='filter', name='filter', description='filter JSON string for sync or reconcile', type=str, default=''),
    Parameter(key='relay', name='relay', description='relay URL for bridge action', type=str, default=''),
))


[docs]def cmd_bridge(a: argparse.Namespace) -> int: return bridge_dispatcher.dispatch(a)
# ---- 2. Compute Market & Order Book ----------------------------------------- def _compute_show(r: dict) -> None: print('Compute Compartment:') print(' offers published: %d' % r.get('offers_published', 0)) print(' active asks: %d' % r.get('active_asks', 0)) print(' order-book offers: %d' % r.get('indexed_offers', 0)) print(' order-book asks: %d' % r.get('indexed_asks', 0)) print(' receipts held: %d' % r.get('receipts_held', 0)) print(' jobs executed: %d' % r.get('jobs_executed', 0)) print(' available engines: %s' % ', '.join(r.get('available_engines', []))) print(' active sessions: %d' % r.get('active_sessions', 0)) def _compute_book(r: dict) -> None: print('Compute Order Book:') print(' Offers (%d):' % r.get('offers_count', 0)) for off in r.get('offers', []): execs = ', '.join(f"{e.get('engine')}@{e.get('rate')}{e.get('unit')}" for e in off.get('executors', [])) print(' - %s... [%s] exp=%s' % (off.get('pubkey', '')[:16], execs, off.get('expiration', 0))) print(' Asks (%d):' % r.get('asks_count', 0)) for ask in r.get('asks', []): print(' - %s: %s bid=%s%s exp=%s' % ( ask.get('ask_id'), ask.get('executor'), ask.get('bid_price'), ask.get('bid_currency'), ask.get('expiration', 0) )) def _compute_models(r: dict) -> None: print('Available AI/LLM Models:') print(' Default: %s' % r.get('default_model')) print(' Endpoint: %s' % r.get('endpoint')) print(' Features: %s' % ', '.join(r.get('features', []))) print(' Models:') for m in r.get('available_models', []): print(' - %s' % m) def _cmd_compute_offer(a: argparse.Namespace) -> int: engine = getattr(a, 'engine', None) or 'wasm' rate = getattr(a, 'rate', None) or '45' r = _ask(a.dir, 'compute.offer', engine=engine, msat_per_mfuel=rate, timeout=10) return emit(a, r, lambda r: print('Published Kind 11803 Compute Offer: %s' % r.get('id'))) def _cmd_compute_match(a: argparse.Namespace) -> int: ask_id = getattr(a, 'ask', None) if not ask_id: fail('match requires --ask <ask-id>') r = _ask(a.dir, 'compute.match', ask=ask_id, timeout=10) def matches(r: list) -> None: print('Matches for Ask %s:' % ask_id) for m in r: free_str = ' [FREE COMPUTE]' if m.get('is_free') else '' print(' - Seller %s... Engine: %s Rate: %s%s (est: %s msat)%s' % ( m.get('seller_pubkey', '')[:16], m.get('executor'), m.get('rate'), m.get('rate_unit'), m.get('estimated_cost_msat'), free_str, )) return emit(a, r, matches) def _cmd_compute_stream(a: argparse.Namespace) -> int: prompt = getattr(a, 'prompt', None) if not prompt: fail('stream requires --prompt <text>') model = getattr(a, 'model', None) kwargs = {'prompt': prompt, 'timeout': 30} if model: kwargs['model'] = model r = _ask(a.dir, 'compute.stream', **kwargs) return emit(a, r, lambda r: print(r.get('output', ''))) _compute_map = {c.key: c for c in Compute.COMMANDS} compute_dispatcher = CommandDispatcher('compute', default_action='status') compute_dispatcher.add_command('status', _compute_map['show'], human=_compute_show, timeout=10) compute_dispatcher.add_command('show', _compute_map['show'], human=_compute_show, timeout=10) compute_dispatcher.add_command('book', _compute_map['book'], human=_compute_book, timeout=10) compute_dispatcher.add_command('receipts', _compute_map['receipts'], human=lambda r: print('Held Compute Receipts: %d' % len(r)), timeout=10) compute_dispatcher.add_command('models', _compute_map['models'], human=_compute_models, timeout=10) compute_dispatcher.add_command('list-models', _compute_map['models'], human=_compute_models, timeout=10) compute_dispatcher.add_custom('offer', _cmd_compute_offer, parameters=( Parameter(key='engine', name='engine', description='executor engine (wasm, llm, bacalhau, zk-verify-groth16, zkvm)', type=str, default=''), Parameter(key='rate', name='rate', description='msat per mfuel rate (0 for free compute)', type=str, default=''), )) compute_dispatcher.add_custom('match', _cmd_compute_match, parameters=( Parameter(key='ask', name='ask', description='ask id or event JSON for matching', type=str, default=''), )) compute_dispatcher.add_custom('stream', _cmd_compute_stream, parameters=( Parameter(key='model', name='model', description='AI/LLM model name', type=str, default=''), Parameter(key='prompt', name='prompt', description='prompt text for LLM streaming inference', type=str, default=''), ))
[docs]def cmd_compute(a: argparse.Namespace) -> int: return compute_dispatcher.dispatch(a)
# ---- 3. DVM Gateway --------------------------------------------------------- def _dvm_show(r: dict) -> None: print('DVM Gateway: %s' % ('enabled' if r.get('enabled') else 'disabled')) print(' jobs received: %d' % r.get('jobs_received', 0)) print(' jobs succeeded: %d' % r.get('jobs_succeeded', 0)) print(' jobs failed: %d' % r.get('jobs_failed', 0)) print(' total fuel: %d' % r.get('total_fuel_used', 0)) print(' refusals: %d' % r.get('refusals', 0)) def _dvm_result(res: dict) -> None: resp = res.get('response') fb = res.get('feedback') print('DVM Execution Result:') if resp: print(' Response (Kind %s): %s' % (resp.get('kind'), resp.get('content', ''))) if fb: print(' Feedback: %s' % (fb.get('content', ''))) def _dvm_delegation(res: dict) -> None: print('Order Book Delegation:') print(' Ask ID: %s' % res.get('ask_id')) print(' Matches Found: %d' % res.get('matches_found', 0)) for cand in res.get('candidates', []): free_str = ' [FREE COMPUTE]' if cand.get('is_free') else '' print(' - Seller: %s... Rate: %s%s (est: %s msat)%s' % ( cand.get('seller_pubkey', '')[:16], cand.get('rate', 0), cand.get('rate_unit', 'msat_per_mfuel'), cand.get('estimated_cost_msat', 0), free_str, )) def _cmd_dvm_process(a: argparse.Namespace) -> int: if not getattr(a, 'request', None): fail('process requires --request <nip-90-json>') res = _ask(a.dir, 'dvm.process', request=load_json_arg(a.request, '--request'), timeout=30) return emit(a, res, _dvm_result) def _cmd_dvm_delegate(a: argparse.Namespace) -> int: if not getattr(a, 'request', None): fail('delegate requires --request <nip-90-json>') res = _ask(a.dir, 'dvm.delegate', request=load_json_arg(a.request, '--request'), timeout=30) return emit(a, res, _dvm_delegation) _dvm_map = {c.key: c for c in DVMGateway.COMMANDS} dvm_dispatcher = CommandDispatcher('dvm', default_action='status') dvm_dispatcher.add_command('status', _dvm_map['show'], human=_dvm_show, timeout=10) dvm_dispatcher.add_command('show', _dvm_map['show'], human=_dvm_show, timeout=10) dvm_dispatcher.add_custom('process', _cmd_dvm_process, parameters=( Parameter(key='request', name='request', description='NIP-90 request event JSON for process or delegate', type=str, default=''), )) dvm_dispatcher.add_custom('delegate', _cmd_dvm_delegate, parameters=( Parameter(key='request', name='request', description='NIP-90 request event JSON for process or delegate', type=str, default=''), ))
[docs]def cmd_dvm(a: argparse.Namespace) -> int: return dvm_dispatcher.dispatch(a)
# ---- 4. Settlement Rails ---------------------------------------------------- def _settle_show(r: dict) -> None: print('Settlement Rails: %s' % ', '.join(r.get('rails', []))) escrows = r.get('escrows', []) print('Active Escrows: %d' % len(escrows)) for e in escrows: print(' - Ask: %s... Rail: %s Amount: %d msat Status: %s' % ( e.get('ask_id', '')[:16], e.get('rail'), e.get('amount_msat', 0), e.get('status'), )) def _cmd_settle_create(a: argparse.Namespace) -> int: for field in ('ask', 'buyer', 'seller', 'amount', 'hash'): if not getattr(a, field, None): fail(f'create requires --{field}') res = _ask(a.dir, 'settle.create', ask=a.ask, buyer=a.buyer, seller=a.seller, amount_msat=int(a.amount), hash=a.hash, rail=getattr(a, 'rail', 'lightning') or 'lightning', timeout=10) return emit(a, res, lambda res: print('Escrow Created: %s (%s msat on %s)' % (res.get('ask_id'), res.get('amount_msat'), res.get('rail')))) def _cmd_settle_hold(a: argparse.Namespace) -> int: if not getattr(a, 'ask', None): fail('hold requires --ask') res = _ask(a.dir, 'settle.hold', ask=a.ask, proof=getattr(a, 'proof', None), timeout=10) return emit(a, {'held': res}, lambda _: print('Escrow Held: %s' % res), indent=None) def _cmd_settle_settle(a: argparse.Namespace) -> int: if not getattr(a, 'ask', None) or not getattr(a, 'preimage', None): fail('settle requires --ask and --preimage') res = _ask(a.dir, 'settle.settle', ask=a.ask, preimage=a.preimage, timeout=10) return emit(a, {'settled': res}, lambda _: print('Escrow Settled: %s' % res), indent=None) def _cmd_settle_cancel(a: argparse.Namespace) -> int: if not getattr(a, 'ask', None): fail('cancel requires --ask') res = _ask(a.dir, 'settle.cancel', ask=a.ask, reason=getattr(a, 'reason', '') or '', timeout=10) return emit(a, {'cancelled': res}, lambda _: print('Escrow Cancelled: %s' % res), indent=None) def _cmd_settle_nwc_pay(a: argparse.Namespace) -> int: if not getattr(a, 'hash', None) or not getattr(a, 'bolt11', None): fail('nwc-pay requires --hash and --bolt11') res = _ask(a.dir, 'settle.nwc_pay', hash=a.hash, bolt11=a.bolt11, timeout=30) return emit(a, res, lambda res: print('NWC Payment Dispatched: Preimage %s' % res.get('preimage'))) def _cmd_settle_cashu_swap(a: argparse.Namespace) -> int: if not getattr(a, 'hash', None) or not getattr(a, 'outputs', None): fail('cashu-swap requires --hash and --outputs (JSON string)') outputs = load_json_arg(a.outputs, '--outputs') res = _ask(a.dir, 'settle.cashu_swap', hash=a.hash, outputs=outputs, timeout=30) return emit(a, res, lambda res: print('Cashu Swap Completed: %d fresh signatures' % len(res.get('signatures', [])))) def _cmd_settle_cashu_melt(a: argparse.Namespace) -> int: if not getattr(a, 'hash', None) or not getattr(a, 'bolt11', None): fail('cashu-melt requires --hash and --bolt11') res = _ask(a.dir, 'settle.cashu_melt', hash=a.hash, bolt11=a.bolt11, timeout=30) return emit(a, res, lambda res: print('Cashu Melt Completed: Paid=%s Preimage=%s' % (res.get('paid'), res.get('payment_preimage')))) _settle_map = {c.key: c for c in Settlement.COMMANDS} settle_dispatcher = CommandDispatcher('settle', default_action='status') settle_dispatcher.add_command('status', _settle_map['show'], human=_settle_show, timeout=10) settle_dispatcher.add_command('show', _settle_map['show'], human=_settle_show, timeout=10) settle_dispatcher.add_custom('create', _cmd_settle_create, parameters=( Parameter(key='ask', name='ask', description='ask id', type=str, default=''), Parameter(key='buyer', name='buyer', description='buyer pubkey', type=str, default=''), Parameter(key='seller', name='seller', description='seller pubkey', type=str, default=''), Parameter(key='amount', name='amount', description='amount in msats', type=int, default=0), Parameter(key='hash', name='hash', description='payment hash (32-byte hex)', type=str, default=''), Parameter(key='rail', name='rail', description='settlement rail', type=str, default='lightning', choices=('lightning', 'cashu', 'nwc', 'mock')), )) settle_dispatcher.add_custom('hold', _cmd_settle_hold, parameters=( Parameter(key='ask', name='ask', description='ask id', type=str, default=''), Parameter(key='proof', name='proof', description='cashu proof or secret token for hold', type=str, default=''), )) settle_dispatcher.add_custom('settle', _cmd_settle_settle, parameters=( Parameter(key='ask', name='ask', description='ask id', type=str, default=''), Parameter(key='preimage', name='preimage', description='payment preimage (32-byte hex)', type=str, default=''), )) settle_dispatcher.add_custom('cancel', _cmd_settle_cancel, parameters=( Parameter(key='ask', name='ask', description='ask id', type=str, default=''), Parameter(key='reason', name='reason', description='escrow cancellation reason', type=str, default=''), )) settle_dispatcher.add_custom('nwc-pay', _cmd_settle_nwc_pay, parameters=( Parameter(key='hash', name='hash', description='payment hash (32-byte hex)', type=str, default=''), Parameter(key='bolt11', name='bolt11', description='Lightning bolt11 invoice string', type=str, default=''), )) settle_dispatcher.add_custom('cashu-swap', _cmd_settle_cashu_swap, parameters=( Parameter(key='hash', name='hash', description='payment hash (32-byte hex)', type=str, default=''), Parameter(key='outputs', name='outputs', description='blinded outputs JSON for Cashu token swap', type=str, default=''), )) settle_dispatcher.add_custom('cashu-melt', _cmd_settle_cashu_melt, parameters=( Parameter(key='hash', name='hash', description='payment hash (32-byte hex)', type=str, default=''), Parameter(key='bolt11', name='bolt11', description='Lightning bolt11 invoice string', type=str, default=''), ))
[docs]def cmd_settle(a: argparse.Namespace) -> int: return settle_dispatcher.dispatch(a)
# ---- 5. Provider Registration -----------------------------------------------
[docs]class ComputeCommandProvider: """Registers compute market, order book, DVM, settlement, and bridge commands."""
[docs] @classmethod def register(cls, sub: argparse._SubParsersAction) -> None: bg = add_command(sub, 'bridge', cmd_bridge, 'interact with the Universal Nostr Relay Bridge', js=True) bridge_dispatcher.register_arguments(bg, action_choices=('status', 'publish', 'add-relay', 'remove-relay', 'sync', 'reconcile', 'cursor')) cp = add_command(sub, 'compute', cmd_compute, 'inspect or interact with the compute market and order book', js=True, experimental=True) compute_dispatcher.register_arguments(cp, action_choices=('status', 'show', 'book', 'offer', 'match', 'receipts', 'models', 'stream')) dv = add_command(sub, 'dvm', cmd_dvm, 'interact with the NIP-90 Data Vending Machine Gateway', js=True, experimental=True) dvm_dispatcher.register_arguments(dv, action_choices=('status', 'show', 'process', 'delegate')) se = add_command(sub, 'settle', cmd_settle, 'inspect settlement rails, escrows, and execute live payments', js=True, experimental=True) settle_dispatcher.register_arguments(se, action_choices=('status', 'show', 'create', 'hold', 'settle', 'cancel', 'nwc-pay', 'cashu-swap', 'cashu-melt'))