Frequently asked questions.

62 questions, grouped by what you are trying to work out. Every answer is on this page. Nothing is hidden behind a click.

Getting started#

What is HoodLock?#

HoodLock is a non-custodial token locker, burner and vesting platform on Robinhood Chain. It holds ERC-20 tokens until a date you set, sends tokens permanently to the dead address, or releases them gradually to a beneficiary, and gives every record a public page anyone can verify.

Do I need an account?#

No. There is no sign-up, no email and no password. Connecting a wallet is the only identity involved, and browsing proof pages or the explorer needs no wallet at all.

Which chain does HoodLock run on?#

Robinhood Chain only, chain id 4663. It is an Ethereum L2 built on the Arbitrum stack, with ETH as the gas token. Full parameters are on the network page.

Which wallets are supported?#

Any wallet that supports Robinhood Chain. Browser extensions are discovered automatically, and WalletConnect covers mobile wallets. See connecting a wallet.

How long does locking take?#

Two transactions and about a minute. The first approves the amount, the second creates the lock. See the quickstart.

Can I try it with a small amount first?#

Yes, and it is a reasonable thing to do. The fee is flat rather than a percentage, so a test lock costs the same as a large one, but nothing stops you locking a token dust balance to see the flow end to end.

Costs#

How much does it cost to lock tokens?#

A flat 0.005 ETH per lock, plus gas. No percentage of your tokens is taken at any point. Full breakdown on the fees page.

Is there a fee to withdraw?#

No. Withdrawing an expired lock costs gas only. The fee is charged once, when the lock is created.

Is there a fee to claim vested tokens?#

No. Claiming is free apart from gas. The vesting fee is charged once, at creation.

Does extending a lock cost anything?#

No fee, just gas. That is deliberate — extending should be the cheapest option, because it is usually the right one. See extending a lock.

Do you take a percentage of locked tokens?#

No, never, at any stage. The fee is a flat amount in ETH. A locker paid in your token has a reason to prefer larger locks over appropriate ones, which is precisely the incentive a flat fee avoids.

Can the fee change?#

Yes, but only for new records. An existing lock or schedule is never re-priced. The vesting contract has a hard cap of 0.05 ETH written into the code; the locker and burner do not. See fees.

What happens if I overpay the fee?#

The locker and burner refund the difference automatically. The vesting contract requires the exact fee and reverts on overpayment. It has no refund path.

Locking#

Can locked tokens be withdrawn early?#

No. The contract checks the unlock time on every withdrawal and reverts before it. There is no override and no admin path. See the security model.

Who owns locked tokens?#

You do. The lock records your address as the owner, and only that address can withdraw, and only after the unlock time. HoodLock never gains the ability to move them.

Can the team unlock tokens early?#

Not if they are locked with HoodLock. No function exists that shortens a lock or releases it ahead of schedule, so it is not a matter of policy or goodwill.

Can I extend a lock?#

Yes, as many times as you like, for free. Unlock dates can always be pushed further out and can never be pulled in. See extending a lock.

Can I shorten a lock?#

No. The contract requires any new unlock time to be strictly later than the current one. That asymmetry is what makes an unlock date a commitment rather than a preference.

Can I unlock part of a lock early?#

No. A lock is a single record with one amount and one date. If you need staggered access, create several locks with different dates rather than one large one.

Can I add more tokens to an existing lock?#

No — create a second lock. Locks are independent records, which also means they can carry different dates.

What happens when a lock expires?#

Nothing automatic. The tokens stay in the contract until the owner withdraws, and can stay there indefinitely. See when a lock expires.

Can I transfer a lock to another wallet?#

Yes. Ownership of the lock can be transferred to a new address, which then holds the right to withdraw. The tokens themselves do not move.

What can be locked?#

Any ERC-20 on Robinhood Chain, including v2-style LP tokens. Uniswap v3 and v4 positions are NFTs and cannot be locked. See the liquidity locker.

Is there a minimum lock duration?#

For locks, no — any time in the future is valid. Vesting schedules must run at least 24 hours.

Is there a maximum lock duration?#

No practical maximum. Choose a date you can defend rather than the largest number available.

Do I keep earning staking rewards on locked tokens?#

No. Locked tokens sit in the locker contract, so anything that depends on holding them in your own wallet — staking, airdrops, governance — will not see them.

Liquidity#

Can I lock LP tokens?#

Yes, if they are v2-style — those positions are ERC-20 tokens. See locking LP tokens.

Why can't I lock my Uniswap v3 position?#

A v3 or v4 liquidity position is an NFT, not an ERC-20 token. The HoodLock locker holds ERC-20s, so it cannot hold one. Many launchpads already lock or burn those positions at graduation.

How do I tell whether my LP is v2 or v3?#

A v2 position appears in your wallet as a token balance, usually with a symbol like UNI-V2, and its pair contract has totalSupply(). A v3 position does not appear as a token at all. More in the liquidity locker.

Does locking LP stop the pool from trading?#

No. Locking the LP token prevents liquidity being withdrawn. Swaps, fees and price discovery all continue exactly as before.

Should I lock or burn liquidity?#

Burning is permanent and needs no trust; locking is temporary and keeps the option to migrate. The comparison covers when each fits.

My launchpad already locked the liquidity. Do I need to do anything?#

Not for the liquidity. What usually remains is fee revenue, a creator buy from the curve, or a treasury — ordinary balances that a holder looks at once liquidity is settled.

How long should I lock liquidity for?#

Long enough to outlast whatever people are worried about. Because extending is free and shortening is impossible, err short and extend — the full discussion.

Vesting#

What is the difference between a lock and vesting?#

A lock releases everything on one date; vesting releases gradually, optionally after a cliff. Locks vs vesting vs burning compares them properly.

Can a vesting schedule be cancelled?#

Not by HoodLock. There is no revoke, sweep or rescue function. The token is the exception: an upgradeable, pausable or blacklisting token can still freeze or devalue a schedule afterwards. See token vesting.

Can I edit a vesting schedule after creating it?#

No. Not the amount, not the dates, not the recipient. This is the one action on HoodLock where a mistake cannot be corrected.

What is a cliff?#

A date before which nothing is claimable, even though time is accruing. When it passes, everything earned to that point becomes claimable at once — why holders look for one.

Who can claim vested tokens?#

Only the current beneficiary. The creator cannot claim on their behalf and cannot redirect the schedule.

Do unclaimed vested tokens expire?#

No. They accumulate and stay claimable indefinitely. There is no deadline and nothing is lost by claiming late.

Can the beneficiary be changed?#

Yes, but only by the current beneficiary — for a wallet change or a handover. The creator cannot do it for them.

Can I vest for a whole team at once?#

Yes — up to 200 beneficiaries in one transaction, sharing the same token and timing. See creating a schedule.

Can a vesting schedule start in the past?#

Yes, and it is legitimate for teams vesting from a date people actually joined. But a schedule that is already half claimable on day one is in practice half a transfer, and the proof page shows that percentage.

Why did my vesting transaction revert?#

Most often the 24-hour minimum duration, or an inexact fee — vesting requires msg.value == fee exactly. More causes in troubleshooting.

Burning#

What does burning actually do?#

It transfers tokens from your wallet to the dead address in a single hop and writes a permanent record of the amount, the token and the time.

Can burned tokens be recovered?#

Not through HoodLock, and the dead address has no private key. But a mintable token can re-issue the amount and an upgradeable one can move the dead address balance. See token burning.

Why burn through HoodLock instead of sending to the dead address myself?#

Both destroy the supply. Only one produces an indexed record and a page stating the amount and share of supply that a reader can check without knowing how to use a block explorer.

Do burned tokens sit in your contract first?#

No. The transfer goes straight from your wallet to the dead address. There is no intermediate custody step.

Verification and trust#

How do investors verify a lock?#

By opening the proof page, checking the token address matches what is actually trading, reading the share of supply rather than the raw token count, and checking the date. Full method: verifying a lock.

Can I verify a lock without a wallet?#

Yes. Proof pages, token pages and the explorer all work with no wallet and no account.

What is a proof page?#

A public URL for a single record that renders current on-chain state and links to the transaction. See proof of lock.

Does a lock mean a token is safe?#

No. A lock is evidence about one balance and says nothing about the token contract or the rest of the supply — the other checks.

Someone showed me a screenshot of a lock. Is that enough?#

No. Ask for the link and open it yourself, then confirm the token address on the page matches the token you would actually buy. Symbols repeat; addresses do not.

Can HoodLock take my tokens?#

No function exists that would let us, and all three contracts are verified so you can check rather than trust — the security model names the exact functions to read.

What can the admin do?#

Change the fee for new records, change the fee collector, and transfer the admin role. No admin function can touch an existing lock, schedule or balance.

How can I check the contracts myself?#

All three are verified on Blockscout, so the source you read is the bytecode that runs. The security model names the exact functions to search for and what you should find.

What happens if HoodLock disappears?#

The contracts keep running. They are deployed on-chain and do not depend on our site. You can call withdraw or claim directly from a block explorer. The proof pages would go, the funds would not.

Developers#

Can I add locking to my own site?#

Yes — an embed widget that is one script tag, or a REST API returning prepared transactions.

Can I style the button myself?#

Yes. The widget attaches a click handler and nothing else. It sets no classes, no inline styles and no attributes affecting appearance. Your button stays entirely yours.

Is the API key secret?#

No, it is public by design, in the same sense as a Stripe publishable key. It credits actions to you and cannot move funds, read balances or reach admin. Embedding it in frontend source is the intended use.

How much do partners earn?#

50% of the fee on every lock, burn and vesting schedule created by a wallet they introduced, claimable to their own wallet once the balance passes $10.

Can I offer only locking, without burn and vesting?#

Yes. Each button is independent — a lock-only integration is a single button with no extra attributes. You earn on whichever products you add.

Do the API endpoints support CORS?#

Yes, they send permissive CORS headers and work from a browser. Note that the API key is passed as a query parameter on GET and a body field on POST. There is no header form, because the CORS policy allows Content-Type only.