Skip to content

docs: Document underwriting setup and production launch - #184

Open
valthon wants to merge 1 commit into
masterfrom
docs/underwriting-operations
Open

valthon wants to merge 1 commit into
masterfrom
docs/underwriting-operations

Conversation

@valthon

@valthon valthon commented Nov 10, 2026 •

Copy link
Copy Markdown
Contributor

Document automatic underwriting setup and the production launch funding handoff. The funding party syndicates real LIQ before launch, the epoch-zero import credits or parks that position, and the funder transfers liquid shadow LIQ to each batch operator shortly after WIRE goes online.

The production section includes placeholders for accounts, external identities, per-operator allocations, exposure caps, and the funding owner/completion target. It covers account linking, keeping relays operational during funding, a sysio.liq::transfer template, read-only acceptance checks, reconciliation of liquid balances and unclaimed bonds, and requests that approach the outpost retention window.

The playbook also clarifies external-outpost startup, verification artifacts and RPC sources, normal scheduling, INVALID-bond recovery, and draining pending envelopes before replacing an outpost deployment.

@valthon
valthon marked this pull request as ready for review November 10, 2026 16:25
@valthon
valthon force-pushed the docs/underwriting-operations branch from 7f1bbf4 to fed6304 Compare November 10, 2026 18:53
@valthon valthon changed the title docs: Update syndication underwriting operations docs: Document underwriting setup and production launch Nov 10, 2026
Clarify daemon startup, verification artifacts, timing and recovery for
automatic syndication underwriting.

Document production seed capital from pre-launch syndication through the
epoch-zero import and funding-account link, followed by liquid shadow-LIQ
transfers to every batch operator after WIRE starts. Keep launch accounts,
allocations and caps as placeholders and provide read-only acceptance
checks for the funding handoff.
@valthon
valthon force-pushed the docs/underwriting-operations branch from fed6304 to 0ffed86 Compare November 10, 2026 19:17
@valthon
valthon requested a review from heifner November 10, 2026 19:40

@heifner heifner left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Checked the playbook against wire-sysio master, wire-tools-ts master and the outposts' next. The harness behaviour (sync-only operator nodes under --external-outpost-config, full args in start.sh / run), the plugin timings and halt message, the retention limits and the depot actions named here all match the code. Two things to fix, inline.

Comment on lines +179 to +180
clio -u "$WIRE_RPC" get table sysio.liq "<FUNDER_WIRE_ACCOUNT>" accounts
clio -u "$WIRE_RPC" get table sysio.liq "<BATCH_OPERATOR_WIRE_ACCOUNT>" accounts

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These fail as written. clio get table takes two positionals (account table); the scope goes in -S:

$ clio get table sysio.liq someacct accounts
ERROR: table: The following argument was not expected: accounts

sysio.liq balances are scoped by holder, so:

Suggested change
clio -u "$WIRE_RPC" get table sysio.liq "<FUNDER_WIRE_ACCOUNT>" accounts
clio -u "$WIRE_RPC" get table sysio.liq "<BATCH_OPERATOR_WIRE_ACCOUNT>" accounts
clio -u "$WIRE_RPC" get table sysio.liq accounts -S "<FUNDER_WIRE_ACCOUNT>"
clio -u "$WIRE_RPC" get table sysio.liq accounts -S "<BATCH_OPERATOR_WIRE_ACCOUNT>"

The four commands under "Existing testnet" (the sysio.bond / sysio.synd / sysio.liq "$OPERATOR" block) have the same three-positional shape on master. This section sends readers to those checks, so they are worth fixing in the same pass.


Use the on-chain WIRE account names from the launch roster
([`wire-opreg-bootstrap.json`](outpost/README.md)), rather than keystore labels
such as `batchop.a`. Inventory and exposure caps are separate: an account can hold

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This and the resource wording will collide with #186, which also edits this file (a trial merge of the two heads conflicts in the opening sentence and the troubleshooting paragraph).

  • Bootstrap Without a Tier-1 Node Owner #186 has sysio create each operator account under its label, so batchop.a becomes the on-chain name. Dropping the example here ("use the account names from the launch roster") stays true either way.
  • Bootstrap Without a Tier-1 Node Owner #186, with wire-sysio#762, removes the bond-row RAM grant. The new text still asks for operator resources in pre-launch step 3 ("Provision each operator's resources"), in launch acceptance ("resources and signing configuration") and in troubleshooting ("insufficient RAM"). Those are correct on master today; whichever PR lands second needs to sweep them.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants