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]>
324 lines
21 KiB
HTML
324 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-treasury</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-treasury.md">
|
|
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/hanzo-treasury">
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/hanzo-treasury.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-treasury</h1><p class="lede">Hanzo Treasury is a programmable financial infrastructure stack providing a double-entry ledger, payment connectors, virtual wallets, reconciliation, and workflow orchestration.</p><h1>Hanzo Treasury - Programmable Financial Infrastructure</h1>
|
|
<p><strong>Category</strong>: Hanzo Ecosystem <strong>Related Skills</strong>: <code>hanzo/hanzo-payments.md</code>, <code>hanzo/hanzo-commerce.md</code>, <code>hanzo/hanzo-ledger.md</code></p>
|
|
<h2>Overview</h2>
|
|
<p>Hanzo Treasury is a <strong>programmable financial infrastructure</strong> stack providing a double-entry ledger, payment connectors, virtual wallets, reconciliation, and workflow orchestration. Go monorepo (forked from Formance Stack). Uses Earthly for builds. License: MIT.</p>
|
|
<h3>Why Hanzo Treasury?</h3>
|
|
<ul><li><strong>Double-entry ledger</strong>: Immutable, programmable source of truth for all financial transactions</li><li><strong>Numscript DSL</strong>: Domain-specific language for modeling complex monetary flows</li><li><strong>50+ payment connectors</strong>: Unified API for payment processing across providers</li><li><strong>Virtual wallets</strong>: Multi-currency with hold/release mechanics</li><li><strong>Reconciliation</strong>: Auto-match ledger entries against payment provider data</li><li><strong>Workflow orchestration</strong>: Composable payment and treasury operation flows</li><li><strong>Event-driven</strong>: JSON Schema-validated events across all services</li></ul>
|
|
<h3>Tech Stack</h3>
|
|
<ul><li><strong>Language</strong>: Go (module: <code>github.com/formancehq/stack</code>, Go 1.22)</li><li><strong>Build</strong>: Earthly (v0.8)</li><li><strong>Events</strong>: Go + Node.js (JSON Schema validation with <code>gojsonschema</code>)</li><li><strong>API</strong>: OpenAPI 3.0.3 (merged spec from all sub-services)</li></ul>
|
|
<h3>OSS Base</h3>
|
|
<p>Repo: <code>hanzoai/treasury</code> (Formance Stack fork). Default branch: <code>main</code>.</p>
|
|
<h2>When to use</h2>
|
|
<ul><li>Recording financial transactions with double-entry accounting</li><li>Payment routing across multiple providers</li><li>Multi-currency virtual wallet management</li><li>Reconciling ledger data against external payment sources</li><li>Orchestrating multi-step payment workflows</li><li>Modeling complex fee splits and fund distributions with Numscript</li></ul>
|
|
<h2>Hard requirements</h2>
|
|
<ol><li><strong>Go 1.22+</strong> for building</li><li><strong>Earthly</strong> for the build system</li><li><strong>PostgreSQL</strong> for ledger and payment data storage</li><li><strong>Docker</strong> for running the full stack locally</li></ol>
|
|
<h2>Quick reference</h2>
|
|
<p>| Item | Value | |------|-------| | Ledger API | <code>POST /v2/ledger/{name}/transactions</code> | | Accounts API | <code>GET /v2/ledger/{name}/accounts</code> | | Payments API | <code>POST /v2/payments</code> | | Wallets API | <code>POST /v2/wallets</code> | | Reconciliation API | <code>POST /v2/reconciliation/policies</code> | | Local Port | 3068 (ledger) | | License | MIT | | Repo | <code>github.com/hanzoai/treasury</code> |</p>
|
|
<h2>One-file quickstart</h2>
|
|
<h3>Start local stack</h3>
|
|
<pre><code class="lang-bash">docker compose up -d</code></pre>
|
|
<h3>Create a ledger transaction</h3>
|
|
<pre><code class="lang-bash">curl -X POST http://localhost:3068/v2/ledger/demo/transactions \
|
|
-H "Content-Type: application/json" \
|
|
-d '{
|
|
"postings": [{
|
|
"source": "world",
|
|
"destination": "users:001",
|
|
"amount": 10000,
|
|
"asset": "USD/2"
|
|
}]
|
|
}'</code></pre>
|
|
<h3>Numscript example</h3>
|
|
<pre><code class="lang-numscript">// Transfer with multi-party fee split
|
|
send [USD/2 10000] (
|
|
source = @users:001
|
|
destination = {
|
|
90% to @merchants:042
|
|
10% to {
|
|
50% to @platform:fees
|
|
50% to @platform:reserve
|
|
}
|
|
}
|
|
)</code></pre>
|
|
<h2>Core Concepts</h2>
|
|
<h3>Architecture</h3>
|
|
<pre><code>hanzo/commerce Storefront, catalog, orders
|
|
|
|
|
hanzo/payments Payment routing (50+ processors)
|
|
|
|
|
hanzo/treasury Ledger, reconciliation, wallets, flows <-- this repo
|
|
|
|
|
lux/treasury On-chain treasury, MPC/KMS wallets</code></pre>
|
|
<h3>Components</h3>
|
|
<p>| Component | Description | |-----------|-------------| | <strong>Ledger</strong> | Programmable double-entry, immutable source of truth | | <strong>Payments</strong> | Unified API and data layer for payment processing | | <strong>Numscript</strong> | DSL for modeling monetary computations and flows | | <strong>Wallets</strong> | Multi-currency virtual wallets with hold/release | | <strong>Reconciliation</strong> | Auto-match ledger vs. payment provider data | | <strong>Flows</strong> | Workflow orchestration (via <code>orchestration</code> service) | | <strong>Webhooks</strong> | Event delivery for financial state changes | | <strong>Auth</strong> | Authentication and authorization for treasury APIs | | <strong>Search</strong> | Full-text search across treasury data | | <strong>Gateway</strong> | API gateway for all treasury services |</p>
|
|
<h3>Service Versions (from Earthfile)</h3>
|
|
<p>| Service | Version | |---------|---------| | Ledger | v2.3.1 | | Payments | v3.0.18 | | Wallets | v2.1.5 | | Webhooks | v2.2.0 | | Auth | v2.4.0 | | Search | v2.1.0 | | Orchestration | v2.4.0 | | Reconciliation | v2.2.1 | | Gateway | v2.1.0 |</p>
|
|
<h3>Event System</h3>
|
|
<p>Events are JSON Schema-validated. The <code>events/</code> directory contains:</p>
|
|
<ul><li><code>base.yaml</code> - Common event envelope (type, app, payload)</li><li><code>services/ledger/</code> - Ledger events (e.g., <code>SAVED_TRANSACTION</code>)</li><li><code>services/payments/</code> - Payment events (e.g., <code>SAVED_PAYMENT</code>)</li><li><code>services/orchestration/</code> - Workflow events</li></ul>
|
|
<p>Event validation in Go:</p>
|
|
<pre><code class="lang-go">import "github.com/formancehq/stack/events"
|
|
|
|
err := events.Check(data, "payments", "SAVED_PAYMENT")</code></pre>
|
|
<h3>OpenAPI Specification</h3>
|
|
<p>The <code>releases/</code> directory merges OpenAPI specs from all sub-services into a unified API spec:</p>
|
|
<ul><li>Auth: <code>/api/auth/*</code></li><li>Ledger: <code>/api/ledger/*</code></li><li>Payments: <code>/api/payments/*</code></li><li>Wallets: <code>/api/wallets/*</code></li><li>Webhooks: <code>/api/webhooks/*</code></li><li>Search: <code>/api/search/*</code></li><li>Orchestration: <code>/api/orchestration/*</code></li><li>Reconciliation: <code>/api/reconciliation/*</code></li><li>Gateway: top-level</li></ul>
|
|
<p>Authentication: OAuth2 client credentials (<code>/api/auth/oauth/token</code>).</p>
|
|
<h3>Directory Structure</h3>
|
|
<pre><code>treasury/
|
|
README.md # Project overview
|
|
LLM.md # AI agent documentation
|
|
LICENSE # MIT
|
|
go.mod # Root Go module (github.com/formancehq/stack)
|
|
Earthfile # Earthly build (downloads + merges OpenAPI specs)
|
|
base.Dockerfile # Base Docker image
|
|
events/
|
|
base.yaml # Common event envelope schema
|
|
events.go # Go event validation library
|
|
services/
|
|
ledger/ # Ledger event schemas
|
|
payments/ # Payment event schemas
|
|
orchestration/ # Orchestration event schemas
|
|
generated/ # Auto-generated event code
|
|
libs/
|
|
events/
|
|
generated/ # Generated event library
|
|
releases/
|
|
base.yaml # OpenAPI 3.0.3 base spec
|
|
openapi-merge.json # Config for merging all service specs
|
|
openapi-overlay.json # Spec overlays</code></pre>
|
|
<h3>Integration with Hanzo Stack</h3>
|
|
<ul><li><strong>hanzo/payments</strong> - Payment routing layer (upstream source of payment connectors)</li><li><strong>hanzo/commerce</strong> - Order settlement and storefront</li><li><strong>lux/treasury</strong> - On-chain treasury operations, MPC wallet management</li><li><strong>hanzo/kms</strong> - Secrets and key management</li></ul>
|
|
<h2>Building</h2>
|
|
<pre><code class="lang-bash"># Build all (OpenAPI spec + events)
|
|
earthly +build
|
|
|
|
# Build just the merged OpenAPI spec
|
|
earthly +build-final-spec
|
|
|
|
# Go tests
|
|
go test ./...</code></pre>
|
|
<h2>Troubleshooting</h2>
|
|
<p>| Issue | Cause | Solution | |-------|-------|----------| | Earthly build fails | Missing Earthly CLI | Install with <code>brew install earthly</code> | | Event validation fails | Schema version mismatch | Check <code>events/services/</code> for latest version dir | | API 401 | Missing OAuth token | Get token from <code>/api/auth/oauth/token</code> | | Ledger balance error | Insufficient funds in source | Check account balances via <code>GET /v2/ledger/{name}/accounts</code> |</p>
|
|
<h2>Related Skills</h2>
|
|
<ul><li><code>hanzo/hanzo-payments.md</code> - Payment routing</li><li><code>hanzo/hanzo-commerce.md</code> - E-commerce platform</li><li><code>hanzo/hanzo-ledger.md</code> - Ledger details</li><li><code>hanzo/hanzo-kms.md</code> - Secret management</li><li><code>hanzo/hanzo-sql.md</code> - PostgreSQL backend</li></ul>
|
|
<hr>
|
|
<p><strong>Last Updated</strong>: 2026-03-13 <strong>Category</strong>: Hanzo Ecosystem <strong>Related</strong>: treasury, ledger, payments, wallets, reconciliation, numscript, fintech <strong>Prerequisites</strong>: Go 1.22+, Earthly, Docker, PostgreSQL</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-treasury.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |