Build

Build a Ward-conformant product without giving up the signer boundary.

Ward provides the SDK surface, API path, and chain adapters needed to ship deterministic default resolution without giving Ward custody or signing authority.

Protocol specification

Five modules. Nine checks. One conformance result.

The Ward conformance engine is deterministic and auditable. Every integration runs the same nine on-ledger checks through the same five modules, returning a machine-readable receipt institutions can inspect.

Read the full protocol specification →

Module 1

WardClient

High-level SDK entrypoint for institutions and integrators.

Module 2

VaultMonitor

WebSocket default detection with authoritative ledger re-verification.

Module 3

ClaimValidator

Nine-step deterministic on-chain claim validation.

Module 4

EscrowSettlement

Unsigned escrow lifecycle for controlled institutional execution.

Module 5

PoolHealthMonitor

Coverage ratio and reserve accounting for pool safety.

Nine on-ledger checks

Check 01

NFT existence and taxon enforcement (WARD_POLICY_TAXON = 281)

Check 02

Policy validity using XRPL ledger close_time, never server clock

Check 03

Vault address binding: metadata vault must equal defaulted_vault

Check 04

LSF_LOAN_DEFAULT flag on LedgerEntry(index=loan_id)

Check 05

Vault loss must be greater than zero drops

Check 06

Pool usable balance must exceed the validated loss amount

Check 07

Replay protection: policy NFT must still be live

Check 08

Claimant must still hold the policy NFT on ledger

Check 09

Pool solvency and rate limits must still hold at settlement

Key constants

WARD_POLICY_TAXON281
MIN_COVERAGE_RATIO1.5
CLAIM_RATE_LIMIT_MAX3
LSF_LOAN_DEFAULT0x00010000
MONITOR_HEARTBEAT_TIMEOUT_S60
XRPL_BASE_RESERVE_DROPS2_000_000

ward_signed = False — always.

Ward returns unsigned payloads only. The institution signs. The chain settles.

Integration architecture

XLS-66, XLS-65, XLS-30, and XLS-20 on the XRP Ledger.

Ward integrates with XLS-66 Lending, XLS-65 Vault, XLS-30 AMM, and XLS-20 NFT on the XRP Ledger. The following shows the settlement pipeline and key calculations.

Settlement timeline

TimeEvent
T + 0Default confirmed on ledger
T + 5 minWard monitor detects lsfLoanDefault
T + 10 minEscrow created — 48 hr dispute lock
T + 48 hrDispute window expires
T + 48 hr 5 minEscrow finishes — claim paid

Monitoring points

ObjectField
LoanlsfLoanDefault
LoanBrokerDebtTotal
VaultAssetsTotal
VaultLossUnrealized

Key calculations

# Drops are the native XRPL integer unit (1 XRP = 1,000,000 drops)

DefaultAmount   = Loan.PrincipalAmount - Loan.PaidAmount
DefaultCovered  = min(DefaultAmount, Policy.CoverageDrops)
VaultLoss       = Vault.LossUnrealized           # set by XLS-65 on default
ClaimPayout     = min(DefaultCovered, VaultLoss)
CoverageRatio   = Vault.AssetsTotal / LoanBroker.DebtTotal  # must be >= 1.5

Integration surface

Start with the SDK. Finish with a conformance receipt.

Python SDK

pip install ward-protocol==0.2.10

Validator services, vault monitors, conformance jobs, and institutional backend flows.

TypeScript SDK

npm install @wardprotocol/sdk

Product consoles, dashboards, rail orchestration, and receipt export.

Hosted API

GET https://api.wardprotocol.org/health

Live API status endpoint for pilot integrations, operational checks, and enterprise onboarding.

Chain adapter catalog

Chain-native rails. One conformance result.

Each rail maps the local chain primitive into Ward's conformance engine. Your product keeps its settlement rail. Ward standardizes the resolution path and the institutional review surface.

Live

Live

XRPL Altnet

@wardprotocol/sdk / xrpl

F01-F03 verified on Altnet; F04-F09 pending XLS-66 vault state availability

Roadmap — scoped, environments provisioned

Roadmap

Flare

@wardprotocol/sdk / flare

Coston2 environment provisioned — scoped on engineering roadmap

Roadmap

XRPL EVM

@wardprotocol/sdk / xrpl-evm

Sidechain environment provisioned — scoped on engineering roadmap

Roadmap

XDC

@wardprotocol/sdk / xdc

Apothem environment provisioned — scoped on engineering roadmap

Roadmap

Polygon

@wardprotocol/sdk / polygon

Amoy environment provisioned — scoped on engineering roadmap

Roadmap

Stellar

@wardprotocol/sdk / stellar

Testnet environment provisioned — scoped on engineering roadmap

Roadmap

Algorand

@wardprotocol/sdk / algorand

Testnet environment provisioned — scoped on engineering roadmap

Roadmap

Solana

@wardprotocol/sdk / solana

Devnet environment provisioned — scoped on engineering roadmap

Pilot readiness timetable

Phase 1–4 from self-serve review to production certification.

01

Self-serve conformance review

Expose the specification, demo workspace, SDK/API surfaces, and receipt model so partners can review Ward without a guided sales call.

Now
02

XRPL/XLS-66 pilot lane

Use the XRPL Altnet path for wallet validation, policy NFT evidence, 3-ledger confirmation, and unsigned settlement review.

30-60 days
03

Cross-chain testnet proof pack

Package Flare, XRPL EVM, XDC, Polygon, Stellar, Algorand, and Solana testnet artifacts into partner-reviewable receipts.

60-120 days
04

Production readiness and certification

Pair the third-party audit path with pilot receipts, mainnet branch readiness, and the public conformance registry.

Mainnet trigger