feat(dex): add Origin ARM swaps to dex.trades

[naddison36]

Summary

Adds Origin ARM swaps on Ethereum to dex.trades.

The model includes swaps from:

• Lido ARM
• Ether.fi ARM
• Ethena ARM

Both swapExactTokensForTokens and swapTokensForExactTokens are supported.

Methodology

The model uses decoded successful ARM calls to determine:

• Tokens bought and sold
• Raw input and output amounts
• Taker
• ARM contract
• Transaction and block metadata

Some older ARM implementations do not return an ABI-encoded amounts array. For these calls, the missing amount is recovered from the corresponding ERC-20 transfer or transferFrom call nested beneath the swap trace.

A deterministic evt_index is assigned using the call trace order, supporting transactions containing multiple ARM swaps.

Changes

• Adds origin_arm_ethereum_base_trades
• Registers the model in dex_ethereum_base_trades
• Declares the six Origin Protocol decoded call sources
• Adds Origin ARM to dex.info
• Adds uniqueness and non-null tests
• Adds regression seeds covering:
  • Legacy exact-input trace recovery
  • Legacy exact-output trace recovery
  • Ether.fi ARM
  • Ethena ARM

Validation

• Successfully executed the rendered model against recent Dune data
• Verified the expected 16-column DEX base-trades schema
• Verified all four regression transactions and raw amounts against Dune
• Validated YAML files
• git diff --check passes

Project metadata

• project: origin_arm
• version: 1
• blockchain: ethereum

[cursor]

PR Summary

Medium Risk
New trade-ingestion logic with custom trace parsing for missing amounts could mis-attribute volume if nested transfers are ambiguous; impact is limited to Origin ARM rows in dex metrics.

Overview
Adds Origin ARM Ethereum swaps into the shared DEX trades pipeline so they roll up to dex.trades alongside other venue base models.

Introduces origin_arm_ethereum_base_trades, which decodes successful swapExactTokensForTokens and swapTokensForExactTokens calls for Lido, Ether.fi, and Ethena ARM contracts (fixed addresses, from 2023-12-13). When older calls omit ABI output_amounts, the model backfills the missing leg from nested ERC-20 transfer / transferFrom traces under the swap call. evt_index is assigned deterministically from trace order for multi-swap txs.

Wiring and metadata: the model is ref’d in dex_ethereum_base_trades, origin_arm is added to dex.info, six origin_protocol_ethereum call sources are declared, and dbt tests plus a regression seed (four txs) validate uniqueness and raw amounts.

^{Reviewed by Cursor Bugbot for commit 64d0d50. Configure here.}

[github-actions]

CLA Assistant Lite bot All contributors have signed the CLA ✍️ ✅

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{Bugbot Autofix is ON, but it could not run because the branch was deleted or merged before autofix could start.}

Want higher recall? High effort reviews run extra passes and find more bugs. A team admin can switch effort levels in the Cursor dashboard.

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit 64d0d50. Configure here.}

[cursor]

Recovery sums all matching transfers

Medium Severity

Legacy amount recovery in missing_amounts uses SUM over every successful nested trace that shares the swap trace prefix and matches the ARM from, token contract to, and ERC-20 selector. When more than one such transfer exists under one swap (splits, refunds, or multi-step internals), the recovered buy or sell raw amount is the total of those calls, not a single swap leg, which can inflate token_bought_amount_raw or token_sold_amount_raw in dex.trades.

 

^{Reviewed by Cursor Bugbot for commit 64d0d50. Configure here.}

[naddison36]

I have read the CLA Document and I hereby sign the CLA