SERV Hackathon - RWA Vaults - IXS
CapitalRail
Check if you can really enter an IXS vault before you sign anything. GO only when deposit capacity is real. How it works · Exit
- Tell us
- We check
- Decision
- Review & sign
Where do you want to put your USDC?
Say it in your own words. We check live IXS vaults before you sign anything.
Exit
Redeem vault shares
Turn shares back into USDC. CapitalRail prepares unsigned redeem and claim steps - you sign, nothing is custodied.
Connect to see your positions
We scan IXS vaults on BSC and Avalanche for shares held by your wallet.
How it works
From a sentence to signable deposit steps, in six checked steps
CapitalRail is a preflight: it answers "can I actually enter this vault right now?" before any capital moves.
Pipeline
Intent to attested deposit
- 1
Intent
you
- 2
Rules
yours
- 3
Scan
IXS vaults
- 4
SERV
decide
- 5
Attest
deposit
Open path
Awaiting scan
CapitalRail path
Blocked vaults
No blockers yet
Naive AVAX path fails here
- 01Chat
Describe your intent
Type what you want to deposit in your own words (amount, chain, KYC, withdrawal speed), or edit your rules by hand.
- 02SERV
SERV turns it into your rules
SERV Reasoning turns your sentence into typed rules validated against a schema. You see what was understood and can edit it.
- 03IXS REST + MCP
Scan the live IXS vaults
CapitalRail reads the 4 live IX High Yield Bond USDC vaults on BSC and Avalanche through the IXS REST API and MCP tools: access mode, deposit limit, whitelist status and settlement mode (including the daily SGT cutoff for async rails).
- 04Code + SERV Reasoning
Rules are code, judgment is SERV
Code applies the hard rules (chain, capacity, KYC, withdrawal speed, balance) and sets GO / WAIT / NO-GO. SERV Reasoning then writes fact-grounded risk notes (NAV-staleness limit 0, settlement clock, redemption ops), cross-checks the rules, ranks the vaults that pass and independently verifies the memo. Every step is schema-validated and traced.
- 05Guardrail
Code-level safety override
Deterministic checks run again after the model. A vault with MCP deposit limit 0 or an unmet whitelist can never be selected, whatever the model says - integrators must not force deposits past limit 0. SERV can veto an entry, never unlock one.
- 06Deposit steps
Review and sign yourself
Only on GO, and only for your connected wallet, IXS tools build unsigned approve + deposit steps. You sign them in order in your own wallet. Nothing is signed server-side. Async deposits still settle against the next cutoff.
Why CapitalRail
A naive agent would deposit. CapitalRail checks first.
The failure case
The Avalanche IX High Yield Bond USDC vault is listed as open, but MCP can report deposit limit 0. Per IXS ops, that often means NAV staleness or drift - not a permanently closed vault. An agent that only reads "open" (or that forces a deposit past limit 0) would build a transaction that fails.
CapitalRail flags DEPOSIT_LIMIT_ZERO, answers WAIT, and refuses that rail until MCP build succeeds. A code-level override enforces it even if the model disagrees. Min deposit on this Avalanche HYB product is 100 USDC; settlement runs against a daily 5:00 PM SGT cutoff.
No custody
SERV and CapitalRail never hold funds. They read public vault data and return a decision.
Nothing signed server-side
Deposit steps are unsigned and built for your connected wallet only. Only you can sign, after review.
Attested snapshot
Each decision carries a snapshot hash and an attestation time, so you know exactly which IXS state it was based on.
Refuses instead of guessing
If MCP reports deposit limit 0 (often NAV stale, not closed forever), CapitalRail says WAIT and explains why - it never forces an unsafe deposit.
For agents
Call CapitalRail before you allocate.
CapitalRail is a preflight gatekeeper, not a desk. Other agents POST here before sending capital to IXS vaults. Humans use the guided flow above; agents use the same REST surface (and optional MCP) to get GO / WAIT / NO-GO with reasons - then only act on GO. MCP deposit limit 0 may mean NAV staleness (not permanently closed); still treat it as WAIT until build succeeds. Async HYB rails settle against a daily 5:00 PM SGT cutoff.
Agents
Parse intent → run preflight → respect WAIT / NO-GO. Unsigned tx pack only on GO with a real wallet. Preview wallet 0x...0001 for public data.
Humans
Tell us → We check → Decision → Review & sign in the browser. Same checks; the UI adds one-click fixes and wallet signing.
Set $BASE_URL = https://capitalrail.ozc.fr (or your host)
Security notes
- No API auth today - rate limited per IP (preflight 6/min, intent 10/min, shared expensive 12/min).
- Browser cross-site Origin is blocked; curl / server-to-server / MCP (no Origin) are allowed.
- 429 returns code RATE_LIMITED with Retry-After. Do not weaken limits from agents.
- Never force a deposit when preflight returns WAIT / DEPOSIT_LIMIT_ZERO - limit 0 can mean NAV stale; CapitalRail waits for a successful MCP build.
curl: POST /api/preflight
Replace $BASE_URL with your host
# CapitalRail preflight - OpenAPI: $BASE_URL/openapi.yaml
curl -s -X POST "$BASE_URL/api/preflight" \
-H 'Content-Type: application/json' \
-d '{
"walletAddress": "0x0000000000000000000000000000000000000001",
"amount": "1",
"preferences": {
"allowKyc": false,
"requireSyncSettlement": false,
"preferredChainId": 56
}
}'curl: POST /api/intent
Free text → mandate
# CapitalRail intent - free text to mandate
curl -s -X POST "$BASE_URL/api/intent" \
-H 'Content-Type: application/json' \
-d '{ "message": "500 USDC on BSC, no KYC, delayed withdrawals ok" }'OpenAI-compatible tools
capitalrail_intent + capitalrail_preflight
[
{
"type": "function",
"function": {
"name": "capitalrail_intent",
"description": "Parse free-text deposit intent into a CapitalRail mandate (amount, KYC, settlement, optional chain). Call before capitalrail_preflight when the user spoke in natural language.",
"parameters": {
"type": "object",
"additionalProperties": false,
"required": ["message"],
"properties": {
"message": {
"type": "string",
"description": "User intent, max 500 characters."
}
}
}
}
},
{
"type": "function",
"function": {
"name": "capitalrail_preflight",
"description": "IXS vault entry preflight. Returns GO / WAIT / NO-GO with reasons, risk notes, and a trace. On GO with a real wallet, may include unsigned approve+deposit. Use wallet 0x...0001 for a public preview (no tx pack). Gatekeeper only - do not allocate until GO.",
"parameters": {
"type": "object",
"additionalProperties": false,
"required": ["walletAddress", "amount", "preferences"],
"properties": {
"walletAddress": {
"type": "string",
"description": "0x-prefixed EVM address."
},
"amount": {
"type": "string",
"description": "USDC amount as a decimal string."
},
"preferences": {
"type": "object",
"additionalProperties": false,
"required": ["allowKyc", "requireSyncSettlement"],
"properties": {
"allowKyc": { "type": "boolean" },
"requireSyncSettlement": { "type": "boolean" },
"preferredChainId": {
"type": "integer",
"enum": [56, 43114],
"description": "56 = BSC, 43114 = Avalanche. Omit for any chain."
}
}
},
"forceRescan": { "type": "boolean" }
}
}
}
}
]Anthropic-style tools
Same two tools, input_schema form
[
{
"name": "capitalrail_intent",
"description": "Parse free-text deposit intent into a CapitalRail mandate. Call before capitalrail_preflight when the user spoke in natural language.",
"input_schema": {
"type": "object",
"additionalProperties": false,
"required": ["message"],
"properties": {
"message": {
"type": "string",
"description": "User intent, max 500 characters."
}
}
}
},
{
"name": "capitalrail_preflight",
"description": "IXS vault entry preflight. Returns GO / WAIT / NO-GO. Gatekeeper only - do not allocate until GO. Wallet 0x...0001 = public preview.",
"input_schema": {
"type": "object",
"additionalProperties": false,
"required": ["walletAddress", "amount", "preferences"],
"properties": {
"walletAddress": { "type": "string" },
"amount": { "type": "string" },
"preferences": {
"type": "object",
"additionalProperties": false,
"required": ["allowKyc", "requireSyncSettlement"],
"properties": {
"allowKyc": { "type": "boolean" },
"requireSyncSettlement": { "type": "boolean" },
"preferredChainId": { "type": "integer", "enum": [56, 43114] }
}
},
"forceRescan": { "type": "boolean" }
}
}
}
]Cursor MCP config
npm run mcp · env CAPITALRAIL_BASE_URL
{
"mcpServers": {
"capitalrail": {
"command": "npx",
"args": ["tsx", "mcp/server.ts"],
"cwd": "/absolute/path/to/CapitalRail",
"env": {
"CAPITALRAIL_BASE_URL": "https://capitalrail.ozc.fr"
}
}
}
}Business model
Every failed deposit avoided is worth something.
Failed deposits avoided on this instance
-
Real count from this server, since start
1 · AI agents and wallets
Preflight API
One POST /api/preflight call before any deposit returns GO / WAIT / NO-GO, reasons, risk notes and an unsigned tx pack. Agents stop sending transactions that fail.
Free tier, then pay-per-check
2 · RWA issuers such as IXS
"Can I enter?" widget + blocked-demand dashboard
A white-label widget for vault pages, plus a dashboard of demand blocked by capacity, KYC or withdrawal rules, so the issuer sees which limit to raise or which onboarding to push.
Monthly license per issuer
3 · Allocators on WAIT
Capacity alerts
When a vault that fits your rules reports MCP deposit limit 0 (often NAV stale - not closed forever), get notified when build succeeds again, with a fresh preflight attached.
Subscription
4 · Partner vaults
Referral on validated deposits
A routing fee only on deposits that passed the preflight and settled on-chain.
Subject to an agreement with IXS
Pricing models, not live revenue. The counter above only counts real results served by this server; it resets on restart.
FAQ