mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
hanzoskills.com/llms.txt now opens with the install line, the API reference index and the company index, so an agent that lands on any one of the three can find the rest. robots.txt claimed 537 documents while llms.txt counts 920. The number is gone from robots.txt; llms.txt derives it. public/ is regenerated from scripts/site.py, which it had fallen behind: the copy-prompt menu and agent bar were in the generator and not in the committed pages. tests/site.mjs passes against the result. Co-authored-by: Hanzo Dev <[email protected]>
423 lines
21 KiB
HTML
423 lines
21 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>hanzo-numscript</title>
|
|
<meta name="color-scheme" content="dark">
|
|
<style>
|
|
/* Committed to one visual world: a dark instrument panel. No light variant —
|
|
the dot field and the hairline rules only read on black, and a naive
|
|
inversion would wash both out. Every colour is painted explicitly so the page
|
|
never borrows a host background. */
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
|
|
|
|
:root{
|
|
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
|
|
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
|
|
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
|
|
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
|
|
--font-zen-pixel-square:'Zen Pixel Square',monospace;
|
|
--mono:var(--font-zen-mono);
|
|
--sans:var(--font-zen-sans);
|
|
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
|
|
--r:999px; --r-soft:14px;
|
|
}
|
|
*{box-sizing:border-box}
|
|
html{-webkit-text-size-adjust:100%}
|
|
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
|
|
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
|
|
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
|
|
|
|
/* The dot field. A halftone made of one repeating radial-gradient, faded out
|
|
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
|
|
/* No overflow clip here: the dot field is inset to the box already, and a clip
|
|
would cut off the copy-prompt menu. */
|
|
.hero{position:relative;border-bottom:1px solid var(--line)}
|
|
.hero::before{content:"";position:absolute;inset:0;
|
|
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
|
|
background-size:7px 7px;
|
|
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
pointer-events:none}
|
|
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
|
|
|
|
nav{border-bottom:1px solid var(--line)}
|
|
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
|
|
justify-content:space-between;align-items:center;gap:1rem}
|
|
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--ink);text-decoration:none;
|
|
display:inline-flex;align-items:center;gap:.6rem}
|
|
.brand i{font-style:normal;color:var(--faint)}
|
|
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
|
|
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--soft);text-decoration:none}
|
|
nav a.up:hover{color:var(--ink)}
|
|
|
|
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
|
|
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
|
|
h1 em{font-style:normal;color:var(--faint)}
|
|
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
|
|
|
|
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
|
|
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
|
|
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
|
|
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
|
|
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
|
|
line-height:1.2;font-weight:400}
|
|
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
|
|
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
|
|
.btn.solid:hover{background:#d8d8d4}
|
|
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
|
|
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
|
|
|
|
/* Copy-prompt selector. Each row copies the prompt for its own target. */
|
|
.copy{position:relative;display:inline-flex}
|
|
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
|
|
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
|
|
padding:.4rem;display:flex;flex-direction:column;
|
|
box-shadow:0 12px 32px rgba(0,0,0,.75)}
|
|
.menu[hidden]{display:none}
|
|
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
|
|
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
|
|
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
|
|
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
|
|
white-space:nowrap}
|
|
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
|
|
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
|
|
.mi:hover .mark{color:var(--ink)}
|
|
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
|
|
letter-spacing:.1em;text-transform:uppercase}
|
|
|
|
/* Works-with bar: one scrolling row, name and mark per agent. */
|
|
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
|
|
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
|
|
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
|
|
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
|
|
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
|
|
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
|
|
display:flex;align-items:center}
|
|
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
|
|
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
|
|
-webkit-overflow-scrolling:touch;
|
|
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
|
|
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
|
|
.bar::-webkit-scrollbar{display:none}
|
|
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
|
|
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
|
|
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
|
|
text-decoration:none;background:var(--ground)}
|
|
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
|
|
.agent .mark{width:.95rem;height:.95rem}
|
|
|
|
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
|
|
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
|
|
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
|
|
p{margin:0 0 1rem;max-width:70ch}
|
|
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
|
|
li{margin:.22rem 0}
|
|
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
|
|
text-decoration-color:var(--line-hi)}
|
|
a:hover{text-decoration-color:var(--ink)}
|
|
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
|
|
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
|
|
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
|
|
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
|
|
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
|
|
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
|
|
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
|
|
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
|
|
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
|
|
display:block;overflow-x:auto}
|
|
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
|
|
|
|
.curl{display:block;background:var(--panel);border:1px solid var(--line);
|
|
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
|
|
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
|
|
white-space:pre;line-height:1.9}
|
|
.curl b{color:var(--ink);font-weight:400}
|
|
.curl i{font-style:normal;color:var(--faint)}
|
|
|
|
/* index */
|
|
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
|
|
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
|
|
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
|
|
#q:focus{outline:none;border-color:var(--soft)}
|
|
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
|
|
text-transform:uppercase;margin:0 0 2rem}
|
|
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
|
|
padding-bottom:.45rem}
|
|
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
|
|
border-radius:var(--r-soft);text-decoration:none}
|
|
.row:hover{background:#0a0a0a}
|
|
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
|
|
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
|
|
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
|
|
color:var(--faint);font-size:.85rem}
|
|
footer a{color:var(--soft)}
|
|
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
|
|
margin:0 0 2rem;font-size:.85rem}
|
|
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
|
|
border-bottom:1px solid var(--line);padding-bottom:.4rem}
|
|
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
|
|
.fmap a:hover{text-decoration:underline}
|
|
.fmap div{color:var(--faint);line-height:1.5}
|
|
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
|
|
|
|
@media (max-width:640px){
|
|
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
|
|
.btns{gap:.5rem}
|
|
.btn{padding:.75rem 1.15rem;font-size:.68rem}
|
|
.copy,.copy .btn{width:100%;justify-content:center}
|
|
.menu{left:0;right:0;min-width:0}
|
|
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
|
|
.strip b{border-right:0;padding-right:0}
|
|
.bar{width:100%}
|
|
}
|
|
</style>
|
|
<link rel="alternate" type="text/markdown" href="/hanzo-numscript.md">
|
|
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/hanzo-numscript">
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/hanzo-numscript.md
|
|
Index: https://hanzoskills.com/llms.txt
|
|
Corpus: https://hanzoskills.com/all.md
|
|
Append .md to any path for the markdown twin. -->
|
|
<body>
|
|
<nav><div class="in">
|
|
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
|
|
<a class="up" href="/">All skills</a>
|
|
</div></nav>
|
|
|
|
<div class="wrap">
|
|
<h1>hanzo-numscript</h1><p class="lede">Numscript is a domain-specific language for modeling complex financial transactions.</p><h1>Hanzo Numscript - DSL for Financial Transactions</h1>
|
|
<p><strong>Category</strong>: Hanzo Ecosystem <strong>Related Skills</strong>: <code>hanzo/hanzo-reconciliation.md</code>, <code>hanzo/hanzo-billing.md</code></p>
|
|
<h2>Overview</h2>
|
|
<p>Numscript is a <strong>domain-specific language for modeling complex financial transactions</strong>. It provides declarative syntax for multi-party fund transfers with percentage splits, ordered funding sources, overdraft controls, and parameterized scripts. Used by Hanzo Ledger for programmable money movement. Includes a CLI, Go library, LSP server, and MCP server.</p>
|
|
<h3>Why Numscript?</h3>
|
|
<ul><li><strong>Declarative transfers</strong> -- Express multi-party fund routing in readable syntax</li><li><strong>Percentage splits</strong> -- Route funds by percentage or fixed amount to multiple destinations</li><li><strong>Source ordering</strong> -- Define fallback funding sources with automatic overdraft prevention</li><li><strong>Type safety</strong> -- Compile-time validation of account references and asset types</li><li><strong>ANTLR grammar</strong> -- Formal grammar (Numscript.g4 + Lexer.g4) for parsing</li><li><strong>LSP support</strong> -- Language Server Protocol for editor integration</li><li><strong>MCP server</strong> -- Model Context Protocol integration for AI tooling</li></ul>
|
|
<h3>Tech Stack</h3>
|
|
<ul><li><strong>Language</strong>: Go 1.24</li><li><strong>Parser</strong>: ANTLR4 (Go target)</li><li><strong>CLI</strong>: cobra (goreleaser for cross-platform builds)</li><li><strong>Testing</strong>: testify + go-snaps (snapshot testing)</li><li><strong>Error tracking</strong>: Sentry</li><li><strong>LSP</strong>: go.lsp.dev/protocol</li><li><strong>MCP</strong>: mark3labs/mcp-go</li><li><strong>License</strong>: MIT</li></ul>
|
|
<h3>OSS Base</h3>
|
|
<p>Repo: <code>hanzoai/numscript</code> (Formance numscript fork). Go module path is <code>github.com/formancehq/numscript</code> (upstream module name retained).</p>
|
|
<h2>When to use</h2>
|
|
<ul><li>Modeling multi-party financial transfers (e.g., marketplace payouts)</li><li>Splitting payments by percentage across multiple destinations</li><li>Defining ordered funding sources with overdraft limits</li><li>Parameterizing transaction scripts for reuse</li><li>Validating transaction scripts before execution (parse + analysis)</li><li>Integrating financial transaction DSL into a ledger system</li></ul>
|
|
<h2>Hard requirements</h2>
|
|
<ol><li><strong>Go 1.24+</strong> for building from source</li><li><strong>ANTLR4</strong> for regenerating the parser from grammar files</li><li><strong>Hanzo Ledger</strong> for executing scripts against real accounts (optional for parsing)</li></ol>
|
|
<h2>Quick reference</h2>
|
|
<p>| Item | Value | |------|-------| | Go module | <code>github.com/formancehq/numscript</code> | | CLI binary | <code>numscript</code> | | Go version | 1.24 | | Grammar | <code>Numscript.g4</code> + <code>Lexer.g4</code> (ANTLR4) | | Default branch | <code>main</code> | | License | MIT | | Repo | <code>github.com/hanzoai/numscript</code> |</p>
|
|
<h2>One-file quickstart</h2>
|
|
<h3>Install CLI</h3>
|
|
<pre><code class="lang-bash">go install github.com/hanzoai/numscript/cmd/numscript@latest</code></pre>
|
|
<h3>Parse and validate</h3>
|
|
<pre><code class="lang-bash">numscript check script.num
|
|
numscript fmt script.num</code></pre>
|
|
<h3>Go library</h3>
|
|
<pre><code class="lang-go">package main
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
"math/big"
|
|
|
|
"github.com/formancehq/numscript"
|
|
)
|
|
|
|
func main() {
|
|
program := numscript.Parse(`
|
|
send [USD/2 5000] (
|
|
source = @users:alice
|
|
destination = {
|
|
85% to @merchants:shop
|
|
10% to @platform:fees
|
|
5% to @platform:reserve
|
|
}
|
|
)
|
|
`)
|
|
|
|
if errs := program.GetParsingErrors(); len(errs) > 0 {
|
|
fmt.Println("Parse errors:", numscript.ParseErrorsToString(errs))
|
|
return
|
|
}
|
|
|
|
// Get needed variables (for parameterized scripts)
|
|
vars := program.GetNeededVariables()
|
|
fmt.Println("Variables:", vars)
|
|
|
|
// Execute against a store
|
|
result, err := program.Run(context.Background(),
|
|
numscript.VariablesMap{},
|
|
&numscript.StaticStore{
|
|
Balances: numscript.Balances{
|
|
"users:alice": {"USD/2": big.NewInt(10000)},
|
|
},
|
|
},
|
|
)
|
|
if err != nil {
|
|
fmt.Println("Error:", err)
|
|
return
|
|
}
|
|
|
|
for _, posting := range result.Postings {
|
|
fmt.Printf("%s -> %s: %s %s\n",
|
|
posting.Source, posting.Destination,
|
|
posting.Amount, posting.Asset)
|
|
}
|
|
}</code></pre>
|
|
<h2>Core Concepts</h2>
|
|
<h3>Language Syntax</h3>
|
|
<pre><code class="lang-numscript">// Variables with types
|
|
vars {
|
|
monetary $amount
|
|
account $sender
|
|
account $receiver
|
|
}
|
|
|
|
// Simple transfer
|
|
send $amount (
|
|
source = $sender
|
|
destination = $receiver
|
|
)
|
|
|
|
// Multi-source with fallback (ordered, first with funds wins)
|
|
send [USD/2 10000] (
|
|
source = {
|
|
@users:alice
|
|
@users:alice:savings
|
|
@world // infinite source (minting)
|
|
}
|
|
destination = @merchants:shop
|
|
)
|
|
|
|
// Percentage split destination
|
|
send [USD/2 10000] (
|
|
source = @users:alice
|
|
destination = {
|
|
85% to @merchants:shop
|
|
10% to @platform:fees
|
|
remaining to @platform:reserve
|
|
}
|
|
)
|
|
|
|
// Overdraft controls
|
|
send [USD/2 100] (
|
|
source = {
|
|
@a allowing overdraft up to [USD/2 10]
|
|
@b allowing unbounded overdraft
|
|
}
|
|
destination = @dest
|
|
)
|
|
|
|
// Save (earmark funds)
|
|
save [USD/2 10] from @alice
|
|
|
|
// Metadata-driven accounts
|
|
vars {
|
|
account $dest = meta(@config, "payout_account")
|
|
}
|
|
|
|
// Function calls
|
|
set_tx_meta("key", "value")</code></pre>
|
|
<h3>Architecture</h3>
|
|
<pre><code> Parse Run
|
|
numscript.go ──────────► ParseResult ──────► ExecutionResult
|
|
| |
|
|
| ANTLR4 parser | interpreter
|
|
| (Lexer.g4 + | (balance queries,
|
|
| Numscript.g4) | metadata queries,
|
|
| | posting generation)
|
|
| |
|
|
v v
|
|
ParserError[] Posting[]
|
|
Metadata{}
|
|
AccountsMetadata{}</code></pre>
|
|
<h3>Public API</h3>
|
|
<pre><code class="lang-go">// Parse source code
|
|
numscript.Parse(code string) ParseResult
|
|
|
|
// Inspect parsed result
|
|
ParseResult.GetParsingErrors() []ParserError
|
|
ParseResult.GetNeededVariables() map[string]string
|
|
ParseResult.GetSource() string
|
|
|
|
// Execute
|
|
ParseResult.Run(ctx, vars, store) (ExecutionResult, InterpreterError)
|
|
ParseResult.RunWithFeatureFlags(ctx, vars, store, flags) (ExecutionResult, InterpreterError)
|
|
|
|
// Types
|
|
type Posting struct {
|
|
Source, Destination string
|
|
Amount *big.Int
|
|
Asset string
|
|
}
|
|
|
|
type ExecutionResult struct {
|
|
Postings []Posting
|
|
Metadata Metadata // set_tx_meta() results
|
|
AccountsMetadata AccountsMetadata // set_account_meta() results
|
|
}
|
|
|
|
// Store interface (implement for your ledger)
|
|
type Store interface {
|
|
GetBalances(ctx, BalanceQuery) (Balances, error)
|
|
GetAccountsMetadata(ctx, MetadataQuery) (AccountsMetadata, error)
|
|
}</code></pre>
|
|
<h3>Feature Flags</h3>
|
|
<pre><code class="lang-go">flags.ExperimentalOneofFeatureFlag // oneof {} source selection
|
|
flags.ExperimentalMidScriptFunctionCall // balance() calls mid-script</code></pre>
|
|
<h2>Directory structure</h2>
|
|
<pre><code>github.com/hanzoai/numscript/
|
|
numscript.go # Public API: Parse, Run, types
|
|
numscript_test.go # Integration tests (20+ test cases)
|
|
Numscript.g4 # ANTLR4 grammar (parser rules)
|
|
Lexer.g4 # ANTLR4 grammar (lexer rules)
|
|
Justfile # Build commands (generate, test, lint, release)
|
|
.goreleaser.yaml # Cross-platform binary releases
|
|
inputs.schema.json # JSON schema for script inputs
|
|
specs.schema.json # JSON schema for specs
|
|
cmd/numscript/
|
|
main.go # CLI entrypoint (check, fmt subcommands)
|
|
internal/
|
|
parser/ # ANTLR4-generated parser + parse tree
|
|
interpreter/ # Script execution engine
|
|
analysis/ # Static analysis and validation
|
|
lsp/ # Language Server Protocol implementation
|
|
mcp_impl/ # Model Context Protocol server
|
|
jsonrpc2/ # JSON-RPC 2.0 transport
|
|
cmd/ # CLI command implementations
|
|
flags/ # Feature flag definitions
|
|
ansi/ # Terminal color output
|
|
specs_format/ # Spec formatting utilities
|
|
utils/ # Shared utilities</code></pre>
|
|
<h2>Troubleshooting</h2>
|
|
<p>| Issue | Cause | Solution | |-------|-------|----------| | Parse error on <code>@world</code> | Missing source block | <code>@world</code> must be inside a <code>source = {}</code> block | | MissingFundsErr | Source accounts have insufficient balance | Add <code>@world</code> as final fallback or use <code>allowing overdraft</code> | | Variables not resolved | Missing from VariablesMap | Check <code>GetNeededVariables()</code> and provide all required vars | | ANTLR regeneration fails | ANTLR4 not installed | Install via <code>brew install antlr</code> or use Nix flake | | Module path mismatch | Upstream module name | Import as <code>github.com/formancehq/numscript</code> (retained from fork) |</p>
|
|
<h2>Related Skills</h2>
|
|
<ul><li><code>hanzo/hanzo-reconciliation.md</code> - Transaction reconciliation engine</li><li><code>hanzo/hanzo-billing.md</code> - Billing and subscription management</li></ul>
|
|
<hr>
|
|
<p><strong>Last Updated</strong>: 2026-03-13 <strong>Category</strong>: Hanzo Ecosystem <strong>Related</strong>: dsl, fintech, ledger, transactions, payments, go <strong>Prerequisites</strong>: Go 1.24+, ANTLR4 (for grammar regeneration)</p>
|
|
<footer>
|
|
<div class="fmap">
|
|
<div><b>Build</b>
|
|
<a href="https://hanzo.app">hanzo.app</a> app builder
|
|
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
|
|
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
|
|
<div><b>Run</b>
|
|
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
|
|
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
|
|
<div><b>Account</b>
|
|
<a href="https://hanzo.id">hanzo.id</a> sign in
|
|
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
|
|
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
|
|
<div><b>Company</b>
|
|
<a href="https://hanzo.ai">hanzo.ai</a> canonical
|
|
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
|
|
</div>
|
|
<div class="fend"><a href="/hanzo-numscript.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |