Managing Transactions
Everything you do with your Kleidi wallet goes through the timelock. This guide covers how to propose, review, and execute transactions.
The Timelock Flow
Every transaction follows the same pattern:
- Propose - A signer creates and signs a proposal
- Wait - The timelock delay period passes
- Execute - Anyone can execute the transaction
- Or Cancel - A signer can cancel before execution
[Screenshot: Timeline diagram showing propose > wait > execute flow]
Creating a Transaction
Starting a Proposal
From your dashboard, click "New Transaction" or "Propose Transaction".
[Screenshot: New Transaction button location]
Choose what type of transaction you want to create:
- Send Tokens - Transfer ETH or ERC-20s
- Contract Interaction - Call any smart contract
- Settings Change - Modify wallet configuration
[Screenshot: Transaction type selection menu]
Send Tokens
The most common transaction type. Here's how to set it up:
1. Enter recipient address
Paste the address you want to send to. Double-check it.
[Screenshot: Recipient address input field]
2. Select token and amount
Pick from the tokens in your wallet. Enter how much to send.
[Screenshot: Token selector and amount input]
3. Review and confirm
Check the transaction details. Once you're sure, click "Propose Transaction".
[Screenshot: Transaction review screen]
4. Sign with your wallet
Your wallet will pop up asking you to sign. This creates the proposal on-chain.
[Screenshot: MetaMask signature request]
Contract Interaction
For advanced users who need to call smart contracts directly.
Enter contract address - Where you're calling
Enter function data - The calldata for the function you want to call
Set value - Amount of ETH to send (usually 0)
[Screenshot: Contract interaction form with address, data, and value fields]
This requires understanding how to encode contract calls. Most users won't need this.
Viewing Proposals
Pending Proposals
These are transactions waiting for the timelock delay to pass.
Navigate to "Pending" in the transactions tab to see them all.
[Screenshot: Pending proposals list showing scheduled transactions]
Each proposal shows:
- What it does - Transfer, settings change, etc.
- When it was scheduled
- When it can execute - Countdown timer
- When it expires - If not executed in time
Proposal Details
Click any proposal to see full details:
[Screenshot: Proposal detail view with all transaction information]
You'll see:
- Complete transaction data
- Who proposed it
- Exact execution time
- Expiration time
- Current status
Executing Transactions
Once the timelock delay has passed, anyone can execute a proposal.
Find the ready proposal in your pending list. It will show "Ready to Execute".
[Screenshot: Proposal marked as "Ready to Execute"]
Click "Execute" and sign the transaction.
[Screenshot: Execute button and confirmation]
The transaction runs and moves funds or updates settings as specified.
Note: You pay gas for execution, even though anyone can do it. Usually the person who needs the transaction executed will do it.
Canceling Proposals
If something's wrong or you changed your mind, you can cancel any pending proposal.
Open the proposal you want to cancel.
Click "Cancel Proposal" at the bottom.
[Screenshot: Cancel button on proposal detail page]
Sign the cancellation in your wallet.
This immediately removes the proposal from the queue. It can't be un-canceled.
Why cancel?
- You spotted an error in the transaction
- Plans changed
- You think it might be unauthorized
- Testing and want to clean up
Execution Window
Proposals don't stay executable forever. After the timelock delay passes, you have an "expiration period" to execute.
[Screenshot: Timeline showing delay period, execution window, and expiration]
If you miss the execution window, the proposal expires. You'll need to schedule it again (and wait through the full delay again).
Check your expiration period in Settings. Common setups use 7-14 days.
Transaction History
View all past transactions in the "History" tab.
[Screenshot: Transaction history list showing completed and canceled transactions]
This shows:
- Executed transactions
- Canceled proposals
- Who initiated each one
- When it happened
Use this to audit activity and track what's been done with your wallet.
Common Questions
Can I speed up a transaction?
No. The timelock delay is fixed. You can't skip it or speed it up. That's the whole security model.
What if I send a transaction to the wrong address?
Cancel it immediately. As long as the timelock delay hasn't passed, you can cancel and prevent the send.
Who can execute a transaction?
Anyone. Execution is permissionless after the delay passes. Usually signers execute their own proposals, but technically anyone could do it and pay the gas.
What happens if a proposal expires?
It becomes invalid and can't be executed. You'd need to create a new proposal with the same parameters and wait through the delay again.
Can I batch multiple operations?
Yes, through contract interaction. You can call a multicall contract to execute several operations in one transaction. This is advanced usage.
Do I need all signers to propose?
No, any single signer can propose. But you need the threshold number of signatures to actually schedule it on-chain. The app handles collecting signatures from other signers if needed.