What to check first
On a test network, compare the chain, recipient, asset and amount to the intended operation. Check a token allowance separately.
Choose a KeySigner setup
| Setup guide | What it does and what to keep available |
|---|---|
| Approve an Ethereum test message → | Verify the selected account’s signature on plain text without submitting a transaction. You need KeySigner on iPhone and a WalletConnect-enabled test app. Keep available The original text and expected signer address. Disconnect the test app after verifying the signature. |
| Send a test ERC-20 token → | Compare the approved token, recipient and amount with the transaction that settles on the test chain. You need Computer tools, KeySigner on iPhone and an Ethereum test network. Keep available The verified token contract, recipient and network details. Read the receipt and recipient balance on that same chain. |
| Review a .eth recipient address → | Confirm where a .eth name leads in a local dry run, then check that a changed record stops the send. You need KeySigner computer tools, KeySigner on iPhone and a local Ethereum test network. Keep available The recipient’s full address confirmed independently. If the record changes, verify the address again before creating a new request. |
| Build and test a browser wallet connection → | Test how your website discovers KeySigner, receives one address and requests a signature. You need KeySigner on iPhone with a test Ethereum account. Keep available An isolated browser profile and a disposable account. End the site connection after verifying the signature. |
More KeySigner setups
- Approve an Ethereum request from Google Chrome →Desktop Chrome, the development extension and KeySigner on iPhone
- Approve an Ethereum request from Firefox →Desktop Firefox, the temporary development add-on and KeySigner on iPhone
- Test an Ethereum network in your browser →KeySigner computer tools, Anvil and Python 3
- Retest an Ethereum site connection in Chrome or Firefox →Desktop Chrome, the development extension and KeySigner on iPhone
What it covers
An account's approval rule does not cancel permissions it already granted to contracts.
Troubleshooting
Does a pending transaction show a different fee or nonce than expected?
Compare the signed transaction fields with the planned operation and the sender's current transaction count on that network.
Check the wallet’s network and the status of its RPC provider. If you have a transaction hash, check for a receipt on that network before submitting another transaction.
Documentation and support
Ethereum documentation
Review transaction fields, signatures and fees