Decoding Contracts
Decoding FAQs
Frequently asked questions about decoding contracts on Dune.
Frequently Asked Questions
General FAQs
How do I figure out if my contract has been decoded?
How do I figure out if my contract has been decoded?
There are two main ways to find out if your contract has been decoded.First: Account SettingsInformation on submitted contracts can be found in your account settings under “Contracts”. The status of the contract will reflect one of the following:
- Pending
- Approved/Rejected*
I see data on Dune but it doesn't match or is missing what I expected to see
I see data on Dune but it doesn't match or is missing what I expected to see
Unfortunately, Dune only has access to contract data in circumstances that the contract performed an event that left a trace. Our recommendation is to check out the .traces table to see what information is available for a particular contract.Alternatively, some contracts are upgradeable (ie., the smart contract code can be modified). In this case we may not have all of the ABIs. ABIs can be checked in the ABI column of the .contracts tables. A contract can always be resubmitted with missing ABIs so we can update our data.
How do I submit contract information manually?
How do I submit contract information manually?
If the contract being manually submitted is a Proxy contract, we recommend you to move on to the next section.
How do I submit a proxy contract?
How do I submit a proxy contract?
In order to properly decode transactions for contracts that fit the Proxy pattern, Dune needs to map the Proxy contract’s address with the implementation contract’s ABI.We avoid monitoring the implementation contract’s address because its logic is accessed in transactions via the 
DelegateCall function.If we did monitor the implementation contract’s address directly, we would miss out on any event logs in its logic since these are actually fired by the caller (the Proxy in this case) when calling a function through DelegateCall. When submitting Proxy-patterned contracts to Dune, you should input the Proxy contract’s address and, if you have it, the Implementation contract’s ABI. If the Proxy has a new implementation upgraded that you wish to decode, use the same project name + contract name and select ‘NO’ for several instances!
How do I submit Diamond Proxy contracts?
How do I submit Diamond Proxy contracts?
Similar to vanilla Proxy contracts, EIP-2535 contracts can be supported by passing in the address of the Diamond Proxy as well as a single ABI representing the totality of all the facets interfaces.
My submission got rejected, why?
My submission got rejected, why?
The most common reason that your submission got rejected is because it has already been decoded! You can make use of this dashboard to check whether the contract have been decoded.Enter the contract that you wish to decode and hit enter to run:
Why am I missing historical data for my contract?
Why am I missing historical data for my contract?
It may take up to six hours from the time of contract approval for the contract to be fully decoded along with its historical data. If you still can’t see the data after this period, please reach out to us through our #decoding Discord channel.
I'm waiting for my data to fully decode. What can I do in the meantime?
I'm waiting for my data to fully decode. What can I do in the meantime?
Need some data urgently but the contract have yet to be fully decoded? You can refer to these queries that utilizes the logs table to get the events:
Duplicate Data & Namespace Issues
My contracts are being decoded under multiple folders/namespaces, causing duplicate records. How do I fix this?
My contracts are being decoded under multiple folders/namespaces, causing duplicate records. How do I fix this?
This happens when the same contract is submitted multiple times under different names, across different blockchains. To resolve:
- Identify the duplicate submissions in your contracts list
- Choose which namespace to keep (e.g., LiFiDiamond_v2 vs LiFiDiamond)
- Resubmit the contract and select “Rename a contract” as the reason for resubmission
- Contact Dune support via Slack (For Enterprise Customers), Telegram (Paid Customers), Discord, or email (support@dune.com) to remove the duplicate namespace
- Check existing decoded contracts before submitting
- Use consistent naming conventions across your team
- Document which contracts are already decoded
Can I move contracts from one namespace to another without losing data?
Can I move contracts from one namespace to another without losing data?
No, you cannot move contracts between namespaces after decoding. You would need to:
- Resubmit under the correct namespace
- Wait for new decoding to complete
- Migrate your queries to use the new tables
- Submit a request to Dune support via Slack (For Enterprise Customers), Telegram (Paid Customers), Discord, or email (support@dune.com) to remove the old namespace
Rejection & Missing Data Issues
My contract was rejected with no explanation. What happened?
My contract was rejected with no explanation. What happened?
When a contract is rejected without a detailed explanation, it’s often for one of these common reasons:
- Duplicate submission: Contract is already decoded under another name
- Invalid ABI: ABI doesn’t match the deployed bytecode
- Wrong contract type: Submitted a library or abstract contract
I see the contract on Etherscan but functions/events are missing on Dune. Why?
I see the contract on Etherscan but functions/events are missing on Dune. Why?
Dune only displays functions and events that have actual onchain data:✅ Visible: Events/functions that have been called at least once
❌ Hidden: Events/functions with zero onchain activity
❌ Hidden: View/pure functions (read-only, no on-chain traces)Most common cause: This often happens when a proxy contract’s implementation is upgraded. The new functions/events won’t appear until:ORIf yes but not in decoded tables, contact Dune support with the tx hash
❌ Hidden: Events/functions with zero onchain activity
❌ Hidden: View/pure functions (read-only, no on-chain traces)Most common cause: This often happens when a proxy contract’s implementation is upgraded. The new functions/events won’t appear until:
- They’re actually called onchain, AND
- The new ABI is submitted to Dune for decoding (requires manual approval, which can take some time)
- Find a transaction that calls the missing function/event
- Check if it appears in
ethereum.tracesorethereum.logsraw tables
Bytecode Matching & Instance Detection
I enabled bytecode matching but other instances aren't appearing. How long should I wait?
I enabled bytecode matching but other instances aren't appearing. How long should I wait?
Bytecode matching timeline:If after 72 hours only one address appears, verify:
- Initial contract: Typically decodes within 24 hours
- Bytecode matching scan: Additional 24-48 hours
- Status remains “Pending”: This is normal during scanning
- All instances appear: Usually within 48-72 hours total
- Other contracts have 100% identical bytecode
- You enabled “bytecode matching” during submission
- Contracts aren’t variations (even slight differences prevent matching)
How do I know if bytecode matching actually found other instances?
How do I know if bytecode matching actually found other instances?
After decoding completes, you can check:
- Query the decoded tables for multiple contract addresses
- Can use dune.com/agent:
Complex Namespace Management
How do I ensure specific contracts fall under the right namespace when using bytecode matching?
How do I ensure specific contracts fall under the right namespace when using bytecode matching?
You cannot selectively include/exclude contracts with bytecode matching. Options:If contracts should be in different namespaces:For different versions under same namespace:
- Submit them separately
- Don’t enable bytecode matching
- Manually submit each address
- Submit the main contract with bytecode matching
- Create a view filtering only desired addresses:
- For upgradeable contracts (e.g., proxy pattern), submit only the proxy contract address with the current implementation’s ABI.
- Use the same project and contract names for consistency.
- When a new implementation is deployed, resubmit the proxy contract with the updated ABI and the same names (select ‘NO’ for several instances).
- Do not submit multiple versions as separate contracts; just update the ABI as needed via resubmission.
Multiple teams deployed our contracts. How do we organize the data?
Multiple teams deployed our contracts. How do we organize the data?
Best practices for shared contract code:
- Coordinate namespace ownership: Decide who “owns” the namespace
- Use project-specific namespaces: teamA_token vs teamB_token
- Create cross-project views: Combine data post-decoding
- Document deployment addresses: Maintain a registry of who deployed what
Performance & Query Optimization
How do I efficiently query factory contracts with thousands of instances?
How do I efficiently query factory contracts with thousands of instances?
Optimize your queries by:Filter early and specifically:Identify relevant contracts upfront:
- Before querying, determine which token pairs or contract instances matter to your analysis
- You can do this by:
- Looking them up on a block explorer or the project’s official documentation/site
- Querying Dune itself to find pairs involving a specific token of interest
- Use materialized views for common filters
- Partition by time when querying historical data
- Index on contract_address in downstream tables
My decoded tables are huge. How do I find specific contract instances?
My decoded tables are huge. How do I find specific contract instances?
Use these strategies:Create a contract registry view:
- Use Dune’s search in Data Explorer with specific addresses
- Filter by deployment block for newer contracts
- Maintain an off-chain registry of your contract deployments
Special Cases & Edge Scenarios
How do I handle contracts deployed by CREATE2 with identical addresses across chains?
How do I handle contracts deployed by CREATE2 with identical addresses across chains?
For deterministic deployments:
- Submit once per chain (multichain decoding handles this automatically if criteria are met)
- Use consistent naming across all chains
- Note in submission: “CREATE2 deterministic deployment”
Submission-Related FAQs
I submitted the wrong ABI type (proxy instead of implementation). How do I fix this?
I submitted the wrong ABI type (proxy instead of implementation). How do I fix this?
You’ll need to resubmit the contract with the correct implementation ABI. Use the resubmission process and select “Upgrade the ABI of a contract” as the reason. In the notes, clearly state you’re switching from proxy to implementation ABI. The original submission will be replaced once approved.Please note: You will need to wait until the original submission has completed the decoding process to resubmit. Submitting back to back will result in both submissions getting rejected.
How do I know if I should use bytecode matching vs factory pattern?
How do I know if I should use bytecode matching vs factory pattern?
- Use bytecode matching when: Multiple contracts have identical code but different deployers (e.g., token contracts deployed by different teams)
- Use factory pattern when: All contracts are created by the same factory contract (e.g., Uniswap pairs)
- Use both when: A factory creates contracts with identical bytecode
My contract has been upgraded multiple times. Should I submit all versions?
My contract has been upgraded multiple times. Should I submit all versions?
Handling Upgraded Contracts on DuneWhen your contract has been upgraded multiple times, you don’t need to submit all versions. Here’s what you should do:For Proxy Contracts (Most Common Upgrade Pattern)
If your contract uses a proxy pattern for upgrades:
- Submit only the proxy contract address with the current implementation’s ABI
- Use the same project name and contract name for consistency
- When you have a new implementation that you want to decode, resubmit the contract with:
- Same proxy address
- Updated ABI from the new implementation
- Same project and contract names
- Select ‘NO’ for “several instances” option
Sometimes you need to resubmit a contract because the name is originally submitted wrong, or you need to update the ABI.When resubmitting:
- Go to the contract submission page
- Select the resubmission reason from the dropdown
- If your reason isn’t listed, provide detailed information about why you’re resubmitting to avoid rejection
- Dune handles upgradeable contracts by allowing ABI updates through resubmission
- The documentation notes: “some contracts are upgradeable (i.e., the smart contract code can be modified). In this case we may not have all of the ABIs. ABIs can be checked in the ABI column of the .contracts tables. A contract can always be resubmitted with missing ABIs so we can update our data.”
- You only need to submit the current/latest version that you want decoded
- Don’t submit multiple versions of the same contract as separate submissions
- Don’t submit implementation contract addresses directly (for proxy patterns)
Decoding Process FAQs
Why does my decoded table show data from other contracts I didn't submit?
Why does my decoded table show data from other contracts I didn't submit?
This happens when you enabled bytecode matching or factory pattern detection. Your submission automatically decoded all contracts with:
- Same bytecode (if bytecode matching enabled)
- Same factory deployer (if factory pattern enabled)
How long does decoding take for factory contracts with thousands of instances?
How long does decoding take for factory contracts with thousands of instances?
Factory contracts with many instances (like Uniswap pairs) can take 24-48 hours to fully decode. The table appears immediately but populates gradually. Large factories may take longer due to the volume of historical data.
Query-Related FAQs
How do I identify which specific contract instance generated an event in factory-decoded tables?
How do I identify which specific contract instance generated an event in factory-decoded tables?
Use the
contract_address column present in all decoded tables. This shows which specific instance (e.g., which Uniswap pair) generated each event.Why can't I find my multichain decoded tables?
Why can't I find my multichain decoded tables?
Multichain views require:
- Identical ABIs across chains
- Same project namespace and contract name
- Contracts submitted on multiple chains
Troubleshooting FAQs
I see similar contracts on Etherscan but bytecode matching isn't working. Why?
I see similar contracts on Etherscan but bytecode matching isn't working. Why?
Dune requires 100% bytecode match. Even minor differences (like constructor parameters stored in bytecode) prevent matching. Check if contracts were compiled with different:
- Solidity versions
- Optimizer settings
- Constructor parameters embedded in bytecode
Best Practices FAQs
Should I decode every contract in my protocol?
Should I decode every contract in my protocol?
No, focus on contracts that emit important events or have a queryable state:✅ Core protocol contracts with business logic
✅ Contracts emitting analytical events
❌ Simple ownership or access control contracts
❌ Libraries (can’t be decoded directly)
✅ Contracts emitting analytical events
❌ Simple ownership or access control contracts
❌ Libraries (can’t be decoded directly)
When should I resubmit vs. submit a new contract?
When should I resubmit vs. submit a new contract?
New submission when:
- Different contract address
- New version with different address
- Different contract type in protocol
- Adding missed chains
- Updating ABI for the same contract
- Fixing naming errors
- Request contract deletion
- Submitting for another reason