Help.
Answers to the most common issues. If yours isn't here, open a ticket and we'll get to it.
Desktop validator client
The app is stuck in a Recovery loop — Reset, sync, error, Recovery again.+
You are on Operator 0.6.18 or older. The bundled node in that build cannot decode blocks on the current testnet format. Reset won't help.
Download 0.6.19 or newer from testnet.asentum.com/downloads and install over the top. The auto-updater should also prompt on next launch.
macOS says the app is damaged and can't be opened.+
The mac build is currently unsigned — Gatekeeper blocks it on first launch. Two ways past it:
Recommended: Right-click Asentum Operator.app in /Applications, choose Open, then click Open in the confirmation dialog. Only needed the first time.
Terminal fallback: xattr -cr "/Applications/Asentum Operator.app", then double-click normally.
A signed + notarized build is in the pipeline.
Windows SmartScreen says "Windows protected your PC."+
The .exe is unsigned. Click More info, then Run anyway. Same as any unsigned Windows installer.
I hit "Start Over" and now my wallet is gone but the validator is still bonded.+
Known issue in older builds — Start Over wipes the local wallet+key but the bond stays on-chain, which orphans the validator. Import your key backup (Settings → Import wallet key) if you have it. If not, contact us with your wallet address; we can look up the tx history.
Balance, imports, MetaMask
My balance shows 0 but I know I received ASE.+
Check three things:
- Your app is pointed at the current testnet — chain id
1337, RPChttps://testnet.asentum.com. - You haven't typed the address in mixed case. Wallet lookups are case-insensitive but explorers sometimes normalise differently.
- Testnet was last reset on 2026-07-02. Balances from before that date do not carry forward. If you received a distribution, it was re-sent post-reset.
How do I add Asentum Testnet to MetaMask?+
Add a custom network:
- Network name:
Asentum Testnet - RPC URL:
https://testnet.asentum.com - Chain ID:
1337 - Currency symbol:
ASE - Block explorer:
https://explorer.asentum.com
I lost my Operator key. Is my bond gone?+
The bond is on-chain but the validator key on your machine was the only way to sign for it. Without a backup, that specific validator slot is unrecoverable. This is one of the things we're working to consolidate — future builds bind wallet + validator identity to a single key.
One-liner + earning rewards
How do I run a validator on a VPS?+
On any Ubuntu/Debian VPS with a public IP and Node 22 available:
curl -fsSL https://testnet.asentum.com/install/validator | bashThe installer sets up systemd, generates a validator key, fetches the chain snapshot, funds a small bond via the faucet, and starts producing. Total time about 5 minutes.
My validator is bonded and active, but my balance isn't growing.+
Two possibilities:
- Fixed 2026-07-08: before that date, external validators' signatures were being buffered but not included in the on-chain LastCommit cert, so reward math skipped them. Fully resolved now — no user-side action needed.
- Rewards are stake-weighted. At a 51,000 ASE bond you earn roughly 0.002 ASE per block signed. That's ~130 ASE per day of continuous participation, not thousands. Higher stake earns proportionally more.
The installer script hangs at "Press ENTER once you've saved it…"+
Non-interactive runs (Docker, remote SSH pipe) block on the seed-backup prompt. Latest installer times out after 30s automatically. If you're still on the old version, either paste into your own SSH session (interactive TTY) or re-fetch the installer: curl -fsSL https://testnet.asentum.com/install/validator.
My validator is behind NAT — will it still earn rewards?+
Yes. NAT'd validators use pull-mode: the node polls the baked relays for proposals, signs locally, POSTs the precommit back. Pull-mode is on by default in the installer. The rewards path treats pull-mode and direct-mode signatures identically.
Getting test ASE
The faucet says "rate limited — try again in Xs."+
One drip per IP per hour with a 500 ASE default cap. Bonded validators can request up to 51,000 ASE per drip (needed for the bond+gas floor). Rate limits reset on a rolling window per IP.
The faucet returned "accepted" but my balance never credited.+
Nonce desync on the faucet wallet, usually right after a chain reset or a mass validator restart. Report the timestamp and your address; we bounce the faucet primary and the drip retries within a minute. Fixed in most cases automatically by the retry-on-drip logic in the installer.
Secrets on-chain
How do I store an API key so my contract can use it?+
Use the Vault Explorer in the IDE at ide.asentum.com/vault — pick a Worker (asentum-default is the free hosted one), paste the secret, set the ACL to the contract that's allowed to trigger decryption. That's it.
The plaintext is encrypted with X25519 + ML-KEM-768 hybrid to the Worker's public key. Ciphertext lives on-chain. Only the Worker with the matching private key can decrypt, and only on authorized on-chain requests.
What can the hosted asentum-default Worker call?+
The whitelist currently covers resend, openai, slack, telegram, github, and httpbin. Free during testnet. To reach a different domain, deploy your own Worker daemon and update the policy hash — instructions in the Workers docs.
Testnet resets + status
Why does testnet get reset?+
Every reset ships a specific architectural change that requires fresh genesis — usually a change to block format, a new genesis-baked contract, or a chain-id migration. We announce ~24h ahead in Telegram. Last reset: 2026-07-02 (LastCommit cert + genesis-baked Vault/WorkerRegistry).
The chain looks stuck. Where do I check?+
Live status at explorer.asentum.com — if the head isn't advancing there, it isn't for you either. Our on-call sees the same page. If the explorer looks healthy but your node doesn't, it's a client-side problem — open a ticket with your node logs.
Didn't find it?
OPEN A TICKET →