PulseLocker – User Guide
PulseLocker lets you create immutable single-use vaults for PLS, pDAI, or HEX.
Each vault unlocks when either a target USD price is met or a backup
time unlock arrives.
Everything is fully on-chain with no admin keys.
The contract is fully verified, immutable, and on-chain, so no one — including the creator — can alter, pause, or access your vault.
1) Choose Asset Type
Start by selecting which token you want to lock:
Each asset has its own PulseX primary and backup price feeds, chosen automatically by USD-normalized liquidity.
2) Set Your Target USD Price
Enter the price (in USD) that must be reached for the vault to unlock via the price condition.
Example: 0.0045 means “unlock when 1 HEX ≥ $0.0045”.
3) Set a Time Unlock (Backup)
Choose a date and time in the future.
This ensures the vault always unlocks eventually even if price conditions fail or feeds are unavailable.
We use two feeds for redundancy: if one pool has low liquidity or stale data, the vault can fall back to the other.
When checking price, the vault automatically picks whichever feed has the larger USD-side liquidity, since that pool gives the most reliable price at that moment.
4) Create the Vault
Connect your PulseChain wallet and click Create Vault.
This deploys a brand-new immutable vault contract that only you own.
5) Deposit Tokens
After creation, simply send PLS / pDAI / HEX to the vault address whenever you want.
There is no deadline — deposit at your leisure.
6) Unlock Conditions
Your vault becomes withdrawable when:
- The target USD price is met, OR
- The time unlock is reached
7) Withdrawing
Once unlocked, click Withdraw.
A 0.5% fee is taken automatically (on successful withdrawals only).
After withdrawal, the vault can never lock tokens again.
8) Accidentally Sent More Funds?
After you withdraw, the vault is considered “finished”.
If you accidentally send new tokens to it, they will never be price-locked.
But the UI will show a Rescue button, allowing you to retrieve them immediately.
9) Single-Use Design
Each vault is intentionally designed as a single-cycle discipline vault:
- Create
- Deposit
- Unlock
- Withdraw once
- Vault becomes inactive except for rescue
10) Managing Your Vaults
- Remove a vault – Click Remove to hide it from your UI (vault remains on-chain).
- Restore all vaults – Click Restore All Vaults to reload every vault created by the connected address.
- Re-add a vault – Paste any vault address into Add Vault Address Manually.
- View-only vaults – You may view and deposit into vaults you don't own, but cannot withdraw.
- Reorder vaults – Use the ▲ / ▼ arrows.
- Minimize / maximize – Collapse or expand a vault using the Min / Max button.
