How-To & Examples

Practical recipes for common NWO-ASM workflows. Every example is self-contained — copy, save as a .nwo file, run nwo-asm build, and you've got something working. Local-only recipes require no credentials.

The three-line loop

Every NWO-ASM workflow reduces to three commands. Anything more advanced is a flag on one of these.

Twelve worked examples

Every example below is real, runnable code. Click any to expand. Tagged by skill level and what they touch.

module hello {
  output r : pmx[1]
  r = pmx.identity()
}

use metastate.anomaly
module ascore {
  input  s : f32[N]
  output v : f32
  v = anomaly.score(s)
}

use metastate.symbolic
module fit {
  input  xs : f32[N]
  input  ys : f32[N]
  output e  : expr
  e = symbolic.regress(xs, ys)
}

use metastate.quantum
module qroute {
  input  e : expr
  output h : handle
  h = quantum.route(pmx.lift(e), {
    prefer:   qpu,
    fallback: gpu,
  })
}

use metastate.poi
module verify {
  input  h : handle
  output p : proof
  p = poi.verify(h)               # signed (PQC)
}

use metastate.anchor
module settle {
  input  p : proof
  output c : calldata
  c = anchor.prepare(p, usdc(base))   # no new contract
}

nwo-asm dispatch app.qasm3 --dry-run --explain

  → would route to: qpu (origin_wukong, expected 42ms)
  → estimated cost: $0.0008 USDC
  → no on-chain calls executed

# one-liner install
pip install nwo-agi
nwo-agi start --wallet 0xYourBaseAddress

  → node registered: NODE-0xC7…2A
  → accepting tasks · health 100%

# inside the NWO ASM Terminal
nwo> portal.new qpu
  → opened PRT-0x5C41 on qpu · per-call USDC

nwo> portal.health PRT-0x5C41
  → PRT-0x5C41 · health 100% · latency 21ms · throughput 2.4 M/s

[settlement]
affiliate = "0xYourBaseAddress"     # 15% of every settled call

nwo-asm build app.nwo --sign

  → app.qasm3
  → app.qasm3.sig    (dilithium3, key ~/.nwo-asm/keys/identity)

use nwo_asm::{Compile, Dispatch};
use metastate_client::Base;

let art = Compile::build("signal.nwo")?;
let res = Dispatch::new(art)
    .target("qpu")
    .settle(Base::usdc())
    .send()?;
println!("proof: {}", res.proof);

A few patterns worth knowing

What the recipes use