Add Relay Tracker

[premiumjibles]

Context

The ShapeShift affiliate revenue API aggregates fee data from multiple swap providers. Relay is a cross-chain bridge/swap provider that ShapeShift actively uses. When users swap through Relay via ShapeShift, an affiliate fee is collected.

Current Problem: There is no Relay tracker implemented.

Relay Integration Details

How ShapeShift uses Relay:

• ShapeShift passes referrer: 'shapeshift' on all Relay swaps
• Affiliate fees are sent to DAO_TREASURY_BASE (0x9c9aA90363630d4ab1D9dbF416cc3BBC8d3Ed502)
• Fee amount specified via appFees parameter with basis points

Relay API for fetching history:

• Endpoint: GET https://api.relay.link/requests/v2
• Documentation: https://docs.relay.link/references/api
• Key parameters:
  • referrer=shapeshift - Filter by ShapeShift transactions
  • startTimestamp / endTimestamp - Time range (unix seconds)
  • status=success - Only completed transactions
  • continuation - Pagination cursor

Acceptance Criteria

• Create relay.ts tracker following existing patterns in the codebase
• Query /requests/v2 endpoint with referrer=shapeshift filter
• Handle pagination using continuation parameter
• Extract affiliate fee data from transaction responses
• Add 'relay' to services array in models.ts
• Import and call relay tracker in index.ts
• Add DAO_TREASURY_BASE to constants.ts if not present

Files to Create/Modify

• node/proxy/api/src/affiliateRevenue/relay.ts (new file)
• node/proxy/api/src/affiliateRevenue/index.ts (add import and integrate)
• node/proxy/api/src/affiliateRevenue/constants.ts (add treasury address)
• node/proxy/api/src/models.ts (add 'relay' to services array)

Implementation Template

// relay.ts
import axios from 'axios'
import { Fees } from '.'

const RELAY_API_URL = 'https://api.relay.link'
const SHAPESHIFT_REFERRER = 'shapeshift'

export const getFees = async (startTimestamp: number, endTimestamp: number): Promise<Array<Fees>> => {
  const fees: Array<Fees> = []
  let continuation: string | undefined

  do {
    const { data } = await axios.get(`${RELAY_API_URL}/requests/v2`, {
      params: {
        referrer: SHAPESHIFT_REFERRER,
        startTimestamp,
        endTimestamp,
        status: 'success',
        continuation,
      },
    })

    for (const request of data.requests) {
      // Extract chain ID, asset ID, fee amount, tx hash from request
      // Map to Fees type following existing tracker patterns
    }

    continuation = data.continuation
  } while (continuation)

  return fees
}

Reference

• Relay API docs: https://docs.relay.link/references/api
• Main app Relay integration: packages/swapper/src/swappers/RelaySwapper/ (in shapeshift/web repo)

[coderabbitai]

📝 CodeRabbit Plan Mode

Generate an implementation plan and prompts that you can use with your favorite coding agent.

• Create Plan

Examples

• Example 1
• Example 2

_{You can configure auto-planning by selecting labels in the issue_enrichment configuration.}

🔗 Related PRs

shapeshift/web#10507 - fix: disable require balances for relay app fees [merged]
shapeshift/web#10561 - feat: add referrer to relay [merged]
shapeshift/web#10669 - fix: change relay affiliate address to the base treasury [merged]
shapeshift/web#11164 - feat: near affiliate fees [merged]
#1228 - feat: affiliate revenue tracker and endpoint [closed]

👤 Suggested Assignees

• NeOMakinG
• gomesalexandre
• kaladinlight

---

🧪 Issue enrichment is currently in open beta.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord or schedule a call!

[coderabbitai]

📝 CodeRabbit Plan Mode

Generate an implementation plan and prompts that you can use with your favorite coding agent.

• Create Plan

Examples

• Example 1
• Example 2

---

🔗 Similar Issues

Possible Duplicates

• https://github.com/shapeshift/web/issues/11437

Related Issues

• https://github.com/shapeshift/web/issues/11463
• Add Relay Tracker #1236

🔗 Related PRs

shapeshift/web#10507 - fix: disable require balances for relay app fees [merged]
shapeshift/web#10561 - feat: add referrer to relay [merged]
shapeshift/web#10669 - fix: change relay affiliate address to the base treasury [merged]
shapeshift/web#11164 - feat: near affiliate fees [merged]
#1228 - feat: affiliate revenue tracker and endpoint [merged]

👤 Suggested Assignees

• premiumjibles
• NeOMakinG
• gomesalexandre
• kaladinlight

---

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord or schedule a call!