Skip to content

docs: add research spikes and design docs for issues #49, #60, #114, … - #154

Open
shadow-ghost706 wants to merge 1 commit into
stellar-vortex-protocol:mainfrom
shadow-ghost706:docs/task-spike
Open

docs: add research spikes and design docs for issues #49, #60, #114, …#154
shadow-ghost706 wants to merge 1 commit into
stellar-vortex-protocol:mainfrom
shadow-ghost706:docs/task-spike

Conversation

@shadow-ghost706

Copy link
Copy Markdown

docs: research spikes & design docs for cross-chain proof, multi-bond,
multi-sig (#49 #60 #114 #124)

What this PR does

Delivers all four documentation tasks from the research/design backlog.
No contract code is changed — these are design docs and research spikes
that unblock future implementation work.


Changes

File Issue Summary
docs/49-cross-chain-proof-spike.md #49 Surveys Acurast, DIA,
Chainlink CCIP, Wormhole, LayerZero, and ZK light clients for source-chain
proof delivery to Stellar. Recommends Wormhole generic messaging (only
production-ready option with a live Stellar integration and no per-message
fee).
docs/60-multi-bond-token-design.md #60 Full data-model redesign to
support multiple bond tokens with per-token accounting. Covers new storage
keys, updated API signatures, lazy migration for existing SolverRecord
entries, and a complete test matrix.
docs/114-multisig-admin-design.md #114 Evaluates native Stellar
multi-sig vs in-contract logic vs external guardian contract. Recommends
using a native Stellar multi-sig account as Admin — zero contract
changes required. Includes CLI setup script, key-holder policy, signer
rotation ceremony, and an optional PauseGuardian split for fast incident
response.
docs/124-proof-verification-interface.md #124 Concrete interface
design for ProofRegistry (new contract), changes to fill_intent
(opt-in require_proof flag), VortexDeposit.sol sketch for source
chains, VAA payload layout, and a 3-phase rollout plan that introduces
proof gating without breaking existing fills.

Closes

Closes #49
Closes #60
Closes #114
Closes #124


Testing

These are documentation-only changes. No build or test changes are
included.
Implementation PRs for each design will reference this PR and include the
corresponding contract changes and test coverage.


Reviewer notes

…rotocol#49, stellar-vortex-protocol#60, stellar-vortex-protocol#114, stellar-vortex-protocol#124

- docs/49-cross-chain-proof-spike.md: survey of oracle/messaging options
  for source-chain proof verification; recommends Wormhole generic messaging
  Closes stellar-vortex-protocol#49

- docs/60-multi-bond-token-design.md: full data-model redesign for per-token
  bond accounting, migration strategy, and updated API surface
  Closes stellar-vortex-protocol#60

- docs/114-multisig-admin-design.md: evaluation of native Stellar multi-sig
  vs in-contract logic; operational recommendation (no contract changes needed)
  Closes stellar-vortex-protocol#114

- docs/124-proof-verification-interface.md: ProofRegistry contract interface,
  fill_intent changes, VortexDeposit sketch, and phased rollout plan
  Closes stellar-vortex-protocol#124
@drips-wave

drips-wave Bot commented Jul 26, 2026

Copy link
Copy Markdown

@shadow-ghost706 Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

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

Labels

None yet

Projects

None yet

1 participant