Trust Stack Docs
Security

Contract verification matrix

What each Move module does, which behaviors are exercised, and where test evidence stops.

Trust Stack tests contracts at three different boundaries. Move tests execute the contract bytecode and prove expected state transitions or aborts. TypeScript tests exercise the exact builders, readers, event decoders, and reconciliation rules used by the dApp. Browser tests then verify that a person can reach each workflow, review a draft, connect a deterministic wallet, and receive actionable feedback on both desktop and mobile.

Those layers complement one another. A browser mock cannot prove Move conservation, and a Move test cannot prove that a labelled field remains usable on a phone.

Core package

The core package currently has 291 passing Move tests and 95.37% instruction coverage. Every value-bearing module has a successful lifecycle plus authorization, amount, time, replay, and custody tests appropriate to its state machine.

ModulePublic operationPositive evidenceAdversarial and boundary evidenceCoverage
foundationVersion and schedule boundsReturns package policy constantsMaximum-horizon equality and overflow-safe boundary behavior100.00%
fee_configInitialize, govern, renounce, and collect feesQueued bounded changes with a 60-second testnet activation delay and separate governor, treasury, and collector rolesMissing configuration, unauthorized/premature/duplicate actions, pending-change conflicts, role rotation, terminal-schedule binding, and irreversible renunciation95.71%
asset_policyRecord advisory asset assessmentsCompatible external-asset custody without admission and optional issuer-capability risk disclosureWrong council, premature/expired assessment, council-rotation acceptance, invalid risk flags, and maximum schedule horizon91.42%
token_factorycreate, mint, burn, rotate or renounce authorityFixed and capped creation, creator minting, holder self-burn, and creation-fee collectionWrong controller, disabled capabilities, zero values, zero recipient, cap enforcement, and authority rotation92.22%
fixed_lockcreate, claim, sweep_surplusExact deposit, fixed creation fee, and one-time beneficiary releaseEarly, wrong-beneficiary, duplicate, zero-value, dispatchable-asset, surplus, and issuer-capability cases96.29%
vestingcreate, claim, revoke, sweep_fees, sweep_surplusCliff, linear, and stepped settlement with optional revocation, snapshotted in-kind claim fees, and exact final remainderInvalid schedules, vested/unvested split, fee rounding, wide arithmetic, early/duplicate/wrong-beneficiary claims, and hostile asset authority97.25%
batch_distributionsendAtomic distribution to the requested recipientsEmpty, mismatched, oversized, duplicate, zero, overflowing, and dispatchable batches98.94%
merkle_airdropcreate, claim, reclaimValid claims and post-deadline remainder recoveryReplay, recipient mismatch, invalid root/node/depth/window/allocation, equal-node ordering, duplicate reclaim, and vault isolation94.53%
digital_asset_factorycreateOne standard Digital Asset minted to its first ownerEmpty identity/URI and zero-recipient rejection97.86%
digital_asset_lockcreate, claimExact owner-gated object custody and beneficiary releaseWrong owner/beneficiary, early/duplicate claim, retained transfer authority, and non-owner-gated assets96.55%
payment_streamcreate, claim, cancel, sweep_surplusAccrual claims, creator refund of only unearned value, and post-cancellation beneficiary claimsWrong role, premature or repeated actions, frozen beneficiary, invalid schedule/value, non-cancelable streams, surplus, and vault isolation96.24%
staking_poolCreate, stake, claim, withdraw, and recover bounded surplusJoin-time reward accounting, repeated claims, withdrawal, and creator recoveryWrong owner, early/duplicate/empty actions, live-stake recovery, denominator changes, surplus isolation, and update-frequency neutrality94.63%

Isolated packages

The Dexlyn V1 adapter is deliberately outside the core package. Its 11 tests exercise the isolated coin vault, exact release, pool-provenance guard, beneficiary authorization, timing, one-time claim, and zero-value boundaries. It has 89.17% instruction coverage. The thin public wrapper that calls Dexlyn's native router can only be completed against a registered testnet pool; the repository does not replace that external integration with a fake claim of coverage.

The fixed-supply test token has 5 passing tests and 94.90% coverage. They exercise one-time deployer initialization, exact supply, normal primary-store transfers, zero-recipient rejection, non-deployer rejection, and duplicate initialization.

What the browser suite proves

The browser suite covers every non-dynamic dApp route in Chromium and Pixel 7 emulation. It checks page status, headings, horizontal overflow, shared Shadcn controls, incomplete-draft feedback, grouped mobile navigation, deterministic StarKey connection, network recovery, and representative workflow transitions. Component integration tests cover successful immutable-version fee-proof, prepare, sign, finalize, event-match, and state-reread paths for every dApp operation. Separate live acceptance records cover token, lock, batch, vesting, airdrop, stream, staking, Digital Asset, and browser-signed create/revoke lifecycles; browser mocks are not presented as a substitute for those receipts.

Honest limits

Passing tests do not establish mainnet safety. The remaining external gates are a real registered Dexlyn LP lifecycle, independent review, a production asset-attestation policy, accepted formal or executable invariant evidence, production governance/operations approval, and stronger proof-provider independence. These limits are release decisions, not lines that can be made green by weakening a test or inventing local chain evidence.

On this page