Security
Security model
Onyx is deployed on Solana's test network and has not yet been externally audited. Use test funds only. The demo vault on this site is a browser simulation and holds no assets.
Threat model
How Onyx responds
to each threat
Each row describes what an attacker controls, what they attempt, and the program rule that prevents it.
Known limitations
The boundaries of protection
What Onyx does not protect against, stated plainly, so you can decide what to keep in a vault.
- 01Only vault funds are protected.
Onyx does not control transactions from your regular wallet.
- 02Instant limits can be spent.
Anyone holding your key can move funds up to your instant and daily limits without delay, including transfers to saved addresses within the daily limit. Set limits to an amount you can afford to lose.
- 03Holds delay transfers; they do not block them forever.
If an attacker holds your key, waits out every delay, and no one responds, funds can eventually move.
- 04The safe harbor must be independent.
If it shares a seed phrase or device with your main key, a rescue cannot protect your funds.
- 05Transfers only.
The vault moves SOL and tokens and nothing else: swaps, staking and other applications are not available from inside it. This removes a whole class of phishing attacks, and also means those applications cannot be used with the vault.
- 06Token issuers keep their powers.
A token's issuer can keep a freeze authority over every account, the vault included, and a Token-2022 token can also give its issuer a permanent delegate that can move it. Tokens with transfer hooks cannot be sent or rescued by the vault.
- 07The current program is upgradeable.
Its deploy key can still replace the program. Whether the mainnet program is made immutable or upgradeable behind a delay will be decided before mainnet.
Development status
Progress toward mainnet
Completed work, the current test deployment, and the requirements before mainnet.
- DoneTest-driven program development
42 instruction tests cover every row of the permissions table, with SOL, SPL Token and Token-2022. Property tests (20,000 random cases each) verify the rule logic, and two randomized attack runs (18,000 steps each) verify that the guardian key alone only moves funds to the safe harbor, that the owner key alone cannot execute a hold or loosen a rule early, and that no more funds leave the vault than entered it.
- DoneStatic analysis
Clippy, the Rust linter, reports no findings.
- LiveSolana test network
Vault program
6m7CyxisjrsVNjjcQmHRv3ZjzcnHfjJgpwo7pBjprZrM. Not yet audited, and upgradeable. - PlannedExternal audit
Required before any mainnet launch with real funds.
- PlannedAutomated guardian service
A service that reviews held transactions and sends alerts.