Ukiyo NetworkDeveloper Docs
Reference

Deployment Guide

Ship in layers: contracts first, then oracle publishers, then agency runtimes.

Order of operations

  1. Deploy / verify Solidity contracts on Arbitrum; record addresses.
  2. Configure L1 anchor + timelock destinations.
  3. Bring up Kafka + oracle publishers in degraded-safe mode.
  4. Enable Agency with empty/highly restricted allowlist; expand gradually.
  5. Open monitoring dashboards before enabling advances.

Foundry broadcast

forge script script/Deploy.s.sol:Deploy \
  --rpc-url $ARB_RPC_URL \
  --broadcast \
  --verify

Oracle rollout

  • Start with state=Degraded (publish scores, consumers ignore advances).
  • Validate calibration and freshness SLOs.
  • Flip to Active only when consumers pass integration checks.

Observability

SignalAlert when
Attestation age> freshness window
Sequencer block lagstall > 30s
Policy rejectionssudden spike
Escalationsabove baseline
Spool utilizationtranche bounds breached

This docs site

Deploy docs.ukiyo.network as its own Vercel project from this repository. Add a CNAME docs → cname.vercel-dns.com at Spaceship DNS.

npm run build
# output: dist/
# point Vercel root to this repo; domain: docs.ukiyo.network
Main site link

Keep whitepapers on ukiyo.network/whitepapersand link “Documentation” to this subdomain.